自动化
    1. Phrase
    2. Phrase TMS
    3. 自动化

    Automated Project Creation - APC (TMS)

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

    可用于

    • 所有付费套餐

    可用于

    • 项目经理

    • Team、Ultimate 和 Enterprise（原）套餐中

    关于许可问题，请联系销售团队。

    注释

    原 APC 计划于 2025 年弃用。客户必须在 2025 年 12 月 31 日之前完成其原 APC 到新版本的迁移。

    迁移流程

    1. 点击每个 APC 旁边的 迁移 以触发迁移，并可选择执行触发器以避免数据丢失。

    2. 在 APC v2 设置页面中，在保存之前查看并完成任何缺失的字段。

      旧的 APC v1 在保存新 APC 后立即停用。

    所有已迁移的 APC 默认启用“试运行”模式。这意味着第一次迭代将创建一个基准，实际的文件导入将从下一个迭代开始。

    我们仍在不断优化，实际的用户界面可能与视频中呈现的不一样。

    设置 Automated Project Creation

    Automated project creation 规则允许配置 Phrase 如何通过 集成 连接器监控特定文件夹，并在其中检测到新内容或更新内容时创建新项目。

    项目模板：

    • 大多数 APC 设置都在项目模板中处理。项目模板定义了文件目标、原文/源语和译文以及工作流步骤。流程和财务详细信息（例如供应商以及报价和分析的生成）也在项目模板中定义。

    将译文导出回存储库：

    • 当项目状态设置为 完成 时，作业将被导出。

    • 可以通过选择 下载 > 导出到在线存储库 手动导出作业。即使是未更改的文件也会被导出。

    • 每个译文文件都存储在 APC 设置中指定的译文路径中。

    重新导入：

    • 作业可以从 jobs table 上的 Download 菜单中重新导入。

    APC 设置

    先决条件：

    • 至少有一个 连接器 和个人资料中的一个 项目模板。

    • （可选）一个 电子邮件模板，且类型选择为 New Project via Automated Project Creation 或 Source update via Automated Project Creation。

    • 如果使用 Job Sync（Phrase Strings 连接器），则可以设置多个文件夹或文件进行监控。

    重要

    每个 APC 监控超过 10,000 个文件可能会导致文件导入错误和性能问题。如果 UI 中出现错误，建议减少受监控文件的数量，并手动触发 APC 监控以重试导入。

    每个 APC 最多可设置 10 个受监控文件夹。

    请按照以下步骤操作：

    1. 创建一个新的 APC

      1. 在设置 Setup_gear.png 页面中，点击 Automated project creation。

        Automated project creation 页面随即打开。

      2. 单击新建。

        Creation 页面随即打开。

      3. 为 APC 提供一个名称（左上角）。

      4. 如果需要，请选择一个 项目模板。

      5. 设置可用的/不可用的状态（左上角）。

        填写所有必填字段后，Save 按钮即变为可用的。

    2. 设置创建与导出

      1. 选择项目的创建方式。

      2. 选择是否：

        • APC 是一个连续项目。

        • 从下拉列表中选择如何根据检测到更改的时间和位置来创建新项目。

      3. 从下拉列表中选择一个项目模板。

        • 原文/源语语言在项目模板中定义，可以选择全部或部分译文语言。

        • 选择 查看项目模板详情 以预览所选项目模板的设置。

        • 监控（步骤 2）中的文件选择会显示默认原文/源语区域（连接器中配置的原文/源语区域）中的条目。如果选择了项目模板，则会显示该模板原文/源语区域的条目。无论设置如何，也无论项目模板与连接器原文/源语区域之间是否存在潜在差异，系统都会遵循项目模板的原文/源语区域，并正确创建作业。

      4. 选择导出译文的标准。

        导出译文来源是指译文在导出时所处的工作流状态。用户可以决定导出哪些内容；例如，来自最终工作流步骤或之前步骤的译文。

        最多可定义 5 个导出。配置应导出的内容（来自哪个工作流步骤）以及触发导出的时间。

        完成时提供了触发导出的事件。

        • 当选定的工作流步骤完成时，译文将被导出；当某个译文语言的指定工作流步骤完成时，这将触发该语言的导出，而无需等待其余译文语言完成。

        • 当整个项目完成时（即所有工作流步骤中的所有作业均已完成时），译文将被导出。

    3. 监控

      1. 点击 监控文件夹或文件 以选择要监控新内容或更新内容的文件夹。

        连接器窗口打开，其中列出了为该账户配置的所有连接器。

        如果未列出所需的连接器，可以通过点击窗口左上角的加号按钮 Plus_connector.png 来添加。

      2. 点击一个连接器以打开文件夹列表。

      3. 选择要监控的特定文件夹或文件。

        并非所有选项在所有 连接器 上都可用

        • 如果未选择任何内容，则会监控整个文件夹的更改或新文件。

        • 包含子文件夹以启用对所选文件夹及其子文件夹的监控。

        • 将已处理的文件移动到指定文件夹 可用于基于文件的连接器，以指示哪些文件已用于翻译。

        按文件名模式筛选 (regex) 允许客户定义一个 正则表达式 来筛选文件夹内要监控的文件。此功能不能用于筛选文件夹。

      4. 点击 确认。

        所选文件夹或文件将连同连接器类型和受监控实体的路径一起列在列表中。点击 浏览 以更改选择。

        对于某些连接器（Strings，Contentful），可以通过再次点击 监控文件夹或文件 将更多文件夹或文件添加到列表中。

        • 多个文件夹或文件只能在一个连接器内进行监控。

        • 如果对受监控的连接器进行了更改，则之前保存的设置将被删除。

        点击 保存 以确认文件夹和文件选择。

      5. 点击 添加监控 以选择 基于计划 或 基于webhook 的触发器。

        在监控窗口中提供 webhook 或计划（或两者）。

    4. 设置可选的自动化操作

      1. 选择所需的自动化。

      2. 选择原文更新选项（仅针对 连续项目<1> 启用）。

      3. 选择译文更新选项（仅在选择了 创建新项目 时，针对 Phrase Strings 连接器<1> 启用）。

        用户可以监控远程在线存储库以获取译文更新。对在线存储库中译文副本所做的任何更改都将自动更新翻译记忆库。

      4. 点击保存。

        从受监控文件夹导入文件<1> 打开。

        如果选择了 仅新文件和已更新文件，自动化的试运行将在第一次迭代时创建基准，并在该基准之后仅导入新文件/已更新文件，以减少不必要的用量。此选项仅在第一次迭代时可用。

      5. 点击 确认。

        APC 已添加到 自动化项目创建<1> 页面上的列表。

    设置好自动化规则后，现在可以在指定文件夹中创建内容。基于频率检查，Phrase 会查看指定文件夹并识别新内容或已更新内容（基于文件名、元数据、大小等）。

    更改检测

    APC 根据连接器类型及其配置使用两种更改检测策略。

    基于文件历史的检测

    大多数连接器都使用此功能。在每次检测运行时，APC 都会列出受监控文件夹中的文件，并将每个文件与上一次运行中存储的记录进行比较。比较以下字段：

    • 哈希值

    • 文件大小

    • 上次修改

    • 截止日期

    实际可用的字段取决于连接器提供的内容，因为并非所有连接器都会公开所有字段。所有可用（非空）字段都会进行比较。

    当传入文件中的任何可用字段与存储的记录不同时，文件即被视为 已更改。如果可用字段集在两次运行之间发生变化（例如，之前不可用的哈希变得可用），则该文件会被视为元数据已修改，并触发导入。

    存储的记录会在每次成功的检测周期后更新。

    基于差异的检测

    当 Git 连接器 启用了子文件夹监控 时使用。对于未启用子文件夹监控的 Git 连接器，则改用基于文件历史的检测。

    APC 不会比较文件元数据，而是向连接器查询自上次处理的提交以来已更改的文件列表。

    • 在首次运行时，APC 会获取文件夹中的所有文件，并将它们全部视为已更改。

    • 在后续运行中，APC 仅请求自上次已知提交以来已更改的文件。

    上次处理的提交 ID 会被存储，并用作下一个检测运行的起点。

    何时跳过导入或更新

    在以下情况下，APC 会跳过触发导入或更新：

    • 未找到匹配的文件

      如果被监控的文件夹未返回任何文件，或者没有文件匹配已配置的文件名筛选，则会跳过本次运行且不采取任何操作。

    • 文件已由该 APC 上传

      如果被监控文件夹中的文件之前是由同一个 APC 实例上传的（例如，写回原文/源语文件夹的译文文件），则会将其从更改检测中排除，以防止重新导入 APC 输出。

    • 未检测到内容更改（基于文件历史记录的连接器）

      如果文件的所有可用字段都与存储的记录匹配，则该文件将被视为未更改并被跳过。

    • 选择性导入（文件不在所选集合中）

      当运行被配置为仅导入特定文件时，所选集合之外的文件将从当前运行中排除，并在下一个检测周期中进行评估。

    当监控多个文件夹时

    当 APC 监控多个文件夹时，每个被监控的文件夹都会运行其独立的检测。结果会在触发下游导入之前进行收集和合并。

    使用基于 Git 的连接器且启用了子文件夹监控的文件夹会使用差异检测；所有其他文件夹均使用基于文件历史记录的检测。

    设置译文文件路径名

    每个译文文件都会导出到 项目设置 中指定的文件夹。

    禁用 APC

    有三种禁用 APC 的方法：

    • 在设置中手动禁用。

    • 在 90 天不活动后自动禁用。

    • 在公司个人资料停用后（订购套餐结束时）自动禁用。

    当作为 APC 规则一部分的连接器检测到项目在应该创建时连续三次或更多次未被创建，系统会向受影响的用户发送通知。

    ZIP 文件支持

    • 可以将多个 ZIP 文件导入到一个项目中。

    • 译文文件会被导出回 ZIP 文件。

    • 如果一个 ZIP 文件被导入到多个译文，译文文件将被导出到多个 ZIP 文件中——每个译文语言对应一个 ZIP——并在 ZIP 名称中使用译文区域代码（例如 Pack18.en_us.ZIP）。

    APC 概览页面

    自动项目创建页面提供了当前可用的 APC 的概览。

    可以按类型、状态、上次触发、下一个预定时间和APC 版本筛选 APC。

    如果选择了特定的 APC：

    • 编辑

      打开所选 APC 进行编辑。

    • 复制

      创建所选 APC 的副本。

    • 触发显示器

      手动检查原文/源语文件是否有更新，并更新上次触发日期和时间。

    • 强制导入

      导入所选 APC 监控的远程文件夹中的所有文件，绕过更改检测。

      启用强制导入时，所有符合文件夹筛选条件的文件都将被视为已更改，无论其存储的历史记录如何。这对于在配置更改后重新处理文件或需要重新导入时非常有用。

      • 选择性强制导入

        选择要从受监控文件夹中导入的文件。仅所选文件绕过更改检测。文件夹中的其余文件不受影响，并将在下一次预定的检测运行中正常评估。

    • 删除

      连接到可用的项目的 APC，以及无法删除的已归档但未完成的项目。

    APC 设置

    点击特定的 APC 将打开该 APC 的设置页面。在设置页面中，可以执行以下操作：

    • 在 配置 选项卡中，查看并更新 APC 设置。

    • 在 历史记录 选项卡中，跟踪 APC 执行的操作及其状态。

    • 在 财务 选项卡中，查看并下载为 APC 生成的现有 持续分析。

    历史记录

    APC 历史记录详细列出了 APC 执行的所有操作。它使本地化经理能够查看所有 APC 事件、搜索和筛选它们，并排查特定 APC 的问题。

    注释

    搜索栏仅适用于英语查询。所有数据均以英语存储，以便 Phrase 的工程师和技术支持/客户成功团队能够使用这些日志。

    日志跟踪以下事件：

    • 项目

      • 创建

      • 状态更改

    • 工作

      • 导入

      • 导出

      • 原文更新

      • 译文更新

      • 状态更改

    • 监控

      • 文件夹监控

    • APC

      • 创建

      • 停用

    日志不跟踪：

    • 手动操作（手动文件导入）

    • 对 APC 功能没有影响的操作（例如，不影响 APC 的项目模板设置更新）

    • 与 APC 无关的操作

    • 报价和分析创建

    • 翻译记忆库更新

    • 已发送的通知

    • APC 配置更改

    APC 状态

    APC 的状态显示在 APC 概览页面上。

    • 活跃

      APC 运行正常，没有任何问题

    • 未生效

      APC 已被有意设置为非活动状态

    • 需处理

      APC 正在运行，但由于可能发生的更改或可能影响 APC 的轻微错误，需要用户注意。

      APC 上的错误和警告状态仅反映最近一次运行的结果。这些状态不会实时更新。需要注意 或错误状态将保持可见，直到 APC 再次成功运行。如果底层问题已解决，请手动触发 APC 以清空过时的状态。

      原因

      详细信息

      APC 检查成功，但文件导入失败。

      来自连接器的文件导入失败。请检查 APC 编辑页面上的受监控文件配置。 

      修复文件监控后，触发 导入（或 选择性导入）以重新导入之前失败的文件。

      在一个 APC 中监控了多个文件夹：部分受监控文件夹失败。

      APC 仅监控成功受监控文件夹的更改。请检查所有受监控文件夹是否仍然存在。

      修复受监控文件夹后，触发监控以处理新的/错过的更改。

      在一个 APC 中监控了一个文件夹：受监控文件夹失败。

      请检查受监控文件夹是否仍然存在。

      一旦受监控文件夹修复，触发监控以处理新的/遗漏的更改。

      在一个 APC 中监控多个文件夹：所有文件夹都有一些问题，但在 APC 检查中仅失败了一两次，

      在 APC 编辑页面上验证文件夹监控设置。一旦受监控文件夹修复，触发监控以处理新的/遗漏的更改。

      连接器故障

      检查连接器配置。

      导出设置的工作流步骤已不存在。

      APC 仍在运行，但不会执行任何导出。确保项目模板正确且 APC 导出设置正确。

      导出设置的工作流步骤已被修改。

      APC 仍在运行，并将从工作流步骤执行导出，该步骤的编号与为 APC 配置的工作流步骤编号相对应。 确保项目模板正确且 APC 导出设置正确。

      一些译文语言已从项目模板中移除。

      APC 不会在新创建的项目中使用已移除的语言。

      从 APC 导出文件失败。

      手动导出文件。

    • 已停止

      由于严重错误/故障，APC 已被系统停用。

      原因

      详细信息

      项目模板中移除了所有原文/源语和/或译文语言。

      无源语和/或目标语言。在项目模板中至少添加一种原文/源语和一种译文语言，然后将 APC 状态设置为可用的。一旦 APC 重新激活，新创建的项目将使用更新后的原文/源语/译文区域设置。

      所有受监控文件夹的 APC 检查均失败三次。

      验证监控配置和连接器设置，然后重新激活 APC 并触发监控。

    通过 APC 使用枢纽语言进行翻译

    在多语言本地化中，枢纽语言可以用作桥梁语言，以启用从原文/源语到任意数量译文语言的翻译。当原文/源语的翻译资源有限时，中转语言方法尤为有效。

    使用中转语言进行翻译是一种 APC 使用案例，旨在实现翻译流程的自动化。以下示例总结了需要遵循的步骤：

    1. 在所需的在线存储库中创建一个文件夹，用于存储原文/源语内容。

      在此示例中，法语原文/源语文件被添加到 Google Drive 文件夹中。

    2. 设置 APC 监控选项，以监控所需在线存储库中的内容更新。

    3. 设置 APC 以创建项目，并使用所需的原文/源语语言和选定的中转语言作为译文语言。

      在此示例中，APC 设置为创建一个以法语为原文/源语、以英语为中转译文语言的项目。

    4. 配置 APC 导出设置，将译文内容导出到同一在线存储库中相应的译文语言文件夹。

      在此示例中，APC 设置为将英语译文导出到同一 Google Drive 上的译文文件夹中。

    5. 项目完成后，导出操作会触发 APC 创建另一个项目，用于将内容从中转语言翻译为所需的译文语言。

      在此示例中，导出操作会触发 APC 创建另一个项目，用于将内容从英语翻译为德语。

    注释

    必须设置所需的 连接器 和 项目模板 才能使用此用例。

    对于大型项目，也可以通过 API 进行自定义脚本编写来实现中转语言翻译。

    自动化项目创建 (原)

    注释

    作为弃用流程的一部分，未主动使用早期版本 APC 的客户将无法再访问该版本（按钮已移除）。

    自动化项目创建规则允许配置 Phrase 如何监控特定文件夹，并在检测到新内容或更新内容时创建新项目。这提供了完整的流程自动化；分析、预翻译、分配给语言专家/供应商以及发送电子邮件通知。

    一旦项目状态通过项目状态自动化规则更改为 已完成，译文文件就会被发送回在线存储库，并存入由语言代码（en、es、ja 等）标识的新建子文件夹中。如果用户手动触发导出，则已完成的文件将导出到标准的 {targetLang} 文件夹。

    将翻译导出回存储库

    • 当项目状态设置为“已完成”时，作业将被导出。

    • 可以通过选择 下载 > 导出到在线存储库 手动导出作业。即使是未更改的文件也会被导出。

    • 每个译文文件都存储在 APC 设置中指定的译文路径中。

    重新导入

    • 作业可以从 jobs table 上的 Download 菜单中重新导入。

    设置自动化规则

    自动化项目创建规则允许配置 Phrase TMS 如何监控特定文件夹，并在其中检测到新内容或已更新内容时创建新项目。

    先决条件：

    注释

    创建服务时，请确保选择了 仅分析 或 分析和报价，并且在 财务 部分中取消选择了 使用项目模板设置中定义的命名 选项。如果选择了 无，则自动化项目创建将不会为受监控文件夹中的新内容或已更新内容创建新项目。

    请按照以下步骤操作：

    1. 从“设置” Setup_gear.png 页面，点击 自动化项目创建。

      自动化项目创建 页面打开。

    2. 单击新建。

      创建自动化项目设置 页面打开。

    3. 为 APC 提供一个名称。

    4. 设置可用的/不可用的状态。

    5. 如果需要，选择 版本 2 (BETA)（如果选择此项，后续选项将会更改）。

    6. 如果需要，选择 作为 连续项目 运行。

    7. 选择要监控新内容或已更新内容的 远程文件夹。

      文件夹中的内容已列出

    8. 选择要监控的特定文件。

      并非所有选项在所有 连接器 上都可用。

      • 如果未选择任何内容，则会监控整个文件夹以查看是否有更改或新文件。

      • 包含子文件夹以启用对所选文件夹及其子文件夹的监控。

    9. 选择 导出已完成文件到<1>的位置。

    10. 根据所需译文文件的路径名，设置 导出已完成文件到<1> 和 译文子文件夹路径<3> 字段。

    11. 指定一个 已处理子文件夹<1>。

      导入的文件会被移动到此文件夹，从而可以查看哪些文件正在被处理。如果禁用，原文/源语文件将保留在其原始文件夹中。

      如果禁用此选项且未使用文件重命名，则原始文档可能会被其译文覆盖（取决于存储库）。

      按文件名模式筛选 (regex) 允许客户定义一个 正则表达式 来筛选文件夹内要监控的文件。此功能不能用于筛选文件夹。

    12. 设置 Phrase 检查指定文件夹中新内容内容的频率。

    13. 选择所需的 服务（如果需要，可指定 截止日期方案）。

    14. 选择自动创建的项目将关联的原文/源语和译文语言。

    15. 为了区分来自不同自动化规则的项目，请使用 项目名称 来定义自动生成的项目名称。

      宏 {filename} 可用于项目的标题中。如果项目名称中使用了多个文件名，则仅使用第一个文件名。

    16. 设置 项目所有者。

      当使用自动化规则创建新项目时，项目所有者将始终收到通知。

    17. 如果需要，可自定义用于通知的 电子邮件模板。

    设置译文文件路径名

    相对于原文/源语文件，译文文件可以导出到：

    • 相同文件夹

      如果选择了特定文件，则为 导出已完成文件到 选择 原文/源语文件文件夹，并保持 译文子文件夹路径 为空。如果监控整个文件夹，则不支持此功能。

    • 语言子文件夹

      请始终保持 译文子文件夹路径 为空。

      如果监控了特定文件，则为 导出已完成文件至 选择 译文语言子文件夹。

    • 任意文件夹

      如果监控了特定文件，则为 导出已完成文件至 选择 译文语言子文件夹。

      在 译文子文件夹路径 中指定文件夹名称：

      • 使用这些宏来表示译文语言。

        • {targetLang} 基于 语言代码。

        • {targetLangName} 基于 语言名称。

        • {targetLangRFC}

          • 示例：es, en-US, az-Latn-AZ

          • 基于 RFC 5646

        • {targetLangAndroid}

          • 示例：es, en-rUS

        • {targetLangAndroidBCP}

          • 示例：b+es, b+en+US

      • 可以在原文/源语文件夹内创建子文件夹。

        适用于 Amazon S3, Azure, FTP, SFTP, Dropbox, Google Drive, Box, OneDrive, Git, GitHub, GitLab 和 Bitbucket Cloud。

      • 对于某些存储库，可以使用绝对路径。以 / 开头以指示绝对路径。

        适用于 Amazon S3, Azure, FTP, SFTP, Dropbox, Google Drive, Box, OneDrive, Git, GitHub, GitLab 和 SharePoint。使用 Git 连接器时，前导 / 后跟分支名称，然后是 .git 文件夹所在的存储库根目录。如果分支不存在，将会创建该分支。使用其他基于 Git 的连接器（例如 GitLab）时，前导斜杠后跟 .git 文件夹所在的存储库根目录。

      • 使用 .. 来引用父文件夹。

      提示

      示例

      如果原文文件是 /files/loc/ui.properties 且译文语言是德语（德国）：

      • translations/{targetLang} 将创建 /files/loc/translations/de_de

      • /files-{targetLang}/loc 将创建 /files-de_de/loc/<filename>

      • ../{targetLang} will create /files/de_de/<filename>

    ZIP 文件支持

    • 可以将多个 ZIP 文件导入到一个项目中。

    • 译文文件会被导出回 ZIP 文件。

    • 如果一个 ZIP 文件被导入到多个译文，译文文件将被导出到多个 ZIP 文件中——每个译文语言对应一个 ZIP——并在 ZIP 名称中使用译文区域代码（例如 Pack18.en_us.ZIP）。

    这篇文章有帮助吗？
    ★ ★ ★ ★ ★

    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.

    Articles related to Automation