Phrase Strings 连接器 (Job Sync)

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

Phrase Strings 集成（在 Strings 界面中称为 Job Sync）连接了 Phrase TMS 和 Phrase Strings。该集成支持工作级和项目级同步。

工作同步

在 Strings 中创建和开始的工作若状态为 进行中，可导入 TMS 进行翻译，并在翻译完成后发回 Strings。默认情况下，从 Strings 发送到 TMS 的工作将作为 XLIFF 2.0 文件导入。

推荐用于具有精细控制的批量工作流。
项目级同步

所选 Strings 项目中的所有键都会传输到 TMS，无需创建工作。新添加或更新的键会自动可供同步。

推荐用于持续本地化工作流。

先决条件

用户需要 TMS 和 Strings 应用程序的访问权限
TMS 项目中使用的语言代码必须与 Strings 工作中的区域代码匹配。
Strings 项目的默认语言必须与 TMS 项目中定义的原文语言相同。

重要

Figma 文件可以在 Strings 中显示为完整的实时文件，但在 TMS 中不受支持。TMS CAT Editor 只能以 SVG 格式显示特定 Figma 框架中的译文内容。

不支持 Strings 键翻译状态。在导入 TMS 之前在 Strings 中标记为未验证的键，如果译文未更改，则可以作为已验证返回到 Strings。

导入 Strings 工作后在 TMS 中创建的工作句段数在以下情况下可能与原始键数不同：

Strings 将键标记为已排除，导致已排除的键未导入。
在 TMS 中创建工作时，已在 XLIFF 2.0 的文件导入设置中启用了句段 XLIFF 选项。在这种情况下，句段数可能大于 Strings 中的键数。

Strings 键可以包含 HTML 实体。在 TMS 中设置连接器时，启用在 CDATA 中包含 HTML 内容的选项以保留 HTML 实体，而不仅是在 TMS 中显示相应字符。

Strings 键原文中存在的首尾空格不会在 TMS CAT Editor 中显示。这些空格会保留在骨架中，并在工作同步回 Strings 时重新插入到原文和译文中。这可能会影响在 Strings 中配置的字符限制验证，因为在翻译过程中，空间计数不会反映在 TMS 编辑器中。

使用连接器，可以用 APC 监控多个项目和文件。每个项目都需要使用一个 APC 中单独监控。

该连接器使用工作区域注释将有关相应 Phrase TMS 项目的元数据附加到 Strings 工作和工作区域。用于列出工作区域注释的 Phrase Strings API 端点会检索此元数据。当 include_annotations 参数设置为 true 时，用于列出工作译文区域的端点也会包含此元数据。带注释的工作包含诸如 tms_project_id 和 tms_in_progress 之类的字段，这些字段允许在链接的 Phrase TMS 项目中跟踪 Strings 工作的状态。

ICU 信息和 CLDR 复数形式

将包含 ICU 信息或复数形式的 Strings 工作发送到 TMS 进行翻译时，在 XLIFF 2.0 文件导入设置或 TMS 项目模板中启用解析 ICU 信息选项。

用例

连接器有多种用例：

TMS 项目经理可以直接在 TMS 系统中添加线上存储库中的文档。
设置 Phrase TMS 提交页面，允许提交者直接从 Phrase Strings 添加文件请求翻译。
使用 TMS 自动项目创建 (APC)，当检测到监控的文件或文件夹的最后修改日期发生更改时，自动创建新项目。
- 对于工作级和项目级同步，监控的项目路径必须一直选择到工作文件夹（例如 空间/项目/main/工作）。
- 对于 Job Syncs，APC 由以下工作更新触发：
  - 添加键或更改现有键
  - Strings 中修改工作的截止日期
  注释
  
  工作重新打开不算 APC 监控的更新。
- 对于项目级同步，APC 由以下内容触发：
  - 新添加的键
  - 对现有键的更改
- 如果在设置 APC 时选择创建一个新项目，远程线上存储库不仅可以监控原文，还可以监控译文更新。
  
  如果选择监控译文更新，在线上存储库中对译文副本所做的任何更改都将自动更新 Phrase TMS 中的翻译记忆库库。
- 如果选择了翻译记忆库将自动保存远程更新的译文，则在相关 APC 项目使用的 TMS 翻译记忆库中自动更新 Strings 译文的键文本更改。
TMS 连接器 API 可用于自动化用户界面手动执行的步骤。Webhook 可用于向第三方系统发送（如工作状态更改等事件）。

Job Syncs 页面

Job Syncs 页面提供了使用 Phrase Strings 连接器的所有工作同步设置 (APC) 的集中视图。它包括直接在 Strings 中创建的同步以及在 TMS 中配置的同步，并包含相关信息。

在 Job Syncs 页面中，Strings 中的管理员和项目经理用户可以配置新的工作同步、编辑现有工作同步（包括其可用的/不可用的状态）或删除它们。

可以通过使用更多 More Menu 菜单中的相关选项来编辑或删除现有工作同步。所有更改都会在 Strings 和 TMS 之间同步。删除工作同步会移除 TMS 中相应的 APC。

Job Syncs 页面可从集成和工作左侧导航菜单访问。

在 Strings 中配置工作同步

注释

如果 TMS 中定义了必需的自定义字段，则不支持从 Strings 设置工作同步。

若要设置 Strings 与 TMS 之间具有基本配置的新 Job Sync，请在 Strings UI 中执行以下步骤：

在集成页面中，选择配置，位于 Job Sync<3> 集成旁边。

显示 Job Syncs 页面。
单击 + 新建 Job Sync。

显示创建新 Job Sync 窗口。
提供同步名称，并从分配的 Strings 项目下拉菜单中选择要连接到 TMS 的 Strings 项目。

只能包含具有相同语言组合的项目。
（可选）选择要使用的 TMS 项目模板。所选的 TMS 项目模板必须与分配的 Strings 项目中定义的语言集匹配。

同步的工作将添加到从所选模板创建的 TMS 项目中。
- 如果选择默认，则会根据所选的 Strings 项目自动创建 TMS 项目模板。
选择要在 TMS 中创建的项目类型。
- 连续项目
  
  默认选项。
- 新项目
  
  每当在 Strings 工作中检测到更改时，都会创建一个新的 TMS 项目。
在导出回 Strings<1> 部分，指定 Strings 导出设置，以控制如何将 TMS 中的译文导出回 Strings。
- 覆盖现有译文
  
  更新 Strings 中现有的译文。
- 标记工作为已完成
  
  自动将 Strings 中的工作标记为已完成。
- 验证 Strings 中的未更改翻译
  
  如果译文未更改，标记为 未验证 的键将在 Strings 中自动变为已验证。
如果需要，单击高级选项以显示其他导出选项。
- 将区域标记为已完成
  
  一旦译文同步回传，即标记特定区域为已完成。
- 创建新键并更新现有键
  
  确保从 TMS 获取的新键在 Strings 中创建，并更新现有键。
- 仅在原文与存储版本相符时才应用译文
  
  防止在导出后 Strings 中的原文发生更改时覆盖译文。
点击保存。

新的 Job Sync 配置将以不可用状态添加到TMS Job Syncs列表。使用可用的列下的开关来启用 Job Sync。

提示

如需更高级的配置，请使用 Phrase TMS 设置来设置连接器。

Phrase TMS 设置

在设置页面，下拉到集成部分。
单击连接器。

连接器页面打开。
点击创建连接器。

创建连接器页面随即打开。
将类型更改为Phrase Strings并为连接器提供名称。
输入从 Strings 获取的账户 ID 和访问令牌。
单击测试连接。
- 如果成功，测试连接按钮旁边会出现一个小勾号。
选择要导入到 TMS 的项目。

如果未导入译文字符串，且在 XLIFF 2.0 文件的文件导入设置中选择了句段 XLIFF，则可以进一步切分 XLIFF 2.0 文件。
- 根据需要启用或禁用高级导入选项：
  - 在导入时使用 TMS 项目的源语言
    
    无论 Strings 项目中的默认语言为何，均应用 TMS 项目的原文语言。
  - 为每个语言创建一个 TMS 工作
    
    启用此选项可防止为已在进程中的区域创建重复的 TMS 工作。建议用于需要更精细控制的多语言工作。
  - 将 HTML 内容包装在 CDATA 中
    
    该选项确保 HTML 实体被包装在 CDATA 中，以便在 Strings 和 TMS 之间的传输过程中保留。
    
    该选项允许导入结合了 ICU 语法和内联 HTML 元素的内容。
选择导出模式。
- 根据需要启用或禁用以下导出选项：
  - 覆盖译文
    
    禁用此项可防止现有译文被文件内容更新。
  - 创建新的键或更新键
    
    禁用此项可防止创建新键以及更新现有键。
  - 仅当原文匹配时才应用译文
    
    与最新原文内容不一致的译文将在同步过程中被排除。这有助于保持原文和译文之间的一致性，避免过时或不正确的译文。
  - 仅当原文未修改时才验证
    
    如果目标译文未更改，标记为未验证的键将在Strings中自动标记为已验证。
  - 将语言标记为已完成
    
    一旦译文同步回传，即标记特定区域为已完成。
  - 标记工作为已完成
    
    如果选择了此项，只有当最后一个区域上传时，工作才会标记为已完成。
如果指定了，请选择一个默认文件夹（仅在保存后才可操作）。
提供了语言映射，如果需要可以自定义。语言映射更改不会影响现有工作。

该列表一次分页显示五个项目，项目按字母顺序排序；首先是A-Z（大写），然后是a-z（小写）。
点击保存。

连接器添加到了连接器页面的列表中。

支持的集成：

TMS 项目模板
TMS 工作流
工作简介（使用项目级别同步时不适用）
工作截止日期（使用项目级别同步时不适用）

TMS 的项目截止日期根据 Strings 中设置的截止日期而定。如果有多个不同的截止日期，则将至今最远的截止日期应用于 TMS 项目。

从 Strings 到 TMS 传输项目参考：

键名称

从 Strings 传输，并在 TMS CAT Editor 上下文注释窗口中显示为上下文键。

键描述

从 Strings 传输，并在 TMS CAT Editor 的上下文注释窗口中显示为上下文注释。

键字符最大长度

从 Strings 传输，并在 TMS CAT Editor 的上下文注释窗口中显示。

截图

要在TMS CAT Editor的上下文注释窗格中显示来自Strings的截图：
- 在TMS项目设置的访问和安全部分下，启用允许在Phrase CAT Editor中加载外部内容选项。
- 在上下文注释窗格中选择富文本格式。
支持的文件格式的自定义元数据：
- .XLSX
- .CSV
- .XLIFF 2.0

通过 APC 监控 Strings 中的译文更新

要通过 APC 监控 Strings 中的译文更新，参照以下步骤：

设置 APC 时，选择创建一个新项目。

这样可以监控线上存储库中是否有 Strings 中的译文更新。
在 APC 设置的自动化部分，选择翻译记忆库将自动保存远程更新的译文。

触发 APC 监控后，对 Strings 中译文内容的更改将自动保存到 Phrase TMS 翻译记忆库。

通过修改 Phrase TMS 编辑器中的译文句段，可以覆盖翻译记忆库更新。这些更新将在 Phrase TMS 工作完成后导回 Strings。

使用APC时的键删除行为

在Strings中删除一个已包含在工作中的键，不会影响通过一次性手动导入创建的Phrase TMS工作。该工作保持不变，直到手动重新导入。

当APC监控处于可用的状态时，Phrase会在每次轮询或webhook触发时比较内容哈希，并将任何更改（包括键删除）视为触发重新同步的更新。

在连续项目模式下，重新同步会更新现有的Phrase TMS项目或工作以匹配Strings中的当前内容，因此已删除键的内容会从该工作中移除。
在每次创建新项目模式下，重新同步会创建一个反映删除后内容的新Phrase TMS工作版本，而之前创建的工作版本保持不变。

Job Sync 故障排除

下表概述了用户在使用 Strings 集成时可能遇到的常见问题，并提供了可能导致故障的原因和解决方案。

问题	原因	解决方案
TMS 工作中与 `神经网络令牌 (NMTOKEN)` 相关的警告信息	键名称包含不支持的字符（例如空格）	尽管出现警告信息，用户仍然可以处理翻译内容并将其导回 Strings。
TMS 中的键为空	工作中包含没有相应源语言原文的键	可以：略过句段。或从 Strings 工作移除这些键，并从线上存储库重新导入原文。
APC 未创建项目/处理新工作	语言代码不匹配	确保 Strings 中的语言代码与 TMS 项目中的语言代码匹配。将 APC 设置为连续项目时，项目创建后对项目模板所做的任何更改都将不适用于现有项目。因此，必须直接对连续项目进行更改。
	APC 认为工作/区域已处理	如果在开始工作后修改了项目模板 / APC 设置，则可能在 APC 历史记录中被视为已处理。因此，可能需要更新工作才能使其符合下一个迭代的条件。可以：为工作添加新键，或更新工作中现有的键或在 Strings 中更改工作的截止日期
	`429 请过多`错误（Strings API 限制）	减少 APC 数量，降低监控频率。
Strings项目中的现有键在TMS工作中缺失	特定的键未添加到Strings工作中	将键添加到Strings工作，并从TMS中的在线存储库重新导入工作
尝试导入/导出工作时出现“无法验证身份”错误。	自动创建的“created by Phrase Strings”连接器上的访问令牌已过期或被撤销	在 TMS 中创建一个新的 Phrase Strings 连接器，将现有的 APC 重新链接到新连接器，并触发监控。
已完成的 Phrase TMS 工作未能将其翻译同步回 Phrase Strings。尽管 Phrase TMS 报告工作已完成，但 Phrase Strings 中受影响的区域设置仍显示单词为未翻译。	已完成工作的翻译未能正确同步回 Phrase Strings 中受影响的区域设置。	在 Strings 中，重新打开该工作，然后将受影响的区域设置标记为未完成。在 TMS 中，选择该工作并点击 Reimport from online repository。从 TMS 重新触发受影响区域设置的导出。