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

Effectué

Dans cet exercice, vous allez créer un plug-in automatisé pour garantir que la valeur de crédit autorisé spécifiée pour un contact n’entraîne pas que son taux Endettement/Revenu dépasse 40 %. Vous vérifiez également que les montants de revenu et d’endettement sont disponibles si le crédit autorisé est précisé. En cas de problème, l’utilisateur doit recevoir une notification avec une erreur indiquant le problème.

Important

Utilisez un environnement de test avec Microsoft Dataverse approvisionné et des exemples d’applications, notamment Dataverse Accelerator App. 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.

Créer un plug-in automatisé

Dans cette première tâche, vous allez créer un plug-in automatisé en procédant comme suit :

  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 automatisé.

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

  5. Saisissez Validate Contact Credit Limit to Debt Ratio dans le champ Nom d’affichage, sélectionnez Contact dans le champ Table et Mise à jour, puis développez la section Options avancées. Utilisez l’image ci-dessous comme référence pour les étapes 5 à 8.

    Capture d’écran illustrant la configuration du plug-in pour les étapes 5 à 8.

  6. Sélectionnez Pré-opération pour déterminer le moment où le plug-in doit s’exécuter, puis sélectionnez la solution Learn Low Code Plugins que vous avez créée.

  7. Collez l’expression suivante dans le champ Expression. Cette expression rend les valeurs Revenu annuel, Endettement immobilier et Autre endettement obligatoires si un crédit autorisé est fourni.

    If(!IsBlank(ThisRecord.'Credit Limit') && (IsBlank(ThisRecord.'Annual Income') Or IsBlank(ThisRecord.'Housing Debt') Or IsBlank(ThisRecord.'Other Debt')), Error({ Kind: ErrorKind.Validation , Message: "Annual income, housing debt, and other debts are required." }));
    
  8. Collez l’expression suivante après l’expression précédente. Cette expression affiche une erreur si la somme de l’endettement total et du crédit autorisé augmentent le taux Endettement/Revenu au-delà de 40 %.

    If((ThisRecord.'Housing Debt' + ThisRecord.'Other Debt' + ThisRecord.'Credit Limit') > (ThisRecord.'Annual Income' * .4), Error("Credit limit will make the debt to ratio over 40%, please decrease the credit limit."));
    

    Remarque

    Si vous rencontrez des erreurs sur les expressions, vérifiez d’abord que la casse dans les formules correspond à celle que vous aviez lors de la création des colonnes.

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

Tester le plug-in

Pour cette tâche, testez votre plug-in à l’aide de l’application Fundraiser fournie comme exemple d’application.

  1. Accédez à Power Apps Maker Portal.

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

  3. Lancez l’application Fundraiser.

  4. Cliquez sur Dons, puis ouvrez l’enregistrement de don Yvonne McKay (exemple).

  5. Ouvrez l’enregistrement de contact Yvonne McKay (exemple).

    Capture d’écran illustrant la recherche de contact.

  6. Le formulaire de contact devrait s’ouvrir. Redéfinissez le champ Téléphone professionnel sur 555-0201, puis cliquez sur Enregistrer.

    Le contact devrait être enregistré sans erreur. Si vous ne fournissez pas de crédit autorisé, vous n’êtes pas tenu de fournir la valeur de revenu ou d’endettement.

  7. Cliquez sur l’onglet Détails.

  8. Saisissez 10000 dans le champ Crédit autorisé, puis cliquez sur Enregistrer.

  9. Vous devriez voir une erreur indiquant que le revenu annuel, l’endettement immobilier et autre endettement sont requis. Cliquez sur OK.

    Capture d’écran illustrant l’erreur relative au besoin en matière d’endettement et de revenu.

  10. Saisissez 120000 dans le champ Annual income, puis cliquez sur Enregistrer.

    La même erreur devrait se reproduire, car les valeurs Housing debt et Other debt sont également obligatoires.

  11. Saisissez 20000 dans le champ Housing debt et 20000 dans le champ Other debt, puis cliquez sur Enregistrer.

  12. Vous devriez voir l’erreur relative au taux Endettement/Revenu, car la somme de l’endettement total et du crédit autorisé fait que ce taux dépasse 40 %. Cliquez sur OK.

    Capture d’écran illustrant l’erreur relative au taux Endettement/Revenu.

  13. Redéfinissez le champ Crédit autorisé sur 8000, puis cliquez sur Enregistrer.

    Vos modifications devraient maintenant être enregistrées sans erreur.

  14. Redéfinissez le champ Crédit autorisé sur 8001, puis cliquez sur Enregistrer.

    Le taux Endettement/Revenu devrait s’afficher à nouveau.

  15. Redéfinissez à nouveau le champ Crédit autorisé sur 8000, puis cliquez sur Enregistrer.

Vos modifications devraient maintenant être enregistrées sans erreur.