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