다음을 통해 공유


웹 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 EntityTypeOneToManyRelationshipMetadata EntityType을 포함합니다.

[조직 URI]/api/data/v8.2/GlobalOptionSetDefinitions

OptionSetMetadataBase EntityType에서 상속된 전역으로 정의된 BooleanOptionSetMetadata EntityTypeOptionSetMetadata EntityType을 포함합니다.

[조직 URI]/api/data/v8.2/ManagedPropertyDefinitions

내부 전용입니다.

각 메타데이터 엔터티 유형은 MetadataId를 고유 식별자 속성으로 사용합니다. 이는 MetadataBase EntityType에서 상속된 것입니다. 모든 메타데이터 엔터티는 MetadataId를 가지며, 모두를 직접 쿼리할 수 없습니다. 예를 들면 특성을 포함하는 EntityMetadata의 컨텍스트에서만 특성에 대한 작업을 쿼리하고 수행할 수 있습니다.

이러한 엔터티는 비즈니스 및 응용 프로그램 데이터를 저장하는 엔터티와 상당한 차이가 있는데 예를 들면 다음과 같습니다.

  • 엔터티 메타데이터에 대한 속성은 crmbaseentity EntityType에서 상속되는 엔터티의 속성에 사용되는 기본 데이터 형식이 아닌 Web API ComplexType ReferenceWeb API EnumType Reference에 정의된 여러 복잡한 열거형 유형을 사용합니다.

  • 메타데이터 엔터티는 다른 명명 규칙을 따르고 조직 서비스의 어셈블리에 사용된 파스칼식 대/소문자 명명 스타일을 유지합니다.

  • 메타데이터 엔터티는 상속을 더욱 광범위하게 사용합니다. 따라서 원하는 데이터를 검색하기 위해 캐스팅을 수행해야 할 수도 있습니다.

이 섹션의 내용

참고 항목

Microsoft Dynamics 365의 메타데이터 및 데이터 모델
조직에 대한 메타데이터 찾아보기
Dynamics 365 메타데이터에서 조직 서비스 사용
Microsoft Dynamics 365 웹 API 사용

Microsoft Dynamics 365

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