Passer au contenu principal

[Workflow Builder - GCW] Comprendre le contexte du flux de travail et son impact sur la configuration des activités

Anastasiia Zbrozhek avatar
Écrit par Anastasiia Zbrozhek
Mis à jour il y a plus de 2 semaines

Cet article explique pourquoi le contexte est essentiel lors de la création d'un workflow et comment la structure de votre workflow, en particulier l'utilisation du traitement par lots, affecte la configuration des activités. Il se concentre sur la façon dont l'ajout d'une activité de traitement par lots dès le début modifie le contexte pour toutes les étapes suivantes, influençant ainsi la définition des valeurs et l'accès aux données de charge utile tout au long de votre flux. Comprendre cela dès le départ peut vous aider à éviter les erreurs de configuration et à assurer une exécution fluide du workflow.


Comprendre le contexte dans la configuration du flux de travail

Lorsque vous configurez un workflow, chaque activité que vous ajoutez fonctionne dans un certain contexte — celui-ci détermine comment les données sont accessibles et transmises entre les activités. Si vous ne prenez pas en compte le contexte approprié lors de la configuration de votre workflow, cela peut entraîner des confusions ou des erreurs par la suite.

Analysons cela :

  • Sans traitement par lots, chaque activité reçoit directement la charge utile d'entrée — par exemple :

    • payload.facility.country pourrait être une référence typique pour les données au début du flux de travail.

  • Avec le traitement par lots, les entrées changent — désormais vos activités font référence aux valeurs de flow.batch.items, comme :

    • flow.batch.items.productUID

Ce changement de structure est ce que nous entendons par « contexte ». Une fois qu'une activité par lot est ajoutée, en particulier au début de votre flux, les données pour les étapes suivantes doivent être accessibles en utilisant des chemins spécifiques aux lots.


Quand et pourquoi utiliser une activité par lots

Si vous prévoyez de regrouper ou de traiter plusieurs articles ensemble (par exemple, regrouper des commandes avant de créer des plaques), il est préférable d'ajouter l'activité Batch tout au début de votre flux de travail. Cela vous permet de :

  • Définissez une structure de données cohérente dès le départ.

  • Évitez les erreurs de configuration qui peuvent survenir lorsque vous passez d’un contexte non groupé à un contexte groupé en cours de configuration.

  • Assurez-vous que toutes les activités suivantes attendent et utilisent correctement les données par lots.

Une fois le traitement par lots mis en place, vos références de charge utile vont changer — configurez donc toujours vos activités en fonction de cette structure par lots.


Conseil clé pour la conception du flux de travail

Pour maintenir la clarté et éviter les problèmes :

  • Commencez toujours par une activité par lots si votre flux de travail implique un traitement groupé.

  • N'oubliez pas que chaque activité après le lot fonctionnera dans un nouveau contexte.

  • Configurez chaque étape en conséquence en vous référant à la structure par lots (par exemple, flow.batch.items).


FAQ

Pourquoi l'ajout d'une activité par lot modifie-t-il la structure de la charge utile ?
Le regroupement par lots rassemble plusieurs éléments dans une collection, ce qui modifie la façon dont les points de données individuels sont accessibles dans les étapes ultérieures. Au lieu de faire référence à un élément unique, vous travaillez désormais dans un contexte de tableau ou de groupe.

Que se passe-t-il si je configure les étapes avant le traitement par lots ?
Si vous configurez des étapes avant d'ajouter le lot, puis introduisez un lot ultérieurement, vous devrez peut-être revoir et ajuster ces étapes. Elles pourraient pointer vers des chemins de données obsolètes.

Puis-je ajouter une activité par lot plus tard dans le flux de travail ?
Techniquement oui, mais ce n'est pas recommandé. L'ajouter ultérieurement peut entraîner un contexte incohérent et nécessiter davantage de reconfiguration. Pour plus de clarté et de facilité de maintenance, il est préférable de commencer avec le traitement par lots si vous savez que vous en aurez besoin.

Avez-vous trouvé la réponse à votre question ?