集成 Salesforce

与 Salesforce 集成,随时随地访问潜在客户、客户、商机、案例和合同。

使用以下过程启用 Salesforce 集成。确保满足必备条件,然后设置 Salesforce 集成。完成此过程后,您的现有审核日志记录级别将持续存在,包括使用 Citrix 微应用执行的任何操作。

有关现成的 Salesforce 微应用的完整列表,请参阅使用 Salesforce 微应用

检查必备项

在 Salesforce 中设置此集成后,您需要以下工件才能在 Citrix Workspace 微应用中添加集成:

  • 用户名
  • 密码
  • 安全令牌

对于 OAuth 2.0:

  • 消费者密钥
  • 消费者秘密

注意:

我们建议您始终使用 OAuth 2.0 作为您的服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

集成需要对您的 Salesforce 实例进行定期 API 访问,因此我们建议您在 Salesforce 中创建专用用户帐户。然后使用该帐户配置 Salesforce 集成。此帐户必须:

  • 获得完全数据访问权限
  • 启用 API
  • 不允许双重身份验证。

使用专用帐户对审核日志非常有用,因为它有助于区分通过 Workspace 完成的活动。此页面包含有关 Salesforce 经典版和 Salesforce 闪电体验的教程。这两个教程都假定您是 Salesforce 中的系统管理员。

注意:

Salesforce“联系人”和“组”版本不支持任何 API。“专业”版本不会自动包含它。但是,可以根据要求激活支持。

此外,在销售力量中,API 请求的数量也受到限制。如果计划频繁同步大量数据,请参阅销售队伍 API 请求限制和分配

  • 将 Citrix Gateway 配置为支持 Salesforce 的单点登录,以便用户在登录后自动重新登录,而无需再次输入凭据。请按照 Salesforce 单点登录配置 中的说明进行操作。有关配置 SSO 的详细信息,请参阅Citrix Gateway 服务

添加新配置文件

请按照以下步骤进行操作:

  1. 登录到 www.salesforce.com
  2. 转到设置图标,然后选择设置 > 管理 > 管理用户 > 配置文件 > 新建配置文件
  3. 现有配置文件设置为系统管理员,以确保为此配置文件创建的用户具有完全的数据访问权限。
  4. 输入配置文件名称,然后选择保存。我们建议将配置文件命名为类似于 Citrix Workspace Access,以便在以下过程中将配置文件添加为新用户时参考。

    将打开“配置式”面板,其中包含新配置式。

为创建的配置文件启用 API 访问

  1. 配置文件面板上,选择编辑
  2. 向下滚动到管理权限,然后选中已启用 API 复选框。
  3. (可选)若要禁用密码过期,请选中密码永不过期复选框。

    注意:

    使用此选项是一个潜在的安全漏洞。

  4. 选择保存

添加回调 URL

向您的实例配置添加自定义 URL,以授予对私有数据的访问权限并启用OAuth 身份验证的用户操作。

  1. 以管理员身份登录到销售部队。
  2. 导航到平台工具 > 应用程序 > 应用程序管理器
  3. 选择新连接的应用程序
  4. 基本信息下,填写以下字段:
    • 已连接的应用程序名称
    • API 名称
    • 联系电子邮件
  5. API 下,选中启用 OAuth 设置复选框。
  6. 回调 URL 字段中,将以下授权的重定向 URL 添加到您的微应用服务器 URL 中:

    • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.salesforce.SalesforceService/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  7. 选定的 OAuth 作用域旁边,在可用的 OAuth 作用域下选择以下作用域,然后选择添加将其移动到选定的 OAuth 作用域字段:
    • 访问和管理您的数据 (api)
    • 访问您的基本信息(ID、个人资料、电子邮件、地址、电话)
    • 随时代表您执行请求(refresh_token、offline_access)
  8. 选择保存

(可选)限制登录 IP 范围

如果您的组织为“用户配置文件”设置了 IP 范围,则可以在用户级别控制登录访问。在用户配置文件中指定允许的 IP 地址范围。有关详细信息,请参阅在增强型配置文件用户界面中限制登录 IP 范围

如果限制登录 IP 范围,则不需要在以下过程中生成安全令牌。

添加新用户

创建用于连接到 Salesforce 的专用用户帐户。使用您在上一过程中添加的新配置文件 添加新配置文件

请按照以下步骤进行操作:

  1. 转到设置 > 管理 > 管理用户 > 用户 > 新用户
  2. 以红色填写必填字段。
  3. 用户许可证设置为 Salesforce
  4. 配置文件设置为系统管理员
  5. 单击保存

设置新用户

添加专用用户帐户后,您会在您提供的地址收到一封电子邮件。

请按照以下步骤进行操作:

  1. 找到电子邮件,然后按照说明单击链接。
  2. 登录到 Salesforce。
  3. 设置密码和密码问题。

生成安全令牌

如果您限制了专用用户配置文件的登录 IP 范围,则可以跳过此步骤。从白色列出的 IP 块连接到 Salesforce API 的帐户不需要使用安全令牌。

请按照以下步骤进行操作:

  1. 登录并选择帐户名称。
  2. 前往我的设置 > 个人 > 重置我的安全令牌
  3. 选择重置安全令牌

    新的安全令牌将发送到您在此帐户的个人设置中提供的电子邮件地址。每当重置此帐户的密码时,您还会获得一个新的安全令牌。

您现在可以完成添加集成。在 Salesforce 服务定义的输入字段中输入专用用户帐户的用户名密码

如果您列出了 IP 白色,则无需输入安全令牌。否则,粘贴发送到专用帐户的电子邮箱中的安全令牌。

筛选查询

大多数 Salesforce 实体都支持筛选。在预定义查询之间进行选择,或者使用 Salesforce SOQL 语言编写自己的自定义查询。有关详细信息,请参阅销售队伍对象查询语言文档

将集成添加到 Citrix Workspace 微应用

将 Salesforce 集成添加到 Citrix Workspace 微应用以连接到您的应用程序。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。

请按照以下步骤进行操作:

  1. 从概览页面中,选择开始

    此时将打开“管理集成”页面。

  2. 选择添加新集成,然后选择从 Citrix 提供的模板中添加新集成
  3. 选择 Salesforce 磁贴。
  4. 输入集成的名称。

    Salesforce 连接器参数、用户名、密码、用户身份验证、安全令牌

  5. 输入您在之前的过程中收集的服务身份验证连接器参数
    • 为您的目标系统服务身份验证输入您的用户名密码凭据。
    • 选择 OAuth 2.0 身份验证方法
      • 输入您在必备条件过程中收集的使用者密钥使用者密码
    • 输入您的安全编码器
    • 如果您需要将数据加载到沙盒环境中,请切换沙盒。
    • 保留开关在增量同步期间查询已删除的记录,以便将其从缓存中删除处于启用状态。如果系统在第一次增量同步后抛出以下错误:无法加载类型的已删除实体,您可以禁用此切换以解决此问题。
  6. 选择添加

微应用集成页面将打开,其中包含您添加的集成及其微应用。在这里,您可以添加另一个集成,继续设置现成的微应用,或者为此集成创建一个新的微应用。

现在,您可以设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到 微应用平台,因此我们建议您使用页面筛选第一次数据同步的实体,以加快同步速度。

有关详细信息,请参阅“配置集成”文章中的验证所需的实体设置数据同步

有关 API 端点和表实体的更多详细信息,请参阅销售团队连接器规格

使用 Salesforce 微应用

现有的应用程序集成带有现成的微应用。从这些微应用开始,并根据您的需求定制它们。

Salesforce 微应用

我们的 Salesforce 集成带有以下预配置的现成微应用:

帐户: 搜索、查看和编辑帐户。

通知或页面 用例工作流
分配给您的帐户(现有)通知 当帐户的所有者发生更改时,新所有者将收到通知。
分配给您的帐户(新)通知 当将新帐户分配给用户时,他们会收到通知。
帐户详情页面 提供帐户视图,其中包括联系人和联系人详细信息链接。
联系详细信息页面 提供包含详细信息的联系人的只读视图。
编辑帐户页面 提供用于向帐户提交编辑内容的表单。
“我的帐户”页面 提供个性化的帐户列表。

案例: 搜索、查看和编辑分配给您的案例。

通知或页面 用例工作流
分配给您的案例(现有)通知 当案例的所有者发生更改时,新所有者将收到通知。
分配给您的案例(新)通知 当将新案例分配给用户时,他们会收到通知。
与您的帐户通知相关的新问题 当创建与用户帐户相关的新案例时,他们会收到通知。
帐户详情页面 提供帐户视图,其中包括联系人和联系人详细信息链接。
案例详情页面 提供案例视图和用于打开编辑页面的按钮。
联系详细信息页面 提供包含详细信息的联系人的只读视图。
“编辑案例”页 提供用于向案例提交编辑内容的表单。
我的未结案例页面 提供分配给用户的个性化案例列表。

联系人: 搜索、查看和编辑联系人。

通知或页面 用例工作流
已分配给您的联系人(现有)通知 当联系人的所有者发生更改时,新所有者将收到通知。
已分配给您的联系人(新)通知 当将新联系人分配给用户时,他们会收到通知。
联系详细信息页面 提供联系人视图和用于打开编辑页面的按钮。
编辑联系人页面 提供用于向联系人提交编辑内容的表单。
我的联系人页面 提供个性化的联系人列表。

合同: 搜索、查看和编辑合同。

通知或页面 用例工作流
合同已更新通知 更改合同的详细信息时,合同的所有者将收到通知。
即将到期的合同通知 当合同在其结束日期之前或之后(例如,默认情况下为 3 天)通过定义的阈值时,所有者将收到通知提醒。
新合同激活通知 当将新的待定合同激活审批请求分配给用户时,他们将收到通知。
帐户详情页面 提供帐户视图,其中包括联系人和联系人详细信息链接。
联系详细信息页面 提供包含详细信息的联系人的只读视图。
“合同详细信息”页面 提供合同视图和用于打开编辑页面和激活合同的按钮。
“编辑合同”页 提供用于向合同提交编辑内容的表单。
“我的合同待激活”页面 提供待激活的合同的个性化列表。

创建帐户: 创建新帐户。

通知或页面 用例工作流
创建帐户页面 提供用于提交新帐户的表单。

创建案例: 创建新案例。

通知或页面 用例工作流
“创建案例”页面 提供用于提交新案例的表单。

创建联系人: 创建新联系人。

通知或页面 用例工作流
创建联系人页面 提供用于提交新联系人的表单。

创建合同: 创建新合同。

通知或页面 用例工作流
“创建合同”页 提供用于提交新合同的表单。

创建事件: 创建新事件。

通知或页面 用例工作流
“创建事件”页 提供用于提交新事件的表单。

创建销售线索: 创建新的销售线索。

通知或页面 用例工作流
“创建潜在顾问”页 提供用于提交新销售线索的表单。

创造商机: 创造新商机。

通知或页面 用例工作流
“创建商机”页 提供用于提交新业务商机的表单。

创建任务: 创建新任务。

通知或页面 用例工作流
“创建任务”页 提供用于提交新任务的表单。

事件: 搜索、查看和编辑事件。

通知或页面 用例工作流
事件提醒通知 当事件在其活动日期和时间之前或之后(例如,默认情况下为 1 小时)通过定义的阈值时,所有者将收到通知提醒。
帐户详情页面 提供帐户视图,其中包括联系人和联系人详细信息链接。
联系详细信息页面 提供包含详细信息的联系人的只读视图。
“编辑事件”页 提供用于向事件提交编辑内容的表单。
“事件详细信息”页面 提供事件视图和用于打开编辑页面的按钮。
我的活动页面 提供个性化的事件列表。

潜在客户: 搜索、查看、编辑和转换潜在客户。

通知或页面 用例工作流
分配给您的销售线索(现有)通知 当潜在客户的所有者发生更改时,新所有者将收到通知。
分配给您的销售线索(新)通知 当将新的潜在客户分配给用户时,他们会收到通知。
转换潜在顾问页面 提供转换潜在客户的表单。
编辑潜在顾问页面 提供用于向潜在客户提交编辑内容的表单。
“我的活动潜在客户”页面 提供个性化的潜在客户列表。

商机: 搜索、查看和编辑商机。

通知或页面 用例工作流
分配给您的商机(现有)通知 当商机的所有者发生更改时,新所有者将收到通知。
分配给您的商机(新)通知 向用户分配新商机时,他们会收到通知。
帐户详情页面 提供帐户视图,其中包括联系人和联系人详细信息链接。
联系详细信息页面 提供包含详细信息的联系人的只读视图。
“编辑商机”页 提供用于向业务商机提交编辑内容的表单。
我的开放商机页面 提供个性化的商机列表。
业务商机详细信息页面 提供商机的视图和用于打开编辑页面的按钮。

待定帐户批准: 搜索并批准或拒绝帐户。

通知或页面 用例工作流
要批准的新帐户通知 当提交一个新帐户以供参与者批准时,他们会收到一个通知。
批准帐户页面 提供用于批准或拒绝帐户的表单。
“我的待定帐户批准”页面 提供待定帐户批准的个性化列表以及指向批准页面的链接。

待定联系人批准: 搜索和批准或拒绝联系人。

通知或页面 用例工作流
新联系人以获得批准通知 当提交新联系人以供参与者批准时,他们会收到通知。
“批准联系人”页面 提供批准或拒绝联系人的表单。
我的待处理的联系人审批 提供待定联系人批准的个性化列表以及批准页面的链接。

待定合同审批: 搜索和审批合同。

通知或页面 用例工作流
新合同批准通知 当提交新合同供参与者批准时,他们会收到通知。
“批准合同”页 提供用于批准或拒绝合同的表单。
我的待处理的合同审批 提供待定合同批准的个性化列表以及指向批准页面的链接。

任务: 搜索、查看和编辑任务。

通知或页面 用例工作流
任务提醒通知 当任务在其活动日期和时间之前或之后(例如,默认情况下为 1 小时)通过定义的阈值时,所有者将收到通知提醒。
帐户详情页面 提供帐户视图,其中包括联系人和联系人详细信息链接。
联系详细信息页面 提供包含详细信息的联系人的只读视图。
“编辑任务”页 提供用于向任务提交编辑内容的表单。
“我的打开任务”页面 提供个性化的任务列表。
“任务详细信息”页 提供任务视图和用于打开编辑页面的按钮。

添加提货单的值表

由于 Salesforce 架构的性质,并非所有数据都作为表实体提供。使用 picklistvalue 表可以查看每个 Salesforce 对象的选择列表及其所有选项。

  1. 打开 Salesforce 微应用程序并导航到页面生成器。
  2. 选择选择组件并将其拖动到字段中。
  3. 选择属性下,清除映射到数据列开关。这允许您查看所有 Salesforce 对象。
  4. 数据表菜单中选择 picklistvalue
  5. 选择编辑筛选器以打开数据筛选器。
  6. 选择您需要从中获取数据的对象字段。选择所有必须匹配的条件保存以关闭筛选器。 以下屏幕截图显示了设置筛选器的示例: 设置选择列表值筛选器 此屏幕截图显示了我们尝试访问的数据库对象和字段: 示例 Salesforce 数据库
  7. 完成此组件的设置。有关详细信息,请参阅页面生成器组件