auroraidoc设计说明及开发指南大学论文.docx

资源描述

auroraidoc设计说明及开发指南大学论文.docx

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

auroraidoc设计说明及开发指南大学论文.docx

auroraidoc设计说明及开发指南大学论文

HandEnterpriseSolutions

AURORA-IDOC设计说明及开发指南

作者:

Jinxiao.lin

建档日期:

2011/7/10

最近更新:

2013/5/23

控制号:

版本:

1.3

Note:

ControlNumberandVersionaremarkedbyaWordBookmarksothattheycanbeeasilyreproducedintheheaderandfooterofdocuments.Whenyouchangeeitherofthesevalues,becarefulnottoaccidentallydeletethebookmark.YoucanmakebookmarksvisiblebyselectingTools->Options匳iewandcheckingtheBookmarksoptionintheShowregion.

审批:

ProjectManager

拷贝号_____

文档控制

记录更改

日期

作者

版本

文档状态

更改参考

2013/5/23

Jinxiao.lin

1.3

2011/11/24

Jinxiao.lin

1.2

2011/11/1

ru.lu

1.1

2011/7/10

Xiaopeng.zhu

1.0

Draft1.0

创建

Jinxiao.lin

Xiaochen.shi（SAP）

审阅人

姓名

职位

分发

拷贝号

姓名

职位

Note:

ThecopynumbersreferencedaboveshouldbewrittenintotheCopyNumberspaceonthecoverofeachdistributedcopy.Ifthedocumentisnotcontrolled,youcandeletethistableandtheCopyNumberlabelfromthecoverpage.

（9-Dec-96）

文档目录

（9-Dec-96）

基本概念介绍

SAPIDoc介绍

IDoc的全称是IntermediateDocument，是SAP用于传输业务数据的一种数据格式。

IDoc主要功能

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

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

IDoc文件例子

xmlversion="1.0"?

EDI_DC40

800

0000000000940780

701

MATMAS05

MATMAS

SAPIDS

IDSCLNT800

A000000071

HANDMAS

20110620

142202

20110620142200

005

000000000000002203

20110312

3047

20110312

3047

FERT

000

0.000

0.0

00000000

NORM

0.0

0.000

0.0

0.000

005

111

005

0.000

IDoc的数据结构

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节点下除第一个子节点外的其余节点。

AuroraIDoc

AuroraIDoc是基于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项目

部署目录结构：

bin

Startup.bat和startup.sh

shutdown.bat和shutdwon.sh

MYSERVER.jcoServer

BCE.jcoDestination

log4j.properties（可选）

WEB-INF

uncertain.xml

uncertain.local.xml

aurora.plugin.sap.sync.idoc

Idoc.config

aurora.database

datasource.config

Aurora.feature

service-logging.config

lib

aurora.jar

classes12.jar（JDBC驱动）

其他jar包

classes

feedback_proc_sample.proc

fnd_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.progid

sap注册的ProgramID

HAND1

jco.server.name

SAP的服务器名字

IDS

jco.server.gwhost

192.168.11.28

jco.server.gwserv

端口号

sapgw00

jco.server.unicode

编码

jco.server.repository_destination

指向<文件名称>.jcoDestination这个文件

BCE

参数

说明

例子

jco.client.lang

语言

jco.client.client

环境

800

jco.client.user

密码

1332

jco.client.passwd

用户

handsap

jco.client.sysnr

端口号

00（加上sapgw就是MYSERVER.jcoServer中的jco.server.gwserv属性值）

jco.client.ashost

192.168.11.28

5.BCE.jcoDestinat

开放端口

在service文件，它在windows和unix系统下路径分别是：

1.Windows系统在C:

\Windows\System32\drivers\etc\service

2.unxi或linux在/etc/services

注：

unix/linux刷新服务的命令：

refresh–sinetd。

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

添加以下内容：

sapdp003200/tcp

sapdp013201/tcp

sapdp023202/tcp

sapdp033203/tcp

sapdp043204/tcp

sapdp053205/tcp

sapdp063206/tcp

sapdp073207/tcp

sapdp083208/tcp

sapdp093209/tcp

sapdp103210/tcp

sapdp113211/tcp

sapdp123212/tcp

sapdp133213/tcp

sapdp143214/tcp

sapdp153215/tcp

sapdp163216/tcp

sapdp173217/tcp

sapdp183218/tcp

sapdp193219/tcp

sapdp203220/tcp

sapdp213221/tcp

sapdp223222/tcp

sapdp233223/tcp

sapdp243224/tcp

sapdp253225/tcp

sapdp263226/tcp

sapdp273227/tcp

sapdp283228/tcp

sapdp293229/tcp

sapdp303230/tcp

sapdp313231/tcp

sapdp323232/tcp

sapdp333233/tcp

sapdp343234/tcp

sapdp353235/tcp

sapdp363236/tcp

sapdp373237/tcp

sapdp383238/tcp

sapdp393239/tcp

sapdp403240/tcp

sapdp413241/tcp

sapdp423242/tcp

sapdp433243/tcp

sapdp443244/tcp

sapdp453245/tcp

sapdp463246/tcp

sapdp473247/tcp

sapdp483248/tcp

sapdp493249/tcp

sapdp503250/tcp

sapdp513251/tcp

sapdp523252/tcp

sapdp533253/tcp

sapdp543254/tcp

sapdp553255/tcp

sapdp563256/tcp

sapdp573257/tcp

sapdp583258/tcp

sapdp593259/tcp

sapdp603260/tcp

sapdp613261/tcp

sapdp623262/tcp

sapdp633263/tcp

sapdp643264/tcp

sapdp653265/tcp

sapdp663266/tcp

sapdp673267/tcp

sapdp683268/tcp

sapdp693269/tcp

sapdp703270/tcp

sapdp713271/tcp

sapdp723272/tcp

sapdp733273/tcp

sapdp743274/tcp

sapdp753275/tcp

sapdp763276/tcp

sapdp773277/tcp

sapdp783278/tcp

sapdp793279/tcp

sapdp803280/tcp

sapdp813281/tcp

sapdp823282/tcp

sapdp833283/tcp

sapdp843284/tcp

sapdp853285/tcp

sapdp863286/tcp

sapdp873287/tcp

sapdp883288/tcp

sapdp893289/tcp

sapdp903290/tcp

sapdp913291/tcp

sapdp923292/tcp

sapdp933293/tcp

sapdp943294/tcp

sapdp953295/tcp

sapdp963296/tcp

sapdp973297/tcp

sapdp983298/tcp

sapdp993299/tcp

sapgw003300/tcp

sapgw013301/tcp

sapgw023302/tcp

sapgw033303/tcp

sapgw043304/tcp

sapgw053305/tcp

sapgw063306/tcp

sapgw073307/tcp

sapgw083308/tcp

sapgw093309/tcp

sapgw103310/tcp

sapgw113311/tcp

sapgw123312/tcp

sapgw133313/tcp

sapgw143314/tcp

sapgw153315/tcp

sapgw163316/tcp

sapgw173317/tcp

sapgw183318/tcp

sapgw193319/tcp

sapgw203320/tcp

sapgw213321/tcp

sapgw223322/tcp

sapgw233323/tcp

sapgw243324/tcp

sapgw253325/tcp

sapgw263326/tcp

sapgw273327/tcp

sapgw283328/tcp

sapgw293329/tcp

sapgw303330/tcp

sapgw313331/tcp

sapgw323332/tcp

sapgw333333/tcp

sapgw343334/tcp

sapgw353335/tcp

sapgw363336/tcp

sapgw373337/tcp

sapgw383338/tcp

sapgw393339/tcp

sapgw403340/tcp

sapgw413341/tcp

sapgw423342/tcp

sapgw433343/tcp

sapgw443344/tcp

sapgw453345/tcp

sapgw463346/tcp

sapgw473347/tcp

sapgw483348/tcp

sapgw493349/tcp

sapgw503350/tcp

sapgw513351/tcp

sapgw523352/tcp

sapgw533353/tcp

sapgw543354/tcp

sapgw553355/tcp

sapgw563356/tcp

sapgw573357/tcp

sapgw583358/tcp

sapgw593359/tcp

sapgw603360/tcp

sapgw613361/tcp

sapgw623362/tcp

sapgw633363/tcp

sapgw643364/tcp

sapgw653365/tcp

sapgw663366/tcp

sapgw673367/tcp

sapgw683368/tcp

sapgw693369/tcp

sapgw703370/tcp

sapgw713371/tcp

sapgw723372/tcp

sapgw733373/tcp

sapgw743374/tcp

sapgw753375/tcp

sapgw763376/tcp

sapgw773377/tcp

sapgw783378/tcp

sapgw793379/tcp

sapgw803380/tcp

sapgw813381/tcp

sapgw823382/tcp

sapgw833383/tcp

sapgw843384/tcp

sapgw853385/tcp

sapgw863386/tcp

sapgw873387/tcp

sapgw883388/tcp

sapgw893389/tcp

sapgw903390/tcp

sapgw913391/tcp

sapgw923392/tcp

sapgw933393/tcp

sapgw943394/tcp

sapgw953395/tcp

sapgw963396/tcp

sapgw973397/tcp

sapgw983398/tcp

sapgw993399/tcp

前台配置

前台配置需要：

一个基于Web的Aurora项目。

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

配置JCO功能。

1.添加JCO相关文件

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

xmlversion="1.0"encoding="UTF-8"?

sap-configxmlns:

jco="aurora.plugin.sap.jco3">

instance-config

server_ip="192.168.11.11"

sid="BP5"

sap_client="300"

userid="HAND.ZST"

password="abc123"

default_lang="ZH"

max_conn="5"

展开阅读全文