Méthodes de page pour les pages génératives

Utilisez les méthodes de page de l’objet dataApi pour contrôler la page générative elle-même, telles que le renvoi d’une valeur lorsque la page est utilisée comme boîte de dialogue. À ce stade, il n’existe qu’une seule méthode de page.

méthode setPageOutput

Définit la valeur retournée au script appelant lorsqu’une page dégénérative ouverte en tant que boîte de dialogue se ferme. Cette méthode est disponible uniquement dans les hôtes qui prennent en charge le retour de valeurs à partir de boîtes de dialogue de page génératives. Il ne fait pas partie du contrat partagé dataApi . Vérifiez donc qu’il existe avant de l’appeler.

Parameters

Name Catégorie Description
value unknown Valeur à retourner au script qui a ouvert la boîte de dialogue. La valeur peut être une primitive, un objet ou un tableau.

Returns

Aucune valeur.

exemple setPageOutput

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

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

L’appel setPageOutput ne ferme pas la boîte de dialogue ni ne met à jour la page appelante. Fermez la boîte de dialogue avec Xrm.Navigation.navigateBack(). La promesse retournée par Xrm.Navigation.navigateTo la suite se résout avec un objet dont returnValue la propriété contient la valeur stockée la plus récente. Le script appelant doit appliquer explicitement la valeur retournée à son formulaire, à sa grille ou à un autre état.

Cette méthode s’applique aux pages dégénératives ouvertes sous forme de dialogues. Les pages génératives ouvertes inline ou dans un volet latéral d’application ne retournent pas de valeur au script appelant.