集成 Salesforce
与 Salesforce 集成，随时随地访问潜在客户、客户、商机、案例和合同。
使用以下过程启用 Salesforce 集成。确保满足必备条件，然后设置 Salesforce 集成。完成此过程后，您的现有审核日志记录级别将持续存在，包括使用 Citrix 微应用执行的任何操作。
有关现成的 Salesforce 微应用的完整列表，请参阅使用 Salesforce 微应用。
检查必备项
在 Salesforce 中设置此集成后，您需要以下工件才能在 Citrix Workspace 微应用中添加集成：
- 用户名
- 密码
- 安全令牌
对于 OAuth 2.0：
- 使用者密钥
- 消费者秘密
- OAuth 授权基础网址
注意：
我们建议您始终使用 OAuth 2.0 作为服务身份验证方法（如果可用）。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。
集成需要对您的 Salesforce 实例进行定期 API 访问，因此我们建议您在 Salesforce 中创建一个专用的用户帐户。然后使用该帐户配置 Salesforce 集成。此帐户必须：
- 获得完整的数据访问权限
- 启用 API
- 不允许双因素身份验证。
使用专用帐户对于审核日志非常有用，因为它有助于区分通过 Workspace 完成的活动。本页面包含有关 Salesforce 经典版和 Salesforce 闪电体验的教程。这两个教程都假定您是 Salesforce 中的系统管理员。
注意：
Salesforce“联系人”和“组”版本不支持任何 API。“专业”版本不会自动包含它。但是，可以根据要求激活支持。
此外，在 Salesforce 中，API 请求的数量也受到限制。如果计划频繁同步大量数据，请参阅销售团队 API 请求限制和分配。
- 将 Citrix Gateway 配置为支持 Salesforce 的单点登录，以便在用户登录后，他们将自动重新登录，而无需再次输入凭据。请按照 销售团队单点登录配置 中的说明进行操作。有关配置 SSO 的详细信息，请参阅Citrix Gateway 服务。
添加新配置文件
请按照以下步骤进行操作：
- 登录到 www.salesforce.com
- 转到设置图标，然后选择设置 > 管理 > 管理用户 > 配置文件 > 新建配置文件。
- 将现有配置文件设置为系统管理员，以确保为此配置文件创建的用户具有完全的数据访问权限。
-
输入配置文件名称，然后选择保存。我们建议将配置文件命名为类似于 Citrix Workspace Access，以便在以下过程中将配置文件添加为新用户时参考。
将打开“配置式”面板，其中包含新配置式。
为创建的配置文件启用 API 访问
- 在配置文件面板上，选择编辑。
- 向下滚动到管理权限，然后选中已启用 API 复选框。
-
（可选）若要禁用密码过期，请选中密码永不过期复选框。
注意：
使用此选项是一个潜在的安全漏洞。
- 选择保存。
添加回调 URL
向您的实例配置添加自定义 URL，以授予对私有数据的访问权限并启用OAuth 身份验证的用户操作。列出的第一个回调不会更改。第二个回调取决于目标应用程序，并且可以在创建集成时在 URL 地址栏中找到。{yourmicroappserverurl} 部分由租户部分、区域部分和环境部分组成：https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com。
- 以管理员身份登录到 Salesforce。
- 导航到平台工具 > 应用程序 > 应用程序管理器。
- 选择新连接的应用程序。
- 在基本信息下，填写以下字段：
- 连接的应用名称
- API 名称
- 联系电子邮件
- 在 API 下，选中启用 OAuth 设置复选框。
-
在回调 URL 字段中，将以下授权的重定向 URL 添加到您的微应用服务器 URL 中：
https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.salesforce.SalesforceService/auth/serverContexthttps://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
- 在选定的 OAuth 作用域旁边，在可用的 OAuth 作用域下选择以下作用域，然后选择添加将其移动到选定的 OAuth 作用域字段：
- 访问和管理您的数据（api）
- 访问您的基本信息（ID、个人资料、电子邮件、地址、电话）
- 随时代表您执行请求（refresh_token、offline_access）
- 选择保存。
（可选）限制登录 IP 范围
如果您的组织为“用户配置文件”设置了 IP 范围，则可以在用户级别控制登录访问。在用户配置文件上指定允许的 IP 地址范围。有关详细信息，请参阅在增强型配置文件用户界面中限制登录 IP 范围。
如果限制登录 IP 范围，则无需在以下过程中生成安全令牌。
添加新用户
创建用于连接到 Salesforce 的专用用户帐户。使用您在上一过程 添加新配置文件 中添加的新配置文件。
请按照以下步骤进行操作：
- 转到设置 > 管理 > 管理用户 > 用户 > 新用户。
- 以红色填写必填字段。
- 将用户许可证设置为 Salesforce。
- 将配置文件设置为您在上一步骤中添加的配置文件。在上面的示例中，我们建议 Citrix Workspace 访问，以便在添加配置文件时进行参考。
- 单击保存。
设置新用户
添加专用用户帐户后，您会收到您提供的地址的电子邮件。
请按照以下步骤进行操作：
- 找到电子邮件，然后按照说明单击链接。
- 登录到 Salesforce。
- 设置密码和密码问题。
生成安全令牌
如果您限制了专用用户配置文件的登录 IP 范围，则可跳过此步骤。从白名单的 IP 块连接到 Salesforce API 的帐户不需要安全令牌。
请按照以下步骤进行操作：
- 登录并选择帐户名称。
- 前往我的设置 > 个人 > 重置我的安全令牌。
-
选择重置安全令牌。
新的安全令牌将发送到您在此帐户的个人设置中提供的电子邮件地址。每当重置此帐户的密码时，您也会获得一个新的安全令牌。
现在，您可以完成添加集成。在 Salesforce 服务定义的输入字段中输入专用用户帐户的用户名和密码。
如果您已列入白名单，则无需输入保安编码器。否则，请粘贴已发送到专用帐户的电子邮件框中的保安编码器。
筛选查询
大多数 Salesforce 实体都支持过滤。在预定义查询之间进行选择，或者使用 Salesforce SOQL 语言编写自己的自定义查询。有关详细信息，请参阅Salesforce 对象查询语言文档。
将集成添加到 Citrix Workspace 微应用
将 Salesforce 集成添加到 Citrix Workspace 微应用以连接到您的应用程序。这样可以提供现成的微应用，以及可以在 Workspace 内使用的预配置通知和操作。
请按照以下步骤进行操作：
-
从概览页面中，选择开始。
此时将打开“管理集成”页面。
- 选择添加新集成，然后选择从 Citrix 提供的模板中添加新集成。
- 选择 Salesforce 磁贴。
-
输入集成的名称。
- 输入您在前面的过程中收集的 服务身份验证 。
- 为您的目标系统服务身份验证输入您的用户名和密码凭据。
- 为 身份验证方法 选择 OAuth 2.0。
- 输入您在必备条件过程中收集的使用者密钥和使用者密码。
- 输入您的 OAuth 授权基础网址。允许您为 Salesforce 实例配置自定义 SSO 登录页面。输入您的域。这与您通常登录的 SFDC URL 相同，并且需要安全的 HTTPS。例如
https://{your_domain}/services/oauth2/authorize。
- 输入连 接器参数。
- 输入您的安全编码器。
- 如果您需要将数据加载到沙盒环境中，请切换沙盒。
- 保留开关在增量同步期间查询已删除的记录，以便将其从缓存中删除处于启用状态。如果系统在第一次增量同步后抛出以下错误：无法加载类型的已删除实体，您可以禁用此切换以解决此问题。
- 选择添加。
微应用集成页面将打开，其中包含您添加的集成及其微应用。在这里，您可以添加另一个集成，继续设置现成的微应用，或者为此集成创建一个新的微应用。
现在，您可以设置和运行第一个数据同步。由于可以将大量数据从集成应用程序提取到 微应用平台，因此我们建议您使用表页面筛选第一次数据同步的实体，以加快同步速度。有关详细信息，请参阅验证所需实体。有关同步规则、不符合其计划的同步以及否决规则的完整信息，请参阅 同步数据。
有关 API 端点和表实体的更多详细信息，请参阅Salesforce 连接器规格。
使用 Salesforce 微应用
现有的应用程序集成带有现成的微应用。从这些微应用开始，并根据您的需求定制它们。
我们的 Salesforce 集成带有以下预配置的现成微应用：
帐户： 搜索、查看和编辑帐户。
| 通知或页面 | 用例工作流 |
|---|---|
| 分配给您的帐户（现有）通知 | 当帐户的所有者发生变化时，新所有者会收到通知。 |
| 分配给您的帐户（新）通知 | 将新帐户分配给用户时，他们会收到通知。 |
| 帐户详情页面 | 提供帐户视图，其中包括联系人和联系人详细信息链接。 |
| 联系人详情页面 | 提供包含详细信息的联系人的只读视图。 |
| 编辑帐户页面 | 提供向帐户提交编辑内容的表单。 |
| “我的帐户”页面 | 提供个性化的帐户列表。 |
案例： 搜索、查看和编辑分配给您的案例。
| 通知或页面 | 用例工作流 |
|---|---|
| 分配给您的问题（现有）通知 | 当案例的所有者发生变化时，新所有者将收到通知。 |
| 分配给您的问题（新）通知 | 将新案例分配给用户时，他们会收到通知。 |
| 与您的帐户通知相关的新问题 | 创建与用户帐户相关的新案例时，他们会收到通知。 |
| 帐户详情页面 | 提供帐户视图，其中包括联系人和联系人详细信息链接。 |
| 案例详情页面 | 提供案例视图和用于打开编辑页面的按钮。 |
| 联系人详情页面 | 提供包含详细信息的联系人的只读视图。 |
| “编辑案例”页 | 提供用于向案例提交编辑内容的表单。 |
| “我的未结案例”页面 | 提供分配给用户的个性化案例列表。 |
联系人： 搜索、查看和编辑联系人。
| 通知或页面 | 用例工作流 |
|---|---|
| 分配给您的联系人（现有）通知 | 当联系人的所有者发生更改时，新所有者将收到通知。 |
| 分配给您的联系人（新）通知 | 将新联系人分配给用户时，他们会收到通知。 |
| 联系人详情页面 | 提供联系人的视图和用于打开编辑页面的按钮。 |
| “编辑联系人”页 | 提供向联系人提交编辑内容的表单。 |
| “我的联系人”页 | 提供个性化的联系人列表。 |
合同： 搜索、查看和编辑合同。
| 通知或页面 | 用例工作流 |
|---|---|
| 合同已更新通知 | 当合同的详细信息发生更改时，合同所有者将收到通知。 |
| 即将到期的合同通知 | 当合同在其结束日期之前或之后超过定义的阈值（例如，默认情况下为 3 天）时，所有者会收到通知提醒。 |
| 新的激活合同通知 | 将新的待定合同激活审批请求分配给用户时，他们会收到通知。 |
| 帐户详情页面 | 提供帐户视图，其中包括联系人和联系人详细信息链接。 |
| 联系人详情页面 | 提供包含详细信息的联系人的只读视图。 |
| “合同详细信息”页面 | 提供合同视图和用于打开编辑页面和激活合同的按钮。 |
| “编辑合同”页 | 提供用于向合同提交编辑内容的表单。 |
| “我的合同待激活”页面 | 提供待激活的合同的个性化列表。 |
创建帐户： 创建一个新帐户。
| 通知或页面 | 用例工作流 |
|---|---|
| 创建帐户页面 | 提供用于提交新帐户的表单。 |
创建案例： 创建新案例。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建案例”页面 | 提供用于提交新案例的表单。 |
创建联系人： 创建新联系人。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建联系人”页 | 提供用于提交新联系人的表单。 |
创建合同： 创建新合同。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建合同”页 | 提供用于提交新合同的表单。 |
创建事件： 创建新事件。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建事件”页 | 提供用于提交新事件的表单。 |
创建销售线索： 创建新销售线索。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建潜在顾问”页 | 提供用于提交新潜在客户的表单。 |
创造商机： 创造新商机。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建商机”页 | 提供用于提交新业务商机的表单。 |
创建任务： 创建新任务。
| 通知或页面 | 用例工作流 |
|---|---|
| “创建任务”页 | 提供用于提交新任务的表单。 |
事件： 搜索、查看和编辑事件。
| 通知或页面 | 用例工作流 |
|---|---|
| 事件提醒通知 | 当事件在其活动日期和时间之前或之后（例如，默认情况下为 1 小时）超过定义阈值时，所有者会收到通知提醒。 |
| 帐户详情页面 | 提供帐户视图，其中包括联系人和联系人详细信息链接。 |
| 联系人详情页面 | 提供包含详细信息的联系人的只读视图。 |
| “编辑事件”页 | 提供用于向事件提交编辑内容的表单。 |
| “事件详细信息”页面 | 提供事件视图和用于打开编辑页面的按钮。 |
| “我的事件”页 | 提供个性化的事件列表。 |
销售线索： 搜索、查看、编辑和转换潜在客户。
| 通知或页面 | 用例工作流 |
|---|---|
| 分配给您的销售线索（现有）通知 | 当潜在客户的所有者发生更改时，新所有者将收到通知。 |
| 分配给您的销售线索（新建）通知 | 将新潜在客户分配给用户时，他们会收到通知。 |
| 转换潜在顾问页 | 提供用于转换潜在客户的表单。 |
| 编辑潜在顾问页 | 提供向潜在客户提交编辑内容的表单。 |
| “我的活动潜在客户”页面 | 提供个性化的潜在客户列表。 |
商机： 搜索、查看和编辑商机。
| 通知或页面 | 用例工作流 |
|---|---|
| 分配给您的商机（现有）通知 | 当商机的所有者发生更改时，新所有者将收到通知。 |
| 分配给您的商机（新）通知 | 向用户分配新商机时，他们会收到通知。 |
| 帐户详情页面 | 提供帐户视图，其中包括联系人和联系人详细信息链接。 |
| 联系人详情页面 | 提供包含详细信息的联系人的只读视图。 |
| “编辑商机”页 | 提供用于向业务商机提交编辑内容的表单。 |
| 我的开放商机页面 | 提供个性化的商机列表。 |
| 业务商机详细信息页面 | 提供商机的视图和用于打开编辑页面的按钮。 |
待定帐户批准： 搜索并批准或拒绝帐户。
| 通知或页面 | 用例工作流 |
|---|---|
| 要批准的新帐户通知 | 当提交一个新帐户以供参与者批准时，他们会收到一个通知。 |
| 批准帐户页面 | 提供用于批准或拒绝帐户的表单。 |
| “我的待定帐户批准”页面 | 提供待定帐户批准的个性化列表以及指向批准页面的链接。 |
待定联系人审批： 搜索并批准或拒绝联系人。
| 通知或页面 | 用例工作流 |
|---|---|
| 要批准的新联系人通知 | 当提交新联系人以供参与者批准时，他们会收到通知。 |
| “批准联系人”页面 | 提供用于批准或拒绝联系人的表单。 |
| 我的待处理的联系人审批 | 提供待处理联系人批准的个性化列表以及批准页面的链接。 |
待定合同审批： 搜索和审批合同。
| 通知或页面 | 用例工作流 |
|---|---|
| 要审批的新合同通知 | 当提交新合同以供参与者批准时，他们会收到通知。 |
| “批准合同”页 | 提供用于批准或拒绝合同的窗体。 |
| 我的待处理的合同审批 | 提供待处理合同批准的个性化列表以及批准页面的链接。 |
任务： 搜索、查看和编辑任务。
| 通知或页面 | 用例工作流 |
|---|---|
| 任务提醒通知 | 当任务在其活动日期和时间之前或之后（例如，默认情况下为 1 小时）通过定义的阈值时，所有者会收到通知提醒。 |
| 帐户详情页面 | 提供帐户视图，其中包括联系人和联系人详细信息链接。 |
| 联系人详情页面 | 提供包含详细信息的联系人的只读视图。 |
| “编辑任务”页 | 提供用于向任务提交编辑内容的表单。 |
| “我的打开任务”页面 | 提供个性化的任务列表。 |
| “任务详细信息”页 | 提供任务视图和用于打开编辑页面的按钮。 |
添加提货单的值表
由于 Salesforce 架构的性质，并非所有数据都作为表实体提供。使用选取列表值表可以查看每个 Salesforce 对象的选择列表及其所有选项。
- 打开 Salesforce 微应用并导航到页面生成器。
- 选择选择组件并将其拖动到字段中。
- 在选择属性下，清除映射到数据列开关。这允许您查看所有 Salesforce 对象。
- 从数据表菜单中选择 picklistvalue。
- 选择编辑过滤器以打开数据过滤器。
- 选择您需要从中获取数据的对象和字段。选择所有必须匹配的条件并保存以关闭过滤器。
以下屏幕截图显示了设置过滤器的示例：
此屏幕截图显示了我们尝试访问的数据库对象和字段：
- 完成此组件的设置。有关详细信息，请参阅页面生成器组件。