Paginamethoden voor generatieve pagina's

Gebruik de paginamethoden van het dataApi object om de generatieve pagina zelf te beheren, zoals het retourneren van een waarde wanneer de pagina wordt gebruikt als dialoogvenster. Op dit moment is er slechts één paginamethode.

setPageOutput methode

Hiermee stelt u de waarde in die wordt geretourneerd aan het aanroepende script wanneer een generatieve pagina wordt geopend als dialoogvenster wordt gesloten. Deze methode is alleen beschikbaar in hosts die ondersteuning bieden voor het retourneren van waarden uit dialoogvensters voor generatieve pagina's. Het maakt geen deel uit van het gedeelde dataApi contract, dus controleer of het bestaat voordat u het aanroept.

Parameters

Name	Type	Description
value	unknown	De waarde die moet worden geretourneerd naar het script dat het dialoogvenster heeft geopend. De waarde kan een primitieve, object of matrix zijn.

Returns

Geen waarde.

setPageOutput-voorbeeld

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

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

Bij het bellen setPageOutput wordt het dialoogvenster niet gesloten of wordt de aanroeppagina bijgewerkt. Sluit het dialoogvenster met Xrm.Navigation.navigateBack(). De belofte die vervolgens Xrm.Navigation.navigateTo wordt geretourneerd, wordt omgezet met een object waarvan returnValue de eigenschap de laatst opgeslagen waarde bevat. Het aanroepende script moet de geretourneerde waarde expliciet toepassen op de vorm, het raster of een andere status.

Deze methode is van toepassing op generatieve pagina's die als dialoogvensters worden geopend. Generatieve pagina's die inline worden geopend of in een deelvenster aan de app-zijde retourneren geen waarde voor het aanroepende script.