Actions
Si tous les filtres sont passés, la règle commencera à exécuter ses actions. Les actions sont définies dans la section « Then » (Ensuite) de l'interface utilisateur. Tout nombre d'actions peut être défini pour une règle.
Les types d'actions suivants sont disponibles :
- Mettre à jour l'entité. Disponible pour la source d'entité modifiée.
- Créer une entité. Disponible pour toutes les sources.
- Créer une entité et l'ajouter en tant que relation. Disponible pour la source d'entité modifiée.
- Déplacer l'entité vers l'état. Disponible pour la source d'entité modifiée.
- Ajouter un commentaire. Disponible pour la source d'entité modifiée.
- Exécuter JavaScript la fonction. Disponible pour toutes les sources.
- Envoyer HTTP la demande. Disponible pour toutes les sources.
Lorsque vous utilisez les actions Mettre à jour l'entité, Déplacer l'entité vers l'état et Ajouter un commentaire, vous pouvez également sélectionner l'entité associée pour effectuer ces actions :
Mettre à jour l'entité
L'action de mise à jour d'entité permet d'effectuer des modifications sur les entités cibles ou associées. L'utilisateur doit choisir un champ et définir une valeur pour ce champ. Il est possible de choisir un nombre illimité de champs. Pour définir la valeur des champs, il est possible d'utiliser à la fois des valeurs constantes et des valeurs provenant de champs référencés de l'entité modifiée.
Créer une entité
Dans l'action Créer une entité, l'utilisateur doit choisir le type d'entité à créer et fournir des valeurs pour les nouveaux champs de l'entité. Il est possible de choisir un nombre illimité de champs. Pour définir les valeurs des champs, il est possible d'utiliser à la fois des valeurs constantes et des valeurs provenant de champs référencés à partir de l'entité modifiée.
Créer une entité et l'ajouter comme relation
Créer une entité en tant que relation est similaire à l'action Créer une entité, sauf que la nouvelle entité deviendra automatiquement une relation avec l'entité cible. L'utilisateur peut sélectionner la direction et le type de relation :
Déplacer l'entité vers l'état
Dans l'action « Déplacer l'entité vers l'état », l'utilisateur doit sélectionner le type d'état vers lequel l'entité modifiée ou associée doit être déplacée.
Ajouter un commentaire
Dans l'action Ajouter un commentaire, l'utilisateur peut définir un modèle pour le commentaire qui sera ajouté à l'entité modifiée ou associée selon la règle. Les champs de l'entité modifiée sont accessibles entre deux accolades {{}}.
Exécuter JavaScript la fonction
La JavaScript fonction Exécuter est disponible à la fois pour l'entité modifiée et la source du webhook entrant.
Dans cette action, l'utilisateur écrit le corps de JavaScript la fonction qui doit renvoyer un tableau de commandes décrivant les modifications dans le processus cible :
Actuellement, le nombre maximal de commandes de modification pouvant être effectuées par une action Javascript est de 50.
Dans JavaScript les actions, le script a accès en lecture seule au processus cible api/v2 et aux informations relatives au changement qui a déclenché la règle, y compris les valeurs d'origine des champs modifiés. Pour plus de détails, consultez notre documentation.
Envoyer une requête HTTP
Dans l'action d'envoi de requête HTTP, l'utilisateur a la possibilité de saisir l'URL et le modèle de corps de la requête à envoyer lors de l'exécution de la règle. À l'aide de doubles accolades, l'utilisateur peut accéder aux champs de l'entité modifiée et des entités associées.
Si un champ (tel que Description ou un champ personnalisé de type texte) est envoyé à un point de terminaison qui attend une charge utile JSON (tel que Slack ou Zapier hook), la valeur envoyée peut contenir des caractères critiques pour le format JSON. Dans ce cas, la fonction ToJsonText doit être appliquée à chaque champ susceptible de contenir des caractères pouvant endommager le JSON :
{
"text": "New comment: {{ToJsonText(Description)}}",
"icon_emoji": ":bee:",
"username": "Targetprocess",
"channel": "#slack-test"
}