전제조건

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

통제 아티팩트 가져오기 준비

통제 아티팩트를 가져오려면 먼저 해당 아티팩트의 가져오기 파일에 나열된 모든 카테고리 및 하위 카테고리가 존재해야 합니다. 그렇지 않으면 정의되지 않은 카테고리가 있는 아티팩트를 가져오지 않습니다. 자세한 정보는 통제 아티팩트 가져오기 문제점 해결을 참조하십시오.

카테고리 정의가 있는 CSV 파일을 가져오려면 파일에서 정의하지 않는 한 상위 레벨 카테고리가 있어야 합니다.

필수 카테고리를 작성하기 위해 다음 방법 중 하나를 사용할 수 있습니다.

• UI를 통해 카테고리를 작성하십시오. 카테고리 관리를 참조하십시오.
• UI를 통해 또는 API 요청을 통해CSV 파일이 있는 카테고리를 가져오십시오.

가져오기 파일에는 아직 가져오지 않은 다른 유형의 통제 아티팩트에 대한 관계가 포함될 수 있습니다. 파일에 정의된 아티팩트가 작성됩니다. 그러나 존재하지 않는 아티팩트에 대한 관계는 작성되지 않으며 오류 메시지를 수신합니다. 다른 유형의 통제 아티팩트를 가져오고 공개한 후 다시 오류를 수신한 파일을 가져와서 관계를 추가할 수 있습니다.

UI를 통해 CSV 파일 가져오기

UI를 통해 CSV 파일을 가져오려면 다음을 수행하십시오.

1. 필요한 경우 카테고리를 작성하십시오. 통제 아티팩트 가져오기 준비를 참조하십시오.
2. 탐색 메뉴에서 통제 섹션을 열고 카테고리, 비즈니스 용어, 분류, 데이터 클래스, 참조 데이터, 정책또는 규칙을 선택하십시오.
3. 아티팩트 유형 추가 >파일에서 가져오기를 클릭하십시오. 단추를 사용할 수 없는 경우 필수 권한이 있는지 확인하십시오.
4. CSV 파일을 추가하십시오.
5. 병합 메소드를 설정하여 기존 아티팩트와의 충돌을 해결하십시오.
   • 모든 값 바꾸기
   • 정의된 값으로 바꾸기
   • 빈 값 바꾸기 새 아티팩트의 경우 이러한 각 메소드는 동일한 결과를 생성합니다.
6. 가져오기를 클릭하십시오. 가져오기 프로세스는 비동기식으로 실행됩니다. 가져오기 창을 열어 두면 가져오기 결과를 볼 수 있습니다. 그렇지 않으면 가져오기 창을 닫고 작업을 계속할 수 있습니다. 그러나 가져오기가 완료되고 가져오기 결과에 액세스할 수 없는 경우에는 알림을 받지 않습니다.
7. 가져오기 프로세스가 완료되면 아티팩트 및 카테고리를 완료하십시오.

API 요청으로 CSV 파일 가져오기

API 요청에서 병렬 가져오기 프로세스를 실행하도록 지정하거나 UTF-8과 다른 인코딩으로 컨텐츠 유형 스펙을 설정 할 수 있습니다.

REST API를 사용하여 CSV 파일을 가져오려면 다음을 수행하십시오.

1. 필요한 경우 카테고리를 작성하십시오. 통제 아티팩트 가져오기 준비를 참조하십시오.
2. POST /v3/governance_artifact_types/{artifact_type}/import 요청을 제출합니다. 조회 매개변수를 설정하십시오.
   1. merge option 매개변수를 설정하여 기존 아티팩트와의 충돌을 해결하십시오.
      • all: 모든 값을 바꾸십시오.
      • specified: 정의된 값으로 바꾸기
      • empty: 빈 값 바꾸기
   2. 선택사항. 여러 가져오기 프로세스를 병렬로 실행하려면 async_mode 매개변수를 true 로 설정하십시오.
   3. 필요한 경우 API 요청에 인코딩 정보를 포함하십시오. UTF-8이외의 인코딩으로 CSV 파일 가져오기를 참조하십시오. ' API 문서: 지정된 CSV 파일에서 값 가져오기 참조. 요청이 제출되면 프로세스 ID가 응답에 제공됩니다(process_id 매개변수).
3. 선택사항. 응답에 제공된 프로세스 ID를 사용하여 가져오기의 상태를 확인할 수 있습니다. GET /v3/governance_artifact_types/import/status/{process_id} 요청을 제출하여 가져오기 프로세스의 상태를 리턴하십시오. ' API 문서: 가져오기 상태 참조.
4. 가져오기 프로세스가 완료되면 아티팩트 및 카테고리를 완료하십시오.

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

아티팩트 및 카테고리 완료

CSV 파일의 통제 아티팩트를 초안으로 가져오고 워크플로우에 종속됩니다. 초안 아티팩트는 해당 유형의 통제 아티팩트에 대한 워크플로우를 따라야 합니다. 초안 탭에서 각 아티팩트 유형 (예: 비즈니스 용어) 에 대한 초안 통제 아티팩트를 볼 수 있습니다.

가져온 아티팩트를 완료하려면 다음을 수행하십시오.

1. 모든 유형의 아티팩트를 가져온 후 모든 초안 아티팩트를 공개하십시오. 작업 받은 편지함 으로 이동하여 공개 프로세스를 시작하십시오. 아티팩트를 공개할 수 있는 권한이 있어야 합니다. 통제 아티팩트의 워크플로우를 참조하십시오.
2. 필요한 경우 모든 값 바꾸기 병합 메소드를 사용하여 관계 오류를 수신한 파일에 대해 가져오기를 다시 실행하십시오. 그런 다음 업데이트된 아티팩트를 공개하십시오.

카테고리는 워크플로우의 영향을 받지 않으므로 가져오는 모든 카테고리는 즉시 공개됩니다. 가져온 카테고리에는 다음 협업자가 있습니다.

• 사용자는 소유자 역할을 갖고 가져오는 모든 카테고리의 협업자입니다.
• 새 최상위 레벨 카테고리를 가져오는 경우에는 사용자가 유일한 협업자입니다.
• 하위 카테고리를 기존 카테고리로 가져오는 경우 새 하위 카테고리는 상위 레벨 카테고리에서 모든 협업자를 상속합니다.

자세한 정보는 통제 아티팩트 가져오기 문제점 해결을 참조하십시오.

가져온 카테고리를 완료하려면 새 카테고리에 다른 협업자를 추가하십시오. 공용 액세스 그룹을 가져온 카테고리에 추가하는 경우, 카테고리를 수동으로 작성할 때 이 그룹에 지정되는 뷰어 역할 대신 기본적으로 편집자 카테고리 역할이 지정됩니다.

카테고리 협업자 관리를 참조하십시오.

자세한 정보

• 통제 아티팩트를 가져오기 위한 CSV 파일 형식

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