SAPPIMessageDesign.ppt

SAPPIMessageDesign 2014 12 16 课程目标 参加完该课程后 参与者需要掌握以下内容 理解SoftwareComponents和Namespaces掌握ESR对象的创建了解ABAPProxy的创建 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A Twomainphases designtimeandconfigurationtime MessageDefinitionandMapping MessageRouting 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A BusinessProcessinadistributedlandscape SoftwareComponentVersion 缩写为SWCV是在EnterpriseServicesRepository ESR 中主要的对象存放归类容器 从而使得接口中的对象属于一个特定的版本空间 SWCV通常是在SLD中基于Product创建的 然后导入到ESR中 导入ESR中依然可以编辑 可以新增Namespace 标明导入的IDOC或者RFC等 一个SWCV可以包含多个Namespace 开发对象由Namespace组织 每个对象是由SWCV Namespace 及其名字唯一识别 Namespaces通常基于外围系统或者是流程来定义 作用等同于XML的Namespace Namespace通常情况下全局唯一 一般是URL或者是URN开头的字符串 EditSWCV 当SWCV第一次导入或者在某个SWCV上双击时 出现如下界面 我们可以选择基本语言 导入对象来源系统 以及该SWCV内的内容是否允许编辑 Namespace CreateorUpdate 方法一 在指定的SWCV中的任一Namespace上双击 在打开的窗口中进行相关操作 方法二 在指定SWCV中的任一Namespace上右击 选择New 在弹出窗口中输入新Namespace名字 SAPWebAS 6 20 Designtime IntegrationRepository SystemLandscapeDirectory SoftwareComponent SoftwareComponentVersion J2EE ABAP Proxies MessageInterfaces MessageTypes EnterpriseServicesBuilder InterfaceEditor DataTypes BusinessProcesses Mappings BusinessScenarios ContextObjects ScenarioEditor ProcessEditor MappingEditor ConditionEditor 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A OverviewofInterfaceObjects Interfaceobjects DataType Datatypes是定义XML结构最基本的对象相当于XMLSchema XSD Datatypeeditor提供了所有的XSD字段类型数据结构可以嵌套 即 可以引用其他DataTypeDateType可以导出为XSD格式文件 不同的DataTypes CoreDataTypes DevelopedaccordingtoUN CEFACTCoreComponentTechnicalSpecification CCTS Ensuresmaximumreusability Doesnothaveanybusiness specificsemanticsyet AggregatedDataTypes mustreferenceexistingcoredatatypesorotheraggregateddatatypes orboth GlobalDataTypes GDT SAPhasdevelopedahugesetofGDTsthathavebusinesssemanticsanddescribesabasicbusinessentitysuchasanaddress GDTsarethebasisforapplication specificdatatypesSAP wideandcanbeusedbycustomerstobuildtheirowndatatypes BasicGDTsModeledusingaprojectionconnectiontotheoriginalcoredatatypeHavetheirownname qualifier andcodelistsCandowithouttheattributesoftheoriginalcoredatatypes ifnotrequired Interfaceobjects MessageType Messagetype对应于XML消息的根节点Name和namespace必须严格符合XML文件需求的格式MessageType包含且只能包含一个DateType可以导出XSD文件 ExternalDefinition ExternalDefinition使得从本地导入WSDL XSD 或者DTD文件到ESR中作为MessageType使用成为可能 并且可以指定哪一部分被用作MessageType Interfaceobjects ServiceInterface ServiceInterface是XML元数据最高级别的代表 Inbound或者outbound 或者Abstract ccBPM使用 同步或者异步异步接口要包含一个MessageType同步接口要包含两个MessageType requestandresponse 可以通过FaultMessageTypes来进行异常消息处理可以以WSDL形式导出是生成Proxy的起点 ABAPProxy和JavaProxy都是这样 IDOC或者RFC可以直接导入作为Interface使用Inbound和Outbound的选择会关系到ABAPProxy生成类的类型 ServiceInterfaceEditor 如下图 在接口编辑器中可以进行接口基本信息的设定 接口方向 同步异步等信息 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A Mappingconcepts Mapping是从一个结构到另外一个结构的转换转换规则在映射程序中定义如果发送端和接收端的结构相同 那么可以不创建MessageMapping 除非特殊情况下 如要改下MessageHeader的某些值 MappingtechniquesinXI MessagemappingGraphicaldesignandtestenvironmentQueue basedmodelallowshandlingofverylargedocumentsExtensibleviaJavauser definedfunctionsXSLTOpenstandardPortableExtensibleviaJavauser definedfunctionsMemoryoverheadforverylargedocumentsJavaFlexibilityofJavaprogramminglanguageJavamappingprogramisresponsibleforparsing renderingXMLABAPLeverageexistingABAPbaseABAPmappingprogramisresponsibleforparsing renderingXML W3C MappingObjects MessageMappingFeatures GraphicalmappingtoolGraphicallydefinemappingrulesbetweensourceandtargetmessagetypesQueue basedmodelallowsforhandlingofextremelylargedocumentsDrag and dropGeneratesinternalJavacodeBuilt inanduser definedfunctions inJava Integratedtestingtool MessageMapping MappingEditor SourceStructure TargetStructure DataFlowEditor MappingEditor分为以下几个部分 MM基本信息 发送接收端结构 映射关系编辑框 另外分为4大标签 分别为不同功能的集合 映射关系编辑 Mapping测试 接口属性标识 用户自定义功能 Mappingobjects operationmapping OperationMapping指定对于选中的一对Operation间相关的Request Response 或者Fault映射程序 MessageMapping 在一个OperationMapping中可以包含的MessageMapping可以是 MessagemappingXSLTmappingCustomJavamappingABAPmapping在一个OperationMapping中可以包含多个MessageMapping 这些MM可以按顺序执行 同MessageMapping Multi Mapping可以在OperationMapping中使用 i e 1 N 对于N 1和N Mmapping 在7 1版本及之前 可以通过使用ccBPM实现 在PI7 3版本中可以通过BPMN实现 对于同步接口 需要提供Request和Response两个方向的MessageMapping 同MessageMapping 在OperationMapping中可以进行相应的测试 不同的是MessageMapping中只能进行单一的Mapping测试 而OperationMapping中 可以一次测试其中包含的所有MessageMapping 因此 在我们执行整个接口测试之前 最好先在此进行OperationMapping的测试 Mappingobjects importedarchives ImportedArchives包含了导入的外部定义的程序 XSLTstylesheetsJavamappingsJavaextensionstoXSLTmappingsJavaclassestobeimportedinauser definedfunctionformessagemapping所有导入的文件必须进行压缩 ZIPorJARformat 并从个人本地机器导入 ESR可以ImportedObjects的维护中心XSLT和text文件可以直接在ESR中进行编辑 JavaCLASS必须在本地编辑 然后重新编译 然后重新导入到ESR中 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A Import exportfunctions ObjectsintheEnterpriseServicesRepositoryarebasedonopenstandardsTheimportfunctionforWSDL XSDandDTDfilesenablesyoutouploadmessagedefinitionsfromexternalsources AfterconversiontoWSDLtheycanbeusedtodefinemessagemappingsandmessageinterfaces TheobjecttypeExternalDefinitionisacontainerwhichisusedtomakeexternalmessagedefinitionsavailableintheEnterpriseServicesRepository EnterpriseServicesRepository BusinessProcesses Mappings Interfaces SAPSystem IDocs RFCs XSLTJava WSDLXSDDTD BPEL WSDLXSD BPEL ImportofRFC IDocinterfaces ImportofRFC IDocmetadatafromexistingSAPsystemBasedonconnectionparametersspecifiedintheSWComponentRFCandIDocmetadatacannotbemodifiedwithinXINamespacesarepreset urn sap com document sap idoc messagesurn sap com document sap rfc functionsXSDandWSDLrepresentationavailableforexportProcedure right clickon importedobjects andfollowthewizard 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A EnterEnterpriseServicesBuilder ESB PIDEVwebsite http pnt81 50000 dir start index jsp ClicktheEnterpriseServicesBuilder ESBOverview Menubar Toolbar Objectslist Objecteditor CreateNewObjects TwowaystocreateObjects Onmenubar Object NewRightclickwhenyouclicksomeObjects Inthisway thecreatewizardwillbespecificobjectyouselected 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A GeneralscenarioonAcBel SAPPI SAPECC6 DataCenter Request Output Response Input Request Input Response Output OutboundInterface InboundInterface Mapping JDBCAdapter RFCAdapter OperationMappingMessageMappingServiceInterfaceMessageTypeDataType BusinessSystem Channel ReceiverDeter InterfaceDeter ReceiverAgreement SenderAgreement DesignTime ConfigurationTime Thestepsformessagedesign Definingnamespace ifrequiredfornewscenario DefiningandstructuringdatatypesDefiningmessagetypeDefiningserviceinterfaceDevelopingmessagemappingsTestingandRefiningthedesignedmappingDefiningoperationmappingsTestingoperationmappings 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A Step1 Definingnamespace NamespaceislikethegroupofmessagescenarioNamingRule urn MM PP SD FI CO D2R R2D xxx Step2 Definingandstructuringdatatypes I Namingrule DT JDBCAdapterwillconvertdatastructureintoSQLstatement 第一個subelement為 StatementTable1 如果要寫入的Table很多 則分別為 StatementTable2 StatementTable3 StatementTable1 之下為實際的TableName SAP QCM01 TableName之下會有一個attribute action 以及subelement access access element之下則為SAP QCM01的實際欄位名稱 Step2 Definingandstructuringdatatypes II 每個 StatementTableX 包一個tablestructure IfoneRFCtrytoinsert5tablesofDatacenteratthesametime Thedatastructurewillbeasfollowing Step2 Definingandstructuringdatatypes III IftheSQLstatementhas where condition thedataelement key1 shouldbeincludedinthedatastructureandit spositionshouldbeputafterthe access Iftheactionis UPDATE theSQLstatementwillbeconvertedasfollowing UPDATESAP INBOUNDSETDELIVER SAP val1 SAP RFCLOGNUM val2 WHEREDATA SEQ val3 Thevalueof action couldbeUPDATEINSERTUPDATE INSERTDELETESELECT EXECUTESQL QUERY Step3 Definingmessagetype Namingrule MT OnlyselectthedatatypewecreatedonStep2 Step4 Definingserviceinterface Namingrule SI In Out Sync Async Besurethismessageis Inbound and Asynchronous Category InboundMode Asynchronous RequestmessageiswecreatedonStep3 Step5 ImportingRFC IDOC TheattributeofProcessingtypeinRFCshouldbe Remote EnabledModule TheprocedureisImportedObjects rightclick clickImportofSAPObjectsandfollowthewizard IftheImport ExportorTablestructureoftheRFChaschangedafterimportingtoPI youshouldimportitagaintorefreshthedatastructure 1 2 3 4 5 Step6 Developingmessagemappings Namingrule MM to OnlyonemessagemappingsinR2Dscenario ThatisfromRFCtoDCtable 在SAPOutbound的mapping中 RFC部分請注意以下幾點1 Company PE RPAR OUT DEST2 RFCLOGNUM PE RPAR ZRFCLOGNUM3 Actioncode應該存在於該RFC個別定義的tablestructure上 分別選擇來源的message及目標的RFC選擇相對應的欄位直接用滑鼠拖曳的方式建立mapping 1 2 Step7 TestingandRefiningthedesignedmapping Twowaystotest Youcaninputvaluesonthefieldsorloadtestingxmlfilefortesting 選定完成後按 StarttheTransformation icon 兩種測試方式 選擇LoadTestInstance叫出測試檔案 而此檔案必須為xml格式在來源的message RFC端的欄位中輸入值 Step8 Definingoperationmappings Namingrule OM to 選擇SourceandTargetOperationClickReadOperations選定下方的messagemapping Step6設定完成的messagemapping 1 2 3 目录 PI接口实现的两个阶段EnterpriseServicesRepositoryOverviewandConceptsInterfaceObjectsMappingObjectsMiscellaneous样例 EnterpriseServicesBuilderMessageDesign步骤ScenarioR2D StepbyStepScenarioD2R StepbyStepQ A Step1 Definingnamespace NamespaceislikethegroupofmessagescenarioNamingRule urn MM PP SD FI CO D2R R2D xxx Step2 Definingandstructuringdatatypes Namingrule DT row isfirstsubelementDatastructuremustmatchwithselectfieldsofSQLstatement Clickheretoinsertdatastructure Step3 Definingmessagetype Namingrule MT SelectthedatatypewecreatedonStep2Don tforgettoremoveXMLNamespace 保持XMLNamespace欄位內容為空白 Step4 Definingserviceinterface Namingrule SI In Out Sync Async Besurethismessageis Outbound and Synchronous Category OutboundMode Synchronous RequestmessageiswecreatedonStep3 Responsemessageis MT SAP INBOUND IN inthePUBLICnamespace Step5 ImportingRFC IDOC TheattributeofProcessingtypeinRFCshouldbe Remote EnabledModule TheprocedureisImportedObjects rightclick clickImportofSAPObjectsandfollowthewiza