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 查询

  • 排序

  • 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": []         
      },
      "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]

操作包故障排除

问题

原因

解决方案

一个操作包显示“已取消”状态,并伴有错误“ActionBundle is cancelled because the last task did not execute”(操作包已取消,因为最后一个任务未执行)。

包内的一个内部操作未成功完成,这导致包的最后一步无法运行。

检查包内各个任务的状态以确定哪个内部操作失败,然后在重新运行工作流之前解决该操作的错误。

执行页面上点击重试执行会按原样重新运行整个执行,但无法自行解决此错误,因为包内的底层操作仍然失败。

这篇文章有帮助吗?

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.