HL7 Connector

Installation and configuration

Copyright ©

Mindbreeze GmbH, A-4020 Linz, 2017.

All rights reserved. All hardware and software names are brand names and/or trademarks of their respective manufacturers.

These documents are strictly confidential. The submission and presentation of these documents does not confer any rights to our software, our services and service outcomes or other protected rights.

The dissemination, publication or reproduction hereof is prohibited.

For ease of readability, gender differentiation has been waived. Corresponding terms and definitions apply within the meaning and intent of the equal treatment principle for both sexes.

.

InstallationPermanent link for this heading

Before the HL7 connector is installed, it must be ascertained that the Mindbreeze server is already installed and that this connector is also included in the Mindbreeze license.

Installing the connector pluginPermanent link for this heading

The HL7 connector is available as a ZIP file. This file must be registered as follows in the Mindbreeze server via the management UI or mesextension.exe REST Client:

mesextension --interface=plugin --type=archive --file=hl7v2-datasource-<version>.zip install

PLEASE NOTE: The connector can also be updated by a reinstallation.

Uninstalling the connector pluginPermanent link for this heading

To uninstall the HL7 connector, first delete all instances in the configuration, and then remove the plugin via the management UI, or run the following command:

mesextension --interface=plugin --type=archive --file=hl7v2-datasource-<version>.zip uninstall

Configuration of MindbreezePermanent link for this heading

Click on the "Indices" tab and then click on the "Add new index" to create a new index (optional).

If necessary, adjust the display name ("Display Name") the index service and the associated filter service.

Add a new data source with the symbol "Add new custom source" (found at the bottom right).

Enter the directory, where the HL7 documents are located, in the field "Root Directories".

Select the option "Clean up unprocessed items" if the documents that have been deleted since the last crawl run of "Root Directories" should also be deleted from the index.

For the calculation of ACLs in the "Distinguished Name" format, a user's credentials with the authorization to the LDAP server are required. These are the "User Name", "Password", "Domain" and "LDAP Server".

For performance optimization, the number of threads that crawl parallel to the "Root Directories", can be specified in the field "Concurrent Filter and Index Dispatch Threads".

Configuration of filter(s) (diagnosis and performance)Permanent link for this heading

Please add the following "Synthesized Metadata" in the index configuration.

The Metadata "DG1_diagnosis" and "PR1_procedure" should be available in the categorydescriptor.xml, and the attribute "aggregatable" should be "true".

<metadatum aggregatable="true" id="DG1_diagnosis" selectable="false" visible="true">

  <name xml:lang="de">Diagnose</name>

</metadatum>

<metadatum aggregatable="true" id="PR1_procedure" selectable="false" visible="false">

  <name xml:lang="de">Leistung</name>

</metadatum>

Define the "visit_DG1_diagnosis" and "visit_PR1_procedure" in the categorydescriptor.xml.

<metadatum aggregatable="true" id="visit_DG1_diagnosis" selectable="false" visible="true">

  <name xml:lang="de">Diagnose</name>

</metadatum>

<!--is synthesized metadata, it needs visit/PR1_procedure property expression in index configuration-->

<metadatum aggregatable="true" id="visit_PR1_procedure" selectable="false" visible="true">

  <name xml:lang="de">Leistung</name>

</metadatum>