7/19/2015

Introductiontosimple(FileXIFile)scenarioan...|SCN

GettingStarted Newsletters

Hi,Guest

LogOn

JoinUs

Store

SearchtheCommunity

Products

Services&Support

AboutSCN

Downloads

Industries

Training&Education

Partnership

DeveloperCenter

Activity

LinesofBusiness

UniversityAlliances

Events&Webinars

Innovation

Browse

Communications

Actions

venkat.donela

Introductiontosimple(FileXIFile)scenarioand
completewalkthroughforstarters(Part1)
PostedbyVenkatDonelainvenkat.donelaonMar2,20057:06:05AM
Share

Tweet

0 Like

HerespecificsofSLDarenotcovered.Scenarioissimplethecsvfileispickedupbythefileadapterfromabusiness
systemandpostedontothesamesystemusingfileadapter.AttheendofthisscenarioIamsureyouwillbeableto
challengewithvariousothercomplexscenarios.

Overview

TheMapDesignerisaclientcomponentoftheDesignBuilderusedtodevelopmapsdefininginputandoutput
specificationsandmappingrulesthatperformdatatransformationasdesired.
TheMappingObjectoftheIntegrationRepositoryusesthedefinitionsofdatastoredordefinedinthedatatypeobject
(thatarecreatedusingtheDataTypeDesigneditor)tospecifythetransformationlogicintheformofmaprules.Map
rulesoperateoninputdataobjectsandbuildoutputdataobjects.

BasicStepsforBuildingtheDesiredOutputData

Buildingthedesiredoutputdataconsistsoftwomainsteps:

1ChoosethemessagetypesintheMappingDesign.
2Definingthedatadefinitionsinthedatatypeeditor
object.

http://scn.sap.com/people/venkat.donela/blog/2005/03/02/introductiontosimplefilexifilescenarioandcompletewalkthroughforstarterspart1

1/6

7/19/2015

Introductiontosimple(FileXIFile)scenarioan...|SCN

WorkingontheMessageMappingObject

InordertousetheMappingObject,youmustalreadyhavethedatastructurethatdefinesyourdatainthedataType
object.TheMappingObjectusesthedataobjectdefinitionsthatarestoredintheDatatypeObject.

TheMappingEditorisusedto:
1.Createmapstospecifythelogicnecessarytotransformtheinputdatatothedesiredoutputdata.
2.Identifythesourceanddataobjectsoftheinputdata.
3.ValidateandresolvethesourcedatatypepropertiesdefinedintheDataTypeObject.
4.Identifythetargetanddataobjectsoftheoutputdata.
5.Specifyandbuildtheoutputdataaccordingtotherulesspecifiedduringmapping.
6.Viewthetestresultsofthemapexecution.

CreateMapstoSpecifySourcesandTargets

AfterdefiningdataobjectsandtheirpropertiesintheDataTypeEditor,definethemappingintheMappingObjects
whereyouspecifytheoutboundandinboundDataTypes.

TocreatemapsusingtheMapDesigner

1SelectthemessagetypesourcefileandtheTargetfile.
2.Specifythelogicnecessarybyusingvariousfunctionstotransformtheinputdatatothedesiredoutputdata.
3Maptherespectiveelements
4TestyourmapswithTesttab.

DevelopmentofalldesignobjectsfortheIntegrationRepositoryatdesigntime

TheobjectsintheIntegrationRepositoryareassignedtoaproductusingthesoftwarecomponentversionandcan
thereforebeshippedwiththisproduct.

Adatafileisasimpleexampleofdata.Thefileconsistsofrecordsandeach
recordconsistsoffields.Threekindsofdataobjectsexistinthisdatafile:afile,
arecord,andafield.Inafileofrecords,thinkofthedataintermsofthethree
Dataobjects:
1)DefineyourFieldsFirstName,MiddleName,LastName,Place,City,State,andCountry

Samuel,J,Jackson,LakefrontDrive,EarthCity,Missouri,USA
Kenny,m,George,NorthBeauregardstreet,Alexandria,Virginia,USA

http://scn.sap.com/people/venkat.donela/blog/2005/03/02/introductiontosimplefilexifilescenarioandcompletewalkthroughforstarterspart1

2/6

7/19/2015

Introductiontosimple(FileXIFile)scenarioan...|SCN

Todefinethisdata,createaDataTypeinyourIntegrationRepository.
createThreedatatypes:
FileInput,Record,andRow
DefineyourfieldsFirstName,MiddleName,LastName,City,Place,State,Countryasshownandtheirrespective
properties.

!https://weblogs.sdn.sap.com/weblogs/images/28987/1.JPG|height=200|alt=image|width=578|src=https://weblogs.sdn.sap.com/weblogs/images/28987/1.JPG|border=0

Theentirecontentsofyourdatamustbedefined.Definetheinputdatasothateachdataobjectofthesourcedatais
identified.Definetheoutputdataaccordingtoyouroutputspecifications.Heretherequirementisoutputconatinsthe
samefieldsastheinput.

2)DefineoutputdatatypestructurenameasFILEOUTPUT_TESTcontainingthesameelementsastheinput.

!https://weblogs.sdn.sap.com/weblogs/images/28987/3.jpg|height=284|alt=image|width=600|src=https://weblogs.sdn.sap.com/weblogs/images/28987/3.jpg|border=0

3)CreateaMessageTypecomprisesadatatypethatdescribesthestructureofamessage.
ThisisusedtoreferthemessageinSAPXItobeexchangedatruntime.specifyyourdatatypenameinthiscaseitis
FILEINPUT

!https://weblogs.sdn.sap.com/weblogs/images/28987/4.jpg|height=400|alt=image|width=600|src=https://weblogs.sdn.sap.com/weblogs/images/28987/4.jpg|border=0

4)CreateaMessageInterfacetodescribeinterface,whichyouwanttousetoexchangemessagesbetween
applicationcomponentsusingSAPExchangeInfrastructure.foramessageinterface,itcaneitherhavethetaskof
sendingarequest(outbound)orreceivingarequest(inbound).
Thisisanoutboundinterface,wheretheOutputmessagetypeisFILEINPUTandattributesaredefinedasshown.

!https://weblogs.sdn.sap.com/weblogs/images/28987/5.jpg|height=349|alt=image|width=600|src=https://weblogs.sdn.sap.com/weblogs/images/28987/5.jpg|border=0

ThisisanInboundInterfacewhereyouspecifytheInputMessagetypeFILEOUTPUT_TESTandtheattributesas
shown.

!https://weblogs.sdn.sap.com/weblogs/images/28987/19.jpg|height=328|alt=image|width=600|src=https://weblogs.sdn.sap.com/weblogs/images/28987/19.jpg|border=0!/

Amappingreferstothemappingofinterfacesormessagestootherinterfacesormessages.
Youcandefinemappingsforaninterfacepair(sourceandtargetinterface)byusingmessageinterfacesandmessage
typesintheIntegrationRepository.

5)CreateaMessageMappingFILE_TO_FILEwhichreferstoamappingofmessagesandissupportedbyagraphical
mappingeditor.TheeditorenablesyoutodesignastructuremappingbetweenanytwoXMLstructuresandconnectto
avaluemapping.
Usingtheeditorwhichenablesyouwiththedraganddropmetaphor,designyourmappingbydraggingtheelements
fromthesourceFILEINPUTstructureanddroppingthemontotheelementsonthetargetstructure
FILEOUTPUT_TEST.loadthetwomessagetypesanddefinethemappingasshown.

http://scn.sap.com/people/venkat.donela/blog/2005/03/02/introductiontosimplefilexifilescenarioandcompletewalkthroughforstarterspart1

3/6

7/19/2015

Introductiontosimple(FileXIFile)scenarioan...|SCN

6)CreateanInterfacemappingFILEINPUT_TO_FILEOUTPUT_NTERFACE.Interfacemappingsregisteryourmapping
programforaninterfacepairintheIntegrationRepository.
EnterthesourceandtargetinterfaceswhichinthiscaseareFILEINPUT_OBandFILEOUTPUT_IB.
Toimportthepropertiesoftheinterfaces,chooseReadInterfaces
Aninterfacemappingcanonlyrefermappingprogramsthatbelongtothesameoranunderlyingsoftwarecomponent
versionoftheinterfacemapping.selectthemappingprogram,inthiscaseitisFILE_TO_FILE.

saveandactivateinthechangelistwhereyouselectyoursavedobjects.NowthestatusbecomefromBeing
ProcessedtoActive.

PleaseDontforgettofollowupthePart2forconfigurationthecontents,theSenderandReceiverFileadapterin
integrationdirectory.

http://scn.sap.com/people/venkat.donela/blog/2005/03/02/introductiontosimplefilexifilescenarioandcompletewalkthroughforstarterspart1

4/6

7/19/2015

Introductiontosimple(FileXIFile)scenarioan...|SCN

3292Views

AverageUserRating

MyRating:

(7ratings)

Share

Tweet

0 Like

6Comments
GerardoRamonEspinoJun7,20062:26PM

Hi,
CouldyoupleasetellmewheredoyouspecifythattheoutputformatwillbeXML?
Regards,
Gerardo.
Like(0)

VenkatDonelaJun8,20064:55AM(inresponsetoGerardoRamonEspino)

Hi,
Thereisnoneedtospecifytheoutputformat.XIusesXMLstandard.
Pleaseelaboratethequestionifiamnotclear.
Cheers!
Venkat
Like(0)

ReddyPJun26,20068:53PM

HiVenkat,
Itisveryniceandusefulfornewcommerslikeme.Canyoupleasetellmewhatisthedifference
betweenrecordandrowinyourexample.
Thanks,
ReddyP
Like(0)

VenkatDonelaJun29,20062:06AM(inresponsetoReddyP)

Hi,
Arecordcancontainmultipletypesofsubstructuresidentifiedbylogicalnames.Inthiscase
istherow.Therecanbeafixedorvariablenumberofsubstructuresinarecord.
Cheers!
Venkat
Like(0)

JenniferLeeJan4,20071:16PM

Ifollowedthisblogexactlybutnothing
happenedtothexi_input.datfile.
Howtodebug?
Thanks!

http://scn.sap.com/people/venkat.donela/blog/2005/03/02/introductiontosimplefilexifilescenarioandcompletewalkthroughforstarterspart1

5/6

7/19/2015

Introductiontosimple(FileXIFile)scenarioan...|SCN
Like(0)

VenkatDonelaJan11,20078:59AM(inresponsetoJenniferLee)

HiJeniffer,
sorryforthedelay,Plzcheckiftheftpserverisrunningandalsoyourfileadapterstatusin
Runtimeworkbench.
Cheers!
Venkat
Like(0)

SiteIndex
Privacy

ContactUs
TermsofUse

SAPHelpPortal
LegalDisclosure

Copyright

http://scn.sap.com/people/venkat.donela/blog/2005/03/02/introductiontosimplefilexifilescenarioandcompletewalkthroughforstarterspart1

FollowSCN

6/6