Créer une action de processus personnalisée

Utilisez des actions de processus personnalisées quand vous souhaitez automatiser une série de commandes dans le système. Les actions de processus personnalisées enrichissent le vocabulaire à la disposition des développeurs pour exprimer les processus d’entreprise. Une action de processus personnalisées utilise les verbes principaux fournis par le système, comme Créer, Mettre à jour, Supprimer et Attribuer, pour créer d’autres verbes encore plus expressifs comme Approuver, Transmettre, Acheminer ou Planifier. Si la définition d’un processus d’entreprise change, un utilisateur qui n’est pas développeur peut modifier l’action de processus personnalisées sans besoin de modifier le code.

Notes

Si vous envisagez d’écrire un plug-in pour implémenter votre logique pour une action de processus personnalisée au lieu d’utiliser le concepteur de flux de travail, vous devez utiliser l’API personnalisée à la place. Plus d’informations : Comparer l’action du processus personnalisée et l’API personnalisée

Créer une action de processus personnalisée

Important

Si vous créez une action de processus personnalisées à inclure à 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 managée dont cette action fera partie. Ensuite, dans la barre de menus, sélectionnez Nouveau > Processus. Cela assure 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 de processus personnalisées 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.

• Tableau

  Avec des processus actions, vous pouvez sélectionner une table 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 table 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 de processus personnalisées ou de la démarrer à partir d’un modèle.

Contrairement aux processus de flux de travail, vous n’avez pas besoin 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 de processus personnalisées ont également quelque chose que les processus de flux de travail n’ont pas : les arguments d’entrée et de sortie.

Notes

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

Modifier une action de processus personnalisée

Vous devez désactiver les actions de processus personnalisées avant de les modifier.

Vous pouvez modifier une action de processus personnalisée 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 de 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.

  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.

• 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 de processus personnalisée 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.

  Notes

  Vous ne pouvez pas activer la restauration si une action de processus personnalisée est appelée directement à partir d’un workflow. Vous pouvez activer la restauration si une action est déclenchée par un message de services Web de Power Apps.

• 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 les arguments de processus

• Ajouter des phases et des étapes

  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. Par exemple, pour créer une ligne 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 de processus personnalisée 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.

Type	Description
Booléenne	Valeur true ou false.
Date/Heure	Valeur qui stocke les informations de date et d’heure.
Décimal	Valeur sous forme de nombre à précision décimale. Utilisée lorsque la précision est extrêmement importante.
Tableau	Une ligne pour la table spécifiée. Quand vous sélectionnez table, la liste déroulante est activée et vous permet de sélectionner le type de table.
entityCollection	Ensemble de lignes de table.
entityReference	Objet qui contient le nom, l’ID et le type d’une ligne de table 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 de table.
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.
Entier	Nombre entier.
Devise	Valeur qui stocke les données concernant une somme d’argent.
Liste déroulante	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, voir : Créer vos propres messages

Ajouter des phases et des étapes

Les actions de processus personnalisées sont un type de processus très similaires aux flux de travail 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 lignes associées à cette ligne avec une relation plusieurs-à-un, des lignes créées dans une précédente étape ou des valeurs qui font partie du processus lui-même.

Propriétés gérées

Les actions de processus personnalisées ont deux propriétés gérées pertinentes

Est personnalisable

La propriété gérée Is Customizable contrôle si quelqu’un qui installe un solution gérée contenant l’action de processus personnalisée peut le modifier ou le supprimer. Si vous souhaitez que l’action de processus personnalisée soit modifiée ou supprimée lorsqu’elle est incluse dans un solution gérée, vous devez définir cette propriété sur true.

Étape de traitement personnalisée autorisée pour d’autres éditeurs

La propriété gérée Is Custom Processing Step Allowed for Other Publishers contrôle si les développeurs de plug-ins tiers peuvent enregistrer les étapes du plug-in sur le message créé par l’action de processus personnalisé. Lorsque cela est vrai, les plug-ins enregistrés par n’importe qui sur ce message s’exécutent et peuvent modifier le comportement de l’action de processus personnalisée. Lorsque la valeur est false, seules les étapes de plug-ins enregistrées dans une solution à partir du même éditeur de solutions seront exécutées.

Étapes suivantes

Appeler des actions de processus personnalisées à partir d’un workflow

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).