Schleifenbildung

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

Schleifen können innerhalb eines Workflow implementiert werden, um eine Reihe von Aufgabe basierend auf definierten Bedingungen zu wiederholen.

Die Schleifenkonfiguration ist entweder über den Advanced Tab einer Blockkonfiguration oder durch Rechtsklick auf einen Block und auswählen von Edit loop zugänglich.

Schleifen-Einstellungen erfordern eine Liste von Dingen, mit denen gearbeitet werden soll:

Einfache, einzelne Werte, die dann in Aufgabe-Parametern wie {{ @item }} verwendbar sind.
Ein .JSON-Objekt, bei dem jedes Element im Objekt über seinen Key wie {{ @item.key }} adressiert werden kann.

Zugriff auf die aggregierten Ergebnisse einer Schleife

Der Output aller Iterationen kann als .JSON-Array abgerufen werden, sobald eine Schleife abgeschlossen ist. Der Output jeder Iteration muss eine gültige .JSON-Datei sein.

Es gibt vier Schleifentypen, die definiert werden können und im Feld loop_with ausgewählt werden:

withSequence
withItems
withComplexItems
withParam

withSequence

Die withSequence-Schleife ermöglicht eine Iteration über eine Zahlenfolge oder die Generierung eines Wertebereichs innerhalb eines Workflow.

Sie kann verwendet werden, um eine Reihe von Schritten eine bestimmte Anzahl von Malen zu wiederholen oder Operationen basierend auf einem Wertebereich durchzuführen.

Um eine Beispiel-withSequence-Schleife zu Erstellen, befolgen Sie diese Schritte:

Wählen Sie einen leer Block aus und öffnen Sie die Loop-Konfiguration.
Klicken Sie auf Edit loop.

Die Konfigurationsoptionen für loop_with werden angezeigt.
Wähle im Feld loop_with withSequence aus.
Gib die Anzahl der Schleifeniterationen in das Feld Count ein.
Gib optional einen Wert ein, mit dem die Schleife beginnen und/oder enden soll.
Klicke auf Save loop.
Klicke in der Konfiguration Parameters auf Edit parameters.

Konfigurationsoptionen werden angezeigt.
Gib im Feld Message {{ @item }} ein und klicke auf Save parameters.

Dieser Wert wird zur Laufzeit konvertiert.

Wenn beispielsweise die Anzahl auf 3 und der Startwert auf 2 gesetzt ist, lauten die Ergebnisse dieser Schleife:

loop Liste => [\"2\", \"3\", \"4\"]
{{ @item }} => 2 oder 3 oder 4, basierend auf der Iteration

withItems

Die withItems-Schleife ermöglicht die Iteration über eine Liste von Elementen.

Sie kann verwendet werden, wenn Vorgänge basierend auf einer Liste von Elementen ausgeführt werden müssen.

Befolge diese Schritte, um eine Beispiel-withItems-Schleife zu Erstellen:

Wählen Sie einen leer Block aus und öffnen Sie die Loop-Konfiguration.
Klicken Sie auf Edit loop.

Die Konfigurationsoptionen für loop_with werden angezeigt.
Wähle im Feld loop_with withItems aus.
Gib en in das Feld variable ein und klicke auf +Item (ein weiteres Feld variable wird Erstellen).
Gib de in das zweite Feld variable ein und Erstellen ein drittes Feld.
Gib fr in das dritte Feld variable ein und Erstellen ein viertes Feld.
Gib us in das vierte Feld variable ein.
Klicke auf Save loop.
Klicke in der Konfiguration Parameters auf Edit parameters.

Konfigurationsoptionen werden angezeigt.
Gib im Feld Message {{ @item }} ein und klicke auf Save parameters.

Dieser Wert wird zur Laufzeit konvertiert.

Die Ergebnisse dieser Schleife sind eine Iteration über eine Liste von Sprachcodes:

loop list => ["en", "de", "fr", "ua"]
{{ @item }} => en oder de .. ua

withComplexItems

Die withComplexItems-Schleife ermöglicht das Iterieren über eine Liste von Objekten.

Sie kann verwendet werden, wenn Operationen basierend auf einer Liste von komplexen Elementen durchgeführt werden müssen.

Um eine Beispiel-withComplexItems-Schleife zu erstellen, befolgen Sie diese Schritte:

Wählen Sie einen leer Block aus und öffnen Sie die Loop-Konfiguration.
Klicken Sie auf Edit loop.

Die Konfigurationsoptionen für loop_with werden angezeigt.
Wählen Sie im Feld loop_with withComplexItems aus.
Klicken Sie auf +Key:value, um einen zweiten Key hinzuzufügen.
Für Object 1 geben Sie Folgendes ein:
- Key: Value1
  - key (optional): name
  - (optional): Projekt 1
- Key: Value2
  - key (optional): id
  - (optional): 11
Klicken Sie auf +Object, um ein zweites Objekt hinzuzufügen, und auf +Key:value für einen zweiten Key.
Für Object 2 geben Sie Folgendes ein:
- Key: Value1
  - key (optional): name
  - (optional): Projekt 2
- Key: Value2
  - key (optional): id
  - (optional): 22
Einstellungen-Beispiel:
Klicke in der Konfiguration Parameters auf Edit parameters.

Konfigurationsoptionen werden angezeigt.
Gib im Feld Message {{ @item.name }} ein und klicke auf Save parameters. Dieser Wert wird zur Laufzeit konvertiert.

Die Ergebnisse dieser Schleife sind eine Iteration über eine Liste von Projekten:

loop list =>

[
  {
    "name": "Projekt 1",
    "id": 11
  },
  {
    "name": "Projekt 2",
    "id": 22
  }
]

{{ @item }} =>
```
{
  "name": "Projekt 1",
  "id": 11
}
```
{{ @item.name }} => Projekt 1
{{ @item.id }} => 11

withParam

Die withParam-Schleife ermöglicht die Iteration über eine dynamische Liste, die als Output von einer vorherigen Aufgabe oder einem Trigger ausgegeben wird.

Diese Schleife wird nur als Referenz im Parameterfeld verwendet.

Beispiel:

Outputs der Aufgabe (Strings: Publish a release):

{
  "created_at": "2015-01-28T09:52:53Z",
  "environments": ["development", "production"],
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "locales": [
    {
      "code": "en-GB",
      "id": "abcd1234cdef1234abcd1234cdef1234",
      "name": "Englisch"
    },
    {
      "id": "abcd5678cdef5678abcd5678cdef5678",
      "name": "German",
      "code": "de_DE"
    }
  ],
  "platforms": ["android"],
  "project": {
    "created_at": "2015-01-28T09:52:53Z",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "main_format": "xml",
    "name": "My Android Project",
    "updated_at": "2015-01-28T09:52:53Z"
  },
  "updated_at": "2015-01-28T09:52:53Z",
  "version": 1
}

Wenn die Schleifen-Einstellungen withParam mit {{ $.locales }} festgelegt sind, dann:

loop list =>

[
  {
    "code": "en-GB",
    "id": "abcd1234cdef1234abcd1234cdef1234",
    "name": "Englisch"
  },
  {
    "id": "abcd5678cdef5678abcd5678cdef5678",
    "name": "German",
    "code": "de_DE"
  }
]

Erste {{ @item }} =>

{
  "code": "en-GB",
  "id": "abcd1234cdef1234abcd1234cdef1234",
  "name": "Englisch"
}

{{ @item.code }} => en-GB
{{ @item.name }} => Englisch

Oder wenn {{ $.environments }} referenziert wird, dann:

Schleife Liste => ["development", "production"]
{{ @item }} => development oder production