Import dat ve formátu XML / CSV
Jak pracovat s importérem XML/CSV
Správný formát souboru CSV – obecný
CSV – Specifika importu uživatelů
CSV – Specifika importu projektů
CSV – Specifika importu kontaktů
Úvod
Importér dat Easy Redmine je dokonalým nástrojem, 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 se hodí, když potřebujete migrovat/synchronizovat data ze stávajícího systému nebo měníte společnost. /systém řízení projektu 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 zvládne data z každé aplikace, která lze exportovat do formátu XML nebo CSV. Zapomeňte na přepínání mezi aplikacemi, když potřebujete otevřít nebo upravit data uložená 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 společnosti používající systémy, které nepodporují REST API, ale umožňují export XML/CSV, existuje tedy další způsob, jak se integrovat. Easy Redmine poskytuje importér XML/CSV, který vám 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 Easy Consultant může vést k poškození databáze => nefunkční aplikace! Pokud máte zájem o import dat, vyžádejte si službu na tato stránka. 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:
- Přesunout všechny existující entity (bez omezení)
- Přesunutá data jsou ručně mapována na existující atributy v Easy Redmine
- Vhodné pro přesun komplexních dat pro náročné klienty
- V jednom okamžiku můžete importovat jednu entitu s neomezeným počtem atributů
Jak pracovat s importérem XML/CSV
Data lze importovat ve formátech XML a CSV pomocí importéru Easy Redmine (součást Easy Redmine). Najdete ho v Administraci >> Vlastní importy.
Po kliknutí na něj se zobrazí seznam již existujících jednoduchých 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 importu XML/CSV 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 import úlohy CSV. Stačí zadat jméno a kliknout na „Odeslat“. 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 Uložit a zobrazit náhled, který umožní mapovat sloupce z CSV (nebo atributů z XML) na atributy v Easy Redmine. Naše aplikace vám také umožňuje aktualizovat stávající záznamy (mapování je přes Vyhledat podle nastavení). 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 automatické operace Easy Redmine (cron) pravidelně importovat XML/CSV poskytnuté na této veřejné URL. Když je mapování hotové, stačí kliknout import, které lze využít pro menší importy (praxe ukazuje do 500 záznamů), popř Importovat na pozadí, což je důrazně doporučeno pro import 500+ položek.
Správný formát souboru CSV – obecný
Aby byla zachována kompatibilita s importérem, formát souboru CSV musí splňovat následující pravidla:
- Soubor musí být pouze ve formátu CSV (Čárka Oddělená hodnota)
- Pole musí být oddělena a čárka (ne středník)
- Soubor CSV musí být v kódování UTF-8
- CSV musí obsahovat externí ID importovaného záznamu (jedinečné číslo, které je v poli „easy_external_id“)
- Toto pole „easy_external_id“ musí být jedinečné v celé aplikaci (nejen v konkrétním projektu nebo konkrétním importu)
- Pokud pole „easy_external_id“ není v celé aplikaci jedinečné, nově importovaný záznam přepíše již existující záznam stejným „easy_external_id“
- Datum musí být ve formátu rrrr-mm-dd (Datum a čas rrrr-mm-dd hh-mm)
- Odkazy na jiné entity (např. uživatelé jako pověřenec úkolu nebo autor úkolu) nebo vyjmenované atributy (např. sledovače, stavy úkolů atd.) by měly být ve tvaru if ID z aktuální databáze Easy Redmine
- Povinná pole musí být vždy vyplněna
- Povinná pole pro úkoly jsou: Projekt, předmět, sledovač, stav, priorita, autor
- Chcete-li importovat zemi do formátu vlastního pole „Vyberte zemi“, musíte použít kód ISO 3166-1 alpha-2 (to platí zejména pro import kontaktů v B2B CRM)
CSV – Specifika importu uživatelů
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, správce, skupiny, projekty, jazyky, heslo, potvrzení, časové pásmo
CSV – Specifika importu projektů
Povinná pole/atributy: jméno, autor
Podporovaná pole/atributy: název, podprojekt, popis, priorita, datum zahájení, datum dokončení, autor
Nepodporovaná pole/atributy: členové projektu + role, přehled projektu
CSV – Specifika importu úkolů
Povinná pole/atributy: projekt, předmět, autor, typ úkolu, stav, priorita
Podporovaná pole/atributy: projekt, předmět, popis, autor, zmocněnec, typ úkolu, stav, datum zahájení, datum dokončení, odhadovaný čas, priorita, % hotovo
Podporovaná pole/atributy pro dílčí úkoly: rodičovský úkol
CSV – Specifika importu kontaktů
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, zmocněnec, je globální kontakt, soukromý kontakt, komentáře
CSV – Specifika importu CRM
Povinná pole/atributy: jméno, stav CRM, projekt
Podporovaná pole/atributy: jméno, stav CRM, projekt
Specifika vlastních polí
Některé typy vlastních polí jsou přímočaré, jiné o něco složitější.
- Boolean - 0 nebo 1
- Datum - rrrr-mm-dd
- Datum a čas - rrrr-mm-dd hh-mm - časová část má známé problémy
- Float - v případě prázdné hodnoty výchozí hodnota není nastaveno
- Celé číslo - v případě prázdné hodnoty výchozí hodnota není nastaveno
- Seznam klíč/hodnota – více hodnot se neimportuje
- Seznam - více hodnot nefunguje - může způsobit duplicity
Částečný správce pro importy
V uživatelském nastavení (Administrace >> Uživatelé >> Uživatel - Částečný správce) najdete možnost Pokročilý import
Je-li povoleno, může vybraný uživatel provádět globální importy stejným způsobem, jakým by to dělal správce.
Pro tento typ uživatele však neexistuje žádné tlačítko pro přístup k importům - uživatel si musí uložit následující odkaz: /easy_entity_imports, aby k nim měl přístup.
