Créer ou modifier les actions personnalisées à partir d’un flux de travail

Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Configurer des actions personnalisées à partir d’un flux de travail

Vous pouvez activer une action personnalisée à partir d’un workflow sans écrire de code. Pour plus d’informations, consultez Appeler des actions personnalisées à partir d’un workflow.

Vous pouvez également créer une action afin qu’un développeur puisse l’utiliser dans du code, ou vous pouvez être amené à modifier une action déjà définie. Comme les processus de workflow, prenez en compte les éléments suivants :

• Que doit faire cette action ?

• Dans quelles conditions l’action doit-elle être effectuée ?

Contrairement aux processus de workflow, il est inutile de définir les options suivantes :

• Démarrer lorsque : Les actions démarrent lorsque le code appelle le message généré pour celles-ci.

• Étendue : Les actions fonctionnent toujours dans le contexte de l’utilisateur appelant.

• Exécuter à l’arrière-plan : Les actions sont toujours des flux de travail en temps réel.

Les actions ont également quelque chose que les processus de workflow n’ont pas : des arguments d’entrée et de sortie. Pour plus d’informations, consultez Définir les arguments de processus.

Créer une action

Comme les processus de workflow, les actions ont les propriétés suivantes dans la boîte de dialogue Créer un processus.

Nom de processus
Après avoir entré un nom du processus, un nom unique lui est créé en supprimant tous les espaces et caractères spéciaux du nom de processus.

Catégorie
Cette propriété établit qu’il s’agit d’un processus en cours. Vous ne pouvez pas modifier cela après avoir enregistré le processus.

Entité
Avec des processus actions, vous pouvez sélectionner une entité pour fournir le contexte au workflow comme pour les autres types de processus, mais vous avez également la possibilité de choisir Aucun (Global). Utilisez cette option si votre action ne nécessite pas le contexte d’une entité spécifique. Vous ne pouvez pas modifier cela après avoir enregistré le processus.

Type
Utilisez cette propriété pour choisir de créer entièrement une nouvelle action ou de la démarrer à partir d’un modèle.

Modifier une action

Vous devez désactiver les processus avant de les modifier.

Vous pouvez modifier une action qui a été créée dans le cadre d’une solution non gérée ou qui est incluse dans une solution installée dans votre organisation. Si la solution est une solution gérée, vous ne pourrez peut-être pas la modifier. L’éditeur de solutions a la possibilité de modifier les propriétés gérées afin que l’action installée avec une solution gérée ne puisse pas être modifiée.

Lorsqu’une action est enregistrée, un nom unique est généré en fonction du nom du processus. Ce nom unique a le préfixe de personnalisation ajouté à partir de l’éditeur de solutions. Il s’agit du nom du message qu’un développeur utilise dans son code.

Lorsque vous modifiez une action, vous avez plusieurs possibilités :

Nom du processus
Une fois le processus créé et le nom unique généré à partir du nom du processus, vous pouvez modifier le nom du processus. Vous voudrez peut-être appliquer une convention d’affectation de noms pour repérer plus facilement les processus spécifiques.

Nom unique
Lorsqu’une action est enregistrée, un nom unique est généré en fonction du nom du processus. Ce nom unique a le préfixe de personnalisation de l’éditeur de solutions ajouté. Il s’agit du nom du message qu’un développeur utilise dans son code. Ne modifiez pas ce nom unique si le processus a été activé et que le code est en place pour appeler l’action en utilisant ce nom.

Activer la restauration
Généralement, les processus qui prennent en charge les transactions veulent « annuler » (ou restaurer) l’opération entière si une partie échoue. Voici quelques exceptions à cela. Certaines actions que les développeurs peuvent exécuter dans du code initialisé par l’action peuvent ne pas prendre en charge des transactions. Par exemple, si le code effectue des actions dans d’autres systèmes en dehors de la portée de la transaction. Ces dernières ne peuvent pas être annulées par l’action qui s’exécute dans une application. Certains messages sur la plateforme ne prennent pas en charge les transactions. Mais tout ce que vous pouvez faire avec l’interface utilisateur de l’action prend en charge les transactions. Toutes les actions qui font partie d’un workflow en temps réel sont considérées comme faisant partie de la transaction, mais avec les actions vous pouvez faire différemment.

Vous devez consulter le développeur qui utilisera ce message pour déterminer s’il est nécessaire qu’elles soient dans la transaction ou non. En règle générale, une action doit faire partie de la transaction si les actions effectuées par les processus d’entreprise n’ont pas de sens tant qu’elles ne sont pas toutes terminées correctement. L’exemple classique est le transfert de fonds entre deux comptes bancaires. Si vous retirez des fonds d’un compte, vous devez les déposer dans l’autre. Si l’une des deux actions échoue, les deux doivent échouer.

Activer en tant que
Comme pour tous les processus, vous pouvez activer le processus sous la forme d’un modèle et l’utiliser comme point de départ avancé pour les processus qui suivent un modèle similaire.

Définir des arguments de processus
Dans cette zone, vous spécifiez toutes les données que l’action attend pour démarrer et les données à transmettre au terme de l’action. Pour plus d’informations, consultez Définir les arguments de processus.

Ajouter des étapes, des conditions et des actions
Comme pour les autres processus, vous spécifiez les actions à effectuer et à quel moment les effectuer. Pour plus d’informations, consultez Ajouter des étapes, conditions et actions

Définir les arguments de processus

Lorsqu’un développeur utilise un message, il peut commencer par certaines données à transmettre dans le message. Par exemple, pour créer un enregistrement d’incident, la valeur du titre de l’incident peut être transmise en tant qu’argument d’entrée.

Lorsque le message est terminé, le développeur peut vouloir transmettre certaines données qui ont été modifiées ou générées par le message à une autre opération dans son code. Ces données sont l’argument de sortie.

Les arguments d’entrée et de sortie doivent avoir un nom, un type et certaines informations indiquant si l’argument est toujours obligatoire. Vous pouvez également fournir une description.

Le nom du message et les informations sur tous les arguments du processus sont la « signature » du message. Lorsqu’une action est activée et utilisée dans le code, la signature ne doit pas changer. Si cette signature change, cela provoque l’échec du code qui utilise le message. La seule exception à cela peut être la modification d’un des paramètres afin qu’il ne soit pas toujours obligatoire.

Vous pouvez modifier l’ordre des arguments en les triant ou en les déplaçant vers le haut ou vers le bas, car les arguments sont identifiés par leur nom et non par leur ordre. De plus, le fait de modifier la description ne modifie pas le code qui utilise le message.

Types d’argument des processus d’action

Le tableau suivant décrit les types d’argument des processus d’action.

Ajouter des phases et des étapes

Les actions sont un type de processus très similaire aux workflows en temps réel. Toutes les étapes qui peuvent être utilisées dans les workflows en temps réel peuvent l’être dans des actions. Pour plus d’informations sur les étapes pouvant être utilisées pour les workflows en temps réel et les actions, voir Phases et étapes de workflow.

En plus des étapes pouvant être utilisées pour les workflows en temps réel, les actions comportent également l’étape Attribuer une valeur. Dans les actions, elle peut être utilisée uniquement pour définir les arguments de sortie. Vous pouvez utiliser l’Assistant Formulaire pour définir des valeurs spécifiques pour les arguments de sortie ou, plus probablement, des valeurs qui proviennent de l’enregistrements dans lequel l’action s’exécute, des enregistrements associés à cet enregistrement avec une relation plusieurs-à-un, des enregistrements créés dans une précédente étape ou des valeurs qui font partie du processus lui-même.

Voir aussi

Actions
Invoquer des actions personnalisées à partir d’un workflow
Surveiller les workflows et les actions en temps réel
Processus de workflow
Vue d’ensemble des flux de processus d’entreprise
Surveillance et gestion des processus de workflow
Créer vos propres actions