共用方式為

適用於 Dynamics 365 管道整合架構 1.0 的 retrieveRecord （JavaScript API 參考）

擷取實體記錄。

語法

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

參數

名稱 類型 為必填項目 Description
實體邏輯名稱 繩子 Yes 您要擷取之記錄的實體邏輯名稱。 例如：「帳戶」。
識別碼 繩子 Yes 您要擷取之實體記錄的 GUID。
options 繩子 否

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
    }
);
  • Last updated on