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

    自动化项目创建 - APC (TMS)

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

    可用于

    • 所有付费套餐

    可用于

    • 项目经理

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

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

    注释

    遗留的APC计划在2025年停用。客户必须在2025年12月31日前完成其遗留APC到新版本的迁移。

    迁移过程

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

    2. 在APC v2设置页面，审查并完成任何缺失的字段，然后保存。

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

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

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

    设置自动化项目创建

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

    项目模板:

    • 大多数APC设置在项目模板中处理。项目模板定义了文件目的地、源语言和目标语言以及工作流步骤。项目模板中还定义了处理和财务细节，例如提供商以及报价和分析的生成。

    将翻译导出回存储库:

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

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

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

    重新导入:

    • 作业可以从下载菜单在作业表中重新导入。

    APC设置

    先决条件:

    • 在个人资料中至少需要一个连接器和一个项目模板。

    • （可选）一个电子邮件模板，类型选择通过自动项目创建的新项目或通过自动项目创建的源更新。

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

    重要

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

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

    按照以下步骤操作：

    1. 创建一个新的APC

      1. 在设置Setup_gear.png页面，单击自动化项目创建。

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

      2. 单击新建。

        创建页面打开。

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

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

      5. 设置活动/非活动状态（左上角）。

        一旦所有必填字段填写完毕，保存按钮将变为可用。

    2. 设置创建和导出

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

      2. 选择是否：

        • APC将是一个连续项目。

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

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

        • 源语言在项目模板中定义，可以选择所有或部分目标语言。

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

        • 在监控中的文件选择（步骤2）显示默认源区域的条目（根据连接器配置的源区域）。如果选择了项目模板，则显示该模板的源区域的条目。无论设置和项目模板与连接器的源区域之间可能存在的差异，均遵循项目模板的源区域，并正确创建作业。

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

        导出翻译是工作流状态翻译在准备导出时的状态。用户可以决定导出哪些内容；例如，从最终工作流步骤或之前的步骤导出的翻译。

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

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

        • 当选定的工作流步骤完成时，翻译将被导出；当为一种目标语言完成指定的工作流步骤时，这将触发该语言的导出，而无需等待其他目标语言完成。

        • 当整个项目完成时，翻译将被导出 - 即当所有工作流步骤中的所有任务完成时。

    3. 监控

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

        连接器窗口打开，显示为账户配置的所有连接器的列表。

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

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

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

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

        • 如果没有选择，整个文件夹将被监控以检测更改或新文件。

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

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

        按文件名模式过滤（正则表达式）允许客户定义正则表达式以过滤要在文件夹内监控的文件。这不能用于过滤文件夹。

      4. 点击确认.

        所选文件夹或文件以名称、连接器类型和监控实体的路径列出。点击 浏览 更改选择。

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

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

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

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

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

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

    4. 设置可选的自动化。

      1. 选择所需的自动化。

        • 基于模板分配服务商

        • 分析和报价选项

        • 截止日期方案

        • 通知

          带有 通过自动项目创建的新项目 或 通过自动项目创建的源更新 的 电子邮件模板 将在此下拉菜单中可用。

      2. 选择源更新选项（仅在 连续项目 时启用）。

        • 如果在APC设置的 创建与导出 部分选择了 每次创建新项目，APC将监控远程文件夹以获取源更新，但不需要详细配置，因为每次检测到更改时都会创建新项目。

        • 对于连续项目，指定在检测到源更新时需要重新打开哪些工作流步骤，是否要生成新的分析和报价，以及是否要通知项目所有者有关源更新。

          • 如果选择 连续分析 以在每次源更新时生成新的分析，请指定要从 分析 中排除的内容（已确认的段落、已锁定的段落、数字）以及如何分组字数（按服务商、按语言）。

            注释

            连续分析的默认设置是译后编辑分析和默认分析的默认强制设置的组合。

            如有需要，请启用宏辅助分析命名以使用可用的宏输入连续分析的命名模式。

      3. 选择目标更新选项（仅在选择每次创建新项目时启用短语字符串连接器）。

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

      4. 点击保存。

        从监控文件夹导入文件已打开。

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

      5. 点击确认.

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

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

    更改检测

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

    基于文件历史的检测

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

    • 哈希

    • 文件大小

    • 最后修改

    • 到期日

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

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

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

    基于差异的检测

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

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

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

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

    最后处理的提交ID被存储并用作下次检测运行的起点。

    当导入或更新被跳过时

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

    • 未找到匹配文件

      如果监控文件夹没有返回文件，或者没有文件匹配配置的文件名过滤器，则该运行将被跳过，不采取任何行动。

    • 文件是由此APC上传的

      如果监控文件夹中的文件之前是由同一APC实例上传的（例如，翻译后的文件写回源文件夹），则该文件将被排除在更改检测之外，以防止重新导入APC输出。

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

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

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

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

    监控多个文件夹时

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

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

    设置目标文件路径名

    每个目标文件被导出到项目设置中指定的文件夹。

    禁用自动项目创建

    有三种方法可以禁用APC：

    • 在设置中手动禁用。

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

    • 在组织资料被停用后自动禁用（在订阅结束时）。

    当作为自动项目创建规则一部分的连接器检测到三次或更多连续未按预期创建项目的情况时，将向受影响的用户发送通知。

    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无关的操作

    • 报价和分析创建

    • TM更新

    • 已发送通知

    • 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设置中指定的目标路径中。

    重新导入

    • 作业可以从下载菜单在作业表中重新导入。

    设置自动化规则

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

    先决条件:

    注释

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

    按照以下步骤操作：

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

      自动项目创建页面打开。

    2. 单击新建。

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

    3. 为APC提供一个名称。

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

    5. 如果需要，选择版本2（测试版）（如果选择，以下选项将会改变）。

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

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

      文件夹的内容列出。

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

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

      • 如果未选择，整个文件夹将监控更改或新文件。

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

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

    10. 根据所需目标文件的路径名，设置导出已完成文件到和目标子文件夹路径字段。

    11. 指定一个处理过的子文件夹。

      导入的文件将移动到此文件夹，以提供正在处理的文件的可见性。如果禁用，源文件将保留在其原始文件夹中。

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

      按文件名模式过滤（正则表达式）允许客户定义正则表达式以过滤要在文件夹内监控的文件。这不能用于过滤文件夹。

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

    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