Workflow konfigurieren

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Um mit dem Beispiel-Workflow fortzufahren, muss dieser konfiguriert werden.

Die Blockkonfiguration kann aufgerufen werden, indem Sie entweder auf Edit parameters auf dem Configure Tab klicken oder mit der rechten Maustaste auf den Block klicken und Edit parameters auswählen, um das Edit parameters Fenster zu öffnen. Sobald ein Block Parameter hat, wechselt die Add parameters Schaltfläche zu Edit parameters.

Um die Blöcke für das Beispiel zu konfigurieren, folgen Sie diesen Schritten:

Öffnen Sie das Edit parameters Fenster für die List locales Aktion.

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

Klicken Sie auf das Link-Symbol für das Access token Feld und wählen Sie die Fetch access tokens Aktion aus.

Der Link wird grün und das Feld kann bearbeitet werden.
Die Syntax für das zugreifen auf die Eigenschaften eines referenzierten Triggers oder einer Aktion lautet:
```
{{$.path.to.value}}
```
Wobei der Output für Fetch access tokens wie folgt lautet:
```
{ "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }
```
wodurch der für das Access token Feld erforderliche Ausdruck {{$.tokens.strings_token}} lautet.
Klicken Sie auf das Link-Symbol für das Project Feld und wählen Sie den uploads:create Trigger aus.

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

Der Output des uploads:create Triggers ähnelt:

{
  "branch": {
    "name": "my_branch"
  },
  "event": "uploads:create",
  "message": "user-1 hat das hochladen der Datei file.yml im Projekt name_1672734591_11 innerhalb des Branch my_branch initialisiert\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"
  }
}

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

Klicke auf Importieren.

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

Die Standard-Sprache des Projekts ist erforderlich, um einen Job zu Erstellen, indem die ID an die Create Job-Aktion übergeben wird. Die Transform JSON with jq-Aktion nimmt einen JSON-Output entgegen, wendet den angegebenen Filter an und gibt dann wieder JSON aus
1. Suchen Sie auf dem Actions-Tab im Workflow blocks-Fenster nach phrase-jq.
  
  Ziehen Sie den Transform JSON with jq-Aktionsblock unter die list locales-Aktion, um sie zu verbinden.
2. Öffnen Sie das Edit parameters-Fenster für die Transform JSON with jq-Aktion.
3. Wählen Sie JSON aus dem Input Type-Dropdown-Feld aus.
4. Klicken Sie auf das Link-Symbol für das Input-Feld und wählen Sie die list locales-Aktion aus.
  
  Der Link wird grün und das Feld kann bearbeitet werden.
5. Das Input-Feld nimmt den JSON-Output entgegen. Ein spezieller fester Ausdruck (@ anstelle von $) stellt sicher, dass der gesamte Output der referenzierten Aktion an das Feld übergeben wird.
  
  Geben Sie den Ausdruck {{@.outputs.result}} in das Input-Feld ein.
6. Klicken Sie auf das Link-Symbol für das Jq-Feld und wählen Sie die list locales-Aktion aus.
  
  Der Link wird grün und das Feld kann bearbeitet werden.
7. Ein Filter der Liste der Sprache, 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. Dieses Element wird direkt mit der .[0] Array-Syntax aufgerufen.
  
  Geben Sie den Ausdruck map(select(.default))|.[0] in das Jq-Feld ein.
8. Klicke auf Importieren.
  
  Das Edit parameters-Fenster schließt sich und die Parameter für die Aktion werden gespeichert
Die Job erstellen-Aktion kann nun konfiguriert werden und verwendet Muster aus vorherigen Blöcken.
1. Klicken Sie auf das Link-Symbol für das Access token Feld und wählen Sie die Fetch access tokens Aktion aus.
  
  Der Link wird grün und das Feld kann bearbeitet werden.
  
  Geben Sie den Ausdruck {{$.tokens.strings_token}} ein.
2. Klicken Sie auf das Link-Symbol für das Project Feld und wählen Sie den uploads:create Trigger aus.
  
  Der Link wird grün und das Feld kann bearbeitet werden.
  
  Geben Sie den Ausdruck {{$.project.id}} ein.
3. Klicken Sie auf das Link-Symbol für das Feld Ausgangssprache und wählen Sie die Aktion JSON mit jq transformieren aus.
  
  Der Link wird grün und das Feld kann bearbeitet werden.
  
  Geben Sie den Ausdruck {{@.outputs.result}} ein.
4. Das Fälligkeitsdatum kann mit Sprig- oder Expr-Funktionen berechnet werden, aber für die Zwecke dieses Beispiels wird ein hartcodiertes Datum verwendet, das von der API verstanden wird.
  
  Geben Sie im Feld Fälligkeitsdatum 2023-12-31T12:00:00Z ein.
5. Klicke auf Importieren.
  
  Die Konfiguration wird gespeichert und Details können im Konfigurieren-Tab eingesehen werden.
Jede Aktion kann eine oder mehrere Bedingungen haben, die mit logischem AND und OR kombiniert werden. 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 abzubilden, klicken Sie bei ausgewählter Job erstellen-Aktion auf Bedingungen bearbeiten im Bedingungen-Tab oder klicken Sie mit der rechten Maustaste auf den Block und wählen Sie Bedingungen bearbeiten aus.

Das Fenster Bedingungen bearbeiten öffnet sich.
1. Verknüpfen Sie dem Muster vorheriger Blöcke folgend das Variable-Feld mit dem uploads:create-Trigger und geben Sie den Ausdruck {{$.upload.tag}} ein.
2. Wählen Sie NOT aus der ersten Dropdown-Liste aus, um die Aussage umzukehren.
3. Wählen Sie IsNull aus der Vergleichen-Dropdown-Liste aus.
4. Klicke auf Importieren.
  
  Die Bedingung wird im Bedingungen-Tab 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).
Zielsprachen sind jetzt für den Job erforderlich. Für die Zwecke des Beispiels werden zwei Sprachen erstellt; eine für Spanisch (es-ES) und eine für Deutsch (de-DE). Sprachen werden in den zwei JSON mit jq transformieren-Aktionen im Fenster Parameter bearbeiten wie in Schritt 3 hinzugefügt.
1. Geben Sie im Feld Input beider Aktionen den Ausdruck {{@.outputs.result}} ein, verknüpfen Sie ihn mit der Aktion Liste Sprachen und Speichern Sie den Parameter.
2. Geben Sie im Feld Jg einer Aktion den Ausdruck map(Auswählen(.name == \"es-ES\"))|.[0] ein und verknüpfen Sie ihn mit der Aktion Liste Sprachen.
  
  Speichern Sie den Parameter.
3. Geben Sie in der zweiten Aktion den Ausdruck map(Auswählen(.name == \"de-DE\"))|.[0] ein und verknüpfen Sie ihn mit der Aktion Liste Sprachen.
  
  Speichern Sie den Parameter.
Die Sprachen werden nun auf die Job-Erstellung angewendet.

Konfigurieren Sie die beiden Aktionen Zielsprache zu einem Job hinzufügen mit denselben Mustern, die zuvor definiert wurden.
Der Job kann nun gestartet werden.

Konfigurieren Sie die Aktion Job starten mit denselben Mustern wie zuvor definiert.