集成SAP Ariba
与SAP Ariba集成,以审查和批准申请请求,而不需要任何额外的登录。
注意:
我们提供了两个SAP Ariba集成模板供您使用。我们建议在大多数用例中使用更新的HTTP集成。HTTP集成提供了更强大的功能来配置缓存的数据结构。
要获得SAP Ariba微应用的全面列表,请参见使用Ariba microapps.
检查先决条件
你需要这些值来在Citrix Workspace Microapps中添加HTTP集成:
- 基URL:
https://openapi.ariba.com/api/approval/v1/prod
- 标记的URL:
https://api.ariba.com/v2/oauth/token
- 客户机ID:客户端ID是表示客户端注册信息的字符串,在SAP中称为OAuth客户端ID。参见收集OAuth客户端ID和应用程序密钥.
- 客户的秘密:客户端机密是在设置目标应用程序集成时发出的唯一字符串,由SAP发出。
- Ariba APIkey:称为应用程序的关键,它将替换脚本过程中的一个变量。看到收集OAuth客户端ID和应用程序密钥.
- Ariba领域:替换脚本过程中的变量。要找到这个,请联系您的SAP管理员确认您的领域ID.
- Ariba lastChangeId:指定在上一个响应中接收到的最后一个更改。响应包含了自该响应以来的所有更改。例如,使用1如果您想从开始加载所有更改。
注意:
建议您始终使用OAuth 2.0作为可用的服务身份验证方法。OAuth 2.0确保您的集成满足与您配置的微应用程序的最大安全合规。
- 你的组织必须在美国或欧洲。
- 您必须具有SAP Ariba解决方案或Ariba网络解决方案组件的当前许可证。
您必须拥有SAP Ariba Open api管理员帐户。您组织的SAP Ariba管理员可以通过以下链接之一请求访问SAP Ariba开放api开发人员门户:
- 配置Citrix Gateway以支持SAP Ariba的单点登录,这样用户一旦登录,就可以自动再次登录,而无需再次输入凭证。请按照Ariba单点登录配置.有关配置SSO的更多信息,请参见Citrix网关服务.
设置SAP Ariba集成
- 登录到https://developer.ariba.com/api/具有管理员帐户。
- 在欢迎页面上,选择创建应用程序.
要创建新的应用程序,输入应用程序名称而且描述,并选择提交.
您的应用程序被发送到SAP Ariba Open api团队进行审批。
收集OAuth客户端ID和应用程序密钥
在您的申请被批准后(如上节所述),您将收到一封带有OAuth秘密令牌的电子邮件。SAP Ariba Open api团队使用您的Ariba Realm ID设置并启用后端。
注意:
您不能继续,直到您收到批准的电子邮件。
- 登录并进入管理应用程序页面。
- 选择您创建的应用程序。
- 复制OAuth客户机ID而且应用程序的关键.
- 将它们保存在一个安全的地方,以便以后在添加集成到Citrix Workspace Microapps时使用。
将集成添加到Citrix Microapps
按照以下步骤设置SAP Ariba HTTP集成。身份验证选项是预先选择的。确保在完成流程时选择了这些选项。我们建议在大多数用例中使用这种更新的HTTP集成。HTTP集成提供了更强大的功能来配置缓存的数据结构。
遵循以下步骤:
- 从Microapp集成页面,选择添加新的集成,从citrix提供的模板中添加一个新的集成.
- 选择下面的SAP Ariba瓷砖集成.
- 输入一个集成的名字的集成。
- 输入连接器参数.
- 输入实例基URL:
https://openapi.ariba.com/api/approval/v1/prod
- 选择一个图标从图标库集成,或保留该图标为默认图标。
- 输入实例基URL:
- 进入Ariba APIkey.此应用程序键将替换脚本编制过程中的一个变量。看到收集OAuth客户端ID和应用程序密钥.
- 进入Ariba领域.Ariba realm Id替换脚本过程中的一个变量。要找到这个,请联系您的SAP管理员确认您的领域ID.
- 进入Ariba lastChangeId.指定在上一个响应中接收到的最后一个更改。响应包含了自该响应以来的所有更改。例如,使用1如果您想从开始加载所有更改。
下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。身份验证选项是预先选择的。确保在完成流程时选择了这些选项。使用OAuth 2.0安全协议为委托访问生成请求/授权令牌。建议您始终使用OAuth 2.0作为可用的服务身份验证方法。OAuth 2.0确保您的集成满足与您配置的微应用程序的最大安全合规。
- 选择客户端凭证从格兰特式流菜单。
- 输入client_credentials为格兰特类型值.
- 选择授权头从令牌授权菜单。
- 选择URL编码形式从令牌内容类型菜单。
- 进入标记的URL:
https://api.ariba.com/v2/oauth/token
- 输入您的客户机ID.客户端ID是表示授权服务器唯一的客户端注册信息的字符串。在配置OAuth服务器时收集这些信息和秘密。看到收集OAuth客户端ID和应用程序密钥.
- 输入您的客户的秘密.客户机机密是在设置目标应用程序集成时发出的唯一字符串。看到收集OAuth客户端ID和应用程序密钥.
- 启用请求速率限制切换。输入3.为的请求数量而且1秒为时间间隔.
- 在请求超时字段中,输入120.
- (可选)使日志记录切换为支持24小时日志记录。
- 选择保存继续。
现在可以设置和运行第一个数据同步了。有关同步化规则的完整信息,请参阅不符合其时间表和否决规则的同步化同步数据.
有关API端点和表实体的详细信息,请参见Ariba连接器规格.
使用Ariba microapps
现有的应用集成带有开箱即用的微应用程序。从这些微应用开始,根据你的需求定制它们。
我们的SAP Ariba集成带有以下预先配置的开箱即用的微应用程序:
请求批准:使用待批准的详细信息和要批准的操作查看请求。
通知或页面 | 用例的工作流 |
---|---|
等待批准的通知 | 当一个新的采购申请等待批准时,审批者会收到一个通知。 |
等待下一次批准通知 | 当一个新的采购申请正在等待下一级审批时,下一个审批者将收到一个通知。 |
征用了通知 | 当创建一个新的请求时,请求提交者会收到一个带有详细信息的通知。 |
请求更改通知 | 当一个新的购买请求的状态被更改时,请求提交者会收到一个通知。 |
批准请求页面 | 提供等待批准的请求的可搜索列表和到更多详细信息的链接。 |
申请详细批准人页面 | 提供请求的详细视图和操作批准而且否认请求。 |
请求详细信息请求者页面 | 向请求者提供请求的详细视图。 |
添加Legacy SAP Ariba集成
将SAP Ariba集成添加到Citrix Workspace Microapps,以连接到您的应用程序。这提供了具有预先配置的通知和操作的开箱即用的微应用程序,随时可以在您的工作区中使用。当你在SAP Ariba中建立了这个集成之后,你将需要这些构件来在Citrix Workspace Microapps中添加集成:
- API的URL
- OAuth标记的URL
- OAuth客户机ID
- OAuth客户的秘密
- 应用程序的关键
- 领域ID
遵循以下步骤:
从Microapps概览页面,选择开始.
将打开“管理集成”页面。
- 选择添加新的集成,从citrix提供的模板中添加一个新的集成.
- 选择Ariba瓷砖。
输入集成的名称。
- 进入连接器参数在前面的过程中收集到的。
- 输入您的API的URL而且OAuth标记的URL用于目标系统服务身份验证的凭证。
- 输入您的OAuth客户机ID而且客户的秘密.
- 输入您的应用程序的关键而且领域ID.
- 切换沙盒如果您需要将数据加载到沙盒环境中。
- 为对Ariba服务的最大请求速率限制.这个字段是强制性的,它决定了每秒的呼叫数。请与Ariba代表讨论实例的限制,以便正确配置该值。如果速率限制未知,我们建议将10次/秒或更少的呼叫作为初始安全速率。Zero可以用来完全禁用所有限制。但是,过高的请求速率可能导致拒绝访问。
- 选择一个值修改全量同步开始的id.当完全同步开始限制数据加载量时,在完全同步期间跳过旧的更改。将此值保留为空以加载所有内容。
- 可选)使在同步期间忽略400 Bad Request响应切换到从400 Bad Request response错误中恢复。如果在同步期间删除了任何Ariba记录,Ariba API将返回一个错误,因为所请求的数据不再存在。日志中有警告信息。
- 选择添加.
的Microapp集成页面打开,显示添加的集成及其微应用程序。从这里你可以添加另一个集成,继续设置你的开箱即用的微应用,或者为这个集成创建一个微应用。
现在可以设置和运行第一个数据同步了。由于可以从您的集成应用程序中提取大量数据到Microapps平台,我们建议您使用表格页来筛选第一次数据同步的实体,以加快同步速度。有关更多信息,请参见验证所需的实体.有关同步化规则的完整信息,请参阅不符合其时间表和否决规则的同步化同步数据.
有关API端点和表实体的详细信息,请参见Ariba连接器规格.
遗留的SAP Ariba微应用
现有的应用集成带有开箱即用的微应用程序。从这些微应用开始,根据你的需求定制它们。
我们的遗留SAP Ariba集成附带以下预先配置的开箱即用的微应用程序:
请求批准:使用待批准的详细信息和要批准的操作查看请求。
通知或页面 | 用例的工作流 |
---|---|
等待批准(变更)通知 | 当等待批准的采购申请的详细信息发生更改时,审批人将收到通知。 |
待审批(新)通知 | 当一个新的采购申请等待批准时,审批者会收到一个通知。 |
请求更改通知 | 当新购买请求的状态发生改变时,用户会收到一个通知。 |
征用了通知 | 当创建一个新的购买请求(意味着提交或组合)时,用户会收到一个通知。 |
批准请求页面 | 提供个性化的审批请求列表和指向详细信息的链接。 |
请求详细信息页面 | 提供一个请求的详细视图和一个可操作的批准按钮。 |