Customize 엔터티 메타데이터

 

게시 날짜: 2017년 1월

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

엔터티는 메타데이터에서 정의합니다. 엔터티 메타데이터를 정의하거나 변경하면 엔터티의 기능을 제어할 수 있습니다. 조직의 메타데이터를 보려면 SDK 패키지에 제공된 메타 데이터 브라우저를 사용합니다. Microsoft Dynamics CRM SDK 패키지를 다운로드합니다. 추가 정보:조직에 대한 메타데이터 찾아보기

이 항목에서는 엔터티를 프로그래밍 방식으로 사용하는 방법에 대해 설명합니다. 응용 프로그램에서 엔터티를 사용하는 방법에 대한 자세한 내용은 TechNet: 엔터티 만들기 및 편집을 참조하십시오.

이 항목의 내용

사용자 지정 엔터티를 만들 때 사용할 수 있는 옵션

엔터티 기능 활성화

편집 가능한 엔터티 속성

엔터티 메타데이터 메시지

사용자 지정 엔터티에서 지원하는 메시지

사용자 지정 엔터티를 만들 때 사용할 수 있는 옵션

다음 표에는 사용자 지정 엔터티를 만들 때 사용할 수 있는 옵션이 나와 있습니다. 사용자 지정 엔터티를 만들 때 다음 속성만 설정할 수 있습니다.

옵션

설명

사용자 지정 활동 만들기

EntityMetadata.IsActivity 속성을 설정하여 활동에 해당하는 엔터티를 만들 수 있습니다. 자세한 내용은 사용자 지정 활동을 참조하십시오.

엔터티 이름

두 가지 유형의 이름이 있으며, 모두 사용자 지정 접두사가 있어야 합니다.

  • EntityMetadata.LogicalName: 엔터티 이름의 버전 이름으로서 모두 소문자로 설정.

  • EntityMetadata.SchemaName: 엔터티를 위한 데이터베이스 표를 생성하는 데 사용될 이름. 이 이름은 대/소문자를 섞어 사용할 수 있습니다. 사용하는 대/소문자는 프로그래밍 방식으로 생성된 개체의 이름을 강력한 유형 또는 REST 끝점을 사용할 때 설정합니다.

참고

논리적 이름이 스키마 이름과 다르면 스키마 이름은 논리적 이름에 설정한 값을 다시 정의합니다.

특정 솔루션 컨텍스트에서 응용 프로그램에 엔터티를 만들면 사용된 사용자 지정 접두사는 솔루션의 Publisher에 대한 한 설정입니다. 엔터티를 프로그래밍 방식으로 만들 때 사용자 지정 접두사를 2~8자로 된 모든 영숫자 문자열로 설정할 수 있으며 문자로 시작해야 합니다. “mscrm”으로 시작할 수 없습니다. 효율적인 방법은 솔루션에 연결된 게시자가 정의한 사용자 지정 접두사를 사용하는 것이지만 반드시 그럴 필요는 없습니다. 사용자 지정 접두사와 논리 또는 스키마 이름 사이에는 밑줄 문자가 포함되어야 합니다.

소유권 형태

EntityMetadata.OwnershipType 속성을 사용하여 이를 설정합니다.OwnershipTypes 열거형을 사용하여 엔터티 소유권 형태의 유형을 설정합니다. 사용자 지정 엔터티에 유효한 값은 OrgOwned 또는 UserOwned뿐입니다. 자세한 내용은 8597998f-764f-4c73-b63d-9f5e02c78061#EntityOwnership을 참조하십시오.

기본 특성

CreateEntityRequest.PrimaryAttribute를 사용하여 이를 설정합니다. 각 엔터티에는 StringFormat.Text를 기본 특성으로 사용하는 StringAttributeMetadata 특성이 있습니다. 이 특성의 값은 관련 엔터티 조회 시 표시되는 값입니다. 따라서 필드 값은 엔터티 레코드에 대한 이름을 나타내야 합니다.

엔터티 기능 활성화

다음 표에는 엔터티 기능이 나와 있습니다. 엔터티를 만들 때 이러한 기능을 설정하거나 나중에 활성화할 수 있습니다. 이러한 기능은 한 번 활성화하면 비활성화할 수 없습니다.

기능

설명

비즈니스 프로세스 플로

비즈니스 프로세스 플로를 위한 엔터티를 활성화하기 위해 EntityMetadataIsBusinessProcessEnabled를 참으로 설정하십시오.

메모

CreateEntityRequest 또는 UpdateEntityRequest.HasNotes 속성을 사용하여 Annotation 엔터티와의 엔터티 관계를 만들고 엔터티 양식에 메모 영역을 포함할 수 있도록 합니다.메모를 포함하여 첨부 파일을 레코드에 추가할 수도 있습니다.

활동

모든 활동 유형 엔터티를 이 엔터티와 연결할 수 있도록 CreateEntityRequest 또는 UpdateEntityRequest.HasActivities 속성을 사용하여 ActivityPointer 엔터티와의 엔터티 관계를 만듭니다.

연결

EntityMetadata.IsConnectionsEnabled 속성을 설정하여 이 엔터티와 다른 연결 엔터티를 연결하는 연결 레코드를 만들 수 있습니다.

대기열

EntityMetadata.IsValidForQueue 속성을 사용하여 큐에 대한 지원을 추가합니다. 이 옵션을 활성화하면 EntityMetadata.AutoRouteToOwnerQueue 속성을 설정하여 이 유형의 레코드를 만들거나 할당할 때 레코드를 담당자의 기본 큐로 자동으로 이동할 수도 있습니다.

전자 메일

전자 메일을 이 유형의 레코드로 전자 메일 주소에 보낼 수 있도록 EntityMetadata.IsActivityParty 속성을 설정합니다.

편집 가능한 엔터티 속성

다음 표에는 편집할 수 있는 엔터티 속성이 나와 있습니다. 관리 속성이 이러한 옵션을 허용하지 않을 경우 언제든지 업데이트할 수 있습니다.

속성

설명

빨리 만들기 허용

EntityMetadata.IsQuickCreateEnabled를 사용하여 엔터티에 대한 양식을 빠르게 만들 수 있습니다. 빨리 만들기 양식을 사용하려면 먼저 빨리 만들기 양식을 만들어 게시해야 합니다.

참고

활동 엔터티는 빨리 만들기 양식을 지원하지 않습니다.

액세스 팀

EntityMetadata.AutoCreateAccessTeams을 사용하여 액세스 팀에 엔터티를 사용하도록 설정합니다. 자세한 내용은 도움말 및 교육: 팀 템플릿 정보를 참조하십시오.

기본 이미지

엔터티에 이미지 특성이 있을 경우 PrimaryImageAttribute를 사용하여 응용 프로그램에서 해당 이미지를 표시하거나 표시하지 않도록 설정할 수 있습니다. 자세한 내용은 8597998f-764f-4c73-b63d-9f5e02c78061#BKMK_EntityImages를 참조하십시오.

표시 텍스트 변경

관리 속성 EntityMetadata.IsRenameable은 응용 프로그램에서 표시 이름이 변경되지 않도록 합니다.EntityMetadata.DisplayNameEntityMetadata.DisplayCollectionName 속성을 업데이트하면 프로그래밍 방식으로 레이블을 계속 변경할 수 있습니다.

엔터티 설명 편집

관리 속성 EntityMetadata.IsRenameable은 응용 프로그램에서 엔터티 설명이 변경되지 않도록 합니다.EntityMetadata.Description 속성을 업데이트하면 프로그래밍 방식으로 레이블을 계속 변경할 수 있습니다.

오프라인 중 사용 활성화

EntityMetadata.IsAvailableOffline을 사용하여 이 엔터티에 대한 데이터를 오프라인 상태로 만드는 Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능) 사용자의 기능을 활성화하거나 비활성화합니다.

Outlook 읽기 창 사용

참고

EntityMetadata.IsReadingPaneEnabled 속성은 내부 전용입니다.입니다.

이 엔터티에 대한 데이터를 보는 Outlook용 Microsoft Dynamics 365 사용자의 기능을 활성화하거나 비활성화하려면 Microsoft Outlook 읽기 창을 사용합니다. 응용 프로그램에서 이 속성을 설정해야 합니다.

편지 병합 사용

EntityMetadata.IsMailMergeEnabled를 사용하여 이 엔터티에 대한 데이터를 사용하는 Microsoft Office Word 병합 문서를 생성할 수 있는 기능을 활성화하거나 비활성화합니다.

중복 검색 사용

EntityMetadata.IsDuplicateDetectionEnabled를 사용하여 엔터티에 대한 중복 검색을 활성화하거나 비활성화합니다. 자세한 내용은 중복 데이터 검색을 참조하십시오.

SharePoint 통합 사용

EntityMetadata.IsDocumentManagementEnabled를 사용하여 엔터티에 대한 SharePoint Server 통합을 활성화하거나 비활성화합니다. 자세한 내용은 엔터티에 대해 문서 관리 사용을 참조하십시오.

휴대폰용 Dynamics 365 사용

EntityMetadata.IsVisibleInMobile을 사용하여 이 엔터티에 대한 데이터를 표시하는 휴대폰용 Microsoft Dynamics 365 사용자의 기능을 활성화하거나 비활성화합니다.

태블릿용 Dynamics 365

EntityMetadata.IsVisibleInMobileClient를 사용하여 이 엔터티에 대한 데이터를 표시하는 태블릿용 Microsoft Dynamics 365 사용자의 기능을 활성화하거나 비활성화합니다.

태블릿용 Dynamics 365에서 엔터티를 사용할 수 있는 경우 EntityMetadata.IsReadOnlyInMobileClient를 사용하여 레코드의 데이터를 읽기 전용으로 지정할 수 있습니다.

감사 사용

EntityMetadata.IsAuditEnabled를 사용하여 엔터티에 대한 감사를 활성화하거나 비활성화합니다. 자세한 내용은 감사할 엔터티 및 특성 구성을 참조하십시오.

엔터티가 표시되는 영역 변경

엔터티 표가 응용 프로그램 탐색 창에 표시되는 위치를 제어할 수 있습니다. 이는 사이트 맵에서 제어됩니다. 자세한 내용은 사이트 맵 편집을 참조하십시오.

특성 추가 또는 제거

관리 속성 EntityMetadata.CanCreateAttributes에서 특성을 만들 수 있으면 CreateAttributeRequest 메시지를 사용하여 특성을 추가할 수 있습니다. 자세한 내용은 Customize 특성 메타데이터 메시지을 참조하십시오.

보기 추가 또는 제거

관리 속성 EntityMetadata.CanCreateViews에서 보기를 만들 수 있으면 SavedQuery 엔터티를 사용하여 엔터티에 대한 보기를 만들 수 있습니다.

차트 추가 또는 제거

관리 속성 EntityMetadata.CanCreateCharts에서 차트를 만들 수 있고 EntityMetadata.IsEnabledForCharts 엔터티 속성이 true이면 SavedQueryVisualization을 사용하여 엔터티에 대한 차트를 만들 수 있습니다. 자세한 내용은 시각화(차트)를 사용하여 데이터 보기을 참조하십시오.

엔터티 관계 추가 또는 제거

엔터티에 대해 만들 수 있는 엔터티 관계의 유형을 제어하는 관리 속성은 여러 개 있습니다. 자세한 내용은 엔터티 관계 메타데이터 사용자 지정을 참조하십시오.

아이콘 변경

사용자 지정 엔터티에 사용된 아이콘을 변경할 수 있습니다. 자세한 내용은 엔터티의 아이콘 수정을 참조하십시오.

사용자 지정 도움말 사용

EntityMetadata.EntityHelpUrlEnabled는 엔터티를 위한 맞춤 도움말의 활성화 여부를 통제합니다.추가 정보:사용자 지정 도움말 콘텐츠 추가.

도움말 URL

EntityMetadata.EntityHelpUrl은 도움말 URL이 활성화되는 경우 엔터티의 도움말 콘텐츠를 위해 무슨 리소스가 표시되는지를 통제합니다.추가 정보:사용자 지정 도움말 콘텐츠 추가.

계층적 관계를 변경할 수 있음

EntityMetadata.CanChangeHierarchicalRelationship는 관리형 솔루션에 포함된 엔터티 관계의 계층 상태를 변경할 수 있는지의 여부를 통제합니다.추가 정보:

엔터티 메타데이터 메시지

다음 표에는 엔터티 메타데이터를 만들고, 검색, 업데이트 및 삭제하는 데 사용할 수 있는 메시지가 나와 있습니다.

메시지 이름

설명

CreateEntityRequest

사용자 지정 엔터티를 만듭니다.

DeleteEntityRequest

사용자 지정 엔터티를 삭제합니다.

RetrieveAllEntitiesRequest

모든 엔터티에 대한 메타데이터를 검색합니다.

RetrieveEntityRequest

엔터티에 대한 메타데이터를 검색합니다.

UpdateEntityRequest

엔터티에 대한 메타데이터를 업데이트합니다.

RetrieveMetadataChangesRequest

Microsoft.Xrm.Sdk.Metadata.Query 네임스페이스에서 개체와 함께 사용하여 특정 메타데이터에 대한 변경을 효율적으로 검색하고 감지하기 위한 쿼리를 만듭니다.추가 정보:메타데이터에 대한 변경 내용을 검색합니다..

사용자 지정 엔터티에서 지원하는 메시지

사용자 지정 엔터티는 시스템 엔터티와 동일한 기본 메시지를 지원합니다. 사용할 수 있는 메시지 집합은 사용자 지정 엔터티가 사용자 담당인지 아니면 조직 담당인지에 따라 달라집니다. 자세한 내용은 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords을 참조하십시오.

참고 항목

Dynamics 365 메타데이터에서 조직 서비스 사용
Microsoft Dynamics 365에서 엔터티에 대한 소개
조직에 대한 메타데이터 찾아보기
Customize 특성 메타데이터 메시지
엔터티 관계 메타데이터 사용자 지정
중복 데이터 검색
엔터티에 대해 문서 관리 사용
감사할 엔터티 및 특성 구성
사이트 맵 편집
시각화(차트)를 사용하여 데이터 보기
사용자 지정 가능한 엔터티는 무엇입니까?
사용자 지정 엔터티 만들기
엔터티 검색, 업데이트 및 삭제
전자 메일 가능한 엔터티 만들기 및 업데이트
사용자 지정 활동 엔터티 만들기
엔터티의 아이콘 수정
엔터티의 메시지 수정
샘플: 엔터티 메타데이터 만들기 및 업데이트
샘플: 사용자 지정 활동 엔터티 만들기
샘플: 전자 메일 가능한 엔터티 만들기 및 업데이트
샘플: 파일에 엔터티 메타데이터 덤프
샘플: 파일에 엔터티 권한 정보 덤프

Microsoft Dynamics 365

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