-------------------------------------------------------------------------------- HL7 Tools Release Notes - http://www.raymarron.com/hl7/ -------------------------------------------------------------------------------- Key: + New feature or improvement - Feature deprecated or removed * Bugfix ! Breaking change, attention required upon upgrade. 2018-10-08 HL7Script 9.401 * Fixed access violations when attempting to use data modifiers F@, G@, and R@ with valid but non-existent HL7 keys. Those now return blanks. * Fixed an access violation attempting to validate LOOP SEGMENTS with an empty input message (non-HL7 input). + Changed the validation input prompt to not select a file for non-HL7 input. It would not be opened anyway, and non-HL7 input like XML and LOOP TEXT/CSV have had simulated input for validation since being introduced. 2018-09-29 HL7ScriptService 9.400, HL7TransmitterService 8.500 (and config programs) + Service versions now go out to 3 decimal places and the config programs save the version number to the ini file. When the version difference between the ini and service exe is large enough (i.e. important settings have changed), the services will refuse to start and the config programs will alert you to update your settings. A change to any "x" digit in the x.xyz version number is considered a major update. + The Error Extension and Failed Tx Extension can now contain an asterisk to include the original extension in the filename. The default was changed to "*.BAD". Example: "foo.hl7" is renamed to "foo.hl7.BAD". + Script and Transmitter threads restrict cleanup of the Archive Directory to the same extension used by their input wildcard instead of using *.*. HL7Script 9.4, HL7ScriptService 9.400 (and config) * Fixed a blank Archive Path being changed to a backslash in the service. * Validation turns off __StrictNum to avoid reporting data-related errors. * Fixed a pointer error in HL7Script Validation when a Named Fields file was selected in preferences. It tried to free it twice. + Added the ability to use non-HL7 files as input. When used, the input HL7 message supplied to the script is empty. The script must know how to handle the file based on its name (__InFile). + Script Validation now asks what sort of input to use: select an HL7 file, select a non-HL7 file, or use the default mostly-blank HL7 message. + Added the OUTPUTX command variation (OUTPUT with no line terminator). + Added the BASE64LOAD and BASE64SAVE commands. + Added the XML commands. + Added the LOOP TEXT and LOOP CSV commands. + Added the __CSVNewLine built-in variable for multi-line CSV fields. + Added the CSVFIELD and FORMATDIGITS script functions. + All loops support question mark replacement. Previously, some did not. - Deprecated Variable loops (LOOP @VAR) in favor of Expression loops that do the same thing (LOOP V@VAR <> ""). !- Removed the primary output file from HL7Script. Use FILE and OUTPUT commands in the script instead. This also removes the [HL7] OUTPUTPRIMARY command variations, as well as the __OutFile and __OutPath built-in variables. I didn't like that a script could behave differently depending on which app it was run from (and I never used it, preferring the on-screen log). 2018-09-09 HL7ScriptService 9.3, HL7TransmitterService 8.4 (and config programs) + The Service Control "Start" button changes to "Connection Status" when the service is running. Press the button to open a dialog showing the current status, last activity time, and uptime message count for each connection. HL7Script 9.3, HL7ScriptService 9.3 + No longer require TRANSLATION input/ouptut literal values to be quoted. + Added the ITRANSLATION option to create case-insensitive translation tables. + Raise an error if duplicate input values are defined in a translation table. HL7TransmitterService 8.4 * Track Duplicate Control IDs only on accepted messages. Messages that fail and are then corrected and re-sent will no longer be rejected for having a duplicate ID. 2018-08-19 HL7NamedFields 2.0 (All projects) !+ Large scale refactor of the Named Fields system to allow for much richer data validation. Instead of using double subcomponent separators (&&) to borrow another data type's component names, you can attach a data type and other validation options to any field or component. See the files themselves for syntax details. HL7Viewer will convert your v1 files. + Two named fields files are now supplied with the release: HL7NamedFields.2.3.1.txt and HL7NamedFields.2.7.txt - Removed HL7NamedFields.txt (the v1 form of HL7NamedFields.2.3.1.txt). HL7Script 9.2, HL7ScriptService 9.2 -+ Changed variable encoding in SAVEVARS/LOADVARS to use llStrings.SimpleEncode instead of Base64, making the files more human-readable. Existing Base64 encoded variables with the "___" prefix will still be read by LOADVARS, but the behavior is deprecated. HL7Viewer 8.5 + If "Show Named and Numeric Keys" is on and both keys are the same (there is no named key available), it won't show both. + If "Show Field Definition" is checked, [sub]component data type details will also be shown where available. + Added a "Validate" button to the Named Fields Data File in Preferences. It will validate the file and offer to convert v1 files to v2. When converting, the original file will be backed up with a *_v1.txt filename. + No longer cap the length of generated MSH.10 message control IDs at 20. The New Message preference's MSH.10 is used as a prefix without modification. + Added "Add Repetition" to the Edit and right-click menus. + Added the ability to directly edit repetition nodes. HL7TransmitterService 8.3 + No longer cap the length of ACK MSH.10 at 20. Whatever prefix is supplied in the ACK MSH preference is used as-is along with a timestamp+unique digit. -+ Added the "ACK ERR Template" setting and removed the "Single ERR" setting on receivers. Existing settings will be converted by the config program to preserve existing ERR segment behavior. + Added the "Proc IDs" setting on receivers. Specify the values allowed in the MSH.11 Processing ID field. Prevent production data from reaching test and vice-versa. Blank = allow anything, including blank. 2018-07-15 HL7Viewer 8.4 + Added a preference page for New Message. Enter a message you want used as the template when adding a new message to the tree. + Added the Save History preference. Turn off to keep filter and search history out of the registry since it may contain PHI. + Added the Auto Fast Search preference. When on (the default), Find in Files will automatically select a suitable fast search value if one is available and it is left blank. 2018-07-08 HL7Script 9.1, HL7ScriptService 9.1 + Added service-wide, shared, persistent variables prefixed by "%%". They are automatically loaded at service startup and saved at shutdown in a file called "HL7ScriptServiceVars.txt" in the service application directory. + Documentation change: "global" variables were renamed to "interval" variables to more clearly identify the lifetime of each type of variable: section, interval, persistent, and service. HL7ScriptServiceConfig 9.1, HL7TransmitterConfig 8.2 + Updated the manifest's requested execution level to ask for administrator permissions by default. HL7Viewer 8.3 + Rearranged controls on the Edit by Key dialog and constrained resizing. + Added the "Show Named and Numeric Keys" option on the Messages menu. When showing named fields, you can now also show the numeric keys. 2018-06-02 HL7Script 9.0, HL7ScriptService 9.0 + Added persistent variables that last for the life of the script (or until cleared). Persistent variables have a "%" prefix. In the service, they last until the service is stopped. In the interactive HL7Script program, they are effectively the same as global variables. !+ Added the Initialization and Finalization sections, and . Initialization happens just once at thread startup, and is effectively what Pre-Processing used to be. Pre-processing is now just like Post-Processing in that there are no syntax restrictions. The Finalization section is processed just prior to unloading a script at service shutdown or reloading a modified script. It also has no syntax restrictions. This is where you might want to do a SAVEVARS on your new persistent variables... - Deprecated the special need for an equal sign when calling LOADVARS in the initialization section. Just use a space like normal, LOADVARS "filename". Equal sign usage will generate a log entry or validation warning. + LOGVARS now accepts an optional wildcard and NOPREFIX. Variables that start with the wildcard will be logged. If NOPREFIX is used, the wildcard is stripped off the beginning (like the old LOGGLOBALS NOUNDERSCORE). - LOGGLOBALS [NOUNDERSCORE] has been deprecated. Use LOGVARS _* [NOPREFIX]. * Fixed an AV raised by FILE DELETE trying to expand a blank filename. HL7Viewer 8.2 + Added the "Edit by Key" feature. Makes it much easier to add a new value that doesn't exist yet, like adding PV1.44 to a new message. It sure beats editing at the field level and counting/typing in 44 pipe characters! * Fixed an AV loading a file that hit the maximum message limit (tried to assign an encoding to a null message object). 2018-04-28 THL7Message (all projects, all versions 8.1) + Added the LowHexOnly property to ignore all 8-bit characters (ASCII 128+) when hex escaping. By default (False), 8-bit characters are escaped only when the MSH.18 character set value is blank or "ASCII". HL7ScriptServiceConfig 8.1, HL7TransmitterServiceConfig 8.1 + Added the ability to change the Service ID from the GUI. Checks for conflicts and un/re-installs as needed. Replaces the View Log button. + Added a graphical View Log button next to the log selection button just like the one for the connection-specific log. HL7Viewer 8.1 * Show Segments Current (F10) was missing from the right-click menu. 2018-03-18 All projects, all versions set to 8.0 + Built in Delphi 10.2 with Unicode support. + All service logging is done as UTF-8 with a byte order mark. !- All previously deprecated features have been removed. For releases prior to 8.0, see releasenotes_old.txt HL7Viewer 8.0 + Reorganized the menus and hotkeys. + All actions are now present on the main menu. Previously, some actions were only available from the right-click popup menu. + Popup menu shows only currently enabled options. Disabled items are hidden. + Added the Move Down/Up actions. * Fixed blank key label when editing a segment. HL7Script 8.0 + Added the HL7 ENCODING command. + Added the __FileEncoding built-in variable to control FILE output encoding. + Added a name/time sorting option for wildcard input on HL7Script.exe GUI. + Added output and log encoding options on HL7Script.exe GUI. HL7TransmitterConfig 8.0, HL7ScriptServiceConfig 8.0 + Reordered controls, save/add/delete buttons are now on top. + Disabled connections are shown with strikethrough text in the list. HL7TransmitterService 8.0 (and config) + Added the Encoding setting. Both the sender and receiver must agree on the encoding. The Default setting is the system's default single-byte ANSI codepage, and should be compatible with all non-Unicode aware transmitters including previous versions of HL7TransmitterService. --------------------------------------------------------------------------------