Wymagania wstępne

Przed zaimportowanie artefaktów zarządzania za pomocą pliku CSV należy utworzyć plik o poprawnym formacie i upewnić się, że użytkownik ma wymagane uprawnienia.

Przygotowywanie do importowania artefaktów zarządzania

Zanim możliwe będzie zaimportowanie artefaktów zarządzania, muszą istnieć wszystkie kategorie i podkategorie wymienione w pliku importu dla tych artefaktów. W przeciwnym razie artefakty z niezdefiniowanymi kategoriami nie zostaną zaimportowane. Więcej informacji na ten temat zawiera sekcja Rozwiązywanie problemów dotyczących importowania artefaktów zarządzania.

Zanim możliwe będzie zaimportowanie pliku CSV z definicjami kategorii, muszą istnieć kategorie najwyższego poziomu, o ile nie zostaną zdefiniowane w pliku.

Aby utworzyć wymagane kategorie, można użyć jednej z następujących metod:

• Utwórz kategorie przy użyciu interfejsu użytkownika. Patrz Zarządzanie kategoriami.
• Zaimportuj kategorie z plikiem CSV, przy użyciu interfejsu użytkownika lub z żądaniem interfejsu API.

Pliki importu mogą zawierać relacje z innymi typami artefaktów zarządzania, których jeszcze nie zaimportowano. Tworzone są artefakty zdefiniowane w pliku. Jednak relacje z artefaktami, które nie istnieją, nie są tworzone i wyświetlany jest komunikat o błędzie. Relacje można dodać, importując pliki, które odebrały błędy ponownie po zaimportowaniu i opublikowaniu innych typów artefaktów zarządzania.

Importowanie pliku CSV przy użyciu interfejsu użytkownika

Aby zaimportować plik CSV przy użyciu interfejsu użytkownika:

1. W razie potrzeby utwórz kategorie. Więcej informacji zawiera sekcja Przygotowanie do importowania artefaktów zarządzania.
2. Z menu nawigacyjnego otwórz sekcję Zarządzanie i wybierz opcje Kategorie, Warunki biznesowe, Klasyfikacje, Klasy danych, Dane odniesienia, Strategielub Reguły.
3. Kliknij opcję Dodaj typ-artefaktu > Importuj z pliku.
4. Dodaj plik CSV.
5. Ustaw metodę scalania w celu rozstrzygnięcia konfliktów z dowolnymi istniejącymi artefaktami:
   • Zastąp wszystkie wartości
   • Zastąp przy użyciu zdefiniowanych wartości
   • Zastąp puste wartości Dla nowych artefaktów, każda z tych metod generuje te same wyniki.
6. Kliknij opcję Importuj. Proces importowania jest uruchamiany asynchronicznie. Jeśli pozostawisz otwarte okno importu, możesz wyświetlić wyniki importowania. W przeciwnym razie można zamknąć okno importowania, aby kontynuować pracę. Jednak użytkownik nie jest powiadamiany o zakończeniu importowania i nie ma dostępu do wyników importowania.
7. Po zakończeniu procesu importowania należy zakończyć artefakty i kategorie.

Importowanie plików CSV za pomocą żądania API

W żądaniu interfejsu API można określić uruchamianie równoległych procesów importowania lub ustawić specyfikację typu treści na inne kodowanie niż UTF-8.

Aby zaimportować plik CSV przy użyciu interfejsu REST API:

1. W razie potrzeby utwórz kategorie. Więcej informacji zawiera sekcja Przygotowanie do importowania artefaktów zarządzania.
2. Wyślij żądanie POST /v3/governance_artifact_types/{artifact_type}/import . Ustaw parametry zapytania:
   1. Ustaw parametr merge option , aby rozstrzygnąć konflikty z istniejącymi artefaktami:
      • all: Zastąp wszystkie wartości.
      • specified: Zastąp przy użyciu zdefiniowanych wartości
      • empty: Zastąp puste wartości
   2. Opcjonalne. Ustaw parametr async_mode na wartość true , aby równolegle uruchamiać wiele procesów importowania.
   3. W razie potrzeby należy dołączyć informacje o kodowaniu w żądaniu interfejsu API. Więcej informacji na ten temat zawiera sekcja Importowanie plików CSV z kodowaniem innym niż UTF-8. Patrz dokumentacja interfejsu API: Importowanie wartości z określonego pliku CSV. Po przesłaniu żądania w odpowiedzi podany jest identyfikator procesu (parametrprocess_id ).
3. Opcjonalne. Aby sprawdzić status importu, można użyć identyfikatora procesu udostępnionego w odpowiedzi. Wyślij żądanie GET /v3/governance_artifact_types/import/status/{process_id} , aby zwrócić status procesu importowania. Patrz: dokumentacja interfejsu API: status importu.
4. Po zakończeniu procesu importowania należy zakończyć artefakty i kategorie.

curl -X POST "https://{server}:{port}/v3/governance_artifact_types/{artifact_type}/import?merge_option={merge_option}" -H "accept: application/json" -H "Authorization: $AUTHORIZATION_HEADER" -H "content-type: multipart/form-data" -F "file=@\"./import_glossary.csv\";type=text/csv;charset=windows-1250" -k

Kończenie artefaktów i kategorii

Artefakty zarządzania w pliku CSV są importowane jako wersje robocze i podlegają przepływowi pracy. Projekty artefaktów muszą być zgodne z przepływem pracy dla tego typu artefaktu zarządzania. Istnieje możliwość wyświetlenia wersji roboczych artefaktów zarządzania na karcie Robocze dla odpowiedniego typu artefaktu, na przykład warunków biznesowych.

Aby zakończyć zaimportowane artefakty, wykonaj następujące czynności:

1. Po zaimportowanie wszystkich typów artefaktów należy opublikować wszystkie artefakty robocze. Przejdź do skrzynki odbiorczej zadania i rozpocznij proces publikowania. Użytkownik musi mieć uprawnienia do publikowania artefaktów. Więcej informacji zawiera sekcja Przepływy pracy dla artefaktów zarządzania.
2. Jeśli to konieczne, ponownie uruchom import dla plików, które odebrały błędy relacji, z metodą scalania Zastąp wszystkie wartości . Następnie opublikuj zaktualizowane artefakty.

Wszystkie kategorie, które są importowane, są publikowane natychmiast, ponieważ kategorie nie podlegają przepływowi pracy. Zaimportowane kategorie mają następujące współpracownicy:

• Jesteś współpracownikiem we wszystkich kategoriach importowych, z rolą Właściciel .
• W przypadku importowania nowych kategorii najwyższego poziomu użytkownik jest jedynym współpracownikiem.
• W przypadku importowania podkategorii do istniejących kategorii, nowe podkategorie dziedziczą wszystkich współpracowników z ich kategorii najwyższego poziomu.

Więcej informacji na ten temat zawiera sekcja Rozwiązywanie problemów dotyczących importowania artefaktów zarządzania.

Aby zakończyć importowane kategorie, dodaj innych współpracowników do nowych kategorii. Jeśli grupa Dostęp publiczny zostanie dodana do zaimportowanej kategorii, wówczas rola kategorii Edytujący jest przypisywany domyślnie, zamiast roli Przeglądarka , która jest przypisana do tej grupy podczas ręcznego tworzenia kategorii.

Patrz sekcja Zarządzanie współpracownikami kategorii.

Dowiedz się więcej

• Format pliku CSV na potrzeby importowania artefaktów zarządzania

Temat nadrzędny: Importowanie metod dla artefaktów zarządzania