|
汉得PI&PO教材系列 |
|
|
|
Adapter使用-实例1：File2File |
|
仅限汉得内部使用 |
作者：汉得顾问 版本：1.0 日期：2017-02-01 |
图标
|
图标 |
含义 |
|
警告 |
|
|
示例 |
|
|
注释 |
|
|
建议 |
|
|
语法 |
|
|
外部处理 |
|
|
可选业务处理或决定 |
排版惯例
|
字体风格 |
描述 |
|
Example text |
出现在屏幕上的单字或字符。包括字段名、屏幕标题、按钮以及菜单名、路径和选项。 到其它文档的交叉引用。 |
|
Example text |
正文文本中强调的字或词组，图形和表格的标题。 |
|
EXAMPLE TEXT |
系统中元素的名称。包括报表名、程序名、事务代码、表名和正文文本中嵌入的编程语言关键字，如 SELECT 和 INCLUDE。 |
|
Example text |
屏幕输出。包括文件和目录的名称及其路径、消息、源代码、变量和参数的名称以及安装工具、更新工具和数据库工具的名称。 |
|
EXAMPLE TEXT |
键盘上的按键。例如，功能键（如F2）或ENTER键。 |
|
Example text |
用户输入原文。完全如文档所示输入这些单字或字符至系统中。 |
|
<Example text> |
可变用户输入。尖括号表示应使用适当的输入替换括号中的单字和字符。 |
目录
1、文档说明... 3
2、文档历史... 4
3、功能说明... 4
4、操作步骤-定义IR对象... 5
4.1 定义Data Type. 6
2.2 定义Message Type. 7
2.3 定义Service Interface. 8
2.4 定义Message Mapping. 9
2.5 定义Operation Mapping. 10
5、 操作步骤-定义ID对象... 11
5.1 定义发送方Communication Channel 11
5.2 定义接收方Communication Channel 13
5.3 定义Integrated Configuration. 14
6、传输监控... 17
1、文档说明
本文档目的在于提供一个File2File场景的接口案例，用于说明File适配器如何使用，以及使用File适配器的注意事项以及最佳使用实践。
使用本案例指导已经具有操作基础的人使用“浏览器+Jar工具（另一个工具是NWDS）”实现文件接口。
2、文档历史
|
版本 |
修订时间 |
修订人 |
备注 |
|
0.1 |
2016年11月1日 |
张宇 |
根据培训案例整理出该文档 |
|
1.0 |
2017年02月1日 |
雷小平 |
审核以及修订文档内容，增加说明 |
|
|
|
|
|
|
|
|
|
|
3、功能说明
本案例中发送方系统为第三方系统BS_Training_demo，接收方系统也为第三方系统BS_Training_demo，即发送方和接收方都为同一个系统。实际使用，则根据实际系统来配置不通的业务系统作为数据发送方和接收方。
实际的文件目录也是PO服务器的某个文件路径，分别是：发送方路径为/tmp/pofile/from/；接收方路径为/tmp/pofile/to/。
详细功能为读取服务器上/tmp/pofile/from/test.txt的文件内容，发送至路径/tmp/pofile/to/下，生成contact.xml文件； 发送方文件格式如下；
接收方为对应的XML文件。
本案例发送的为简单的联系人数据。
注意file适配器只能配置异步接口，且由PO系统排定后台作业。
4、操作步骤-定义IR对象
异步方式发送，所需IR对象如下图：
4.1 定义Data Type
定义发送方Data Type
定义接收方Data Type
2.2 定义Message Type
定义发送方Message Type，关联发送方Data Type
定义接收方Message Type，关联接收方Data Type
2.3 定义Service Interface
定义发送方Service Interface，属性是Outnound，选择异步方式，关联发送方Message Type
定义接收方Service Interface，属性是Inbound，选择异步方式，关联接收方Message Type
2.4 定义Message Mapping
异步方式下只有一个MM，选择发送方Message Type，接收方Message Type，匹配字段对应关系
2.5 定义Operation Mapping
选择发送方Service Interface，接收方Service Interface，选择Message Mapping
5、 操作步骤-定义ID对象
所需ID对象如下图，先定义Configuration Scenario（可以理解为接口场景对象的容器，用于组织ID对象用，通常将构成一个接口的所有对象放到一个Configuration Scenario，同一个对象可以放到多个Configuration Scenario，便于组织构成接口的完整对象）
5.1 定义发送方Communication Channel
定义发送方Communication Channel，选择发送方Business System（BS_Training_demo），选择File适配器，输入源文件路径，文件名。
定义前确定源文件的位置和格式：
位置为本服务器上的目录/tmp/pofile/from/test.txt
内容格式如下：
然后定义读取文件的CC
此处定义的文件名可以带“*”，表示模糊读取符合文件名规则的文件。
此处可以定义定期读取文件的周期，上述截图维护的周期为0，表示激活即读取一次，后去不再周期性读取。
输入发送方Message Type，输入Data Type中定义的数据集，及数据结构；
根据数据源文件的格式定义读取规则：
字段以“;”分割，即text文件字段的分割符
每行数据以换行符结束，
维护字段名映射顺序
5.2 定义接收方Communication Channel
指定数据接收方业务系统（BS_Training_demo），选择File适配器，维护接收文件路径，接收文件名
文件名可以是消息好，也可以加上时间戳作为文件名的部分。
5.3 定义Integrated Configuration
输入发送方业务系统（BS_Training_demo），输入发送方Service Interface，发送方Communication Channel
维护接收方业务系统（BS_Training_demo）
维护接收方Service Interface
维护接收方Communication Channel
保存，激活，查看传输日志。
6、传输监控
文件适配器激活起即执行一次文件读取，然后根据定义的读取周期，到期即读取一次。
监控截图此处省略，请参考监控文档。
标签：定义,Adapter,汉得,发送,文档,file2file,Message,接收,Type From： https://www.cnblogs.com/ZJY-1314/p/18157158