Configurazione dell'Uscita HL7v2

L'invio dei risultati ad un EMR o ad un altro sistema esterno richiede una licenza EMR valida. Per assistenza nella configurazione dell'output HL7v2, contatta การสนับสนุนทางเทคนิค.

Apri impostazioni

Per configurare l’output HL7v2, apri l’applicazione AGNES Connect e premi l’icona Impostazioni in basso a sinistra.

Seleziona sezione Dispositivi

Trova e seleziona la voce denominata Dispositivi.

Seleziona HL7v2

Trova e seleziona la voce denominata HL7v2.

Modifica configurazione

Fare clic sulla configurazione da modificare.

Applica o Annulla

Fai clic su Applica per salvare le modifiche.

Premere ESC per annullare senza salvare.

Impostazioni HL7

Impostazione	Descrizione
`enabled`	Impostare su `true` per abilitare l’output HL7. Impostare su `false` per disabilitare l’output HL7.
`allowQuery`	Impostare su `true` per abilitare le interrogazioni dei pazienti.
`allowVitals`	Impostare su `true` per consentire l’invio di snapshot vitali. Impostare su `false` per bloccare l’invio di istantanee vitali.
`allowDocuments`	Impostare su `true` per consentire l’invio di documenti, come report PDF e snapshot video.
`allowedExternalExtensions`	Elenco delle estensioni di file per consentire l’esportazione.
`destination`	Destinazione dei messaggi vitali HL7. Accetta un `mllp://`, `mllps://`, `http://`, `https://`, o `file://` URI.
`fileDestination`	Destinazione dei messaggi del file HL7. Accetta un `mllp://`, `mllps://`, `http://`, `https://`, o `file://` URI.
`queryDestination`	Destinazione di HL7 informazioni paziente query. Accetta un `mllp://`, `mllps://`, `http://`, o `https://` URI. Abilita la scheda Ricerca Paziente in AGNES quando definito.
`receivingApplication`	Popola il campo “Ricezione Applicazione” di tutti i messaggi HL7 in uscita.
`receivingFacility`	Popola il campo “Facilità di ricezione” di tutti i messaggi HL7 in uscita.
`rawFileUpload`	Impostare su `true` per caricare file senza un wrapper HL7.
`requiredPatientFields`	Elenco dei campi che AGNES dovrebbe richiedere prima di inviare messaggi HL7, come `paziente`, `firstName`, `lastName`, `middleInitial`, `birthDate`, e/o `sesso`.
`timestampFormat`	Formato per timestamp. Predefiniti allo standard HL7v2.
`hl7_vitals_msg`	Configura singoli segmenti di messaggi vitali. Può sovrascrivere i valori nei segmenti `MSH`, `PID`, `OBR`, e `OBX`.
`hl7_document_msg`	Configura i singoli segmenti di messaggi del documento. Può sovrascrivere i valori nei segmenti `MSH`, `PID`, `OBR`, e `OBX`.
`queryPatientMessage`	Configurare i segmenti delle interrogazioni HL7 in uscita. Puoi sovrascrivere i valori nei segmenti `MSH` e `QPD`.

Query del paziente

Gli utenti possono interrogare un elenco di pazienti da un EMR su HL7 se il sistema EMR lo supporta. L’utente può fornire una stringa di ricerca parziale per restringere i risultati.

Endpoint di query HL7

Una volta definito queryEndpoint , la scheda Ricerca paziente in AGNES sarà abilitata. Per abilitare la scheda di ricerca paziente, definire l’indirizzo del server a cui connettersi nella configurazione HL7 come queryEndpoint. Una sezione QPD dovrà essere definita nella configurazione HL7 in base alle impostazioni nell’EMR connesso.

Consenti interrogazione paziente

La funzionalità di ricerca in AGNES viene abilitata una volta definito queryEndpoint. Questo può essere disabilitato impostando allowQuery su false.


        allowQuery: false

Copy to clipboard

Personalizzazione Dei Segmenti Hl7

AGNES produce segnali HL7v2 validi e completi per impostazione predefinita, ma alcuni utenti possono desiderare dati aggiuntivi o modifiche all’output. I valori di ogni segmento e di ogni campo possono essere sovrascritti usando le impostazioni hl7_vitals_msg (per osservazioni vitali discrete), hl7_documents_msg (per documenti) e queryPatientMessage (per le query di censimento).

Per personalizzare un segmento, aggiungere il codice del segmento come chiave sotto l’impostazione associata del messaggio. Da lì, i singoli campi possono essere personalizzati utilizzando il loro numero prefisso da un underscore. Per esempio, _1 sostituirà il primo campo del segmento. Anche i campi annidati sono modificati seguendo lo stesso schema. I campi saranno sovrascritti solo se specificato.

Ad esempio, le seguenti impostazioni capitalizzeranno solo con il cognome del paziente durante il salvataggio delle osservazioni:

Copy to clipboard


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

In alcuni casi, un campo in un segmento HL7 può avere un tipo di variabile, ad esempio nel terzo campo del segmento QPD (“Parametri utente”). In questi casi, AGNES permette di definire la struttura del messaggio usando le chiavi _def per definire le strutture personalizzate, in modo che il messaggio possa soddisfare le esigenze della domanda ricevente. Per esempio, passa i parametri di ricerca della query definendo il campo “Parametri Utente” del segmento 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

Le chiavi _def devono contenere le seguenti proprietà:

Proprietà	Descrizione
`dt`	Tipo di dati HL7v2. Fare riferimento allo standard HL7 per i valori validi.
`desc`	Descrizione del campo. Non trasmesso.
`opt`	Opzionalità. `R` per richiesto, `O` per opzionale.
`rep`	Ripetibilità. `0` o `false` per nessuna ripetizione.

Variabili Di Modello Disponibili

Quando si sovrascrivono i segmenti HL7 o si calcola l’endpoint per la richiesta, sono disponibili le seguenti variabili del modello.

Variabile	Tornare
`{{document.source}}`	Modulo AGNES che ha aggiunto il documento
`{{document.data}}`	Dati dal document
`{{document.timestamp}}`	Timestamp del documento con formattazione
`{{document.key}}`	Chiave univoca assegnata al documento
`{{document.ext}}`	Estensione del documento
`{{document.filename}}`	Nome file del documento
`{{document.isValid}}`	Booleano
`{{document.mime}}`	Tipo di file MIME
`{{document.thumbnail}}`	Percorso del file di miniature utilizzato
`{{document.editable}}`	Booleano
`{{patient.sex.value}}`	Sesso paziente
`{{patient.patientId.value}}`	ID paziente (non visibile dal portale)
`{{patient.middleInitial.value}}`	Iniziale centrale del paziente
`{{patient.extra.value}}`	Campo extra paziente (non visibile dal portale) utilizzato per trasmettere valori arbitrari
`{{patient.birthDate.value}}`	Data di nascita del paziente
`{{patient.patientExternalId.value}}`	ID esterno paziente (visibile all’utente)
`{{patient.firstName.value}}`	Nome del paziente
`{{patient.lastName.value}}`	Cognome del paziente
`{{user.firstName}}`	Nome del mittente
`{{user.lastName}}`	Cognome del mittente
`{{user.username}}`	Nome utente del mittente
`{{user.org}}`	ID organizzazione del mittente
`{{user.sub}}`	ID utente del mittente
`{{user.npi}}`	EMR ID del notificante
`{{user.fullName}}`	Nome completo del mittente
`{{timestamp}}`	Marcatura oraria dell’operazione di salvataggio nella formattazione HL7v2
`{{docTimestamp}}`	Marcatura oraria creazione documento nella formattazione HL7v2

Configurazioni Di Esempio

Configurazione di 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:

Esempio con variabili

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}}'

Esempio di richiesta del paziente

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: