Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
cancel
Showing results for 
Search instead for 
Did you mean: 
former_member681427
Participant
0 Kudos

写在开头


已经有很多开发人员在SAP业务技术平台(以下简称为BTP)上发布了自己的应用以及完整的解决方案。很多客户在SAP BTP业务技术平台上进行开发时,经常很困惑关于Approuter的问题,关键是还分SAP Managed Approuter和Standalone Approuter两种,使得客户和合作伙伴在开发前端应用时面临选型的疑惑,甚至想选用Standalone Approuter,但是不知道如何使用。在这篇文章里我会详细介绍如何使用Standalone Approuter配合Connectivity服务以及Destinaiton服务来消费企业内网里的数据资源。

本文用一个简单的页面index.html通过Connectivity 服务和Destination服务配合使用,从而连接到企业内网OnPremise的OData数据源。在这里不会花太多篇幅解释SAP Managed Approuter与Standalone Approuter的区别,想了解这两种approuter的区别,请移步这里了解更多。

后续还会有一篇文章讲解如何将自己的APP部署到HTML5 repository中去,并通过standalone approuter去消费后端数据源(这里数据源可以是Cloud的OData数据源也可以是OnPremise的数据源)
HTML5应用通过standalone approuter消费OData数据源

 

架构图




项目配置


前期准备




  1. 安装并配置好SAP云连接器(SAP Cloud Connector),您可以参考这里 install SAP Cloud Connector with Docker, 或者在这里下载可安装版本。




  2. 在本项目中,我们使用 ES5 作为我们后端基于ABAP的OData数据源. Configure OP system in SAP Cloud Connector, 在SAP Cloud Connector里您需要配置自己的Location ID(任何利于区分的字符串即可).




项目开发


整个文件目录结构主要包含这些内容:



  1. 在MTA.yaml中配置Destination属性.
    定义Destination名称为 es5, 可以从您配置的SAP Cloud Connector中获取到URL。并输入相应的ES5系统的用户名和密码(注意这里并不是SAP i-用户的域密码)。另外,需要添加一个参数sap-client,其值为002,注意这里的002必须用双引号括起来,否则会被转义成数字。这里的URL是SAP云连接器里配置好的Cloud To OnPremise配置里获取到。
    浏览到destination_approuter模块,将YOUR.CUSTOM.DOMAIN.COM更新为您自己的真实域名。



    ID: destination-approuter
    _schema-version: "2.1"
    version: 1.0.0

    modules:
    - name: destination_approuter
    type: approuter.nodejs
    path: approuter
    parameters:
    disk-quota: 256M
    memory: 256M
    routes:
    - route: opes5.YOUR.CUSTOM.DOMAIN.COM
    requires:
    - name: es5-xsuaa
    - name: es5-destination
    - name: es5-connectivity
    resources:
    - name: es5-connectivity
    type: org.cloudfoundry.managed-service
    parameters:
    service: connectivity
    service-plan: lite
    - name: es5-destination
    type: org.cloudfoundry.managed-service
    parameters:
    config:
    HTML5Runtime_enabled: true
    init_data:
    instance:
    destinations:
    - Authentication: BasicAuthentication
    Name: es5
    ProxyType: OnPremise
    Type: HTTP
    URL: http://<Your.OnPremise.OData.Service>;
    User: i000000
    Password: xxxxxxxxxx
    sap-client: "002"
    existing_destinations_policy: update
    version: 1.0.0
    service: destination
    service-name: es5-destination
    service-plan: lite
    - name: es5-xsuaa
    parameters:
    path: ./xs-security.json
    service-plan: application
    service: xsuaa
    type: org.cloudfoundry.managed-service



  2. 配置自定义域名
    在BTP@AliCloud上,根据法规要求合法的域名是必须项目。您可以通过命令行 cf domains来确认自己是否已经具有合法的域名。如果拥有合法域名将会显示成如下图示:

    另外,打开文件xs-security.json,按以下格式添加自己的域名到oauth2-configuration下:



    {
    "xsappname": "desttest",
    "tenant-mode": "dedicated",
    "description": "Security profile of called application",
    "scopes": [
    {
    "name": "uaa.user",
    "description": "UAA"
    }
    ],
    "role-templates": [
    {
    "name": "Token_Exchange",
    "description": "UAA",
    "scope-references": [
    "uaa.user"
    ]
    }
    ],
    "oauth2-configuration": {
    "redirect-uris": [
    "https://*.YOUR.CUSTOM.DOMAIN.COM/**"
    ]
    }
    }



  3. 检查文件xs-app.json中关于路由的配置。Destination es5应该在列,如果没有,需要按以下格式添加进去。所有URL中包含es5的请求都会路由到Destination es5。Connectivity服务作为代理功能与SAP云连接器配合打通一个从内网到云环境的通道,从而实现从云端访问内网数据源的功能。



    {
    "welcomeFile": "index.html",
    "authenticationMethod": "route",
    "routes": [
    {
    "source": "^/user-api(.*)",
    "target": "$1",
    "service": "sap-approuter-userapi"
    },
    {
    "source": "^/es5(.*)",
    "target": "$1",
    "destination": "es5"
    },
    {
    "source": "^(.*)$",
    "target": "$1",
    "authenticationType": "xsuaa",
    "localDir": "./"
    }
    ]
    }



部署应用



  1. 编译项目:

    mbt build -t ./


  2. 部署应用到Cloud Foundry:

    cf deploy destination-approuter_1.0.0.mtar


  3. 部署完成后的配置
    登陆到您的SAP BTP子账号,浏览到Instances and Subscriptions,点击es5-destination进入destination的实例,从左边菜单栏选择Destination,然后编辑destination es5,添加Location ID。这个location ID可以在您配置的SAP Cloud Connector上找到并获取。Location ID是BTP子账号与OnPremise连接的重要识别依据,是必填字段。


部署完成后,并完成相应的配置,即可测试您的应用。登陆到您的BTP子账号,进入CF org/space/Applications, 找到部署好的应用destination_approuter,即可测试。




检查最终成果


检验web应用


登陆到SAP BTP子账号,浏览到Cloud Foundry Org/Space。打开应用destination_approuter。访问URL链接打开我们的web应用。这个应用会显示我们当前登陆的用户名字。

将后缀index.html更新为/es5/Products?format=json, OnPremise系统的数据将会正常被获取并显示。