Sidemetoder til generative sider

Brug objektets dataApi sidemetoder til at styre selve den generative side, f.eks. returnere en værdi, når siden bruges som en dialogboks. På nuværende tidspunkt er der kun én sidemetode.

setPageOutput metode

Angiver den værdi, der returneres til kaldescriptet, når en generativ side, der åbnes som en dialogboks, lukkes. Denne metode er kun tilgængelig i værter, der understøtter returnering af værdier fra generative sidedialogbokse. Den er ikke en del af den delte dataApi kontrakt, så kontrollér, at den findes, før du kalder den.

Parametre

Name	Type	Beskrivende tekst
value	Ukendt	Den værdi, der skal returneres til det script, der åbnede dialogboksen. Værdien kan være en primitiv værdi, et objekt eller en matrix.

Retur

Ingen værdi.

setPageOutput-eksempel

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

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

Opkaldet setPageOutput lukker ikke dialogboksen eller opdaterer opkaldssiden. Luk dialogboksen med Xrm.Navigation.navigateBack(). Det løfte, der returneres af Xrm.Navigation.navigateTo , løses derefter med et objekt, hvis returnValue egenskab indeholder den senest gemte værdi. Det kaldende script skal eksplicit anvende den returnerede værdi på formularen, gitteret eller en anden tilstand.

Denne metode gælder for generative sider, der åbnes som dialogbokse. Generative sider, der er åbnet indbygget eller i en appsiderude, returnerer ikke en værdi til opkaldsscriptet.