使用对象的页面方法 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 的 promise 使用其 returnValue 属性包含最近存储的值的对象解析。 调用脚本必须将返回的值显式应用于其窗体、网格或其他状态。
此方法适用于作为对话打开的生成页面。 在内联或应用端窗格中打开的生成页面不会向调用脚本返回值。