Métodos de página para páginas generativas

Utilice los métodos de página del dataApi objeto para controlar la propia página generativa, como devolver un valor cuando la página se usa como un cuadro de diálogo. En este momento, solo hay un método de página.

método setPageOutput

Establece el valor devuelto al script de llamada cuando se cierra una página generativa abierta como un cuadro de diálogo. Este método solo está disponible en hosts que admiten la devolución de valores de diálogos de página generativa. No forma parte del contrato compartido dataApi , por lo que debe comprobar que existe antes de llamarlo.

Parameters

Name Tipo Description
value unknown Valor que se va a devolver al script que abrió el cuadro de diálogo. El valor puede ser un primitivo, un objeto o una matriz.

Devoluciones

No hay ningún valor.

Ejemplo de setPageOutput

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

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

La llamada setPageOutput no cierra el cuadro de diálogo ni actualiza la página de llamada. Cierre el cuadro de diálogo con Xrm.Navigation.navigateBack(). A continuación, la promesa devuelta Xrm.Navigation.navigateTo se resuelve con un objeto cuya returnValue propiedad contiene el valor almacenado más recientemente. El script de llamada debe aplicar explícitamente el valor devuelto a su formulario, cuadrícula u otro estado.

Este método se aplica a las páginas generativas abiertas como diálogos. Las páginas generativas abiertas insertadas o en un panel lateral de la aplicación no devuelven un valor al script de llamada.