Configuration de Sortie HL7v2

Envoyer des résultats à un DME ou à un autre système externe nécessite une licence de DME valide. Pour obtenir de l'aide sur la configuration de la sortie HL7v2, veuillez contacter Support Technique.

Ouvrir les paramètres

Pour configurer la sortie HL7v2, ouvrez l’application AGNES Connect et appuyez sur l’icône Paramètres en bas à gauche.

Sélectionner la section “Appareils”

Recherchez et sélectionnez l’entrée intitulée Périphériques.

Sélectionnez HL7v2

Recherchez et sélectionnez l’entrée intitulée HL7v2.

Modifier la configuration

Cliquez sur la configuration à modifier.

Appliquer ou annuler

Cliquez sur Appliquer pour enregistrer les modifications.

Appuyez sur ESC pour annuler sans enregistrer.

Paramètres HL7

Réglages	Description
`enabled`	Définissez à `true` pour activer la sortie HL7. Définir à `false` pour désactiver la sortie HL7.
`allowQuery`	Définir à `true` pour activer les requêtes du patient.
`allowVitals`	Définir à `true` pour permettre d’envoyer des instantanés vitaux. Définir à `false` pour bloquer l’envoi d’instantanés vitaux.
`allowDocuments`	Définir à `true` pour permettre l’envoi de documents, tels que des rapports PDF et des instantanés vidéo.
`allowedExternalExtensions`	Liste des extensions de fichier à autoriser pour l’exportation.
`destination`	Destination des messages vitaux HL7. Accepte une URI `mllp://`, `mllps://`, `http://`, `https://`, ou `file://`.
`fileDestination`	Destination des messages du fichier HL7. Accepte une URI `mllp://`, `mllps://`, `http://`, `https://`, ou `file://`.
`queryDestination`	Destination des requêtes d’information du patient HL7. Accepte une URI `mllp://`, `mllps://`, `http://`, ou `https://`. Active l’onglet Recherche de Patients dans AGNES une fois défini.
`receivingApplication`	Remplit le champ “Réception de l’application” de tous les messages HL7 sortants.
`receivingFacility`	Remplit le champ “Réception” de tous les messages HL7 sortants.
`rawFileUpload`	Définissez à `true` pour télécharger des fichiers sans enveloppe HL7.
`requiredPatientFields`	Liste des champs dont AGNES devrait avoir besoin avant d’envoyer des messages HL7, tels que `patientId`, `firstName`, `lastName`, `middleInitial`, `birthDate`, et/ou `sex`.
`timestampFormat`	Format pour l’horodatage. Par défaut, la norme HL7v2 est utilisée.
`hl7_vitals_msg`	Configurer les segments de messages vitaux individuels. Peut remplacer les valeurs dans les segments `MSH`, `PID`, `OBR`, et `OBX`.
`hl7_document_msg`	Configurez des segments de messages individuels. Peut remplacer les valeurs dans les segments `MSH`, `PID`, `OBR`, et `OBX`.
`queryPatientMessage`	Configurez les segments des requêtes HL7 sortantes. Peut remplacer les valeurs dans les segments `MSH` et `QPD`.

Requête des patients

Les utilisateurs peuvent interroger une liste de patients à partir d’un DME via HL7 si le système DME le prend en charge. L’utilisateur peut fournir une chaîne de recherche partielle pour affiner les résultats.

Point de terminaison de requête HL7

Une fois queryEndpoint défini, l’onglet Recherche de patient dans AGNES sera activé. Pour activer l’onglet Recherche de Patients, définissez l’adresse du serveur auquel se connecter dans la configuration HL7 comme queryEndpoint. Une section QPD devra être définie dans la configuration HL7 en fonction des paramètres du DME connecté.

Autoriser la requête du patient

La fonctionnalité de recherche dans AGNES est activée une fois que queryEndpoint est défini. Cela peut être désactivé en définissant allowQuery sur false.


        allowQuery: false

Copy to clipboard

Personnalisation des segments HL7

AGNES produit des signaux HL7v2 valides et complets par défaut, mais certains utilisateurs peuvent vouloir des données supplémentaires ou des modifications à la sortie. Les valeurs de chaque segment et de chaque champ peuvent être remplacées en utilisant les paramètres hl7_vitals_msg (pour les observations vitales discrètes), hl7_documents_msg (pour les documents), et queryPatientMessage (pour les requêtes de recensement).

Pour personnaliser un segment, ajoutez le code de segment en tant que clé sous le paramètre associé du message. À partir de là, les champs individuels peuvent être personnalisés en utilisant leur nombre préfixé par un tiret bas. Par exemple, _1 remplacera le premier champ du segment. Les champs imbriqués sont également modifiés suivant le même schéma. Les champs ne seront remplacés que s’ils sont spécifiés.

Par exemple, les paramètres suivants ne capitaliseront que sur le nom de famille du patient lors de l’enregistrement des observations:

Copy to clipboard


          hl7_vitals_msg:
  PID:
    _5:
      _0:
        _1: {{ patient.lastName.value.toUpperCase() }}

Dans certains cas, un champ dans un segment HL7 peut avoir un type de variable, comme dans le troisième champ du segment QPD (“Paramètres utilisateur”). Dans ces cas, AGNES permet de définir la structure du message en utilisant les clés _def pour définir des structures personnalisées, afin que le message puisse convenir aux besoins de l’application réceptrice. Par exemple, passez les paramètres de recherche de requête en définissant le champ “Paramètres utilisateur” du segment QPD:

Copy to clipboard


          queryPatientMessage:
  QPD:
    _3:
      _0:
        _1:
          _def:
            dt: ST
            opt: R
            rep: 0
          _0: Status
        _2:
          _def:
            dt: ST
            opt: R
            rep: true
          _0: Active

Les clés _def doivent contenir les propriétés suivantes:

Propriété	Description
`dt`	Type de données HL7v2. Reportez-vous au standard HL7 pour des valeurs valides.
`desc`	Description du champ. Non transmis.
`opt`	Optionnalité. `R` pour obligatoire, `O` pour optionnel.
`Représentant`	Répétitivité. `0` ou `false` pour aucune répétition.

Variables de modèle disponibles

Lorsque vous surchargez les segments HL7 ou que vous calculez le point de terminaison de la requête, les variables de modèle suivantes sont disponibles.

Variable	Retour
`{{document.source}}`	Module AGNES qui a ajouté le document
`{{document.data}}`	Données du document
`{{document.timestamp}}`	Horodatage du document avec mise en forme
`{{document.key}}`	Clé unique attribuée au document
`{{document.ext}}`	Extension de document
`{{document.filename}}`	Nom de fichier du document
`{{document.isValid}}`	Booléen
`{{document.mime}}`	Type de fichier MIME
`{{document.thumbnail}}`	Chemin du fichier de vignettes utilisé
`{{document.editable}}`	Booléen
`{{patient.sex.value}}`	Sexe du patient
`{{patient.patientId.value}}`	ID du patient (non visible depuis le portail)
`{{patient.middleInitial.value}}`	Initiale intermédiaire du patient
`{{patient.extra.value}}`	Champ supplémentaire du patient (non visible depuis le portail) utilisé pour transmettre des valeurs arbitraires
`{{patient.birthDate.value}}`	Date de naissance du patient
`{{patient.patientExternalId.value}}`	ID externe du patient (visible par l’utilisateur)
`{{patient.firstName.value}}`	Prénom du patient
`{{patient.lastName.value}}`	Nom du patient
`{{user.firstName}}`	Prénom de l’expéditeur
`{{user.lastName}}`	Nom de famille de l’expéditeur
`{{user.username}}`	Nom d’utilisateur de l’expéditeur
`{{user.org}}`	ID d’organisation de l’émetteur
`{{user.sub}}`	ID utilisateur de l’émetteur
`{{user.npi}}`	ID DME de l’émetteur
`{{user.fullName}}`	Nom complet du demandeur
`{{timestamp}}`	Horodatage de l’opération de sauvegarde au format HL7v2
`{{docTimestamp}}`	Horodatage de la création du document au format HL7v2

Exemple de configurations

Configuration de base

Copy to clipboard


          enabled: true

keepOpen: true
destination: file:///hl7/message-{{document.timestamp}}.hl7
fileDestination: file:///hl7/message-{{document.timestamp}}.hl7

allowExternalDocuments: true
allowVideoSnapshots: true
allowPDFReport: true

# This option will disable the HL7 wrapper for file destinations
#rawFileUpload: true

allowVitals: true
combinedVitalsField: 'OBX'

# If you require certain patient fields to be present, specify them here
#requiredPatientFields:
#        - 'patientId'

allowedExternalExtensions:
    - jpg
    - txt
    - pdf
    - tif

timestampFormat: YYYYMMDDHHmmss

hl7_vitals_msg:
    MSH:
    PID:
    OBR:
    OBX:

hl7_document_msg:
    MSH:
    PID:
    OBR:
    OBX:

Exemple avec des variables

Copy to clipboard


          enabled: true

keepOpen: true
destination: file:///hl7/vitals-{{docTimestamp}}.hl7
fileDestination: file:///hl7/file-{{docTimestamp}}.hl7

allowExternalDocuments: true
allowVideoSnapshots: true
allowPDFReport: true

# This option will disable the HL7 wrapper for file destinations
#rawFileUpload: true

allowVitals: true
combinedVitalsField: 'OBX'

# If you require certain patient fields to be present, specify them here
#requiredPatientFields:
#        - 'patientId'

allowedExternalExtensions:
    - jpg
    - txt
    - pdf
    - tif

timestampFormat: YYYYMMDDHHmmss

hl7_vitals_msg:
    MSH:
        '_3': '3)Doc_Timestamp={{document.timestamp}}'
        '_4': '4)Timestamp={{timestamp}}'
        '_5': '5)Patient_Birthdate={{patient.birthDate.value}}'
    PID:
        '_1': '1)Patient_ID={{patient.patientId.value}}'
        '_8': '8)Patient_First_Name={{patient.firstName.value}}'
        '_9': '9)Patient_Middle_Initial={{patient.middleInitial.value}}'
        '_10': '10)Patient_Last_Name={{patient.lastName.value}}'
    OBR:
        '_2': '2)Document_Timestamp={{document.timestamp}}'
        '_3': '3)Document_Filename={{document.filename}}'
        '_4': '4)Patient_Sex={{patient.sex.value}}'
    OBX:
        '_1': '1)User_Full_Name={{user.fullname}}'
        '_4': '4)User_Username={{user.username}}'
        '_7': '7)User_First_Name={{user.firstname}}'
        '_8': '8)User_Last_Name={{user.lastname}}'
        '_10': '10)User_Org={{user.org}}'
        '_11': '11)User_Sub={{user.sub}}'
        '_13': '13)User_Meta={{user.meta}}'
        '_15': '15)User_NPI={{user.npi}}'

hl7_document_msg:
    MSH:
        '_3': '3)Doc_Timestamp={{document.timestamp}}'
        '_4': '4)Timestamp={{timestamp}}'
        '_5': '5)Patient_Birthdate={{patient.birthDate.value}}'
        '_6': '6)User_NPI={{user.npi}}'
    PID:
        '_1': '1)Patient_ID={{patient.patientId.value}}'
        '_8': '8)Patient_First_Name={{patient.firstName.value}}'
        '_9': '9)Patient_Middle_Initial={{patient.middleInitial.value}}'
        '_10': '10)Patient_Last_Name={{patient.lastName.value}}'
    OBR:
        '_2': '2)Document_Timestamp={{document.timestamp}}'
        '_3': '3)Document_Filename={{document.filename}}'
        '_4': '4)Patient_Sex={{patient.sex.value}}'
        '_14': '14)User_First_Name={{user.firstname}}'
        '_15': '15)User_Last_Name={{user.lastname}}'
        '_10': '10)User_Org={{user.org}}'
        '_11': '11)User_Sub={{user.sub}}'
        '_13': '13)User_Meta={{user.meta}}'
    OBX:
        '_1': '1)User_Full_Name={{user.fullname}}'
        '_4': '4)User_Username={{user.username}}'

Exemple de requête de patient

Copy to clipboard


          enabled: true

keepOpen: true
destination: mllps://192.168.1.238:6007
fileDestination: mllps://192.168.1.238:6007
queryEndpoint: mllps://192.168.1.238:6007

allowExternalDocuments: true
allowVideoSnapshots: true
allowPDFReport: true

# This option will disable the HL7 wrapper for file destinations
#rawFileUpload: true

allowVitals: true
combinedVitalsField: 'OBX'

# If you require certain patient fields to be present, specify them here
#requiredPatientFields:
#        - 'patientId'

allowedExternalExtensions:
    - jpg
    - txt
    - pdf
    - tif

timestampFormat: YYYYMMDDHHmmss

queryPatientMessage:
    MSH:
        '_2': 'TeleHealth'
        '_5': 'ApplicationName'
        '_6': 'Facility'
    QPD:
        '_3':
            '_0':
                '_1':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Family Name Segment'
                        'opt': 'R'
                        'rep': 0
                    '_0': 'PID-5-0'
                '_2':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Family Name'
                        'opt': 'O'
                        'rep': 0
                    '_0': '{{patient.lastName}}*'
            '_1':
                '_1':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Given Name Segment'
                        'opt': 'R'
                        'rep': 0
                    '_0': 'PID-5-1'
                '_2':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Given Name'
                        'opt': 'O'
                        'rep': 0
                    '_0': '{{patient.firstName}}*'
            '_2':
                '_1':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Segment'
                        'opt': 'R'
                        'rep': 0
                    '_0': 'PID-2-1'
                '_2':
                    '_def':
                        'dt': 'ST'
                        'desc': 'Patient ID'
                        'opt': 'O'
                        'rep': 0
                    '_0': '{{patient.patientExternalId}}*'

hl7_vitals_msg:
    MSH:
        'ReceivingApplication': 'ApplicationName'
        'ReceivingFacility': 'Facility'
    PID:
    OBR:
    OBX:

hl7_document_msg:
    MSH:
        'ReceivingApplication': 'ApplicationName'
        'ReceivingFacility': 'Facility'
    PID:
    OBR:
    OBX: