Configure a Workflow

Das Fenster Parameter bearbeiten für die Aktion Liste Locale öffnen.

Die Felder Zugriffstoken und Projekt benötigen dynamische Werte, die zur Laufzeit aufgelöst werden.

1. Klicke auf das Link-Symbol für das Zugriffstoken Feld und wähle die Zugriffstoken abrufen Aktion aus.

   Der Link wird grün und das Feld kann bearbeitet werden.

2. Die Syntax zum Zugriff auf die Eigenschaften eines referenzierten Triggers oder einer Aktion lautet:

   {{$.path.to.value}}

   Mit dem Output für Fetch access tokens ist:

   { "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }

   Dadurch wird der Ausdruck für das Feld Access token {{$.tokens.strings_token}} erforderlich.

3. Klicke auf das Link-Symbol für das Feld Projekt und wähle den Trigger uploads:create aus.

   Der Link wird grün und das Feld kann bearbeitet werden.

4. Der Output des uploads:create Triggers sieht folgendermaßen aus:

   {
     "branch": {
       "name": "my_branch"
     },
     "event": "uploads:create",
     "message": "user-1 hat den Datei-Upload file.yml im Projekt name_1672734591_11 innerhalb des Branch 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": "initialisiert",
       "zusammenfassung": {},
       "Tag": null,
       "updated_at": "2023-01-03 08:29:48 UTC"
     },
     "user": {
       "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
       "id": "9c365b9a6f77c247c3de959f6152b231",
       "name": "Joe Sixpack",
       "username": "user-1"
     }
   }
   

   Dadurch wird der Ausdruck für das Feld Projekt {{$.project.id}} erforderlich.

5. Klicke auf Speichern.

   Das Fenster Parameter bearbeiten schließt sich und die Parameter für die Aktion werden gespeichert.

Die Standard-Locale des Projekts ist erforderlich, um einen Job zu erstellen, indem die ID an die Job erstellen Aktion übergeben wird. Die Aktion Transform JSON with jq nimmt eine JSON-Eingabe, wendet den angegebenen Filter an und gibt dann wieder JSON als Output aus.

1. Im Actions Tab im Workflow-Blöcke Fenster nach phrase-jq suchen.

   Ziehe den Transform JSON with jq Aktionsblock unter den list Locale Aktionsblock, um sie zu verbinden.

2. Öffne das Fenster Parameter bearbeiten für die Aktion Transform JSON with jq.

3. Wähle JSON aus dem Eingabetyp-Dropdown-Feld aus.

4. Klicke auf das Link-Symbol für das Feld Input und wähle die Aktion list Locale aus.

   Der Link wird grün und das Feld kann bearbeitet werden.

5. Das Input-Feld nimmt die JSON-Eingabe entgegen. Ein spezieller fester Ausdruck (@ anstelle von $) stellt sicher, dass der gesamte Output der referenzierten Aktion in das Feld übergeben wird.

   Den Ausdruck {{@.outputs.result}} im Input-Feld eingeben.

6. Klicke auf das Link-Symbol für das Jq-Feld und wähle die Aktion list Locale aus.

   Der Link wird grün und das Feld kann bearbeitet werden.

7. Ein Filter der Liste der Sprachen, der eine neue Liste zurückgibt, die alle Elemente enthält, bei denen die default Eigenschaft true ist, ist erforderlich.

   Es kann nur eine Standard-Sprache pro Projekt geben und die Liste hat ein identifizierbares und erforderliches Element. Auf dieses Element wird direkt mit der .[0] Array-Syntax zugegriffen.

   Gib den Ausdruck map(select(.default))|.[0] im Jq-Feld ein.

8. Klicke auf Speichern.

   Das Fenster Parameter bearbeiten schließt sich und die Parameter für die Aktion werden gespeichert.

Die Job erstellen Aktion kann jetzt konfiguriert werden und verwendet Muster aus vorherigen Blöcken.

1. Klicke auf das Link-Symbol für das Feld Access token und wähle die Aktion Fetch access tokens aus.

   Der Link wird grün und das Feld kann bearbeitet werden.

   Gib den Ausdruck {{$.tokens.strings_token}} ein.

2. Klicke auf das Link-Symbol für das Feld Projekt und wähle den Trigger uploads:create aus.

   Der Link wird grün und das Feld kann bearbeitet werden.

   Gib den Ausdruck {{$.project.id}} ein.

3. Klicke auf das Link-Symbol für das Feld Ausgangssprache und wähle die Aktion Transform JSON with jq aus.

   Der Link wird grün und das Feld kann bearbeitet werden.

   Gib den Ausdruck {{@.outputs.result}} ein.

4. Das Fälligkeitsdatum kann mit Sprig- oder Expr-Funktionen berechnet werden, aber für dieses Beispiel wird ein fest codiertes Datum verwendet, das von der API verstanden wird.

   Im Feld Fälligkeitsdatum gib den Wert 2023-12-31T12:00:00Z ein.

5. Klicke auf Speichern.

   Die Konfiguration wird gespeichert und Details können im Konfigurieren-Tab angezeigt werden.

Jede Aktion kann eine oder mehrere Bedingungen haben, die mit logischen UND und ODER kombiniert sind. Diese Bedingungen werden zur Laufzeit ausgewertet und die Aktion sowie ihre untergeordneten Elemente werden nur ausgeführt, wenn die Bedingung als wahr ausgewertet wird.

Um dies im Beispiel widerzuspiegeln, während die Job erstellen-Aktion ausgewählt ist, klicke auf Bedingungen bearbeiten im Bedingungen-Tab oder klicke mit der rechten Maustaste auf den Block und wähle Bedingungen bearbeiten aus.

Das Fenster Bedingungen bearbeiten öffnet sich.

1. Den Mustern aus vorherigen Blöcken folgend, verknüpfe das Feld variable mit dem Trigger uploads:create und gib den Ausdruck {{$.upload.tag}} ein.

2. NOT aus der ersten Dropdown-Liste auswählen, um die Aussage umzukehren.

3. IsNull aus der vergleichen Dropdown-Liste auswählen.

4. Durch Betätigung von Speichern wird gespeichert.

   Die Bedingung wird im Conditions Tab angezeigt.

Der Workflow stoppt an dieser Stelle, wenn der Upload kein Tag enthält (was bedeutet, dass es keine neuen/aktualisierten Keys/Übersetzungen gab).

Ziel-Locales sind jetzt für den Job erforderlich. Für das Beispiel werden zwei Locales erstellt: eine für Spanisch (es-ES) und eine für Deutsch (de-DE). Locales werden zu den zwei Transform JSON with jq Aktionen im Bearbeiten parameters Fenster hinzugefügt, wie in Schritt 3.

1. Im Feld Input beider Aktionen den Ausdruck {{@.outputs.result}} eingeben, mit der Aktion Liste locales verknüpfen und den Parameter speichern.

2. Im Feld Jg einer Aktion den Ausdruck map(select(.name == "es-ES"))|.[0] eingeben und mit der Aktion Liste locales verknüpfen.

   Den Parameter speichern.

3. In der zweiten Aktion den Ausdruck map(select(.name == "de-DE"))|.[0] eingeben und mit der Aktion Liste locales verknüpfen.

   Den Parameter speichern.

Die Locales werden jetzt auf die Erstellung des Jobs angewendet.

Die beiden Zielsprache zu einem Job hinzufügen Aktionen werden mit den zuvor definierten Mustern konfiguriert.

Der Job kann jetzt gestartet werden.

Die Aktion Job starten wird mit denselben Mustern wie zuvor konfiguriert.