1. Building an Adapter 1

2. Session Agenda Review of CONNECT components Project/source layout Customization of adapter components Copyright 2009. All Rights Reserved. 2

3. Assumptions/Expectations Familiarity with… Java Service Oriented Architecture (SOA) NetBeans GlassFishESB Copyright 2009. All Rights Reserved. 3

4. Review of CONNECT Components Copyright 2009. All Rights Reserved. 4

5. CONNECT Architecture Messages From NHIN Copyright 2009. All Rights Reserved. 5

6. CONNECT Architecture Messages to NHIN Copyright 2009. All Rights Reserved. 6

7. Project / Source Layout Copyright 2009. All Rights Reserved. 7

8. Source Code Directory Structure DIRECTORYDESCRIPTION C:\projects\NHINC\Current\Product Contains master ant script that compiles the CONNECT gateway and adapter C:\projects\NHINC\Current\Product\Production This project will contain sub folders that separate the code by its primary location (i.e. Common, Gateway, Adapter) C:\projects\NHINC\Current\Product\Production\AdapterCONNECT adapter source C:\projects\NHINC\Current\Product\Production\Common Source used by both gateway and adapter C:\projects\NHINC\Current\Product\Production\GatewayCONNECT gateway source C:\projects\NHINC\Current\ThirdParty Contains third party libraries needed to compile Copyright 2009. All Rights Reserved. 8

9. Project Naming Conventions PROJECTS ENDING IN…TYPE OF PROJECT WebPOJO Web Services LibJava library ProxySpring Component Proxy Projects DAO Data Access (Note some data access objects are defined as Lib) GUIWeb application EJB or Ejb Enterprise java bean (mainly in ESC – not many left) Copyright 2009. All Rights Reserved. 9

10. Project Creation Guidelines »WIKI page describes the projects –http://developer.connectopensource.org/display/CONNECTWIKI/Proje ct+Creation+Guidelineshttp://developer.connectopensource.org/display/CONNECTWIKI/Proje ct+Creation+Guidelines Copyright 2009. All Rights Reserved. 10

11. Special Projects PROJECT/DIRECTORYPURPOSE Common\Interfaces Contains all of the WSDL and schemas that are being used within CONNECT Common\Properties Contains property files and configuration files that are used within CONNECT (These are used in: C:\Sun\AppServer\Domains\Domain1\Config and C:\Sun\AppServer\Domains\Domain1\Config\N hin Copyright 2009. All Rights Reserved. 11

12. Web Service WSDL File Naming Conventions Copyright 2009. All Rights Reserved. 12 »First part identifies the type of service –Adapter: Services on the adapter –Entity: Services on the gateway which are called by the adapter –Nhinc: Services on the gateway that are internal to the gateway –Nhin: NHIN services hosted or called by the CONNECT gateway »If “component” identified in second part… –NhincComponent: Identifies internal components to the gateway –AdapterComponent: Identifies services on the Adapter Service Bus Used to customize an adapter service –EntityComponent: Identifies gateway internal services which orchestrate a message »Adapter/Entity interfaces may contain word Secured/Unsecured –Identifies whether the interface represents the secured or unsecured interface »Rest of the name identifies the service »Example –AdapterComponentSecuredMPI.wsdl

13. XML Schema Layout and Naming Conventions »Directory: Interfaces\src\schemas »First level of hierarchy: identifies organization or type of schemas »schemas\nhinc: CONNECT schemas »schemas\nhinc\common: used in gateway and adapter »schemas\nhinc\gateway: used in gateway »schemas\nhinc\hl7: schemas to combine HL7 messages Copyright 2009. All Rights Reserved. 13

14. Connection Manager »Manages endpoint URLs –NHIN services –Replaceable services »Two points of configuration –UDDI UDDI Update Manager service uddiConnectionInfo.xml: CONNECT service information cache –Do not modify this file by hand –Internal Used to override UDDI settings – settings here take precedence over UDDI Used for non UDDI supported services internalConnectionInfo.xml Copyright 2009. All Rights Reserved. 14

15. Example internalConnectionInfo.xml Copyright 2009. All Rights Reserved. 15 1.1 DoD DoD Description subjectdiscovery https://localhost:8181/PIXConsumer_Service/SubjectDiscovery nhincsubjectdiscovery NHIN-CONNECT Internal Subject Discovery http://localhost:9080/NhinConnect/NhincSubjectDiscovery

16. Customization of Adapter Components Copyright 2009. All Rights Reserved. 16

17. Adapter Service Bus Components COMPONENTWSDL Document RepositoryAdapterDocRetrieveSecured.wsdl Document RegistryAdapterDocQuerySecured.wsdl MPIAdapterComponentSecuredMpi.wsdl Policy Engine AdapterPolicyEngineSecured.wsdl (or) AdapterPolicyEngineOrchestrator.wsdl Subscription RepositoryAdapterComponentSubscriptionRepository.wsdl Subscription ManagementAdapterSubscriptionManagementSecured.wsdl NotificationAdapterNotificationConsumerSecured.wsdl Document Submission (XDR)AdapterComponentXDRSecured.wsdl XDR Async RequestAdapterXDRRequestSecured.wsdl XDR Async ResponseAdapterXDRResponseSecured.wsdl Re-identificationAdapterSubjectDiscoverySecured.wsdl Copyright 2009. All Rights Reserved. 17

18. Steps for Customizing an Adapter Component Create a Web Service that implements the correct WSDL Deploy the web service Update internalConnectionInfo.xml with the URL for the customized WSDL Copyright 2009. All Rights Reserved. 18