Import dat ve formátu XML/CSV
Jak pracovat s XML/CSV importérem
Správný formát CSV souboru - obecně
CSV – CSV – Import uživatelů (specifika)
CSV – Import projektů (specifika)
CSV – Import úkolů (specifika)
CSV – import kontaktů (specifika)
Malý administrátor pro importy
Úvod
Datový importér Easy Projectu je nepostradatelný nástroj, když se chystáte přenést jakákoli data ze svého stávajícího systému nebo z databáze, takže jej využijete, když potřebujete migrovat/synchronizovat data ze stávajícího systému nebo měníte firemní/projektový systém a je potřeba přenést všechna data. Používáte MS Project, Basecamp, Asana, Clarizen nebo nějakou jinou aplikaci? Náš importér si poradí s daty z každé aplikace, která umí exportovat do formátu XML nebo CSV. Již žádné přepínání mezi aplikacemi, když potřebujete otevřít či upravit data na různých místech. Od této chvíle můžete mít všechna data pouze v jedné aplikaci. Toto řešení je skvělé pro firmy používající systémy, které nepodporují REST API, ale umožňují export do XML/CSV, a tímto přinášíme další způsob, jak je integrovat. Easy Project poskytuje XML/CSV importér, který umožňuje migrovat data v dávkách a mapovat je na existující atributy.
Toto řešení je součástí našich profesionálních implementačních služeb. Import dat přes XML/CSV bez asistence Easy konzultanta může vést k poškození databáze => nefunkční aplikaci! Pokud máte zájem o import dat, vyžádejte si službu na této stránce. Tento článek slouží k poskytnutí informací o principech fungování tohoto nástroje pro vaše vyhodnocení jeho relevance pro váš případ použití.
Klíčové vlastnosti:
- Import všech existujících entit (bez omezení)
- Migrovaná data jsou ručně namapována na existující atributy v Easy Projectu
- Vhodné pro import komplexních dat pro náročné klienty
- V jednom okamžiku lze importovat jednu entitu s neomezeným množstvím atributů
Jak pracovat s XML/CSV importérem
Data lze importovat ve formátech XML a CSV pomocí importéru Easy Projectu (součást Easy Projectu). Najdete jej v Administraci >> Nastavitelné importy.
Po kliknutí na ně se zobrazí seznam již existujících Easy importů. Chcete-li zobrazit, upravit nebo odstranit jakýkoli existující import, jednoduše na něj najeďte kurzorem myši a tyto možnosti se automaticky zobrazí. V nabídce pravého postranního panelu můžete najít různé možnosti vytvoření nového XML/CSV importu konkrétní entity. Pokud na postranním panelu chybí entita, kterou byste chtěli importovat, váš konzultant se o to postará.
Takto může například vypadat nový formulář pro CSV import úkolů. Stačí zadat jméno a kliknout na „Potvrdit“. Při importu nedefinované entity vás formulář také požádá o výběr požadované entity k importu.
V dalším kroku je potřeba nahrát soubor CSV (se správnou datovou strukturou), který chcete importovat. Klikněte na Ulož a zobraz náhled, což umožní mapovat sloupce z CSV (nebo atributů z XML) na atributy v Easy Projectu. Naše aplikace vám také umožňuje aktualizovat stávající záznamy (mapování probíhá přes nastavení Vyhledat podle). Importované položky s ID, které již v systému existuje, se znovu nevytvoří, ale aktualizují se. Importy a aktualizace lze provádět automaticky v datových dávkách. Pokud je importovaný dokument přístupný na veřejné URL, mohou automatizované operace Easy Projectu (cron) pravidelně importovat XML/CSV dostupné na této veřejné URL. Když je mapování hotové, jednoduše klikněte na Importovat, což lze použít pro menší importy (v praxi až 500 záznamů), nebo Importovat na pozadí, což se důrazně doporučuje pro importy více než 500 záznamů.
Správný formát CSV souboru - obecně
Aby byla zachována kompatibilita s importérem, formát CSV souboru musí splňovat následující pravidla:
- Soubor musí být ve formátu CSV (jednotlivé položky odděleny čárkou)
- Jednotlivá pole musí být oddělena čárkou (ne středník)
- CSV soubor musí být ve formátu UTF-8 encoding
- CSV soubor musí obsahovat externí ID importovaných záznamů (unikátní číslo, které obsahuje pole "easy_external_id")
- Pole “easy_external_id” musí být jedinečné napříč aplikací (neplatí pro konkrétní projekt nebo import)
- Pokud pole “easy_external_id” není jedinečné v celé aplikaci, nový importovaný záznam přepíše již existující záznam se stejnou hodnotou pole “easy_external_id”
- Datum musí být ve formátu yyyy-mm-dd (datum a čas yyyy-mm-dd hh-mm)
- Uživatelé, typy úkolů, stavy úkolů atd. by měly být ve formátu ID z databáze
- Povinná pole musí být vždy vyplněná
- Povinná pole pro úkoly jsou: projekt, předmět úkolu, typ úkolu, stav úkolu, priorita, autor
- K importování země do uživatelského pole s formátem typu "seznam" (vyberte zemi), musíte používat kód ISO 3166-1 alpha-2
CSV – Import uživatelů (specifika)
Povinná pole/atributy: jméno, příjmení, login, e-mail
Podporovaná pole/atributy: jméno, příjmení, login, e-mail, kalendář
Nepodporovaná pole/atributy: typ uživatele, šablona, administrátor, skupiny, projekty, jazyky, heslo, potvrzení, časové pásmo
CSV – Import projektů (specifika)
Povinná pole/atributy: jméno, autor
Podporovaná pole/atributy: název, podprojekt, popis, priorita, začátek, datum dokončení, autor
Nepodporovaná pole/atributy: členové projektu + role, přehled projektu
CSV – Import úkolů (specifika)
Povinná pole/atributy: projekt, předmět, autor, typ úkolu, stav, priorita
Podporovaná pole/atributy: projekt, předmět, popis, autor, přiřazeno, typ úkolu, stav, začátek, datum dokončení, odhadovaný čas, priorita, %hotovo
Podporovaná pole/atributy pro podúkoly: nadřazený úkol
CSV – import kontaktů (specifika)
Povinná pole/atributy: typ kontaktu, jméno, příjmení (v závislosti na typu kontaktu)
Podporovaná pole/atributy: typ kontaktu, jméno, příjmení, nadřazený kontakt, příjemce, je globální kontakt, soukromý kontakt, komentáře
CSV – import CRM (specifika)
Povinná pole/atributy: název, stav CRM, projekt
Podporovaná pole/atributy: název, stav CRM, projekt
Uživatelská pole (specifika)
Některé typy uživatelských polí jsou jednoduché, jiné mají své omezení.
- Ano/ne - pouze "0" nebo "1"
- Datum - yyyy-mm-dd
- Datum a čas - yyyy-mm-dd hh-mm - s časem jsou známé problémy, nemusí se naimportovat
- Desetinné číslo - v případě nevyplněného pole, nenačte se výchozí hodnota
- Celé číslo - v případě nevyplněného pole, nenačte se výchozí hodnota
- Seznam klíč/hodnota - není možné importovat více hodnot v jednom záznamu
- Seznam - není možné importovat více hodnot v jednom záznamu - může způsobit duplicity
Malý Administrátor pro importy
V nastavení uživatelského profilu (Administrace >> Uživatelé >> Uživatel - Malý administrátor) Naleznete možnostAdvanced Import
Je-li tato možnost povolena, může vybraný uživatel provádět globální importy stejným způsobem jako správce.
Pro tento typ uživatele však neexistuje žádné tlačítko pro přístup k importům - uživatel musí uložit následující odkaz: Aby k němu mohl přistupovat : /easy_entity_imports.
