自动化项目创建规则允许配置 Phrase 如何通过 集成 连接器监控特定文件夹,并在其中检测到新内容或更新内容时创建新项目。
-
大多数 APC 设置都在项目模板中处理。项目模板定义了文件目标、原文/源语和译文语言以及工作流步骤。流程和财务详细信息(例如提供商以及报价和分析的生成)也在项目模板中定义。
-
不同的 APC 可以共享同一个项目模板,但每个 APC 仍然会创建自己的项目。由不同 APC 监控的文件或文件夹中的任务不会合并到同一个项目中。
将译文导出回存储库:
-
当项目状态设置为 时,任务会被导出。
-
可以通过选择 > 手动导出任务。即使未更改的文件也会被导出。
-
每个译文文件都存储在 APC 设置中指定的译文路径中。
重新导入:
-
任务可以从任务表上的 菜单中重新导入。
先决条件:
重要
每个 APC 监控超过 10,000 个文件可能会导致文件导入错误和性能问题。如果 UI 中出现错误,建议减少监控文件的数量,并手动触发 APC 监控以重试导入。
每个 APC 最多可设置 10 个监控文件夹。
请遵循以下步骤:
-
创建一个新的 APC
-
在设置
页面中,点击 APC。
页面打开。
-
单击新建。
页面打开。
-
为 APC 提供一个名称(左上角)。
-
如果需要,选择一个项目模板。
-
设置可用的/不可用的状态(左上角)。
一旦填好所有必填字段,保存按钮即变为可用的。
-
-
设置创建和导出
-
选择如何创建项目。
-
选择是否:
-
APC 将成为一个连续项目。
-
从下拉列表中选择如何根据检测到更改的时间和位置来创建新项目。
-
-
从下拉列表中选择一个项目模板。
-
原文语言在项目模板中定义,可以选择全部或部分译文语言。为 APC 选择的译文语言适用于 APC 监控的所有文件和文件夹。APC 不能为同一规则内的不同文件或子文件夹分配不同的译文语言集。要为不同的文件或子文件夹创建具有不同译文语言集的任务(例如,一个文件仅需要德语,而另一个需要德语、西班牙语和法语),请为每个文件或文件夹设置单独的 APC,每个 APC 仅指向相关文件或文件夹,并仅配置该内容所需的译文语言。
-
选择 查看项目模板详情 以预览所选项目模板的设置。
-
(步骤 2)中的文件选择显示默认原文区域中的条目(连接器中配置的原文区域)。如果选择了项目模板,则会显示该模板原文区域的条目。无论项目模板和连接器的原文区域之间的设置和潜在差异如何,都会遵循项目模板的原文区域并正确创建任务。
-
-
选择导出译文的标准。
是指当译文处于何种工作流状态时进行导出。用户可以决定导出哪些内容;例如,来自最终工作流步骤或之前步骤的译文。
最多可定义 5 个导出。配置应导出的内容(来自哪个工作流步骤)以及何时触发导出。
提供了触发导出的事件。
-
当选定的工作流步骤完成时,译文将被导出;当指定的译文语言的工作流步骤完成时,这将触发该语言的导出,而无需等待其余译文语言完成。
-
当整个项目完成时(即当所有工作流步骤中的所有任务都完成时),译文将被导出。
-
-
-
监控
-
点击 监控文件夹或文件 以选择要监控新内容或更新内容的文件夹。
窗口打开,其中列出了为该账户配置的所有连接器。
如果未列出所需的连接器,可以通过点击窗口左上角的加号按钮
来添加。
-
点击一个连接器以打开文件夹列表。
-
选择要监控的特定文件夹或文件。
并非所有选项在所有 连接器 上都可用
-
如果未选择任何内容,则会监控整个文件夹的更改或新文件。
-
包含子文件夹以启用对所选文件夹及其子文件夹的监控。
-
可用于基于文件的连接器,以指示哪些文件已用于翻译。
允许客户定义 正则表达式 以筛选出文件夹内要监控的文件。这不能用于筛选文件夹。
-
-
点击 确认。
所选文件夹或文件将与连接器的名称和类型以及被监控实体的路径一起列出。点击 浏览 以更改选择。
对于某些连接器(Strings,Contentful),可以通过再次点击 监控文件夹或文件 将更多文件夹或文件添加到列表中。
-
多个文件夹或文件只能在一个连接器内进行监控。
-
如果对已监控的连接器进行了更改,则之前保存的设置将被删除。
点击 保存 以确认文件夹和文件选择。
-
-
点击 添加监控 以选择 或 的触发器。
在监控窗口中提供webhook或计划(或两者)。
基于webhook的监控:
-
在APC设置期间选择 的监控并点击 添加 时,会自动生成webhook令牌。
-
每个APC都会收到其唯一的令牌。该令牌不会被共享,也不能在其他APC之间重复使用。
-
调用 webhook URL 会立即触发该特定 APC 上的更改检测。如果 APC 在 webhook 再次触发时已经在运行检查,Phrase 会排队等待一次额外的运行。当运行已在排队时,后续调用不会创建额外的运行;它们确认单个待处理的运行将继续进行。
-
-
-
设置可选自动化
-
选择必需的自动化。
-
选择原文更新选项(仅对 连续项目 启用)。
-
选择译文更新选项(仅在选择了 的情况下对 Phrase Strings 连接器 启用)。
用户可以监控 Remote 在线存储库以获取译文更新。对在线存储库中译文副本所做的任何更改都将自动更新翻译记忆库。
-
点击保存。
打开。
如果选中 ,自动化试运行将在第一次迭代时创建基准,并在该基准之后仅导入新文件/已更新文件,以减少不必要的用量。此选项仅在第一次迭代时可用。
-
点击 确认。
APC 会被添加到 页面上的列表中。
-
设置自动化规则后,现在可以在指定文件夹中创建内容。基于频率检查,Phrase 会查看指定文件夹并识别新内容或已更新内容(基于文件名、元数据、大小等)。
APC 根据连接器类型及其配置使用两种更改检测策略。
基于文件历史记录的检测
大多数连接器都使用此方法。在每次检测运行时,APC 会列出受监控文件夹中的文件,并将每个文件与上一次运行存储的记录进行比较。将比较以下字段:
-
哈希值
-
文件大小
-
上次修改
-
截止日期
实际可用的字段取决于连接器提供的内容,因为并非所有连接器都会公开所有字段。将比较所有可用(非空)字段。
当传入文件中的任何可用字段与存储记录不同时,文件即被视为 已更改。如果可用字段集在两次运行之间发生更改(例如,之前不可用的哈希值现在可用),则该文件将被视为元数据已修改,并触发导入。
存储的记录会在每次成功检测周期后更新。
基于差异的检测
当 基于 Git 的连接器 启用了子文件夹监控 时使用。对于没有子文件夹监控的 Git 连接器,改用基于文件历史记录的检测。
APC 不会比较文件元数据,而是向连接器查询自上次处理的提交以来已更改的文件列表。
-
在首次运行时,APC 会获取文件夹中的所有文件,并将它们全部视为已更改。
-
在后续运行中,APC 仅请求自上次已知提交以来已更改的文件。
上次处理的提交 ID 会被存储并用作下一个检测运行的起点。
当导入或更新被跳过时
在以下条件下,APC 会跳过触发导入或更新:
-
未找到匹配的文件
如果监控文件夹未返回任何文件,或者没有任何文件匹配配置的文件名筛选,则会跳过该运行且不采取任何操作。
-
文件由该 APC 上传
如果监控文件夹中的文件之前是由同一个 APC 实例上传的(例如,写回原文/源语文件夹的译文文件),则会将其从更改检测中排除,以防止重新导入 APC 输出。
-
未检测到内容更改(基于文件历史记录的连接器)
如果文件的所有可用字段都与存储的记录匹配,则该文件被视为未更改并被跳过。
-
选择性导入(文件不在所选集合中)
当运行配置为仅导入特定文件时,所选集合之外的文件将从当前运行中排除,并在下一个检测周期中进行评估。
当监控多个文件夹时
当 APC 监控多个文件夹时,每个监控文件夹都会运行其独立的检测。在触发下游导入之前,结果会被收集并合并。
使用启用了子文件夹监控的基于 Git 的连接器的文件夹使用差异检测;所有其他文件夹使用基于文件历史记录的检测。
每个译文文件都会导出到 项目设置 中指定的文件夹。
有三种方法可以禁用 APC:
-
在设置中手动禁用。
-
在 90 天不活动后自动禁用。
-
在公司个人资料停用后(订购套餐结束时)自动禁用。
当作为 Automated Project Creation 规则一部分的连接器检测到项目在应该创建时未创建,且这种情况连续出现三次或以上时,系统会向受影响的用户发送通知。
页面提供了当前可用 APC 的概览。
APC 可以按 、、、 和 进行筛选。
如果选择了特定的 APC:
-
编辑
打开所选 APC 进行编辑。
-
复制
复制所选 APC。
-
触发显示器
手动检查原文文件是否有更新,并更新 的日期和时间。
-
强制导入
从所选 APC 监控的 Remote 文件夹导入所有文件,跳过更改检测。
启用强制导入后,所有符合文件夹筛选条件的文件都将被视为已更改,无论其存储的历史记录如何。这对于在配置更改后或需要重新导入时重新处理文件非常有用。
-
选择性强制导入
选择要从受监控文件夹中导入的文件。仅选定的文件绕过更改检测。文件夹中的其余文件不受影响,并将在下一次计划的检测运行中正常评估。
-
-
删除
连接到可用项目的 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 自动化翻译流程的一种使用场景。以下示例总结了需要遵循的步骤:
-
在所需的在线存储库中创建一个文件夹,用于存储原文内容。
在此示例中,法语原文文件被添加到了 Google Drive 文件夹中。
-
设置 APC 监控选项,以监控所需在线存储库中的内容更新。
-
设置 APC 以创建项目,并指定所需的原文语言和选定的枢纽语言作为译文语言。
在此示例中,APC 被设置为创建一个以法语为原文语言、以英语为枢纽译文语言的项目。
-
配置 APC 导出设置,将译文内容导出到同一在线存储库中相应的译文语言文件夹内。
在此示例中,APC 被设置为将英语译文导出到同一 Google Drive 上的译文文件夹中。
-
项目完成后,导出操作会触发 APC 创建另一个项目,用于将内容从枢纽语言翻译为所需的译文语言。
在此示例中,导出操作会触发 APC 创建另一个项目,用于将内容从英语翻译为德语。