生成頁面的頁面方法

利用物件的 dataApi 頁面方法來控制生成頁面本身,例如當頁面被用作對話框時回傳一個值。 目前只有一頁法。

setPageOutput 方法

設定當生成頁面開啟對話框關閉時,回傳給呼叫腳本的值。 此方法僅適用於支援從生成頁面對話框回傳數值的主機。 這不包含在共享 dataApi 合約中,所以在打電話前請確認它是否存在。

Parameters

Name 類型 Description
value 未知 返回開啟對話框的腳本的值。 這個值可以是原始物件、物件或陣列。

Returns

毫無價值。

setPageOutput 範例

dataApi.setPageOutput?.({
    action: "selected",
    recordId: selectedRecordId
});

const xrm = (window as any).Xrm;
await xrm.Navigation.navigateBack();

呼叫 setPageOutput 不會關閉對話框或更新呼叫頁面。 以 關閉對話 Xrm.Navigation.navigateBack()。 回傳 Xrm.Navigation.navigateTo 的承諾會以一個包含 returnValue 最近儲存值的物件來解析。 呼叫腳本必須明確將回傳值套用到其形式、網格或其他狀態。

此方法適用於以對話框開啟的生成頁面。 在內嵌或應用程式側面板開啟的生成頁面不會回傳呼叫腳本的值。