微应用

集成 SAP Ariba

与 SAP Ariba 集成,无需额外登录即可审核和批准申请请求。

注意:

我们提供了两个 SAP Ariba 集成模板供你使用。对于大多数用例,我们建议使用较新的 HTTP 集成。HTTP 集成提供了更多功能来配置缓存的数据结构。

有关开箱即用的 SAP Ariba 微应用的完整列表,请参阅 使用 Ariba 微应用。

查看必备项

要在 Citrix Workspace 微应用中添加 HTTP 集成,您需要以下值:

  • 基本 URLhttps://openapi.ariba.com/api/approval/v1/prod
  • 令牌 URLhttps://api.ariba.com/v2/oauth/token
  • 客户端 ID:客户端 ID 是表示授权服务器特有的客户端注册信息的字符串,在 SAP 中称为 OAuth 客户端 ID。请参阅 收集 OAuth 客户端 ID 和应用程序密钥
  • 客户端密钥:客户端密钥是在设置目标应用程序集成时发出的唯一字符串,由 SAP 发出。
  • Ariba apiKey:称为 应用程序密钥,用于替换脚本过程中的变量。请参阅 收集 OAuth 客户端 ID 和应用程序密钥
  • Ariba Realm:替换脚本过程中的变量。要找到此信息,请联系您的 SAP 管理员以确认您的 Realm ID
  • Ariba lastChangeID:指定在上一个响应中收到的最后一次更改。响应包括自此之后的所有更改。例如,如果要从头开始加载所有更改,请使用 1

注意:

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

  • 您的组织必须位于美利坚合众国或欧洲。
  • 你必须拥有 SAP Ariba 解决方案或 Ariba 网络解决方案组件的最新许可证。
  • 你必须拥有 SAP Ariba Open API 管理员帐户。贵组织的 SAP Ariba 管理员可以通过以下链接之一请求访问 SAP Ariba Open API 开发人员门户:

  • 将 Citrix Gateway 配置为支持 SAP Ariba 的单点登录,这样一旦用户登录,他们将自动重新登录,而无需再次输入凭据。按照 Ariba 单点登录配置中的说明进行操作。有关配置 SSO 的更多信息,请参阅 Citrix Gateway 服务

设置 SAP Ariba 集成

  1. 使用管理 https://developer.ariba.com/api/ 员帐户登录。
  2. 在欢迎页面上,选择 创建应用程序
  3. 要创建新应用程序,请输入 应用程序名称说明,然后选择 提交

    你的应用程序将被发送给 SAP Ariba 开放 API 团队进行审批。

收集 OAuth 客户端 ID 和应用程序密钥

申请获得批准后(如上节所述),您会收到一封包含 OAuth 密钥令牌的电子邮件。SAP Ariba 开放 API 团队使用你的 Ariba Realm ID 设置并启用后端。

注意:

在收到批准电子邮件之前,您无法继续操作。

  1. 登录并转到 “ 管理应用程序 ” 页面。
  2. 选择您创建的应用程序。
  3. 复制 OAuth 客户端 ID应用程序密钥
  4. 将集成添加到 Citrix Workspace 微应用程序时,将它们保存在安全的位置以供以后使用。

将集成添加到 Citrix 微应用

请按照以下步骤设置 SAP Ariba HTTP 集成。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。对于大多数用例,我们建议使用这种较新的 HTTP 集成。HTTP 集成提供了更多功能来配置缓存的数据结构。

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

  1. 微应用集成 页面中,选择 添加新集成,然后 从 Citrix 提供的模板中添加新集成。
  2. 选择 集成下的 SAP Ariba 磁贴。
  3. 输入 集成的集成名称
  4. 输入 连接器参数
    • 输入实例 基本 URLhttps://openapi.ariba.com/api/approval/v1/prod
    • 图标 库中选择用于集成的图标,或将其保留为默认图标。
  5. 输入 Ariba apiKey。此应用程序密钥替换脚本过程中的变量。请参阅 收集 OAuth 客户端 ID 和应用程序密钥
  6. 进入 Ariba 领域。Ariba Realm Id 替换了脚本过程中的变量。要找到此信息,请联系您的 SAP 管理员以确认您的 Realm ID
  7. 输入 Ariba lastChangeID。指定在上一个响应中收到的最后一次更改。响应包括自此之后的所有更改。例如,如果要从头开始加载所有更改,请使用 1
  8. 服务身份验证下,从身份验证 方法 菜单中选择 OAuth 2.0 ,然后填写身份验证详细信息。身份验证选项是预先选择的。确保在完成该过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为可用的服务身份验证方法。OAuth 2.0 可确保您的集成符合配置的微应用的最大安全合规性。

    1. 授权类型流程 菜单中选择 客户端凭据
    2. 授权类型值输入client_凭** 证**。
    3. 令牌授权菜单中选择授权 标题。
    4. 令牌内容类型 菜单中选择 URL 编码表 单。
    5. 输入 令牌 URLhttps://api.ariba.com/v2/oauth/token
    6. 输入您的 客户 ID。客户端 ID 是表示授权服务器特有的客户端注册信息的字符串。当你配置 OAuth 服务器时,你会收集这个和密钥。请参阅 收集 OAuth 客户端 ID 和应用程序密钥
    7. 输入您的 客户端密钥。客户端密钥是设置目标应用程序集成时发出的唯一字符串。请参阅 收集 OAuth 客户端 ID 和应用程序密钥
  9. 启用请 求速率限制 开关。在 请求数 中输入 3 ,在 时间间隔 中输入 1 秒
  10. 在 “请 求超时 ” 字段中,输入 120
  11. (可选)启用 日志记录 切换以保留 24 小时的日志记录以用于支持目的。
  12. 选择 保存 以继续。

现在,您已准备好设置和运行第一次数据同步。有关同步规则、不符合其计划的同步和否决规则的完整信息,请参阅同步数据

有关 API 端点和表实体的更多详细信息,请参阅 Ariba 连接器规范

使用 Ariba 微应用

现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始,然后根据您的需求自定义它们。

我们的 SAP Ariba 集成带有以下预配置的开箱即用微应用:

申请审批: 查看具有待审批的详细信息和要审批的活动的申请。

通知或页 用例工作流
等待批准通知 当新的采购申请等待审批时,审批人会收到通知。
等待下次批准通知 当新的采购申请等待下一级批准时,下一个审批人会收到通知。
申请已创建通知 创建新申请后,申请提交者会收到包含详细信息的通知。
申请已更改通知 当新的采购申请的状态发生更改时,申请提交者会收到通知。
批准请求页 提供等待批准的可搜索请求列表以及指向更多详细信息的链接。
申请详细信息审批人页 提供申请的详细视图,其中包含 准和 拒绝 请求的操作。
申请详细信息申请人页 向请求者提供申请的详细视图。

添加旧版 SAP Ariba 集成

将 SAP Ariba 集成添加到 Citrix Workspace 微应用程序以连接到您的应用程序。这样可以提供带有预配置通知和操作的开箱即用的微应用程序,这些通知和操作可在工作区中使用在 SAP Ariba 中设置此集成后,您需要以下工件才能在 Citrix Workspace 微应用中添加集成:

  • API URL
  • OAuth 令牌 URL
  • OAuth 客户端 ID
  • OAuth 客户端密钥
  • 应用密钥
  • 领域 ID

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

  1. 在微应用概述页面中,选择 入门

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

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

    Ariba 连接器参数、API URL、OAuth 令牌 URL、OAuth 客户端 ID、OAuth 客户端密钥、应用程序密钥、领域 ID

  5. 输入在前面的过程中收集的 连接器参数
    • 输入目标系统服务身份验证的 API URL和 OAuth 令牌 URL 凭据。
    • 输入您的 OAuth 客户端 ID客户端密钥
    • 输入您的 应用程序密钥Realm ID
    • 如果您需要将数据加载到沙盒环境中,请切换沙盒。
    • 输入请 求速率限制值,即 Ariba 服务的最大请求次数。此字段是必填字段,用于确定每秒呼叫的次数。与您的 Ariba 代表讨论您的实例的限制,以便正确配置值。如果速率限制未知,我们建议每秒 10 次或更少的电话作为初始安全费率。零可用于完全禁用所有限制。但是,请求速率过高会导致拒绝访问。
    • 为 Ch ange id 选择一个值,从中开始完全同步。当完全同步开始限制数据加载量时,将在完全同步期间跳过较早的更改。将此值留空以加载所有内容。
    • 可选)启用 同步期间忽略 400 个错误请求响应 切换以从 400 个错误请求响应错误中恢复。如果在同步过程中删除了任何 Ariba 记录,Ariba API 将返回错误,因为请求的数据不再存在。日志中会生成警告。
  6. 选择添加

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

现在,您已准备好设置和运行第一次数据同步。由于可以将大量数据从集成应用程序提取到微应用平台,因此我们建议您使用 “ ” 页面筛选实体以进行首次数据同步,以加快同步速度。有关更多信息,请参阅验证所需实体。有关同步规则、不符合其计划的同步和否决规则的完整信息,请参阅同步数据

有关 API 端点和表实体的更多详细信息,请参阅 Ariba 连接器规范

传统 SAP Ariba 微应用

现有的应用程序集成随现成的微应用程序一起提供。从这些微应用开始,然后根据您的需求自定义它们。

我们的旧版 SAP Ariba 集成带有以下预配置的开箱即用微应用:

申请审批: 查看具有待审批的详细信息和要审批的活动的申请。

通知或页面 用例工作流
等待批准(更改)通知 当等待审批的采购申请的详细信息发生更改时,审批人会收到通知。
等待批准(新)通知 当新的采购申请等待审批时,审批人会收到通知。
申请变更通知 当新的采购申请的状态发生更改时,用户会收到通知。
申请已创建通知 创建新的采购申请(表示已提交或正在编写)时,用户会收到通知。
批准请求页 提供个性化的批准请求列表和更多详细信息的链接。
申请详情页 提供申请的详细视图和可操作的批准按钮。
集成 SAP Ariba