세트의 참조 데이터 값은 일반적으로 고유 코드로 식별됩니다. 그러나 둘 이상의 컬럼을 사용하여 데이터를 식별해야 할 수도 있습니다. 복합 키 는 코드 열과 참조 데이터 세트에 있는 최대 5개의 사용자 정의 열의 조합입니다. 그런 다음 복합 키를 사용하여 각 참조 데이터 값을 고유하게 식별합니다.

필수 권한 참조 데이터 세트를 작성, 편집 또는 삭제하려면 다음 사용자 권한이 있어야 합니다.

• 거버넌스 아티팩트에 액세스

또한 참조 데이터 세트의 기본 카테고리에 다음 카테고리 협업자 역할 중 하나가 있어야 합니다.

• 관리자
• 소유자
• 편집기
• 참조 데이터 세트를 작성할 수 있는 권한이 있는 사용자 정의 역할입니다.

복합 키 는 각 참조 데이터 값을 고유하게 식별하는 데 사용됩니다. 복합 키를 사용하면 코드 열의 값이 더 이상 고유할 필요가 없습니다. 고유성은 지정된 모든 컬럼의 값이 결합된 경우에만 보장됩니다. 개별 컬럼의 값이 반드시 고유할 필요는 없습니다.

세트에 대한 복합 키를 정의할 때 이러한 세트의 각 참조 데이터 값은 시스템에서 복합 키의 실제 표시로 식별됩니다. 복합 키는 세트가 처음 작성될 때 지정된 순서대로 코드 열과 복합 키 사용자 정의 열을 연결한 것입니다. 값은 |로 구분됩니다 (예: CODE|CC1|CC2|CC3). 이 실제 표시는 시스템에서 참조 데이터 값을 식별하는 데 사용되며 (예를 들어, 관계를 추적하기 위해) 변경할 수 없습니다.

복합 키를 작성하는 데 사용되는 사용자 정의 열에는 다음과 같은 제한사항이 적용됩니다.

• 복합 키 열은 새 참조 데이터 세트 또는 비어 있는 참조 데이터 세트에만 추가할 수 있습니다. 세트에 이미 참조 데이터 값이 추가된 경우 복합 키를 정의할 수 없습니다.
• 유효성을 검증할 사용자 정의 열은 텍스트 유형이어야 합니다.
• 복합 키를 구성하기 위해 코드 열에 최대 5개의 사용자 정의 열을 추가할 수 있습니다. 코드 열은 항상 첫 번째입니다.
• 사용자 정의 열이 복합 키의 일부인 경우 필수로 설정해야 합니다.
• 참조 데이터 값이 세트에 추가되면 복합 키를 더 이상 수정할 수 없습니다. 변경이 필요한 경우 새 참조 데이터 세트를 작성해야 합니다.
• 복합 키 열의 길이는 최대 200자까지 가능합니다. 복합 키의 일부가 아닌 사용자 정의 열에는 한계가 2000으로 설정되어 있습니다.
• 문자 | 및 UNIT SEPARATOR (ASCII 코드 0x31) 는 복합 키를 작성하는 데 사용되는 사용자 정의 컬럼 또는 코드 컬럼에서 사용되지 않아야 합니다. 이 문자는 데이터베이스에서 복합 키의 실제 표시를 작성할 때 복합 키 값을 분리하는 데 사용됩니다. 이 제한사항은 API v4에만 적용됩니다.

값이 있는 CSV 파일을 사용하여 복합 키로 참조 데이터 세트를 작성하려면 다음을 수행하십시오.

1. 통제 > 참조 데이터를 선택한 후 참조 데이터 세트 추가를 클릭하십시오.

2. 새 참조 데이터 세트 를 클릭하고 세부사항 패널에서 다음을 지정하십시오.

   1. CSV 파일을 업로드하십시오.
   2. 참조 데이터 세트의 이름을 제공하십시오.
   3. 값의 유형 (텍스트, 숫자 또는 날짜) 을 지정하십시오.
   4. 참조 데이터 세트를 작성할 카테고리를 선택하십시오.
   5. 선택적으로 설명을 제공하십시오.

3. 열 맵핑 패널에서 CSV 파일의 열을 대상 열에 맵핑하십시오.

   1. CSV 파일의 첫 번째 행을 첫 번째 참조 데이터 값 대신 열 헤더로 사용해야 하는지 여부를 지정하십시오.

   2. 파일의 열을 하나씩 맵핑하십시오. 업로드된 열의 미리보기가 표시됩니다. 사전 정의된 열이 사용자의 요구를 충족하지 않는 경우 새 사용자 정의 열을 선택하십시오.

   3. 각 사용자 정의 열에 대해 다음을 지정하십시오.

      • 이름: 열 이름은 지정된 참조 데이터 세트 내에서 고유해야 합니다.
      • 텍스트, 숫자 또는 날짜를 입력하십시오.
      • 설명: 선택사항.
      • 열의 레코드에 사용할 최대 문자 수입니다. 복합 키 컬럼의 한계는 200입니다. 다른 열의 경우 한계는 2000입니다. 이 한계는 참조 데이터 세트가 비어 있는 경우에만 변경할 수 있습니다. 값이 세트에 추가되면 한계만 늘릴 수 있습니다.
      • 선택적으로 유효성 검증에 사용할 참조 데이터 세트를 선택하십시오. 열의 값은 선택된 참조 데이터 세트의 CODE열에 대해 유효성 검증됩니다. 어떤 이유로 사용자 정의 열 값이 올바르지 않은 경우 참조 데이터 값을 작성하거나 가져오지 않으며 보고서에 경고가 추가됩니다.

      참고:

      • 유효성 검증기가 되도록 선택하는 참조 데이터 세트는 이 세트에 대한 유효성 검증이 제거되지 않으면 더 이상 제거할 수 없습니다.
      • 참조 데이터 세트가 비어 있는 경우에만 열의 유효성 검증기를 설정하거나 수정할 수 있습니다.
      • 유효성을 검증하는 CODE열은 항상 이 유형이므로 텍스트 유형의 열만 유효성 검증할 수 있습니다.

   4. 사용자 정의 열이 복합 키의 일부가 되도록 하려면 복합 키의 일부를 선택하십시오. 그러면 열이 자동으로 필수로 표시되며, 이는 값이 비어 있을 수 없음을 의미합니다.

4. 모든 열이 맵핑되면 검토 패널에서 정보를 검토하십시오. 이때 요구사항에 맞게 복합 키 열을 다시 정렬할 수 있습니다. 이 패널에 설정된 컬럼의 순서는 복합 키의 실제 표시가 시스템에서 형성되는 방법에 영향을 줍니다. 예를 들어, 이 패널의 컬럼이 다음 순서로 나열되는 경우,

   • 사용자 정의 컬럼 1
   • 사용자 정의 열 2
   • 사용자 정의 컬럼 3

   그런 다음 이 참조 데이터 값에 대한 복합 키의 실제 표시는 CODE|CC1|CC2|CC3로 구성됩니다. 참조 데이터 세트에 값을 추가하면 이 순서를 더 이상 변경할 수 없습니다. 세트를 볼 때 UI에서 열을 재배열할 수 있지만 복합 키의 실제 컴포지션에는 영향을 주지 않습니다. 열의 순서를 CSV 파일에 지정된 순서와 비교하고 필요한 경우 수정하십시오.

5. 작성을 클릭하십시오. 참조 데이터 세트가 초안으로 저장됩니다.

참고: 참조 데이터 값이 있는 CSV 파일에 대해 작업할 때 값 사이의 상위 관계가 CODE및 |로 구분된 복합 키 사용자 정의 열 값의 연결로 표시되는지 확인하십시오. 코드는 항상 먼저 이동한 후 복합 키 열 값으로 이동합니다. 이러한 컬럼의 순서가 CSV 파일 및 작성 또는 가져오기 마법사의 요약 패널에서 동일한지 확인하십시오.

완료되면 다음을 수행할지 여부를 결정하십시오.

• 초안 상태의 새 참조 데이터 세트를 닫으십시오.
• 새 참조 데이터 세트를 삭제하려면 초안 삭제를 클릭하십시오.
• 워크플로우 정의에 따라 공개 또는 승인을 위해 전송 을 클릭하여 참조 데이터 세트를 처리하십시오.