Clean-up Tool

The clean-up tool allows you to find and remove unwanted messages from a tab. This can be helpful for removing duplicate messages or messages coming from a particular source system.

• Operation - Control whether the tool removes the messages, or just performs a find.
• Remove consecutive duplicate messages - Some log files write the message twice. If this option is selected a full message comparison will be performed between the current message and the previous message. If they are equivalent, the current message will be removed from the tab.
• Remove duplicate messages, field-based - Messages are parsed in the order they appear in the tab. For each message the key expression is evaluated. If a message further in the tab is found to contain the same key expression value, it is removed from the collection. The simplest expression is just an HL7Path. For example, in the diagram above, the value in MSH-10 is used. More complex expressions can be used such as PID-3 + MSH-9.2, which will result in the tab containing at most 1 type of each message type for a given patient ID. 
  "Message to Keep" is set to "Last", the last message encountered in the tab is preserved and the previous matching messages are discarded. NOTE: You can pre-sort the messages using the Message Sort tool if you want a different order than the order the messages appear in the original file.
• Remove where - Removes messages based on a condition expression. If the condition expression evaluates to true, it is removed from the collection. In the example above, all messages where MSH-3 is SQ, VAL2, VAL3, are removed.
• Remove messages with only an MSH segment - Any messages found that only have an MSH segment are removed.
• Remove ACK messages where MSA-1 = - This removes ACK messages from the tab where the value in MSA-1 is AA, if check, AE if check, or AR if check. This is equivalent to using the "Remove where" and setting the condition to:  MSA-1 in ('AA','AE','AR')
• Place removed messages into new Tab - If this option is set, any messages that are removed are placed into their own Tab.