Wymagania wstępne

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

Edytowanie zawartości pliku ZIP

Wyeksportowany plik ZIP zawiera osobny folder dla każdego typu artefaktu z plikiem CSV, który zawiera ten typ artefaktu.

Zawartość wyeksportowanego pliku ZIP można zmodyfikować ręcznie. Sposób postępowania:

• Nie należy tworzyć dodatkowych folderów, na przykład folderu macierzystego.
• Nie należy zmieniać nazw folderów. Foldery dla każdego typu artefaktu w pliku ZIP muszą mieć następujące nazwy: category, classification, data_class, glossary_term, policy, rulei reference_data.
• Zachowaj poprawny format każdego pliku CSV. Patrz Format pliku CSV na potrzeby importowania artefaktów zarządzania.
• Nie należy usuwać ani zmieniać nazwy kolumny Artifact ID w każdym pliku CSV. Ta kolumna określa identyfikator artefaktu jako dodatkowy do nazwy artefaktu.
• Zdefiniuj relację między dwoma artefaktami zarządzania dla tylko jednego z artefaktów. Istnieją dwa wyjątki:
  1. Relacja znajduje się między strategią i regułą zarządzania. W tym przypadku należy zdefiniować relację dla obu artefaktów w obu plikach CSV. W pliku CSV z strategiami dodaj relację w kolumnie Rule . W pliku CSV z regułami zarządzania dodaj relację w kolumnie Parent Policies .
  2. Używana jest opcja scalania all . W takim przypadku należy upewnić się, że cała treść CSV jest spójna w odniesieniu do relacji między artefaktami. Jeśli na przykład plik importu ZIP zawiera zarówno termin, jak i klasę danych połączone ze sobą, to relacja ta musi być obecna w obu klasach danych CSV i CSV. W przeciwnym razie zachowanie importu relacji jest nieprzewidywalne, relacja może być importowana lub nie.

Przygotowywanie do importowania pliku ZIP

Przed zaimportowanie pliku ZIP należy wykonać następujące czynności:

• Wykonaj odpowiednie działanie, aby uniknąć duplikowania predefiniowanych artefaktów
• Tworzenie niestandardowych właściwości i relacji

opcje łączenia

Podczas uruchamiania importu ZIP dostępne są następujące opcje scalania:

• all -Zastąp wszystkie wartości zaimportowane wartości zastępują istniejące wartości w katalogu
• specified -Zastąp przez zdefiniowane wartości-zaimportowane wartości, które nie są puste, zastępują istniejące wartości w katalogu
• empty -Zastąp puste wartości-importowane wartości zastępują tylko puste wartości w katalogu

Wartość specified jest używana jako domyślna.

Więcej informacji na temat opcji scalania znajduje się w sekcji Metody scalania zaimportowanych i istniejących artefaktów .

Importowanie pliku ZIP

Aby zaimportować plik ZIP artefaktów zarządzania:

1. Jeśli to konieczne, usuń istniejące predefiniowane artefakty lub edytuj relacje z predefiniowanymi artefaktami. Więcej informacji na ten temat zawiera sekcja Przygotowanie do importowania pliku ZIP.
2. Wyślij żądanie POST /v3/governance_artifact_types/import . Dołącz opcję scalania i ścieżkę do pliku ZIP. Patrz dokumentacja interfejsu API: Importowanie wartości z określonego pliku ZIP. Wszystkie artefakty są publikowane natychmiast bez przepływu pracy.
3. Po zakończeniu procesu importowania należy dodać innych współpracowników do nowych kategorii. Patrz sekcja Zarządzanie współpracownikami kategorii.

Przed rozpoczęciem nowego procesu importowania należy poczekać na zakończenie procesu importowania lub wyczyścić wstrzymany proces.

Monitorowanie procesu importowania

Po wysłaniu żądania importowania pliku ZIP w odpowiedzi zostanie podany identyfikator procesu (parametrprocess_id ). Za pomocą identyfikatora procesu można sprawdzić status importu. Wyślij żądanie GET /v3/governance_artifact_types/import/status/{process_id} , aby wysłać zapytanie o status importu. Patrz: dokumentacja interfejsu API: status importu.

Czyszczenie wstrzymanego procesu importu

Experimental Jest to wersja eksperymentalna i nie jest jeszcze obsługiwana w środowiskach produkcyjnych.

Jeśli dane są wstrzymane, można wyczyścić proces importowania, a następnie ponownie zaimportować plik ZIP. Nie można uruchomić nowego procesu importowania do czasu zakończenia poprzedniego procesu lub po wyczyszczniu wstrzymanego procesu. Wszystkie procesy importu są czyszczone automatycznie po 24 godzinach nieaktywności.

Status procesu importowania można sprawdzić, wysyłając żądanie GET /v3/governance_artifact_types/import/status/{process_id} . Proces jest wstrzymany, jeśli status to IN_PROGRESS, ale artefakty nie są importowane.

Aby wyczyścić wstrzymany lub nieudany proces importowania, wyślij żądanie POST /v3/governance_artifact_types/import/cleanup/{process_id} .

Patrz: dokumentacja interfejsu API: czyszczenie procesu importu ZIP.

Więcej inform.

• Importowanie artefaktów zarządzania z plikiem CSV

• Eksportowanie wszystkich artefaktów zarządzania do pliku ZIP

• Rozwiązywanie problemów dotyczących importowania artefaktów zarządzania

• Dokumentacja interfejsu API: Importowanie wartości z określonego pliku ZIP

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