전제조건

ZIP 파일을 사용하여 통제 아티팩트를 가져오기 전에 올바른 형식으로 파일을 작성하고 필요한 권한이 있는지 확인하십시오.

ZIP 파일의 컨텐츠 편집

내보낸 ZIP 파일에는 해당 유형의 아티팩트를 포함하는 CSV 파일이 있는 각 아티팩트 유형에 대한 별도의 폴더가 포함되어 있습니다.

내보낸 ZIP 파일의 컨텐츠를 수동으로 수정할 수 있습니다. 다음 지침을 따르십시오.

• 추가 폴더 (예: 상위 폴더) 를 작성하지 마십시오.
• 폴더 이름을 변경하지 마십시오. ZIP 파일의 각 아티팩트 유형에 대한 폴더 이름은 category, classification, data_class, glossary_term, policy, rule및 reference_data여야 합니다.
• 각 CSV 파일의 올바른 형식을 유지하십시오. 통제 아티팩트 가져오기를 위한 CSV 파일 형식을 참조하십시오.
• 각 CSV 파일에서 Artifact ID 열을 제거하거나 이름을 바꾸지 마십시오. 이 열은 아티팩트의 이름과 함께 아티팩트의 ID를 지정합니다.
• 아티팩트 중 하나에 대해서만 두 통제 아티팩트 간의 관계를 정의하십시오. 다음과 같은 두 가지 예외가 있습니다.
  1. 정책과 통제 규칙 간의 관계입니다. 이 경우 두 CSV 파일 모두에서 두 아티팩트의 관계를 정의하십시오. 정책이 있는 CSV 파일에서 Rule 열에 관계를 추가하십시오. 통제 규칙이 있는 CSV 파일에서 Parent Policies 열에 관계를 추가하십시오.
  2. all 병합 옵션을 사용 중입니다. 이 경우 모든 CSV 컨텐츠가 아티팩트 간 관계와 관련하여 일치하는지 확인해야 합니다. 예를 들어, ZIP 가져오기 파일에 관계와 함께 연결된 용어 및 데이터 클래스가 모두 포함되어 있는 경우 이 관계는 데이터 클래스 CSV및 용어 CSV 모두에 있어야 합니다. 그렇지 않으면 관계 가져오기 동작을 예측할 수 없으며 관계를 가져올 수도 있고 가져올 수도 없습니다.

ZIP 파일 가져오기 준비

ZIP 파일을 가져오기 전에 다음 태스크를 완료해야 합니다.

• 사전 정의된 아티팩트가 중복되지 않도록 적절한 조치를 수행하십시오.
• 사용자 정의 특성 및 관계 작성

병합 옵션

ZIP 가져오기를 실행할 때 다음 병합 옵션을 사용할 수 있습니다.

all

모든 값을 대체하십시오. 가져온 값은 카탈로그의 기존 값을 대체합니다.

specified

정의된 값으로 대체합니다. 비어 있지 않은 가져온 값은 카탈로그의 기존 값을 대체합니다.

empty

빈 값을 대체하십시오. 가져온 값은 카탈로그에서 비어 있는 값만 대체합니다.

specified 가 기본값으로 사용됩니다.

참조 데이터 값을 포함하는 파일을 가져올 때 항상 merge_option=all를 사용해야 합니다.

병합 옵션에 대한 자세한 정보는 가져온 아티팩트 및 기존 아티팩트 병합 방법 을 참조하십시오.

ZIP 파일 가져오기

통제 아티팩트의 ZIP 파일을 가져오려면 다음을 수행하십시오.

1. 필요한 경우 기존의 사전 정의된 아티팩트를 삭제하거나 사전 정의된 아티팩트와의 관계를 편집하십시오. ZIP 파일 가져오기 준비를 참조하십시오.
2. POST /v3/governance_artifact_types/import 요청을 제출하십시오. 병합 옵션 및 ZIP 파일의 경로를 포함하십시오. API 문서: 지정된 ZIP 파일에서 값 가져오기를 참조하십시오. 모든 아티팩트는 워크플로우 없이 즉시 공개됩니다.
3. 가져오기 프로세스가 완료되면 새 카테고리에 다른 협업자를 추가하십시오. 카테고리 협업자 관리를 참조하십시오.

새 가져오기 프로세스를 시작하기 전에 가져오기 프로세스가 완료될 때까지 기다리거나 정지된 프로세스를 정리해야 합니다.

가져오기 프로세스 모니터링

ZIP 파일을 가져오기 위한 요청을 제출한 후에는 응답 (process_id 매개변수) 에 프로세스 ID가 제공됩니다. 프로세스 ID를 사용하여 가져오기의 상태를 확인할 수 있습니다. 가져오기 상태를 조회하려면 GET /v3/governance_artifact_types/import/status/{process_id} 요청을 제출하십시오. ' API 문서: 가져오기 상태 참조.

지연된 가져오기 프로세스 정리

실험 이는 실험적인 릴리스이며 아직 프로덕션 환경에서 사용하도록 지원되지 않습니다.

가져오기가 지연되면 가져오기 프로세스를 정리한 후 ZIP 파일을 다시 가져올 수 있습니다. 이전 프로세스가 완료되거나 정지된 프로세스를 정리할 때까지 새 가져오기 프로세스를 시작할 수 없습니다. 모든 가져오기 프로세스는 24시간동안 사용하지 않으면 자동으로 정리됩니다.

GET /v3/governance_artifact_types/import/status/{process_id} 요청을 제출하여 가져오기 프로세스의 상태를 확인할 수 있습니다. 상태가 IN_PROGRESS인 경우 프로세스가 정지되지만 아티팩트를 가져오지 않습니다.

정지되거나 실패한 가져오기 프로세스를 정리하려면 POST /v3/governance_artifact_types/import/cleanup/{process_id} 요청을 제출하십시오.

' API 문서: ZIP 가져오기 프로세스 정리 참조.

자세한 정보

• CSV 파일로 통제 아티팩트 가져오기

• 모든 통제 아티팩트를 ZIP 파일로 내보내기

• 통제 아티팩트 가져오기 문제점 해결

• API 문서: 지정된 ZIP 파일에서 값 가져오기

상위 주제: 통제 아티팩트에 대한 메소드 가져오기