服务mysql下载

NEAL-NET试点示范项目开发与接入指南文档编号:NEAL-NET标准接入指南当前版本号:Draft0.
4最初发布日期:2011年8月31日最新修订日期:2012年4月10日版本号版本日期修改内容修订人Draft0.
12011-8-31创建初稿万鹏洲、林安Draft0.
22011-9-14修改查询接口与返回接口部分内容吴一舟Draft0.
32011-11-23添加直连和通过中间平台访问两种使用场景添加Frosstrek使用说明万鹏洲Draft0.
42012-4-14添加其他要求章节万鹏洲Draft0.
52012-4-24添加10.
4章节万鹏洲Draft0.
62012-6-25完善10.
4章节内容胡歆Draft0.
62012-7-18添加5.
3章节用户认证接口内容林浩庭目录1概述52服务交换理念53规范性引用文件54应用场景64.
1服务提供方---服务调用方直接互联64.
2服务提供方---服务交换中心---服务调用方互联75接口描述75.
1查询接口(动态船舶查询)75.
1.
1查询报文结构75.
1.
2数据项说明85.
1.
3查询参数95.
1.
4Request示例95.
2返回接口(动态船舶查询)115.
2.
1返回报文结构115.
2.
2数据项说明125.
2.
3Response示例155.
3查询接口(集装箱状态查询)195.
3.
1查询报文结构195.
3.
2数据项说明195.
3.
3查询参数205.
3.
4Request示例215.
4返回接口(集装箱状态查询)225.
4.
1返回报文结构225.
4.
2数据项说明235.
4.
3Response示例255.
5用户认证接口275.
5.
1用户认证描述275.
5.
2数据项说明275.
5.
3REQUEST示例中的用户认证部分:276其他要求286.
1数据更新要求286.
2数据保存要求286.
3服务响应要求287服务提供商接入指南287.
1获取资料287.
2服务培训297.
3系统开发297.
4测试环境联调297.
5正式环境联调与发布298服务调用方接入指南298.
1获取资料298.
2服务培训308.
3系统开发308.
4应用场景308.
5测试联调309附录30A-数据元定义概要(动态船舶查询)30B-OutlineofDataItemDefinition(集装箱状态查询)32C-FosstrakEPCIS介绍339.
1JDK/JRE349.
2ApacheTomcat349.
3MySQL下载安装配置359.
4App应用下载安装配置359.
5建立数据库和测试数据导入369.
6客户端使用36103710.
1数据元字典定义3710.
2接口事件格式定义3810.
3查询客户端工具3810.
4SOAP报文监听工具38概述NEAL-NET是东北亚物流信息服务网络(NortheastAsiaLogisticsInformationServiceNetwork)的英文缩写,是一个实现网络内各国之间物流信息互联互通的物流高速通的平台.
其目的是为了提高网络内各个国家内和各个国家之间物流效率和服务能力,推进物流信息资源共享,促进经济和运输服务贸易发展.

NEAL-NET是以服务交换的理念为设计原则,以国际上物流行业通用的EPCIS为设计标准进行建设的.
目前已经完成了中日韩三国的动态船期查询服务,并已经接入相关企业进行试点运行.
本指南给出了NEAL-NET平台的信息查询服务的接口规范以及接入方法.
本指南适用于NEAL-NET平台船舶动态信息查询服务的设计与开发.
服务交换理念所谓的服务交换,是指作为数据拥有方的各类企业单位或实体,通过服务交换中心发布自身的已有服务,作为服务提供方对外提供数据服务.
服务需求方通过服务交换中心,有选择性的调用已发布的服务.
包括建立一套统一的服务交换技术标准体系;发布一组服务交换标准函数;搭建一个为服务提供方发布服务,服务需求方检索服务,并有服务整合能力的服务交换中介平台.
建立一套统一的服务交换技术标准体系是指依据目前国际上在物流行业有成熟应用的EPCIS系统,结合国内物流行业实际应用环境与需求,建立一套可以在物流链上下游的政府部门,企事业单位之间使用的通信体系,为提供统一,安全,有序、开放的服务交换制定标准,从而实现货品在整个物流链的全程化,全方位的状态跟踪.

发布一组服务服务交换标准函数是针对目前已经存在的应用需求,依据服务交换标准,对具体的应用进行抽象,整理出服务交换标准函数.
服务提供方和服务需求方可以根据规范化的标准函数进行开发,针对同一种服务,实现一处开发,多处使用,降低服务提供方和服务需求方的设计费用和二次开发费用.

搭建一个为服务提供方发布服务,服务需求方检索服务,并有服务整合能力的服务交换中介平台是指在目前物流行业信息化发展不均衡,服务提供方和服务需求方信息化程度参差不齐的背景下,造成服务提供方与服务需求方难以互相被检索到,或者是服务提供方与服务需求方没有足够的技术力量将各自服务或需求以信息化的形式表达出来,搭建一个以服务中介为目的的服务交换中心,把服务提供方按照标准服务函数开发的服务进行注册管理,统一向服务需求方进行发布,并提供技术支持,配合双方进行测试联调,实现服务供需双方快速安装配置,推动服务交换理念的推广.

规范性引用文件EPCIS是货物电子标签信息系统ElectronicProductCodeInformationServices的英文缩写,是由EPCGlobal(http://www.
gs1.
org/epcglobal)所发布一系列标准所组成.
EPC是一种被认为是下一代标准货物编码,类似条形码,EPC也是用来唯一标识货物,但是EPC比条形码有更大的信息容量.

EPCIS的目标是通过促使企业中或企业间不同的应用程序中与货物电子标签相关数据的共享,最终达到供应链的中所有参与各方状态可查询和可追溯.
其详细介绍以及最新开发文档都可以在其官方网站得到.
按照本指南进行开发的文档有Epcis_1_0-schema-20070412.
zip该文件包含EPCGlobal颁布的EPC标准文档,用于确定报文格式.
epcis_1_0_1-standard-20070921.
pdf该文件包含EPCGlobal发布的使用说明.
应用场景服务提供方---服务调用方直接互联服务提供方依据服务交换标准体系,遵照已有服务标准函数,对自身系统进行改造,发布应用服务.
服务需求方根据自身业务需要,寻找到提供相应服务的服务提供商,并依据服务交换标准体系,遵照已有服务标准函数,对自身系统进行改造,与服务提供商进行直连,从而完成服务的输入与输出.
该类场景适用于服务交换标准体系推广应用成熟阶段,且服务供需双方业务量较大的情况下.
服务提供方---服务交换中心---服务调用方互联服务提供方依据服务交换标准体系,遵照已有服务标准函数,对自身系统进行改造,开发应用服务,并将该应用服务注册到服务交换中心.
服务交换中心会将服务提供方注册上来的服务进行审核,归类,并通过标准服务函数进行发布,同时提供服务整合和服务检索.
该类场景适用于服务交换标准体系推广阶段.
接口描述作为服务提供方,需要根据EPCIS标准对外发布服务接口.
作为服务需求方,需要根据EPCIS标准接入标准服务接口.
查询接口采用SOAP报文格式进行传输.
业务数据的数据格式采用EPCIS标准,根据EPCIS的规范进行SOAP绑定到SOAP包体内部.
报文格式必须符合SOAP标准和EPCIS标准.
本指南的说明将针对船舶动态信息查询的具体实现进行表述.
查询接口(动态船舶查询)查询报文结构序号报文层XML标记中文名称出现次数数据类型和长度11soap:Envelope1.
.
122soap:Header0.
.
132soap:Body1.
.
143Poll方法名1.
.
1标签54queryName查询名称1.
.
1常量:SimpleEventQuery64Params查询参数集1.
.
1标签75Param查询参数0.
.
n标签86Name查询参数名1.
.
196Value1.
.
1107String查询值0.
.
n数据项说明(1)soap:Envelopesoap报文根节点(2)soap:Headersoap报文包头部分.
在目前应用中没有使用,可以忽略该节点.
(3)soap:Bodysoap报文包体部分.
(4)Poll调用方法定义,在其内部需要对外部引用的命名空间进行声明,统一写法如下:(5)queryName查询名称定义,目前统一使用常量SimpleEventQuery.
(6)Params查询参数集,标签节点,不填写具体值.
(7)Param查询参数,标签节点,不填写具体值.
(具体请见5.
1.
3查询参数)(8)Name查询参数名称,具体取值参看附录A.
(9)Value查询参数值,参数取值类型参看附录A,不同的类型表示方法不同,具体方法如下:String类型ObjectEventAggregationEventQuantityEventTransactionEventTime类型2011-08-02T10:00:00.
123ZInt类型2查询参数序号参数名称参数类型功能是否必须实现1eventTypeListofString查询事件类型是2GE_eventTimeTime大于等于发生时间是3LT_eventTimeTime小于发生时间是4GE_recordTimeTime大于等于记录时间可选5LT_recordTimeTime小于记录时间可选6EQ_actionListofString等于活动类型是7EQ_bizStepListofString等于业务阶段代码是8EQ_dispositionListofString等于状态可选9EQ_readPointListofString等于读取点可选10WD_readPointListofStringLIKE读取点可选11EQ_bizLocationListofString等于港口(码头)代码是12WD_bizLocationListofStringLIKE港口(码头)代码是13EQ_bizTransaction_typeListofString等于交易类型可选14MATCH_epcListofStringLIKECallSign编号是15MATCH_parentIDListofStringLIKE父ID可选16MATCH_anyEPCListofStringLIKE任意EPCID可选17MATCH_epcClassListofStringLIKE任意EPC类型可选18EQ_quantityInt等于数量可选19GT_quantityInt大于数量可选20GE_quantityInt大于等于数量可选21LT_quantityInt小于数量可选22LE_quantityInt小于等于数量可选23EQ_#IMONumberlistofstring等于IMO代码是24EQ_#VoyageNumberlistofstring等于航次代码是25orderByString排序是26orderDirectionString排序方向是27eventCountLimitInt事件返回数量是28maxEventCountInt最大事件数是Request示例示例一:根据CallSign代码为urn:un:NEALNET:data:standard:UNCEFACT:CallSign:OZGQ2和航次代码为118E进行查询.
SimpleEventQueryeventTypeObjectEventMATCH_epcurn:un:NEALNET:data:standard:UNCEFACT:CallSign:OZGQ2EQ_http://www.
nealnet.
org/tracking/extensions/#VoyageNumber118E示例二:根据IMO代码为IMO9235555和航次代码为118W进行查询.
SimpleEventQueryeventTypeObjectEventEQ_http://www.
nealnet.
org/tracking/extensions/#IMONumberIMO9235555EQ_http://www.
nealnet.
org/tracking/extensions/#VoyageNumber118W返回接口(动态船舶查询)返回报文结构序号报文层XML标记中文名称出现次数数据类型和长度11soap:Envelope1.
.
122soap:Header0.
.
132soap:Body1.
.
111QueryResults查询结果1.
.
1标签22queryName查询名称1.
.
1常量32resultsBody查询结果集1.
.
1标签43EventList事件列表1.
.
1标签54ObjectEvent对象事件1.
.
n标签65eventTime事件发生时间1.
.
1Time75recordTime记录时间1.
.
1Time85eventTimeZoneOffset事件发生时区1.
.
1常量95epcList1.
.
1标签106EpcCallSign编号1.
.
1115Action活动类型1.
.
1125bizStep业务阶段代码1.
.
1135bizLocation港口(码头)代码1.
.
1标签146Id代码值1.
.
1155nealnet:VesselName船名0.
.
1扩展字段165nealnet:VoyageNumber航次代码0.
.
1扩展字段175nealnet:IMONumberIMO代码0.
.
1扩展字段185nealnet:ShippingCompanyCode船公司代码0.
.
1扩展字段195nealnet:EstimatedTimeOfArrival预计到港时间0.
.
1扩展字段205nealnet:EstimatedTimeOfBerthing预计靠泊时间0.
.
1扩展字段215nealnet:EstimatedTimeOfDeparture预计离港时间0.
.
1扩展字段225nealnet:CyOpenDateTime集装箱场开放时间0.
.
1扩展字段235nealnet:CyCutDateTime集装箱场关闭时间0.
.
1扩展字段245nealnet:LastPortCode上港代码0.
.
1扩展字段255nealnet:NextPortCode下港代码0.
.
1扩展字段265nealnet:CourseLine航线代码0.
.
1扩展字段数据项说明1.
标准数据项说明(1)soap:Envelopesoap报文根节点(2)soap:Headersoap报文包头部分.
在目前应用中没有使用,可以忽略该节点.
(3)soap:Bodysoap报文包体部分.
(4)QueryResults查询结果,标签节点,不填写具体值.
在其内部需要对外部引用的命名空间进行声明,统一的写法如下:(5)queryName查询名称定义,目前统一使用常量SimpleEventQuery.
(6)resultsBody查询结果集,标签节点,不填写具体值.
(7)EventList事件列表,标签节点,不填写具体值.
(8)ObjectEvent对象事件,标签节点,不填写具体值.
(9)eventTime时间发生时间,填写该事件实际发生的时间,数据类型为时间类型.
(10)recordTime记录发生时间,填写该事件被记录进入系统的时间,数据类型为时间类型.
(11)eventTimeZoneOffset事件发生时区,填写事件发生所在时区信息.
中国为+08:00.
(12)epcList报告单号列表,标签节点,不填写具体值.
(13)EpcCallSign代码,填写对应船舶的CallSign代码,CallSign代码数据格式具体参阅附录B.
(14)Action活动类型,具体取值参阅附录B.
(15)bizStep业务阶段代码,具体取值参阅附录B.
(16)bizLocation港口(码头)代码,标签节点,不填写具体值.
(17)Id港口(码头)代码值,填写港口(码头)代码,数据格式具体参阅附录B.
2.
扩展字段数据项以下是船舶动态信息查询业务特有的扩展字段,当扩展字段的值不为空时,按照字段标准格式在报文中输出该结构,如果为空,则忽略该字段,不在报文中输出.
(1)nealnet:VesselName船名,数据格式参阅附录B.
写法如下:YUANFENG11(2)nealnet:VoyageNumber航次代码,数据格式参阅附录B.
写法如下:1104J(3)nealnet:IMONumberIMO代码,数据格式参阅附录B.
写法如下:IMO0000111(4)nealnet:ShippingCompanyCode船公司代码,数据格式参阅附录B.
写法如下:DXF(5)nealnet:EstimatedTimeOfArrival预计到港时间,数据格式参阅附录B.
写法如下:2011-08-02T00:00:01.
000+08:00(6)nealnet:EstimatedTimeOfBerthing预计靠泊时间,数据格式参阅附录B.
写法如下:2011-08-02T00:00:01.
000+08:00(7)nealnet:EstimatedTimeOfDeparture预计离港时间,数据格式参阅附录B.
写法如下:2011-08-02T00:00:01.
000+08:00(8)nealnet:CyOpenDateTime集装箱场开放时间,数据格式参阅附录B.
写法如下:2011-08-02T00:00:01.
000+08:00(9)nealnet:CyCutDateTime集装箱场关闭时间,数据格式参阅附录B.
写法如下:2011-08-02T00:00:01.
000+08:00(10)nealnet:LastPortCode上港代码,数据格式参阅附录B.
写法如下:CNYIN(11)nealnet:NextPortCode下港代码,数据格式参阅附录B.
写法如下:CNYIN(12)nealnet:CourseLine航线代码,数据格式参阅附录B.
写法如下:CNNMXResponse示例示例一:返回根据CallSign代码为urn:un:NEALNET:data:standard:UNCEFACT:CallSign:OZGQ2和航次代码为118E的查询结果,共2条记录.
SimpleEventQuery2011-09-02T00:17:19.
0+08:002011-09-02T00:17:19.
0+08:00+08:00urn:un:NEALNET:data:standard:UNCEFACT:CallSign:OZGQ2ADDurn:un:nealnet:codelist:standard:UNCEFACT:SubLocationCode:CNNGB.
BLCTYD2011-05-11T00:00:00.
000+08:00MAEUCNAANIMO9235555MAERSKGIRONDE118EAUBNEJPYOK2011-09-02T00:17:19.
0+08:002011-09-02T00:17:19.
0+08:00+08:00urn:un:NEALNET:data:standard:UNCEFACT:CallSign:OZGQ2OBSERVEurn:un:unece:uncefact:codelist:standard:UNECE:StatusCode:139urn:un:nealnet:codelist:standard:UNCEFACT:SubLocationCode:CNNGB.
BLCTYDMAEU2011-05-11T00:00:00.
000+08:002011-05-12T00:00:00.
000+08:00IMO9235555MAERSKGIRONDE118EAUBNEJPYOK示例二:返回根据IMO代码为IMO9235555和航次代码为118W的查询结果,共2条记录.
SimpleEventQuery2011-09-02T00:17:19.
0+08:002011-09-02T00:17:19.
0+08:00+08:00urn:un:NEALNET:data:standard:UNCEFACT:CallSign:OZGQ2OBSERVEurn:un:nealnet:codelist:standard:UNCEFACT:SubLocationCode:CNNGB.
BLCTYD2011-05-12T00:00:00.
000+08:00MAEUCNAAN2011-07-05T09:00:01.
000+08:002011-07-12T13:30:01.
000+08:00IMO9235555MAERSKGIRONDE118WAUBNEJPYOK2011-09-02T00:17:19.
0+08:002011-09-02T00:17:19.
0+08:00+08:00urn:un:NEALNET:data:standard:UNCEFACT:CallSign:OZGQ2DELETEurn:un:unece:uncefact:codelist:standard:UNECE:StatusCode:24urn:un:nealnet:codelist:standard:UNCEFACT:SubLocationCode:CNNGB.
BLCTYDMAEU2011-05-11T00:00:00.
000+08:002011-05-12T00:00:00.
000+08:002011-07-05T09:00:01.
000+08:002011-07-12T13:30:01.
000+08:00IMO9235555MAERSKGIRONDE118WAUBNEJPYOK查询接口(集装箱状态查询)查询报文结构序号报文层XML标记中文名称出现次数数据类型和长度11soap:Envelope1.
.
122soap:Header0.
.
132soap:Body1.
.
143Poll方法名1.
.
1标签54queryName查询名称1.
.
1常量:SimpleEventQuery64Params查询参数集1.
.
1标签75Param查询参数0.
.
n标签86Name查询参数名1.
.
196Value1.
.
1107String查询值0.
.
n数据项说明(1)soap:Envelopesoap报文根节点(2)soap:Headersoap报文包头部分.
在目前应用中没有使用,可以忽略该节点.
(3)soap:Bodysoap报文包体部分.
(4)Poll调用方法定义,在其内部需要对外部引用的命名空间进行声明,统一写法如下:(5)queryName查询名称定义,目前统一使用常量SimpleEventQuery.
(6)Params查询参数集,标签节点,不填写具体值.
(7)Param查询参数,标签节点,不填写具体值.
(具体请见5.
1.
3查询参数)(8)Name查询参数名称,具体取值参看附录A.
(9)Value查询参数值,参数取值类型参看附录A,不同的类型表示方法不同,具体方法如下:String类型ObjectEventAggregationEventQuantityEventTransactionEventTime类型2011-08-02T10:00:00.
123ZInt类型2查询参数序号参数名称参数类型功能是否必须实现1eventTypeListofString查询事件类型是2GE_eventTimeTime大于等于发生时间是3LT_eventTimeTime小于发生时间是4GE_recordTimeTime大于等于记录时间可选5LT_recordTimeTime小于记录时间可选6EQ_actionListofString等于活动类型是7EQ_bizStepListofString等于业务阶段代码是8EQ_dispositionListofString等于状态可选9EQ_readPointListofString等于读取点可选10WD_readPointListofStringLIKE读取点可选11EQ_bizLocationListofString等于港口(码头)代码是12WD_bizLocationListofStringLIKE港口(码头)代码是13EQ_bizTransaction_typeListofString等于交易类型可选14MATCH_epcListofStringLIKECallSign编号是15MATCH_parentIDListofStringLIKE父ID可选16MATCH_anyEPCListofStringLIKE任意EPCID可选17MATCH_epcClassListofStringLIKE任意EPC类型可选18EQ_quantityInt等于数量可选19GT_quantityInt大于数量可选20GE_quantityInt大于等于数量可选21LT_quantityInt小于数量可选22LE_quantityInt小于等于数量可选23orderByString排序是24orderDirectionString排序方向是25eventCountLimitInt事件返回数量是26maxEventCountInt最大事件数是Request示例示例:根据ContainerNumber(集装箱号)代码为urn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:ALP:HLXU4691920和航次代码为JW123进行查询.

SimpleEventQueryeventTypeObjectEventMATCH_epcurn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:ALP:HLXU4691920EQ_http://www.
nealnet.
org/tracking/extensions/#VoyageNumberJW123返回接口(集装箱状态查询)返回报文结构序号报文层XML标记中文名称出现次数数据类型和长度11soap:Envelope1.
.
122soap:Header0.
.
132soap:Body1.
.
111QueryResults查询结果1.
.
1标签22queryName查询名称1.
.
1常量32resultsBody查询结果集1.
.
1标签43EventList事件列表1.
.
1标签54ObjectEvent对象事件1.
.
n标签65eventTime事件发生时间1.
.
1Time75recordTime记录时间1.
.
1Time85eventTimeZoneOffset事件发生时区1.
.
1常量95epcList1.
.
1标签106EpcCallSign编号1.
.
1115Action活动类型1.
.
1125bizStep业务阶段代码1.
.
1135bizLocation港口(码头)代码1.
.
1标签146Id代码值1.
.
1155nealnet:VoyageNumber航次代码0.
.
1扩展字段165nealnet:IMONumberIMO代码0.
.
1扩展字段175nealnet:ContainerOperatorCode船公司编码,参照标准为StandardCarrierAlphaCode(SCAC)0.
.
1扩展字段185nealnet:ContainerSizeType运输工具大小和类型,参照标准为ISO6346transportequipmentsizeandtypecode0.
.
1扩展字段195nealnet:ContainerGrossWeight集装箱总重量0.
.
1扩展字段205nealnet:ContainerSealNumber集装箱封箱号0.
.
1扩展字段215nealnet:ContainerLoadingStatus集装箱装载状态,例如:F为满仓,E为空仓0.
.
1扩展字段225nealnet:VehicleLicensePlateNumber车牌号0.
.
1扩展字段数据项说明1.
标准数据项说明(1)soap:Envelopesoap报文根节点(2)soap:Headersoap报文包头部分.
在目前应用中没有使用,可以忽略该节点.
(3)soap:Bodysoap报文包体部分.
(4)QueryResults查询结果,标签节点,不填写具体值.
在其内部需要对外部引用的命名空间进行声明,统一的写法如下:(5)queryName查询名称定义,目前统一使用常量SimpleEventQuery.
(6)resultsBody查询结果集,标签节点,不填写具体值.
(7)EventList事件列表,标签节点,不填写具体值.
(8)ObjectEvent对象事件,标签节点,不填写具体值.
(9)eventTime时间发生时间,填写该事件实际发生的时间,数据类型为时间类型.
(10)recordTime记录发生时间,填写该事件被记录进入系统的时间,数据类型为时间类型.
(11)eventTimeZoneOffset事件发生时区,填写事件发生所在时区信息.
中国为+08:00.
(12)epcList报告单号列表,标签节点,不填写具体值.
(13)EpcContainerNumber(集装箱号)代码,填写对应集装箱的ContainerNumber代码,ContainerNumber代码数据格式具体参阅附录B.
(14)Action活动类型,具体取值参阅附录B.
(15)bizStep业务阶段代码,具体取值参阅附录B.
(16)bizLocation港口(码头)代码,标签节点,不填写具体值.
(17)Id港口(码头)代码值,填写港口(码头)代码,数据格式具体参阅附录B.
2.
扩展字段数据项以下是集装箱状态信息查询业务特有的扩展字段,当扩展字段的值不为空时,按照字段标准格式在报文中输出该结构,如果为空,则忽略该字段,不在报文中输出.
(1)nealnet:VoyageNumber航次代码,数据格式参阅附录B.
写法如下:1104J(2)nealnet:IMONumberIMO代码,数据格式参阅附录B.
写法如下:IMO1234567(3)nealnet:ContainerOperatorCode船公司代码,数据格式参阅附录B.
写法如下:MSC(4)nealnet:ContainerSizeType预计到港时间,数据格式参阅附录B.
写法如下:22G1(5)nealnet:ContainerGrossWeight预计靠泊时间,数据格式参阅附录B.
写法如下:100(6)nealnet:ContainerSealNumber预计离港时间,数据格式参阅附录B.
写法如下:1401081(7)nealnet:ContainerLoadingStatus集装箱场开放时间,数据格式参阅附录B.
写法如下:F(8)nealnet:VehicleLicensePlateNumber集装箱场关闭时间,数据格式参阅附录B.
写法如下:ZJB-14238Response示例示例:返回根据ContainerNumber代码为urn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:ALP:HLXU4691920和航次代码为JW123的查询结果,共2条记录.

SimpleEventQuery2011-09-02T00:17:19.
0+08:002011-09-02T00:17:19.
0+08:00+08:00urn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:ALP:HLXU4691920ADDurn:un:unece:uncefact:codelist:standard:UNECE:StatusCode:13urn:un:nealnet:codelist:standard:UNCEFACT:SubLocationCode:CNNGB.
BLCTYDMAEUIMO1234567JW1231001401081F2011-09-02T00:17:19.
0+08:002011-09-02T00:17:19.
0+08:00+08:00urn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:ALP:HLXU4691920OBSERVEurn:un:unece:uncefact:codelist:standard:UNECE:StatusCode:12urn:un:nealnet:codelist:standard:UNCEFACT:SubLocationCode:CNNGB.
BLCTYDMAEUIMO1234567JW123F用户认证接口用户认证描述NEAL-NET目前支持使用用户名加密码来验证请求用户的身份.
服务提供方可以根据自身业务系统的实际情况决定是否以该方式实现用户安全认证.
在REQUEST报文的soap:Header里加上用户名与密码,服务提供方用户名和密码来判断该用户的类型和合法性,进而返回与该用户类型想匹配的数据查询结果.
数据项说明(1)soap:Headersoap报文包头部分.
(2)Security安全认证标签,里面包含用户名标签和密码标签.
(3)UserName服务需求方的用户名,统一写法如下:NEALuserCN(4)PassWord服务需求方的密码,统一写法如下:cn0926!
REQUEST示例中的用户认证部分:NEALuserCNcn0926!
其他要求数据更新要求服务提供商应保证数据的及时更新,以达到跟踪高效的目的.
建议动态船期的数据与业务生产库的数据的延时应保证在30分钟以内.
数据保存要求服务提供商应对数据予以一定时间的保留,根据动态船期的业务需要,要求数据保存3个月,在三个月以内的动态船期数据都可以实时查询到.
超过三个月的数据可以不保留以保证服务的高效性.
服务响应要求服务提供商应提供高效响应的查询服务以达到最好的用户体验.
根据许多研究表明,用户最满意的响应时间是2秒以下.
根据服务交换架构的需要,要求使用查询客户端在服务本地或者本地局域网内进行数据查询时,返回时间不得超过2秒.

服务提供商接入指南获取资料服务接入指南:开发商从NEAL-NET获取本接入指南.
EPCIS标准:开发商从NEAL-NET获取使用的EPCIS标准的版本信息,从NEAL-NET或EPCglobal(http://www.
gs1.
org/epcglobal/)获得相应的标准文档.
服务函数定义与数据项定义:开发商需要从NEAL-NET获取最新的相应服务的函数定义与数据项定义,并对定义进行理解和沟通.
测试地址:开发商需要从NEAL-NET获取相应的测试地址以供测试使用.
测试工具:开发商可以从NEAL-NET获取测试工具,配合开发.
服务培训NEAL-NET提供相关EPCIS标准版本信息,服务函数定义、数据项定义等相关技术标准与内容的培训,开发商可自行决定是否参与NEAL-NET组织的技术培训.
系统开发组织业务数据:开发商根据服务函数定义与数据项定义,结合业务流程,对自身的业务系统数据进行组织整理,建立符合函数定义的数据结构.
组织报文:开发商根据报文的标准格式,开发查询输入接口和结果输出接口.
(注:也可以基于FosstrakEPCIS进行快速开发,详细见附录B-FosstrakEPCIS介绍)发布WS:开发商将接口以WebService形式进行发布.
内部集成测试:开发商使用枢纽提供的查询客户端自行进行测试,测试服务的联通性,数据的合规性和服务的效率性.
测试环境联调开发商向枢纽申请将webservice服务注册到服务交换中心,必须先通过测试环境进行联调,填写必要的服务注册信息、验证信息等资料.
在测试环境联调通过后,需提交测试联调文档.
正式环境联调与发布开发商向枢纽申请将webservice服务注册到服务交换中心,填写必要的服务注册信息、验证信息等资料.
枢纽对注册信息进行审查,并在正式环境与开发商对服务进行联调测试,测试通过后,在服务交换中心对webservice进行对外发布.
服务调用方接入指南获取资料服务接入指南:开发商从NEAL-NET获取本接入指南.
EPCIS标准:开发商从NEAL-NET获取使用的EPCIS标准的版本信息,从NEAL-NET或EPCglobal(http://www.
gs1.
org/epcglobal/)获得相应的标准文档.
服务培训NEAL-NET提供相关EPCIS标准版本信息等相关技术标准与内容的培训,开发商可自行决定是否参与NEAL-NET组织的技术培训.
系统开发组织报文:开发商根据报文的标准格式,开发查询输入接口和结果输出接口.
应用场景在软件客户端中完成接口升级改造后,在客户端中设置具体的应用场景,明确服务调用的方式和使用场景.
测试联调在改造升级的软件客户端上查询服务交换中心所提供的webservice服务.
附录A-数据元定义概要(动态船舶查询)序号EPCIS事件定义数据元名称功能描述URI示例是否必须实现1epcRadioCallSigns国际海运组织用来调用船只,代码由字母和数字组成,通常为4-5个字符urn:un:NEALNET:data:standard:UNCEFACT:Callsignurn:un:NEALNET:data:standard:UNCEFACT:CallSign:ACBCD必选2bizstepStatusCode贸易运输状态代码,电子申报发生的状态信息urn:un:unece:uncefact:codelist:standard:UNECE:StatusCodeurn:un:unece:uncefact:codelist:standard:UNECE:StatusCode:139必选3bizlocationPortCode港口(码头)的唯一标识符,前五位为港口代码,采用国际标准.
后五位为码头代码,由港口自己定义.
urn:nealnet:codelist:standard:UNCEFACT:SubLocationCodeurn:un:nealnet:codelist:standard:UNCEFACT:SubLocationCode:必选4ActualArrivalDateTimeActualTimeofArrival实际到达时间必选5ActualBerthingDateTimeActualTimeofBerthing实际靠港时间必选6ActualDepartureDateTimeActualTimeofDeparture实际离泊时间必选7IMONumberIMONumber船舶编码IMO1234567必选8VesselNameVesselName船名President需要9ShippingCompanyCodeShippingCompanyCode船公司代码HMMC需要10VoyageNumberVoyageNumber航次JW123必选11EstimatedArrivalDateTimeEstimatedTimeofArrival预计到达时间2006-05-10T02:50:35.
000Z需要12EstimatedBerthingDateTimeEstimatedTimeofBerthing预计靠港时间2006-05-10T02:50:35.
000Z需要13EstimatedDepartureDateTimeEstimatedTimeofDepature预计离港时间2006-05-10T02:50:35.
000Z需要14LastPortofCallLastPortofCall上港代码JPUKB可选15NextPortofCallNextPortofCall下港代码JPUKB可选16CyOpenDateTimeCyOpenDateTime集装箱堆场开放时间2006-05-10T02:50:35.
000Z需要17CyCutDateTimeCyCutDateTime集装箱堆场关闭时间2006-05-10T02:50:35.
000Z需要17CourseLineCodeCourseLineCode航线代码CN-JP可选具体数据元定义请见9.
1数据元字典定义B-OutlineofDataItemDefinition(集装箱状态查询)序号EPCIS事件定义数据元名称功能描述URI示例是否必须实现1epcContainerNumber集装箱号,最大为12位长度urn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:ALPurn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:ALP:HLXU4691920必选2bizstepStatusCode贸易运输状态代码,电子申报发生的状态信息urn:un:unece:uncefact:codelist:standard:UNECE:StatusCodeurn:un:unece:uncefact:codelist:standard:UNECE:StatusCode:13必选3bizlocationPortCode港口(码头)的唯一标识符,前五位为港口代码,采用国际标准.
后五位为码头代码,由港口自己定义.
urn:nealnet:codelist:standard:UNCEFACT:SubLocationCodeurn:un:nealnet:codelist:standard:UNCEFACT:SubLocationCode:CNNGB.
BLCTYD必选4#VoyageNumberVoyageNumber船舶航次号码JW123需要5IMONumberIMONumber船舶编码IMO1234567可选6#ContainerOperatorCodeContainerOperatorCode船公司唯一标示编码MSC可选7#ContainerSizeTypeContainerSizeType集装箱型号及类型22G1需要8#ContainerGrossWeightContainerGrossWeight集装箱总重量1000可选9#ContainerSealNumberContainerSealNumber集装箱封箱号1401081可选10#ContainerLoadingStatusContainerLoadingStatus集装箱装载状态F/E→ForEorS需要11#VehicleLicensePlateNumberVehicleLicensePlateNumber车牌号ZJB-14238可选C-FosstrakEPCIS介绍Fosstrak(http://www.
fosstrak.
org/epcis/)提供了一套符合EPCGlobal标准并通过EPC认证的完整实现,其中包括一套数据存放的实现方案(Repository),一个交互式的数据采集程序(CaptureInterface),一个交互式的数据查询程序(QueryInterface).
具体架构如下图.
其中EPCISRepository提供了包括数据库层面的数据存储表结构,数据采集和数据查询接口.
服务提供方可以根据EPCISRepository的数据库结构进行快速开发,将EPCIS的实现方式内嵌到企业自有应用中,按照EPCIS标准对自有数据进行转换,并使用FosstrakEPCIS已有查询接口对外发布WebService服务.
数据查询工具(QueryApp)提供了标准EPCIS查询功能和标准EPCIS字段的显示功能,服务供需双方可以用该工具进行服务的自测和互测,以达到测试标准一致.
同时也可以使用枢纽提供的测试工具来进行服务的自测和互测,详细见9.
3查询客户端工具.
数据采集工具(CaptureApp)提供了标准EPCISSOAP报文的数据采集功能,可以将符合EPCIS标准的数据加入到EPCISRepository中.
JDK/JRE运行FOSSTRAK的WEB应用需要在本机安装JDK或者JRE1.
5或者更高版本的,如果已经安装,请略过这一部分.
获取JDK/JRE可以从oracle的网站上找到JDK/JRE的下载地址,或者联系NEAL-NET技术支持获得.
安装JDK/JRE按照安装向导完成安装,将JDK安装到指定目录,例如C:\jdk\.
配置环境变量Windows7为例右键点击桌面的计算机图标(属性(高级系统设置(环境变量(系统变量新建,变量名:JAVA_HOME变量值:C:\jdk变量名:CLASS_PATH变量值:.
;%JAVA_HOME%\lib\dt.
jar;%JAVA_HOME%\lib\tools.
jar;ApacheTomcatFOSSTRAK的应用需要运行在WEB服务器中,本例是使用ApacheTomcat作为WEB服务器,如果本机上已经安装了5.
5或者以上版本,请略过这一部分.
获取ApacheTomcat从http://tomcat.
apache.
org/可以得到最新的软件,或者联系NEAL-NET技术支持获得.
安装ApacheTomcat按照安装向导完成安装,将tomcat安装到指定目录,例如D:\Tomcat5\.
配置环境变量Windows7为例右键点击桌面的计算机图标(属性(高级系统设置(环境变量(系统变量新建,变量名:TOMCAT_HOME变量值:D:\Tomcat5变量名:CATALINA_HOME变量值:D:\Tomcat5MySQL下载安装配置获取MySQL数据库从http://www.
mysql.
com/获得5.
0以上版本,或者联系NEAL-NET技术支持获得.
安装按照安装向导完成安装,选择默认选项,确认MySQLConnector/J是被选中的.
将MySQL安装到指定目录,如D:\mysql\.
设置密码,如mysql123.
如遇到非致命性错误,如添加防火墙规则失败(Addingfirewallrulefailed.
)可忽略.
配置将C:\ProgramFiles\MySQL\MySQLConnectorJ\目录下的mysql-connector-java--bin.
jar拷贝到D:\Tomcat5\common\lib\目录下.
App应用下载安装配置获取APP应用从http://www.
fosstrak.
org/epcis/download.
html下载epcis-repository-0.
5.
0-bin-with-dependencies.
zip,或者联系NEAL-NET技术支持获得.
发布将zip包解开,将epcis-repository-0.
5.
0.
war拷贝到D:\Tomcat5\webapps,重新启动tomcat,这时,war包会被自动解开并发布,打开浏览器,在以下地址可以看到发布的APP应用了.

http://localhost:8080/epcis-repository-0.
5.
0/配置数据库连接配置文档在D:\Tomcat5\conf\Catalina\localhost\epcis-repository-.
xml,相关用户名、密码和URL需要调整的话参考以下部分,修改完毕后需要重新启动Tomcat.
建立数据库和测试数据导入打开MySQL命令行客户端程序(MySQL(MySQLServer5.
5(MySQL5.
5CommandLineClient.
创建数据库实例在例子中,我们使用epcis当作资料库的名称.
mysql>CREATEDATABASEepcis;创建表结构找到epcis-repository-0.
5.
0-bin-with-dependencies.
zip中解开的epcis_schema.
sql文件并拷贝到固定目录,如D:\temp\,并运行以下命令.

mysql>USEepcis;mysql>SOURCEd:/temp/epcis_schema.
sqlmysql>SOURCEd:/temp/epcis_demo_data.
sqlmysql>SOURCEd:/temp/epcis_demo_data.
sql忽略产生的ERROR1071.
客户端使用获得客户端软件标准版客户端可以从fosstrak网站上得到,或者联系NEAL-NET技术支持获得.
动态船期版客户端可以联系NEAL-NET技术支持获得.
输入查询地址,以http://180.
214.
34.
168/nealnet-epcis/query为例选择查询条件,可以单选或者多选,这里以查询条件"EPC=urn:un:NEALNET:data:standard:UNCEFACT:CallSign:C6WB6"、"VoyageNumber=1124S"为例点击"Runquery",显示查询结果数据元字典定义Attachment1-数据元.
xlsx.
该文档定义了具体业务数据元的使用方法、取值范围等内容.
接口事件格式定义Attachment2-事件表.
xlsx.
该文档定义了不同业务事件的数据项组合形式和组合要求.
查询客户端工具Query_Client.
rar.
该文件包含了查询客户端工具以及具体使用方法.
该工具是在FosstrakEPCISQueryClient基础上进行二次开发完成,添加了可以根据配置文件添加自定义查询条件,添加显示自定义的扩展字段,添加了设置默认查询地址等功能.
详细的配置修改功能请查看readme.
txt文件.

QueryinterfaceURL填写WebService服务地址.
Eventstobereturned选择时间类型.
Queryarguments填写查询条件,可多选.
SOAP报文监听工具为了更好的理解报文结构,对报文有感性的理解,并在开发和测试阶段对SOAP报文进行高效的对比与检验,建议使用一些SOAP报文监听工具.
这里我们推荐使用MembraneMonitor.
下载地址为http://www.
membrane-soa.
org/soap-monitor/.
该工具可以监听到request和response的报文内容.
使用步骤如下:启动软件,点击"Add"添加一条rule.
选择默认的2000端口作为代理的监听端口,点击下一步.
填写需要监听的服务的主机地址和端口号.
以地址http://115.
236.
89.
171:89/services/neal-net/query为例,在HOST填写115.
236.
89.
171,端口填写89,点击"Finish"保存.
修改客户端的查询地址,将http://115.
236.
89.
171:89/services/neal-net/query改为http://localhost:2000/services/neal-net/query.
然后按照正常程序填写查询条件进行查询.

在MembraneMonitor的"Exchanges"窗口里可以看到有一条抓取到的报文列表.
点击该条信息,在request/response窗口可以查看到Raw/HTTP/SOAP格式的发送报文和接收报文.