BTP 使用SPA开发工作流

1、前言

目前SAP ABAP 工作流比较难用，BTP上的工作流比较简单便捷。

BTP上面有两款服务可以执行工作流，一种是workflow management 配合Business Rules Services简称BRS，还有一种是接下来会介绍的SP Bulide Process Automation 简称SBPA。

SBPA是从SAP iRPA发展来的，然后再2021年发展为了SPA，除了保留原有的传统的可以自动化处理企业的重复性流程，降低企业成本。SPA增添了workflow的的功能，可以进行审批页面。2023年开始发展为SBPA，在原有的功能上，添加了api触发的手段。

我做的例子是物料主数据的审批，下面介绍整个流程。

2、SPA 创建workflow

 2.1、创建一个流程Process

2.2、创建一个API Trigger

2.3、创建一个审批通知邮件

 2.3.1、编辑mail process ( 这里首先必须要保证SPA要具备 Outlook的SDK )

 send email 步骤

 2.4、添加一个Approval Form

2.5、审批成功的记录调用API写入结果到对应的后台服务器

 2.5.1、获取token

由于我消费的API是需要token验证的odata接口，所以这里需要调用两次 Call Web Service

2.5.2、消费API

这里注意，我们取的token是返回参数的header数据，这里如果我们再call web service后面添加一个log message的话，会发现并没有headers参数数据。但是其实是存在的，获取header数据的步骤是：

Step2.obj.headers['x-csrf-token']

 2.6、在完成开发和测试之后，需要点击release和deploy。

然后再Monitor页签的Tri 

 点击view，可以看到调用服务的API，但是注意BTP的上面你的API服务一般都是需要用到oauth 2.0的。

 3、消费SPA的API

3.1、查找spa的token以及相关clientId 或者密码等。

再BTP Cockpit控制台处，点击实例和订阅

找到SPA服务的key，点击

 下图分别展示着SPA服务对应的url , clientid,clientsecret

 3.2、postman测试API

如下图所示，在相应的位置填入相应的内容 

 然后点击get new access token

在弹出框点击use token，然后

在body里面填入相应的报文，点击send

 说明spa没有问题。

3.3、配置spa服务对应的destination

点击Service Instance

选择SPA Instance

 创建之后效果如下

 3.4、Bas开发触发app的功能

3.4.1、在xs-app.json里面配置好destination

 source中就是之前在destinations中添加的配置

3.4.2、ajax调用API

sap.ui.define(["sap/ui/model/json/JSONModel"
], function(JSONModel) {return {fetchToken: function (oController,oData) {var that = this;var oThisController = oController;oThisController.getView().setBusy(true);$.ajax({url: this._getWorkflowRuntimeBaseURL(oController)+ "/xsrf-token",//"/comsapbpmDocumentCentricStartUI/workflowruntime/v1/xsrf-token",method: "GET",headers: {"X-CSRF-Token": "Fetch"},success: function (result, xhr, data) {// After retrieving the xsrf token successfullyvar workflowtoken = data.getResponseHeader("X-CSRF-Token");// Values entered by the user stored in the payload and push to the server.that.startInstance(workflowtoken,oController,oData);},error: function (jqXHR, textStatus, errorThrown) {//MessageBox.error("Error occurred while fetching work-flow access token.");var sErrorText = oThisController.getMessage("WORKFLOW_ACCESS_TOKEN_ERROR");MessageBox.error(sErrorText + "\\n Error:" + errorThrown + ".");oThisController.oBusyDialog.close();return;}});},_getWorkflowRuntimeBaseURL: function (oController) {var appId = oController.getOwnerComponent().getManifestEntry("/sap.app/id");var appPath = appId.replaceAll(".", "/");var appModulePath = jQuery.sap.getModulePath(appPath);return appModulePath + "/spaWorkflowMaterial/v1";},startInstance:function(workflowtoken,oController,oData){var oThisController = oController;// oMdlCommon = oThisController.getParentModel("mCommon");var sUrl = this._getWorkflowRuntimeBaseURL(oController) + "/workflow-instances";//"/comsapbpmDocumentCentricStartUI/workflowruntime/v1/workflow-instances";var sDefinitionId2 = "cn40.syntax.workflowapply.applyPropcess";var sPayload = {"definitionId": sDefinitionId2,"context": {"materialline": {"Mateiral": oData.Matnr,"MatGrp": oData.Matkl,"Unit": oData.Meins,"Receipter": "user039@sap-hackathon.io","MateiralDesc": oData.Maktx,"ProductId": oData.Spart,"OldMaterial":oData.Bismt,"RejectReason":""}}};$.ajax({url: sUrl,method: "POST",dataType: "json",crossDomain: false,contentType: "application/json",data: JSON.stringify(sPayload),cache: true,headers: { // pass the xsrf token retrieved earlier"X-CSRF-Token": workflowtoken},success: function (data) {MessageBox.success("Request '" +  "' is submitted.");},error: function (jqXHR, textStatus, errorThrown) {oThisController.getView().setBusy(false);var sErrorText = oThisController.getMessage("WORKFLOW_SERVICE_ERROR");MessageBox.error(sErrorText + "\\n Error: " + errorThrown + ".");return;}});},createWorkflowInstance:function(oController, oJsonModel){var oData = oJsonModel.getData();this.fetchToken(oController,oData);}
});

 3.5、失败

这时候如果报错http 403，就需要看看是不是fetch token那里是不是有问题，去network那里看看request header那里是不是有问题

如果是httlp 500 错误，这时候应该是没有根据xs-app.json那里的source和ajax的路径拼接上正确的url。

这时候首先检查xs-app，然后检查ajax的url是不是和destination的名字一样

如果都没有问题的话，点击控制台，进去这个服务看看里面是不是有spa 的detination。

如果没有的话，从控制台cockpit那里导出一份，然后着服务里面impot。