Metódy strany pre generatívne strany

Pomocou metód dataApi strany objektu môžete ovládať samotnú generatatívnu stránku, napríklad vrátenie hodnoty, keď sa strana používa ako dialógové okno. V súčasnosti je k dispozícii iba jedna metóda strany.

setPageOutput metóda

Nastaví hodnotu vrátenú do volajúceho skriptu pri otvorení generatatívnej stránky ako dialógové okno. Táto metóda je k dispozícii iba v hostiteľoch, ktoré podporujú vrátenie hodnôt z dialógových okien generativnej stránky. Nie je súčasťou zdieľanej dataApi zmluvy, takže pred volaním ju skontrolujte, či existuje.

Parametre

Name Type Description
value Neznámy Hodnota, ktorá sa má vrátiť k skriptu, ktorý otvoril dialógové okno. Hodnotou môže byť primitívne, objekt alebo pole.

Vrátené hodnoty

Žiadna hodnota.

príklad setPageOutput

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

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

Volanie setPageOutput nezatvára dialógové okno ani neaktualizuje volajúcu stránku. Zatvorte dialógové okno pomocou funkcie Xrm.Navigation.navigateBack(). Sľub vrátený funkciou Xrm.Navigation.navigateTo sa potom vyrieši s objektom, ktorého returnValue vlastnosť obsahuje naposledy uloženú hodnotu. Volajúci skript musí explicitne použiť vrátenú hodnotu na jeho formulár, mriežku alebo iný stav.

Táto metóda sa vzťahuje na generativní strany otvorené ako dialógové okná. Všeobecné strany otvorené vnorené alebo na bočnej table aplikácie nevracajú hodnotu volajúceho skriptu.