Workflow konfigurieren

Das Fenster Edit parameters für die Aktion List locales öffnen.

Die Felder Access token und Project erfordern dynamische Werte, die zur Laufzeit aufgelöst werden.

1. Für das Feld Access token auf das Link-Symbol klicken und die Aktion Fetch access tokens auswählen.

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

2. Die Syntax für den Zugriff auf die Eigenschaften eines referenzierten Triggers oder einer Aktion lautet:

   {{$.path.to.value}}

   Die Ausgabe für Fetch access tokens lautet:

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

   Damit lautet der für das Feld Access token erforderliche Ausdruck {{$.tokens.strings_token}}.

3. Für das Feld Project auf das Link-Symbol klicken und den Trigger uploads:create auswählen.

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

4. Die Ausgabe des Triggers uploads:create sieht wie folgt aus:

   {
     "branch": {
       "name": "my_branch"
     },
     "event": "uploads:create",
     "message": "user-1 initialized file upload file.yml in project name_1672734591_11 within 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": "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"
     }
   }
   

   Damit lautet der für das Feld Project erforderliche Ausdruck {{$.project.id}}.

5. Klicke auf Importieren.

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

Um einen Job zu erstellen, muss die ID des Standard-Gebietsschemas des Projekts an die Aktion Create Job übergeben werden. Die Aktion Transform JSON with jq nimmt eine JSON-Eingabe entgegen, wendet den angegebenen Filter an und gibt dann wieder JSON aus.

1. Auf der Registerkarte Actions im Fenster Workflow blocks nach phrase-jq suchen.

   Den Aktionsblock Transform JSON with jq per Drag-and-drop unter der Aktion list locales platzieren, um die beiden zu verbinden.

2. Das Fenster Edit parameters für die Aktion Transform JSON with jq öffnen.

3. Im Dropdown-Feld Input Type die Option JSON auswählen.

4. Für das Feld Input auf das Link-Symbol klicken und die Aktion list locales auswählen.

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

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

   Den Ausdruck {{@.outputs.result}} in das Feld Input eingeben.

6. Für das Feld Jq auf das Link-Symbol klicken und die Aktion list locales auswählen.

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

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

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

   Den Ausdruck map(select(.default))|.[0] in das Feld Jq eingeben.

8. Klicke auf Importieren.

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

Die Aktion Create a job kann nun konfiguriert werden und wird Muster aus vorherigen Blöcken verwenden.

1. Für das Feld Access token auf das Link-Symbol klicken und die Aktion Fetch access tokens auswählen.

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

   Den Ausdruck {{$.tokens.strings_token}} eingeben.

2. Für das Feld Project auf das Link-Symbol klicken und den Trigger uploads:create auswählen.

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

   Den Ausdruck {{$.project.id}} eingeben.

3. Für das Feld Quellsprache auf das Link-Symbol klicken und die Aktion Transform JSON with jq auswählen.

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

   Den Ausdruck {{@.outputs.result}} eingeben.

4. Das Fälligkeitsdatum kann mit sprig- oder Expr-Funktionen berechnet werden. Für dieses Beispiel wird jedoch ein fest vorgegebenes Datum verwendet, das die API akzeptiert.

   Im Feld Fälligkeitsdatum 2023-12-31T12:00:00Z eingeben.

5. Klicke auf Importieren.

   Die Konfiguration wird gespeichert und Details können auf der Registerkarte Konfigurieren eingesehen werden.

Jede Aktion kann eine oder mehrere Bedingungen haben, die mit logischem UND und ODER kombiniert werden. Diese Bedingungen werden zur Laufzeit ausgewertet. Die Aktion und ihre untergeordneten Elemente werden nur ausgeführt, wenn das Ergebnis der Bedingungsprüfung wahr ist.

Um dies im Beispiel abzubilden, bei ausgewählter Aktion Job erstellen auf der Registerkarte Bedingungen auf Bedingungen bearbeiten klicken. Alternativ mit der rechten Maustaste auf den Block klicken und Bedingungen bearbeiten auswählen.

Das Fenster Bedingungen bearbeiten öffnet sich.

1. Wie bei den vorherigen Blöcken das Feld Variable mit dem Trigger uploads:create verknüpfen und den Ausdruck {{$.upload.tag}} eingeben.

2. Zum Umkehren der Aussage in der ersten Dropdown-Liste NICHT auswählen.

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

4. Klicke auf Importieren.

   Die Bedingung wird auf der Registerkarte Bedingungen angezeigt.

Der Workflow stoppt an diesem Punkt, wenn der Upload kein Tag enthält (was bedeutet, dass keine neuen/aktualisierten Schlüssel/Übersetzungen vorhanden waren).

Für den Job sind nun Zielgebietsschemas erforderlich. Für dieses Beispiel werden zwei Gebietsschemas erstellt: eines für Spanisch (es-ES) und eines für Deutsch (de-DE). Gebietsschemas werden den beiden Aktionen Transform JSON with jq im Fenster Parameter bearbeiten wie in Schritt 3 hinzugefügt.

1. Im Feld Eingabe beider Aktionen den Ausdruck {{@.outputs.result}} eingeben, das Feld mit der Aktion Gebietsschemas auflisten verknüpfen und den Parameter speichern.

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

   Den Parameter speichern.

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

   Den Parameter speichern.

Die Gebietsschemas werden nun bei der Erstellung des Jobs verwendet.

Die beiden Aktionen Zielgebietsschema zu einem Job hinzufügen nach den zuvor definierten Mustern konfigurieren.

Der Job kann nun gestartet werden.

Die Aktion Job starten nach den zuvor definierten Mustern konfigurieren.