Orchestrator

操作包

文本由 Phrase Language AI 从英语机器翻译而得。

操作包是 Orchestrator 中预设的操作组,反映了特定业务流程步骤,让本地化经理和项目经理等非专业技术用户无需深入了解 Phrase API 栈即可创建工作流

操作包的配置与标准操作一样,需要执行参数。

由于它们包含多个操作,操作包会消耗更多的 工作流执行操作额度。用户可参考工作流编辑器中操作页面右上角的数值。

用户可以在编辑器的 操作 选项卡中查找和使用现有的操作包,但无法创建新的操作包(联系 Team 支持以请求新操作包)。搜索操作时,启用优先操作包选项即可在列表中优先查看操作包。粗体蓝色图标表示常规操作与操作包之间的区别。

使用操作包

要使用操作包,请按照以下步骤操作:

  1. 将选定的操作包拖到工作流上。

    操作包出现在工作流中。

  2. 点击操作包并选择参数选项卡。

  3. 点击 编辑参数

    显示操作包所需的参数。

  4. 提供所需参数并点击 保存参数

    参数已保存到操作包并显示。

  5. 如果需要更改,请再次点击 编辑参数

可用操作包

添加或更新翻译

说明:

此操作包等同于在 Strings Editor 中点击翻译字段并输入翻译(覆盖之前存在的任何内容)。

输入参数:

  • 项目 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": "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"
  }
}

分配并通知服务商

输入参数:

  • 访问令牌

    用于身份验证。

  • 电子邮件模板 UID

  • list_of_job_uids

    • 列表

  • 项目模板 UID

  • 项目 UID

    一个包含手动输入或从触发器引用的项目 ID 的数组。

输出:

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

检查 Strings 工作的所有译文区域是否已完成

说明:

此操作包用于检查所有 Strings 工作译文区域是否已完成。如果是,则返回 true,否则返回 false

输入参数:

  • 访问令牌

    用于身份验证。

  • 项目 ID

    用于列出特定项目内的所有工作译文区域。

  • 工作 ID

    用于列出所有工作译文区域。

输出:

true 
或
false

将内容从 Strings 项目导出到在线存储库

说明:

此操作包获取项目 ID,并根据这些 ID 以及列出存储库同步的输出,识别随后在循环中触发导出的存储库同步 ID。操作包的结果是触发了导出的存储库同步列表。

输入参数:

  • 访问令牌

    用于身份验证。

  • 项目 ID

    一个包含手动输入或从触发器引用的项目 ID 的数组。

  • Strings 账户 ID

    列出存储库同步所需的 Strings 组织 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 endpoint 的分页需求。它还将项目 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" }
.
.
]

按区域列出译文

说明:

此操作包隐藏了 List translations by locale API endpoint 的分页需求。它还将项目 ID 添加到有效负载中,以启用更稳健的循环。

输入参数:

  • 项目 ID

    要获取译文的 Strings 项目 ID。

  • 区域 ID

    项目中要获取译文的 Strings 区域 ID。

  • q

    Strings 查询<1>。

  • 排序

  • Strings 访问令牌

输出:

{
  "projectId": "f6dfee6466384379606b6158a410cd46",
  "translations": [
    {
      "content": "This is new translation - six",
      "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"
    }
  ]
}

锁定句段

输入参数:

  • 访问令牌

    用于身份验证。

  • 工作 UID

  • 项目 UID

  • 句段 ID

输出:

{
  "jobs": [
    {
      "uid": "string",
      "status": "ACCEPTED",
      "providers": [
        {
          "type": "string",
          "id": "string",
          "uid": "string"
        }
      ],
      "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": "string"
  }
}

将工作映射到工作流步骤

输入参数:

  • 访问令牌

    用于身份验证。

  • 工作 UID

  • 项目 UID

  • 工作流级别编号

输出:

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

准备句段 v3

输入参数:

  • 访问令牌

    用于身份验证。

  • 工作 UID

  • 项目 UID

输出:

[
  {
    "segmentId": "string",        // Value from ."@id"
    "origin": "string",           // Value from ."@m:trans-origin"
    "score": number,              // Numeric value from ."@m:score"
    \"长度\": number,             // .原文/源语 字符串的长度
    "source": "string",           // Value of .source
    "target": "string"            // Value of .target
  },
  ...
]

对单个工作运行 QA v3

输入参数:

  • 访问令牌

    用于身份验证。

  • 工作 UID

  • 项目 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.