集成 SAP Ariba

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

注意:

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

有关现成的 SAP Ariba 微应用的完整列表,请参阅使用 SAP 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 Open API 团队以供批准。

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

申请获得批准后(如上文章节所述),您将收到一封带有 OAuth 密钥令牌的电子邮件。SAP Ariba Open 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 Realm。Ariba 领域 ID 替换了脚本编写过程中的变量。如果你需要找到此信息,请联系你的 SAP 管理员以确认你的 Realm ID
  7. 输入 Ariba lastChangeID。指定上一个响应中收到的最后一次更改。响应包括自此以来的所有更改。例如,如果要从头开始加载所有更改,请使用 1
  8. 服务身份验证下,从身份验证方法菜单中选择 OAuth 2.0,然后填写身份验证详细信息。身份验证选项已预先选择。确保在完成此过程时选择了这些选项。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。

    1. 授权类型流程 菜单中选择 客户端凭据
    2. 授权类型值 输入 client_credentials
    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 微应用以连接到您的应用程序。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。在 SAP Ariba 中设置此集成后,您需要以下工件才能在 Citrix Workspace 微应用中添加集成:

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

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

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

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

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

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

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

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

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

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

传统 SAP Ariba 微应用

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

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

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

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