Mètodes de pàgines per a pàgines generatives

Utilitza els mètodes de pàgina de l'objecte dataApi per controlar la pàgina generativa en si, com ara retornar un valor quan la pàgina s'utilitza com a diàleg. Actualment, només hi ha un mètode de pàgina.

setPageOutput mètode

Estableix el valor retornat a l'script que crida quan s'obre una pàgina generativa mentre es tanca un diàleg. Aquest mètode només està disponible en hosts que admeten valors retornats de diàlegs generatius de pàgines. No forma part del contracte compartit dataApi , així que comprova que existeix abans de trucar-hi.

Paràmetres

Nom	Tipus	Descripció
value	Desconegut	El valor per tornar al script que va obrir el diàleg. El valor pot ser un primitiu, un objecte o un array.

Devolucions

Cap valor.

Exemple de setPageOutput

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

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

Trucar setPageOutput no tanca el diàleg ni actualitza la pàgina de trucada. Tanca el diàleg amb Xrm.Navigation.navigateBack(). La promesa retornada per Xrm.Navigation.navigateTo llavors es resol amb un objecte la propietat del qual returnValue conté el valor emmagatzemat més recentment. L'script que crida ha d'aplicar explícitament el valor retornat a la seva forma, graella o altre estat.

Aquest mètode s'aplica a pàgines generatives obertes com a diàlegs. Les pàgines generatives obertes en línia o en un panell lateral d'aplicació no retornen cap valor a l'script que crida.