엔터티 사용자 지정 및 특성 매핑

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

엔터티 관계가 있는 엔터티 간의 특성을 매핑할 수 있습니다. 따라서 다른 레코드의 컨텍스트에서 만들어진 레코드에 대한 기본값을 설정할 수 있습니다. 응용 프로그램에서 사용자 지정 도구를 사용하여 특성을 매핑합니다.TechNet: CRM 시스템 사용자 지정 항목 TechNet: 엔터티 관계 만들기 및 편집: 엔터티 필드 매핑을 참조하십시오. 자세한 내용은 엔터티 필드 매핑 섹션을 참조하십시오.

기본 시스템 엔터티 및 필드 매핑을 보여 주는 테이블에 대해 TechNet: 엔터티 및 특성 매핑을 참조하십시오.

이 항목의 내용

응용 프로그램의 동작

엔터티 및 특성 매핑 데이터 사용

엔터티 간 자동 매핑 특성

엔터티 및 특성 매핑 검색

응용 프로그램의 동작

Microsoft Dynamics 365에서 매핑을 사용하면 다른 레코드에 연결된 새 레코드를 만들 때 데이터 입력을 간소화할 수 있습니다. 엔터티에 다른 엔터티와의 엔터티 관계가 있을 경우 리본에서 관련 항목 만들기 탭을 사용하여 새 관련 엔터티 레코드를 만들 수 있습니다. 이런 방식으로 새 레코드를 만들면 기본 엔터티 레코드의 매핑된 데이터가 새 관련 엔터티 레코드의 양식에 복사됩니다. 엔터티 특성을 매핑하면 두 엔터티 간의 관계에 새 매핑을 추가하여 복사되는 데이터를 제어합니다. 기본 엔터티의 관련 보기 이외의 다른 방법으로 레코드를 만들면 데이터가 매핑되지 않습니다.

예를 들어 거래처의 주소 필드와 연락처의 주소 필드 간에 매핑을 설정할 수 있습니다. 이 매핑을 사용하여 사용자가 특정 거래처에 연결된 연락처를 추가하면 연락처의 주소 필드가 자동으로 채워집니다.

하나의 특성을 여러 대상 특성에 매핑할 수 있습니다. 예를 들어 거래처의 주소 정보를 주문의 청구지 주소 및 운송지 주소 모두에 매핑할 수 있습니다.

새 관련 레코드를 만들기 전에 매핑이 적용됩니다. 사용자는 레코드를 저장하기 전에 항목을 변경할 수 있습니다. 기본 레코드에서 이후에 변경된 데이터는 관련 레코드에 적용되지 않습니다.

엔터티 및 특성 매핑 데이터 사용

두 엔터티 간에 매핑이 있는 기존 레코드의 컨텍스트에서 새 레코드를 만들 경우 InitializeFromRequest 메시지를 사용하여 매핑에 지정된 값이 포함된 새 레코드를 정의할 수 있습니다. 그런 다음 IOrganizationService.Create 메서드를 사용하여 레코드를 저장할 수 있습니다. 이러한 방식으로 정의하는 모든 매핑이 적용됩니다.

유효한 엔터티 맵은 엔터티 관계를 만들 때 만들어집니다.entity_map_attribute_maps 엔터티 관계를 사용하여 엔터티 맵에서 정의한 엔터티 쌍에 대한 특성 맵을 검색합니다.

특성 맵 레코드를 만들거나 업데이트할 수 있습니다. 특성 맵에 대해 다음 요구 사항이 충족되어야 합니다.

• AttributeMetadata 유형은 일치해야 합니다.

• 대상 필드는 원본 필드보다 길어야 합니다.

• 형식은 일치해야 합니다.

• 다른 매핑에서 대상 필드를 사용하면 안 됩니다.

• 원본 필드는 엔터티 양식에 표시되어야 합니다.

• 대상 필드는 사용자가 데이터를 입력할 수 있는 필드여야 합니다.

• 주소 ID 값은 매핑할 수 없습니다.

• PartyList 특성(여기서 AttributeMetadata.AttributeType은 AttributeTypeCode.PartyList임)을 매핑할 수 없습니다.

엔터티 간 자동 매핑 특성

매핑을 지원하는 엔터티 관계에 대한 엔터티 간에 특성 매핑을 편집할 수 있습니다.

각 특성 맵을 수동으로 만드는 것 외에도 AutoMapEntityRequest 메시지를 사용하여 새 특성 매핑 집합을 생성할 수 있습니다. 이 메시지는 도구 모음에서 기타 작업의 매핑 생성 메뉴 옵션에 있는 작업을 수행합니다. 이 메시지는 특성 이름과 유형이 동일한 두 관련 엔터티 간의 특성을 모두 매핑합니다. 이 메시지는 생산성 향상으로 제공되므로 모든 특성 매핑을 수동으로 추가할 필요가 없습니다. 대신 가능성이 많은 매핑 집합을 생성할 수 있으며 요구 사항을 충족하기 위해 개별 매핑을 추가하거나 제거하는 수동 작업량을 최소화합니다.

참고

이런 방식으로 매핑을 자동으로 생성하면 이전에 정의한 특성 매핑을 제거하고 원하지 않는 매핑을 포함할 수 있습니다.

엔터티 및 특성 매핑 검색

만들어진 매핑을 확인하는 간단한 방법은 다음 FetchXML 쿼리를 사용하는 것입니다. 이 쿼리를 실행하는 방법에 대한 자세한 내용은 FetchXML을 사용하여 쿼리 구성을 참조하십시오.

<fetch version='1.0' mapping='logical' distinct='false'>
   <entity name='entitymap'>
      <attribute name='sourceentityname'/>
      <attribute name='targetentityname'/>
      <link-entity name='attributemap' alias='attributemap' to='entitymapid' from='entitymapid' link-type='inner'>
         <attribute name='sourceattributename'/>
         <attribute name='targetattributename'/>
      </link-entity>
   </entity>
 </fetch>

참고 항목

Dynamics 365 메타데이터에서 조직 서비스 사용
EntityMap 엔터티 메시지 및 메서드
AttributeMap 엔터티 메시지 및 메서드
TechNet: 엔터티 관계 만들기 및 편집: 엔터티 필드 매핑

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보