แชร์ผ่าน


การอ้างอิงตาราง/เอนทิตีที่เปิดใช้งานแอป Dynamics 365

ตาราง Dataverse มีชุดตารางทั่วไปที่ฐานข้อมูลสภาพแวดล้อมทั้งหมดมี ตารางที่แสดงรายการที่นี่จะถูกเพิ่มหรือแก้ไขเมื่อคุณเลือก เปิดใช้งานแอป Dynamics 365 ในขณะที่คุณเพิ่ม Dataverse ไปยังสภาพแวดล้อมที่คุณสร้าง

เมื่อคุณมีสิทธิ์การใช้งานที่จําเป็น คุณสามารถติดตั้งผลิตภัณฑ์ Dynamics 365 ที่อาจเพิ่มตารางเพิ่มเติม หรือปรับแต่งตาราง Dynamics 365 หรือ Dataverse ที่มีอยู่

ตารางนี้แสดงรายการผลิตภัณฑ์ Dynamics 365 อื่นๆ ที่ขึ้นอยู่กับการอ้างอิงนี้:

เอกสารผลิตภัณฑ์ การอ้างอิงตารางผลิตภัณฑ์
ขาย การอ้างอิงตาราง/เอนทิตีการขาย
บริการภาคสนาม การอ้างอิงตาราง/เอนทิตี Field Service
บริการลูกค้า การอ้างอิงตาราง/เอนทิตี Customer Service

ข้อมูลอ้างอิงนี้รวมเฉพาะตารางที่:

  • IsPrivate เท่ากับ false

  • IsIntersect เท่ากับ false หรือ IsIntersect เท่ากับ true และตารางมีมากกว่า 4 คอลัมน์

    • ตารางที่ตัดกันส่วนใหญ่มีเพียง 4 คอลัมน์ที่จําเป็นในการสนับสนุนความสัมพันธ์แบบกลุ่มต่อกลุ่ม พวกเขาไม่มีประโยชน์ ตารางตัดที่มีมากกว่าสี่คอลัมน์น่าสนใจกว่า

ข้อความ

ข้อความในรายการนี้ใช้ได้กับเอนทิตี ตัวอย่างเช่น ตารางที่ผู้ใช้เป็นเจ้าของรองรับ Assign, , GrantAccessและ ModifyAccessRevokeAccess messages ในขณะที่ตารางขององค์กรไม่สนับสนุน

SDK สําหรับ .NET

เมื่อใช้ SDK สําหรับ .NET โดยปกติคุณสามารถเรียกใช้คลาสคําขอที่สอดคล้องกันซึ่งจะเป็นของเนมสเปซ Microsoft.Crm.Sdk.Messages หรือ Microsoft.Xrm.Sdk.Messages คลาสเหล่านี้มีชื่อที่มีคํานําหน้าที่ Request เพิ่มลงในชื่อข้อความ

ข้อความบางข้อความจะถูกเพิ่มเป็น การดําเนินการที่กําหนดเอง สําหรับโซลูชันที่รองรับ ข้อความเหล่านี้ไม่ได้กําหนดไว้ภายในแอสเซมบลี SDK แต่มีหลายวิธีที่คุณสามารถใช้ได้

เว็บ API

เมื่อใช้ Web API คุณสามารถค้นหาฟังก์ชันและการดําเนินการ Dataverse OData ทั่วไปที่กําหนดไว้ในการอ้างอิงเหล่านี้:

สําหรับฟังก์ชันและการกระทําเหล่านี้ และฟังก์ชันและการดําเนินการเพิ่มเติมใดๆ ที่เพิ่มเข้ามา คุณสามารถค้นพบวิธีใช้สิ่งเหล่านี้ได้โดย:

  1. ตรวจสอบ เอกสารบริการ $metadata สําหรับรายละเอียดเกี่ยวกับพารามิเตอร์และค่าที่ส่งคืน ดูรายละเอียดที่คําจํากัดความของการดําเนินการและคําจํากัดความของฟังก์ชัน
  2. เรียกใช้การกระทําและฟังก์ชัน ดูรายละเอียดได้ที่หัวข้อใช้การดําเนินการ Web API และใช้ฟังก์ชัน Web API

กิจกรรม

เหตุการณ์คือข้อความที่มีอยู่เพื่อให้คุณสามารถสมัครรับข้อมูลได้ เว้นแต่คุณจะเพิ่มเหตุการณ์ คุณไม่ควรเรียกใช้ข้อความ ให้สมัครรับข้อมูลเท่านั้น คุณสามารถสมัครรับกิจกรรมได้หลายวิธี เช่น

คุณสมบัติ

ส่วนนี้รวมคุณสมบัติเอนทิตีที่เลือกแทนที่จะเป็นคุณสมบัติทั้งหมด รวมเฉพาะคุณสมบัติที่คาดว่าจะเป็นประโยชน์สูงสุดสําหรับนักพัฒนาเท่านั้น ค่าคุณสมบัติของเอนทิตีบางค่าสามารถเปลี่ยนแปลงได้

คอลัมน์

คอลัมน์จะแสดงอยู่ในสองส่วนแยกกัน: คอลัมน์/แอตทริบิวต์ที่เขียนได้ และคอลัมน์/แอตทริบิวต์แบบอ่านอย่างเดียว จุดประสงค์ของการแยกนี้คือการมุ่งเน้นไปที่คอลัมน์ที่นักพัฒนาสามารถตั้งค่าได้เมื่อสร้างหรืออัปเดตแถวในตาราง การทําความเข้าใจคอลัมน์เหล่านี้ช่วยให้นักพัฒนาเข้าใจว่าพวกเขาสามารถทําอะไรได้บ้างกับตารางนอกเหนือจากการดึงค่า

คอลัมน์ในส่วนคอลัมน์ /แอตทริบิวต์ที่เขียนได้ ส่งกลับ true สําหรับคุณสมบัติIsValidForCreate หรือ IsValidForUpdate (โดยปกติจะเป็นทั้งสองอย่าง) หากคุณสมบัติอย่างใดอย่างหนึ่งเหล่านี้ส่งคืน false แสดงว่ามีการระบุสิ่งนี้

คอลัมน์/แอตทริบิวต์แบบอ่านอย่างเดียว จะส่งกลับ false สําหรับคุณสมบัติ IsValidForCreateและIsValidForUpdate เสมอ

ตัวเลือกคอลัมน์ตัวเลือกในเอกสารอ้างอิงนี้มาจากการปรับใช้ที่ภาษาอังกฤษเป็นภาษาพื้นฐาน ตัวเลือกบางอย่างอาจแตกต่างกันไปขึ้นอยู่กับภาษาพื้นฐานที่เลือกเมื่อสร้างสภาพแวดล้อม ความแตกต่างเหล่านี้สอดคล้องกับตัวเลือกที่เหมาะกับภาษาหรือวัฒนธรรมมากที่สุด คุณมีอิสระที่จะปรับแต่งตัวเลือกเหล่านี้โดยการเปลี่ยนป้ายกํากับหรือเพิ่มและลบตัวเลือกตามต้องการ

ความสัมพันธ์

คลาส EntityMetadata ประกอบด้วยคุณสมบัติสามรายการเพื่อแสดงความสัมพันธ์:

คุณสมบัติ ประเภท คำอธิบาย
ความสัมพันธ์แบบหนึ่งต่อหลาย OneToManyRelationshipMetadata[] รับอาร์เรย์ของความสัมพันธ์แบบหนึ่งต่อกลุ่มสําหรับเอนทิตี
ManyToOne ความสัมพันธ์ OneToManyRelationshipMetadata[] รับอาร์เรย์ของความสัมพันธ์แบบกลุ่มต่อหนึ่งสําหรับเอนทิตี
ManyToMany ความสัมพันธ์ ManyToManyRelationshipMetadata[] รับอาร์เรย์ของความสัมพันธ์แบบกลุ่มต่อกลุ่มสําหรับเอนทิตี

Note

สิ่งสําคัญคือต้องจําไว้ว่าในขณะที่แต่ละตารางแสดงรายการความสัมพันธ์เหล่านั้นที่ใช้กับตารางนั้น แต่แต่ละความสัมพันธ์จะถูกใช้ร่วมกันโดยทั้งสองตาราง ความสัมพันธ์มีอยู่ ระหว่าง ตาราง ในขณะที่ความสัมพันธ์แบบหนึ่งTo-Many มีอยู่ แต่ความสัมพันธ์ แบบกลุ่มต่อหนึ่ง เป็นเพียงมุมมองของความสัมพันธ์แบบTo-Many หนึ่งจากตารางอ้างอิง

ความสัมพันธ์แบบกลุ่มต่อหนึ่ง

รวมคุณสมบัติเหล่านี้ OneToManyRelationship :

คุณสมบัติ คำอธิบาย
ReferencedEntity ชื่อตรรกะของตารางที่เกี่ยวข้อง
ReferencedAttribute ชื่อตรรกะของคีย์หลักของตารางที่เกี่ยวข้อง
ReferencingEntity ชื่อตรรกะของตารางที่เกี่ยวข้องที่มีคอลัมน์การค้นหา
ReferencingAttribute ชื่อตรรกะของคอลัมน์การค้นหาในตารางที่เกี่ยวข้องที่มีการอ้างอิงไปยังคีย์หลักของตารางหลัก
IsHierarchical ความสัมพันธ์แสดงถึงความสัมพันธ์แบบลําดับชั้นอ้างอิงตนเองหรือไม่
CascadeConfiguration ข้อมูลที่อธิบายว่าการดําเนินการใดที่ดําเนินการกับเอนทิตีหลักจะเรียงซ้อนลงไปยังเอนทิตีที่เกี่ยวข้อง
ข้อมูลเพิ่มเติม: การกําหนดค่าเรียงซ้อน

ความสัมพันธ์แบบหนึ่งต่อกลุ่ม

รวมคุณสมบัติเหล่านี้ OneToManyRelationship :

คุณสมบัติ คำอธิบาย
ReferencingEntity ชื่อตรรกะของตารางที่เกี่ยวข้อง
ReferencingAttribute ชื่อตรรกะของคอลัมน์ในตารางที่เกี่ยวข้องที่มีการอ้างอิงไปยังคีย์หลักของตารางหลัก
IsCustomizable คุณสมบัติของความสัมพันธ์สามารถเปลี่ยนแปลงได้หรือไม่
ReferencedEntityNavigationPropertyName ชื่อของคุณสมบัติการนําทางที่มีค่าคอลเลกชัน Web API สําหรับความสัมพันธ์นี้
ข้อมูลเพิ่มเติม: คุณสมบัติการนําทาง Web API
AssociatedMenuConfiguration ข้อมูลที่ใช้โดยแอปแบบจําลองเพื่อควบคุมว่าสามารถเข้าถึงข้อมูลเอนทิตีที่เกี่ยวข้องใน UI จากเอนทิตีหลักได้หรือไม่

ความสัมพันธ์แบบกลุ่มต่อกลุ่ม

ความสัมพันธ์แบบกลุ่มต่อกลุ่มแต่ละความสัมพันธ์ประกอบด้วย Entity1LogicalName และ Entity2LogicalName สําหรับเอกสารนี้ รายละเอียดความสัมพันธ์จะมีให้ในบริบทของตารางปัจจุบัน ไม่ว่าจะ Entity1 สําคัญหรือไม่ Entity2 สําคัญจริงๆ

สําหรับความสัมพันธ์แบบกลุ่มต่อกลุ่มแต่ละรายการ จะรวมคุณสมบัติต่อไปนี้:

คุณสมบัติ คำอธิบาย
IntersectEntityName ชื่อตรรกะของตารางตัดที่สนับสนุนความสัมพันธ์แบบกลุ่มต่อกลุ่มนี้
คุณสามารถใช้ค่านี้เมื่อรวมคอลัมน์ตารางโดยใช้ FetchXml
IsCustomizable คุณสมบัติของความสัมพันธ์สามารถเปลี่ยนแปลงได้หรือไม่
SchemaName ชื่อ Schema ของความสัมพันธ์
IntersectAttribute ชื่อของคอลัมน์ในตารางตัดที่เป็นคีย์หลักสําหรับระเบียนชนิดนี้
NavigationPropertyName ชื่อของคุณสมบัติการนําทางที่มีค่าคอลเลกชัน Web API สําหรับความสัมพันธ์นี้
ข้อมูลเพิ่มเติม: คุณสมบัติการนําทาง Web API
AssociatedMenuConfiguration ข้อมูลที่ใช้โดยแอปแบบจําลองเพื่อควบคุมว่าสามารถเข้าถึงข้อมูลตารางที่สองใน UI จากตารางนี้ได้หรือไม่และอย่างไร

ในบางกรณีที่ความสัมพันธ์แบบกลุ่มต่อกลุ่มเป็นการอ้างอิงด้วยตนเอง เช่น connectionroleassociation_association บทบาทEntity1การเชื่อมต่อ (ConnectionRole) หรือEntity2ถูกนําหน้าลงในคุณสมบัติ

คุณสมบัติ ค่า
Entity1IntersectAttribute ชื่อของคอลัมน์ในตารางตัดที่เป็นคีย์หลักสําหรับระเบียนชนิดนี้เป็นตารางแรก
Entity2IntersectAttribute ชื่อของคอลัมน์ในตารางตัดที่เป็นคีย์หลักสําหรับระเบียนชนิดนี้เป็นตารางที่สอง
Entity1NavigationPropertyName ชื่อของคุณสมบัติการนําทางที่มีค่าคอลเลกชัน Web API สําหรับความสัมพันธ์นี้เป็นตารางแรก
Entity2NavigationPropertyName ชื่อของคุณสมบัติการนําทางที่มีค่าคอลเลกชัน Web API สําหรับความสัมพันธ์นี้เป็นตารางที่สอง
Entity1AssociatedMenuConfiguration ข้อมูลที่ใช้โดยแอปแบบจําลองเพื่อควบคุมว่าสามารถเข้าถึงข้อมูลตารางที่สองใน UI จากตารางนี้เป็นตารางแรกได้หรือไม่
Entity2AssociatedMenuConfiguration ข้อมูลที่ใช้โดยแอปแบบจําลองเพื่อควบคุมว่าสามารถเข้าถึงข้อมูลตารางที่สองใน UI จากตารางนี้เป็นตารางที่สองได้หรือไม่