หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ตาราง Dataverse มีชุดตารางทั่วไปที่ฐานข้อมูลสภาพแวดล้อมทั้งหมดมี
การอ้างอิงตาราง/เอนทิตีแอปที่เปิดใช้งาน Dynamics 365 ประกอบด้วยตารางเพิ่มเติมที่จําเป็นก่อนที่คุณจะสามารถติดตั้งแอป Dynamics 365 เช่น Field Service ได้
ตารางที่แสดงรายการที่นี่จะถูกเพิ่มหรือแก้ไขเมื่อคุณเลือกติดตั้ง Dynamics 365 Field Service ในขณะที่คุณเพิ่ม Dataverse ไปยังสภาพแวดล้อมที่คุณสร้าง สคีมาตารางอาจมีลักษณะแตกต่างออกไป หากมีแอปอื่นๆ ที่ติดตั้งในสภาพแวดล้อม Dataverse ของคุณ
Note
เอกสารอ้างอิงนี้ไม่รวมบางตารางที่มีอยู่ในสภาพแวดล้อมของคุณ ตัวอย่างเช่น ตารางที่มีไว้สําหรับใช้ภายในเท่านั้น และเราพิจารณาว่ามีความเกี่ยวข้องน้อยกว่าสําหรับนักพัฒนา Field Service การเปลี่ยนแปลง Schema ตารางจะไม่สะท้อนให้เห็นในทันที เนื่องจากเราสร้างเอกสารนี้ในบางช่วงเวลา
เราได้เปิดตัวเอกสารอ้างอิงนี้ในเดือนกุมภาพันธ์ 2025 คุณอาจสังเกตเห็นการเปลี่ยนแปลงบ่อยขึ้นเมื่อเรารวบรวมความคิดเห็นเบื้องต้นและจัดการกับการเปลี่ยนแปลงนั้น
หากต้องการดูข้อมูลปัจจุบันและข้อมูลที่ไม่ได้กรองสําหรับตารางทั้งหมดในสภาพแวดล้อม Dataverse ของคุณ ให้ใช้เบราว์เซอร์ ข้อกําหนดตาราง เบราว์เซอร์ข้อกําหนดตารางเป็นโซลูชันที่มีการจัดการที่อธิบายไว้ใน เรียกดูข้อกําหนดตารางในสภาพแวดล้อมของคุณ
ข้อมูลอ้างอิงนี้รวมเฉพาะตารางที่:
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 ทั่วไปที่กําหนดไว้ในการอ้างอิงเหล่านี้:
สําหรับฟังก์ชันและการกระทําเหล่านี้ และฟังก์ชันและการดําเนินการเพิ่มเติมใดๆ ที่เพิ่มเข้ามา คุณสามารถค้นพบวิธีใช้สิ่งเหล่านี้ได้โดย:
- ตรวจสอบ เอกสารบริการ $metadata สําหรับรายละเอียดเกี่ยวกับพารามิเตอร์และค่าที่ส่งคืน ดูรายละเอียดที่คําจํากัดความของการดําเนินการและคําจํากัดความของฟังก์ชัน
- เรียกใช้การกระทําและฟังก์ชัน ดูรายละเอียดได้ที่หัวข้อใช้การดําเนินการ Web API และใช้ฟังก์ชัน Web API
กิจกรรม
เหตุการณ์คือข้อความที่มีอยู่เพื่อให้คุณสามารถสมัครรับข้อมูลได้ เว้นแต่คุณจะเพิ่มเหตุการณ์ คุณไม่ควรเรียกใช้ข้อความ ให้สมัครรับข้อมูลเท่านั้น คุณสามารถสมัครรับกิจกรรมได้หลายวิธี เช่น
- ใช้ตัวเชื่อมต่อ Power Automate Dataverse โดยใช้ทริกเกอร์ เมื่อดําเนินการ
- ลงทะเบียนปลั๊กอิน Dataverse เพื่อตอบสนองต่อเหตุการณ์
- ส่งข้อมูลเหตุการณ์ไปยัง Azure หรือเว็บฮุคด้วยการรวม Dataverse Azure
คุณสมบัติ
ส่วนนี้รวมคุณสมบัติเอนทิตีที่เลือกแทนที่จะเป็นคุณสมบัติทั้งหมด รวมเฉพาะคุณสมบัติที่คาดว่าจะเป็นประโยชน์สูงสุดสําหรับนักพัฒนาเท่านั้น ค่าคุณสมบัติของเอนทิตีบางค่าสามารถเปลี่ยนแปลงได้
คอลัมน์
คอลัมน์จะแสดงอยู่ในสองส่วนแยกกัน: คอลัมน์/แอตทริบิวต์ที่เขียนได้ และคอลัมน์/แอตทริบิวต์แบบอ่านอย่างเดียว จุดประสงค์ของการแยกนี้คือการมุ่งเน้นไปที่คอลัมน์ที่นักพัฒนาสามารถตั้งค่าได้เมื่อสร้างหรืออัปเดตแถวในตาราง การทําความเข้าใจคอลัมน์เหล่านี้ช่วยให้นักพัฒนาเข้าใจว่าพวกเขาสามารถทําอะไรได้บ้างกับตารางนอกเหนือจากการดึงค่า
คอลัมน์ในส่วนคอลัมน์ /แอตทริบิวต์ที่เขียนได้ ส่งกลับ 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 จากตารางนี้เป็นตารางที่สองได้หรือไม่ |