限制:对于所有新的启动外部URL解决方案,请使用启动外部URL v4API。

Launch External URL标注为客户端和开发人员提供了一个扩展SAP Concur功能的平台,提供了一种交付自定义用户交互或访问外部系统中发现的功能的方法。客户端可以安排添加一个Expense Entry表单字段,该字段配置为使用Launch External URL标注到Concur Expense Entry表单。Concur Expense将显示此字段,并附带一个按钮,单击该按钮时将启动一个单独的窗口。该窗口由第三方开发人员、客户端或SAP Concur创建的应用程序连接器控制。应用程序连接器是一个在窗口中显示信息的web服务器。

应用程序连接器可以通过web服务访问SAP Concur数据,也可以访问外部系统中的数据。一旦用户在窗口中完成了他们的操作(例如执行搜索或完成向导),他/她就会点击一个按钮,例如“完成”,这表明用户已经在窗口中结束了他们的工作。然后应用程序连接器关闭窗口。

应用程序连接器可以使用web服务将信息发送到SAP Concur,以更新费用输入表单或其他表单类型上的字段值。应用程序连接器可以在用户关闭窗口之前或之后发送更新。当用户返回SAP Concur时,页面会刷新,他/她会看到更新的值。

此标注与标准SAP Concur web服务的不同之处在于:

  • 它使用一个出站调出其中Expense调用应用程序连接器提供的公共URL,该连接器是由第三方开发人员或客户端托管的web服务器。连接器域和IP地址必须在配置过程中添加到SAP Concur安全列表中。
  • 应用程序连接器还可以使用web服务检索或发送SAP Concur数据。
  • 开发人员或客户端可以配置和维护公共web服务接口(应用程序连接器),或者该连接器可以由SAP Concur维护。本指南指定SAP Concur所需的请求和响应格式。
  • 在使用此服务之前,客户端费用管理员必须配置一个新的表单字段并将该字段添加到所需的表单。

内容

工艺流程

启动外部服务的流程流

产品和版本

  • Concur费用专业版

产品的限制

SAP Concur移动应用程序不支持此标注。

SAP Concur产品是高度可配置的,并不是所有客户都可以访问所有特性。

只有Employee角色可以与启动外部URL配置字段交互。其他角色,如审批者和处理器,不能触发弹出窗口。

在评审过程之前,合作开发人员必须确定他们的解决方案需要哪些配置。

现有客户端可以使用SAP Concur Integration Services创建使用其配置的自定义应用程序。

Callout细节

有关如何下载、安装和配置应用程序连接器的信息包括在标注和应用程序连接器

启动URL过程概述

配置流程如下:

  1. 第三方开发人员、客户端或SAP Concur下载、安装、配置和定制应用程序连接器。应用程序连接器可以向入站web服务发出请求。
  2. SAP Concur注册应用程序连接器。SAP Concur必须将应用程序连接器的IP地址和域添加到包含列表中。准备好提供测试和生产域信息。
  3. 费用管理使用Launch External URL控件类型创建一个新的表单字段,并将该字段添加到费用输入表单中。

配置完成后,callout使用以下过程:

  1. 用户单击只读表单字段旁边的按钮。
  2. Expense启动一个新窗口,并以编码查询字符串的形式将Expense Entry Details URI、公司域和X-User ID发送给应用程序连接器。
  3. 应用程序连接器解析查询字符串以提取已发送的数据。
  4. 应用程序连接器使用SAP Concur web服务来收集信息。这可能是费用输入信息、用户信息或其他信息。
  5. 应用程序连接器在新窗口中显示一个web页面供用户交互。这可以是来自商业应用程序的页面,也可以是自定义web应用程序的页面。
  6. 用户完成外部系统进程。这可以是搜索、向导或其他进程。
  7. 应用程序连接器使用SAP Concur web服务将任何字段更新信息发送到SAP Concur。
  8. 用户或应用程序连接器关闭窗口并返回SAP Concur。
  9. SAP Concur会重新加载用户所在的页面,以显示任何更新的字段值。

安全

SAP Concur将使用SSL调用应用程序连接器的端点。在配置期间,SAP Concur将连接到应用程序连接器以验证其主机名和访问凭据是否有效。

在SAP Concur为示例应用程序连接器提供的代码中,凭据存储在随平台而异的web配置文件中,如web.xml或web.config。但是,如果您正在托管连接器,您可以通过定制HTTPBasicAuth.java或Authentication.cs来定制凭证存储的位置和方式。

在应用程序连接器中安装由证书颁发机构(CA)签名的证书之前,费用将无法连接到应用程序连接器。在SAP Concur访问连接器之前,您需要安装签名证书。

身份验证

SAP Concur通过HTTPS使用匿名授权(不提供用户名和密码)向应用程序连接器发送请求。

应用程序连接器可以通过从提供的变量生成签名散列并将其与传入的值(包括SAP Concur提供的签名散列)进行比较来验证查询的真实性。签名散列所需的两个变量是用户名和密码,它们在注册应用程序连接器Web服务政府.应用程序连接器必须使用相同的用户名和密码对来生成验证签名散列。注意:用户名和密码必须至少为10个字符,以提高安全性,最大长度为50个字符。

功能

启动外部URL请求

同意费用配置

必须将费用文本表单字段配置为启动URL控件类型,并且必须在使用此标注之前将表单字段添加到所需的表单。启动URL控件类型将不会出现在列表中,直到使用启动外部URL API的合作伙伴应用程序已为本公司注册并启用。管理员必须选择单行或多行控制类型,具体取决于将放在该字段中的数据。

注:

  • 启动外部URL目前只适用于专业版。
  • 它也只能在Expense入门字段中配置。
  • 此标注不能用于标准版客户端或旅行或发票字段。

反应和错误

指的是HTTP规范页以了解常见响应和错误的详细信息。