Répéter une action sur une liste

À quoi ça sert

Une action « Créer une tâche » crée en général une seule tâche. Quand le déclencheur porte une liste, vous pouvez en créer une par élément : une tâche par pièce jointe d'un contrat, une visite tous les six mois pendant un an, une ligne de suivi par produit. Vous n'écrivez l'action qu'une fois ; la règle la répète.

La répétition est un réglage de l'action « Créer une tâche ». Elle ne s'applique à aucune autre action. Voir Configurer les actions pour le reste des actions.

Concepts clés

• Liste à répéter — une formule qui donne une liste, saisie dans « Répéter pour chaque élément de ». Exemple : {{= record.crmAttachments }}.
• Élément — une valeur de la liste. Il se lit par {{item.champ}} ou {{= item }} dans les champs de la tâche.
• Position — le rang de l'élément dans la liste, à partir de 0 : {{= index }}.
• Itération — une exécution de l'action pour un élément.

Comment faire

Créer une tâche par élément d'une liste

1. Ouvrez la règle et repérez l'action « Créer une tâche ».
2. Dans « Répéter pour chaque élément de », saisissez la formule de la liste, par exemple {{= record.crmAttachments }}. Laissez le champ vide pour créer une seule tâche.
3. Dans les champs de la tâche (le nom, la description…), lisez l'élément avec {{item.champ}} ou {{= item }}, et sa position avec {{= index }}. Par exemple, {{= index + 1 }} numérote les tâches à partir de 1.
4. Enregistrez la règle.

La règle crée une tâche par élément. La formule doit être une formule unique de la forme {{= … }} ; sinon l'enregistrement est refusé avec « La liste à répéter doit être une formule unique, de la forme '{{= … }}' ».

Fabriquer la liste avec une formule

Une liste peut aussi se construire. range(n) donne les nombres de 0 à n-1, et map les transforme. Par exemple, une date de visite tous les six mois : range(2).map(k, addMonths(record.startDate, k * 6)). Voir Calculer une valeur avec une formule.

Vérifier avant d'activer

1. Sur la vue « Graphique », cliquez sur « Tester sur des cas réels ».
2. Sous l'action, lisez le nombre de tâches annoncé pour chaque exemple.

L'aperçu indique « 3 tâches seraient créées », ou « Liste non évaluable sur cet exemple : {erreur} » quand la formule ne donne pas de liste sur cet exemple. Aucune tâche n'est créée pendant le test. Voir Créer une règle.

Suivre le résultat

1. Ouvrez « Administration », « Automatisations », onglet « Exécutions ».
2. Repérez l'action sur la ligne de l'exécution.

Sous l'action, « 2 tâches créées sur 3 » indique le nombre d'itérations réussies, et « Liste vide » signale une liste sans élément. Voir Exécutions et historique.

Référence

Règles de la répétition

Messages de refus

Questions fréquentes

Puis-je répéter une autre action qu'une création de tâche ?

Pas pour l'instant : seule l'action « Créer une tâche » accepte la répétition.

Puis-je lire l'élément dans la condition de l'action ?

Non. item et index n'existent que pendant l'exécution d'une itération, dans les paramètres de l'action.

Que se passe-t-il si la règle est interrompue en cours de route ?

La reprise ne recrée pas les tâches déjà créées. Dans le cas rare d'un arrêt exactement entre la création d'une tâche et son enregistrement, une tâche peut être créée en double.