แชร์ผ่าน


retrieveRecord (การอ้างอิง JavaScript API) สําหรับ Dynamics 365 Channel Integration Framework 1.0

ดึงข้อมูลเรกคอร์ดเอนทิตี

Syntax

Microsoft.CIFramework.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

Parameters

ชื่อ ประเภท ต้องมี คำอธิบาย
ชื่อ entityLogicalName สตริง ใช่ ชื่อตรรกะของเอนทิตีของเรกคอร์ดที่คุณต้องการดึงข้อมูล ตัวอย่างเช่น: "บัญชี"
รหัส สตริง ใช่ GUID ของเรกคอร์ดเอนทิตีที่คุณต้องการดึงข้อมูล
ตัวเลือก สตริง ไม่

ตัวเลือกการสืบค้นระบบ OData $select และ $expand เพื่อดึงข้อมูลของคุณ

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

คุณระบุตัวเลือกแบบสอบถามที่ขึ้นต้นด้วย? คุณยังสามารถระบุตัวเลือกแบบสอบถามได้หลายแบบโดยใช้ & เพื่อแยกตัวเลือกแบบสอบถาม ตัวอย่าง

?$select=name&$expand=primarycontactid($select=contactid,fullname)
successCallback ฟังก์ชัน ไม่

ฟังก์ชันที่จะเรียกใช้เมื่อมีการดึงบันทึก

errorCallback ฟังก์ชัน ไม่ ฟังก์ชันที่จะเรียกใช้เมื่อการดําเนินการล้มเหลว

ค่าที่ส่งคืน

เมื่อสําเร็จ จะส่งคืนสัญญาที่มีสตริงที่มีแอตทริบิวต์ที่ดึงมาและค่าของแอตทริบิวต์

ตัวอย่าง

โค้ดตัวอย่างนี้จะดึงชื่อและหมายเลขโทรศัพท์ของเรกคอร์ดผู้ติดต่อที่มี ID = a8a19cdd-88df-e311-b8e5-6c3be5a8b200

// retrieve contact record
var id = "b44d31ac-5fd1-e811-8158-000d3af97055";
var entityLogicalName = "contact";
Microsoft.CIFramework.retrieveRecord(entityLogicalName, id, "?$select=fullname,telephone1").then(
    function success(result) {
      res=JSON.parse(result);
        console.log(`Retrieved values: Full Name: ${res.fullname}, Telephone Number: ${res.telephone1}`);
        // perform operations on record retrieval
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);