Sidemetoder for generative sider

Bruk sidemetodene dataApi for objektet til å kontrollere selve den generative siden, for eksempel å returnere en verdi når siden brukes som en dialogboks. For øyeblikket er det bare én sidemetode.

setPageOutput metode

Angir verdien som returneres til kallskriptet når en generativ side åpnes når en dialogboks lukkes. Denne metoden er bare tilgjengelig i verter som støtter returverdier fra generative sidedialogbokser. Det er ikke en del av den delte dataApi kontrakten, så kontroller at den eksisterer før du ringer den.

Parametre

Navn Type Description
value Ukjent Verdien som skal returneres til skriptet som åpnet dialogboksen. Verdien kan være en primitiv, et objekt eller en matrise.

Returer

Ingen verdi.

setPageOutput-eksempel

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

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

Anrop setPageOutput lukker ikke dialogboksen eller oppdaterer anropssiden. Lukk dialogboksen med Xrm.Navigation.navigateBack(). Løftet som returneres, Xrm.Navigation.navigateTo løses deretter med et objekt med returnValue egenskapen som inneholder den sist lagrede verdien. Kallskriptet må eksplisitt bruke den returnerte verdien i skjemaet, rutenettet eller en annen tilstand.

Denne metoden gjelder for generative sider som åpnes som dialogbokser. Generative sider som åpnes innebygd eller i sideruten for apper, returnerer ikke en verdi til anropsskriptet.