利用物件的 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 最近儲存值的物件來解析。 呼叫腳本必須明確將回傳值套用到其形式、網格或其他狀態。
此方法適用於以對話框開啟的生成頁面。 在內嵌或應用程式側面板開啟的生成頁面不會回傳呼叫腳本的值。