Contentful (TMS)

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

可用于

商业和企业计划（不适用于LSP计划）

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

包含在

Enterprise 套餐（原）

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

提示

有关Phrase Strings中Contentful集成的信息，请参阅Contentful (Strings)。

Contentful提供无头内容管理基础设施，以创建、管理和分发内容到任何平台或设备。Phrase通过两种方式与Contentful集成：

通过专用的Contentful连接器（2.0，入门级，字段级）

Contentful 2.0连接器目前仅支持通过美国数据中心进行身份验证。
通过Contentful市场插件以获得定制体验

注释

该连接器不支持JSON对象的翻译。

支持的本地化方法

Contentful支持多种本地化方法。请参见Contentful文档以获取详细描述。

Contentful 2.0连接器是当前和首选的集成，支持字段级本地化。它还提供：

多个空格
环境别名
预览URL设置
参考导入
基于标签的内容过滤
实时预览配置

入门级本地化（遗留）

使用Contentful (入门级)连接器。

入门级连接器仅适用于具有本地化参考字段的内容类型（例如，启用本地化的名为本地化的参考字段）。

字段级本地化（遗留）

使用Contentful（字段级）连接器。

字段级连接器仅适用于具有可翻译字段的内容类型（例如，启用本地化的文本或富文本字段），并可选地支持媒体资产。它导入引用的条目及其可翻译字段（如果参考字段已本地化）。

注释

遗留连接器不再积极维护，但仍然可以使用。

用例

连接器有多种用例：

项目经理可以直接从在线存储库向项目添加文件。内容可以通过条目 ID 进行搜索。
设置提交者门户，以便提交者可以直接从在线存储库向请求添加文件。内容可以通过条目 ID 进行搜索。
使用自动项目创建（APC），当检测到监控文档或文件夹的内容大小发生更改时，自动创建新项目。

应用程序的用例：

内容编辑者可以直接从 Contentful 提交条目以进行本地化。这使得内容编辑者或经理可以完全控制本地化流程，并在查看条目时实时获取状态更新。

一旦条目最终确定：
- 选择所需的目标语言进行本地化。
- 仅将选定语言的条目提交给 Phrase TMS，或使用字段选择选项卡选择字段。
  - 如果未选择任何字段，则所有可本地化字段将被提交进行翻译。
  - 如果选择了不可本地化字段，该字段仍将不会被提交进行翻译。仅提交可本地化字段。
  - 如果仅选择了一些可本地化字段，则仅这些字段将被提交进行翻译。
- 根据APC设置，作业会自动从提交的内容中创建。在APC运行期间，只有状态为已提交的条目会被选中以创建作业。
- 一旦从提交的条目创建了作业，状态会更改为进行中。当翻译被推送回Contentful时，状态会更改为已完成。
- 之前翻译的条目在原始内容更改后可以重新提交。
内容编辑者可以使用Phrase TMS主页来：
- 批量提交条目。
- 在批量提交时指定单个目标语言。
- 查看活动翻译作业的概览。

Contentful设置

在使用Phrase TMS应用程序时：

从市场下载Phrase TMS应用程序。
将应用程序安装到当前活动空间，并选择需要安装应用程序的内容模型。
输入在Phrase TMS中创建连接器时获得的Phrase TMS认证令牌。
点击安装。

可选 - 启动应用程序（Contentful已弃用）

如果通过Contentful的启动应用程序使用工作流支持，请按照以下步骤操作：

将Contentful的启动应用程序安装到一个或多个空间。

注释

每个空间只能创建一个工作流。如果在一个Contentful空间内需要不同的内容类型处理方式，请联系专门的客户成功经理。
设置所需的本地化工作流。
选择遵循所描述工作流的内容类型。

如果连接器中的工作流已设置，当监控的文章或内容类型的工作流步骤发生更改时，自动项目创建（APC）将自动创建新项目。

已提交的作业可以被取消，允许在进行更改后重新提交内容。这些作业仍将存在于Phrase中，需要由项目经理删除。

Phrase TMS设置（Contentful 2.0）

注释

Contentful启动应用程序在2.0连接器中不受支持。

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

连接器页面打开。
点击新连接器。

创建连接器页面打开。
将类型更改为Contentful 2.0。
为连接器提供一个名称。
点击连接到Contentful 2.0。

Contentful登录窗口打开。
提供登录详细信息并点击登录（或使用其他登录方法）。登录窗口关闭，显示已连接。
如果将连接器与应用程序一起使用，可以选择Phrase Contentful应用程序复选框。
1. 点击生成令牌。
  
  生成Contentful令牌窗口打开。
2. 点击生成令牌。
  
  生成一个令牌，应复制到剪贴板或文本文件中。确保在关闭窗口之前复制令牌，因为它将不再可见。此令牌将在连接到应用程序时使用。
3. 关闭窗口，显示生成的令牌。
如果使用Contentful 标签来识别可译内容，请输入标签ID并按回车。

ID已显示，可以添加更多。
- 选择列表策略
  - 包含所有标记
    
    显示Contentful中的内容，列出所有标签。
  - 包含至少 1 个标记
    
    显示Contentful中的内容，至少包含列出的一个标签。
如有需要，选择包含资产。
如有需要，选择包含引用条目（嵌套内容）。

显示引用条目设置。应用所需的过滤器，以更细致地控制系统如何遍历内容关系。
- 为链接条目设置导入深度
  
  限制短语在导入期间跟随引用条目的深度。
  
  默认值为10,000。如有需要，选择其他值或指定自定义整数值。
- 内容类型
  
  选择是否在或跟随内容类型与指定列表匹配的条目。
- 父内容类型
  
  排除父内容类型与指定列表匹配的条目。
- 标记
  
  选择是否在或跟随具有任何指定内容标签的条目。
- 字段 ID
  
  选择是否在或跟随由指定字段ID引用的条目。
如有需要，选择包含分类法。

显示Contentful 组织ID字段。输入一个值以启用分类设置。
- 当选择时，连接器从Contentful获取分类并将其包含在.XLIFF文件中。上下文注释窗格的CAT编辑器将列出每个段落的Contentful分类值。
- 如果分类元数据不可用或连接器未配置，则上下文注释窗格将被省略。
- 如果项目不需要功能/屏幕上下文，建议将分类设置为禁用，以优化.XLIFF导出时的性能。
如有需要，请选择跟随别名。

别名用于所有APC监控和工作重新导入/导出。如果将来更改别名目标，APC将监控新目标中的内容，工作将从新别名目标重新导入/导出。
- 禁用（默认和推荐）
  
  APC和创建的工作与创建工作/APC时别名指向的环境相关联。APC仅监控该环境和内容；工作被导出并重新导入到其中。
- 已启用
  
  APC和创建的工作与别名本身相关联。APC仅监控该别名和内容；工作被导出并重新导入到其中。
  
  如果更改别名目标，APC将监控新的别名目标（环境）；工作现在将导出并重新导入到其中。
如有需要，请提供预览URL。

这是指向Contentful渲染内容的URL模板。支持以下占位符：
- {env_id}：Environment ID
- {entry.id}：Entry ID
- {space_id}:Space ID
URL模板可能看起来像这样：

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}

注释

该URL必须指向一个已部署的应用程序，该应用程序渲染Contentful内容。要使用实时预览，请在 URL 模板中将 contentfulapp.tld 替换为应用程序的实际域名。

有关设置内容预览的更多信息，请参阅 Contentful 文档。

当前不支持将区域设为占位符。要在 URL 中使用区域，请指定固定值并创建多个连接器实例。
如有必要，请提供应从导入到 Phrase 中省略的 ContentIDs。
提供空间 ID 和令牌以获取空间预览令牌映射（必需）。

预览 API 需要一个名为内容预览 API – 访问令牌的 Contentful 访问令牌，该令牌应在 Contentful 空间的 API 设置中配置。

Contentful 2.0 集成使用此 API 导入内容并监控更改 (APC)。
- 选择每个空间和环境以监控/从 Contentful 导入。
- 设置和访问在 Contentful 内部管理。
点击保存。

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

Phrase TMS 设置

重要

如果从自定义域访问（例如 mydomain.phrase.jp），请打开一个隐身浏览器窗口，并通过 cloud.memsource.com 或 us.cloud.memsource.com 登录，以应用创建或保存连接器所需的身份验证。保存后，可以通过自定义域访问连接器。

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

连接器页面打开。
点击新连接器。

创建连接器页面打开。
将类型更改为要么 Contentful（条目级） 还是 Contentful（字段级） 并为连接器提供一个名称。
如果将连接器与应用程序一起使用，可以选择Phrase Contentful应用程序复选框。
- Contentful 应用令牌
  
  生成一个应用令牌以输入到 Phrase TMS Contentful 应用中。生成令牌并将其复制到 Contentful 应用中后，请保存连接器。
注释

保存后，令牌不能从 Contentful 内部更改。要更新它，请从 Phrase TMS 中的连接器配置中撤销令牌并生成一个新令牌。
配置与语言无关的设置。
- 源语言
  
  选择源语言以覆盖 Contentful 默认语言。然后，连接器将从连接器配置中设置的语言中提取内容。
  
  示例：
  
  如果在Contentful中将EN-US设置为默认语言，但在特定空间或内容模型中需要DE-DE作为本地化的源语言，则可以调整配置，使空间（远程文件夹）从DE-DE而不是EN-US提取内容。
注释

在使用该应用程序时不适用。
选择如何通过条目导入模式处理嵌套内容。内容可以使用引用字段引用其他内容，从而创建实体的层次结构。

注释

在使用该应用程序时不适用。
- Contentful（条目级）
  
  条目级连接器会自动遍历整个嵌套内容的层次结构。
- Contentful（字段级）
  
  选择字段级连接器应如何导入嵌套内容。
  - 仅选定条目
    
    从存储库中添加时明确选择的内容将被导入。
    
    APC检测到的更改将被导入以进行翻译。
  - 导入引用的条目
    
    连接器遍历整个嵌套内容的层次结构，并导入所有可翻译字段以进行翻译。
在省略可翻译字段中创建一个以逗号分隔的列表，以省略在导入到Phrase TMS时检查的启用此字段的本地化的字段。使用以下结构：contentTypeID:fieldID。
- 如果列出的字段应留空，请选择将省略的字段留空。此设置将应用于所有列出的条目。
- 如果列出的字段应包含源值，请选择复制源到目标。此设置将应用于所有列出的条目。
如果源语言中特定字段缺少数据，请选择使用后备语言。

如果需要，从下拉列表中选择一个源语言后备。在缺少数据的情况下，将使用此语言区域。

注释

Contentful的后备语言与此设置之间没有关系。
如有需要，请提供实时预览URL（测试版）。

这是指向Contentful渲染内容的URL模板。支持以下占位符：
- {env_id}：Environment ID
- {entry.sys.id}：Entry ID
- {space_id}:Space ID
URL模板可能看起来像这样：

https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}

注释

该URL必须指向一个已部署的应用程序，该应用程序渲染Contentful内容。要使用实时预览，请在 URL 模板中将 contentfulapp.tld 替换为应用程序的实际域名。

有关设置内容预览的更多信息，请参阅 Contentful 文档。

当前不支持将区域设为占位符。要在 URL 中使用区域，请指定固定值并创建多个连接器实例。
如果技术支持团队要求记录调试信息，请选择记录调试信息。
点击连接到Contentful。

如果连接成功，连接器设置中将出现一个勾号。否则将出现红色感叹号。将鼠标悬停在图标上可查看更多详细信息。
仅限Contentful（入门级）：

设置源语言。

注释

该语言应与在Contentful的区域设置中配置的Contentful空间的默认区域匹配。
点击保存。

连接器添加到了连接器页面的列表中。
可选，编辑连接器以选择Contentful工作流。
- 从：
  
  连接器监视选定阶段（例如翻译阶段）中的文章。作者可以在文章准备好进行翻译时将此标签应用于文章。
从Contentful导入时：
- 将源语文章设置为
  
  当源文章被下载时，连接器将工作流推进到所选阶段（例如，翻译进行中）。
导出到Contentful时：
- 将源语文章设置为
  
  当翻译被导出时，连接器将源文章的工作流阶段设置为所选阶段（例如，翻译完成）。
注释

Contentful于2023年6月1日停止支持工作流。继续使用不被支持。