Configure a Workflow

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

Um mit dem beispielhaften Arbeitsablauf weiter fortzufahren, muss er konfiguriert werden.

Die Blockkonfiguration ist zugänglich, indem du entweder auf dem Tab Konfigurieren auf Parameter bearbeiten klickst oder mit der rechten Maustaste auf den Block klickst und Parameter bearbeiten auswählst, um das Fenster Parameter bearbeiten zu öffnen. Sobald ein Block Parameter aufweist, wechselt die Schaltfläche Parameter hinzufügen auf Parameter bearbeiten.

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

Öffne das Fenster Parameter bearbeiten für die Aktion Liste Gebietsschemata.

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

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

Der Link wird grün und das Feld kann bearbeitet werden.
Die Syntax für den Zugriff auf die Eigenschaften eines referenzierten Triggers oder einer Aktion ist:
```
{{$.path.to.value}}
```
wobei der Output für Abrufen von Zugriffstoken ist:
```
{ "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }
```
Erstellen des für das {{$.tokens.strings_token}} des Zugriffstokens erforderlichen Ausdrucks.
Klicke auf das Link-Symbol für das Feld Projekt und wähle die uploads:erstelle Trigger.

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

Der Output der uploads:erstellen Trigger ähnelt:

{
  "branch": {
    "name": "my_branch"
  },
  "Event": "uploads:erstellen",
  "Nachricht": "User-1 initialisierte Datei file.yml im Projekt name_1672734591_11 innerhalb Branch my_Branch\n hochladen",
  "Projekt": {
    "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"
  },
  "hochladen": {
    "created_at": "2023-01-03 08:29:48 UTC",
    "filename": "file.yml",
    "format": "yml",
    "ID": "hochladen",
    "Zustand": "initialisiert",
    "summary": {},
    "Tag": null,
    "updated_at": "2023-01-03 08:29:48 UTC"
  },
  "user": {
    "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
    "id": "9c365b9a6f77c247c3de959f6152b231",
    "Name": "Joe Sixpack",
    "User Name": "User-1"
  }
}

Erstellen des für das Feld Projekt erforderlichen Ausdrucks {{$.project.id}}.

Klicke auf Speichern.

Das Fenster Parameter bearbeiten 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 Job erstellen übergeben wird. Die Aktion JSON mit jq transformieren übernimmt einen JSON-Eingang, wendet den angegebenen filter an und gibt dann JSON erneut aus
1. Suche im Tab Aktionen im Fenster Arbeitsablauf nach Phrase-jq.
  
  Ziehe den Transform JSON with jq action block per Drag & Drop unter die Aktion Liste Locales, um sie zu verbinden.
2. Öffne das Fenster Parameter bearbeiten für die JSON mit jq Aktion transformieren.
3. Wähle JSON aus dem Dropdown-Feld Eingabetyp aus.
4. Klicke auf das Link-Symbol für das Eingabefeld und wähle die Aktion Liste Gebietsschemata aus.
  
  Der Link wird grün und das Feld kann bearbeitet werden.
5. Das Eingabefeld übernimmt die JSON-Eingabe. Ein spezieller fester Ausdruck (@ anstelle von $) stellt sicher, dass der gesamte Output der referenzierten Aktion in das Feld übernommen wird.
  
  Gib den Ausdruck {{@.outputs.result}} im Eingabefeld ein.
6. Klicke auf das Link-Symbol für das Jq-Feld und wähle die Aktion Liste Gebietsschemata aus.
  
  Der Link wird grün und das Feld kann bearbeitet werden.
7. Die Liste der Gebietsschemata, die eine neue Liste zurückgibt, die alle Elemente enthält, bei denen die Standardeigenschaft wahr ist, wird gefiltert.
  
  Es kann nur eine Sprache pro Projekt geben, und die Liste enthält 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 Aktion Job erstellen kann nun konfiguriert werden und verwendet Muster aus vorherigen Blöcken.
1. Klicke auf das Link-Symbol für das Feld Zugriffstoken und wähle die Aktion Zugriffstoken abrufen 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 die uploads:erstelle Trigger.
  
  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 JSON mit jq transformieren 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, jedoch wird für die Zwecke dieses Beispiels ein unter API verstandenes hartcodiertes Datum verwendet.
  
  Gib im Feld Fälligkeitsdatum 2023-12-31T12:00:00Z ein.
5. Klicke auf Speichern.
  
  Die Konfiguration wird gespeichert und Details können im Tab Konfigurieren angezeigt werden.
Jede Aktion kann eine oder mehrere Bedingungen mit logischem UND und ODER kombinieren. Diese Bedingungen werden während der Laufzeit ausgewertet und die Aktion und ihre untergeordneten Elemente werden nur ausgeführt, wenn die Bedingung als wahr bewertet wird.

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

Das Fenster Bedingungen bearbeiten öffnet sich.
1. Verknüpfe das Variablenfeld nach Mustern aus vorherigen Blöcken mit den uploads:erstelle Trigger und gib den Ausdruck {{$.upload.tag}} ein.
2. NICHT aus der ersten Dropdown-Liste auswählen, um die Anweisung zu invertieren.
3. IsNull aus der Dropdown Liste vergleichen auswählen.
4. Klicke auf Speichern.
  
  Die Bedingung wird auf dem Tab Bedingungen angezeigt.
Der Arbeitsablauf stoppt an diesem Punkt, wenn kein Tag hochgeladen wird (das heißt, es gab keine neuen/aktualisierten Keys/Übersetzungen).
Für den Job sind jetzt Zielsprachen erforderlich. Für die Zwecke des Beispiels werden zwei Gebietsschemata erstellt: eines für Spanisch (es-ES) und eines für Deutsch (de-DE). Zu den beiden Transform JSON mit jq Aktionen werden im Fenster Parameter bearbeiten wie in Schritt 3 Gebietsschemata hinzugefügt.
1. Geben Sie im Eingabefeld beider Aktionen den Ausdruck {{@.outputs.result}} ein, verlinken Sie auf die Aktion Liste Gebietsschemata und speichern Sie den Parameter.
2. Gib im Jg-Feld einer Aktion den Ausdruck map(select(.name == "es-ES"))|.[0] ein und verknüpfe ihn mit der Aktion Liste Locales.
  
  Parameter speichern.
3. Gib in der zweiten Aktion den Ausdruck map(select(.name == "de-DE"))|.[0] ein und verknüpfe ihn mit der Aktion Liste Locales.
  
  Parameter speichern.
Die Gebietsschemata werden jetzt bei der Job Erstellung angewendet.

Konfigurieren Sie die beiden Aktionen, die dieselben Muster wie zuvor definiert haben, zu einem Job eine Zielsprache hinzufügen.
Der Job kann jetzt gestartet werden.

Konfiguriere die Aktion Job starten mit denselben Mustern wie zuvor definiert.