Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip

Before you begin,

  • Download the product installer from here, and run the installer.
    Insert excerpt
    Installing the Product
    Installing the Product
    nopaneltrue
  • Select the relevant WSO2 Integration Studio based on your operating system and download it from here.
    The path to this folder is referred to as <EI_TOOLING> throughout this tutorial.

    Info

    Getting an error message? See the troubleshooting tips given under Installing WSO2 Integration Studio.

  • If you did not try the Transforming Message Content tutorial yet,
    1. Download the pre-packaged project that contains the configurations of the Transforming Message Content tutorial.
    2. Open WSO2 Integration Studio, click File, and click Import.
    3. Next, expand the WSO2 category and select Existing WSO2 Projects into workspace, click Next, and upload the project file.

...

  1. In WSO2 Integration Studio, add a Property mediator just after the Get Hospital Property mediator in the In sequence of the API resource. This is used for retrieving and storing the card number that is sent in the request payload.

     

    With the Property mediator selected, access the Properties tab and fill in the information as in the following table:

    FieldValue
    Property NameSelect New Property
    New Property Namecard_number
    Property Action

    Select set

    Value TypeSelect Expression
    Value Expressionjson-eval($.cardNo)
    DescriptionGet Card Number
    Tip

    For detailed instructions on adding a Property mediator, see Mediating requests to the back-end service.

  2. Go to the first case box of the Switch mediator. Add a Property mediator just after the Log mediator to store the uri.var.hospital variable value that will be used when sending requests to ChannelingFeeEP.
     

    With the Property mediator selected, access the Properties tab and fill in the information as in the following table:

    FieldValue
    Property NameSelect New Property
    New Property Nameuri.var.hospital
    Property Action

    Select set

    Value TypeSelect LITERAL
    Property Data TypeSelect STRING
    Valuegrandoaks
    DescriptionSet Hospital Variable
  3. Similarly, add Property mediators in the other two case boxes in the Switch mediator. Change only the Value field as follows:
    • Case 2: clemency
    • Case 3: pinevalley
  4. Delete the Send mediator by right-clicking the mediator and selecting Delete from Model. Replace this with a Call mediator from the Mediators palette and add GrandOakEP from the Defined Endpoints palette to the empty box adjoining the Call mediator. 

    Replace the Send mediators in the following two case boxes as well and add ClemencyEP and PineValleyEP to the respective boxes adjoining the Call mediators.

    Info

    Replacing with a Call mediator allows us to define other service invocations following this mediator.

    Let's use Property mediators to retrieve and store the values that you receive as responses from GrandOakEP, ClemencyEP, or PineValleyEP.

  5. Next to the Switch mediator, add a Property mediator to retrieve and store the value sent as appointmentNumber.

     

    With the Property mediator selected, access the Properties tab and fill in the information as in the following table:

    FieldValue
    Property NameSelect New Property
    New Property Nameuri.var.appointment_id
    (This value is used when invoking ChannelingFeeEP)
    Property Action

    Select set

    Value TypeSelect EXPRESSION
    Value Expressionjson-eval($.appointmentNumber)
    DescriptionGet Appointment Number
    Note

    You derive the Value Expression in the above table from the following response that is received from GrandOakEP, ClemencyEP, or PineValleyEP:

    Code Block
    {"appointmentNumber":1,   "doctor":
            {"name":"thomas collins",
             "hospital":"grand oak community hospital",
             "category":"surgery","availability":"9.00 a.m - 11.00 a.m",
             "fee":7000.0},
       "patient":
           {"name":"John Doe",
            "dob":"1990-03-19",
            "ssn":"234-23-525",
            "address":"California",
            "phone":"8770586755",
            "email":"johndoe@gmail.com"},
       "fee":7000.0,
       "confirmed":false}
  6. Similarly, add two more Property mediators as follows. They retrieve and store the doctor details and patient details respectively from the response that is received from GrandOakEP, ClemencyEP, or PineValleyEP.

    FieldValue
    Property NameSelect New Property
    New Property Namedoctor_details
    Property Action

    Select set

    Value TypeSelect EXPRESSION
    Value Expressionjson-eval($.doctor)
    DescriptionGet Doctor Details
    FieldValue
    Property NameSelect New Property
    New Property Namepatient_details
    Property ActionSelect set
    Value TypeSelect EXPRESSION
    Value Expressionjson-eval($.patient)
    DescriptionGet Patient Details

  7. Add a Call mediator and add ChannelingFeeEP from Defined Endpoints palette to the empty box adjoining the Call mediator. 
  8. Add a Property mediator adjoining the Call mediator box to retrieve and store the value sent as actualFee. Access the Property tab of the mediator and fill in the information as in the following table:

    FieldValue
    Property NameSelect New Property
    New Property Nameactual_fee (This value is used when invoking SettlePaymentEP )
    Property Action

    Select set

    Value TypeSelect EXPRESSION
    Value Expressionjson-eval($.actualFee)
    DescriptionGet Actual Fee

    Note

    You derive the Value Expression in the above table from the following response that is received from ChannelingFeeEP:

    Code Block
    {"patientName":" John Doe ", 
     "doctorName":"thomas collins", 
     "actualFee":"7000.0"}

    Let's use the PayloadFactory mediator to construct the following message payload for the request sent to SettlePaymentEP. 

    Code Block
    {"appointmentNumber":2,
    	"doctor":{
    		"name":"thomas collins",
    		"hospital":"grand oak community hospital",
    		"category":"surgery",
    		"availability":"9.00 a.m - 11.00 a.m",
    		"Fee":7000.0
    	},
    	"patient":{
    		"name":"John Doe",
    		"Dob":"1990-03-19",
    		"ssn":"234-23-525",
    		"address":"California",
    		"phone":"8770586755",
    		"email":"johndoe@gmail.com"
    	},
    	"fee":7000.0,
    	"Confirmed":false,
        "card_number":"1234567890"
    }
  9. Add a PayloadFactory mediator next to the Property mediator, from the mediators palette to construct the above message payload. 

     

    With the PayloadFactory mediator selected, access the Properties tab of the mediator and fill in the information as in the following table:

    FieldValueDescription
    Payload FormatSelect Inline-
    Media Type

    Select json

    -
    Payload
    Code Block
    {
    "appointmentNumber":$1,
    "doctor":$2,
    "patient":$3,
    "fee":$4,
    "confirmed":"false",
    "card_number":"$5"
    }
    The message payload to send with the request to SettlePaymentEP. In this payload, $1, $2, $3, $4, and $5 indicate variables.

    We will look at adding the value for the Args field in the following steps.

    Tip

    To avoid getting an error message, first select the Media Type before providing the Payload.

  10. To add Args values for the PayloadFactory mediator, click the click Add (+) icon in  in the Args field and enter the following information as in the table given below. It provides the argument that defines the actual value of the first variable that is used in the format definition (in the previous step).

    FieldValueDescription
    TypeSelect Expression-
    Value

    $ctx:uri.var.appointment_id

    The value for the first variable ($1) in the message payload format.
    Evaluator

    Select xml

    Indicates that the expression provided is in XML.
    Info

    The $ctx method is similar to using the get-property method. This method checks in the message context. For more details on using this method, refer the documentation.

  11. Similarly, click Add and add more arguments to define the other variables that are used in the message payload format definition. Use the following as the Value for each of them: 

    $ctx:doctor_details
    $ctx:patient_details
    $ctx:actual_fee
    $ctx:card_number

  12. Add a Call mediator and add SettlePaymentEP from the Defined Endpoints palette to the empty box adjoining the Call mediator.
  13. Add a Respond mediator to send the response to the client. 
    You should now have a completed configuration that looks like this:
  14. Save the updated REST API configuration.

...

  1. Open the pom.xml file of the SampleServicesCompositeApplication project, which is already included in the project explorer.
  2. Select the artifact that needs to be included into the CAR file.
    Image Added

Note

Ensure the following artifact check boxes are selected in the Composite Application Project POM Editor.

  • SampleServices
    • HealthcareAPI
    • ClemencyEP
    • GrandOakEP
    • PineValleyEP
    • ChannelingFeeEP
    • SettlePaymentEP
  • SampleServicesRegistry

...

  1. Download the JAR file of the back-end service.
  2. Open a terminal and navigate to the location where your saved the back-end service.

  3. Execute the following command to start the service:

    Code Block
    java -jar Hospital-Service-JDK11-2.0.0-EI7.jar

The Healthcare service is now active and you can start sending requests to the service.

...