Order management

The OrderManager tool is able to manage orders from various domains:

Radiology, Eye Care, and Cardiology orders

The order management part for radiology/cardiology is divided into two parts: placer order and filler order. The placer order part gathers the actions related to the Placer Order Management transaction (RAD-2) whereas the filler order part is dedicated to the Filler Order Management transaction (RAD-3). 

The orders can be created either by the Order Placer (RAD-2) or by the Order Filler (RAD-3). In both cases, each system attributes an order number to the just created order. In the RAD-3 transaction case, initiated by the Order Filler, the Order Placer has to notify the Order Filler of the number it has attributed to the order contain in the message sent by the Order Filler.

SWF.b

From version 4.0.0, the Order Manager tool supports the SWF.b profile. It will be able to handle and validate the OMG messages your SUT sent to it. You can also ask the tool to use HL7v2.5.1 instead of HL7v2.3.1 when configuring the message to send to your SUT, to do so, tick the "Send HL7v2.5.1 messages ?" checkbox.

Placer Order management (RAD-2)

The placer order management transaction is initiated by the Order Placer, the one sends a message of type ORM^O01^ORM_O01 to the Order Filler. Three actions can be performed, for each one, the order control code contained in the message (ORC-1) differs.

Your system plays the role of the Order Filler for this transaction, read the following lines:

You reach this page from menu Radiology/Order Placer/[RAD-2] Create/Cancel orders.

Create a new order (order control code = NW)

Firstly, select the configuration of your system under test; the simulator needs it to send the message. Then select "Create a new order" choice. The list of encounters stored in the simulator is displayed, you just have to select the one you want. If you are logged in, you can easily retrieve the encounters you have previously created by checking the "Display only my data" checkbox. The demographics of the patient related to the selected encounter and the details about the encounter are displayed. Below, you can see a panel entitled "The order". Here are the values required by the simulator to create the message. If you are boring with filling all the fields, you can fill only some (or none) of them and hit the "Randomly fill the order and send message". Random values will be taken from the SVS repository. If you feel courageous, fill the requried fields and hit "send message" button. Finally, the table gathering the message sent by the simulator and the one received from your system is displayed. You can used the validation button to check the conformance of the messages to the IHE specifications.

Hit the "Perform another test" button to continue testing.

Cancel an existing order (order control code = CA)

Select the action to perform as "Cancel an existing order". You will be provided with the list of orders holded by the Order Placer part of the simulator. Select the one you want to cancel, a pop-up shows up which ask you to confirm your choice. If you click "yes", the message is automatically sent to your Order Filler. If you click "no", the pop-up is closed and nothing else is done.

Stop the fullfilment of an "in progress" order (order control code = DC)

The order control code DC is sent when an order is already started. The action to perform are the same as the one for cancelling an order. 

Your system plays the role of the Order Placer for this transaction, read the following lines:

Read carefully the configuration of our Order Filler. To do so, go to Radiology/Order Filler/Configuration. The Order Filler will store all the messages it receives and integrates them; that means that it will create/cancel/discontinue the sent order. Be carefull to always send the same placer/filler order number for a given order. The orders received from your simulator are stored in the database and you can browse them from menu Radiology/Order Filler/Data Browser. The name of the creator is "{sending application}_{sending facility}".

Filler Order management (RAD-3)

The placer order management transaction is initiated by the Order Filler, the one sends a message of type ORM^O01^ORM_O01 to the Order Placer. Three actions can be performed, for each one, the order control code contained in the message (ORC-1) differs. 

Your system plays the role of the Order Placer for this transaction, read the following lines:

You reach this page from menu Radiology/Order Filler/[RAD-3] Create/Update/Cancel orders.

Create a new order (order control code = SN)

Firstly, select the configuration of your system under test; the simulator needs it to send the message. Then select "Create a new order" choice. The list of encounters stored in the simulator is displayed, you just have to select the one you want. If you are logged in, you can easily retrieve the encounters you have previously created by checking the "Display only my data" checkbox. The demographics of the patient related to the selected encounter and the details about the encounter are displayed. Below, you can see a panel entitled "The order". Here are the values required by the simulator to create the message. If you are boring with filling all the fields, you can fill only some (or none) of them and hit the "Randomly fill the order and send message". Random values will be taken from the SVS repository. If you feel courageous, fill the requried fields and hit "send message" button. Finally, the table gathering the message sent by the simulator and the one received from your system is displayed. You can used the validation button to check the correctness of the messages.

Hit the "Perform another test" button to continue testing.

Cancel an existing order (order control code = OC)

Select the action to perform as "Cancel an existing order". You will be provided with the list of orders holded by the Order Filler part of the simulator. Select the one you want to cancel, a pop-up shows up which ask you to confirm your choice. If you click "yes", the message is automatically sent to your Order Placer. If you click "no", the pop-up is closed and nothing else is done.

Update the status of an order (order control code = SC)

Select the action to perfrom as "Update order status". you will be provided with the lists of orders horded by the Order Filler part of the simulator. Select the order you want to update, a pop-up shows up which ask you to select the new status of the order. Click on the "Send update notification", the message will be automatically sent to your system under test.

Your system plays the role of the Order Filler for this transaction, read the following lines:

Read carefully the configuration of our Order Placer. To do so, go to Radiology/Order Placer/Configuration. The Order Placer will store all the messages it receives and integrates them; that means that it will create/cancel/update the sent order. Be carefull to always send the same placer/filler order number for a given order. The orders received from your simulator are stored in the database and you can browse them from menu Radiology/Order Placer/Data Browser. The name of the creator is "{sending application}_{sending facility}".

 

Laboratory orders

All the actors playing a role in the LTW and LAW integration profiles from the Laboratory domain are available under the Laboratory menu.

Order Placer

Under the Laboratory/Order Placer menu, you will find three sub menus:

  • [LAB-1/LAB-2] Notify Order Filler of orders: this page is dedicated to the sending part of the Order Placer actor from LTW profile. You will be able to create/cancel an order and to send a message to your SUT acting as an Order Filler.
  • Configuration: this page is dedicated to the receiving part of the Order Placer. You will find the IP address, port and receiving application/facility names of this part of the simulator.
  • Data Browser: this entry points to the page where the patients and the orders/specimens owned by this part of the simulator are gathered.

Order Filler

Under the Order Filler menu, you will find five sub menus but only two of them deal with the management of orders :

  • [LAB-1/LAB-2] Notify order placer of orders: this page is dedicated to the sending part of the Order Filler actor from the LTW profile. You will be able to create/cancel update the status of an order and send a message to your SUT acting as an Order Placer.
  • Configuration: this page is dedicated to the receiving part of the Order Filler. You will find the IP address, port and receiving application/facility names of this part of the simulator.

Creation of a new order

Both Order Filler and Order Placer parts of this simulator work in the same way; only some little differences can be noticed due to differences between those two actors as described in the Technical Framework of Laboratory.

First of all, select your system under test from the drop-down list entitled "System Under Test".

Then select the action to perform: Create a new order

As defined in the Technical Framework, LAB-1 and LAB-2 transactions allows the Order Filler and Order Placer actors to exchange orders using different structures. In this part of the simulator, we enable you to test all of them. Differences between structures implies that the way to build an order in not the same depending on the message you want to send. As a consequence, before creating an order, you will have to tell the simulator which structure you want to use (see below).

Then select an encounter from the displayed list. Using "Create a new patient and encounter" you will be able to ask for the generation of a new patient with random demographic data, using "Create a new encounter for an existing patient" you will get a new encounter for a patient selected in the displayed list.

Laboratory order message (OML^O21^OML_O21) 

This message structure is battery-centric. To build such an order, follow the steps below:

  1. You are first asked to fill out the order properties (use the "Fill with random values"  button for a random filling of the form).
  2. Once you think the order is properly defined, click on "Create a specimen for order" button.
  3. A new form appears, fill it out with specimen properties, in the same way as previously the "Fill with random values" button can help you for this task. 
  4. Click on "Add to current order" to add the specimen to the order you have previously created.
  5. If you need more than one specimen, click on "Add a specimen to this order" button and repeat steps 3 to 5.
  6. Once all the specimens are created, click on "Send message" button.

Note that you can remove a specimen from the list using the red "minus" sign located on each row of the table.

Laboratory order for multiple orders related to a single specimen (OML^O33^OML_O33)

This message structure is specimen-centric. To build such an order, follow the steps below:

  1. You are first asked to fill out the specimen properties (use the "Fill with random values" button for a random filling of the form).
  2. Once you think the specimen is properly defined, click on "Create an order for specimen" button.
  3. A new form appears, fill it out with order properties, in the same way as previously the "Fill with random values" button can help you for this task.
  4. Click on "Add to current specimen" button to add the order to the specimen you have previously created.
  5. If you need more than one order, click on "Add an order to this specimen" button and repeat steps 3 to 5.
  6. Once all the orders are created, click on "Send message" button.

Note that you can remove an order from the list using the red "minus" sign located on each row of the table.

Laboratory order for multiple orders related to a single container of a specimen (OML^O35^OML_O35)

This message structure is specimen-centric. For each specimen, a list of containers is given and for each container, a list of orders is specified. To build such an order, follow the steps below:

  1. You are first asked to fill out the specimen properties (use the "Fill with random values" button for a random filling of the form).
  2. Once you think the specimen is properly defined, click on "Create a container for specimen" button. The list of containers specified for the current specimen is displayed. 
  3. To add an order for a given specimen click on the "Add an order for this container" button.
  4. Fill out the order properties and click on the "Add to current container" button. The order will be displayed within a table below the relative container.
  5. Repeat steps 3 and 4 until you have created all the orders you want.
  6. If you need to add another container to the specimen, click on "Add a container for specimen" button.
  7. To add orders to this new container, repeat steps 3 and 4.
  8. Finally, click on the "Send message" button.

Note that you can remove an order from a container using the red "minus" sign located on each row  of the table. You can also remove a container from the specimen by clicking on the red "minus" sign located beside the container identifier.

Cancellation of an order

 

Both Order Filler and Order Placer actors can cancel existing orders. See below the instructions to send such a message to your SUT.

  1. Select your system under test from the drop-down list entitled "System Under Test".
  2. Then select the action to perform: Cancel an existing order
  3. Select the structure of message to use
  4. Select the order to cancel. A pop-up raises, click on "Yes" to send the cancellation message.

Update of an order

Only the Order Filler has the capabilities to update the status of an order. See below the instructions to send such a message to your Order Placer.

 

  1. Select your system under test from the drop-down list entitled "System Under Test".
  2. Then select the action to perform: Update order status.
  3. Select the structure of message to use
  4. Select the order to update. A pop-up raises, select the new status of the order and click on "Send update notification" button.

Sending messages to the simulator from your SUT

As mentionned above, the simulator is able to act as an Order Filler and an Order Placer (receiving role) for LAB-1 and LAB-2 transactions. The messages supported by the simulator are the same as the one it is able to send, all of three defined structures will be understood by the simulator. To browse the orders received by the simulator, go to the Data Browser menu linked to the actor you are using:

  • All orders (battery-centric) for the orders sent and received within OML^O21^OML_O21 messages
  • All orders (specimen-centric) for the orders received and sent within OML^O33^OML_O33 and OML^O35^OML_O35 messages. In that page, you will first see the specimen, and then, for each specimen, the list of orders.

Pathology orders

Not yet implemented