在最新版本的SAP云平台集成中,云服务器,我们提供了一个新的API来钩住消息处理日志和适配器跟踪功能。有了这个新发布的API,适配器开发人员还可以提供有关适配器打开的HTTP端点的知识,并在Web应用程序的管理集成内容视图中显示它们,我创建了一个适配器来演示新适配器API的安装和使用。
您必须安装用于SAP云平台集成的适配器开发工具包。有关详细说明,淘客分佣系统,永久免费自助建站平台,请参阅文档。
第一步是创建一个新的适配器项目,在Eclipse中称为BlogADKAdapter。在Eclipse新适配器项目向导中,输入新适配器的详细信息,如下一屏幕截图所示。
单击Finish创建适配器。该项目包含以下文件:
编译适配器
要编译适配器项目,请使用标准Maven命令mvn install或Maven M2Eclipse插件。编译过程的输出显示在Eclipse的终端窗口或控制台视图中,生成的适配器的路径显示在build命令输出的末尾。
使用适配器
我们现在创建了一个简单的轮询机制适配器。对于这篇博文,我们修改了适配器,就像接收HTTP消息一样。
要使用新适配器,必须将适配器部署到租户并创建集成流。
首先,转到Integration Operations Eclipse透视图,从Node Explorer视图中选择租户。然后打开租户的上下文菜单,大数据app,从出现的向导中选择Deployartifacts…选择IntegrationAdapter,通过选择上面生成的BlogADKAdapter.esa网站文件。
您可以在组件状态视图Eclipse视图中看到部署的结果。
创建新的博客集成包并添加新的集成流称为BlogADKAdpaterIFlow。有关创建集成流的更多信息,请参阅文档。
在集成流中,您需要连接发送方和接收方组件,并选择新的BlogADKAdapter作为连接的适配器类型。
集成流程如下:
使用下表所示的值配置发送方适配器:
使用下表所示的值配置接收方适配器:
之后,部署集成流。
进入Web应用程序的管理集成内容视图,查看集成流的状态。您应该看到您部署的集成流:
点击监控消息处理链接,您可以看到BlogADKAdapter集成流的已处理消息。
注意:重新部署或重启集成流会触发新的消息处理。
注意:要查看详细的消息处理日志,必须至少在调试日志级别执行集成流。有关日志级别的更多信息,请参阅文档。
我们现在已经完成了适配器的初始设置。
到目前为止,我们已经开发了一个非常基本的适配器及其执行的集成流程。如果您想加入消息处理日志,跟踪或端点信息然后您必须使用新的适配器API。
安装
执行以下步骤在适配器项目中安装适配器API:
通过展开Eclipse项目的Maven Dependencies部分并查看引用的JAR文件来验证所有应用是否正确。
注意:如果您编辑pom.xml文件文件在Eclipse之外,则必须更新Eclipse中的Maven项目定义,以将更改应用于Eclipse项目设置。
集成到消息处理日志
如果适配器需要向消息处理日志添加信息,则使用com.sap.it公司.api.msglog.adapter接口随附包裹适配器API.
要添加到发送方适配器的消息日志,请修改在BlogADKAdapterConsumer类中实现的发送方适配器的现有poll()方法。下面的清单显示了BlogADKAdapterConsumer类的更新poll()方法:
AdapterMessageLogFactory的实现是由适配器运行时提供的,它不适用于单元测试。因此,必须为单元测试执行模拟工厂,或者必须通过skipTests maven选项跳过maven构建,必须部署适配器。
然后将日志级别设置为调试并重新启动集成流。
以下屏幕截图显示消息处理日志中的新步骤:
转到突出显示的步骤的步骤详细信息显示新的标题内容:
如果适配器转换负载或添加标题,则集成到跟踪
在发送或接收消息之前,这些更改将不会反映在常规跟踪中。但是,在故障排除中,大数据应用前景,查看有效负载和报头是如何接收或传输的可能是非常有用的信息。因此,如果您的适配器是这种情况,您可以将该信息提供给跟踪机制。
以下对BlogADKAdapterConsumer类的更改将在跟踪信息中设置负载并定义头条目。
如果您激活跟踪日志级别并重新启动集成流,跟踪信息将写入并显示在消息监视器的步骤详细信息视图中,如下所示。
显示端点信息
如果适配器打开HTTP端点(可以从外部调用),则端点的URL取决于部署和使用适配器的租户。根据URL路径的构建方式,用户可能很难找到要调用的正确URL。为了简化这一点,可以选择将URL显示为监视器集成内容视图的集成流详细信息的一部分,以便用户可以复制URL并使用它来配置调用该端点的客户端。