-------------------------------------------------------------------------------- HL7 Tools Release Notes - https://www.raymarron.com/hl7/ -------------------------------------------------------------------------------- Key: + New feature or improvement - Feature deprecated or removed * Bugfix ! Breaking change, attention required upon upgrade. 2019-07-13 All Projects + Started moving release notes over one year old into releasenotes_old.txt. + Started removing deprecated features one year after deprecation. HL7Script 10.200 + Added the error processing section, . + Added the __ErrorText and __ErrorType built-in variables. + No longer force a prefix of "ERROR: " onto ERROR command text, but will default to "ERROR" if the text ends up blank. !- Removed the deprecated LOGGLOBALS command. !- Removed the deprecated use of LOADVARS with an equal sign in INIT section. HL7ScriptService 10.010 + Added handling of the script error processing section. + Added the :ErrorType parameter to the Error SQL. + The error type is included when the service logs errors as "[Type] Text". 2019-07-06 HL7Script 10.120 + Made the __OutputMsgStr/Text variables read-write to allow the output HL7 message to be set from any data, e.g. a message retrieved from a database. + Added the __AnonymizerDef and __NamedFieldsDef built-in variables to allow the definitions to come from data as well as a file. + Added the W@ Double Quote data modifier. + Added the J@ data modifier (the last remaining unassigned letter!) as a shortcut for the EXISTS script function. + Added the SLEEP command. + Added the EXECUTE script function. - Deprecated the SHELL script function in favor of the more flexible EXECUTE. + Continuing QA script coverage improvements (now over 1300 lines): * Fixed expression loops ignoring BREAK. * Fixed text/csv loops ignoring BREAK and QUIT. * Fixed blanks when reading the __DebugData and __Epsilon built-in variables. Assigning them worked as expected. * Fixed INC and DEC not allowing whitespace around the optional equal sign. 2019-06-29 HL7Script 10.110 + GREATLY improved the comprehensive test script which found the following: * No longer cache pre-parsed IF/ELSEIF/ELSE blocks inside of loops because the question marks and other replacements in the cached lines were not being updated for iterations beyond the first. * Fixed script function arguments being parsed like csv data and interpreting things like HL7 NULLs ("") as empty quotes. * Fixed XML GET prematurely evaluating the variable name argument. * Fixed some HL7 commands prematurely evaluating the segment/field key. * Fixed HL7 IREPLACE not properly finding case-insensitive values. * Fixed validation raising a closed dataset exception in LOOP QUERY. * Fixed validation warning on all properly prefixed variable names in SET. * HL7Script_NPPLang.xml was missing a few HL7 command keywords. + Added the HL7 REPLACE "WHOLE" option to match on whole values only. + LOGVARS now supports the full comma-separated wildcard list like SAVEVARS instead of only a single wildcard. 2019-06-22 HL7Script 10.101 * Fixed an "Invalid or blank variable name" error introduced in 10.100. Sorry! Poorly tested last-minute addition, improving automated tests. * Fixed the FILEPART script function not returning anything. + Added the "S" part to FILEPART to return the file Stripped of its extension. 2019-06-15 HL7Script 10.100 + Section variables now have a dollar-sign ($) prefix instead of no prefix. Now that all variables have a special prefix character, the V@ modifier is only needed when using expressions or un-prefixed variable names from older scripts! -+ The "special" section variables (CSVCOUNT, FIELDCOUNT, LOOPTEXT, ROWSAFFECTED, and XMLOK) are set both with and without the $ prefix so that older scripts will still work without modification. This double declaration is immediately deprecated and in the future will be prefixed only. + Validation will issue a warning if a SET command is used with an un-prefixed variable name. In the future, this will raise an error. +* Refactored CombineFragments.h7s to use new variable prefixes. Output uses HL7 APPEND instead of __OutFile, which was removed back in v9.4 (oops!). * HL7Script.exe: Set the main form to not scale because some controls within the tabbed container do not scale properly above 100%. HL7Viewer 10.021 * Select for Diff and Diff with Selected were only present on the right-click menu, not the main menu. Added them to the Messages menu. * Set the Preferences and Find in Files/Database forms to not scale because some controls within the tabbed container do not scale properly above 100%. 2019-05-27 HL7Script 10.010 + Made LOOP QUERY and the Q@ modifier set ROWSAFFECTED like X@ does. + LOOP QUERY also sets the FIELDCOUNT section variable (handy with select *). HL7Transmitter 10.020 (and Config) + Added the boolean "ACKTimeZone" setting on receivers. The ACK message's MSH.7 will include the local time zone when true. This setting appears as the "TZ" checkbox next to the ACK MSH template. 2019-05-11 HL7Script 10.001 + Added detection of unclosed quotes (e.g. "foo). HL7Transmitter 10.010 (and Config) + Added Receiver Rules. Optional HL7Script IF expressions that will reject a message if they evaluate to true. Each is defined with an error code and text for the ACK message. HL7Viewer 10.020 + Added the Reverse Sort option to the Messages menu. Simply reverses the order of the messages in the list. 2019-05-03 HL7Viewer 10.011 * Fixed sorting ignoring all but the first key in the list. 2019-04-27 HL7Viewer 10.010 + Combined Find in Files and Find in Database into a single menu item/form. + All resizeable dialogs now remember their last position and size. + Added Copy Key and Copy Named Key to the Edit and popup menus. 2019-03-22 HL7Viewer 10.000 + Added DATABASE SUPPORT! + Added the "Find in Database" option to the Edit menu. It works like Find in Files, but uses a database query instead of a file wildcard. It shares the same match criteria history and clear/append settings as Find in Files. + When a message comes from the database, the PK is stored as if it were the filename, and shows a prefix of "PK=". The prefix is removed when copied. + Added the Tab Chars preference for query editing. 2019-03-10 HL7Script 10.000, HL7ScriptService 10.000 (and Config) + Added DATABASE SUPPORT! + Changed the Post-Process on File/Interval radio buttons to the "Post-Process at Interval end" checkbox. Auto-converted. + Added the Q@ (Query) and X@ (eXec) data modifiers. + Added LOOP QUERY to loop over query results, with the QUERYFIELD function and Y@ data modifier for accessing the fields of the query. + Remember config window positions between runs. 2019-02-17 HL7TransmitterService 10.000 (and Config) + Added DATABASE SUPPORT! Currently linked drivers: MSSQL, MySQL, ODBC, Oracle, PostgreSQL, SQLite. Others available, just ask. + Included FDAdministrator.exe for configuring database connections. + Major config program changes to support both file-based and database. + Changed the Encoding combobox to a UTF-8 checkbox. Auto-converted. + Remember config window positions between runs. * Fixed non-persistent or scheduled transmitter connections seeing all send attempts as a "Timeout" after a stop/start. All projects + Adopted the service versioning scheme of "V.MFB" for all applications: V=Version (Primary), M=Major change, F=Feature, B=Bug fix or minor change HL7Script 9.421 * Fixed debug logging not including ELSEIF and ELSE lines. HL7Viewer 8.701 + Changed Default Encoding preference and Transmit Message Encoding setting to UTF-8 checkboxes. Auto-converted. * Fixed an incorrect "Timeout" result when transmitting a message more than once without closing the dialog. 2019-01-01 THL7NamedFields, THL7Message (all projects) + Added support for Table definitions and validating data against them. + Named Fields version remains at 2 as it is an optional extension to the existing file format. HL7Script 9.420 + Added ELSEIF support to IF statements. + Added TABLE support to the VALIDATE script function. HL7ScriptServiceConfig 9.410, HL7TransmitterServiceConfig 8.510 + Added a "Copy" button to the Connection Status screen. HL7TransmitterServiceConfig 8.510 * Renaming/deleting a receiver connection will rename/delete an existing persistent duplicate control ID tracking file. Service must be stopped. + Added the Table option to Named Fields validation choices on receivers. HL7Viewer 8.7 + Added the Table option to Named Fields validation choices in preferences. 2018-12-22 HL7Script 9.410 + Made the I@ data modifier an equivalent to the CSVFIELD script function. HL7Viewer 8.6 + Added the "Transmit Message" (F6) feature to the Messages and popup menus. Transmits the selected message to an IP:Port and displays the result. + Added the Default Encoding preference. * Fixed the Low Hex Only property not being cascaded to all messages in the list. THL7Message (all projects) * Fixed hex escaping ignoring the presence of a multi-byte encoding when the Low Hex Only property was False. 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 may 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 input wildcard instead of always 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. This simplifies the documentation, and 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. -------------------------------------------------------------------------------- For release notes older than one year, see releasenotes_old.txt --------------------------------------------------------------------------------