详细指导还是要看官方文档

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个阶段：

1. 将带有productid的列表数据使用SOAP的方式发送到集成流。
2. 拆分出迭代数据Product List。
3. 调用OData API检查每个ProductID，检查它是否在数据库中可用。
4. 判定ProductID是否存在于数据库中，如果不在直接结束。如果在走第5步。
5. 调用HTTP API根据ProductID获取SalesOrderLineItems (SalesOrderID, ItemPosition)。
6. 迭代SalesOrderLineItems数据。
7. 为每个SalesOrderLineItems (SalesOrderID, ItemPosition)条目取到SalesHeader (CustomerID)。
8. 在每个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应用程序。然后可以执行这个集成流。开发过程可以作为迭代来处理，其中组件的添减和配置，使用跟踪日志级别进行调试，以及重复测试，直到达到期望的结果。

练习：创建一个package和空白iFlow

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进行日志分析，或是对多个租户的日志进行收集，或是长期归档或是审计需求。

两个前提：

1. 角色权限 AuthGroup_Admin 或是ExternalLoggingActivate
2. 官方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调用中。
通过简单表达式语言访问要读取的交换参数，该语言不仅包括内置参数，还允许对复杂的正则表达式进行建模。

Content modifier实例