Metode de pagină pentru pagini generativă

Utilizați metodele de pagină ale obiectului dataApi pentru a controla pagina generativă propriu-zisă, cum ar fi returnarea unei valori atunci când pagina este utilizată ca dialog. În acest moment, există o singură metodă de pagină.

setPageOutput metodă

Setează valoarea returnată la scriptul de apelare atunci când se închide o pagină generată ca casetă de dialog. Această metodă este disponibilă numai în gazdele care acceptă returnări de valori de la dialoguri de pagini generatorii. Nu face parte din contractul partajat dataApi , deci verificați dacă există înainte de a-l apela.

Parametri

Nume Tip Descriere
value necunoscut Valoarea de returnat la scriptul care a deschis caseta de dialog. Valoarea poate fi o matrice primitivă, obiect sau matrice.

Retururi

Nicio valoare.

setPageOutput example

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

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

Apelarea setPageOutput nu închide caseta de dialog sau nu actualizează pagina de apelare. Închideți caseta de dialog cu Xrm.Navigation.navigateBack(). Promisiunea returnată apoi Xrm.Navigation.navigateTo se rezolvă cu un obiect a cărui returnValue proprietate conține valoarea stocată cel mai recent. Scriptul de apelare trebuie să aplice în mod explicit valoarea returnată la forma, grila sau la altă stare.

Această metodă se aplică la pagini generative deschise ca dialoguri. Paginile generoase deschise în linie sau într-un panou lateral al aplicației nu returnează o valoare în scriptul de apelare.