Orchestrator

Konfigurieren Sie einen Workflow

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

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

Die Blockkonfiguration kann entweder durch Klicken auf Parameter bearbeiten im Konfigurieren Tab oder durch Rechtsklicken auf den Block und Auswählen von Parameter bearbeiten geöffnet werden, um das Parameter bearbeiten Fenster zu öffnen. Sobald ein Block Parameter hat, wechselt die Parameter hinzufügen Schaltfläche zu Parameter bearbeiten.

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

  1. Öffnen Sie das Parameter bearbeiten Fenster für die language-blue.svgListe der Lokalisierungen Aktion.

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

    1. Klicken Sie auf das Link-Symbol Linking Icon für das Zugriffstoken Feld und wählen Sie die circle-blue.svgZugriffstoken abrufen Aktion aus.

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

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

      {{$.path.to.value}}

      Mit der Ausgabe für circle-blue.svgZugriffstoken abrufen ist:

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

      die Ausdruck erforderlich für das Zugriffstoken Feld {{$.tokens.strings_token}}.

    3. Klicken Sie auf das Link-Symbol Linking Icon für das Projekt Feld und wählen Sie den history-orange.svguploads:create Trigger aus.

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

    4. Die Ausgabe des history-orange.svguploads:create Triggers ähnelt:

      {
        "branch": {
          "name": "my_branch"
        },
        "event": "uploads:create",
        "message": "user-1 hat den Datei-Upload file.yml im Projekt name_1672734591_11 innerhalb des Branches my_branch\n"
        "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"
        },
        "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"
        }
      }
      

      die für das Projekt Feld erforderliche Ausdruck {{$.project.id}} erstellen.

    5. Klicke auf Speichern.

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

  3. Die Standard-Sprache des Projekts ist erforderlich, um einen Job zu erstellen, indem die ID an die work-blue.svgJob erstellen Aktion übergeben wird. Die circle-blue.svgJSON mit jq transformieren Aktion nimmt eine JSON-Eingabe, wendet den angegebenen Filter an und gibt dann wieder JSON aus.

    1. Vom Aktionen Tab im Workflow-Blöcke Fenster, suche nach phrase-jq.

      Ziehe den circle-blue.svgJSON mit jq transformieren Aktionsblock unter die language-blue.svgSprache auflisten Aktion, um sie zu verbinden.

    2. Öffne das Bearbeiten der Parameter Fenster für die JSON mit jq transformieren Aktion.

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

    4. Klicke auf das Link-Symbol Linking Icon für das Eingabe Feld und wähle die language-blue.svgSprache auflisten Aktion aus.

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

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

      Gib den Ausdruck {{@.outputs.result}} im Eingabe Feld ein.

    6. Klicken Sie auf das Linksymbol Linking Icon für das Jq Feld und wählen Sie die language-blue.svgListe der Sprachen Aktion 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. Dieses Element wird direkt mit der .[0] Array-Syntax zugegriffen.

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

    8. Klicke auf Speichern.

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

  4. Die work-blue.svgErstellen Sie einen Job Aktion kann jetzt konfiguriert werden und verwendet Muster aus vorherigen Blöcken.

    1. Klicken Sie auf das Link-Symbol Linking Icon für das Zugriffstoken Feld und wählen Sie die circle-blue.svgZugriffstoken abrufen 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 Linking Icon für das Projekt Feld und wählen Sie den language-orange.svguploads: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 Linksymbol Linking Icon für das Ausgangssprache Feld und wählen Sie die Transformiere JSON mit jq Aktion 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 fest codiertes Datum verwendet, das von der API verstanden wird.

      Geben Sie im Fälligkeitsdatum Feld 2023-12-31T12:00:00Z ein.

    5. Klicke auf Speichern.

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

  5. 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 Kinder werden nur ausgeführt, wenn die Bedingung als wahr ausgewertet wird.

    Um dies im Beispiel widerzuspiegeln, während die work-blue.svgErstellen Sie einen Job Aktion ausgewählt ist, klicken Sie auf Bedingungen bearbeiten im Bedingungen Tab oder klicken Sie mit der rechten Maustaste auf den Block und wählen Sie Bedingungen bearbeiten aus.

    Das Bedingungen bearbeiten Fenster öffnet sich.

    1. Folgen Sie den Mustern aus vorherigen Blöcken, verknüpfen Sie das Variable Feld mit dem language-orange.svgUploads:Erstellen 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 IstNull aus der Vergleichen Dropdown-Liste aus.

    4. Klicke auf Speichern.

      Die Bedingung wird im Bedingungen Tab angezeigt.

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

  6. Ziel-Lokalisierungen sind jetzt für den Job erforderlich. Für die Zwecke des Beispiels werden zwei Lokalisierungen erstellt; eine für Spanisch (es-ES) und eine für Deutsch (de-DE). Lokalisierungen werden zu den beiden circle-blue.svgJSON mit jq transformieren Aktionen im Parameter bearbeiten Fenster wie in Schritt 3 hinzugefügt.

    1. Geben Sie im Eingabefeld beider Aktionen den Ausdruck {{@.outputs.result}} ein, verlinken Sie zur language-blue.svgListe der Lokalisierungen Aktion und speichern Sie den Parameter.

    2. Geben Sie im Jg Feld einer Aktion den Ausdruck map(select(.name == "es-ES"))|.[0] ein und verlinken Sie zur language-blue.svgListe der Lokalisierungen Aktion.

      Speichern Sie den Parameter.

    3. Geben Sie in der zweiten Aktion den Ausdruck map(select(.name == "de-DE"))|.[0] ein und verlinken Sie zur language-blue.svgListe der Lokalisierungen Aktion.

      Speichern Sie den Parameter.

  7. Die Lokalisierungen werden jetzt auf die Erstellung des Jobs angewendet.

    Konfigurieren Sie die beiden work-blue.svgFügen Sie eine Ziel-Lokalisierung zu einem Job hinzu Aktionen mit denselben zuvor definierten Mustern.

  8. Der Job kann jetzt gestartet werden.

    Konfigurieren Sie die work-blue.svgStarten Sie einen Job Aktion mit denselben Mustern wie zuvor definiert.

War dieser Beitrag hilfreich?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.