共用方式為


retrieveRecord

擷取資料表記錄。

適用於

模型導向應用程式和入口網站。

語法

context.webAPI.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

參數

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

OData 系統查詢選項 $select$expand,用於檢索數據。

  • 使用 $select system query 選項,通過包含以逗號分隔的屬性名稱清單來限制返回的屬性。 限制您擷取的資料行是重要的效能最佳實務。 如果未使用 $select 指定屬性,則會傳回所有屬性。
  • 使用 $expand 系統查詢選項來控制傳回相關表格中的哪些資料。 如果您只包含導覽屬性的名稱,您將收到相關記錄的所有屬性。 您可以使用導航屬性名稱後括弧中的 $select system query 選項來限制為相關記錄返回的屬性。 將此函數用於 單值集合值 導航屬性。

您指定以 ?. 您還可以透過使用 for & 分隔查詢選項來指定多個查詢選項。 例如:

?$select=name&$expand=primarycontactid($select=contactid,fullname)
successCallback 回調 功能

擷取記錄時要呼叫的函式。 具有擷取屬性和值的 JSON 物件將會傳遞至函式。

errorCallback 回調 功能 作業失敗時要呼叫的函式。

傳回值

類型: 承諾<實體>

網路API
Power Apps 元件架構 API 參考
Power Apps 元件架構概觀