2023学年完整公开课版QuickStartGuideofTagCapturer（2022新）

Presenter:MiZhiqiangHunanModernLogisticsCollegeQuickStartGuideofTagCapturerIntroductionThisinstallationguideprovidesthenecessaryprocedurestoinstallTagCapturer.TagCapturerisanapplicationdemonstratingthefunctionalitiesoftheALEmiddlewareandintegrationwithAccada‘sEPCISproject.TagCapturerdemonstratesthesuccessfulintegrationofCUHKMiddlewarewithanopensourceEPCISmodule.ThegoalofEPCISistoenabledisparateapplicationstoleverageElctronicProductCode(EPC)dataviaEPC-relateddatasharing,bothwithinandacrossenterprises.Ultimately,thissharingisaimedatenablingparticipantsintheEPCglobalNetworktogainasharedviewofthedispositionofEPC-bearingobjectswithinarelevantbusinesscontext.TagCapturerisanapplicationthatdemonstratestheinteroperabilityofCUHKmiddlewarewithanopensourcedEPCISproduct,namelyAccadaEPCIS.AccadaEPCISProjectisthefirstopensourceEPCISprojectwithitsimplementationavailablepublic,andclaimstobecomplianttotheEPCInformationServices(EPCIS)Version1.0SpecificationasspecifiedinEPCglobal‘sRatifiedStandard(Version1.0ofApril12,2007).TagCapturerimplementstheEPCISroleintheEPCnetworkanddevelopstheappropriatetoolsthatfacilitatecommunicationwithanEPCISRepositoryinstance.SinceanEPCISapplicationisdomainspecificandrequiresdetailedworkflowinordertofulfillrequirementsandalignwithbusiness,TagCapturerdemonstratesonlythefeasibilityofexpandingCUHKmiddlewarewithspecificationcompliantEPCISproducts.TagCapturershowstheintegrationofCUHKmiddlewarewithAccadaEPCISCaptureInterfaceandAccadaEPCISrepositorytocaptureanEPCISEvent.1.EmbedEPCISRepositoryintothedemonstrationapplicationtoaddanEPCISinterfacetoit2.InteractivelyexploreanyEPCISRepositoryusingAccada’sgraphicalEPCISQueryApplication3.BuildanEPCISCaptureApplicationApartfromtheinteroperability,TagCaptureralsodemonstratestheusagefeasibilityofthefollowingscenarios:Thisdocumentisintendedtoprovidea“gettingstarted”pointforTagCapturer.Afterfollowingthistechnicalarticle,usersshouldbeabletoinstallandsetuptheTagCapturer.ThistechnicalarticledoesnotexplainthesystemdesignandthetechnicaldetailsofTagCapturer.ReadersareexpectedtohaveabasiclevelofunderstandingoftheEPCGlobalALEandEPCISstandards,whichmaybereferencedfromthesitehttp:///.TheistallationofTagCapturerrequiresthefllowingsoftwaretobeinsalledinthemachine:JavaDevelopmentKit(JDK)1.5MySQL5.0CUHKRFID1.0ApacheTomeat6.0oraboveAccadaEPCISProjectPreparingtheInstallationTheCUHKRFID1.0includes:ManagementConsole-providesabird-viewoftherunningsystemandprovidesadministrativeandmanagementfunctions.ReaderEmulator-provideshardwarereaderemulationtothemiddlewareTagCapturer-demonstratesthebasicfunctionalitiesofthemiddlewareFordetailsofinstallingCUHKmiddleware,pleaserefertothedocument“QuickStartGuideofMiddlewareInstallation".InstallJavaDevelopmentKit(JDK)1.5runjdk-1_5_0_10-windows-i586-p.exemakesuretoincludethebindirectoryisinyoursystemPATHmakesureJAVA_HOMEenvironmentvariableissetInstallingJavaDevelopmentKit(JDK)1.5Runmysql-5.0.15-win32_setup.exechooseStandardConfigurationinMySQLserverinstanceconfigurationnotethepasswordoftherootusermakesuretoincludethebindirectoryisinyoursystemPATHInstallingMySQL5.0InstallingCUHKRFID1.0Runcuhkrfid_1.0.exeApacheTomcat6.xastheWebcontainerforrunningAccada‘sEPCISRepository.Afterinstallation,itisimportanttocheckifCATALINA_HOMEenvironmentvariablehasbeensettotheTomcatrootinstallationdirectoryandthattheJAVA_HOMEenvironmentvariablepointstoavalidJREdirectory.PleasenotethatiftheTomcatisinstalledinthesamemachineastheCUHKRFID,makesurethatopenedportsdonotcollidewitheachother.InstallingTomcatTagCapturerisabletoincorporateAccada‘sEPCISRepositoryimplementationintoCUHKMiddlewaretoprovideameansofpersistenceforEPC-relateddata.Thissectionprovidesonlyahighlevelguideline,whichprovidesoutlineitemsthatshouldbeexecutedfortheinstallationofAccadaEPCISProjectForstepbystepinstallationguide,pleaserefertotheofficiallinkofAccada‘sEPCISProject,thatisathttp:///epcis/docs/user-guide.html.1.Downloadthemodifedversionofepcisrepository-0.2.0.war2.DeployEPCISrepositorytotheTomcat(asinstalledinprevioussection)3.CreatedatabaseschemaforEPCISrepository4.StarttheAccada‘sCaptureApplicationtotestsuccessfulinstallationofEPCISRepositoryviatheCaptureInterface5.StarttheAccada‘sQueryApplicationtotesttheconnectionviaSOAPwiththeQueryInterfaceInstallingAccadaEPCISProjectStarttheAccada'sEPCISRepositorybystartingtheTomcatapplicationserverStarttheAccada‘sEPCISQueryApplicationandtesttheconnectionwiththeEPCISRepositoryOpenManagementConsole:

-Createareadercalled“READER1”

-Createalogicalreadercalled"LREADER1“

-Createamappingsuchthatlogicalreader“LREADER1”mappedtoreader“Reader1”OpenTagCapturer:AddaView-IntheMenu,choose“AddaView”-Title:ecspecl-LogicalReaders:LREADERI-ScopeofTags:urn:epc:pat:gid-96:100001.0.[5000-9999]-SetofEPCs:current-SubmittheRequestb)SelectaView-IntheMenu,choose"SelectaView“-Select"ecspec1”TestingInstallationWhenyousetupyourlabcomputers,installandconfigureyoursystemsinthefollowingorder:HereweuseasimplescenariototestthesuccessfulinsallationoftheTagCapturer.5.OpenReaderEmulator:-ServerAddress:localhost-ReaderID:READER1-ReaderCycle:1000-Tags:urn:epc:tag:gid-96:1000001.0.[5000-9000:1]-Starttheemulation6.TheTagCapturerreportsthetagsreceived7.ExecuteAccada'sQueryApplicationtoretrievetheresultsFordetailsofinstallingCUHKmiddleware,pleaserefertothedocument“QuickStartGuideofMiddlewareInstallation".TagCapturerisanappicationdemonstratingthefunctionalitiesoftheALEmiddlewareandintegrationwithAccada‘sEPCISproject.TagCapturerdemonstratesthesuccessfulintegrationofCUHKMiddlewarewithanopensourceEPCISmodule.TagCapturerprovidesthefollowingfunctionalities:DefineandsubscribeECSpecinthemiddlewareReceivereportsfromthemiddlewareTransformreportsintoEPCISEventsSendEPCISEventstotheEPCISCaptureInterfaceReceiveresponsefromtheCaptureInterfaceDisplaytheEPCISstatusTagCapturerGuideserver.host,server.portTheseparametersspecifythehostnameandtheportnumberoftheALEmiddleware.Thedefaultvalueislocalhost，8080.client.host,elient.portTheseparametersspecifythehostnameandtheportnumberofTagCapturerasseenbythemiddleware.Forexample,ifTagCapturerisrunningonprivateIPaddess,andthemiddlewareisrunninginpublicIntemet,thenaproxyisrequiredtobesetupinordertoroutethetrafficfrommiddlewaretotheclient.Theclient.hostandclient.portinthiscaseistheproxy’spublicaddressandtheportfortrafficrouting.Thedefaultvalueislocalhost,6666.epcis.captureurlThisparameterspecifiestheURLoftheEPCISCaptureInterface.SincetheCaptureInterfacewillbehostedinanotherapplicationserverandthecommunicationisconductedviaXMLmessagesonHTTP,thelinkspecifyingtheCaptureInterfaceshouldbechangedaccordingtodifferentconfigurationoftheapplicationserver.Thedefaultvalueishttp://localhost:8081/epcis-repository-0.2.0/capture.ConfigurationThereisafilenamed"perties"whichcontainsthefllowingparameters:ViewTheTagCapturerisworkingon“View",whichisanabstractionofECSpecandECReport.Toaddaview,thefollowingparametershavetobespecified:TitleThisparametercorrespondstothenameoftheECSpec,specName.LogicalReadersThisparametercorrespondstotheoneinECSpec.Semicolon“;”canbeusedtoseparatelistoflogicalreadernames.ScopeofTagIDsThisparametercorrespondstotheincludePattemsintheECFilterSpec.Semicolon“;”canbeusedtoseparatealistoftagpatterns.SetofECPsThisparametercorrespondstothesettinginECReportSetSpec.TheECSpecaddedinthemiddlewarehasadurationof3secondsinECBoundarySpec.Operati