Orchestrator

Action Bundles

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

Action bundlesは、Orchestrator内の既存のアクションを特定のビジネスプロセスのステップごとにまとめたグループです。ローカリゼーションマネージャやプロジェクトマネージャなどのエンジニアではないユーザーが、Phrase APIについての深い理解がなくてもワークフローの作成ができるように設計されています。

アクションバンドルは標準のアクションと同様に設定され、実行にはパラメータが必要です。

複数のアクションが含まれているため、アクションバンドルはより多くの実行されたワークフローアクションを消費します。これは、ワークフローエディタのアクションの右上隅に数値で示されます。

ユーザーはエディタのアクションタブで既存のアクションバンドルを見つけて使用できますが、新しいバンドルを作成することはできません(新しいバンドルをリクエストする場合はサポートTeamに連絡してください)。アクションを検索するときは、「Prioritize Action Bundles」オプションを有効にすると、アクションバンドルが一覧の最初に表示されます。太字の青いアイコンは、通常のアクションとバンドルの違いを示します。

アクションバンドルの使用

アクションバンドルを使用するには、次の手順に従います:

  1. 選択したアクションバンドルをワークフローにドラッグします。

    アクションバンドルがワークフローに表示されます。

  2. アクションバンドルをクリックし、パラメータタブを選択します。

  3. パラメータを編集をクリックします。

    アクションバンドルに必要なパラメータが表示されます。

  4. 必要なパラメータを提供し、パラメータを保存をクリックします。

    パラメータはアクションバンドルに保存され、表示されます。

  5. 変更が必要な場合は、再度パラメータを編集をクリックします。

利用可能なバンドル

翻訳を追加または更新する

説明:

このアクションバンドルは、Stringsエディタの翻訳フィールドをクリックして、フィールドに翻訳を入力することと同等です(既存の内容を上書きします)。

入力パラメータ:

  • Project ID

    ロケールを取得するためのStringsプロジェクトのID。

  • ロケールID

    言語バージョンを追加するためのロケールID。

  • キーID

    編集するキーを識別するためのID。

  • 翻訳された文字列

    選択した翻訳に追加する文字列。

出力:

{
  "projectId": "f6dfee6466384379606b6158a410cd46",
  "translation": {
    "content":"Phrase NextMTのハイライト",
    "created_at":"2024-11-21T15:13:46Z",
    "excluded": false,
    "id":"91ad609cbd7d57e17cbf24432ba3d661",
    "key": {
      "data_type": "文字列",
      "id": "c7e7924dbb16527eaa0d892a8f0fd0fd",
      "name": "key3",
      "plural": false,
      "タグ": [
        "35-2024",
        "アップロード-20240830_150155",
        "ジョブ-4C4F8EE9"
      ]
    },
    "ロケール": {
      "code": "en-CA",
      "id":"086fe5acddd58c52a5f8b5d9ec4c5a21",
      "name": "en-ca"
    },
    "placeholders": [],
    "plural_suffix": "",
    "state": "unverified",
    "unverified": true,
    "updated_at":"2024-11-21T15:18:09Z"
  }
}

プロバイダに割り当てて通知する

入力パラメータ:

  • アクセストークン

    認証のため。

  • メールテンプレートUID

  • ジョブのUID一覧

    • 一覧

  • プロジェクトテンプレートUID

  • プロジェクトUID

    手動で入力されたプロジェクトIDまたはトリガーから参照されたプロジェクトIDを含む配列。

出力:

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

すべてのStringsジョブのターゲットロケールが完了しているか確認します。

説明:

このアクションバンドルは、すべてのStringsジョブのターゲットロケールが完了しているかどうかを確認します。そうであれば、trueを返し、そうでなければfalseを返します。

入力パラメータ:

  • アクセストークン

    認証のため。

  • プロジェクトID

    特定のプロジェクト内からすべてのジョブターゲットロケールをリストするため。

  • ジョブID

    すべてのジョブターゲットロケールをリストするため。

出力:

true 
または
false

Stringsプロジェクトからオンラインリポジトリへコンテンツをエクスポートする。

説明:

このアクションバンドルは、プロジェクトIDを受け取り、それとリポジトリ同期の一覧出力に基づいて、エクスポートがループ内でトリガーされるリポジトリ同期IDを特定します。アクションバンドルの結果は、エクスポートがトリガーされたリポジトリ同期のリストです。

入力パラメータ:

  • アクセストークン

    認証のため。

  • プロジェクトIDs

    手動で入力されたプロジェクトIDまたはトリガーから参照されたプロジェクトIDを含む配列。

  • StringsアカウントID

    リポジトリ同期を一覧するために必要なStrings ORG ID。

出力:

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

ターゲット言語用のジョブUIDを取得します。

入力パラメータ:

  • アクセストークン

    認証のため。

  • ファイル名

  • loop_variable

  • 一覧

  • プロジェクトUID

出力:

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

ジョブUID一覧を取得します。

入力パラメータ:

  • input_array

  • UIDパス

出力:

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

プロジェクトのロケールを取得する

説明:

このアクションバンドルは、List Locales APIエンドポイントのページングの必要性を隠すまた、より堅牢なループを有効にするために、ペイロードにプロジェクトIDを追加する

入力パラメータ:

  • プロジェクトID

    ロケールを取得するためのStringsプロジェクトID。

  • Strings アクセストークン

出力:

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

ターゲットロケールのジョブを特定する

入力パラメータ:

  • アクセストークン

    認証のため。

  • ファイル名

  • プロジェクトUID

  • ターゲットロケール

出力:

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

ロケール別の翻訳を一覧表示する

説明:

このアクションバンドルは、ロケール別の翻訳を一覧表示するAPIエンドポイントのページングの必要性を隠すまた、より堅牢なループを有効にするために、ペイロードにプロジェクトIDを追加する

入力パラメータ:

  • プロジェクトID

    翻訳を取得するためのStringsプロジェクトID。

  • ロケールID

    翻訳を取得するためのプロジェクト内のStringsロケールID。

  • q

    Stringsクエリ

  • 並べ替え

  • Stringsアクセストークン

出力:

{
  "projectId": "f6dfee6466384379606b6158a410cd46",
  "translations": [
    {
      "content":"これは新しい翻訳 - 六",
      "created_at":"2024-11-21T14:34:06Z",
      "excluded": false,
      "id":"0dbb663df544008df7e47176f8ec0444",
      "key": {
        "data_type": "string",
        "id":"15798c1dcc05e2d955d2de1959778347",
        "name": "key1",
        "plural": false,
        "tags": []         
      },
      "ロケール": {
        "code": "en-CA",
        "id":"086fe5acddd58c52a5f8b5d9ec4c5a21",
        "name": "en-ca"
      },
      "placeholders": [],
      "plural_suffix": "",
      "state": "unverified",
      "unverified": true,
      "updated_at":"2024-11-21T14:55:48Z"
    }
  ]
}

セグメントをロックする

入力パラメータ:

  • アクセストークン

    認証のため。

  • ジョブID

  • プロジェクトUID

  • セグメントID

出力:

{
  "jobs": [
    {
      "uid": "string",
      "status":"ACCEPTED",
      "providers": [
        {
          "type": "string",
          "id": "string",
          "uid": "string"
        }
      ],
      "targetLang": "文字列",
      "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"
    }
  ],
  "プロジェクト": {
    "name": "string",
    "uid": "string"
  }
}

ジョブをワークフローステップにマップする

入力パラメータ:

  • アクセストークン

    認証のため。

  • ジョブID

  • プロジェクトUID

  • ワークフロー レベル番号

出力:

{
  "taskId": "string",
  "workflowLevel": "string",
  "resourcePath": "string",
  "project": {
    "uid": "string"
  },
  "job": {
    "uid": "string"
  }
}

セグメントを準備する v3

入力パラメータ:

  • アクセストークン

    認証のため。

  • ジョブID

  • プロジェクトUID

出力:

[
  {
    "segmentId": "string",        // Value from ."@id"
    "origin": "string",           // Value from ."@m:trans-origin"
    "score": number,              // Numeric value from ."@m:score"
    "length": 数値,             // .source 文字列の長さ
    "source": "string",           // Value of .source
    "target": "string"            // Value of .target
  },
  ...
]

単一ジョブでQAを実行する v3

入力パラメータ:

  • アクセストークン

    認証のため。

  • ジョブID

  • プロジェクトUID

  • 警告の種類

出力:

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

一覧を引く

入力パラメータ:

  • 除外リスト

  • 原文一覧

出力:

[1, 3, 5]
この記事は役に立ちましたか?

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.