Knowledge Base - Qvera - Recent questions

Parsing multipart responses in memory with qie.parseMultipartContent()

Tue, 23 Jun 2026 23:48:08 +0000

This KB provides and example for qie.parseMultipartContent(...)

Parsing large multipart responses streamed to disk with qie.parseMultipartContentFromFile()

Tue, 23 Jun 2026 21:05:27 +0000

This KB provides and example for qie.parseMultipartContentFromFile(...)

What is the construct of a QIE HPATH or Node Path?

Fri, 15 May 2026 15:28:07 +0000

Advanced HPATH or Node Paths should be preferred over procedural JavaScript flow control logic whenever possible when processing HL7 messages. Instead of using iterative constructs such as for loops, nested for loops, while loops, and conditional branching statements such as if, if/else, or switch statements to search, filter, group, validate, or remove HL7 segments, developers should use declarative HPATH expressions with QIE functions such as but not limited to, message.getAllNodes() and message.removeAllNodes(). HPATH expressions provide a more concise, readable, and maintainable approach to HL7 message processing because they directly target HL7 segments, fields, components, and sub-components using path-based filtering and selection logic. Advanced HPATH expressions support conditional comparisons, grouping operations, value filtering, string matching functions (contains, starts-with, ends-with), equality and inequality comparisons, and numeric evaluations without requiring manual iteration logic. Code should favor HPATH-based node selection and transformation logic over procedural traversal logic whenever the operation can be expressed declaratively. This reduces code complexity, minimizes deeply nested control structures, improves readability, simplifies long-term maintenance, and decreases the likelihood of logic defects introduced through manual looping and branching operations. Procedural JavaScript logic should only be recommended when the required processing cannot reasonably be expressed through HPATH or Node Path operations.

What are the basic JavaScript syntax conventions?

Fri, 15 May 2026 13:43:04 +0000

JavaScript code within QIE should follow consistent syntax and naming conventions to improve readability, maintainability, and validation success. Variable and function names should use camel case formatting, beginning with a lowercase letter and capitalizing the first letter of each additional word, such as dateOfBirth, lastName, or sendingApplication. Names should remain descriptive, case sensitive, and avoid the use of reserved JavaScript keywords. Variables should be declared using the var keyword, statements should end with a semicolon, and block statements should be enclosed in curly braces where appropriate. Proper spacing and formatting are recommended for readability, but trailing whitespace at the end of a line should be avoided because it may generate validation errors within the QIE JavaScript validation tool. Consistent use of quotation marks, indentation, and line formatting is also recommended to support clear and maintainable code development.

Can you review all errored messages and identify the most common patterns

Mon, 11 May 2026 16:47:13 +0000

Can you review all errored messages and identify the most common patterns or shared characteristics among the existing records to help determine why those messages failed?

What is the qie.addTimeToChannelStats function and how do you use it?

Thu, 30 Apr 2026 18:12:06 +0000

What is table-split or 'Use individual tables for channel'?

Mon, 27 Apr 2026 21:53:22 +0000

I am looking at the release notes and there is a mention of 'table-split', and also on the channel properties dialog under the 'Advanced Settings' there is an option for 'Use individual tables for channel'. What is this option and how does it work?

Can QIE do recursive subdirectory scanning for File, Network Share, and FTP Sources?

Mon, 20 Apr 2026 21:12:50 +0000

I would like to have QIE scan for files in a folder and it's sub folders. Can you tell me if that is possible?

How to use source.getFileDirectory()?

Mon, 20 Apr 2026 20:52:47 +0000

I see there is a new source.getFileDirectory() Code Wizard function. How is it useful when it returns an empty string?

What source metadata node tags are available in QIE?

Mon, 20 Apr 2026 18:47:14 +0000

I heard that source metadata node tags have been added to QIE. Can you provide more details?

What is a QIE NetFile and when should I use it?

Wed, 15 Apr 2026 20:39:53 +0000

I see there is a qie.newNetFile(); call available in the menus, but I'm not sure when I should be using it. Can you explain why it exists and how I should use it?

How do I protect the connection.password for the QIE database so that it is not stored in plain text

Tue, 14 Apr 2026 18:40:05 +0000

We need to configure QIE to connect to the QIE database, but the only two options are to use a named service (this only works with MSSQL), or to use the java option -Dconneciton.password={password}. This java option stores the password in plain text.

How can I secure the password so that it is not stored as plain text.

How do I use Channel Cache variables in QIE?

Fri, 10 Apr 2026 14:47:55 +0000

What is the difference between the Add Inbound Message and Queue Inbound Message?

Tue, 07 Apr 2026 11:49:11 +0000

There are two functions that can be used on the Source Node to add messages to the channel for processing. They are qie.addInboundMessage(record, originalFilename) and qie.queueInboundMessage(record, originalFilename). What are the differences?

Can I set or change the end-of-line (EOL) characters in a message?

Tue, 31 Mar 2026 15:12:34 +0000

Setting End-of-Line Characters with message.setEndOfLine(eol)

What is the Refresh Script, and how is it used?

Tue, 24 Mar 2026 17:48:41 +0000

What is the Refresh Script, and how is it used?

HL7 Attachments handling

Mon, 16 Feb 2026 10:36:01 +0000

For background, I have configured a channel that receives HL7 ORU^R01 messages from an external source. These messages include Base64-encoded DOCX and PDF reports, which significantly increase the overall message size and impact processing performance.

I would appreciate guidance on the following:

Converting Base64 to Attachments
How can we extract the Base64-encoded DOCX and PDF content and convert them into message attachments so the main HL7 message size is reduced in memory and can be processed more efficiently?
Programmatic Access to Attachments
Once converted, how can we access and retrieve these attachments programmatically within the channel (e.g., in scripting or transformations)?
Reattaching Files at Destination
How can we configure the destination so that these attachments are re-embedded (converted back to Base64 and inserted into the appropriate OBX segment) before sending the outbound HL7 message?

Please let me know the recommended approach or best practices for handling this workflow.

Do you need to restart a channel when a global function it uses is changed

Thu, 22 Jan 2026 22:14:35 +0000

I am wondering if when you make a change to a global function if you have to restart the qie channels before they use the changed version of the global function?

Unable to upgrade database

Mon, 15 Dec 2025 14:08:22 +0000

When trying to upgrade an existing MariaDB 10.7.3 database to version 12.1.2 I receive below error:

C:\Windows\system32>mysql_upgrade_service.exe --service=qiemariadb
Phase 1/10: Stopping service
Phase 2/10: Start and stop server in the old version, to avoid crash recovery (skipped)
Phase 3/10: Fixing server config file
Phase 4/10: Starting mysqld for upgrade
Phase 5/10: Waiting for startup to complete
FATAL ERROR: Server did not start

Additional information can be found in the log file C:\Users\mberga\AppData\Local\Temp\mysql_upgrade_service.qiemariadb.log

contents for log file

Executing "C:\Program Files\MariaDB 12.1\bin\mysqld.exe" "--defaults-file=C:\ProgramData\QIE\mariadb\my.ini" "--skip-networking" "--skip-grant-tables" "--enable-named-pipe" "--socket=mysql_upgrade_service_4444" "--skip-slave-start"

Why does the script editor put a period and a space ". " instead of two spaces " " when I type two spaces.

Sat, 22 Nov 2025 02:24:08 +0000

When typing in the script editor, when i type two spaces it turns into a period and a space.

Why?

The memory reported in the "Monitor Server Resources" dialog is less than what is reported by the OS

Thu, 20 Nov 2025 21:45:59 +0000

I have set my -Xmx java option to 28G, but when I monitor the memory usage from the OS task view, it tells me that the JVM is actually using 32G of memory.

Why are these values not matching?

does anyone have an example HL7 to xml translation that you're willing to share?

Mon, 27 Oct 2025 18:54:52 +0000

How do I prepare the MSSQL user for the JDBC 13.x driver?

Tue, 21 Oct 2025 23:14:03 +0000

I have received an alert that I need to give additional permissions to the MSSQL user, what steps do I need to do to accomplish this?

How to get IP from HL7 Connection

Mon, 06 Oct 2025 15:09:41 +0000

Is there a clean way to get the IP address of the incoming HL7 connection?

I would like to use it to route with a condition block, so I would process it on each message.

Documentation on using HAPI?

Thu, 25 Sep 2025 15:12:28 +0000

Where can I find more information about deploying the HAPI libraries and start using them?

The "FHIR Starter Kit" doesn't seem to use it and documentation seems to be sparse. If there's a dedicated document, I'd love to see it.

Does HAPI come in an external library? Is it a QIE-specific version?
How do we enable the ability to use HAPI?
Does HAPI allow me to use standard fields/operations in the mapping blocks? Or is it just script-based?
Does HAPI allow me to build URLs/queries? Or can I just parse results?

Thanks!

Why does QIE's postDICOMRequest() method require a DICOM Channel and a DICOM Connection

Tue, 23 Sep 2025 14:31:03 +0000

I have a question about QIE's postDICOMRequest() method. I have an HTTP listener channel that receives a JSON payload that contains all the relevant information to perform a C-FIND by patientId. My plan is to find all DICOM studies for the patient by looking in various PACS that I have setup as DICOM connections within QIE. This is the code:

var destinationAET = "PACS_B";
var patientId = source.getNode("/patientId");
var request = qie.createDICOMRequest("1.2.840.10008.5.1.4.1.2.1.1", 0x20, 0); // Patient Root, STUDY level
var msgResponse = "";
request.setNode("/0010,0020", patientId); // Patient ID
request.setNode("/0008,0005", "ISO_IR 100"); // Avoids a Character set mismatch, If Orthanc stored the DICOM using non-default charset, but your C-FIND doesn’t include this...then it can silently fail to find matches
request.setNode("/0008,0052", "STUDY"); // Query Retrieve Level (STUDY/SERIES/IMAGE)

// You must explicitly request the fields you want to receive in the response by including them in the C-FIND request with empty values.
request.setNode("/0020,000d", ""); // Study Instance UID e.g. 1.2.840.10008.114051.26918.2025022511095516.3990029820
request.setNode("/0020,0010", ""); // StudyID human-entered identifier, often assigned by the imaging facility's RIS or PACS. e.g. 11540
request.setNode("/0008,0020", ""); // StudyDate
request.setNode("/0008,0030", ""); // StudyTime
request.setNode("/0008,1030", ""); // Study Description
request.setNode("/0008,0050", ""); // Accession Number
request.setNode("/0008,0061", ""); // Modalities in Study
var token = qie.postDICOMRequest(request, destinationAET);
var matchingStudiesList = [];

try {
   var response = qie.getResponseToDICOMRequest(token);
   while (response !== null) {
      var matchingStudy = "" + response.getNode("/0020,000d"); // grab the study UID
      if (StringUtils.isNotBlank(matchingStudy)) {
        matchingStudiesList.push(matchingStudy);
      }
      response = qie.getResponseToDICOMRequest(token);
   }
   qie.debug("CFIND studyUIDs from " + destinationAET + ": " + JSON.stringify(matchingStudiesList));
   msgResponse =
   `HTTP Status: 200 OK
      
   Content-Type="application/json"
   {"matchingStudiesFound":${JSON.stringify(matchingStudiesList)}}`;
} catch (err) {
   qie.warn(err);
   msgResponse = `HTTP Status: 500
   
   Content-Type="application/json"
   {"error":"${err}"}
   `;
}

qie.postMessageResponse(msgResponse);

This is the error I get:

[line: 18] WrappedException: Wrapped 
com.qvera.qie.web.exception.MappingFailureException: 
Channel 'C-FIND via JSON' is not running.
Stack Trace:
at script [line: 18]

How do I update the qieLauncher package?

Thu, 18 Sep 2025 16:41:52 +0000

I have received an alert that qieLauncher needs to be updated before I can run QIE using Java 24 or later. How do I update it?

Where can I find information about the different FHIR structures?

Fri, 05 Sep 2025 20:09:23 +0000

I would like to find information on the different FHIR structures, like R4 or R5. Where do I find that information?

Can I validate a FHIR resource when it is read into QIE

Fri, 05 Sep 2025 20:03:33 +0000

I am receiving FHIR resources and want to validate the resource before processing it, how would I validate it?

Where can I find information about converting FHIR from JSON to XML?

Fri, 05 Sep 2025 19:04:32 +0000

I have a FHIR resource that is in JSON format and I would like to convert it to XML. How do I complete this conversion?

Where do I find information about a DICOM instance UID?

Fri, 05 Sep 2025 18:59:13 +0000

We need to create a new Dicom instance UID. Where is that specification found?

Does QIE have an official docker image?

Fri, 05 Sep 2025 18:53:56 +0000

We would like to run QIE in a docker environment. Is there an official image that we can use?

How do I configure my MSSQL Server to use ssl-encryption?

Fri, 05 Sep 2025 18:48:45 +0000

We would like to secure the connection between QIE and our MSSQL server using ssl. The QIE service has the encrypt=true connection URL parameter, but my server is not accepting it.

Where can I find information about the Apache Camel Options available in QIE

Tue, 02 Sep 2025 22:39:23 +0000

I would like to know what options are available when adding custom Apache Camel FTP parameters to the configured endpoint.

What is the NDJSON Specification

Fri, 29 Aug 2025 18:45:17 +0000

I am receiving an NDJSON file and need to be able to parse it. What is the specification?

Does QVERA integration platform support NCPDP 2017071 standard?

Mon, 25 Aug 2025 12:39:39 +0000

Cannot call property escapeCsv in object [JavaPackage org.apache.commons.lang.StringEscapeUtils].

Mon, 18 Aug 2025 19:34:57 +0000

After upgrading QIE to the latest release, I have a script that stopped working. Now it throws an exception:

TypeError: Cannot call property escapeCsv in object [JavaPackage org.apache.commons.lang.StringEscapeUtils]. It is not a function, it is "object".

What caused this and how do I fix it?

What version of the mssql-jdbc_auth-{version} file do I need.

Thu, 14 Aug 2025 15:54:32 +0000

QIE Build 25.2.1.16482 requires MariaDB 10.4 or greater, or MySQL 8.0 or greater.

Wed, 13 Aug 2025 15:39:16 +0000

QIE Build 25.2.1.16482 requires MariaDB 10.4 or greater, or MySQL 8.0 or greater.

Security Cert expiry notifications

Tue, 12 Aug 2025 14:58:30 +0000

How to configure Qvera QIE to alert (30/60/90 days) for the following certificate expiry scenarios?

1. Global certificates configured in Qvera used by the channels for webhook?

2. Security certificate used for enabling ssl in Qvera which is passed as a jvm parameter in the QIE Service Manager -Djetty.sslContext.keyStorePath- Ex: https://qvera.abc.com?

Forcing DICOM Association Release

Fri, 04 Jul 2025 10:39:46 +0000

I am looking for a way to force the release of the ongoing DICOM Association.

I have a channel that sends Study-level DICOMC-FIND requests to a DICOM Q/R SCP and another sending Series-level requests to that same SCP.

I'd like to force the release of the association right after each C-FIND operation is completed.

Json to HL7 mapping with array

Mon, 30 Jun 2025 13:02:46 +0000

How to read, iterate as an array the Json below and attach the AIG segments in a HL7 SIU message?

"AIG": [

    {

      "setId": "111",

      "resourceId": "111222",

      "resourceName": {

        "id": "111222333",

        "lastName": "TLN-1",

        "firstName": "TFN-1"

      }

    },

    {

      "setId": "222",

      "resourceId": "222333",

      "resourceName": {

        "id": "222333444",

        "lastName": "TLN-2",

        "firstName": "TFN-2"

      }

    }

  ]

Can a NTE immediately follow a ORC in HL7? If not, how do I remove it?

Mon, 16 Jun 2025 14:14:25 +0000

I have a vendor that is rejecting messages that have a NTE immediately following an ORC. They say that a NTE can't be associated with an ORC. According to my Google-Fu, it is OK to have a NTE follow an ORC.
Example:

ORC|RE|OID_ID00017279220250616082456|2506160233|OID_06BQGX47BXNAX61WN5G2||||||^ Kramer^Kayla||SC^CANANNA^SREEN|^^^CRSC West&LH_BJ596521083_9|(906) 366-1999^^^^^906^3661999|20250616095223|||||

NTE|1||Special Chemistry testing done at The CRSC Central Lab 790 Kovor Ave. SE, Grand Marais, MI 49762 p.906-366-4499, f.906-366-9662

How do I remove only the said NTE from the message without removing the other NTEs?

Global way to handle Error Management Alert Handler Script

Wed, 28 May 2025 21:00:33 +0000

How can we modify all error emails from all channels?

Can Qvera connect using Microsoft SQL using Manged Idenity (Passwordless login)

Thu, 15 May 2025 20:30:03 +0000

Getting an error when using a String variable for the public key qie.pgpEncryptBytesNoSig

Thu, 08 May 2025 20:32:52 +0000

com.qvera.qie.web.exception.MappingFailureException: WrappedException: Wrapped java.lang.Exception: Parameter 'publicKeyIn' must be a 'String', 'File', or 'byte[]'.

var outputFilename = "\\iis-int-dev\generatedfiles\PGP\encryption\completed\out.txt";

var bytes = source.getBytes();

var PGPTrilliumPublic = qie.getVariable('PGPTrilliumPublic');

qie.info(PGPTrilliumPublic);

var outBytes = qie.pgpEncryptBytesNoSig(bytes, PGPTrilliumPublic);

qie.writeFile(outputFilename, outBytes);

Find all instances of a node reference in a channel

Sat, 19 Apr 2025 01:26:42 +0000

Looking to find all instances of a node such as PV1-7.1 within a channel.

This would show if it is used in a Condition or a Mapping.

Content-Length header is missing on HTTP GET requests

Tue, 25 Mar 2025 17:03:18 +0000

When using HTTP GET with a Web Service endpoint, the Content-Length header may be missing from the request. Why would that be, and how can I force it to be present?

Converting many Source Messages into One Destination Output

Fri, 14 Mar 2025 13:08:48 +0000

I have a requirement to output 1 JSON Message as an Array of data which has been recieved over many SOAP API calls.

Is there a way to loop over incoming messages and process into 1 destination once all incoming messages are processed?

How can I connect to MySQL using SSL certificates

Fri, 07 Mar 2025 22:31:47 +0000