Exercice : créer des plug-ins instantanés

Effectué

Dans cet exercice, vous allez créer un plug-in instantané pour calculer le taux d’endettement. Ce plug-in est réutilisable à partir de Power Apps ou Power Automate et n’est lié à aucune ligne de table Dataverse. Vous allez également créer un plug-in instantané qui effectue le même calcul, mais utilise les données d’une ligne Dataverse.

Important

Utilisez un environnement de test avec Microsoft Dataverse approvisionné et les exemples d’applications. Si vous ne disposez pas d’un environnement de test, vous pouvez vous inscrire pour bénéficier du Plan pour développeurs Power Apps.

Tâche : préparer votre environnement

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

  1. Accédez à Power Apps Maker Portal.

  2. Sélectionnez l’environnement adéquat, puis cliquez sur Solutions.

  3. Cliquez sur Nouvelle solution.

    Capture d’écran illustrant le bouton Nouvelle solution.

  4. Saisissez Learn Low Code Plugins dans le champ Nom d’affichage et LearnLowCodePlugins dans le champ Nom, puis cliquez sur le bouton + Nouvel éditeur.

  5. Saisissez Contoso dans le champ Nom d’affichage, Contoso dans le champ Nom et contoso dans le champ Préfixe, puis cliquez sur Enregistrer.

  6. Sélectionnez l’éditeur Contoso que vous avez créé, puis cliquez sur Créer.

    Capture d’écran illustrant la boîte de dialogue Nouvelle solution.

Créer un plug-in pour calculer le taux d’endettement

  1. Accédez à Power Apps Maker Portal.

  2. Sélectionnez l’environnement adéquat, puis cliquez sur Applications.

  3. Cliquez sur l’onglet Tous, sélectionnez Dataverse Accelerator App, puis cliquez sur le bouton Lire.

    Capture d’écran illustrant le bouton Lire l’application.

  4. Cliquez sur Créer un plug-in instantané.

  5. Saisissez Calculate Debt Ratio dans le champ Nom d’affichage, puis cliquez sur + Nouveau paramètre d’entrée.

  6. Saisissez Income dans le champ Étiquette, sélectionnez Decimal dans le champ Type de données, puis cliquez sur + Nouveau paramètre d’entrée.

  7. Saisissez HousingDebt dans le champ Étiquette, sélectionnez Decimal dans le champ Type de données, puis cliquez sur + Nouveau paramètre d’entrée.

  8. Saisissez OtherDebt dans le champ Étiquette et sélectionnez Decimal dans le champ Type de données.

  9. Vous devriez maintenant disposer de trois paramètres d’entrée. Cliquez sur + Nouveau paramètre de sortie.

  10. Saisissez TotalDebtRatio dans le champ Étiquette, sélectionnez Decimal dans le champ Type de données, puis cliquez sur + Nouveau paramètre de sortie.

  11. Saisissez HousingDebtRatio dans le champ Étiquette, puis sélectionnez Decimal dans le champ Type de données.

    Vos paramètres d’entrée et de sortie devraient ressembler à l’image suivante :

    Capture d’écran illustrant les paramètres d’entrée et de sortie.

  12. La formule suivante calcule le taux d’endettement immobilier et le taux d’endettement total. Collez la formule Power Fx suivante dans le champ Expression, puis développez la section Options avancées.

     {TotalDebtRatio: ((HousingDebt + OtherDebt)/Income) * 100, HousingDebtRatio: (HousingDebt/Income) * 100};
    
  13. Sélectionnez la solution LearnLowCodePlugins que vous avez créée dans le champ Solution, puis sélectionnez Global.

    Capture d’écran illustrant la solution et l’étendue sélectionnées.

  14. Cliquez sur Enregistrer, puis attendez que le plug-in soit enregistré.

  15. Cliquez sur le bouton Tester. Le bouton Tester s’affiche une fois le plug-in enregistré avec succès.

  16. Saisissez 12000 dans le champ Income, 4000 dans le champ HousingDebt et 4000 dans le champ OtherDebt, puis cliquez sur Exécuter.

    Capture d’écran illustrant le bouton Exécuter.

  17. Vous devriez obtenir une réponse de réussite avec les valeurs TotalDebtRatio et HousingDebtRatio calculées.

    Capture d’écran illustrant la réponse.

  18. Vous pouvez fermer la fenêtre ou l’onglet de navigateur Dataverse Accelerator App.

Tâche : créer un plug-in pour calculer le taux d’endettement du contact

  1. Accédez à Power Apps Maker Portal.

  2. Sélectionnez l’environnement adéquat, puis cliquez sur Solutions.

  3. Ouvrez la solution Learn Low Code Plugins que vous avez créée.

  4. Cliquez sur Ajouter un élément existant, puis sélectionnez Table.

  5. Sélectionnez la table Contact, puis cliquez sur Suivant.

    Capture d’écran illustrant la boîte de dialogue Ajouter un élément existant.

  6. Cliquez sur le bouton de lien Sélectionner des objets.

  7. Cliquez sur l’onglet Formulaires.

  8. Sélectionnez le formulaire principal Contact, puis cliquez sur Ajouter.

  9. Recliquez sur Ajouter.

  10. Ouvrez la table Contact que vous venez d’ajouter à la solution.

    Capture d’écran illustrant la table Contact.

  11. Cliquez sur + Nouveau, puis sélectionnez Colonne.

  12. Saisissez Housing debt dans le champ Nom d’affichage, sélectionnez Devise dans le champ Type de données, puis cliquez sur Enregistrer.

  13. Cliquez sur + Nouveau, puis sélectionnez de nouveau Colonne.

  14. Saisissez Other debt dans le champ Nom d’affichage, sélectionnez Devise dans le champ Type de données, puis cliquez sur Enregistrer.

  15. Les colonnes que vous avez ajoutées devraient ressembler à l’image suivante. Cliquez sur Formulaires.

    Capture d’écran illustrant les colonnes ajoutées.

  16. Ouvrez le formulaire Contact que vous avez ajouté à la solution.

  17. Cliquez sur l’onglet Détails.

  18. Ajoutez les colonnes Annual income, Housing debt et Other debt sous la colonne Credit limit.

  19. Cliquez sur Enregistrer et publier et attendez la fin de la publication.

  20. Cliquez sur le bouton <- Précédent.

  21. Sélectionnez la table Contact.

  22. Cliquez sur le bouton Modifier.

    Capture d’écran illustrant le bouton Modifier.

  23. Cliquez sur le chevron en regard du bouton Nouvelle ligne, puis sélectionnez Nouvelle ligne à l’aide du formulaire.

    Capture d’écran illustrant l’option Nouvelle ligne à l’aide du formulaire.

  24. Saisissez John dans le champ Prénom et Doe dans le champ Nom, puis cliquez sur l’onglet Détails.

  25. Saisissez 120000 dans le champ Annual income, 40000 dans le champ Housing debt et 40000 dans le champ Other debt, puis cliquez sur Enregistrer.

    Capture d’écran illustrant la page Nouveau contact.

  26. Copiez l’ID de contact depuis l’URL et conservez-le dans un bloc-notes : il vous permet de tester le plug-in. L’ID est le GUID à la fin de l’URL ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

  27. Cliquez sur Enregistrer et fermer.

  28. Cliquez sur Terminé.

  29. Cliquez sur le bouton Précédent.

  30. Cliquez sur le bouton Revenir aux solutions.

  31. Cliquez sur Applications et sur l’onglet Tous, puis lancez Dataverse Accelerator App.

  32. Cliquez sur Créer un plug-in instantané.

    Capture d’écran illustrant la carte Créer un plug-in instantané.

  33. Saisissez Calculer le taux d’endettement du contact dans le champ Nom d’affichage, puis cliquez sur Nouveau paramètre de sortie.

  34. Saisissez HousingDebtRatio dans le champ Étiquette et sélectionnez Decimal dans le champ Type de données.

  35. Recliquez sur Nouveau paramètre de sortie.

  36. Saisissez TotalDebtRatio dans le champ Étiquette et sélectionnez Decimal dans le champ Type de données.

  37. Développez la section Options avancées.

  38. Afin que « cet enregistrement » soit disponible dans l’expression, nous devons d’abord définir l’étendue. Sélectionnez LearnLowCodePlugins dans le champ Solution, Entité dans le champ Étendue et Contact dans le champ Table.

    Capture d’écran illustrant la solution de plug-in et l’étendue.

  39. Collez l’expression suivante dans le champ Expression. Cette expression affiche une erreur si le taux Endettement total/Revenu est supérieur à 40 %.

     {TotalDebtRatio: ((ThisRecord.'Housing Debt' + ThisRecord.'Other Debt')/ThisRecord.'Annual Income') * 100, HousingDebtRatio: (ThisRecord.'Other Debt'/ThisRecord.'Annual Income') * 100}
    
  40. Cliquez sur Enregistrer, puis attendez que le plug-in soit enregistré.

  41. Cliquez sur le bouton Tester.

  42. Collez l’ID de contact que vous avez copié précédemment, puis cliquez sur Exécuter.

    Capture d’écran illustrant le bouton Exécuter permettant de tester le plug-in.

  43. Vous devriez obtenir une réponse de réussite et les valeurs endettement total et Housing debt calculées.

    Capture d’écran illustrant la réponse du test.