다음을 통해 공유


Dataverse 테이블/엔터티 참조

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

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

  • IsPrivatefalse와 같습니다

    • 외부 사용 케이스가 없는 테이블은 제외됩니다.
  • IsIntersectfalse와 같거나 IsIntersecttrue과 같고 테이블에 4개 이상의 열이 포함됩니다.

    • 대부분의 교차 테이블에는 다대다 관계를 지원하는 데 필요한 4개의 열만 포함됩니다. 이들은 유용하지 않습니다. 열이 4개 이상인 교차 테이블이 더 흥미롭습니다.

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

Dynamics 365 제품 테이블 참조

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

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

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

속성

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

칼럼

열은 쓰기 가능한 열/특성읽기 전용 열/특성의 두 섹션으로 나열됩니다. 이 분리의 목적은 개발자가 테이블에서 행을 만들거나 업데이트할 때 설정할 수 있는 열에 초점을 맞추는 것입니다. 이러한 열을 이해하면 개발자가 단순히 값을 검색하는 것 이상으로 테이블로 수행할 수 있는 작업을 이해하는 데 도움이 됩니다.

쓰기 가능한 열/특성 섹션의 열은 IsValidForCreate 또는 IsValidForUpdate 속성 중 하나(일반적으로 둘 다)에 대해 true를 반환합니다. 이러한 속성 중 하나가 false를 반환하면 이 표시가 표시됩니다.

읽기 전용 열/특성IsValidForCreateIsValidForUpdate 속성에 대해 항상 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에서 관련 엔터티 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다.

다대다 관계

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

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

재산 Description
IntersectEntityName 이 다 대 다 관계를 지원하는 교차 테이블의 논리적 이름
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에서 두 번째 테이블 데이터에 액세스할 수 있는지 여부와 방법을 제어하는 데 사용하는 데이터입니다.