Sidmetoder för generativa sidor

Använd sidmetoderna för dataApi objektet för att styra själva generativa sidan, till exempel att returnera ett värde när sidan används som en dialogruta. För närvarande finns det bara en sidmetod.

setPageOutput metod

Anger värdet som returneras till det anropande skriptet när en generativ sida öppnas när en dialogruta stängs. Den här metoden är endast tillgänglig i värdar som stöder returnering av värden från generativa siddialogrutor. Det ingår inte i det delade dataApi kontraktet, så kontrollera att det finns innan du anropar det.

Parameters

Name	Type	Description
value	unknown	Värdet som ska returneras till skriptet som öppnade dialogrutan. Värdet kan vara en primitiv, ett objekt eller en matris.

Returns

Inget värde.

setPageOutput-exempel

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

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

Samtal setPageOutput stänger inte dialogrutan eller uppdaterar inte samtalssidan. Stäng dialogrutan med Xrm.Navigation.navigateBack(). Löftet som returneras av Xrm.Navigation.navigateTo matchar sedan med ett objekt vars returnValue egenskap innehåller det senast lagrade värdet. Det anropande skriptet måste uttryckligen tillämpa det returnerade värdet på dess formulär, rutnät eller annat tillstånd.

Den här metoden gäller för generativa sidor som öppnas som dialogrutor. Generativa sidor som öppnas infogade eller i en appsida returnerar inte något värde till det anropande skriptet.