Partager via

Configurer des actions de processus personnalisées à partir d’un flux de travail

  • Article

Vous pouvez activer une action de processus personnalisée d’un workflow en temps réel sans écrire de code. Pour plus d’informations : Appeler des actions personnalisées à partir d’un workflow.

Vous pouvez également créer une action de processus 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 en temps réel, 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 en temps réel, il est inutile de définir les options suivantes :

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

  • Étendue : les actions de processus personnalisées s’exécutent toujours dans le contexte de l’utilisateur appelant.

  • Exécuter à l’arrière-plan : les actions de processus personnalisées 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 en temps réel n’ont pas : les arguments d’entrée et de sortie. Pour plus d’informations : Définir les arguments de processus

Créer une action de processus personnalisée

Important

Si vous créez une action à 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.

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

Comme les processus de workflow en temps réel, 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 d’action, vous pouvez sélectionner une table pour fournir le contexte au workflow en temps réel 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.

Modifier une action

Vous devez désactiver les processus 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 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 de processus personnalisée 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

    En règle générale, les processus qui prennent en charge les transactions annulent l’intégralité de l’opération si une partie d’entre elles échoue. Il existe quelques exceptions. Les actions exécutées dans le code par un développeur 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 au-delà de l’étendue 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 de processus personnalisée est déclenchée par un message de services web Power Apps.
    • Si l’action définie ne modifie pas les données, mais récupère uniquement les données, il existe certaines situations où les performances peuvent être améliorées en désactivant Activer la restauration.

  • 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 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 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, ce qui 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 tableReference, 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 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, accédez à 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

Utiliser des actions
Appeler des actions personnalisées à partir d’un workflow
Surveiller les workflows et les actions en temps réel

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