Dataverse 테이블은 모든 환경 데이터베이스에 있는 공통 테이블 집합을 제공합니다.
Dynamics 365 사용 앱 테이블/엔터티 참조 에는 Sales와 같은 Dynamics 365 앱을 설치하기 전에 필요한 추가 테이블이 포함되어 있습니다.
여기에 나열된 테이블은 사용자가 만든 환경에 Dataverse를 추가하는 동안 Dynamics 365 Sales를 설치하도록 선택할 때 추가되거나 수정됩니다.
이 참조에는 다음과 같은 테이블만 포함됩니다.
IsPrivate이
false와 같습니다- 외부 사용 케이스가 없는 테이블은 제외됩니다. 프라이빗 테이블에 대해 자세히 알아보기
IsIntersect가
false와 같거나 IsIntersect가true과 같고 테이블에 4개 이상의 열이 포함됩니다.- 대부분의 교차 테이블에는 다대다 관계를 지원하는 데 필요한 4개의 열만 포함됩니다. 이들은 유용하지 않습니다. 열이 4개 이상인 교차 테이블이 더 흥미롭습니다.
Messages
이 목록의 메시지는 엔터티에 적용할 수 있습니다. 예를 들어 사용자 소유 테이블은 Assign, GrantAccess, ModifyAccess 및 RevokeAccess 메시지를 지원하지만 조직 소유 테이블은 지원하지 않습니다.
.NET용 SDK
.NET용 SDK를 사용하는 경우 일반적으로 Microsoft.Crm.Sdk.Messages 또는 Microsoft.Xrm.Sdk.Messages 네임스페이스에 속하는 해당 요청 클래스를 호출할 수 있습니다. 이러한 클래스에는 메시지 이름에 추가된 Request 접두사가 포함된 이름이 있습니다.
일부 메시지는 지원하는 솔루션에 대해 사용자 지정 작업으로 추가됩니다. 이러한 메시지는 SDK 어셈블리 내에 정의되어 있지 않지만 사용할 수 있는 몇 가지 방법이 있습니다.
인터넷 응용 프로그램 인터페이스
Web API를 사용할 때 다음 참조에 정의된 일반적인 Dataverse OData 함수 및 작업을 찾을 수 있습니다.
이러한 함수와 작업 및 추가된 함수와 작업에 대해 다음을 통해 이를 사용하는 방법을 확인할 수 있습니다.
- 매개 변수 및 반환 값에 대한 자세한 내용은 $metadata 서비스 문서를 검토합니다. 자세한 내용은 작업 정의 및 함수 정의를 참조하십시오.
- 작업 및 함수를 호출합니다. 자세한 내용은 Web API 작업 사용 및 Web API 함수 사용을 참조하십시오.
Events
이벤트는 구독할 수 있도록 존재하는 메시지입니다. 이벤트를 추가하지 않는 한 메시지를 호출하지 말고 구독하기만 하면 됩니다. 다음과 같은 여러 가지 방법으로 이벤트를 구독할 수 있습니다.
- 작업 수행 시 트리거를 사용하여 Power Automate Dataverse 커넥터를 사용합니다.
- 이벤트에 응답할 Dataverse 플러그 인을 등록합니다.
- Dataverse Azure 통합을 사용하여 Azure 또는 웹 후크에 이벤트 데이터 보내기
속성
이 섹션에는 모든 엔터티 속성이 아닌 선택한 엔터티 속성이 포함됩니다. 개발자에게 가장 유용할 것으로 예상되는 속성만 포함됩니다. 일부 엔터티 속성 값은 변경할 수 있습니다.
칼럼
열은 쓰기 가능한 열/특성과 읽기 전용 열/특성의 두 섹션으로 나열됩니다. 이 분리의 목적은 개발자가 테이블에서 행을 만들거나 업데이트할 때 설정할 수 있는 열에 초점을 맞추는 것입니다. 이러한 열을 이해하면 개발자가 단순히 값을 검색하는 것 이상으로 테이블로 수행할 수 있는 작업을 이해하는 데 도움이 됩니다.
쓰기 가능한 열/특성 섹션의 열은 IsValidForCreate 또는 IsValidForUpdate 속성 중 하나(일반적으로 둘 다)에 대해 true를 반환합니다. 이러한 속성 중 하나가 false를 반환하면 이 표시가 표시됩니다.
읽기 전용 열/특성은 IsValidForCreate및IsValidForUpdate 속성에 대해 항상 false를 반환합니다.
이 참조 설명서의 선택 열 옵션은 영어가 기본 언어인 배포에서 제공됩니다. 일부 선택 옵션은 환경을 만들 때 선택한 기본 언어에 따라 달라질 수 있습니다. 이러한 차이점은 언어나 문화권에 가장 적합한 옵션과 더 밀접하게 일치합니다. 필요에 따라 레이블을 변경하거나 옵션을 추가 및 제거하여 이러한 옵션을 자유롭게 사용자 정의할 수 있습니다.
관계
EntityMetadata 클래스에는 관계를 나타내는 세 가지 속성이 포함되어 있습니다.
| 재산 | 유형 | Description |
|---|---|---|
| OneToManyRelationships | OneToManyRelationshipMetadata[] | 엔터티에 대한 일대다 관계의 배열을 가져옵니다. |
| ManyToOneRelationships | OneToManyRelationshipMetadata[] | 엔터티에 대한 다대일 관계의 배열을 가져옵니다. |
| ManyToManyRelationships | ManyToManyRelationshipMetadata[] | 엔터티에 대한 다대다 관계의 배열을 가져옵니다. |
비고
각 테이블에는 적용되는 관계가 나열되지만 각 관계는 두 테이블에서 공유된다는 점을 명심해야 합니다. 관계는 테이블 간에 존재합니다. 일대다 관계는 존재하지만 다대일 관계는 단순히 참조 테이블에서 일대다 관계를 보는 것입니다.
다대일 관계
다음 OneToManyRelationship 속성을 포함합니다.
| 재산 | Description |
|---|---|
ReferencedEntity |
관련 테이블의 논리적 이름입니다. |
ReferencedAttribute |
관련 테이블의 기본 키의 논리적 이름입니다. |
ReferencingEntity |
조회 열이 있는 관련 테이블의 논리적 이름입니다. |
ReferencingAttribute |
기본 테이블의 기본 키에 대한 참조를 포함하는 관련 테이블의 조회 열의 논리적 이름입니다. |
IsHierarchical |
관계가 자기 참조 계층 관계를 나타내는지 여부 |
CascadeConfiguration |
상위 엔터티에서 수행되는 작업을 설명하는 데이터는 관련 엔터티로 계단식으로 전달됩니다. 추가 정보: 계단식 구성 |
일대다 관계
다음 OneToManyRelationship 속성을 포함합니다.
| 재산 | Description |
|---|---|
ReferencingEntity |
관련 테이블의 논리적 이름입니다. |
ReferencingAttribute |
기본 테이블의 기본 키에 대한 참조를 포함하는 관련 테이블의 열의 논리적 이름입니다. |
IsCustomizable |
관계의 속성을 변경할 수 있는지 여부입니다. |
ReferencedEntityNavigationPropertyName |
이 관계에 대한 Web API 컬렉션 반환 탐색 속성의 이름입니다. 추가 정보: Web API 탐색 속성 |
AssociatedMenuConfiguration |
모델 기반 앱에서 기본 엔터티의 UI에서 관련 엔터티 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다. |
다대다 관계
각 다대다 관계에는 Entity1LogicalName 및 Entity2LogicalName이 포함됩니다. 이 설명서의 경우 관계 세부 정보는 현재 테이블의 컨텍스트에서 제공됩니다.
Entity1 또는 Entity2가 중요한지 여부입니다.
각 다대다 관계에 대해 다음 속성이 포함됩니다.
| 재산 | Description |
|---|---|
IntersectEntityName |
이 다대다 관계를 지원하는 교차 테이블의 논리적 이름입니다. FetchXml을 사용하여 테이블 열을 조인할 때 이 값을 사용할 수 있습니다. |
IsCustomizable |
관계의 속성을 변경할 수 있는지 여부입니다. |
SchemaName |
관계의 스키마 이름입니다. |
IntersectAttribute |
이 형식의 레코드에 대한 기본 키인 교차 테이블의 열 이름입니다. |
NavigationPropertyName |
이 관계에 대한 Web API 컬렉션 반환 탐색 속성의 이름입니다. 추가 정보: Web API 탐색 속성 |
AssociatedMenuConfiguration |
모델 기반 앱에서 이 테이블의 UI에서 두 번째 테이블 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다. |
연결 역할(ConnectionRole) connectionroleassociation_association, Entity1 또는 Entity2처럼 드물게 다대다 관계가 자체 참조에 대해 자체 참조되거나 속성 앞에 추가되는 경우.
| 재산 | 가치 |
|---|---|
Entity1IntersectAttribute |
첫 번째 테이블로서 이 형식의 레코드에 대한 기본 키인 교차 테이블의 열 이름입니다. |
Entity2IntersectAttribute |
두 번째 테이블로서 이 형식의 레코드에 대한 기본 키인 교차 테이블의 열 이름입니다. |
Entity1NavigationPropertyName |
첫 번째 테이블로서 이 관계에 대한 Web API 컬렉션 반환 탐색 속성의 이름입니다. |
Entity2NavigationPropertyName |
두 번째 테이블로서 이 관계에 대한 Web API 컬렉션 반환 탐색 속성의 이름입니다. |
Entity1AssociatedMenuConfiguration |
모델 기반 앱에서 첫 번째 테이블로서 이 테이블의 UI에서 두 번째 테이블 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다. |
Entity2AssociatedMenuConfiguration |
모델 기반 앱에서 두 번째 테이블로서 이 테이블의 UI에서 두 번째 테이블 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다. |