Didacticiel 5 : ajouter un bouton d’action personnalisé à une carte personnalisée pour appeler REST

Effectué

Une fonctionnalité permettant d’ajouter des actions personnalisées aux cartes d’informations est introduite et est actuellement disponible en préversion.

De nouveaux types de boutons sont introduits dans l’opération Créer une carte pour l’assistant V2.

Exemples de cas d’utilisation

Nous allons créer une carte d’informations qui sera affichée lorsque la date de clôture estimée d’une opportunité se situera dans la journée et nous allons ajouter une action pour prolonger cette date de clôture estimée de 10 jours.

Données de test

Créez une ou plusieurs opportunités dont la date de clôture estimée est la date du jour.

Étape 1 : créer un déclencheur pour démarrer le flux

Définissez un déclencheur qui s’exécute chaque matin à 8 heures. 

1. Dans la zone de recherche, saisissez Périodicité. Dans les résultats de la recherche, sous l’option Déclencheurs, sélectionnez Périodicité.

   

2. Le déclencheur ci-dessous s’affiche. Dans Intervalle entrez 1 et dans Fréquence sélectionnez Journée. Cela garantit que le déclencheur s’exécutera une fois par jour. 

   Vous pouvez définir les autres colonnes selon vos besoins. Dans cet exemple, nous définissons Aux heures indiquées sur 8, car nous souhaitons que le déclencheur s’exécute chaque matin à 8 heures. 

   

Étape 2 : récupérer toutes les opportunités qui se clôturent aujourd’hui

1. Sélectionnez Nouvelle étape et, dans la zone de recherche, entrez Microsoft Dataverse, puis choisissez Répertorier les enregistrements.

   

2. Ajoutez une requête de filtre pour récupérer toutes les opportunités se clôturant aujourd’hui.

   estimatedclosedate eq @{formatDateTime(utcNow(), 'yyyy-MM-dd')}

   

Étape 3 : pour chaque opportunité, créer une carte d’informations personnalisée

Pour toutes les opportunités extraites lors de l’étape précédente, nous allons utiliser une nouvelle opération Créer une carte pour l’assistant V2 et créer une carte d’informations.

1. Sélectionnez Nouvelle étape sous l’action Répertorier les enregistrements et ajoutez l’action Appliquer à chacun.

   

2. Sélectionnez toutes les opportunités dans le Contenu dynamique pour l’itération.

   

3. Dans l’opération Appliquer à chacun, sélectionnez Ajouter une action et recherchez Sales Insight. Vous verrez l’action Sales Insights comme indiqué dans la section d’introduction, choisissez l’opération Créer une carte pour l’assistant V2.

   

4. Entrez l’environnement et d’autres détails si nécessaire. Pour en savoir plus, consultez le didacticiel 1 : Hello world.

   

Vous pouvez constater que Prolonger la date de clôture est utilisé comme texte du bouton.

Nous allons faire Prolonger la date de clôture pour repousser la date de fin prévue de l’opportunité associée à l’aide de REST.

Action à l’aide de REST

1. Sélectionnez REST comme type de bouton et ajoutez le point de terminaison OData avec l’ID d’opportunité sélectionné à l’étape précédente. Dans le corps de REST, ajoutez un json dynamique avec une date ultérieure de 10 jours à compter d’aujourd’hui, et sélectionnez la méthode PATCH.

   {"estimatedclosedate": "@{getFutureTime(10, 'Day', 'yyyy-MM-dd')}"}

   

Étape 4 : enregistrer le flux

Étape 5 : tester le flux

Lorsque le flux s’exécute comme programmé ou que vous l’exécutez manuellement, une carte doit être créée et affichée sur le tableau de bord, comme illustré ci-dessous.

Notre action définie est disponible sous la forme d’un bouton sur la carte Sales Insights.

Sélectionnez Prolonger la date de clôture. L’opportunité est mise à jour avec la nouvelle date de clôture estimée et un message de confirmation s’affiche.

Nous avons prolongé la date de clôture prévue de l’opportunité avec une nouvelle action par le biais d’un appel REST.