Salesforce Knowledge 是一个在线内容管理系统,可帮助企业满足其营销、销售和商务需求。该连接器适用于 Salesforce Knowledge 的经典版和 Lightning 版。
项目的 源语言 必须与在 知识设置 中配置的 Salesforce Knowledge 默认 语言相匹配。Salesforce 中的 英语 实际上是 英语(美国) 完整区域设置。
该连接器导入所有具有字符串或文本区域数据类型的可更新字段。
该连接器符合最新的 Salesforce 安全要求:它支持 PKCE、刷新令牌轮换、30 天空闲令牌过期和 IP 白名单。
注意
自 2022 年 11 月 1 日起,该连接器支持 持续本地化 工作流程。如果使用这些工作流程,修改现有连接器将无法启用该功能,必须创建一个新的连接器。
该连接器有多种使用案例:
-
项目经理可以直接从在线存储库将文件添加到项目中。仅列出与连接器源语言匹配或未设置任何语言的文档。
-
设置 提交者门户,允许提交者直接从在线存储库将文件添加到请求中。仅列出与连接器源语言匹配或未设置任何语言的文档。
-
使用 自动项目创建 (APC),以便在检测到受监控文件或文件夹的 最后修改日期 发生更改时自动创建新项目。
翻译源文章
要允许文章作者手动触发翻译,请在 Salesforce Knowledge 中定义或创建特定字段。这些字段将由 Phrase 连接器用于触发和跟踪翻译工作流。根据需要使用现有字段或创建自定义字段。
必需的字段映射
为确保 Salesforce Knowledge 与 Phrase TMS 之间的正常通信,必须进行以下字段配置:
-
触发翻译请求
-
目的:
定义哪些文章应发送进行翻译。
-
设置:
创建或指定一个字段(例如
Workflow_stage__c),用于保存特定值(例如“Translate”)- 推荐类型:下拉列表。 -
连接器映射:
在 Phrase TMS 中,映射此字段以仅针对具有此指定值的文章触发翻译。
-
-
跟踪翻译进度
-
目的:
在翻译过程中自动更新文章的状态。
-
设置:
使用与上述相同的字段或创建一个单独的字段。
-
连接器映射:
配置 Phrase TMS,以便在翻译开始时将此字段的值设置为类似 的内容。
-
-
指示翻译完成
-
目的:
通知用户翻译已完成。
-
设置:
使用与上述相同的字段或创建一个单独的字段。
-
连接器映射:
一旦翻译被推送回 Salesforce,请将此字段的值设置为类似 的内容。
-
-
为自动项目创建 (APC) 定义目标语言
-
目的:
指定文章应翻译成的语言。
-
设置:
-
创建一个自定义字段(例如
Target_Languages__c)。 -
字段类型:
多选下拉列表。
-
值:
使用语言代码(例如
fr, de, es)作为 API 名称,而不是标签。
-
-
连接器映射:
Phrase TMS 会读取此字段,仅为所选语言创建作业。
-
重要
如果从自定义域(例如 mydomain.phrase.jp)访问,请打开隐身浏览器窗口并通过 cloud.memsource.com 或 us.cloud.memsource.com 登录,以应用创建或保存连接器所需的身份验证。保存后,即可通过自定义域访问该连接器。
-
从设置
页面,向下滚动到 部分。
-
点击 连接器。
页面随即打开。
-
点击 新建连接器。
页面随即打开。
-
将 类型 更改为 Salesforce Knowledge 并为连接器提供名称。
-
提供主机名称。
-
可选择根据 字段值 定义何时翻译文章。
-
可选择定义源文章中的一个字段,以便在首次导出翻译时将其更改为选定值(例如:翻译就绪)。
-
可选择定义翻译后的字段值。
-
选择翻译应具有的状态。
-
提供
自动项目创建 仅为自定义字段(由其字段名称标识,例如
Target_Languages__c)中指定的语言创建作业。 -
配置 ,将 Salesforce 的 2 位区域设置代码映射到 TMS 的 4 位区域设置代码。
-
点击 连接到 Salesforce。
如果连接成功,将出现一个勾选标记。如果连接失败,将出现一个红色感叹号。将鼠标悬停在图标上可查看更多详细信息。
-
点击 保存。
连接器已添加到 页面上的列表中。
删除连接器
要删除连接器:
注意
如果连接器仍链接到项目中的未完成作业(包括位于回收站中的作业),则无法删除该连接器。尝试删除此类连接器会返回 "Failed to delete connector" 错误。
解决方法:打开与该连接器关联的项目,并完成或删除所有剩余的作业。转到 ,并清空它以删除仍链接到该连接器的所有作业。重试删除连接器。
解决重新验证期间的常见 OAuth 错误
要重新验证连接器,请在 Phrase 中打开 Salesforce Knowledge 连接器设置,打开显示为 的连接器,然后重新授权 Salesforce 访问权限。
如果重新验证失败并出现错误 We can't authorize you because of an OAuth error 和代码 OAUTH_APPROVAL_ERROR_GENERIC,请稍后重试验证,因为这可能是暂时性问题。
如果重新验证失败并显示错误 invalid_client: app must be installed into org,则说明 Phrase Salesforce Knowledge Connector 已连接应用尚未安装到 Salesforce 组织中。要解决此问题,Salesforce 管理员必须:
-
在 Salesforce 设置中,转到 或 ,检查 Phrase Salesforce Knowledge Connector 是否显示为已安装。
-
如果未显示,请通过 或通过该应用的安装 URL 进行安装。
-
验证已连接应用的 OAuth 策略 未设置为 "Admin approved users are pre-authorized",且未分配相关用户的配置文件或权限集,因为这也会产生相同的错误。
-
在 Phrase 中重试重新认证。
Salesforce 管理员需要足够的权限来安装已连接应用。如果在安装过程中出现权限问题,可能需要在 Salesforce 组织内部进行升级。