Aktionsbündel

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

Aktionsbündel sind Gruppierungen bereits vorhandener Aktionen im Orchestrator, die bestimmte Business-Prozessschritte widerspiegeln. Sie sollen es Usern in nicht-technischen Rollen wie Lokalisierungsmanagern und Projektmanagern ermöglichen, Workflows zu erstellen, ohne ein tiefgreifendes Verständnis des Phrase API-Stacks zu erfordern.

Aktionsbündel sind wie eine Standardaktion konfiguriert, für deren Ausführung Parameter erforderlich sind.

Da sie mehrere Aktionen enthalten, verbrauchen Aktionsbündel mehr ausgeführte Workflow-Aktionen. Dies wird durch eine Ziffer in der oberen rechten Ecke der Aktion im Workflow Editor angezeigt.

Benutzer können vorhandene Aktionsbündel im Aktionen-Tab des Editors finden und verwenden, aber keine neuen erstellen (kontaktieren Sie das Support-Team, um ein neues Bündel anzufordern). Aktiviere bei der Suche nach Aktionen die Option Aktionsbündel priorisieren, um Aktionsbündel zuerst in der Liste anzuzeigen. Ein fettes blaues Symbol kennzeichnet den Unterschied zwischen einer regulären Aktion und einem Bündel.

Verwendung eines Aktionsbündels

Um ein Aktionsbündel zu verwenden, befolgen Sie diese Schritte:

Ziehen Sie ein ausgewähltes Aktionsbündel auf einen Workflow.

Das Aktionsbündel erscheint im Workflow.
Klicken Sie auf das Aktionsbündel und wählen Sie den Parameter-Tab aus.
Klicken Sie auf Parameter bearbeiten.

Erforderliche Parameter für das Aktionsbündel werden angezeigt.
Geben Sie die erforderlichen Parameter an und klicken Sie auf Parameter speichern.

Die Parameter werden im Aktionsbündel gespeichert und angezeigt.
Klicken Sie erneut auf Parameter bearbeiten, falls Änderungen erforderlich sind.

Verfügbare Bündel

Eine Übersetzung hinzufügen oder aktualisieren

Beschreibung:

Dieses Aktionsbündel entspricht dem Klicken in ein Übersetzungsfeld im Strings Editor und dem Eingeben einer Übersetzung in das Feld (wobei alles Vorhandene überschrieben wird).

Eingabeparameter:

Projekt-ID

Die Strings Projekt-ID, für die die Sprachen abgerufen werden sollen.
Sprache ID

Die Sprach-ID zur Identifizierung der hinzuzufügenden Sprachversion.
Key ID

Die Key ID zur Identifizierung des zu bearbeitenden Keys.
Übersetzte Zeichenfolge

Die der ausgewählten Übersetzung hinzuzufügende Zeichenfolge.

Output:

{
  "projectId": "f6dfee6466384379606b6158a410cd46",
  "translation": {
    "content": "Highlights of Phrase NextMT",
    "created_at": "2024-11-21T15:13:46Z",
    "excluded": false,
    "id": "91ad609cbd7d57e17cbf24432ba3d661",
    "key": {
      "data_type": "string",
      "id": "c7e7924dbb16527eaa0d892a8f0fd0fd",
      "name": "key3",
      "plural": false,
      "tags": [
        "35-2024",
        "upload-20240830_150155",
        "job-4C4F8EE9"
      ]
    },
    "locale": {
      "code": "en-CA",
      "id": "086fe5acddd58c52a5f8b5d9ec4c5a21",
      "name": "en-ca"
    },
    "placeholders": [],
    "plural_suffix": "",
    "state": "unverified",
    "unverified": true,
    "updated_at": "2024-11-21T15:18:09Z"
  }
}

Dienstleister zuweisen und benachrichtigen

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
E-Mail-Vorlage UID
list_of_job_uids
- Liste
Projektvorlage UID
Project UID

Ein Array, das manuell eingegebene oder vom Trigger referenzierte Projekt-ID(s) enthält.

Output:

{
  "jobs": [
    {
      "uid": "Zeichenfolge"
    }
  ],
  "emailTemplate": {
    "id": "ID"
  },
  "cc": [
    "Zeichenfolge"
  ],
  "bcc": [
    "Zeichenfolge"
  ]
}

Überprüfen, ob alle Zielsprachen eines Strings-Jobs abgeschlossen sind

Beschreibung:

Dieses Action-Bundle überprüft, ob alle Zielsprachen des Strings-Jobs abgeschlossen sind. Wenn ja, gibt es true zurück, wenn nicht, gibt es false zurück.

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
Projekt-ID

Zum Auflisten aller Job-Zielsprachen innerhalb eines bestimmten Projekts.
Job-ID

Zum Auflisten aller Job-Zielsprachen.

Output:

true 
ODER
false

Content aus Strings-Projekten in ein Online-Repository exportieren

Beschreibung:

Dieses Action-Bundle nimmt die Projekt-ID(s) entgegen und identifiziert basierend darauf und dem Output der Auflistung der Repository-Syncs die Repository-Sync-IDs, für die der Export anschließend in einer Schleife ausgelöst wird. Das Ergebnis des Action-Bundles ist die Liste der Repository-Syncs, für die der Export ausgelöst wurde.

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
Projekt-IDs

Ein Array, das manuell eingegebene oder vom Trigger referenzierte Projekt-ID(s) enthält.
Strings User-Konto-ID

Strings ORG-ID erforderlich für das Auflisten der Repository-Syncs.

Output:

[
  {
    "auto_import": false,
    "created_at": "2024-11-22T12:24:38Z",
    "id": "6315b3fd21d7735d0735f1d496b3832f",
    "status": "running",
    "type": "exportieren"
  },
  {
    "auto_import": false,
    "created_at": "2024-11-22T12:24:39Z",
    "id": "928298761a94a979e1eb6c01948b2041",
    "status": "running",
    "type": "exportieren"
  }
]

Job-UIDs für Zielsprachen abrufen

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
Dateiname
loop_variable
Liste
Project UID

Output:

[ 
{ "uid": "string" }
…
 ]

Job-UID-Liste abrufen

Eingabeparameter:

input_array
UID-Pfad

Output:

[
  { "uid": "string" },
  { "uid": "string" }
.
.
]

Sprachversionen eines Projekts abrufen

Beschreibung:

Dieses Aktionspaket verbirgt die Paging-Notwendigkeit für den Liste Sprachen API-Endpunkt. Es fügt außerdem die Projekt ID zum Payload hinzu, um ein robusteres Looping zu Aktivieren.

Eingabeparameter:

Projekt-ID

Die Strings Projekt-ID, für die die Sprachen abgerufen werden sollen.
Strings zugreifen Token

Output:

{
  "locales": [
    {
      "code": "en",
      "default": true,
      "id": "77e27f1d896629b0641063652572c038",
      "name": "en"
    },
    {
      "code": "fr",
      "default": false,
      "id": "2e8fb31c39957bb557bb96c0228960bf",
      \"name\": \"fr\"
    }
  ],
  "projectId": "f6dfee6466384379606b6158a410cd46"
}

Jobs für Zielsprachen identifizieren

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
Dateiname
Project UID
Zielsprachen

Output:

[
  { "uid": "string" },
  { "uid": "string" }
.
.
]

Übersetzungen nach Sprache auflisten

Beschreibung:

Dieses Aktionspaket verbirgt die Paging-Notwendigkeit für den Liste Übersetzungen nach Sprache API-Endpunkt. Es fügt außerdem die Projekt ID zum Payload hinzu, um ein robusteres Looping zu Aktivieren.

Eingabeparameter:

Projekt-ID

Die Strings Projekt ID, von der die Übersetzungen abgerufen werden sollen.
Sprache ID

Die Strings Sprache ID innerhalb des Projekts, von der die Übersetzungen abgerufen werden sollen.
q

Die Strings Query.
Sortierung
Strings zugreifen Token

Output:

{
  "projectId": "f6dfee6466384379606b6158a410cd46",
  "translations": [
    {
      \"content\": \"Dies ist eine neue Übersetzung - sechs\"," ,translation_15:
      "created_at": "2024-11-21T14:34:06Z",
      "excluded": false,
      "id": "0dbb663df544008df7e47176f8ec0444",
      "key": {
        "data_type": "string",
        "id": "15798c1dcc05e2d955d2de1959778347",
        "name": "key1",
        "plural": false,
        "tags": []         
      },
      "locale": {
        "code": "en-CA",
        "id": "086fe5acddd58c52a5f8b5d9ec4c5a21",
        "name": "en-ca"
      },
      "placeholders": [],
      "plural_suffix": "",
      "state": "unverified",
      "unverified": true,
      "updated_at": "2024-11-21T14:55:48Z"
    }
  ]
}

Segmente sperren

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
Job UID
Project UID
Segment IDs

Output:

{
  "jobs": [
    {
      "uid": "string",
      "status": "ACCEPTED",
      "providers": [
        {
          "type": "string",
          "id": "string",
          "uid": "Zeichenfolge"
        }
      ],
      "targetLang": "string",
      "workflowLevel": 0,
      "workflowStep": {
        "name": "string",
        "id": "string",
        "uid": "string",
        "order": 0,
        "lqaEnabled": true
      },
      "filename": "string",
      "dateDue": "2019-08-24T14:15:22Z",
      "dateCreated": "2019-08-24T14:15:22Z",
      "updateSourceDate": "2019-08-24T14:15:22Z",
      "imported": true,
      "jobAssignedEmailTemplate": {},
      "notificationIntervalInMinutes": 0,
      "continuous": true,
      "sourceFileUid": "string"
    }
  ],
  "project": {
    "name": "string",
    "uid": "Zeichenfolge"
  }
}

Job Workflow-Schritten zuordnen

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
Job UID
Project UID
Workflow-Ebenennummer

Output:

{
  "taskId": "string",
  "workflowLevel": "string",
  "resourcePath": "string",
  "project": {
    "uid": "Zeichenfolge"
  },
  "Job": {
    "uid": "Zeichenfolge"
  }
}

Segmente vorbereiten v3

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
Job UID
Project UID

Output:

[
  {
    "segmentId": "string",        // Value from ."@id"
    "origin": "Zeichenfolge",           // Wert von .\"@m:trans-origin\"
    "Kennzahl": number,              // Numerischer Wert von .\"@m:score\"
    "length": number,             // Länge der .Ausgangssprache Zeichenfolge
    "source": "string",           // Value of .source
    "target": "string"            // Value of .target
  },
  ...
]

QA für einen einzelnen Job ausführen v3

Eingabeparameter:

Zugriffstoken

Zur Authentifizierung.
Job UID
Project UID
Warnung Typen

Output:

{
  "projectUid": "project123",
  "jobUid": "job456",
  "segmentIds": ["string"],
  "warnings": [
    {
      "segmentId": "string",
      "warnings": [
        {
          "id": "string",
          "ignored": true,
          "type": "string",
          "repetitionGroupId": "string"
        }
      ],
      "ignoredChecks": ["string"]
    }
  ]
}

Listen subtrahieren

Eingabeparameter:

Ausschlussliste
Ausgangssprachenliste

Output:

[1, 3, 5]

Fehlerbehebung bei Aktionsbündeln

Problem

Ursache(n)

Die Lösung

Ein Aktionsbündel zeigt einen Status „Abgebrochen“ mit der Fehlermeldung „ActionBundle is cancelled because the last task did not execute“ an.

Eine der internen Aktionen innerhalb des Bündels konnte nicht erfolgreich abgeschlossen werden, was verhindert, dass der letzte Schritt des Bündels ausgeführt wird.

Überprüfen Sie die Status der einzelnen Aufgaben innerhalb des Bundles, um zu identifizieren, welche interne Aktion fehlgeschlagen ist, und beheben Sie dann den Fehler dieser Aktion, bevor Sie den Workflow erneut ausführen.

Das Klicken auf Retry executions auf der Seite Executions führt die gesamte Ausführung unverändert erneut aus und behebt diesen Fehler nicht von selbst, da die zugrunde liegende Aktion innerhalb des Bundles weiterhin fehlschlägt.