集成 SAP Concur
与 SAP Concur 集成以提交申请并接收有关批准、费用、行程和报告的通知。
注意
我们提供了两个 SAP Concur 集成模板供你使用。对于大多数用例，我们建议使用 集成 类别中较新的模板，因为它提供了配置缓存数据结构的更多功能。在 SAP Concur-添加旧版集成中查找旧版（已弃用）集成模板详细信息。
有关开箱即用的 SAP Concur 微应用的完整列表，请参阅 使用 SAP Concur 微应用。
查看必备项
这些先决条件假定你管理组织的 SAP Concur 实例来设置集成。要在 Citrix Workspace 微应用中添加集成，您必须具备以下详细信息：
-
基本 URL：这是基本 URL 模型：
https://{data_center}.api.concursolutions.com。有关更多信息，请参阅 SAP Concur-基本 URI。 -
令牌 URL：
https://{data_center}.api.concursolutions.com/oauth2/v0/token -
授权 URL：
https://{data_center}.api.concursolutions.com/oauth2/v0/authorize - 用户名：这和密码是有权访问 SAP Concur 的服务帐号的凭据。
- 密码：此密码和用户名是有权访问 SAP Concur 的服务帐号的凭据。
- 客户端 ID：您可以通过在 SAP Concur 帐户中注册 OAuth 客户端来收集客户端 ID。对于服务身份验证和服务操作身份验证，客户端 ID 和客户端密钥是相同的。 请参阅请求客户端 ID 和客户端密钥。
- 客户机密钥：您可以通过在 SAP Concur 帐户中注册 OAuth 客户端来收集客户端密钥。服务身份验证和服务操作身份验证的客户端 ID 和客户端密钥相同。 请参阅请求客户端 ID 和客户端密钥。
- 范围：CCARD 信用卡帐户。读取收据。阅读 COMPD 用户用户 _ 阅读 EMERG JOBLOG 公司。阅读 REECPT ITINER FIINER FISVC 列表 PASSV mileage.vehicle.writeonly 配置 FOP mileage.rateonly 收据。只写收据。只写 GHOST 用户。TRVREQ SUPSCC 公司。写 EXPRPT 提取 PAYBAT INVPMT 里程。车辆.read Image TAXINV RCTIMG UNUTX TWS TMCSP 快速支出。只写银行 INVVEN 简明收据。写旅行请求。写 MTNG 里程。
注意：
建议您始终使用 OAuth 2.0 作为服务身份验证方法（如果可用）。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
- 你必须从 SAP Concur 购买 Web 服务组件。如果贵公司尚未购买 Web 服务组件，请让组织中的 SAP Concur 管理员联系 SAP Concur 的客户经理。
- 将 Citrix Gateway 配置为支持 SAP Concur 的单点登录，这样一旦用户登录，他们将自动重新登录，而无需再次输入凭据。按照 Concur 单点登录配置中的说明进行操作。有关配置 SSO 的更多信息，请参阅 Citrix Gateway 服务。
请求客户端 ID 和客户端密钥
获取新的 oauth2 client_id 和 client_secret，然后按照以下说明定义客户端的应用范围。
重要提示：
使用 Concur 创建支持票证以使用 OAuth 2.0 配置集成并注册正确的身份验证回调 URL。我们建议在支持票中使用以下文本：
我们需要 OAuth 2.0 凭据以启用与 Citrix Workspace 的集成。此工具使用服务帐号下载最近的支出报告和订单项目详细信息，以便向经理呈现待处理的批准。它允许员工提交、批准和拒绝费用。最终用户执行的操作将被定向到 3LO 授权页面，他们在其中输入 Concur 凭据并批准 Workspace 应用程序的访问权限。
将以下授权重定向 URL 添加到 Concur 以进行此集成，授予授权访问权限以允许访问私有数据并启用经 OAuth 身份验证的用户操作。列出的第一个回调不会改变。第二个回调取决于目标应用程序，创建集成时可以在 URL 地址栏中找到。{yourmicroappserverurl} 部分由租户部分、区域部分和环境部分组成 https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com：
<https://microapps_server_URL/admin/api/external-services/com.sapho.services.concur.ConcurService/auth/serverContext>
<https://microapps_server_URL/app/api/auth/serviceAction/callback>
将集成添加到 Citrix Workspace 微应用
将 SAP Concur HTTP 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序，这些通知和操作可在工作区中使用身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。对于大多数用例，我们建议使用这种较新的 HTTP 集成。HTTP 集成提供了更多功能来配置缓存的数据结构。
请按照以下步骤进行操作：
- 在 微应用集成 页面中，选择 添加新集成，然后 从 Citrix 提供的模板中添加新集成。
- 选择 SAP Concur 磁贴。
- 输入 集成的集成名称 。
- 输入 连接器参数。
- 输入实例 基本 URL。这是基本 URL 模型：
https://{data_center}.api.concursolutions.com。有关更多信息，请参阅 SAP Concur-基本 URI。 - 从 图标 库中选择用于集成的图标，或将其保留为默认的 Salesforce 图标。
- 如果要创建 本地连接，请启用本地实例 切换。有关更多信息，请参阅 本地实例。
- 输入实例 基本 URL。这是基本 URL 模型：
-
在 服务身份验证下，从身份验证 方法 菜单中选择 OAuth 2.0 ，然后填写身份验证详细信息。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
- 从 身份验证方法 菜单中选择 OAuth 2.0 。
- 从 授权类型流程 菜单中选择 资源所有者密码 。提供正确的凭据以授权资源服务器提供访问令牌。
- 在 授予类型值 菜单中输入 密码 。
- 从令牌授权菜单中选择请求正文。
- 从 令牌内容类型 菜单中选择 URL 编码表 单。
-
令牌 URL 已预先填充：
https://{data_center}.api.concursolutions.com/oauth2/v0/token - 将 刷新令牌 URL 和 范围 字段留空。
- 输入您的 用户名 和 密码。
- 输入您的 客户端 ID 和 客户端密钥。
- 将 标题前缀 留空。
-
在服务操作身份验证下，启用在操作使用单独的用户身份验证开关。服务操作身份验证在服务操作级别进行身份验证。
- 从身份验证方法菜单中选择 OAuth 2.0，然后填写身份验证详细信息。
- 从 授权类型流程菜单中选择授权码 。这会授予客户端用来交换访问令牌的临时代码。该代码从授权服务器获取，您可以在其中查看客户端请求的信息。只有这种授权类型才能启用安全的用户模拟。这将显示您在注册应用程序时使用的 回调 URL。
- 在 授权类型值菜单中输入 authorization_code 。
- 回调 URL 字段已预填。
- 从令牌授权菜单中选择请求正文。
- 从 令牌内容类型 菜单中选择 URL 编码表 单。
-
授权 URL 是预先填写的：
https://{data_center}.api.concursolutions.com/oauth2/v0/authorize -
令牌 URL 已预先填充：
https://{data_center}.api.concursolutions.com/oauth2/v0/token - 将 刷新令牌 URL 字段留空。
- S cope 字段包含以下范围：
CCARD creditcardaccount.read receipts.read COMPD USER user_read EMERG JOBLOG company.read ERECPT ITINER FISVC LIST PASSV mileage.vehicle.writeonly CONFIG FOP mileage.rate.writeonly receipts.writeonly GHOST user.read CONREQ user.write COMPANY mileage.journey.read EVS TRVPTS ATTEND INVPO NOTIF TRVREQ SUPSVC company.write EXPRPT EXTRCT PAYBAT INVPMT mileage.vehicle.read IMAGE TAXINV RCTIMG UNUTX TWS TMCSP quickexpense.writeonly BANK INVVEN openid receipts.write travelrequest.write MTNG mileage.rate.read mileage.journey.writeonly INSGHT TRVPRF INVTV MEDIC TSAI - 输入您的 客户端 ID 和 客户端密钥。
- 将 标题前缀 留空。
- 默认情况下，请 求速率限制 字段设置为 每秒 50 个请求。
- 默认情况下，请求超时 设置为 120 。
- （可选）启用 日志记录 切换以保留 24 小时的日志记录以用于支持目的。
- 选择保存。
现在，您已准备好设置和运行第一次数据同步。有关同步规则、不符合其计划的同步和否决规则的完整信息，请参阅同步数据。
使用 SAP Concur 微应用
我们的 SAP Concur 集成带有以下预配置的开箱即用微应用：
审批： 批准待定支出报表或将其发回。
| 通知或页面 | 用例工作流 |
|---|---|
| 批准提醒通知 | 当支出报表等待批准并且在截止日期之前（例如，默认情况下为 3 天）超过了定义的阈值时，审批人会收到通知提醒。 |
| 新请求通知 | 将新的批准请求分配给审批人时，批准者会收到通知。 |
| 新请求通知 | 当批准请求发生更改时，审批人会收到通知。 |
| 费用详情页面 | 提供包含详细信息的支出的只读视图。 |
| 支出报告详情页面 | 提供报告的详细视图，其中包含支出列表以及 “ 批准 ” 和 “发回” 选项。 |
| “我的待批准” 页面 | 提供待批准的个性化列表。 |
费用： 搜索和查看费用。
| 通知或页面 | 用例工作流 |
|---|---|
| “我的费用详情” 页 | 提供带附件的支出的详细视图。 |
| 我的支出报告详情页面 | 提供报告的详细视图，其中包含支出列表和 “ 召回” 选项。 |
| 我的费用页面 | 提供可搜索的个性化费用清单。 |
行程： 搜索、查看和分享行程。
| 通知或页面 | 用例工作流 |
|---|---|
| 已更改行程成功预订通知 | 当用户的行程发生变化时，用户会收到通知。 |
| 已更改共享行程通知 | 当与用户共享更改的行程时，他们会收到通知。 |
| 新行程成功预订通知 | 当用户的新行程被预订和出票时，用户会收到通知。 |
| 新的共享行程通知 | 与用户共享行程时，他们会收到通知。 |
| 行程详情页面 | 提供用户行程的视图和可操作的共享按钮。 |
| “我的行程” 页面 | 提供个性化的行程列表。 |
报告： 搜索和查看您提交的支出报告。
| 通知或页面 | 用例工作流 |
|---|---|
| 请求批准通知 | 用户的支出报告获得批准后，他们会收到通知。 |
| 请求退回通知 | 当用户的支出报告发回时，他们会收到通知。 |
| “我的费用详情” 页 | 提供带附件的支出的详细视图。 |
| 我的支出报告详情页面 | 提供报告的详细视图，其中包含支出列表和 “ 召回” 选项。 |
| 我的费用报告页面 | 提供支出报表列表。 |
添加旧版集成
作为系统管理员，您可以使用以下过程启用 Concur 集成。确保满足先决条件，然后设置 Concur 集成。设置集成后，必须向员工提供专用帐户的员工姓名、电子邮件地址、员工 ID 或登录 ID，并要求他们调整 SAP Concur 个人资料设置。完成此过程后，您现有的审核日志记录级别将保留，包括使用 Citrix Microapps 执行的任何操作。
查看必备项
这些先决条件假定你管理组织的 SAP Concur 实例来设置集成。要在 Citrix Workspace 微应用中添加集成，您必须具备以下详细信息：
- 实例 URL
- 用户名
- 密码
对于 OAuth 2.0：
- OAuth 客户端 ID
- OAuth 客户端密钥
- 授权 URL
注意：
建议您始终使用 OAuth 2.0 作为服务身份验证方法（如果可用）。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。
- 获取新的 oauth2 client_id 和 client_secret 并定义客户端应用程序的范围。
重要提示：
使用 Concur 创建支持票证以使用 OAuth 2.0 配置集成并注册正确的身份验证回调 URL。我们建议在支持票中使用以下文本：
我们需要 OAuth 2.0 凭据以启用与 Citrix Workspace 的集成。此工具使用服务帐号下载最近的支出报告和订单项目详细信息，以便向经理呈现待处理的批准。它允许员工提交、批准和拒绝快速支出。最终用户执行的操作将被定向到 3LO 授权页面，他们在其中输入 Concur 凭据并批准 Workspace 应用程序的访问权限。
将以下授权重定向 URL 添加到 Concur 以进行此集成，授予授权访问权限以允许访问私有数据并启用经 OAuth 身份验证的用户操作。列出的第一个回调不会改变。第二个回调取决于目标应用程序，创建集成时可以在 URL 地址栏中找到。{yourmicroappserverurl} 部分由租户部分、区域部分和环境部分组成 https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com：
<https://microapps_server_URL/admin/api/external-services/com.sapho.services.concur.ConcurService/auth/serverContext>
<https://microapps_server_URL/app/api/auth/serviceAction/callback>
- 你必须从 SAP Concur 购买 Web 服务组件。如果贵公司尚未购买 Web 服务组件，请让组织中的 SAP Concur 管理员联系 SAP Concur 的客户经理。
- 将 Citrix Gateway 配置为支持 SAP Concur 的单点登录，这样一旦用户登录，他们将自动重新登录，而无需再次输入凭据。按照 Concur 单点登录配置中的说明进行操作。有关配置 SSO 的更多信息，请参阅 Citrix Gateway 服务。
配置旧版模板
将 SAP Concur 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序，这些通知和操作可在工作区中使用
请按照以下步骤进行操作：
-
在概述页面中，选择 入门。
此时将打开 “管理集成” 页面。
- 选择 添加新集成，然后 从 Citrix 提供的模板中添加新集成。
- 选择 SAP Concur 磁贴。
-
输入集成的名称。
- 输入作为先决条件收集的 连接器参数 。
- 输入您的 实例 URL。
- 输入用 户名 和 密码。
- 选择一种 身份验证方法。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。
- 输入 授权 URL 以定义在设置目标应用程序集成时提供的授权服务器 URL。
- 选择 OAuth 2.0 身份验证方法。
- 凭据 使用客户端的凭证而不是资源所有者的凭据。访问令牌与客户端本身相关联，或者与资源所有者的委派授权相关联。
- 授权授予 (3LO) 资源所有者允许访问。
- 输入您在先决条件过程中收集的 OAuth 客户端 ID和 OAuth 客户端密钥 。
-
根据需要选择以下单选按钮：
- 费用模块 提供对员工费用跟踪的访问。
- 支出组配置 检索 OAuth 访问令牌分配到的支出组的费用政策、支出类型和付款类型的列表。
- 支出报表详细信息（分配和明细） 允许检索与报表 ID、条目 ID 或明细编号相关的分配信息。
- 旅行模块 提供对旅行数据的访问，例如行程、旅行资料和旅行请求。
- 费用委托人 检索已向 OAuth 访问令牌中指定的用户授予委托权限的用户的列表。
-
输入 连接数的数量。此值确定数据同步启动的字符串数。
注意：
默认连接数为 1。打开更多连接可以减少数据同步的时间，但会增加微应用服务器的负载并影响其性能。如果你需要，我们建议不超过 10 个。
- 选择添加。
微应用集成 页面随即打开，其中包含您添加的集成及其微应用。在这里，您可以添加另一个集成，继续设置开箱即用的微应用，或为此集成创建新的微应用。
现在，您已准备好设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到微应用平台，因此我们建议您使用 “ 表 ” 页面筛选实体以进行首次数据同步，以加快同步速度。有关更多信息，请参阅验证所需实体。有关同步规则、不符合其计划的同步和否决规则的完整信息，请参阅同步数据。
有关 API 端点和表实体的更多详细信息，请参阅 Concur 连接器规范。
使用 SAP Concur 传统微应用
现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始，然后根据您的需求自定义它们。
重要提示！
这些 SAP Concur 微应用现已弃用：“ 提交快速支出”、“ 创建用户” 和 “ 用户”。用户需要删除这些微应用，因为它们配置错误。要删除微应用，请从微应用集成页面中选择要删除的微应用旁边的菜单。选择 删除微应用 并确认。
我们的 SAP Concur 集成带有以下预配置的开箱即用微应用：
审批： 批准待定支出报表或将其发回。
| 通知或页面 | 用例工作流 |
|---|---|
| 批准提醒通知 | 当支出报表等待批准并且在截止日期之前（例如，默认情况下为 3 天）超过了定义的阈值时，审批人会收到通知提醒。 |
| 新请求通知 | 将新的批准请求分配给审批人时，批准者会收到通知。 |
| 新请求（已更改）通知 | 当批准请求发生更改时，审批人会收到通知。 |
| 费用详情页面 | 提供包含详细信息的支出的只读视图。 |
| “我的待批准” 页面 | 提供待批准的个性化列表。 |
| 查看报告页 | 提供可操作的表单，其中包含待批准的支出报告的详细视图。 |
费用： 搜索和查看费用。
| 通知或页面 | 用例工作流 |
|---|---|
| 费用详情页面 | 提供包含详细信息的支出的只读视图。 |
| 我的费用页面 | 提供个性化的费用清单。 |
| “报告详情” 页 | 提供支出报表的详细视图，其中包含用于注释的字段。 |
行程： 搜索、查看和分享行程。
| 通知或页面 | 用例工作流 |
|---|---|
| 新行程成功预订通知 | 当用户的新行程被预订和出票时，用户会收到通知。 |
| 新的共享行程通知 | 与用户共享行程时，他们会收到通知。 |
| 行程详情页面 | 提供用户行程的视图和可操作的共享按钮。 |
| “我的行程” 页面 | 提供个性化的行程列表。 |
| 分享行程页面 | 提供用于共享用户行程的表单。 |
报告： 搜索和查看您提交的支出报告。
| 通知或页面 | 用例工作流 |
|---|---|
| 请求批准通知 | 用户的支出报告获得批准后，他们会收到通知。 |
| 请求退回通知 | 当用户的支出报告发回时，他们会收到通知。 |
| 费用详情页面 | 提供包含详细信息的支出的只读视图。 |
| 支出报告页 | 提供支出报表的详细视图，其中包含用于注释的字段。 |
| 我的待处理支出报告页面 | 提供个性化的支出报告列表。 |