Ancestor: HL7Connect.Events.InterfaceBase

This event is called immediately before a message is sent. If the script chooses, it can build a reply in ReplyMessage and set UseReplyMessage. In this case, the message will not be sent an ReplyMessage will be sent as the response

The script is able to modify the Message as it chooses but it should maintain a valid MSH segment.

The logs are written after this event

Setting UseReplyMessage := true while sequencenumbering is in use can have unexpected consequences. It's best not to do this

Note that when this event is called with a message that is being passed through, the message is not stored (if the incoming interface message processing mode is "Pass-through with store", the message will be stored after the remote system has responded).

XSLT: the input is the message to be sent, the output replaces the message to be sent

Properties

HL7Connect.Exchange.Message Message;
   A handle to the actual message to be sent

HL7Connect.Exchange.Message ReplyMessage;
   A handle to a prebuilt ACK answer message to the message to be sent. If the script wants, it can add to this message, and then set UseReplyMessage to true to have this message become the reply message (rather than sending the message to the nominated interface)

HL7Connect.Kernel.Interface SourceInterface;
   Handle the source interface that received the message. It is possible that the source interface is no longer valid, in which case the value will be null

bool UseReplyMessage;
   set UseReplyMessage to true to have the message in ReplyMessage become the reply message that the kernel uses (rather than sending the message to the nominated interface). Note that the OnReceiveReply event will not be called if UseReplyMessage is true


Methods

void SendToInterface(string Name);
   Send the message to the named (message) interface.

Note that this is not immediate; instead, the message will be added to the queue after the script finishes executing

void SendToInterfaceWithParams(string Name, string OutTranslationParam, string InTranslationParam);
   Send the message to the named (message) interface with translation parameters for the scripts.

Note that this is not immediate; instead, the message will be added to the queue after the script finishes executing

void SendToVirtualQueue(string Name);
   Send the message to the named virtual queue.

Note that this is not immediate; instead, the message will be added to the queue after the script finishes executing

void SendToVirtualQueueWithPartition(string Name, string Partition);
   Send the message to the named virtual queue with a specified partition.

Note that this is not immediate; instead, the message will be added to the queue after the script finishes executing


© Kestral Computing P/L 2000 - 2003. HL7Connect v2.00-063 generated on 30-Nov 2015.
Keywords: Message, SendToInterface, SendMessage, SendToInterfaceWithParams, SendToVirtualQueue, SendToVirtualQueueWithPartition, ReplyMessage, SourceInterface, UseReplyMessage, HL7Connect.Events.SendMessage