Configurer les actions

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Vous pouvez activer une action personnalisée d'un workflow ou d'un dialogue, sans écrire de code.Pour plus d'informations :Appeler une action personnalisée à partir d'un workflow ou d'un dialogue.

Vous devrez également créer une action pour qu'un développeur puisse l'utiliser dans le code ou vous devrez peut-être modifier une action précédemment définie. Comme les processus de workflow, prenez en compte les éléments suivants :

• Que doivent accomplir les actions ?

• Dans quelles conditions les actions doivent-elles être effectuées ?

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 en arrière-plan : Les actions sont toujours des workflows en temps réel.

Une action a également quelque chose en plus par rapport aux processus de workflow : des arguments d'entrée et de sortie.Pour plus d'informations :Définir des arguments de processus

Contenu de la rubrique

Créer une action

Modifier une action

Créer une action

Important

Si vous créez une action qui est incluse à une solution qui sera distribuée, créez-la dans le contexte de la solution. Accédez à Paramètres > Solutions et recherchez la solution non gérée dont cette action fera partie. Ensuite, dans la barre de menus, sélectionnez Nouveau > Processus. Cela assurera la cohérence du préfixe de personnalisation associé au nom de l'action avec d'autres composants dans la solution. Après avoir créé l'action, vous ne pouvez pas modifier le préfixe.

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
  Vous pouvez utiliser 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.

Important

Une fois l'action activée et le code conçu pour utiliser un nom unique, le nom unique ne doit pas être modifié sans modifier également le code auquel il fait référence.

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 Microsoft Dynamics 365. Certains messages sur la plateforme Dynamics 365 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.

  Notes

  L'option d'activation de restauration n'est pas prise en charge si une action personnalisée est appelée directement à partir d'un workflow ou d'un dialogue. Vous pouvez activer la restauration si une action est déclenchée par un message de services Web de Dynamics 365.

• 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 dont le démarrage est attendu par l'action et celles qui seront ignorées par l'action.Pour plus d'informations :Définir des arguments de processus

• Ajouter des étapes, des conditions et des actions
  Comme avec les autres processus, vous spécifiez les actions à effectuer et quand les effectuer.Pour plus d'informations :Ajouter des phases et des étapes

Définir des arguments de processus

Lorsqu'un développeur utilise un message, il peut commencer par certaines données à transmettre dans le message et à utiliser. Par exemple, pour créer un nouvel enregistrement d'incident, vous pouvez transmettre la valeur du titre de l'incident en tant qu'argument. Il s'agirait d'un 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 doivent être définies en tant qu'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. Modifier cette signature provoquera 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.

Modifier l'ordre des arguments en les triant ou en les déplaçant vers le haut ou vers le bas ne change rien, car les arguments sont identifiés par leur nom et non par leur ordre. 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.

Type	Description
Boolean	Valeur true ou false.
DateTime	Valeur qui stocke les informations de date et d'heure.
Decimal	Valeur sous forme de nombre à précision décimale. Utilisée lorsque la précision est extrêmement importante.
Entity	Enregistrement Dynamics 365 pour l'entité spécifiée. Quand vous sélectionnez Entity, la liste déroulante est activée et vous permet de sélectionner le type d'entité.
EntityCollection	Collection d'enregistrements d'entités.
EntityReference	Objet qui contient le nom, l'ID et le type d'un enregistrement d'entité qui l'identifie de façon unique. Quand vous sélectionnez EntityReference, la liste déroulante est activée et vous permet de sélectionner le type d'entité.
Float	Valeur sous forme de nombre à précision décimale. Utilisé lorsque les données proviennent d'une mesure qui n'est pas tout à fait précise.
Integer	Nombre entier.
Money	Valeur qui stocke les données concernant une somme d'argent.
Picklist	Valeur qui représente une option pour un attribut OptionSet.
String	Valeur texte

Notes

Les valeurs de l'argument EntityCollection ne peuvent pas être définies dans l'interface utilisateur pour des conditions ou des actions. Elles sont fournies pour être utilisées par les développeurs dans le code personnalisé.Pour plus d'informations :Créer vos propres actions

Ajouter des phases et des étapes

Les actions sont un type de processus très proche des 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.

Outre les étapes pouvant être utilisées pour les workflows en temps réel, les actions ont également l'étape Attribuer une valeur semblable à celle utilisée pour définir des variables ou des arguments d'entrée dans les dialogues. 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
Appeler une action personnalisée à partir d'un workflow ou d'un dialogue
Surveiller les workflows et les actions en temps réel
Création et modification de processus
Processus de workflow
Boîtes de dialogue
Flux des processus d'entreprise
Surveillance et gestion des processus
Créer vos propres actions

© 2016 Microsoft Corporation. Tous droits réservés. Copyright