详细指导还是要看官方文档
4. 云集成管理
4.1 云集成介绍
什么是云集成?
前三章讲了很多内容,但都不是最核心的,通常我们用CPI是让他实现原来PI/PO的功能的,是用来做集成的。这章才刚开始。
云集成有以下几个特性:
- SAP Cloud Integration通过消息交换支持端到端流程集成。
- 它基于Apache软件基金会的开源框架Camel。
- 它是SAP BTP集成套件的核心功能之一。
- 开发、部署和监视在浏览器中使用图形工具进行。
- 它是LowCode/No Code工具之一。
4.1.1 连接
两端是发送方的适配器和接收方的适配器,中间是处理过程,感觉是不是和PI/PO一样了。可以处理同步和异步的消息。
发送方和接收方的适配器是不同的,哪些适配器能用取决于买的lisence。也可以自己开发适配器。
新创建一个集成
,发现支持平台还有SAP PO的选项,不明白,暂时放下。
4.1.2 集成功能
各种工件有不同的功能。详细信息更多信息
集成流可以加入各种功能,可以自由组合,可以设计出非常复杂的集成流,这也是CPI相对PIPO更灵活的特点之一,同时这也增大了我们开发集成流的难度,所以SAP在SAP Business Accelerator Hub中做了很多预定义的集成,让我们可以参考甚至直接拿来用。这里可以选择源和目标系统。
比如S/4HANA和Concur
然后就可以进入到具体的集成流中
查看相关配置和文档做参考。也可以通过导出导入的方式创建自己的集成流。
举例解读一个集成流
大概分了8个阶段:
- 将带有productid的列表数据使用SOAP的方式发送到集成流。
- 拆分出迭代数据Product List。
- 调用OData API检查每个ProductID,检查它是否在数据库中可用。
- 判定ProductID是否存在于数据库中,如果不在直接结束。如果在走第5步。
- 调用HTTP API根据ProductID获取SalesOrderLineItems (SalesOrderID, ItemPosition)。
- 迭代SalesOrderLineItems数据。
- 为每个SalesOrderLineItems (SalesOrderID, ItemPosition)条目取到SalesHeader (CustomerID)。
- 在每个SalesHeader中,选择Customer ID并将其写入数据存储。
所以这个集成流整体实现的是根据ProductID清单找到所有对应订单中的CustomerID。其中当然还有一些数据验证。
练习
4.2 开发周期
这个图主要是方便理解云集成的URL,这个例子也很容易看明白:
开发云集成最少需要分配PI_Integration_Developer角色。
4.2.1 技术实施
CPI的核心是Apache Camel应用集成开发框架,SAP通过图形客户端和各种安全特性增强了这个Camel框架。由以下组件组成:
整个过程大概是:用户通过浏览器(1)Cloud Integration URL访问实现,以创建和管理集成流。第二个组件(2)是图形界面,一旦创建了集成流,如果它作为Java应用程序部署在runtime时(Cloud Foundry, Kyma)上,(4)消息可以使用发送方组件(4)传输,并使用接收方组件(4)接收。其中负载均衡器(IP5)是连接到发送方(3)的。
上面提到集成“实现”也就是一个Java应用程序部署在runtime中占用的资源是有限的,一个CPI实现占用:
要开发一个云集成,通常是这么几步:
- 理解用户需求
- 配置BTP子账户和Integration suite
- 确认所需API,以及相关Metadata,认证,header等等
- 开始创建空白集成模版(遵守命名规范)
- 将流程模块快
- iflow逐步实现集成过程
- 测试
定期对开发状态进行版本化是很重要的,这样可以在必要时恢复到以前的版本。
模拟执行
模拟单个组件或整个集成流对于验证内容转换中的值是否设置正确,或者脚本或映射是否按预期执行非常有用。但并不是所有的集成流组件都支持模拟。
模拟执行后可以查看每一步的消息详细信息:
一旦集成流完成,就对其进行版本控制和部署,从而在RUNTIME中创建和部署Java应用程序。然后可以执行这个集成流。开发过程可以作为迭代来处理,其中组件的添减和配置,使用跟踪日志级别进行调试,以及重复测试,直到达到期望的结果。
4.3 使用消息监控和日志
除了标准的内置监视器之外,还可以使用各种工具与Cloud Integration Monitoring一起使用。它提供了不同的类别,包括消息监视、内容管理和警报管理。这里只讨论用于消息的内置监视器和API日志。
4.3.1 内置消息监控器
消息状态:
- Completed
- Processing
- Retry
- Escalated
- Failed
- Canceled
- Discarded
- Abandoned
如果将日志级别设置为trace,则可以点击trace进入到流程流的调试模式
系统日志
System Log Files 可以查看系统日志,包括HTTPs访问日志和跟踪日志,日志保存时间为30天。
这个Monitor本身也是基于Cloud Integration的API的。
所以其它系统也是可以通过API可以调用日志的。
首先需要这两个权限之一:PI_Administrator , PI_Integration_Developer
URL: https://…hana.ondemand.com:443/api/v1/LogFiles
4.3.2启用External logging
(只适用Cloud Foundry环境)适用的业务场景有很多,比如要使用splunk进行日志分析,或是对多个租户的日志进行收集,或是长期归档或是审计需求。
两个前提:
- 角色权限 AuthGroup_Admin 或是ExternalLoggingActivate
- 官方OData API的activateexternalloging功能
设置入站HTTP连接(用于API客户端)
其中这三个认证方式可以找机会再认真了解一下,这也是HTTP最常用的三种认证。
ExternalLoggingActivationRead 和 ExternalLoggingActivate
4.3.3 使用定时器事件替换开始事件
太简单,不赘述,重点是理解定时器的作用,使用定时器组件,每次部署,都可以进行触发iFlow,当然这个和scheduler的配置有关,可以选择一次性触发,也可以是周期式的触发。其中一个作用就是可以用来debug。修改后点击部署就可以触发来检查iFlow是否有问题。
4.4 Camel数据模型和简单表达式语言
4.4.1 Camel数据模型
它是下面元素的容器:
- Headers: 报头数据包含与消息相关的信息,例如消息发送者的地址,并且自动包含在任何后续的HTTP调用中
- Properties: 在消息处理期间,可以以上下文对象的形式临时存储其他数据
- Attachment: 要附加到消息的可选数据
- Body: 要在消息中传输的有效负载包含在正文中。在消息处理期间,还可以使用Exchange容器,它可以存储消息之外的其他数据。此容器由Exchange ID唯一标识,可以在消息处理期间在Properties区域中保存临时数据。存储在Exchange容器中的数据在整个消息交换期间可用,并在调用下一个处理步骤时包含在容器中。
- Others
4.4.1.1 Exchange parameters的操作
有多种方法可用于操纵交换参数:
- 使用Content Modifier组件
- 使用 Groovy SDK
- 使用 JS SDK
- 在消息映射中使用PDF
- 使用XSLT映射
- 使用Filter组件
- 使用Content Enricher组件
下面逐一说明
使用Content Modifier组件
图形化,使用方便 ,可以用来修改:
Header
Properties
Body
更多
可以直接更改负载,只需将所需的目标值直接添加到相应的字段中。可以是任何格式,纯文本,XML, JSON等。
可以直接替代负载,也可以是用表达式动态
上面这个表达式就是把原有报文加到了其中,在原有报文基础上加了一些常量。
还可以参考现有header或是properties并用在表达式里:
注意:Content Modifier是修改负载很强大的工具,但对于XML修改,建议使用其他流程步骤,因为在修改或合并XML有效负载时可能会使XML编码无效。
更多
使用 Groovy SDK
com.sap.gateway.ip.core.customdev.util.Message类提供了操纵参数的方法
例子
使用 JS SDK
同上
使用XSLT映射
另一种更改XML消息的方法是使用XSL转换,或者简而言之就是XSLT。XSLT是一种基于文本的映射脚本,它允许解析源XML并根据转换脚本生成目标XML。
创建XSLT转换
例子
使用Filter
如果有效负载是XML消息,并且我们只需要现有有效负载的某一部分,那么就可以使用Filter,Filter允许提供XML路径或简短的XPath。XPath的结果就被设置为新的有效负载。这也是修改负载的一种方式。
意思就是只允许符合条件的节点过去成为新负载。
更多
更多
使用Content Enricher组件
4.4.2 Simple Expression Language简单表达语言
简单表达式语言用于参数化Exchange parameters。它还提供了许多内置参数,如时间戳、错误消息等。这些参数我们只有读访问权限。看到这就已经明白,它是用来操作来往负载的,想要灵活控制负载,不管是header还是parameters或是body报文,就这个语言来做控制。既然是个语言一定用它的语法和内置变量以及内置表达式或函数,用的多了自然就熟了,先从认知上了解就好。
除个修改负载还可以用来动态的控制Router,掌握了这个语言就可以很自如的控制接口。
内置参数或是交换参数一般以 ${}
符号引用,在Cloud Integration中,可以将${}
占位符插入到例如Content Modifier步骤中的负载中,或者在Query Editor中应用,从而向OData资源路径添加动态值。非常重要。
${}
占位符还可以与运算符组合生成布尔表达式用来做逻辑判断,可以将其用作路由器、过滤器和更多集成流组件中的条件中。比如:
${property.MyNumericProperty} > 0
${property.MyStringProperty} contains ‚test‘
property.ProductCoderegex‚[a−z]5\d3‘
${date:now:dd-MM-yyyy HH:mm}
日常使用的参数有 :
Message Body
${in.body}
Properties
${property.}
Message Headers
${header.}
简单表达式语言可以用在:
- 使用Groovy或JavaScript编写的脚本。
- 在一些集成流组件(如Router、Content Modifier和Message Mapping)中作为用户定义的函数。
- 在XSLT映射中。
- 在一些用于查询的适配器中。
小结
Camel数据模型要结合简单表达语言来理解学习。用于管理各个集成流组件处理期间的临时数据。该数据模型不仅包括有效负载(主体),还包括属性和报头数据,它们自动包含在HTTP调用中。
每个处理步骤都将Exchange容器从前一个处理步骤传递到下一个处理步骤。交换参数可以自动设置(例如在接收消息时),也可以通过Content Modifier或Groovy SDK等组件手动设置。Camel Data Model在处理过程中管理临时数据,其中包括有效负载(主体)、属性和报头数据。报头数据自动包含在HTTP调用中。
通过简单表达式语言访问要读取的交换参数,该语言不仅包括内置参数,还允许对复杂的正则表达式进行建模。