Import danych w formacie XML / CSV
Jak pracować z importerem XML/CSV
Prawidłowy format pliku CSV - ogólne
CSV – szczegóły importu użytkowników
CSV – Specyfika importu projektów
CSV – specyfikacja importu zadań
CSV – Specyfika importu kontaktów
Specyfika pól niestandardowych
Częściowy administrator importu
Wprowadzenie
Importer danych Easy Redmine to doskonałe narzędzie, gdy masz zamiar przenieść dowolne dane z istniejącego systemu lub bazy danych, więc przydaje się, gdy musisz przenieść/zsynchronizować dane z istniejącego systemu lub zmienić firmę /project management system i trzeba przenieść wszystkie dane. Czy korzystasz z MS Project, Basecamp, Asana, Clarizen lub innej aplikacji? Nasz importer może obsłużyć dane z każdej aplikacji, które można wyeksportować do formatu XML lub CSV. Zapomnij o przełączaniu się między aplikacjami, gdy musisz otworzyć lub edytować dane przechowywane w różnych lokalizacjach. Od teraz możesz mieć wszystkie dane tylko w jednej aplikacji. To rozwiązanie jest świetne dla firm korzystających z systemów, które nie obsługują REST API, ale pozwalają na eksport XML/CSV, więc istnieje inny sposób na integrację. Easy Redmine zapewnia importer XML / CSV, który umożliwia migrację danych w partiach i mapowanie ich do istniejących atrybutów.
To rozwiązanie jest częścią naszych profesjonalnych usług wdrożeniowych. Importowanie danych przez XML/CSV bez pomocy Easy Consultant może doprowadzić do uszkodzenia bazy danych => niefunkcjonalna aplikacja! W przypadku zainteresowania importem danych, prosimy o zgłoszenie usługi na tutaj. Ten artykuł ma na celu dostarczenie informacji o zasadach działania tego narzędzia w celu oceny jego przydatności do przypadku użycia.
Kluczowe cechy:
- Przenieś wszystkie istniejące podmioty (bez limitu)
- Przeniesione dane są ręcznie mapowane do istniejących atrybutów w Easy Redmine
- Nadaje się do przenoszenia złożonych danych dla wymagających klientów
- W tej chwili można importować jedną jednostkę z nieograniczoną liczbą atrybutów
Jak pracować z importerem XML/CSV
Dane można importować w formatach XML i CSV za pomocą importera Easy Redmine (część Easy Redmine). Znajdziesz go w Administracja >> Import niestandardowy.
Po kliknięciu możesz zobaczyć listę już istniejących łatwych importów. Aby wyświetlić, edytować lub usunąć istniejący import, po prostu umieść nad nim kursor myszy, a te opcje pojawią się automatycznie. W prawym menu paska bocznego można znaleźć różne opcje tworzenia nowego importu XML/CSV określonej encji. Jeśli na pasku bocznym brakuje podmiotu, który chcesz zaimportować, Twój Konsultant zajmie się tym.
Na przykład tak może wyglądać nowy formularz importu zadań CSV. Wystarczy wpisać nazwę i kliknąć „Prześlij”. Podczas importowania niezdefiniowanej encji, formularz poprosi również o wybranie wymaganej encji do zaimportowania.
W kolejnym kroku należy wgrać plik CSV (z odpowiednią strukturą danych) do importu. Kliknij Zapisz i wyświetl podgląd, co umożliwi mapowanie kolumn z CSV (lub atrybutów z XML) na atrybuty w Easy Redmine. Nasza aplikacja umożliwia również aktualizację istniejących wpisów (mapowanie odbywa się za pomocą Wyszukaj według ustawienie). Zaimportowane wpisy z identyfikatorem, który już istnieje w systemie, nie są ponownie tworzone, ale są aktualizowane. Importy i aktualizacje mogą być wykonywane automatycznie w partiach danych. Jeśli importowany dokument jest dostępny pod publicznym adresem URL, automatyczne operacje Easy Redmine (cron) mogą regularnie importować XML / CSV dostarczony pod tym publicznym adresem URL. Po zakończeniu mapowania po prostu kliknij import, które można wykorzystać do mniejszych importów (praktyka pokazuje do 500 wpisów), lub Importuj w tle, co jest zdecydowanie zalecane w przypadku importu ponad 500 wpisów.
Prawidłowy format pliku CSV - ogólne
W celu zachowania kompatybilności z importerem format pliku CSV musi spełniać następujące zasady:
- Plik musi być tylko w formacie CSV (Przecinek Wartość oddzielona)
- Pola muszą być oddzielone znakiem przecinek (nie średnik)
- Plik CSV musi być zakodowany w UTF-8
- CSV musi zawierać zewnętrzny identyfikator importowanego rekordu (unikalny numer, który znajduje się w polu „easy_external_id”)
- To pole „easy_external_id” musi być unikalne w całej aplikacji (nie tylko w konkretnym projekcie lub konkretnym imporcie)
- Gdy pole „easy_external_id” nie jest unikatowe w całej aplikacji, nowo zaimportowany rekord zostanie zastąpiony już istniejącym tym samym „easy_external_id”
- Data musi być w formacie rrrr-mm-dd (data i godzina rrrr-mm-dd gg-mm)
- Odniesienia do innych podmiotów (np. użytkowników jako zleceniodawcy zadania lub autora zadania) lub wyliczonych atrybutów (np. modułów śledzących, statusów zadań itp.) powinny mieć formę identyfikatora z aktualnej bazy danych Easy Redmine
- Pola wymagane muszą być zawsze wypełnione
- Wymagane pola dla zadań to: Projekt, temat, tracker, status, priorytet, autor
- Aby zaimportować kraj do niestandardowego formatu pola „Wybierz kraj”, musisz użyć kodu ISO 3166-1 alpha-2 (dotyczy to zwłaszcza importu kontaktów w B2B CRM)
CSV – szczegóły importu użytkowników
Wymagane pola/atrybuty: imię, nazwisko, login, e-mail
Obsługiwane pola/atrybuty: imię, nazwisko, login, e-mail, kalendarz
Nieobsługiwane pola/atrybuty: typ użytkownika, szablon, administrator, grupy, projekty, języki, hasło, potwierdzenie, strefa czasowa
CSV – Specyfika importu projektów
Wymagane pola/atrybuty: nazwisko, autor
Obsługiwane pola/atrybuty: nazwa, podprojekt, opis, priorytet, data rozpoczęcia, termin wykonania, autor
Nieobsługiwane pola/atrybuty: członkowie projektu + role, przegląd projektu
CSV – specyfikacja importu zadań
Wymagane pola/atrybuty: projekt, temat, autor, typ zadania, status, priorytet
Obsługiwane pola/atrybuty: projekt, temat, opis, autor, osoba przypisana, typ zadania, status, data rozpoczęcia, termin, szacowany czas, priorytet, %wykonane
Obsługiwane pola/atrybuty dla podzadań: zadanie nadrzędne
CSV – Specyfika importu kontaktów
Wymagane pola/atrybuty: typ kontaktu, imię, nazwisko (w zależności od typu kontaktu)
Obsługiwane pola/atrybuty: typ kontaktu, imię, nazwisko, kontakt nadrzędny, cesjonariusz, jest kontaktem globalnym, kontakt prywatny, komentarze
CSV – specyfika importu CRM
Wymagane pola/atrybuty: nazwa, status CRM, projekt
Obsługiwane pola/atrybuty: nazwa, status CRM, projekt
Specyfika pól niestandardowych
Niektóre typy pól niestandardowych są proste, inne nieco bardziej skomplikowane.
- Boole'a - 0 lub 1
- Data - rrrr-mm-dd
- Data i godzina – rrrr-mm-dd gg-mm – w części czasowej występują znane problemy
- Float - w przypadku pustej wartości, domyślna wartość nie jest ustawiony
- Integer - w przypadku pustej wartości, domyślna wartość nie jest ustawiony
- Lista klucz/wartość – wiele wartości nie jest importowanych
- Lista — wiele wartości nie działa — może powodować duplikaty
Częściowy administrator importu
W ustawieniach użytkownika (Administracja >> Użytkownicy >> Użytkownik - Częściowy administrator) znajdziesz opcję Zaawansowany import
Po włączeniu wybrany użytkownik może wykonywać importy globalne w taki sam sposób, jak zrobiłby to administrator.
Nie ma jednak przycisku umożliwiającego dostęp do importu dla tego typu użytkownika - użytkownik musi zapisać następujący link: /easy_entity_imports, aby uzyskać do niego dostęp.