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 中显示相应字符。

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

ICU 信息和 CLDR 复数形式

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

用例

连接器有多种用例：

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

Job Syncs 页面

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

在 Job Syncs 页面中，Strings 中的管理员和项目经理用户可以 configure new job syncs、编辑现有 Job Sync（包括其可用的/不可用的状态）或删除它们。

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

Job Syncs 页面可通过左侧导航菜单中的 Integrations 和 Jobs 访问。

在 Strings 中配置 Job Syncs

注释

如果 TMS 中定义了必需的 custom fields，则不支持从 Strings 设置 Job Sync。

要通过基本配置在 Strings 和 TMS 之间设置新的 Job Sync，请在 Strings UI 中执行以下步骤：

在 Integrations 页面中，选择 Job Sync 集成旁边的 Configure。

显示 Job Syncs 页面。
点击 + New Job Sync。

显示 Create new Job Sync 窗口。
提供 Sync Name，并从 Assigned Strings projects 下拉菜单中选择要连接到 TMS 的 Strings 项目。

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

同步的工作将添加到从所选模板创建的 TMS 项目中。
- 如果选择了默认，则会根据所选的 Strings 项目自动创建 TMS 项目模板。
选择要在 TMS 中创建的项目类型。
- 连续项目
  
  默认选项。
- 新项目
  
  每次在 Strings 工作中检测到更改时，都会创建一个新的 TMS 项目。
在导出回 Strings 部分，指定 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 项目的源语言
    
    如果 TMS 项目未设置源语言，则使用 Strings 工作的源语言。
  - 为每个语言创建一个 TMS 工作
    
    启用此选项可防止为已在进程中的区域创建重复的 TMS 工作。建议用于需要更精细控制的多语言工作。
  - 将 HTML 内容包装在 CDATA 中
    
    该选项确保 HTML 实体被包装在 CDATA 中，以便在 Strings 和 TMS 之间的传输过程中保留。
    
    该选项允许导入结合了 ICU 语法和内联 HTML 元素的内容。
  - 略过 Strings 项目的默认区域
    
    根据 TMS 项目的源语言选择 TMS 工作的源语言，或回退到 Strings 工作的源语言。
选择导出模式。
- 根据需要启用或禁用以下导出设置：
  - 覆盖译文
    
    禁用以防止现有译文被文件内容更新。
  - 创建新的键或更新键
    
    禁用以防止创建新 Key 以及更新现有 Key。
  - 仅当原文匹配时才应用译文
    
    与最新原文内容不一致的译文将在同步过程中被排除。这有助于保持原文与译文之间的一致性，避免过时或错误的译文。
  - 仅当原文未修改时才验证
    
    如果译文未更改，标记为未验证的 Key 将在 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。

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 中的在线存储库重新导入工作
尝试导入/导出工作时出现“无法验证身份”错误。	自动创建的“由 Phrase Strings 创建”连接器上的访问令牌已过期或被撤销	在 TMS 中创建一个新的 Phrase Strings 连接器，将现有的 APC 重新链接到新连接器，并触发监视器。