Ancestor: HL7Connect.Events.Base

Called by an incoming scripted dicom message interface basis. If the script determines that a message is to be generated, then it should create one and send it using the SendMessage method

The script is called under two different circumstances (as configured). Either it is called on a regular schedule, or it is called when there are items in the virtual queue to be processed. If the event is called because there is a message or document in a virtual queue, then either the IncomingMessage, IncomingDocument oir IncomingDicomMessage properties will be non-null, and the script must set IncomingHandled to true - or else the same message will be processed repeatedly

Note that this is the one place in HL7Connect where documents, hl7 messages and Dicom message can mix - this event produces an outgoing dicom message, but either documents or hl7 or dicom messages will come in, depending on the configuration of the interface

Properties

HL7Connect.Exchange.Message IncomingMessage;
   The message that is being handled, if the event is being called because a message has been queued to a virtual queue that the incoming scripted interface is triggered on.

HL7Connect.Exchange.Document IncomingDocument;
   The Document that is being handled, if the event is being called because a Document has been queued to a virtual queue that the incoming scripted interface is triggered on.

HL7Connect.Exchange.DicomMessage IncomingDicomMessage;
   The DicomMessage that is being handled, if the event is being called because a DicomMessage has been queued to a virtual queue that the incoming scripted interface is triggered on.

bool IncomingHandled;
   If the event is being called in response to a message or document in a virtual queue, this must be set to true to tell the kernel to remove the message from the virtual queue - else the script will be called again indefinitely.

You can safely leave IncomingHandled = false; there is always a short break (at least 1 second) before repeating the script after IncomingHandled is false to keep the load on the system down


Methods

HL7Connect.Dicom.Message MakeDicomMessage();
   Start building a CDA DicomMessage. The DicomMessage is created, but no properties are set

void SendDicomMessage(HL7Connect.Dicom.Message ADicomMessage);
   Send the DicomMessage to the kernel as a new incoming DicomMessage.

If sending the DicomMessage fails, an exception will be thrown

void SendDicomMessageEx(HL7Connect.Dicom.Message ADicomMessage, string ASourceParameter);
   Send the DicomMessage to the kernel as a new incoming DicomMessage. The second parameter is passed to any incoming scripts as the source parameter on the event

If sending the DicomMessage fails, an exception will be thrown


© Kestral Computing P/L 2000 - 2003. HL7Connect v2.00-063 generated on 30-Nov 2015.
Keywords: IncomingDocument, IncomingHandled, IncomingMessage, IncomingDicomMessage, MakeDicomMessage, SendDicomMessage, SendDicomMessageEx, HL7Connect.Events.CheckDicomMessage, CheckDicomMessage