Utilisation de l’éditeur de flux de travail dans Shopify Flow

L’éditeur de flux de travail est un outil qui vous permet de personnaliser et de modifier les fonctionnalités de vos flux de travail dans Shopify Flow. L’éditeur de flux de travail dispose d’une interface par glisser-déposer, qui vous permet d’organiser et de concevoir vos flux de travail en y ajoutant des étapes de différents types à la verticale, de haut en bas.

La première étape que vous pouvez ajouter à un flux de travail à l’aide de l’éditeur de flux de travail est toujours une étape de déclencheur. Après avoir ajouté le déclencheur de flux de travail, vous pouvez utiliser les icônes + pour ajouter les étapes de condition ou d’action qui se produisent ensuite dans la séquence du flux de travail. Des flèches relient les différentes étapes dans l’éditeur de flux de travail et indiquent quelles étapes mènent directement à d’autres en fonction des conditions appliquées ou des actions exécutées.

Toutes les étapes doivent être connectées à au moins 1 autre étape du flux de travail pour fonctionner. Vous pouvez ajouter des étapes en dehors du flux de travail, n’importe où dans l’éditeur, mais celles-ci ne feront pas partie du flux de travail à moins d’être reliées à une autre étape par une flèche. Chaque étape ne peut être précédée que d’une seule étape. Par conséquent, la convergence de plusieurs branches du flux de travail vers un chemin d’étape unique n’est pas prise en charge.

Vous pouvez configurer les détails des étapes de condition et d’action à l’aide du panneau de configuration situé sur le côté gauche de l’éditeur de flux de travail. Le panneau de configuration s’affiche uniquement lorsqu’une étape est sélectionnée.

Conseil

Vous pouvez ajouter une note à votre flux de travail dans l’éditeur de flux de travail. Les notes vous permettent de consigner des informations sur votre flux de travail avec vos propres mots.

Ouvrir un flux de travail dans l’éditeur de flux de travail

Dans Shopify Flow, vous pouvez accéder à l’éditeur de flux de travail en créant un nouveau flux de travail, ou vous pouvez cliquer sur n’importe quel flux de travail existant, puis sur Modifier.

Étapes :

1. Depuis votre interface administrateur Shopify, allez à Applications > Flow.

2. Dans la section Flux de travail, effectuez l’une des actions suivantes :

   • Pour ouvrir l’éditeur de flux de travail pour un nouveau flux de travail vide, cliquez sur Créer un flux de travail.
   • Pour ouvrir l’éditeur de flux de travail pour un flux de travail existant, cliquez sur le flux de travail, puis sur Modifier.

Ajouter une étape à un flux de travail

Dans l’éditeur de flux de travail, vous pouvez ajouter une étape au flux de travail de l’une des manières suivantes :

• Pointez sur n’importe quelle étape existante et cliquez sur l’icône + pour sélectionner une étape de condition ou d’action à ajouter comme connexion suivante dans le flux de travail.
  • Les étapes de condition ont deux icônes + : une pour le chemin Vrai lorsque la condition est remplie, et une pour le chemin Faux lorsque la condition n’est pas remplie.
  • L’étape d’action Boucle pour chaque (itérer) a également deux icônes + : une pour Répéter pour chaque article, qui vous permet de définir les étapes qui se produisent pour chaque article de la liste, et une pour Après le dernier article, qui vous permet de définir les étapes qui se produisent une fois que le dernier article de la liste est retourné.
• Cliquez sur un espace vide n’importe où dans l’éditeur de flux de travail. S’il n’y a aucun déclencheur existant dans le flux de travail, le panneau de configuration affiche les options de l’étape de déclencheur. S’il y a un déclencheur existant dans le flux de travail, le panneau de configuration affiche les options de l’étape d’action.

Copier et coller des étapes dans un flux de travail

La création de flux de travail implique souvent de recréer des étapes déjà configurées ailleurs. Dans l’éditeur de flux de travail, vous pouvez copier une ou plusieurs étapes d’action ou de condition existantes et les coller dans le même flux de travail ou dans un autre, plutôt que de les recréer de toutes pièces. Les étapes collées conservent les valeurs des champs de configuration des étapes copiées ainsi que leur logique pour les étapes de condition. Elles ne nécessitent donc que de légères modifications pour être utilisées.

Lorsque vous copiez plusieurs étapes à la fois, les connexions entre les étapes copiées sont conservées. Ainsi, une condition et les étapes de ses branches Vrai et Faux sont collées sous la forme d’un groupe d’étapes reliées entre elles. Les connexions provenant d’étapes que vous n’avez pas copiées ne sont pas conservées. Le groupe collé n’est donc pas relié au reste du flux de travail tant que vous ne l’avez pas connecté. Si une étape copiée utilise des données renvoyées par une autre étape copiée, comme une action Obtenir des données, l’étape collée utilise les données renvoyées par la copie collée de cette action.

Les étapes de type déclencheur ne peuvent pas être copiées. Les étapes qui utilisent une page de configuration personnalisée, comme Envoyer un e-mail marketing, ne peuvent pas non plus être copiées. Si votre sélection comprend une étape qui ne peut pas être copiée, aucune des étapes sélectionnées n’est copiée.

Étapes :

1. Ouvrez un flux de travail dans l’éditeur de flux de travail.
2. Sélectionnez les étapes à copier :
   • Pour copier une seule étape, cliquez sur l’étape d’action ou de condition.
   • Pour copier plusieurs étapes, maintenez la touche Maj de votre clavier enfoncée, puis cliquez sur chaque étape à copier, ou maintenez la touche Maj enfoncée et tracez un rectangle de sélection autour des étapes.
3. Copiez les étapes en appuyant sur ctrl + C sur un PC ou sur commande + C sur un Mac.
4. Facultatif : si vous collez les étapes dans un autre flux de travail, ouvrez ce flux dans l’éditeur de flux de travail. Le flux de travail de destination doit déjà comporter une étape de type déclencheur.
5. Collez les étapes en appuyant sur ctrl + V sur un PC ou sur commande + V sur un Mac. Une étape seule est ajoutée près de votre curseur. Un groupe d’étapes est ajouté dans l’espace libre le plus proche de votre curseur, avec la même disposition que les étapes copiées. Le groupe collé est sélectionné pour que vous puissiez le déplacer. Si votre curseur ne se trouve pas dans l’éditeur, les étapes sont ajoutées au centre de celui-ci.
6. Connectez les étapes collées au reste du flux de travail avant d’activer le flux de travail.

Connecter les étapes d’un flux de travail

Toutes les étapes doivent être connectées à au moins 1 autre étape du flux de travail pour fonctionner. L’éditeur de flux de travail indique quelles étapes sont connectées les unes aux autres à l’aide de flèches directionnelles. Par défaut, les flux de travail s’écoulent à la verticale de haut en bas dans l’éditeur de flux de travail.

Lorsque vous ajoutez une étape au flux de travail à partir d’une autre étape à l’aide de l’icône +, la nouvelle étape se connecte automatiquement à l’étape précédente. Vous pouvez également créer manuellement une connexion entre les étapes en cliquant sur le + de la première étape, en le maintenant enfoncé et en faisant glisser l’extrémité de la flèche vers la deuxième étape. Chaque étape ne peut avoir qu’une seule connexion à une étape précédente. Par conséquent, la convergence de plusieurs branches du flux de travail en un seul chemin d’étape n’est pas prise en charge.

Vous pouvez supprimer une connexion entre des étapes en pointant sur la flèche que vous souhaitez supprimer, puis en cliquant sur l’icône .

Organisation des étapes dans l’éditeur de flux de travail

Vous pouvez déplacer des étapes par glisser-déposer dans l’éditeur de flux de travail pour organiser manuellement la mise en page de votre flux de travail. Il vous est ainsi plus facile de suivre votre flux de travail au fur et à mesure que vous le créez. Par défaut, les étapes se connectent les unes aux autres de haut en bas, mais vous pouvez glisser-déposer des étapes n’importe où dans l’éditeur de flux de travail sans rompre les connexions des flèches entre les étapes.

Vous pouvez déplacer plusieurs étapes à la fois en maintenant la touche Maj de votre clavier enfoncée, puis en cliquant sur les étapes que vous souhaitez sélectionner sous forme de groupe. Cliquez et faites glisser n’importe quelle étape dans la zone de groupe grise pour déplacer les étapes incluses en bloc.

Vous pouvez réinitialiser automatiquement la mise en page de votre flux de travail avec l’espacement par défaut entre les étapes pour faciliter sa consultation. Cliquez sur l’icône , puis cliquez sur Organiser le flux de travail pour confirmer la réinitialisation.

Supprimer une étape d’un flux de travail

Dans l’éditeur de flux de travail, vous pouvez supprimer une étape du flux de travail en pointant sur celle que vous souhaitez supprimer, puis en cliquant sur l’icône à côté de l’étape. La suppression d’une étape est irréversible.

Vous pouvez supprimer plusieurs étapes à la fois en maintenant la touche Maj de votre clavier enfoncée, puis en cliquant sur les étapes que vous souhaitez sélectionner sous forme de groupe. Cliquez sur l’icône au-dessus de la zone de groupe grise pour supprimer les étapes en bloc.

Si vous supprimez une étape à laquelle d’autres étapes sont connectées, ces étapes restent dans l’éditeur de flux de travail, mais sont déconnectées de toute étape précédente. Vous devez reconnecter manuellement les étapes déconnectées pour continuer à utiliser ces étapes dans le flux de travail.

Utilisation de la barre d’outils d’affichage de l’éditeur de flux de travail

En bas de l’éditeur de flux de travail, vous pouvez cliquer sur l’une des icônes suivantes dans la barre d’outils d’affichage :

• Utilisez ou pour effectuer un zoom arrière ou avant sur le flux de travail.
• Utilisez l’icône pour centrer votre flux de travail dans la zone visible de l’éditeur de flux de travail, au niveau de zoom affichant l’intégralité du flux de travail.
• Utilisez pour lancer la documentation du Centre d’aide de Shopify Flow dans un nouvel onglet de navigateur.
• Utilisez pour organiser la mise en page de votre flux de travail.

Utilisation du panneau de configuration de l’étape dans l’éditeur de flux de travail

Lorsque vous sélectionnez une étape, le panneau de configuration s’affiche sur le côté gauche de l’éditeur de flux de travail. Le panneau de configuration contient les détails de l’étape et c’est là que vous pouvez personnaliser la fonctionnalité d’étapes spécifiques, par exemple en définissant des variables, en attribuant des opérateurs logiques ou en ajoutant des informations d’action personnalisées en fonction de ce que vous voulez que l’étape fasse.

Les options qui s’affichent dans le panneau de configuration sont directement liées au type d’étape que vous sélectionnez.

Ajout ou modification de la description d’une étape

Vous pouvez modifier la description de n’importe quelle étape de condition ou d’action depuis le panneau de configuration. Cliquez sur Ajouter une description ou Modifier la description et saisissez une description de l’étape avec vos propres mots. Cela peut vous aider, vous et vos employés, à interpréter ce que fait le flux de travail en fonction de votre propre description. Vous pouvez supprimer tout le texte du champ de description pour réinitialiser la description de l’étape.

Vérification d’une étape pour le contenu de configuration manquant

Si des données ou des détails de configuration qui ont un impact sur sa capacité à fonctionner sont manquants dans une étape, une bannière À vérifier s’affiche en haut de l’étape. Cliquez sur l’étape pour ouvrir son panneau de configuration et ajoutez les données manquantes pour supprimer la bannière À vérifier. À moins qu’un champ ne soit indiqué comme étant facultatif, il doit être rempli pour que l’étape soit considérée comme entièrement configurée.

Les étapes affichent également une bannière À vérifier lorsqu’elles ne sont connectées à aucune autre étape. Vous devez connecter l’étape à une autre étape du flux de travail avant de pouvoir continuer à configurer les détails de l’étape.

Si une bannière À vérifier n’est pas résolue avant la tentative d’activation du flux de travail, l’étape s’affiche comme une erreur et le flux de travail ne s’active pas. Vous devez résoudre toutes les erreurs de configuration d’un flux de travail avant de pouvoir l’activer.

Utilisation de la boîte de dialogue « Ajouter une variable »

Dans le panneau de configuration de l’étape, certains champs ont une option Ajouter une variable pour ajouter une variable au contenu de la configuration. Les jeux de données qui sont affichés dans la boîte de dialogue Ajouter une variable dépendent des données renvoyées par les étapes précédentes du flux de travail. Par exemple, par défaut, la boîte de dialogue Ajouter une variable s’affiche avec les options suivantes :

• Une barre de recherche pour rechercher des variables par nom ou par description.
• Les jeux de données de variables par défaut renvoyés par le déclencheur du flux de travail, qui incluent généralement les options suivantes :
  • les variables shop, qui sont globales à votre boutique.
  • Au moins 1 autre type, en fonction du déclencheur du flux de travail.

Cependant, si vous ajoutez des étapes au flux de travail qui renvoient des données supplémentaires, telles que des actions Obtenir les données ou Exécuter le code, des jeux de données de variables supplémentaires s’affichent dans la boîte de dialogue que vous pourrez sélectionner pour toute étape ultérieure de la branche du flux de travail, car les données supplémentaires sont maintenant disponibles à ce stade du flux de travail. Les données renvoyées les plus récentes s’affichent en premier.

Vous pouvez accéder à des variables spécifiques en cliquant sur les différentes options de variables. Certaines variables ont des options imbriquées et sont accompagnées d’un > pour indiquer qu’il existe des sous-options dans ce chemin d’API de variable. Lorsque vous avez atteint la fin d’un chemin d’API de variable, la variable n’a pas d’option > et affiche un badge de type de contenu de variable, tel que String, Boolean, DateTime ou Int, pour indiquer le type d’informations renvoyées par la variable.

Conseil

Pour en savoir plus sur un élément particulier d’une variable, passez le curseur sur la variable et cliquez sur l’icône pour ouvrir l’article correspondant de la documentation pour les développeurs de Shopify.