Utiliser des plug-ins instantanés depuis Power Apps

15 minutes

Vous pouvez utiliser des plug-ins low-code instantanés à partir d’applications canevas Power Apps. La façon dont vous procédez pour appeler le plug-in instantané dépend de la configuration du plug-in : global ou d’entité.

Utiliser des plug-ins instantanés globaux

Les plug-ins instantanés configurés comme globaux ne sont pas liés à une table Dataverse spécifique. Pour utiliser ces plug-ins, vous devez ajouter une référence à un objet de langage d’environnement à partir du volet de source de données.

Capture d’écran illustrant le connecteur Environnement.

Après avoir ajouté l’objet de langage d’environnement, vous pouvez utiliser le plug-in instantané depuis vos expressions Power Fx dans l’application. L’exemple suivant illustre l’utilisation d’un plug-in instantané global :

Environment.contoso_CalculateRiskScore(...inputs...)

Important

Vous devez rajouter l’objet de langage d’environnement pour accéder aux nouveaux plug-ins dans les applications canevas existantes. Pour les plug-ins que vous créez après avoir ajouté la source de données d’environnement à une application canevas existante, vous devez supprimer et rajouter l’objet de langage d’environnement Power Fx.

Utiliser des plug-ins instantanés d’entité

Les plug-ins instantanés configurés comme d’entité sont liés à une table Dataverse spécifique. Lorsque vous utilisez ces plug-ins à partir d’une expression Power Fx, vous pouvez y accéder depuis la table Dataverse et vous devez transmettre un identificateur à une ligne existante de cette table.

Par exemple, pour appeler un plug-in CalculateRiskScore configuré comme d’entité et avec la table Account, vous devez utiliser l’expression suivante :

Accounts.contoso_CalculateRiskScore(RecordsGallery1.Selected.Account)

Dans l’exercice suivant, vous allez calculer le taux d’endettement dans une application canevas Power Apps à l’aide de plug-ins low-code.

Important

Utilisez un environnement de test avec Microsoft Dataverse approvisionné et les exemples d’applications disponibles. Si vous ne disposez pas d’un environnement de test, vous pouvez vous inscrire pour bénéficier de l’offre Communauté.

Important

Cet exercice utilise les plug-ins que vous avez créés dans le module 1. Si vous n’avez pas terminé le module 1, vous pouvez importer et utiliser la solution de démarrage LearnLowCodePlugins_1_0_0_1.zip incluse dans ce module.

Préparer votre environnement

Pour préparer votre environnement, procédez comme suit :

Accédez à Power Apps Maker Portal.
Sélectionnez l’environnement adéquat, puis cliquez sur Applications.
Cliquez sur Démarrer avec des données.
Cliquez sur la carte Sélectionner une table existante.
Sélectionnez la table Contact, puis cliquez sur Créer une application.

Le studio d’application canevas devrait alors ouvrir la nouvelle application.
Supprimez les colonnes superflues du formulaire. Accédez à l’onglet Arborescence, puis sélectionnez Form1.
Toujours avec Form1 sélectionné, accédez au volet Propriétés à gauche, puis cliquez sur le bouton de lien Modifier les champs.
Cliquez sur le bouton des points de suspension (…) en regard du champ Last Name, puis sélectionnez Supprimer.
Supprimez tout sauf les champs Full Name, Annual Income, Credit Limit, Housing debt et Other debt. Vous devrez peut-être ajouter des colonnes manquantes en cliquant sur le bouton + Ajouter un champ.
Fermez le volet Champs.
Cliquez sur l’onglet Données à gauche, puis sur + Ajouter des données.
Recherchez, puis sélectionnez Environnement.
De retour dans l’Arborescence sélectionnez MainContainer1.
Cliquez sur le bouton + Insérer, puis sélectionnez Bouton.
Redéfinissez le nom du contrôle Bouton sur Appeler non lié.
Remplacez le texte de test du contrôle Bouton par Appeler non lié.
Redéfinissez la propriété Width du contrôle Bouton sur200.
Sélectionnez MainContainer1, cliquez sur le bouton + Insérer, puis sélectionnez à nouveau Bouton.
Redéfinissez le nom du contrôle Bouton sur Appeler lié.
Remplacez le texte de test du contrôle Bouton par Appeler lié.
Redéfinissez la propriété Width du contrôle Bouton sur200.
Sélectionnez MainContainer1, puis redéfinissez la propriété LayoutGap sur 10.

L’écran devrait maintenant ressembler à l’image suivante :
Ne quittez pas cette page.

Appeler le plug-in

Pour appeler le plug-in, procédez comme suit :

Cliquez sur le bouton Appeler non lié. Accédez à la barre de formule, sélectionnez OnSelect, puis collez l’expression suivante. Cette expression utilise le plug-in Calculer le taux d’endettement que vous avez créé dans le module 1. L’expression utilise les valeurs Annual income, Housing debt et Other debt du formulaire comme entrées, puis affiche un taux d’endettement total formaté à titre de notification. La casse des lettres est importante. Si vous obtenez des erreurs, vérifiez que la casse correspond à ce qui a été fait dans les labos précédents.
```
With(RecordsGallery1.Selected, Notify(
"Total debt ratio: " & Text(
    Environment.contoso_CalculateDebtRatio(
        {
            Income: Value('Annual Income'),
            HousingDebt: Value('Housing debt'),
            OtherDebt: Value('Other debt')
        }
    ).TotalDebtRatio,
    "###.00%"
)
))
```
Cliquez sur le bouton Appeler lié. Accédez à la barre de formule, sélectionnez OnSelect, puis collez l’expression suivante. Cette expression utilise le plug-in Calculer le taux d’endettement du contact que vous avez créé dans le module 1. L’expression utilise l’ID du contact sélectionné comme entrée, puis affiche le taux d’endettement total formaté à titre de notification.
```
With(
Contacts.contoso_CalculateContactDebtRatio(RecordsGallery1.Selected.Contact),
Notify(
    "Total debt ratio: " & Text(
        TotalDebtRatio,
        "###.00%"
    )
)
)
```
Cliquez sur Enregistrer.
Saisissez Gestionnaire de contacts dans le champ Nom, puis cliquez sur Enregistrer. Attendez que l’application soit enregistrée.
Cliquez sur le bouton Lire.
L’application devrait se lancer. Cliquez sur le bouton Modifier.
Saisissez 250000 dans le champ Annual income, 30000 dans le champ Housing debt et 50000 dans le champ Other debt, puis cliquez sur l’icône Enregistrer.
Cliquez sur le bouton Appeler non lié.

Une notification présentant le taux d’endettement total devrait alors s’afficher.
Fermez l’aperçu en cliquant sur le bouton X dans le coin supérieur droit de l’écran.

Commentaires

Cette page a-t-elle été utile ?