SAP CPI 教程002 Message Mapping(CPI如何调用SAP的webservice）

01CPI

SAP Cloud Platform Integration (CPI) 是 SAP 新一代的云端集成平台，核心功能是帮助企业快速、安全地连接各种云端和本地系统，打破数据孤岛，实现业务流程自动化。它既提供了低代码的开发环境，也内置了丰富的预置连接器和模板，能显著降低集成的门槛和工作量。

   1.1核心功能速览

下表汇总了 SAP CPI 的主要功能模块，方便你快速了解：

02Message Mapping

简单来说，它的作用可以概括为：实现不同系统之间数据格式的转换和语义的映射。：

1. 可视化构建数据转换逻辑

CPI 提供了一个基于浏览器的图形化映射编辑器，允许集成开发人员通过拖拽连线的方式，直观地建立源字段与目标字段之间的映射关系。这种方式无需编写大量代码，降低了实现复杂转换的门槛，并且映射逻辑一目了然，便于维护。

2. 支持多种数据格式之间的互转

与 PI/PO 类似，CPI 的 Message Mapping 能够处理异构系统间的数据格式差异，支持的转换类型包括：

• XML ↔ XML

• JSON ↔ JSON

• XML ↔ JSON

• XML ↔ CSV（通过额外的解析器或脚本辅助）

• JSON ↔ CSV

这使得 CPI 能够轻松连接现代 REST API（通常使用 JSON）与传统企业系统（通常使用 XML 或 IDoc）等不同技术栈的端点。

3. 内置丰富的函数库与脚本能力

在映射过程中，Message Mapping 提供了大量预置函数，用于实现常见的转换需求：

• 字符串处理：拼接、截取、替换、正则匹配等。

• 数学运算：求和、平均值、取整等。

• 日期/时间格式化：在不同格式之间转换。

• 条件映射：使用 if、choose 等结构实现分支逻辑。

• 值映射：根据查找表将源值转换为目标值（如代码转换）。

当标准函数不足以满足业务逻辑时，CPI 的 Message Mapping 允许嵌入 Groovy 脚本 或 XSLT 来编写自定义函数，实现高度灵活的转换。

4. 处理复杂的数据结构

对于包含循环、嵌套、层级关系的复杂消息（例如采购订单包含抬头、多个行项目、每个行项目又包含多个计划行），Message Mapping 能够精准地处理：

• 1:1 映射：简单字段直接对应。

• 1:N / N:1 映射：将源结构中的多个元素合并为一个，或将一个元素拆分为多个。

• 上下文管理：通过分组或索引来控制循环内部的映射关系，确保输出结构正确。

5. 作为集成流中的可复用组件

在 CPI 的集成流（Integration Flow）中，Message Mapping 通常以 “映射”步骤（Mapping Step） 的形式存在。一个映射步骤可以引用一个设计好的 Message Mapping 对象，并且同一个映射对象可以被多个集成流复用，提高了开发效率和一致性。

6. 云原生特性带来的优势

与 PI/PO 相比，CPI 的 Message Mapping 还具备以下云原生特点：

• 零基础设施管理：无需部署和运维映射引擎，完全由 SAP 云平台托管。

• Web 化协作：开发人员可以直接在浏览器中完成映射设计，支持版本管理和团队协作。

• 无缝集成 CPI 的其他能力：可以与 CPI 的内容修改器（Content Modifier）、路由器（Router）、参与者（Participant）等步骤协同工作，形成完整的集成流程。

03实战CPI访问S4提供的Webservice服务

① SAP函数发布webservice服务（网上有很多教程，所以这里就不详细罗列具体步骤）

②在CPI场景中我们先一个Message Mapping的控件，作用就是做数据转换的。这里介绍一个XSD与wsdl文件如何转换映射的步骤。在这个步骤之前，我们需要把文件上传的集成流程中，点集成流程的空白区域，有个参考的TAB页签，我们可以在这里上传需要的文件。

③双击Message Mapping，就是映射关系绑定的地方，左边这个是xsd文件，右边是sap提供的webservice文件，文件配置关系后，我们可以模拟测试下。

发送xml文件
 

<root>
<id>
   <anzhl>998</anzhl>
   <begda>2026-03-07</begda>
   <pernr>3063</pernr>
   <lgart>14001508</lgart>
</id>
<id>
   <anzhl>998</anzhl>
   <begda>2026-03-08</begda>
   <pernr>3063</pernr>
   <lgart>14001508</lgart>
</id>
</root>

xsd文件生成工具

https://www.freeformatter.com/xsd-generator.html#before-output

网站生成的xsd文件导入到Message Mapping左边的xsd文件中。

<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">  <xs:element name="root">    <xs:complexType>      <xs:sequence>        <xs:element name="id" maxOccurs="unbounded" minOccurs="0">          <xs:complexType>            <xs:sequence>              <xs:element type="xs:short" name="anzhl"/>              <xs:element type="xs:date" name="begda"/>              <xs:element type="xs:short" name="pernr"/>              <xs:element type="xs:int" name="lgart"/>            </xs:sequence>          </xs:complexType>        </xs:element>      </xs:sequence>    </xs:complexType>  </xs:element></xs:schema>

注意：

在选择webservice服务地址的时候，不能直接贴soamanager生成的地址给外围系统。可以有两种方法识别暴露给外围系统的地址。

方案一：可以在soapui工具导入我们在soamanager下载的文件，然后通过工具识别地址。

方式二：我们可以打开wsdl文件找到location的位置，后面就是给外围系统调用的地址。

例如在CPI系统中配置调用SAP的webservice服务，下面就是填写的地址。