웹 API를 Dynamics 365 메타데이터와 함께 사용
게시 날짜: 2017년 1월
적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
조직 서비스를 사용하여 수행할 수 있는 웹 API로 어떠한 메타데이터 작업이든 수행할 수 있습니다. 이 섹션에서는 Web API Metadata EntityType Reference에 포함된 엔터티 유형과 웹 API를 사용하는 방법에 대한 지침을 제공합니다.
다음 표에 설명된 것처럼 메타데이터로 작업을 수행하기 위해 노출된 엔터티 집합 경로는 4개가 있습니다.
엔터티 설정 경로 |
설명 |
---|---|
[조직 URI]/api/data/v8.2/EntityDefinitions |
EntityMetadata EntityType 엔터티를 포함합니다. |
[조직 URI]/api/data/v8.2/RelationshipDefinitions |
RelationshipMetadataBase EntityType에서 상속된 ManyToManyRelationshipMetadata EntityType 및 OneToManyRelationshipMetadata EntityType을 포함합니다. |
[조직 URI]/api/data/v8.2/GlobalOptionSetDefinitions |
OptionSetMetadataBase EntityType에서 상속된 전역으로 정의된 BooleanOptionSetMetadata EntityType 및 OptionSetMetadata EntityType을 포함합니다. |
[조직 URI]/api/data/v8.2/ManagedPropertyDefinitions |
내부 전용입니다. |
각 메타데이터 엔터티 유형은 MetadataId를 고유 식별자 속성으로 사용합니다. 이는 MetadataBase EntityType에서 상속된 것입니다. 모든 메타데이터 엔터티는 MetadataId를 가지며, 모두를 직접 쿼리할 수 없습니다. 예를 들면 특성을 포함하는 EntityMetadata의 컨텍스트에서만 특성에 대한 작업을 쿼리하고 수행할 수 있습니다.
이러한 엔터티는 비즈니스 및 응용 프로그램 데이터를 저장하는 엔터티와 상당한 차이가 있는데 예를 들면 다음과 같습니다.
엔터티 메타데이터에 대한 속성은 crmbaseentity EntityType에서 상속되는 엔터티의 속성에 사용되는 기본 데이터 형식이 아닌 Web API ComplexType Reference 및 Web API EnumType Reference에 정의된 여러 복잡한 열거형 유형을 사용합니다.
메타데이터 엔터티는 다른 명명 규칙을 따르고 조직 서비스의 어셈블리에 사용된 파스칼식 대/소문자 명명 스타일을 유지합니다.
메타데이터 엔터티는 상속을 더욱 광범위하게 사용합니다. 따라서 원하는 데이터를 검색하기 위해 캐스팅을 수행해야 할 수도 있습니다.
이 섹션의 내용
웹 API를 사용하는 메타데이터 쿼리
웹 API를 사용하여 RetrieveMetadataChangesRequest 그리고 조직 서비스를 사용하는 Microsoft.Xrm.Sdk.Metadata.Query 네임스페이스의 개체를 사용할 때와 유사한 방식으로 웹 API를 사용할 수 있습니다.이름 또는 MetadataId로 메타데이터 검색
메타 데이터를 쿼리하여 응용 프로그램을 구성 변경 내용에 맞게 변경할 수 있습니다. 메타데이터 항목의 주요 속성 중 하나를 알고 있는 경우 웹 API를 사용하여 메타데이터 정의를 검색할 수 있습니다.Web API를 사용하여 엔터티 정의 만들기 및 업데이트
웹 API를 사용하여 특성 및 엔터티를 만들고 업데이트하면 조직 서비스 CreateEntityRequest, UpdateEntityRequest, CreateAttributeRequest, 및 UpdateAttributeRequest을 사용했을 때와 동일한 결과를 얻을 수 있습니다.Web API를 사용하여 엔터티 관계 만들기 및 업데이트
엔터티가 다른 엔터티와의 관계에 참여할 수 있는지 확인한 다음 웹 API를 사용하여 이러한 관계를 만들고 업데이트할 수 있습니다.
참고 항목
Microsoft Dynamics 365의 메타데이터 및 데이터 모델
조직에 대한 메타데이터 찾아보기
Dynamics 365 메타데이터에서 조직 서비스 사용
Microsoft Dynamics 365 웹 API 사용
Microsoft Dynamics 365
© 2017 Microsoft. All rights reserved. 저작권 정보