Skip to content
Ivan William Harsono edited this page Nov 19, 2026 · 1 revision

HL7 v2 and MLLP

Bahasa / Language: English · Bahasa Indonesia

This SDK speaks HL7 v2 for analyzers and LIS, and FHIR R4 for SATUSEHAT, from one install. SDK ini berbicara HL7 v2 untuk analyzer dan LIS, serta FHIR R4 untuk SATUSEHAT, dari satu instalasi.

English

What is implemented

  • ER7 parsing and serialisation. CR, LF or CRLF; encoding characters read from MSH-2.
  • Path access. PID.5.1 is field 5, component 1; fieldAll() returns repetitions; escapes are decoded on read and re-encoded on write, so a message round-trips byte for byte.
  • Escapes. \F\ \S\ \R\ \E\ \T\ and \Xdd..\; \Z..\ and \.br\ are left untouched.
  • Charset. MSH-18 is reported, never used to re-encode bytes.
  • MLLP. frame, unframe, split, and MllpReader, which keeps bytes that arrive after a complete frame — one TCP read often returns several ACKs.
  • ACK/NAK. Ack.build() produces AA/AE/AR and echoes MSH-10 in MSA-2.
  • Client. send() retries transport failures only, and rejects an ACK whose MSA-2 does not match MSH-10. session() sends many messages over one connection, one result each, in order.
  • Profiles. Profiles.adtA01(), adtA08(), oruR01() — declarative data, errors block and warnings do not.

Shared corpus

src/hl7v2/__fixtures__ is copied byte-for-byte from the PHP SDK: ten messages a hospital sends and ten that must be refused. Parity is a test, not a claim.

Not implemented

Batches (FHS/BHS), vendor profiles beyond the three built in, HL7 v2 table validation, and a supervised MLLP server daemon.

Bahasa Indonesia

Yang sudah ada

  • Parsing dan serialisasi ER7. CR, LF, atau CRLF; karakter encoding dibaca dari MSH-2.
  • Akses lewat path. PID.5.1 berarti field 5 komponen 1; fieldAll() mengembalikan repetisi; escape didekode saat baca dan dienkode saat tulis, sehingga pesan bolak-balik tanpa perubahan byte.
  • Escape. \F\ \S\ \R\ \E\ \T\ dan \Xdd..\; \Z..\ dan \.br\ dibiarkan apa adanya.
  • Charset. MSH-18 dilaporkan, tidak dipakai untuk mengubah byte.
  • MLLP. frame, unframe, split, dan MllpReader yang menyimpan byte setelah frame lengkap — satu pembacaan TCP sering mengembalikan beberapa ACK sekaligus.
  • ACK/NAK. Ack.build() menghasilkan AA/AE/AR dan memantulkan MSH-10 di MSA-2.
  • Klien. send() hanya mengulang kegagalan transport, dan menolak ACK yang MSA-2-nya tidak cocok dengan MSH-10. session() mengirim banyak pesan lewat satu koneksi, satu hasil per pesan, berurutan.
  • Profil. Profiles.adtA01(), adtA08(), oruR01() — data deklaratif; error memblokir, warning tidak.

Korpus bersama

src/hl7v2/__fixtures__ disalin byte-per-byte dari SDK PHP: sepuluh pesan yang dikirim rumah sakit dan sepuluh yang harus ditolak. Parity adalah tes, bukan klaim.

Yang belum ada

Batch (FHS/BHS), profil vendor di luar tiga bawaan, validasi tabel HL7 v2, dan daemon server MLLP yang diawasi supervisor.

See also / Lihat juga

Clone this wiki locally