Dataverse 테이블/엔터티 참조

이 참조를 사용하여 특정 테이블에 사용 가능한 작업, 각 테이블의 기본 열 및 테이블 간의 관계를 이해할 수 있습니다. 테이블 정의는 EntityMetadata 클래스를 사용합니다.

이 참조에는 다음과 같은 테이블만 포함됩니다.

  • EntityMetadata.IsPrivate 같음 false

    이 조건은 외부 사용 사례가 없는 테이블을 제외합니다.

  • EntityMetadata.IsIntersect 같 false 거나 IsIntersect 가 true 같고 테이블에 4개 이상의 열이 포함됩니다.

    대부분의 교차 테이블에는 다대다 관계를 지원하는 데 필요한 4개의 열만 포함됩니다. 유용하지 않습니다. 4개 이상의 열이 있는 테이블을 교차하는 것은 일반적이지 않으며 더 흥미롭습니다.

환경의 모든 테이블에 대한 정보를 보려면 사용자 환경에서 테이블 정의 찾아보기를 참조하세요.

Dynamics 365 제품 테이블 참조

Dynamics 365 제품은 Dataverse를 사용합니다. Dynamics 365 제품에 대한 환경을 만들 때 환경에는 모든 Dynamics 365 제품에 대한 공통 테이블 집합이 있습니다. Dynamics 365 사용 앱 테이블/엔터티 참조를 참조하세요.

각 특정 Dynamics 365 제품은 테이블을 더 추가할 수 있습니다. 다음 표에서는 특정 Dynamics 365 제품에 대한 테이블 참조를 보여 줍니다.

제품 문서 제품 테이블 참조
판매 판매 테이블/엔터티 참조
현장 서비스 Field Service 테이블/엔터티 참조
고객 서비스 Customer Service 테이블/엔터티 참조

속성

이 섹션에는 모든 엔터티 속성이 아닌 선택한 엔터티 속성이 포함됩니다. 개발자에게 가장 유용한 속성만 포함됩니다. 일부 엔터티 속성 값을 변경할 수 있습니다.

칼럼

열은 두 개의 개별 섹션에 나열됩니다.

섹션 Description
쓰기 가능한 열/특성 테이블에서 행을 만들거나 업데이트할 때 설정할 수 있는 열입니다. 이러한 열은 일반적으로 둘 다 또는 속성에 대해 AttributeMetadata.IsValidForCreateAttributeMetadata.IsValidForUpdate 반환 true 됩니다. 두 속성 중 하나가 반환 false되면 이 조건이 표시됩니다.
읽기 전용 열/특성 검색할 수 있지만 테이블에서 행을 만들거나 업데이트할 때 설정할 수 없는 열입니다. 이러한 열은 항상 속성과 AttributeMetadata.IsValidForUpdate 속성 모두에 AttributeMetadata.IsValidForCreate 대해 반환 false 됩니다.

선택 항목 열 옵션

이 참조 설명서의 선택 열 옵션은 영어가 기본 언어인 배포에서 제공됩니다. 일부 선택 옵션은 환경을 만들 때 선택한 기본 언어에 따라 달라질 수 있습니다. 이러한 차이는 언어 또는 문화권에 가장 적합한 옵션에 더 밀접하게 맞춥니다. 레이블을 변경하거나 필요에 따라 옵션을 추가 및 제거하여 이러한 옵션을 사용자 지정할 수 있습니다.

관계

EntityMetadata 클래스에는 관계를 나타내는 세 가지 속성이 포함되어 있습니다.

재산 유형 Description
OneToManyRelationships OneToManyRelationshipMetadata[] 엔터티에 대한 일대다 관계의 배열을 가져옵니다.
ManyToOneRelationships OneToManyRelationshipMetadata[] 엔터티에 대한 다대일 관계의 배열을 가져옵니다.
ManyToManyRelationships ManyToManyRelationshipMetadata[] 엔터티에 대한 다대다 관계의 배열을 가져옵니다.

비고

각 테이블에 적용되는 관계가 나열되지만 각 관계는 두 테이블에서 공유됩니다. 관계는 테이블 간에 존재합니다. 일대다 관계가 존재하지만 다대 일 관계는 참조 테이블의 일대다 관계에 대한 보기일 뿐입니다.

다 대 일 관계

다음 OneToManyRelationshipMetadata 클래스 속성을 포함합니다.

재산 Description
ReferencedEntity 관련 테이블의 논리적 이름입니다.
ReferencedAttribute 관련 테이블의 기본 키의 논리적 이름입니다.
ReferencingEntity 조회 열이 있는 관련 테이블의 논리적 이름입니다.
ReferencingAttribute 기본 테이블의 기본 키에 대한 참조를 포함하는 관련 테이블의 조회 열의 논리적 이름입니다.
IsHierarchical 관계가 자기 참조 계층 관계를 나타내는지 여부
CascadeConfiguration 부모 엔터티에서 수행된 작업을 설명하는 데이터는 관련 엔터티로 연계됩니다.
자세한 내용은 Cascade 구성을 참조하세요.

일대다 관계

다음 OneToManyRelationshipMetadata 클래스 속성을 포함합니다.

재산 Description
ReferencingEntity 관련 테이블의 논리적 이름입니다.
ReferencingAttribute 기본 테이블의 기본 키에 대한 참조를 포함하는 관련 테이블의 열의 논리적 이름입니다.
IsCustomizable 관계의 속성을 변경할 수 있는지 여부입니다.
ReferencedEntityNavigationPropertyName 이 관계에 대한 Web API 컬렉션 반환 탐색 속성의 이름입니다.
자세한 내용은 Web API 탐색 속성을 참조하세요.
AssociatedMenuConfiguration 모델 기반 앱에서 기본 엔터티의 UI에서 관련 엔터티 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다.

다대다 관계

각 다대다 관계에는 Entity1LogicalName 및 Entity2LogicalName이 포함됩니다. 이 설명서의 경우 관계 세부 정보는 현재 테이블의 컨텍스트에서 제공됩니다. Entity1 또는 Entity2가 중요한지 여부입니다.

각 다 대 다 관계에 대해 다음 ManyToManyRelationshipMetadata 클래스 속성이 포함됩니다.

재산 Description
IntersectEntityName 이 다대다 관계를 지원하는 교차 테이블의 논리적 이름입니다.
IsCustomizable 관계의 속성을 변경할 수 있는지 여부입니다.
SchemaName 관계의 스키마 이름입니다.
IntersectAttribute(Entity1IntersectAttribute 또는 Entity2IntersectAttribute) 이 형식의 레코드에 대한 기본 키인 교차 테이블의 열 이름입니다.
NavigationPropertyName(Entity1NavigationPropertyName 또는 Entity2NavigationPropertyName) 이 관계에 대한 Web API 컬렉션 반환 탐색 속성의 이름입니다.
추가 정보: Web API 탐색 속성
AssociatedMenuConfiguration(Entity1AssociatedMenuConfiguration 또는 Entity2AssociatedMenuConfiguration) 모델 기반 앱에서 이 테이블의 UI에서 두 번째 테이블 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다.

연결 역할(ConnectionRole) connectionroleassociation_association, Entity1 또는 Entity2처럼 드물게 다대다 관계가 자체 참조에 대해 자체 참조되거나 속성 앞에 추가되는 경우.

재산 가치
Entity1IntersectAttribute 첫 번째 테이블로서 이 형식의 레코드에 대한 기본 키인 교차 테이블의 열 이름입니다.
Entity2IntersectAttribute 두 번째 테이블로서 이 형식의 레코드에 대한 기본 키인 교차 테이블의 열 이름입니다.
Entity1NavigationPropertyName 첫 번째 테이블로서 이 관계에 대한 Web API 컬렉션 반환 탐색 속성의 이름입니다.
Entity2NavigationPropertyName 두 번째 테이블로서 이 관계에 대한 Web API 컬렉션 반환 탐색 속성의 이름입니다.
Entity1AssociatedMenuConfiguration 모델 기반 앱에서 첫 번째 테이블로서 이 테이블의 UI에서 두 번째 테이블 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다.
Entity2AssociatedMenuConfiguration 모델 기반 앱에서 두 번째 테이블 데이터를 이 테이블의 UI에서 두 번째 테이블로 액세스할 수 있는지 여부와 방법을 제어하는 데 사용되는 데이터입니다.