Application. 1.1 About This Tutorial Tutorial Requirements Provided Files

Transcription

1 About This Tutorial 1Creating an End-to-End HL7 Over MLLP Application 1.1 About This Tutorial Tutorial Requirements Provided Files This tutorial takes you through the steps of creating an end-to-end SOA healthcare solution that will process HL ADT A03 messages using MLLP 1.0 exchange transport protocol. It includes the following sections Section 1.1, "About This Tutorial" Section 1.2, "Importing the Document Definitions" Section 1.3, "Creating Endpoints in Oracle SOA Suite for Healthcare Integration" Section 1.4, "Creating the SOA Composite Application" Section 1.5, "Testing the Application" Section 1.6, "Working with the Prebuilt Sample" This exercise is designed to show you how to create a simple end-to-end application that sends an HL7 ADT_A03 message from a source endpoint (In_Patient_Admission) to a target endpoint (In_Patient_Laboratory) with no modification to the message. The endpoints and document definitions are defined in the Oracle SOA Suite for healthcare integration console, and Oracle Mediator (defined as a part of the compsoite application created in Oracle JDeveloper) sequences and routes the messages. In this tutorial, you will design and create a SOA composite for Oracle SOA Suite for healthcare integration in Oracle JDeveloper. You will also deploy the application to WebLogic Server and then test the application using the B2B simulator and the test data provided with the sample files. To run this tutorial, you must have the following installed: Oracle Database, with RCU run to create the schemas Oracle WebLogic Server Oracle SOA Suite with Opatch for Healthcare and postinstallation script (please refer to the Install readme) Oracle JDeveloper, with the PCBPEL extension In addition, you should have a WebLogic domain already created for the SOA Suite. The sample ZIP file includes files you need to create the sample project, including an import file for the HL7 document definitions and a configuration file to use when testing the application. It also includes all of the project files, which you can open in Oracle JDeveloper instead of creating them in this tutorial, and then deploy and test the application. The sample ZIP file includes these key files: Creating an End-to-End HL7 Over MLLP Application 1-1

2 Importing the Document Definitions /artifacts/samples/composite/hcfp-101-mllp-1.zip: A prebuilt SOA composite project, based on the instructions in this tutorial. /artifacts/samples/b2b/b2b-hcfp-101-mllp-scenario1.zip: A prebuilt Oracle SOA Suite for healthcare integration configuration, based on the instructions in this tutorial. /artifacts/input/adta03_2.3.1_1.txt: A sample input message for you to use when testing the application. /artifacts/schema/hl7doctypeexport.zip: An export file containing the HL and HL& 2.5 document definitions used in this tutorial. /artifacts/runtime/hl7-config.properties: A sample configuration file to use with the simulator when testing the application. 1.2 Importing the Document Definitions In order to create the sample project, you need to import the document definitions for the HL7 v2.3.1 message structures. This import provides the full definitions for only a few types of messages. Before you begin, make sure that the WebLogic Administration and Managed servers are running. To import the document definitions 1. Download the hcfp-101-adt_a03_mllp10.zip sample file. 2. Extract the file to a temporary directory and make a note of the location. 3. Open a Web browser and access the Oracle SOA Suite for healthcare integration console with the following URL: Where <hostname> is the name of the computer where WebLogic Server is installed, and <port> is the port number on which the Managed Server listens. 4. Click the Administration tab, expand Settings, and then double click Runtime. 5. Verify that Auto Stack Handler is selected and that both Inbound Dispatcher Count and Outbound Dispatcher Counter are set to In the navigation panel on the left, double click Repository Management. The Repository Management page appears. 1-2 Oracle SOA Suite for healthcare intergration - Sample Scenario

3 Creating Endpoints in Oracle SOA Suite for Healthcare Integration Figure 1 1 Repository Management Page 7. Next to the Import field, click Browse. Navigate to the temporary directory where you extracted the sample ZIP file and then navigate to artifacts/schema. 8. Select HL7DocTypeExport.zip, and click Open. 9. On the Repository Management page, click Import. The import process begins. This might take some time depending on the size of the import file. 10. Once the import completes, click OK on the confirmation dialog. 11. To verify the schema, click the Configuration tab, right-click Document Protocol, and then select Refresh. Expand Document Protocol > HL7. The HL7 versions are listed. Expand any of the nodes to view individual document definitions. 1.3 Creating Endpoints in Oracle SOA Suite for Healthcare Integration First, you need to create and configure two endpoints (In_Patient_Admission and In_ Patient_Laboratory) by using the Oracle SOA Suite for healthcare integration user interface. Task 1 Creating and configuring the In_Patient_Admission endpoint To create and configure the endpoint: 1. Log on to the Oracle SOA Suite for healthcare integration user interface by typing in the address bar of a supported Web browser and pressing Enter. <hostname> is the name of the computer where Oracle SOA Suite is installed and <port> is typically Creating an End-to-End HL7 Over MLLP Application 1-3

4 Creating Endpoints in Oracle SOA Suite for Healthcare Integration 2. Click the Configuration tab, click the Endpoint folder, and then click the Create (+) icon. This displays the Create... dialog box. 3. In the Create... dialog box, enter the following: In_Patient_Admission as Name 8010 as Port localhost as Host Name Verify that Transport Protocol is set to MLLP10, Connection Mode is set to Server. These are the default values. Note: With the Connection Mode set to Server, the Healthcare application waits and listens on the specified port for an incoming connection request. Once the request is received, the connection is established. Figure 1 2 Specifying Parameters for an Endpoint Click OK to create the endpoint. Once you click OK, the newly created endpoint is opened at the right pane of the Oracle SOA Suite for healthcare integration interface. 4. Click the + icon in the Receive section to display the document selection window. 5. Expand Document Protocol > HL7 > > ADT_A03, select the ADT_A03_def document definition, and click OK. Ensure that the Translation check box is selected. Note: With Translation selected, the Healthcare application translates messages from XML to native format and from native format to XML, allowing correlation of the message with the functional ACK. 6. Select the Enabled check box. 7. Click Apply. 1-4 Oracle SOA Suite for healthcare intergration - Sample Scenario

5 Creating Endpoints in Oracle SOA Suite for Healthcare Integration Figure 1 3 Configuring the In_Patient_Admission Endpoint Task 2 Creating and configuring the In_Patient_Laboratory endpoint To create and configure the endpoint: 1. Log on to the Oracle SOA Suite for healthcare integration user interface by typing in the address bar of a supported Web browser and pressing Enter. <hostname> is the name of the computer where Oracle SOA Suite is installed and <port> is typically Click the Configuration tab, click the Endpoint folder, and then click the Create (+) icon. This displays the Create... dialog box. 3. In the Create... dialog box, enter the following: In_Patient_Laboratory as Name 9010 as Port localhost as Host Name Client as Connection Mode Note: With the Connection Mode set to Client, the Healthcare application connects to an external server, based on the name and port number, to establish the connection. Verify that Transport Protocol is set to MLLP10. Click OK to create the endpoint. Once you click OK, the newly created endpoint is opened at the right pane of the Oracle SOA Suite for healthcare integration interface. Creating an End-to-End HL7 Over MLLP Application 1-5

6 4. Click the + icon in the Send section to display the document selection window. 5. Expand Document Protocol > HL7 > > ADT_A03, select the ADT_A03_def document definition, and click OK. Ensure that the Translation check box is selected. 6. Select the Enabled check box. 7. Click Apply. Figure 1 4 Configuring the In_Patient_Laboratory Endpoint 1.4 Creating the SOA Composite Application The following procedures describe how to create the SOA application and project, and include creating a receiving healthcare service, a sending healthcare service, and an Oracle Mediator component to transfer the data. This process includes the following tasks: Task 1, "Create a Connection to the WebLogic Server" Task 2, "Create the SOA Application and Project" Task 3, "Create and Configure the Oracle Healthcare Adapter for the receiving the ADT_A03 document" Task 4, "Create and Configure the Oracle Healthcare Adapter for sending the ADT_A03 document" Task 5, "Create an Oracle Mediator Component" Task 6, "Deploy the Composite Application" 1-6 Oracle SOA Suite for healthcare intergration - Sample Scenario

7 Task 1 Create a Connection to the WebLogic Server The Healthcare Adapter requires a connection to the WebLogic application server. When you create a connection from Oracle JDeveloper, the connection is available to all applications and projects. 1. Launch Oracle JDeveloper by running the jdev executable file. 2. In the Oracle JDeveloper toolbar, select File > New. The New Gallery Wizard appears. 3. Under Categories, expand General and select Connections. Under Items, select Application Server Connection. Figure 1 5 New Gallery Wizard 4. Click OK. The Create Application Server Connection window appears. 5. In the Name field, enter AppConn, and verify the connection type is set to WebLogic Note: The connection name can be any unique name. If you use AppConn for the name, you can run the prebuilt application with little configuration. Creating an End-to-End HL7 Over MLLP Application 1-7

8 Figure 1 6 Create Application Server Connection - Name and Type 6. Click Next. The Authentication page appears. 7. Enter the user name and password to log in to the WebLogic Server. 1-8 Oracle SOA Suite for healthcare intergration - Sample Scenario

9 Figure 1 7 Create Application Server Connection - Authentication 8. Click Next. The Configuration page appears. 9. Enter the following information for the server; Weblogic Hostname: The name of the computer where the WebLogic Administration Server resides. Port: The port number on which the Administration Server listens for requests. Weblogic Domain: The name of the user domain that is running the Administration Server. Creating an End-to-End HL7 Over MLLP Application 1-9

10 Figure 1 8 Create Application Server Connection - Configuration 10. Click Next. The Test page appears. 11. Click Test Connection Oracle SOA Suite for healthcare intergration - Sample Scenario

11 Figure 1 9 Create Application Server Connection -Test 12. When the test comes back successful, click Next, and then click Finish. 13. Click Save All. Task 2 Create the SOA Application and Project In Oracle JDeveloper, the processing logic is defined in projects which are contained in an application. You need to create the application and project before defining the processing logic. For this tutorial, you need to create a SOA application. 1. In Oracle JDeveloper, do one of the following: If there are no existing applications, click New Application. If there are existing applications, click in the existing application name in the Application Navigator toolbar, and select New Application. The Create SOA Application Wizard appears. 2. For the application name, enter FPScenario1. 3. Under Application Template, select SOA Application. Creating an End-to-End HL7 Over MLLP Application 1-11

12 Figure 1 10 Create SOA Application Wizard - Name Your Application 4. Click Next. The Name Your Project page appears. Figure 1 11 Create SOA Application Wizard - Name Your Project 1-12 Oracle SOA Suite for healthcare intergration - Sample Scenario

13 5. For the project name, enter FPScenario1Composite, and then click Next. The Configure SOA Settings page appears. 6. Select Empty Composite, and then click Finish. The application and project are created in the Application Navigator and the composite.xml file is opened in the editor. 7. Click Save All. Task 3 Create and Configure the Oracle Healthcare Adapter for the receiving the ADT_A03 document In this procedure, you will create and configure the receiving adapter for the source system in this project (the source system is the system from which messages originate). This step includes configuring the adapter, selecting an endpoint and document definition, and specifying a connection to the WebLogic server. 1. If the Components Palette is not visible, click View in the Oracle JDeveloper main menu and then select Component Palette. The Component Palette appears in the right of the window. 2. In the Components Palette, scroll down to Healthcare Adapter and drag it to the Exposed Services lane in the composite to create a receiving endpoint. The Healthcare Configuration Wizard appears. 3. On the Welcome page, click Next. The Service Name page appears. 4. For the service name, enter receive_adt_a03. Click Next. The Application Server Connection page appears. 5. Click in the AppServer Connection field and select the application server connection you created in the previous step (AppConn). 6. Click Next. The Operation page appears. 7. Select Receive to indicate that this endpoint will receive messages from the external system, and then click Next. The Document Definition Handling page appears. 8. Click Next on the Document Definition Handling page. Tip: To see the default document definition handling configuration, click the Advanced tab. The Document Definition page appears. 9. Expand HL7 > > ADT_A03, and then select ADT_A03_def. Creating an End-to-End HL7 Over MLLP Application 1-13

14 Figure 1 12 Healthcare Configuration Wizard - Document Definition 10. Click Next. 11. Click Finish. The endpoint is created, the receive_adt_a03.wsdl file appears in the Project tree, and the Healthcare Adapter appears in the Exposed Services lane. 12. Click Save All on the Oracle JDeveloper toolbar. Task 4 Create and Configure the Oracle Healthcare Adapter for sending the ADT_ A03 document This procedure describes how to create and configure the sending adapter for the target system in this project (the target system is the system to which messages are sent). 1. In the Component Palette, scroll down to Healthcare Adapter and drag it to the External References lane in the composite. The Healthcare Configuration Wizard appears. 2. On the Welcome page, click Next. The Service Name page appears. 3. For the service name, enter send_adt_a03. Click Next. The Application Server Connection page appears. 4. Select the connection you created in Task 1 from the AppServer Connection list. You can click Test Healthcare to test the connection Oracle SOA Suite for healthcare intergration - Sample Scenario

15 Figure 1 13 Healthcare Configuration Wizard - Application Server Connection 5. Click Next. The Operation page appears. 6. Select Send to indicate that this endpoint will send messages from the healthcare integration application, and then click Next. 7. Click Next on the Document Definition Handling page. Tip: To see the default document definition handling configuration, click the Advanced tab. The Document Definition page appears. 8. Expand HL7 >2.3.1 >ADT_A03, and then select ADT_A03_def. Creating an End-to-End HL7 Over MLLP Application 1-15

16 Figure 1 14 Healthcare Configuration Wizard - Document Definition 9. Click Next. 10. Click Finish. The endpoint is created, the send_adt_a03.wsdl file appears in the Project tree, and the Healthcare Adapter appears in the External References lane. The project tree should be similar to Figure Figure 1 15 Project Tree After Adding Healthcare Adapters The composite should be similar to Figure Oracle SOA Suite for healthcare intergration - Sample Scenario

17 Figure 1 16 Composite With Added Healthcare Adapters 11. Click Save All on the Oracle JDeveloper toolbar. Task 5 Create an Oracle Mediator Component Once you create the services, you can create the Oracle Mediator component that transforms the data and then routes it from the receiving service to the sending service. 1. From the Components Palette on the right, drag an Oracle Mediator component to the Components section in the composite. The Create Mediator dialog appears. Figure 1 17 Create Mediator Dialog 2. Enter Mediator_Scenario1 for the name, and click OK. 3. In the composite, wire the components together by dragging the arrow from receive_adt_a03 to an available drop zone in Mediator_Scenario1, and then dragging the yellow triangle from Mediator_Scenario1 to a drop zone in send_ ADT_A03 (drop zones are highlighted in green). This indicates the path of the messages through the SOA application. Creating an End-to-End HL7 Over MLLP Application 1-17

18 Figure 1 18 Wired Composite Components 4. Double-click the Oracle Mediator component to configure the message routing. The Mediator_scenario1.mplan file opens so you can edit the Oracle Mediator component. Figure 1 19 Mediator_Scenario1 5. In the Resequence field under Routing Rules, select FIFO for first in/first out sequencing. A Resequence Options box appears. 6. Click the Invoke Expression Builder icon next to the Group field, and enter the following text in the Expression field of the Expression Builder Oracle SOA Suite for healthcare intergration - Sample Scenario

19 $in.body/ns1:adt_a03/ns1:msh/ns1:msh.9/ns1:msg.1 Figure 1 20 Group Expression for First In/First Out Resequencing 7. Click OK. 8. In the Static Routing section, click the Assign Values icon next to the Assign Values field. The Assign Values dialog appears. 9. In the Type field in the From panel, select Constant. In the constant field, enter In_Patient_Laboratory. In the Type field in the To panel, select property. In the Property field, enter hc.toendpoint. 10. Click OK on the Assign Value dialog. 11. Click Save All on the Oracle JDeveloper toolbar, and then close the Mediator editor. Task 6 Deploy the Composite Application Once the project is complete, you deploy the application to the WebLogic server. 1. In the Application Navigator panel, right-click FPScenario1Composite, point to Deploy, and then click FPScenario1Composite. The Deploy FPScenario1Composite dialog appears. 2. Select Deploy to Application Server, and then click Next. Creating an End-to-End HL7 Over MLLP Application 1-19

20 Testing the Application 3. On the Deploy Configuration page, click Next. 4. On the Select Server page, select the server connection you defined in Task 3, and then click Finish. The healthcare application is deployed to the WebLogic server. Any messages generated during deployment appear in the lower section of the Oracle JDeveloper window. Note: A warning message may appear in the message log during deployment. You can ignore this message. Note: After creating the composite, you need to associate the composite with the required endpoint. In the Oracle SOA Suite for healthcare integration console, open the In_Patient_Admission endpoint and select FPScenario1Composite from the Composite list under the Document To Receive section. Click Apply to save the changes. 1.5 Testing the Application A sample input file is provided so you can test your application and verify that it is working correctly. You can use the Oracle B2B command-line simulator to perform the test. A configuration file is required, which is also provided in the sample ZIP file. In this test scenario, there are two endpoints: In_Patient_Admission is configured as an MLLP server, and In_Patient_Laboratory is configured as an MLLP client. You configure the B2B simulator to send HL7 messages to an MLLP server. 1. When the B2B simulator sends an HL7 message, the In_Patient_Admission endpoint receives the message. 2. The Oracle Mediator component receives the message from In_Patient_Admission and routes it to the In_Patient_Laboratory endpoint. 3. The In_Patient_Laboratory endpoint sends the message to the B2B simulator, which acts as the MLLP client. 4. The B2B simulator receives the HL7 message from the In_Patient_Laboratory endpoint. Testing the application consists of two steps: Testing the application and verifying the data. Task 1 Test the Application 1. Navigate to the temporary directory where you extracted the sample ZIP file in Section 1.2, "Importing the Document Definitions". 2. If your WebLogic Server is not installed on the local host, do the following: a. In the temporary directory, navigate to /artifacts/runtime and open hl7-config.properties in a text editor. b. Edit the following entries: Specify the value of ListeningPort as the port number of the sender endpoint (in this case, 9010) 1-20 Oracle SOA Suite for healthcare intergration - Sample Scenario

21 Testing the Application Specify the value of Name as the receiving partner s name (in this case, MyCompany) Specify the value of Port as the port number of the reciever port (in this case, 8010) Specify the value of the HostName as the name of the computer that is running the Healthcare application. c. Save and then close the file. 3. Copy hl7-config.properties to <fmw_home>/<soa_home>/bin, where <fmw_home> is the Oracle Fusion Middleware Home directory and <soa_home> is the folder where Oracle SOA Suite is installed. 4. In the temporary directory where you extracted the sample ZIP file, navigate to /artifacts/input. 5. Create two folders for the input and output files as described below: mkdir -p /tmp/blite/test/in mkdir -p /tmp/blite/test/out 6. Copy ADTA03_2.3.1_1.txt from /artifacts/input to /tmp/blite/test/in/mycompany_adta03_2.3.1.txt. For example: cp ADTA03_2.3.1_1.txt /tmp/blite/test/in/mycompany_adta03_2.3.1.txt 7. Navigate to <fmw_home>/<soa_home>/bin. 8. Set the ANT_HOME environment variable using the following command: export ANT_HOME=<fmw_home>/modules/org.apache.ant_1.7.1 Where <fmw_home> is the location where Oracle Fusion Middleware is installed. Note: If you are not using the bash shell, use the setenv command instead of the export command. 9. Run the following command: ant -f ant-b2bsimulator-util.xml b2bsimulatorstart -Dargs="hl7-config.properties" 10. After the command completes processing, shut down the simulator by running the following command: ant -f ant-b2bsimulator-util.xml b2bsimulatorstop 11. To verify that the message was processed successfully, navigate to /tmp/blite/test/in and verify that the input file is no longer there. Then navigate to/tmp/blite/test/out and verify the output message. Task 2 Verify the Message Flow in Oracle Enterprise Manager 1. Open a Web browser and log in to Oracle Enterprise Manager. The URL is: Where <hostname> is the name of the computer where WebLogic Server resides, and <port> is the port number on which the WebLogic Administration Server is listening. 2. In the left navigation panel, expand SOA until you see the FPScenario1Composite deployment. Creating an End-to-End HL7 Over MLLP Application 1-21

22 Testing the Application 3. Select FPScenario1Composite and then click the Dashboard tab if it is not already the active window. The composite instance is listed under Recent Instances, the Oracle Mediator component is listed under Component Metrics, and the healthcare services are listed under Services and References. Figure 1 21 FPScenario1Comopsite on Oracle Enterprise Manager Dashboard 4. Click the first instance ID. The message flow at each component of the composite appears. Note: Make sure pop-ups are enabled for this site; otherwise this step will not complete. Figure 1 22 Flow Trace for an Instance of FPScenario1Composite 5. Click receive_adt_a03. The Oracle SOA Suite for healthcare integration console is launched. Log in to the console and click the Reports tab to view information about the message Oracle SOA Suite for healthcare intergration - Sample Scenario

23 Testing the Application Task 3 Verify Message Processing in Oracle SOA Suite for Healthcare Integration 1. Do one of the following to open the Oracle SOA Suite for healthcare integration console: Perform the steps outlined in Task 2, "Verify the Message Flow in Oracle Enterprise Manager" to open the console from Oracle Enterprise Manager. Open a Web browser and log in to Oracle SOA Suite for healthcare integration. The URL is: Where <hostname> is the name of the computer where WebLogic Server resides, and <port> is the port number on which the WebLogic Managed Server is listening. 2. Click the Dashboard tab, and do the following: a. Click the plus icon in the upper right, and select New Dashboard. b. Name the dashboard AdmissionsToLab, select the In_Patient_Admission and In_Patient_Laboratory endpoints, and click the right arrow. c. Click Create. The new dashboard appears, displaying information about both endpoints. Figure 1 23 AdmissionsToLab Dashboard d. Click the More Endpoint Details icon to the far right of the In_Patient_ Laboratory endpoint to display Endpoint details - In_Patient_Laboratory page, which contains more detailed information. Creating an End-to-End HL7 Over MLLP Application 1-23

24 Testing the Application Figure 1 24 Endpoint Details - In_Patient_Laboratory in Healthcare Integration Dashboard e. In the Message Processing section, click the eyeglasses under Sent to view a report of the message. 3. To view reports, do the following: a. Click the Reports tab. The default report is set to view all messages for the last 24 hours. The main Reports page appears first, and then the default report appears. The flow of the selected message appears graphically below the message list. Figure 1 25 Reports Page for Healthcare Integration 1-24 Oracle SOA Suite for healthcare intergration - Sample Scenario

25 Working with the Prebuilt Sample b. Select the first message, and click Pin Current Message Details into a New Tab. A new page appears displaying greater detail about the business message. Figure 1 26 Message Details for Outbound Message to In_Patient_Laboratory c. Scroll down in the Business Message Details section to view addition information, such as communication and protocol details, message content, and correlation details. d. Click the Last 24 Hours subtab to return to the original report. Note that from this page, you can purge and resubmit messages, refresh the message list, and modify the report filters. 1.6 Working with the Prebuilt Sample The sample ZIP file includes the Oracle SOA Suite for healthcare integration files and the Oracle JDeveloper project that are described in the previous procedures. You can extract the sample project and then deploy and test it without going through the steps of creating the project. 1. Log on to 2. Click the Designer tab and then click the Administration tab. 3. Double-click Import/Export. 4. Import Oracle SOA Suite healthcare Integration configuration from /artifacts/samples/b2b/b2b-hcfp-101-mllp-scenario1.zip. 5. Expand Settings and double-click Runtime. 6. Ensure that Outbound Dispatcher Count and Inbound Dispatcher Count are set to 1, and the Auto Stack Handler check box is selected. 7. Enable the channels in Oracle SOA Suite for healthcare integration user interface as follows: Creating an End-to-End HL7 Over MLLP Application 1-25

26 Working with the Prebuilt Sample a. Click the Designer tab, click the Configuration tab, and then click the Endpoint folder. b. Double-click the endpoints (In_Patient_Admission and In_Patient_ Laboratory) and ensure that the Enabled check box is selected (if it is not already enabled, select the Enabled check box and click Apply.) 8. Unzip artifacts/samples/composite/hcfp-101-mllp- scenario1.zip on your local drive and open FPScenario1.jws in Oracle JDeveloper. 9. Perform Task 1, "Create a Connection to the WebLogic Server". 10. Perform Task 6, "Deploy the Composite Application". 11. Test the project, as described in Section 1.5, "Testing the Application" for experiencing the process at run time Oracle SOA Suite for healthcare intergration - Sample Scenario