Configurer un flux de travaux

Le contenu est traduit de l’anglais par Phrase Language AI.

Pour continuer avec le flux de travaux d'exemple, il devra être configuré.

La configuration du bloc peut être accédée en cliquant sur Modifier les paramètres dans l'onglet Configurer, ou en faisant un clic droit sur le bloc et en sélectionnant Modifier les paramètres pour ouvrir la fenêtre Modifier les paramètres. Une fois qu'un bloc a des paramètres, le bouton Ajouter des paramètres passe à Modifier les paramètres.

Pour configurer les blocs pour l'exemple, suivez ces étapes :

Ouvrez la fenêtre Modifier les paramètres pour l'action Liste des locales.

Les champs Jeton d'accès et Projet nécessiteront des valeurs dynamiques qui sont résolues à l'exécution.

Cliquez sur l'icône de lien pour le champ Jeton d'accès et sélectionnez l'action Récupérer les jetons d'accès.

Le lien devient vert et le champ peut être modifié.
La syntaxe pour accéder aux propriétés d'un déclencheur ou d'une action référencée est :
```
{{$.path.to.value}}
```
Avec la sortie pour Récupérer les jetons d'accès étant :
```
{ "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }
```
rendant l'expression requise pour le champ Jeton d'accès {{$.tokens.strings_token}}.
Cliquez sur l'icône de lien pour le champ Projet et sélectionnez le déclencheur uploads:create.

Le lien devient vert et le champ peut être modifié.

La sortie du déclencheur uploads:create ressemble à :

{
  "branch": {
    "name": "my_branch"
  },
  "événement": "uploads:create",
  "message": "utilisateur-1 a initialisé le téléchargement du fichier file.yml dans le projet name_1672734591_11 au sein de la branche ma_branche\n",
  "projet": {
    "created_at": "2023-01-03 08:29:51 UTC",
    "id": "abcdabcdabcdabcd-11",
    "main_format": "yml",
    "name": "name_1672734591_10",
    "point_of_contact": null,
    "project_image_url": null,
    "slug": "name_1672734591_10",
    "updated_at": "2023-01-03 08:29:51 UTC"
  },
  "upload": {
    "created_at": "2023-01-03 08:29:48 UTC",
    "filename": "file.yml",
    "format": "yml",
    "id": "upload-1",
    "state": "initialized",
    "summary": {},
    "tag": null,
    "updated_at": "2023-01-03 08:29:48 UTC"
  },
  "user": {
    "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
    "id": "9c365b9a6f77c247c3de959f6152b231",
    "name": "Joe Sixpack",
    "username": "user-1"
  }
}

rendant l'expression requise pour le champ Projet {{$.project.id}}.

Cliquez sur Enregistrer.

La fenêtre Modifier les paramètres se ferme et les paramètres de l'action sont enregistrés.

Le paramètre linguistique par défaut du projet est requis pour créer une tâche en passant l'identifiant à l'action Créer une tâche. L'action Transformer JSON avec jq prend une entrée JSON, applique le filtre spécifié puis renvoie à nouveau du JSON.
1. Depuis l'onglet Actions dans la fenêtre Blocs de flux de travaux, recherchez phrase-jq.
  
  Faites glisser et déposez le bloc d'action Transformer JSON avec jq sous l'action liste des paramètres linguistiques pour les connecter.
2. Ouvrez la fenêtre Modifier les paramètres pour l'action Transformer JSON avec jq.
3. Sélectionnez JSON dans le champ déroulant Type d'entrée.
4. Cliquez sur l'icône de lien pour le champ Entrée et sélectionnez l'action liste des paramètres linguistiques.
  
  Le lien devient vert et le champ peut être modifié.
5. Le champ Entrée prend l'entrée JSON. Une expression fixe spéciale (@ au lieu de $) garantit que toute la sortie de l'action référencée est passée dans le champ.
  
  Entrez l'expression {{@.outputs.result}} dans le champ Entrée.
6. Cliquez sur l'icône de lien pour le champ Jq et sélectionnez l'action liste des paramètres linguistiques.
  
  Le lien devient vert et le champ peut être modifié.
7. Un filtre de la liste des paramètres linguistiques qui renvoie une nouvelle liste contenant tous les éléments où la propriété par défaut est true est requis.
  
  Il ne peut y avoir qu'un seul paramètre linguistique par défaut par projet et la liste a un élément identifiable et requis. Cet élément est directement accessible avec la syntaxe de tableau .[0].
  
  Entrez l'expression map(select(.default))|.[0] dans le champ Jq.
8. Cliquez sur Enregistrer.
  
  La fenêtre Modifier les paramètres se ferme et les paramètres de l'action sont enregistrés.
L'action Créer une tâche peut maintenant être configurée et utilisera des modèles des blocs précédents.
1. Cliquez sur l'icône de lien pour le champ Jeton d'accès et sélectionnez l'action Récupérer les jetons d'accès.
  
  Le lien devient vert et le champ peut être modifié.
  
  Entrez l'expression {{$.tokens.strings_token}}.
2. Cliquez sur l'icône de lien pour le champ Projet et sélectionnez le déclencheur uploads:create.
  
  Le lien devient vert et le champ peut être modifié.
  
  Entrez l'expression {{$.project.id}}.
3. Cliquez sur l'icône de lien pour le champ Paramètre linguistique source et sélectionnez l'action Transformer JSON avec jq.
  
  Le lien devient vert et le champ peut être modifié.
  
  Entrez l'expression {{@.outputs.result}}.
4. La date d'échéance peut être calculée avec des fonctions sprig ou Expr, mais pour les besoins de cet exemple, une date codée en dur comprise par l'API sera utilisée.
  
  Dans le champ Date d'échéance, entrez 2023-12-31T12:00:00Z.
5. Cliquez sur Enregistrer.
  
  La configuration est enregistrée et les détails peuvent être consultés dans l'onglet Configurer.
Chaque action peut avoir une ou plusieurs conditions combinées avec des logiques ET et OU. Ces conditions sont évaluées en temps d'exécution et l'action ainsi que ses enfants ne s'exécuteront que si la condition est évaluée à vrai.

Pour illustrer cela dans l'exemple, tout en ayant l'action Créer une tâche sélectionnée, cliquez sur Modifier les conditions dans l'onglet Conditions ou faites un clic droit sur le bloc et sélectionnez Modifier les conditions.

La fenêtre Modifier les conditionnelles s'ouvre.
1. En suivant les modèles des blocs précédents, liez le champ variable au déclencheur uploads:create et entrez l'expression {{$.upload.tag}}.
2. Sélectionnez NON dans la première liste déroulante pour inverser l'énoncé.
3. Sélectionnez EstNul dans la liste déroulante comparer.
4. Cliquez sur Enregistrer.
  
  La condition est présentée dans l'onglet Conditions.
Le flux de travaux s'arrêtera à ce point si le téléchargement ne contient pas de balise (ce qui signifie qu'il n'y avait pas de nouvelles clés/traductions mises à jour).
Les paramètres linguistiques cibles sont maintenant requis pour la tâche. Pour les besoins de l'exemple, deux paramètres linguistiques seront créés ; un pour l'espagnol (es-ES) et un pour l'allemand (de-DE). Les paramètres linguistiques seront ajoutés aux deux actions Transformer JSON avec jq dans la fenêtre Modifier les paramètres comme dans l'étape 3.
1. Dans le champ Entrée des deux actions, entrez l'expression {{@.outputs.result}}, liez à l'action Lister les paramètres linguistiques et enregistrez le paramètre.
2. Dans le champ Jg d'une action, entrez l'expression map(select(.name == "es-ES"))|.[0] et liez à l'action Lister les paramètres linguistiques.
  
  Enregistrez le paramètre.
3. Dans la deuxième action, entrez l'expression map(select(.name == "de-DE"))|.[0] et liez à l'action Lister les paramètres linguistiques.
  
  Enregistrez le paramètre.
Les paramètres linguistiques seront maintenant appliqués à la création de la tâche.

Configurez les deux actions Ajouter un paramètre linguistique à une tâche avec les mêmes modèles définis précédemment.
La tâche peut maintenant être démarrée.

Configurez l'action Démarrer une tâche avec les mêmes modèles que ceux définis précédemment.