Configurer un flux de travaux

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

Pour Continuer avec le flux de travaux exemple, il devra être configuré.

La configuration du bloc peut être accédée soit en cliquant sur Modifier les paramètres dans l'onglet Configurer, soit 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 possède 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 paramètres régionaux.

Les champs Jeton d'accès et Projet nécessiteront des valeurs dynamiques qui sont résolues au moment de 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"
  },
  \"event\": \"uploads:create\","
  \"message\": \"user-1 a initialisé le chargement du fichier file.yml dans le projet name_1672734591_11 au sein de la branche my_branch\\n\","
  "project": {
    "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": {},
    "balise": null,
    "updated_at": "2023-01-03 08:29:48 UTC"
  },
  "user": {
    "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
    "id": "9c365b9a6f77c247c3de959f6152b231",
    "name": "Joe Sixpack",
    "username": "user-1"
  }
}

rendre l'expression obligatoire pour le champ projet {{$.project.id}}.

Cliquez sur Enregistrer.

La fenêtre Edit parameters 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 transmettant l'Identifiant à l'action Créer tâche. L'action Transform JSON with jq prend une entrée JSON, applique le filtre spécifié, puis génère à nouveau du JSON
1. Depuis l'onglet Actions de la fenêtre Workflow blocks, recherchez phrase-jq.
  
  Faites glisser et déposez le bloc d'action Transform JSON with jq sous l'action list locales pour les connecter.
2. Ouvrez la fenêtre modifier les paramètres pour l'action Transform JSON with jq.
3. Sélectionner JSON dans le champ déroulant Input Type.
4. Cliquez sur l'icône de lien pour le champ Input et Sélectionner l'action liste les paramètres linguistiques.
  
  Le lien devient vert et le champ peut être modifié.
5. Le champ Input prend la sortie JSON. Une expression fixe spéciale (@ au lieu de $) garantit que la totalité de la sortie de l'action référencée est transmise dans le champ.
  
  Entrez l'expression {{@.outputs.result}} dans le champ Input.
6. Cliquez sur l'icône de lien pour le champ Jq et Sélectionner l'action liste les 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é default est true est requis.
  
  Il ne peut y avoir qu'un seul paramètre linguistique par défaut par projet et la liste contient un élément identifiable et requis. Cet élément est directement accédé avec la syntaxe de tableau .[0].
  
  Entrez l'expression map(select(.default))|.[0] dans le champ Jq.
8. Cliquez sur Enregistrer.
  
  La fenêtre Edit parameters 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 les 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électionner l'action Transform JSON with 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 Configure.
Chaque action peut avoir une ou plusieurs conditions combinées avec des ET et OU logiques. Ces conditions sont évaluées lors de l'exécution et l'action ainsi que ses enfants ne s'exécuteront que si la condition est évaluée comme vraie.

Pour refléter cela dans l'exemple, tout en ayant l'action créer une tâche Sélectionner, cliquez sur modifier les conditions depuis l'onglet Conditions ou faites un clic droit sur le bloc et Sélectionner modifier les conditions.

La fenêtre modifier les conditions s'ouvre.
1. En suivant les modèles des blocs précédents, liez le champ variable au déclencheur uploads:Créer et saisissez l'expression {{$.upload.tag}}.
2. Sélectionner NOT dans la première liste déroulante pour inverser l'instruction.
3. Sélectionner IsNull dans la liste déroulante Comparer.
4. Cliquez sur Enregistrer.
  
  La condition est présentée sur l'onglet Conditions.
Le flux de travaux s'arrêtera à ce point si le chargement ne contient pas de balise (ce qui signifie qu'il n'y avait aucune clé/traduction nouvelle/mise à jour).
Des paramètres linguistiques cible sont désormais requis pour la tâche. Aux fins 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 Transform JSON with jq dans la fenêtre modifier les paramètres comme à l'étape 3.
1. Dans le champ Input des deux actions, saisissez l'expression {{@.outputs.result}}, liez à l'action liste des paramètres linguistiques et enregistrer le paramètre.
2. Dans le champ Jg d'une action, saisissez l'expression map(Sélectionner(.name == \"es-ES\"))|.[0] et liez à l'action liste des paramètres linguistiques.
  
  Enregistrer le paramètre.
3. Dans la seconde action, saisissez l'expression map(Sélectionner(.name == \"de-DE\"))|.[0] et liez à l'action liste des paramètres linguistiques.
  
  Enregistrer le paramètre.
Les paramètres linguistiques seront désormais appliqués à la création de tâche.

Configurez les deux actions ajouter un paramètre linguistique cible à 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.