Seitenmethoden für generative Seiten

Verwenden Sie die Seitenmethoden des dataApi Objekts, um die generative Seite selbst zu steuern, z. B. das Zurückgeben eines Werts, wenn die Seite als Dialogfeld verwendet wird. Derzeit gibt es nur eine Seitenmethode.

setPageOutput Methode

Legt den Wert fest, der an das aufrufende Skript zurückgegeben wird, wenn eine generative Seite, die als Dialogfeld geöffnet wird, geschlossen wird. Diese Methode ist nur in Hosts verfügbar, die das Zurückgeben von Werten aus generativen Seitendialogfeldern unterstützen. Sie ist nicht Teil des freigegebenen dataApi Vertrags. Überprüfen Sie daher, ob er vorhanden ist, bevor Sie ihn aufrufen.

Parameters

Name	Type	Description
value	Unbekannt	Der Wert, der an das Skript zurückgegeben werden soll, das das Dialogfeld geöffnet hat. Der Wert kann ein Grundtyp, ein Objekt oder ein Array sein.

Rücklieferungen

Kein Wert.

setPageOutput-Beispiel

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

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

Das setPageOutput Aufrufen schließt das Dialogfeld nicht, oder die aufrufende Seite wird aktualisiert. Schließen Sie das Dialogfeld mit Xrm.Navigation.navigateBack(). Die anschließend zurückgegebene Xrm.Navigation.navigateTo Zusage wird mit einem Objekt aufgelöst, dessen Eigenschaft den zuletzt gespeicherten returnValue Wert enthält. Das aufrufende Skript muss den zurückgegebenen Wert explizit auf das Formular, das Raster oder den anderen Zustand anwenden.

Diese Methode gilt für generative Seiten, die als Dialogfelder geöffnet werden. Generative Seiten, die inline oder in einem App-Seitenbereich geöffnet wurden, geben keinen Wert an das aufrufende Skript zurück.