Importowanie rekordów z pliku CSV
Importer CSV zamienia arkusz kalkulacyjny w rekordy — jeden rekord na wiersz. Znajduje się w menu Rekordy → Importuj rekordy i prowadzi przez wybór szablonu, mapowanie kolumn na pola, wybór docelowego folderu oraz uruchomienie importu z bieżącym podglądem postępu.
Format CSV
Dział zatytułowany „Format CSV”Przygotuj wiersz nagłówka, jeden rekord na wiersz, i uwzględnij kolumnę z nazwą rekordu. Panel Format CSV na pasku bocznym sugeruje przykładowe kolumny (Nazwa, Opis, Stan, Właściciel), a opcja Pobierz przykładowy plik CSV udostępnia plik startowy. Akceptowane są tylko pliki .csv (“Tylko pliki CSV”), a “ten importer zakłada, że każdy wiersz pliku CSV reprezentuje jeden rekord”.
Dwie dodatkowe wskazówki dotyczące formatu:
- Jedna kolumna dostarcza nazwę rekordu i musi mieć wartość w każdym wierszu, który ma zostać zaimportowany. DICE sugeruje kolumnę Nazwa/Tytuł, jeśli ją znajdzie, a w przeciwnym razie wybiera pierwszą kolumnę.
- Typy kolumn (tekst, data, liczba) są wykrywane automatycznie na podstawie danych podczas generowania szablonu, dlatego wartości w każdej kolumnie powinny być spójne.
Wybór trybu importu
Dział zatytułowany „Wybór trybu importu”Sekcja Tryb importu oferuje dwie ścieżki:
- Utwórz nowy szablon i zaimportuj — “Prześlij plik CSV, wygeneruj automatycznie szablon, przejrzyj go, a następnie zaimportuj.” Najlepsze przy pierwszym imporcie: DICE wywnioskuje szablon na podstawie kolumn.
- Importuj do istniejącego szablonu — “Najpierw wybierz szablon, a następnie zmapuj pola i zaimportuj rekordy.” Dostępne, gdy masz co najmniej jeden szablon; opcja Pobierz przykład generuje plik CSV zgodny z polami wybranego szablonu.
Import z nowym szablonem
Dział zatytułowany „Import z nowym szablonem”- Prześlij plik CSV — kliknij, aby przesłać, lub przeciągnij i upuść plik. Plik jest analizowany na miejscu i wyświetlana jest liczba wierszy (“N wierszy gotowych do mapowania”).
- Sprawdź kreator szablonu — wywnioskowany szablon jest wyświetlany z polami Nazwa szablonu i Opis szablonu wstępnie wypełnionymi na podstawie nazwy pliku oraz z wykrytymi Polami danych.
- W sekcji Nazwa i opis rekordu potwierdź Kolumnę nazwy i opcjonalną Kolumnę opisu. Kolumny te są wymienione w sekcji Pola danych jako Nazwa rekordu / Opis rekordu i oznaczone jako Nie jest tworzone jako pole, ponieważ każdy rekord już je ma.
- Kliknij Utwórz szablon. Szablon zostanie zapisany w twoim zespole, a ty przejdziesz do wyboru miejsca docelowego i importu (“Utworzono szablon. Przejdź do wyboru miejsca docelowego i importu.”).
Ponieważ szablon wygenerowano z pliku CSV, mapowanie kolumn jest stosowane automatycznie (“Ten szablon został wygenerowany na podstawie przesłanego pliku CSV, więc mapowanie pól jest stosowane automatycznie.”). Panel Automatyczne mapowanie kolumn przypomina źródła nazwy i opisu; aby je zmienić, użyj opcji Wróć do szablonu.
Import do istniejącego szablonu
Dział zatytułowany „Import do istniejącego szablonu”- W sekcji Wybierz szablon wybierz szablon, który ma otrzymać importowane wiersze.
- Prześlij plik CSV — “Prześlij plik CSV, aby rozpocząć mapowanie i import.” Panel pokazuje Wiersze CSV obok Pól szablonu wybranego szablonu.
- Kliknij Przejdź do mapowania pól.
Miejsce docelowe i mapowanie pól
Dział zatytułowany „Miejsce docelowe i mapowanie pól”W kroku Miejsce docelowe i mapowanie pól decydujesz, co zostanie utworzone:
- Folder — folder docelowy dla wszystkich importowanych rekordów. Selektor jest wstępnie wypełniany ostatnio używanym folderem; przed importem musisz wybrać folder.
- Mapowanie pól — “Przypisz każdemu polu szablonu kolumnę CSV, z której ma zostać wypełnione.” Sugerowane mapowania są stosowane na podstawie zgodności nazw kolumn; pola pozostawione z ustawieniem Brak kolumny po prostu nie są wypełniane. (Pomijane, gdy szablon wygenerowano automatycznie z pliku CSV).
- Nazwa i opis rekordu — kolumna CSV, z której każdy rekord pobiera nazwę (wymagane) i opcjonalnie opis. Są to właściwości rekordu, więc te kolumny nie są zapisywane jako dane pól.
- Zapisz te kolumny również jako pola — domyślnie wyłączone. Włącz tę opcję, aby wartości nazwy i opisu były również przechowywane w danych pól każdego rekordu. Pominięte zmapowane pole informuje o tym pod swoją nazwą, także pole Wymagane — wartość przenoszą wtedy nazwa i opis samego rekordu.
Pod mapowaniem Podgląd importowanych rekordów pokazuje pierwsze wiersze w takiej postaci, w jakiej zostaną zaimportowane, liczbę gotowych wierszy (“N wierszy gotowych do importu”) oraz oznacza wiersze, których import by się nie powiódł (“N wierszy obecnie zawiera błędy”) — zwykle wiersze bez wymaganej wartości. Popraw plik CSV lub mapowanie, aż istotne dla ciebie wiersze będą miały stan Gotowe.
Każdy wiersz podglądu wygląda jak strona rekordu, którym się stanie: nazwa, szablon, opis, a następnie organizacja, zespół i folder, do których będzie należał. Warto zerknąć na ten ostatni wiersz przed importem — folder udostępniony tobie należy do innego zespołu, a rekordy w nim utworzone należą do tamtego zespołu, a nie do twojego.
Uruchamianie importu
Dział zatytułowany „Uruchamianie importu”Kliknij Importuj rekordy: N. Import jest wykonywany partiami, a Stan importu jest aktualizowany na bieżąco (“Przetwarzanie wierszy: X z Y. Pakiet A z B.”), po czym wyświetlane jest podsumowanie: “Zaimportowano N rekordów.” oraz, w stosownych przypadkach, “Nie udało się zaimportować N wierszy.”
Pomyślny import zapisuje również grupę aktywności Zaimportowany rekord dla każdego rekordu w kanale aktywności, a utworzony szablon pozostaje dostępny dla przyszłych importów.
Importowanie pakietu złożenia
Dział zatytułowany „Importowanie pakietu złożenia”Niezależnie od importu CSV DICE może zaimportować pakiet importu złożeń — plik JSON opisujący w jednej strukturze rekordy, złożenia, dołączone części i linki relacji. Znajduje się w menu Złożenia → Importuj pakiet złożenia.
- Wklej kod JSON pakietu lub użyj opcji Wczytaj plik.
- Kliknij Sprawdź poprawność pakietu. Pakiet jest przetwarzany w trybie próbnym na Plan importu: liczby rekordów, złożeń, rekordów spoza złożeń, dołączeń rekordów i linków rekordów, które zostaną utworzone, oraz ewentualne Problemy blokujące i Ostrzeżenia. Foldery, kategorie i relacje, do których odwołuje się pakiet, są porównywane z istniejącymi i oznaczane jako użyj istniejącego lub utwórz nowy bądź oznaczane jako niejednoznaczne.
- Gdy plan informuje “Ten pakiet jest gotowy do importu.”, kliknij Zatwierdź import.
W odróżnieniu od importu CSV import pakietu złożenia jest transakcyjny: “nic nie zostanie zapisane, dopóki nie zatwierdzisz importu, a import jest wykonywany w całości albo wcale”. Przed zatwierdzeniem rozwiąż wszystkie problemy blokujące. Informacje o tym, czym są złożenia i części, znajdziesz w sekcji Złożenia.