구성 키 및 데이터 엔터티

데이터 엔터티를 사용하여 데이터를 가져오거나 내보내기 전에 먼저 사용하려는 데이터 엔터티에 대한 구성 키의 영향을 결정하는 것이 좋습니다.

구성 키에 대한 자세한 내용은 라이센스 코드 및 구성 키 보고서를 참조하십시오.

구성 키 할당

구성 키는 다음 아티팩트 중 하나 또는 모두에 할당할 수 있습니다.

• 데이터 엔터티
• 데이터 소스로 사용되는 테이블
• 테이블 필드
• 데이터 항목 필드

다음 표에는 개체의 기초가 되는 다양한 아티팩트의 구성 키 값이 개체의 예상 동작을 변경하는 방법이 요약되어 있습니다.

데이터 엔터티에 대한 구성 키 설정	테이블의 구성 키 설정	테이블 필드의 구성 키 설정	데이터 항목 필드의 구성 키	예상되는 행동
비활성화됨	평가되지 않은	평가되지 않은	평가되지 않은	데이터 엔터티의 구성 키가 비활성화되면 데이터 엔터티가 작동하지 않습니다. 기본 테이블 및 필드의 구성 키가 활성화 또는 비활성화되어 있는지 여부는 중요하지 않습니다.
활성화됨	비활성화됨	평가되지 않은	평가되지 않은	데이터 엔터티에 대한 구성 키가 활성화된 경우 데이터 관리 프레임워크는 각 기본 테이블의 구성 키를 확인합니다. 테이블의 구성 키가 비활성화된 경우 해당 테이블은 함수적 사용을 위해 데이터 엔터티에서 사용할 수 없습니다. 테이블의 구성 키가 비활성화된 경우 테이블 및 데이터 엔터티 구성 키 설정은 평가되지 않습니다. 엔터티의 기본 테이블에 구성 키가 비활성화되어 있으면 시스템은 엔터티의 구성 키가 비활성화된 것처럼 작동합니다.
활성화됨	활성화됨	비활성화됨	평가되지 않은	데이터 엔터티에 대한 구성 키가 활성화되고 기본 테이블 구성 키가 활성화된 경우 데이터 관리 프레임워크는 테이블 필드의 구성 키를 확인합니다. 필드의 구성 키가 비활성화된 경우 해당 데이터 엔터티 필드에 구성 키가 활성화된 경우에도 데이터 엔터티에서 해당 필드를 함수적으로 사용할 수 없습니다.
활성화됨	활성화됨	활성화됨	비활성화됨	다른 모든 수준에서 구성 키가 활성화되어 있지만 엔터티 필드 구성 키가 활성화되어 있지 않으면 데이터 엔터티에서 필드를 사용할 수 없습니다.

참고

엔터티에 데이터 소스로 다른 엔터티가 있는 경우 위의 의미 체계는 재귀적 방식으로 적용됩니다.

항목 목록 새로 고침

엔터티 목록이 새로 고쳐지면 데이터 관리 프레임워크는 런타임 사용을 위한 구성 키 메타데이터를 빌드합니다. 이 메타데이터는 위에서 설명한 논리를 사용하여 구축됩니다. 데이터 관리 프레임워크에서 작업 및 엔터티를 사용하기 전에 엔터티 목록 새로 고침이 완료될 때까지 기다리는 것이 좋습니다. 기다리지 않으면 구성 키 메타데이터가 최신 상태가 아닐 수 있으며 예기치 않은 결과가 발생할 수 있습니다. 엔터티 목록을 새로고침할 때 엔터티 목록 페이지에 다음 메시지가 표시됩니다.

데이터 항목 목록 페이지

데이터 관리 작업 영역의 데이터 엔터티 목록 페이지에는 엔터티에 대한 구성 키 설정이 표시됩니다. 구성 키가 데이터 엔터티에 미치는 영향을 이해하려면 이 페이지에서 시작하십시오.

이 정보는 엔터티 새로 고침 중에 빌드된 메타데이터를 사용하여 표시됩니다. 구성 키 열에는 데이터 엔터티와 연결된 구성 키의 이름이 표시됩니다. 이 열이 비어 있으면 데이터 엔터티와 연결된 구성 키가 없음을 의미합니다. 구성 키 상태 열에는 구성 키의 상태가 표시됩니다. 체크 표시가 있으면 키가 활성화되었음을 의미합니다. 비어 있으면 키가 비활성화되었거나 연결된 키가 없음을 의미합니다.

대상 필드

다음 단계는 구성 키가 테이블과 필드에 미치는 영향을 보기 위해 데이터 엔터티를 자세히 살펴보는 것입니다. 데이터 엔터티의 대상 필드 양식은 데이터 엔터티의 관련 테이블 및 필드에 대한 구성 키와 키 상태 정보를 보여줍니다. 데이터 엔터티 자체에서 구성 키가 비활성화된 경우 이 엔터티에 대한 대상 필드 양식의 테이블과 필드는 구성 키 상태에 관계없이 전혀 사용할 수 없다는 경고 메시지가 표시됩니다.

하위 항목

특정 엔터티는 데이터 소스로 다른 엔터티를 갖거나 복합 데이터 엔터티입니다. 이러한 엔터티에 대한 구성 키 정보는 하위 엔터티 양식에 표시됩니다. 위에서 설명한 엔티티 목록 페이지와 유사한 방식으로 이 양식을 사용합니다. 하위 엔터티에 대한 대상 필드 양식도 위에서 설명한 것과 같이 작동합니다.

데이터 항목 사용

사용하려는 데이터 엔터티에 대한 구성 키의 전체 영향(있는 경우)을 이해한 후에는 이제 데이터 엔터티를 데이터 프로젝트에 추가하여 데이터 엔터티 사용을 진행할 수 있습니다.

구성 키에 대한 런타임 검증

엔터티 새로 고침 목록 중에 빌드된 구성 키 메타데이터를 사용하여 다음 사용 사례에서 런타임 유효성 검사가 수행됩니다.

• 데이터 항목이 작업에 추가되는 경우
• 사용자가 엔터티 목록에서 '확인'을 클릭하면
• 사용자가 데이터 프로젝트에 데이터 패키지를 로드할 때
• 사용자가 템플릿을 데이터 프로젝트에 로드할 때
• 기존 데이터 프로젝트가 로드될 때
• 템플릿이 데이터 프로젝트에 로드될 때
• 내보내기/가져오기 작업이 실행되기 전(일괄, 비일괄, 반복, OData)
• 사용자가 매핑을 생성할 때
• 사용자가 매핑 UI에서 필드를 매핑할 때
• 사용자가 '가져올 수 있는 필드'만 추가하는 경우

구성 키 변경 관리

엔터티, 테이블 또는 필드 수준에서 구성 키를 업데이트할 때마다 데이터 관리 프레임워크의 엔터티 목록을 새로 고쳐야 합니다. 이 프로세스는 프레임워크가 최신 구성 키 설정을 선택하도록 합니다. 엔터티 목록을 새로 고칠 때까지 엔터티 목록 페이지에 다음 경고가 표시됩니다. 업데이트된 구성 키 변경 사항은 엔터티 목록을 새로 고친 직후 적용됩니다. 기존 데이터 프로젝트 및 작업의 유효성을 검사하여 구성 키 변경 사항이 적용된 후 예상대로 작동하는지 확인하는 것이 좋습니다.