auroraidoc设计说明及开发指南.docx

auroraidoc设计说明及开发指南.docx

《auroraidoc设计说明及开发指南.docx》由会员分享，可在线阅读，更多相关《auroraidoc设计说明及开发指南.docx（6页珍藏版）》请在冰豆网上搜索。

auroraidoc设计说明及开发指南

aurora-idoc设计说明及开发指南

aurora-idoc设计说明及开发指南HandEnterpriseSolutionsAURORA-IDOC设计说明及开发指南作者:

Jinxiao.lin建档日期:

2011/7/10最近更新:

2013/5/23控制号:

版本:

1.3Note:

ControlNumberandVersionaremarkedbyaWordBookmarksothattheycanbeeasilyreproducedintheheaderandfooterofdocuments.Whenyouchangeeitherofthesevalues,becarefulnottoaccidentallydeletethebookmark.YoucanmakebookmarksvisiblebyselectingTools->Options匳iewandcheckingtheBookmarksoptionintheShowregion.审批:

ProjectManager拷贝号_____文档控制记录更改日期作者版本文档状态更改参考2013/5/23Jinxiao.lin1.32011/11/24Jinxiao.lin1.22011/11/1ru.lu1.12011/7/10Xiaopeng.zhu1.0Draft1.0创建Jinxiao.linXiaochen.shi（SAP）审阅人姓名职位分发拷贝号姓名职位1234Note:

ThecopynumbersreferencedaboveshouldbewrittenintotheCopyNumberspaceonthecoverofeachdistributedcopy.Ifthedocumentisnotcontrolled,youcandeletethistableandtheCopyNumberlabelfromthecoverpage.（9-Dec-96）文档目录文档控制ii基本概念介绍1SAPIDoc介绍1IDoc主要功能1IDoc文件例子1IDoc的数据结构2IDoc文件2AuroraIDoc2AuroraIDoc事务流程3项目实施4部署4从公司cvs下载最新的aurora_idoc项目4修改配置文件4开放端口5前台配置10配置JCO功能。

10在系统中注册配置页面，效果如下：

11管理14启动和关闭AuroraIDoc14监控，查询数据14数据库表14起初配置表14运行时表15SAPIDOC配置16配置接收/发送IDOC系统（TCODE:

SALE）16定义RFC目标系统（TCODE:

SM59）17配置IDOC端口（TCODE:

WE21）18创建段类型（TCODE:

WE31）19创建IDOC类型（TCODE:

WE30）19定义消息类（TCODE:

WE81）20把基本类型分配给消息类型（TCODE:

WE82）21分配模型视图（TCODE:

BD64）21把消息类型加入伙伴参数文件的出站参数22编写代码23把idoc设置成后台自动发送（TCODE:

sm36）24察看IDOC发送情况（TCODE:

WE02和sm59）24SAP网关配置24常见问题28附件30配置页面文件30（9-Dec-96）27CompanyConfidential-Forinternaluseonly基本概念介绍SAPIDoc介绍IDoc的全称是IntermediateDocument，是SAP用于传输业务数据的一种数据格式。

IDoc主要功能IDoc主要用于系统间的数据同步，数据发起方是SAP,接受方是另一方系统。

举例来说，在一个特定的SAP服务器配置了IDoc之后，当一个SAP用户创建一张采购订单，其信息会自动通过IDoc传输给另一方系统，此系统根据接受到的数据，在本系统中自动创建一张销售订单。

IDoc文件例子EDI_DC4080000000000009407807013012MATMAS05MATMASSAPIDSLSIDSCLNT800A000000071LSHANDMAS2011062014220220110620142200005000000000000002203201103123047201103123047KFERTMEA0000.0000.0000.0000.0000.0000.0000.0000.0000.0000.00.000000K000000000000000000NORM0.00.00.0000.00.0000.0000.00000051111ZH005EA110.0000.0000.0000.0000.000000.000IDoc的数据结构IDoc的数据结构分三个层次：

1.IDoc类型（idoctype）2.段（segment）3.字段（field）不同的IDoc类型用于处理不同类型的信息。

比如IDoc格式ORDERS01可用于采购订单（PurchaseOrder）和订单确认（OrderConfirmation）。

IDoc类型下可以定义一个或多个段。

段类似于数据库中的表，段可以有层次结构，即段可以有父段，也可以有子段。

段下定义一个或多个字段，类似于数据库中的表字段。

IDoc文件一个IDoc文件包含两种数据：

1.控制记录（ControlRecord）：

包含IDoc类型、伙伴端口、SAPR/3的版本等信息。

对应上面文件中IDOC节点的第一个子节点。

2.数据记录（DataRecord）：

包含段和字段的数据信息。

对应上面文件中的IDOC节点下除第一个子节点外的其余节点。

AuroraIDocAuroraIDoc是基于Aurora框架研发出来的一款产品。

它独立部署，不依赖于任何Web容器，并且可以部署在windows、unix和linux等各种操作系统上。

AuroraIDoc事务流程1.AuroraIDoc启动时会登录SAP，并向SAP注册一个ProgramID。

2.当SAP系统有数据新增或更改时，向上述的ProgramID发送IDoc数据流。

3.AuroraIDoc接收到IDoc数据流，并以XML文件的形式保存在指定的文件目录中。

4.AuroraIDoc解析此XML文件，并根据预先配置的对应关系，数据插入临时表中。

5.在插入临时表后，调用项自定义的客户化数据库package，把临时表中德数据插入到正式业务表中。

6.在成功插入业务表后，再把解析的数据插入系统通用的接口表（FND_INTERFACE_HEADERS，FND_INTERFACE_LINES），作为数据备份。

7.根据配置决定是否删除此xml文件。

8.给sap方一个反馈信息，这个步骤可选。

注：

以上七个步骤都是全自动化的操作，项目实施时只需要做两件事：

1.配置对应关系2.编写客户化数据库package项目实施部署从公司cvs下载最新的aurora_idoc项目部署目录结构：

binStartup.bat和startup.shshutdown.bat和shutdwon.shMYSERVER.jcoServerBCE.jcoDestinationlog4j.properties（可选）WEB-INFuncertain.xmluncertain.local.xmlaurora.plugin.sap.sync.idocIdoc.configaurora.databasedatasource.configAurora.featureservice-logging.configlibaurora.jarclasses12.jar（JDBC驱动）其他jar包classesfeedback_proc_sample.procfnd_idoc_feedbacks.bm这个结构跟tomcat的结构基本类似，仅稍有不同：

bin目录是跟web-inf目录是同级的，并减少了很多其他目录和文件。

用户只需把自定义的config文件放入web-inf下，把jar包放入lib下，并把其他资源（如果需要）放入bin目录下，在classes目录下放置反馈给sap的程序文件，部署即完成。

修改配置文件1.datasource.config：

数据库连接2.idoc.config：

idoc配置文件3.uncertain.xml：

日志文件路径4.MYSERVER.jcoServer参数含义例子jco.server.progidsap注册的ProgramIDHAND1jco.server.nameSAP的服务器名字IDSjco.server.gwhostIP192.168.11.28jco.server.gwserv端口号sapgw00jco.server.unicode编码1jco.server.repository_destination指向.jcoDestination这个文件BCE参数说明例子jco.client.lang语言ENjco.client.client环境800jco.client.user密码1332jco.client.passwd用户handsapjco.client.sysnr端口号00（加上sapgw就是MYSERVER.jcoServer中的jco.server.gwserv属性值）jco.client.ashostIP192.168.11.285.BCE.jcoDestinat开放端口在service文件，它在windows和unix系统下路径分别是：

1.Windows系统在C:

\Windows\System32\drivers\etc\service2.unxi或linux在/etc/services注：

unix/linux刷新服务的命令：

refresh–sinetd。

如果这个命令没效果，请重启系统试试。

添加以下内容：

sapdp003200/tcpsapdp013201/tcpsapdp023202/tcpsapdp033203/tcpsapdp043204/tcpsapdp053205/tcpsapdp063206/tcpsapdp073207/tcpsapdp083208/tcpsapdp093209/tcpsapdp103210/tcpsapdp113211/tcpsapdp123212/tcpsapdp133213/tcpsapdp143214/tcpsapdp153215/tcpsapdp163216/tcpsapdp173217/tcpsapdp183218/tcpsapdp193219/tcpsapdp203220/tcpsapdp213221/tcpsapdp223222/tcpsapdp233223/tcpsapdp243224/tcpsapdp253225/tcpsapdp263226/tcpsapdp273227/tcpsapdp283228/tcpsapdp293229/tcpsapdp303230/tcpsapdp313231/tcpsapdp323232/tcpsapdp333233/tcpsapdp343234/tcpsapdp353235/tcpsapdp363236/tcpsapdp373237/tcpsapdp383238/tcpsapdp393239/tcpsapdp403240/tcpsapdp413241/tcpsapdp423242/tcpsapdp433243/tcpsapdp443244/tcpsapdp453245/tcpsapdp463246/tcpsapdp473247/tcpsapdp483248/tcpsapdp493249/tcpsapdp503250/tcpsapdp513251/tcpsapdp523252/tcpsapdp533253/tcpsapdp543254/tcpsapdp553255/tcpsapdp563256/tcpsapdp573257/tcpsapdp583258/tcpsapdp593259/tcpsapdp603260/tcpsapdp613261/tcpsapdp623262/tcpsapdp633263/tcpsapdp643264/tcpsapdp653265/tcpsapdp663266/tcpsapdp673267/tcpsapdp683268/tcpsapdp693269/tcpsapdp703270/tcpsapdp713271/tcpsapdp723272/tcpsapdp733273/tcpsapdp743274/tcpsapdp753275/tcpsapdp763276/tcpsapdp773277/tcpsapdp783278/tcpsapdp793279/tcpsapdp803280/tcpsapdp813281/tcpsapdp823282/tcpsapdp833283/tcpsapdp843284/tcpsapdp853285/tcpsapdp863286/tcpsapdp873287/tcpsapdp883288/tcpsapdp893289/tcpsapdp903290/tcpsapdp913291/tcpsapdp923292/tcpsapdp933293/tcpsapdp943294/tcpsapdp953295/tcpsapdp963296/tcpsapdp973297/tcpsapdp983298/tcpsapdp993299/tcpsapgw003300/tcpsapgw013301/tcpsapgw023302/tcpsapgw033303/tcpsapgw043304/tcpsapgw053305/tcpsapgw063306/tcpsapgw073307/tcpsapgw083308/tcpsapgw093309/tcpsapgw103310/tcpsapgw113311/tcpsapgw123312/tcpsapgw133313/tcpsapgw143314/tcpsapgw153315/tcpsapgw163316/tcpsapgw173317/tcpsapgw183318/tcpsapgw193319/tcpsapgw203320/tcpsapgw213321/tcpsapgw223322/tcpsapgw233323/tcpsapgw243324/tcpsapgw253325/tcpsapgw263326/tcpsapgw273327/tcpsapgw283328/tcpsapgw293329/tcpsapgw303330/tcpsapgw313331/tcpsapgw323332/tcpsapgw333333/tcpsapgw343334/tcpsapgw353335/tcpsapgw363336/tcpsapgw373337/tcpsapgw383338/tcpsapgw393339/tcpsapgw403340/tcpsapgw413341/tcpsapgw423342/tcpsapgw433343/tcpsapgw443344/tcpsapgw453345/tcpsapgw463346/tcpsapgw473347/tcpsapgw483348/tcpsapgw493349/tcpsapgw503350/tcpsapgw513351/tcpsapgw523352/tcpsapgw533353/tcpsapgw543354/tcpsapgw553355/tcpsapgw563356/tcpsapgw573357/tcpsapgw583358/tcpsapgw593359/tcpsapgw603360/tcpsapgw613361/tcpsapgw623362/tcpsapgw633363/tcpsapgw643364/tcpsapgw653365/tcpsapgw663366/tcpsapgw673367/tcpsapgw683368/tcpsapgw693369/tcpsapgw703370/tcpsapgw713371/tcpsapgw723372/tcpsapgw733373/tcpsapgw743374/tcpsapgw753375/tcpsapgw763376/tcpsapgw773377/tcpsapgw783378/tcpsapgw793379/tcpsapgw803380/tcpsapgw813381/tcpsapgw823382/tcpsapgw833383/tcpsapgw843384/tcpsapgw853385/tcpsapgw863386/tcpsapgw873387/tcpsapgw883388/tcpsapgw893389/tcpsapgw903390/tcpsapgw913391/tcpsapgw923392/tcpsapgw933393/tcpsapgw943394/tcpsapgw953395/tcpsapgw963396/tcpsapgw973397/tcpsapgw983398/tcpsapgw993399/tcp前台配置前台配置需要：

一个基于Web的Aurora项目。

在做配置时，确保此项目连接的数据库和AuroraIDoc连接的数据是一致的。

配置JCO功能。

1.添加JCO相关文件在WEB-INF目录下创建目录aurora.plugin.sap，然后在这个目录下创建sap.config文件，将SAP服务器的连接配置到文件中，内容如下：

属性名描述server_ipSAP服务器的ip地址sid为当前sap实例命名，方便引用sap_clientSAP中client的概念user_idSaprfc用户名password密码default_lang设定jco连接语言max_connJco连接池最大连接数system_numberSap中系统标识2.修改uncertain.xml文件，添加黄色底色部分在系统中注册配置页面，效果如下：

1.同步IDOC结构打开“同步IDOC结构”功能，页面如下：

这个页面form中的参数请sap人员协助配置，具体可参考下图的参数：

点击段类型，查看段下的字段，效果如下：

这个功能主要是从SAP方获取IDoc的结构。

获取IDOC结构后，可以快速配置对应关系。

2.配置对应关系打开“IDOC对应关系”功能，管理SAP段和数据库表的对应关系。

建立对应关系后，AuroraIDoc在接收到IDoc数据时，能够根据对应关系，把段和字段的内容插入到数据库对应的表中。

界面配置如下：

点击“快速生成对应表和对应关系”按钮后，系统依据IDOC结构，用动态SQL自动生成名称相同的表和字段结构。

这些自动被创建的表统称为临时表。

3.配置IDOC类型对应的存储过程在数据根据对应关系插入到数据库的临时表中后，AuroraIDoc调用一个存储过程，把临时表中的数据插入到正式业务表中。

这个存储过程，根据项目业务场景自行编写。

如果需要在同步完程序后，给sap方一个反馈，请配置“反馈程序”，文件目录在classes下。

配置页面如下：

“有次序”这个属性表示，IDoc数据是否有严格的次序。

如果某次同步IDOC数据发生异常后，下次再次接收到同一个IDoc类型的数据，是否处理？

选中就是不处理，不选中，就是继续处理。

管理和监控启动和关闭AuroraIDoc1.启动进入bin目录，运行startup.bat或startup.sh文件2.停止进入bin目录，运行shutdown.bat或shutdown.sh文件。

3.查看日志查看uncertain.local.xml中定义的log目录。

监控日志和数据1.查看aurora\web\bin\dev_jco_rfc.trc文件，可以获取与SAP交互出错信息。

2.查看aurora\web\logs下，可以获取到AURORA抛出的信息3.查看fnd_idoc_files表可以获取到IDOC同步的步骤状态注意：

SAP方更改IDocsegment或者field后，需要重新启动AuroraIDoc才能正确接收到更新后的结构文件。

数据库表起初配置表表名说明fnd_idoc_segmentsIDOC段结构表fnd_idoc_fieldsIDoc字段结构表fnd_idoc_segment_mapsIDOC段和数据库表对应关系表fnd_idoc_field_mapsIDOC字段和数据库表字段对应关系表fnd_idoc_typesIDOC类型对应的存储过程表运行时表表名说明fnd_idoc_serversIDOC服务连接表fnd_idoc_files接收到的idoc文件表fnd_interface_headersAurora系统标准接口头表fnd_interface_linesAurora系统标准接口行表fnd_idoc_trx_sample仅测试用，假定是正式的业务表SAPIDOC配置配置接收/发送IDOC系统（TCODE:

SALE）定义接收逻辑系统：

输入一个逻辑系统名及其描述：

定义RFC目标系统（TCODE:

SM59）SM59里有很多不同的连接类型:

a.ABAPConnections:

连接远程SAP系统的,需要提供作为SAPCLIENT调用系统时的各种参数b.InternalConnections:

连接外部HTTP服务,需要提供URL.c.TCP/IPconnections:

通过TCP/IP层面调用外部服务.此处选用TCP/IP方式连接.由于接口是从SAP向外部系统抛送的方式,所以在配置RFC连接时需要RegisteredS