Metodi di pagina per le pagine generative

Utilizzare i metodi di pagina dell'oggetto dataApi per controllare la pagina generativa stessa, ad esempio la restituzione di un valore quando la pagina viene utilizzata come finestra di dialogo. Al momento, è presente un solo metodo di pagina.

Metodo setPageOutput

Imposta il valore restituito allo script chiamante quando viene chiusa una pagina generativa aperta quando viene chiusa una finestra di dialogo. Questo metodo è disponibile solo negli host che supportano la restituzione di valori dalle finestre di dialogo di pagina generative. Non fa parte del contratto condiviso dataApi , quindi verificare che esista prima di chiamarlo.

Parameters

Name	Type	Description
value	unknown	Valore da restituire allo script che ha aperto la finestra di dialogo. Il valore può essere una primitiva, un oggetto o una matrice.

Returns

Nessun valore.

Esempio di setPageOutput

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

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

La chiamata setPageOutput non chiude la finestra di dialogo o aggiorna la pagina chiamante. Chiudere la finestra di dialogo con Xrm.Navigation.navigateBack(). La promessa restituita da Xrm.Navigation.navigateTo viene quindi risolta con un oggetto la cui returnValue proprietà contiene il valore archiviato più di recente. Lo script chiamante deve applicare in modo esplicito il valore restituito alla maschera, alla griglia o ad altro stato.

Questo metodo si applica alle pagine generative aperte come dialoghi. Le pagine generative aperte inline o in un riquadro laterale dell'app non restituiscono un valore allo script chiamante.