Workflow konfigurieren

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

Um mit dem Beispiel-Workflow weiter zu machen, muss er konfiguriert werden.

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

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

Öffnen Sie das Bearbeiten 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 Feld Project {{$.project.id}} erforderlich wird.

Klicke auf Importieren.

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

Die Standardsprache des Projekts ist erforderlich, um einen Job zu erstellen, indem die ID an die Aktion Create Job übergeben wird. Die Aktion Transform JSON with jq nimmt einen JSON-Output entgegen, wendet den angegebenen Filter an und gibt dann wieder JSON aus
1. Suchen Sie auf dem Tab Actions im Fenster Workflow blocks nach phrase-jq.
  
  Ziehen Sie den Aktionsblock Transform JSON with jq unter die Aktion list locales, um sie zu verbinden.
2. Öffnen Sie das Fenster Edit parameters für die Aktion Transform JSON with jq.
3. Wählen Sie JSON aus dem Dropdown-Feld Input Type aus.
4. Klicken Sie auf das Link-Symbol für das Feld Input und wählen Sie die Aktion list locales aus.
  
  Der Link wird grün und das Feld kann bearbeitet werden.
5. Das Feld Input 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 Feld Input ein.
6. Klicken Sie auf das Link-Symbol für das Feld Jq und wählen Sie die Aktion list locales 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 Eigenschaft default true ist, ist erforderlich.
  
  Es kann nur eine Standardsprache pro Projekt geben und die Liste enthält 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 Fenster Edit parameters schließt sich und die Parameter für die Aktion werden gespeichert
Die Aktion Job erstellen 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 UND und ODER 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, wählen Sie die Aktion Job erstellen aus, klicken Sie im Bedingungen-Tab auf Bedingungen bearbeiten oder klicken Sie mit der rechten Maustaste auf den Block und wählen Sie Bedingungen bearbeiten aus.

Das Fenster Bedingungen bearbeiten öffnet sich.
1. Folgen Sie den Mustern aus den vorherigen Blöcken, verknüpfen Sie das Variable-Feld mit dem uploads:create-Trigger und geben Sie den Ausdruck {{$.upload.tag}} ein.
2. Wählen Sie NICHT 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 es keine neuen/aktualisierten Schlüssel/Übersetzungen gab).
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.