กําหนดค่าเอาต์พุต HL7V2

การส่งผลไปยัง EMR หรือระบบภายนอกอื่น ๆ จำเป็นต้องมีใบอนุญาต EMR ที่ถูกต้อง หากต้องการความช่วยเหลือในการกำหนดค่าเอาต์พุต HL7v2 โปรดติดต่อ การสนับสนุนทางเทคนิค.

เปิดการตั้งค่า

หากต้องการกำหนดค่าเอาต์พุต HL7v2 ให้เปิดแอปพลิเคชัน AGNES Connect แล้วกดไอคอนการตั้งค่า ที่ด้านซ้ายล่าง

เลือกส่วนอุปกรณ์

ค้นหาและเลือกรายการที่มีป้ายกำกับ อุปกรณ์

เลือก HL7v2

ค้นหาและเลือกรายการที่ชื่อ HL7v2

แก้ไขการกำหนดค่า

คลิกที่การกำหนดค่าเพื่อแก้ไข

สมัครหรือยกเลิก

คลิก นำไปใช้ เพื่อบันทึกการเปลี่ยนแปลง

กด ESC เพื่อยกเลิกโดยไม่บันทึก

การตั้งค่า HL7

การตั้งค่าคำอธิบาย
enabledตั้งค่าเป็น “จริง” เพื่อเปิดใช้งานเอาต์พุต HL7 ตั้งค่าเป็น “จริง” เพื่อเปิดใช้งานเอาต์พุต HL7 ตั้งค่าเป็น “false” เพื่อปิดใช้งานเอาต์พุต HL7 ตั้งค่าเป็น “จริง” เพื่อเปิดใช้งานเอาต์พุต HL7 ตั้งค่าเป็น “false” เพื่อปิดใช้งานเอาต์พุต HL7
allowQueryตั้งค่าเป็น “จริง” เพื่อเปิดใช้การสอบถามของผู้ป่วย
allowVitalsตั้งค่าเป็น “จริง” เพื่ออนุญาตการส่งสแนปชอต Vitals ตั้งค่าเป็น “จริง” เพื่ออนุญาตการส่งสแนปชอต Vitals ตั้งค่าเป็น “จริง” เพื่ออนุญาตการส่งสแนปชอต Vitals ตั้งค่าเป็น “เท็จ” เพื่อบล็อกการส่งสแนปชอต Vitals
allowDocumentsตั้งค่าเป็น “จริง” เพื่ออนุญาตการส่งเอกสาร เช่น รายงาน PDF และสแนปชอตวิดีโอ
allowedExternalExtensionsรายการนามสกุลไฟล์ที่สามารถส่งออกได้
destinationปลายทางของข้อความสำคัญ HL7 ยอมรับ mllp://, mllps://, http://, https:// หรือ file:// URI
fileDestinationปลายทางของข้อความไฟล์ HL7 ยอมรับ mllp://, mllps://, http://, https:// หรือ file:// URI
queryDestinationปลายทางของการสอบถามข้อมูลผู้ป่วย HL7 ยอมรับ mllp://, mllps://, http:// หรือ https:// URI เปิดใช้งานแท็บการค้นหาผู้ป่วยใน AGNES เมื่อกำหนด
receivingApplicationเติมข้อมูลในช่อง “แอปพลิเคชันการรับ” ของข้อความ HL7 ขาออกทั้งหมด
receivingFacilityเติมข้อมูลในช่อง “สิ่งอำนวยความสะดวกการรับ” ของข้อความ HL7 ขาออกทั้งหมด
rawFileUploadตั้งค่าเป็น “จริง” เพื่ออัปโหลดไฟล์ที่ไม่มี Wrapper HL7
requiredPatientFieldsรายการช่องที่ AGNES ควรต้องมีก่อนส่งข้อความ HL7 เช่น PatientId, firstName, lastName, middleInitial, birthDate และ/หรือ sex
รtimestampFormatรูปแบบสำหรับการประทับเวลา รูปแบบสำหรับการประทับเวลา รูปแบบสำหรับการประทับเวลา ค่าเริ่มต้นเป็นมาตรฐาน HL7v2
hl7_vitals_msgกำหนดค่าส่วนข้อความสำคัญแต่ละรายการ สามารถแทนที่ค่าในส่วน “MSH”, “PID”, “OBR” และ “OBX” ได้
hl7_document_msgกำหนดค่าส่วนข้อความเอกสารแต่ละรายการ สามารถแทนที่ค่าในส่วน “MSH”, “PID”, “OBR” และ “OBX” ได้
queryPatientMessageกำหนดค่าเซ็กเมนต์ของการสืบค้น HL7 ขาออก กำหนดค่าเซ็กเมนต์ของการสืบค้น HL7 ขาออก สามารถแทนที่ค่าในส่วน “MSH” และ “QPD” ได้

แบบสอบถามผู้ป่วย

ผู้ใช้สามารถสอบถามรายชื่อผู้ป่วยจาก EMR บน HL7 ได้ หากระบบ EMR รองรับ ผู้ใช้สามารถระบุสตริงการค้นหาบางส่วนเพื่อจำกัดผลลัพธ์ให้แคบลง

ปลายทางการสืบค้น HL7

หากต้องการเปิดใช้งานแท็บการค้นหาผู้ป่วย ให้กำหนดที่อยู่ของเซิร์ฟเวอร์ที่จะเชื่อมต่อในการกำหนดค่า HL7 เป็น แบบสอบถามปลายทาง เมื่อกำหนด queryEndpoint แล้ว แท็บการค้นหาผู้ป่วยใน AGNES จะเปิดใช้งาน จะต้องกำหนดส่วน QPD ในการกำหนดค่า HL7 ตามการตั้งค่าใน EMR ที่เชื่อมต่อ

อนุญาตให้สอบถามผู้ป่วย

ฟังก์ชันการค้นหาใน AGNES จะเปิดใช้งานเมื่อมีการกำหนด queryEndpoint สิ่งนี้สามารถปิดใช้งานได้โดยการตั้งค่า allowQuery เป็นเท็จ


        allowQuery: false
      
Copy to clipboard

การปรับแต่งเซ็กเมนต์ HL7

AGNES สร้างสัญญาณ HL7v2 ที่ถูกต้องและครอบคลุมตามค่าเริ่มต้น แต่ผู้ใช้บางรายอาจ ต้องการข้อมูลเพิ่มเติมหรือการเปลี่ยนแปลงผลลัพธ์ ค่าของแต่ละเซ็กเมนต์และแต่ละฟิลด์ในนั้นสามารถแทนที่ได้โดยใช้การตั้งค่า hl7_vitals_msg (สำหรับการสังเกตสัญญาณชีพแบบแยกส่วน), hl7_documents_msg (สำหรับเอกสาร) และ queryPatientMessage (สำหรับการสอบถามการสำรวจสำมะโนประชากร)

หากต้องการปรับแต่งกลุ่ม ให้เพิ่มรหัสกลุ่มเป็นคีย์ใต้การตั้งค่าที่เกี่ยวข้องของข้อความ จากนั้น คุณสามารถปรับแต่งแต่ละฟิลด์ได้โดยใช้ตัวเลขที่นำหน้าด้วยเครื่องหมายขีดล่าง ตัวอย่างเช่น _1 จะแทนที่ช่องแรกของกลุ่ม ฟิลด์ที่ซ้อนกันยังได้รับการแก้ไขตามรูปแบบเดียวกัน ฟิลด์จะถูกเขียนทับหากระบุไว้เท่านั้น

ตามตัวอย่าง การตั้งค่าต่อไปนี้จะใช้ประโยชน์จากนามสกุลของผู้ป่วยเท่านั้นเมื่อบันทึกการสังเกต:

หมายเหตุ: YAML คำนึงถึงพื้นที่
Copy to clipboard

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

ในบางกรณี ฟิลด์ในส่วน HL7 อาจมีประเภทตัวแปร เช่น ในช่องที่สามของส่วน QPD (“พารามิเตอร์ผู้ใช้”) ในกรณีเหล่านี้ AGNES อนุญาตให้กำหนดโครงสร้างของข้อความโดยใช้ _def คีย์เพื่อกำหนดโครงสร้างที่กำหนดเองเพื่อให้ข้อความอาจเหมาะสมกับความต้องการของแอปพลิเคชันที่รับ ตัวอย่างเช่น ส่งพารามิเตอร์การค้นหาคำค้นหาโดยการกำหนดฟิลด์ “พารามิเตอร์ผู้ใช้” ของกลุ่ม QPD:

หมายเหตุ: YAML คำนึงถึงพื้นที่
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
        

คีย์ _def ต้องมีคุณสมบัติดังต่อไปนี้:

คุณสมบัติคำอธิบาย
dtชนิดข้อมูล HL7v2 ชนิดข้อมูล HL7v2 ชนิดข้อมูล HL7v2 โปรดดูมาตรฐาน HL7 สำหรับค่าที่ถูกต้อง
dtคำอธิบายฟิลด์ ไม่ถ่ายทอด. ไม่ถ่ายทอด.
optทางเลือก ทางเลือก ทางเลือก R สำหรับจำเป็น , O สำหรับทางเลือก
repการทำซ้ำ การทำซ้ำ การทำซ้ำ 0 หรือ false หากไม่มีการซ้ำกัน

ตัวแปรเทมเพลตที่มีอยู่

เมื่อแทนที่เซ็กเมนต์ HL7 หรือคำนวณตำแหน่งข้อมูลสำหรับคำขอ ตัวแปรเทมเพลตต่อไปนี้จะพร้อมใช้งาน

ตัวแปรผลตอบแทน
{{document.source}}AGNES โมดูลที่เพิ่มเอกสาร
{{document.data}}ข้อมูลจากเอกสาร
{{document.timestamp}}การประทับเวลาของเอกสารพร้อมการจัดรูปแบบ
{{document.key}}คีย์เฉพาะที่กำหนดให้กับเอกสาร
{{document.ext}}ส่วนขยายของเอกสาร
{{document.filename}}ชื่อไฟล์เอกสาร
{{document.isValid}}บูล
{{document.mime}}ไฟล์ประเภท MIME
{{document.thumbnail}}เส้นทางของไฟล์รูปขนาดย่อที่ใช้
{{document.editable}}บูล
{{patient.sex.value}}เพศของผู้ป่วย
{{patient.patientId.value}}ID ผู้ป่วย (มองไม่เห็นจากพอร์ทัล)
{{patient.middleInitial.value}}ชื่อย่อกลางของผู้ป่วย
{{patient.extra.value}}ฟิลด์เสริมผู้ป่วย (ไม่สามารถมองเห็นได้จากพอร์ทัล) ใช้เพื่อส่งผ่านค่าตามอำเภอใจ
{{patient.birthDate.value}}วันเกิดของผู้ป่วย
{{patient.patientExternalId.value}}ID ภายนอกของผู้ป่วย (ผู้ใช้มองเห็นได้)
{{patient.firstName.value}}ชื่อผู้ป่วย
{{patient.lastName.value}}นามสกุลผู้ป่วย
{{user.firstName}}ชื่อผู้ส่ง
{{user.lastName}}นามสกุลของผู้ส่ง
{{user.username}}ชื่อผู้ใช้ของผู้ส่ง
{{user.org}}รหัสองค์กรของผู้ส่ง
{{user.sub}}ID ผู้ใช้ของผู้ส่ง
{{user.npi}}รหัส EMR ของผู้ส่ง
{{user.fullName}}ชื่อเต็มของผู้ส่ง
{{timestamp}}การประทับเวลาของการดำเนินการบันทึกในรูปแบบ HL7v2
{{docTimestamp}}การประทับเวลาการสร้างเอกสารในรูปแบบ HL7v2

การกำหนดค่าตัวอย่าง

การกำหนดค่าพื้นฐาน

หมายเหตุ: YAML คำนึงถึงพื้นที่
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:
        

ตัวอย่างที่มีตัวแปร

หมายเหตุ: YAML คำนึงถึงพื้นที่
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}}'
        

ตัวอย่างแบบสอบถามผู้ป่วย

หมายเหตุ: YAML คำนึงถึงพื้นที่
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: