การตั้งค่าคอนฟิกผู้ให้บริการข้อมูล OData v4 และแนวทางปฏิบัติที่ดีที่สุด
หัวข้อนี้นำไปใช้ได้กับ Dynamics 365 Customer Engagement (on-premises) สำหรับรุ่น Power Apps ของหัวข้อนี้ ดู: การกำหนดค่า OData v4 Data Provider
หัวข้อนี้จะอธิบายวิธีการตั้งค่าคอนฟิกตัวให้บริการข้อมูล OData v4 รวมถึงข้อกำหนดต่างๆ และแนวทางปฏิบัติที่ดีที่สุดที่แนะนำสำหรับการใช้งานตัวให้บริการข้อมูล OData v4 เพื่อเชื่อมต่อกับ Web Service ของ OData v4
แนวทางปฏิบัติที่ดีที่สุดของตัวให้บริการข้อมูล OData v4
อินสแตนซ์ของคุณต้องการให้เอนทิตีทั้งหมดมีแอตทริบิวต์ ID รหัสนี้เรียกว่ารหัสเฉพาะ และค่าต้องเป็น guid คุณสามารถแมปฟิลด์รหัสไปยังฟิลด์ภายนอกด้วยชนิดข้อมูล EDM.Guid เท่านั้น คุณไม่สามารถแม็ปชนิดข้อมูล EDM.Int32 ไปยังฟิลด์ชนิดข้อมูลรหัสเฉพาะได้
เอนทิตี OData ที่มีคุณสมบัติเป็นนัลได้ ต้องตั้งค่าให้ตรงกับฟิลด์ที่ถูกแมปในเอนทิตีเสมือน ตัวอย่างเช่น คุณสมบัติเอนทิตี OData ที่มี Nullable=False ต้องมีฟิลด์ที่แม็ปพร้อมกับแอตทริบิวต์ข้อกำหนดฟิลด์ ซึ่งตั้งค่าเป็น ธุรกิจที่ต้องการ
สำหรับการเรียกใช้แบบสอบถามหลายรายการ เช่น เมื่อคุณโหลดข้อมูลเป็นเส้นตาราง ควบคุมขนาดของชุดข้อมูลที่ส่งกลับจากแหล่งข้อมูลจากภายนอกโดยใช้พารามิเตอร์การสอบถามตัวกรองและการเลือก
ถ้ายังไม่ได้เปิดใช้งาน ผู้ดูแลระบบควรเปิดใช้งานการสืบค้นกลับปลั๊กอิน เมื่อเปิดการใช้งานแล้ว ข้อผิดพลาดทั้งหมดจากจุดสิ้นสุด OData จะถูกจับภาพในล็อกการติดตามที่ปลั๊กอิน ข้อมูลเพิ่มเติม: กล่องโต้ตอบการตั้งค่าระบบ - แท็บการเลือกกำหนด
การแมปชนิดข้อมูล
ตารางต่อไปนี้แสดงรายการการแม็ปชนิดข้อมูลแบบจำลองข้อมูลในเอนทิตี OData (EDM) ที่มีชนิดข้อมูลที่เหมาะสม
ชนิดข้อมูล OData | ชนิดข้อมูล |
---|---|
Edm.Boolean | สองตัวเลือก |
Edm.DateTime | วันที่และเวลา |
Edm.DateTimeOffset | วันที่และเวลา |
Edm.Decimal | จำนวนทศนิยมหรือสกุลเงิน |
Edm.Double | เลขจุดทศนิยมลอยตัว |
Edm.Guid | รหัสเฉพาะ |
Edm.Int32 | จำนวนเต็ม |
Edm.Int64 | จำนวนเต็ม |
Edm.String | ข้อความบรรทัดเดียวหรือข้อความหลายบรรทัด |
ชนิดข้อมูล OData EDM ที่ไม่รองรับสำหรับการแมปด้วยเอนทิตีเสมือน
Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte
เพิ่มแหล่งข้อมูลโดยใช้ตัวให้บริการข้อมูล OData v4
กระบวนงานนี้แสดงวิธีการใช้ตัวให้บริการข้อมูล OData สำเร็จรูปเพื่อใช้เป็นแหล่งข้อมูลเอนทิตีแบบเสมือนจริง
ไปที่ การตั้งค่า>การจัดการ>แหล่งข้อมูลของเอนทิตีเสมือน
บนแถบการดำเนินการ เลือก สร้าง
ในกล่องโต้ตอบของตัวให้บริการข้อมูลที่เลือก ให้เลือกจากแหลงข้อมูลต่อไปนี้ และจากนั้นเลือก ตกลง
ผู้ให้บริการข้อมูล OData v4 สภาพแวดล้อมของคุณรวมถึงให้บริการข้อมูล Odata v4 ที่สามารถใช้เพื่อเชื่อมต่อกับแหล่งข้อมูลที่สนับสนุนมาตรฐานแบบเปิดของ OData v4
ผู้ให้บริการข้อมูลแบบกำหนดเอง ถ้าคุณนำเข้าข้อมูลปลั๊กอินตัวให้บริการข้อมูล ตัวให้บริการข้อมูลจะปรากฏขึ้นที่นี่ ข้อมูลเพิ่มเติม: เริ่มต้นใช้งานเอนทิตีเสมือน
บนเพจคุณสมบัติแหล่งข้อมูลใหม่ ให้กรอกข้อมูลฟิลด์ต่อไปนี้ และบันทึกเรกคอร์ด
ชื่อ พิมพ์ชื่อที่อธิบายถึงแหล่งข้อมูล
Uri ถ้าคุณกำลังใช้ตัวให้บริการข้อมูล OData ให้ป้อน uri สำหรับบริการเว็บ OData ตัวอย่างเช่น ถ้าคุณใช้ตัวให้บริการ OData เพื่อเชื่อมต่อไปยัง Web Service ที่เป็นโฮสต์ใน Azure URI อาจมีลักษณะคล้ายกับ
https://contosodataservice.azurewebsites.net/odata/
การหมดเวลาเป็นวินาที ป้อนจำนวนของวินาทีที่จะรอการตอบกลับจากบริการเว็บก่อนที่จะหมดเวลาการร้องขอข้อมูล ตัวอย่างเช่น ป้อน 30 เพื่อ รอสูงสุดสามสิบวินาทีก่อนที่จะหมดเวลา
โหมดการจัดแบ่งหน้า เลือกว่าจะใช้การแบ่งหน้า ฝั่งไคลเอ็นต์ หรือ ฝั่งเซิร์ฟเวอร์เพื่อควบคุมวิธีการแบ่งหน้าผลลัพธ์แบบสอบถาม ค่าเริ่มต้นคือ การแบ่งหน้าฝั่งไคลเอ็นต์ ด้วยการแบ่งหน้าฝั่งเซิร์ฟเวอร์ เซิร์ฟเวอร์จะสามารถควบคุมวิธีการแบ่งหน้าผลลัพธ์โดยใช้พารามิเตอร์ $skiptoken ที่ถูกเพิ่มเข้าไปในสตริงการสอบถาม ข้อมูลเพิ่มเติม: ตัวเลือกการข้ามการสอบถามระบบโทเค็น ($skiptoken)
- แสดงจำนวนแบบอินไลน์ แสดงเรกคอร์ดจำนวนทั้งหมดในชุดผลลัพธ์ การตั้งค่านี้จะใช้เพื่อเปิดใช้งานฟังก์ชันหน้าถัดไปเมื่อคุณแสดงข้อมูลเป็นเส้นตาราง ใช้ค่า เท็จ หากจุดสิ้นสุด OData ของคุณไม่รองรับพารามิเตอร์ OData $inclinecount ค่าเริ่มต้นคือ เท็จ
พารามิเตอร์การร้องขอ อีกทางหนึ่งคือ คุณสามารถเพิ่มหัวกระดาษแบบกำหนดเองหรือพารามิเตอร์สตริงแบบสอบถามที่ใช้ในการเชื่อมต่อกับบริการเว็บ OData เช่น พารามิเตอร์การรับรองความถูกต้องไปยังบริการภายนอก เลือก สตริงแบบสอบถาม เพื่อสลับระหว่างพารามิเตอร์สตริงแบบสอบถามและส่วนหัวและค่า คุณสามารถเพิ่มสตริงแบบสอบถามหรือส่วนหัวได้สูงสุด 10 รายการ
ดูเพิ่มเติม
สร้างและแก้ไขเอนทิตีเสมือนที่ประกอบด้วยข้อมูลจากแหล่งข้อมูลภายนอก
TechNet Blog: ทำงานกับข้อมูลจากระบบภายนอกโดยใช้เอนทิตีเสมือนใหม่