merancang interoperabilitas fhir | java php laravel linux mysql sql bootstrap html css query java php laravel linux mysql sql bootstrap html css query: merancang interoperabilitas fhir

Wednesday, November 18, 2026

merancang interoperabilitas fhir

🌉🏥
Artikel 15 dari 16 · Pertukaran Informasi Kesehatan

Merancang Interoperabilitas: Analisis Kebutuhan, Diagram Alur, dan Pemetaan Tabel ke FHIR Resource

Dari tumpukan tabel SIMRS ke JSON yang dimengerti sistem mana pun. Ini peta jalannya, langkah demi langkah.

FHIRInteroperabilitasAnalisis KebutuhanPemetaan DataSATUSEHAT
⏱️
8 menit
Estimasi baca
🎓
D4 MIK · Menengah
Level
📅
2026
Tahun

Bayangkan kamu membawa hasil laboratorium dari Puskesmas ke rumah sakit rujukan, lalu petugas bilang, “Maaf, formatnya beda. Tolong input ulang.” Data yang sama diketik dua kali, dan satu salah ketik bisa mengubah keputusan klinis. Masalah ini yang merancang interoperabilitas FHIR selesaikan: sistem yang berbeda bisa saling bertukar data tanpa saling menerjemahkan manual.

Kamu calon perekam medis dan informatika kesehatan, jadi merancang jembatan itu akan jadi tugasmu. Artikel ini bagian dari seri Pertukaran Informasi Kesehatan. Kita bahas tiga hal: analisis kebutuhan, diagram alur, dan pemetaan tabel ke FHIR Resource.

Merancang Interoperabilitas FHIR Dimulai dari Analisis Kebutuhan

Banyak mahasiswa langsung membuka editor JSON. Itu seperti membangun jembatan sebelum tahu sungai mana yang mau diseberangi. Mulailah dengan bertanya: siapa yang butuh data, data apa, dan untuk keperluan apa.

📐 Konsep Utama: Interoperabilitas
Interoperabilitas adalah kemampuan dua sistem atau lebih untuk bertukar data dan memakai data itu dengan arti yang sama. FHIR (Fast Healthcare Interoperability Resources) mewujudkannya lewat unit data bernama Resource yang diakses dengan REST API (HL7 International, 2019).

Bayangkan FHIR sebagai set balok LEGO standar. Setiap Resource, seperti Patient atau Observation, adalah satu jenis balok. Siapa pun yang punya balok yang sama bisa merakit hasil yang sama. Bender dan Sartipi (2013) menyebut pendekatan berbasis Resource dan REST ini lebih mudah diadopsi pengembang dibanding standar pesan sebelumnya.

Empat Langkah Analisis Kebutuhan

Contoh konkret: Puskesmas ingin merujuk pasien hipertensi ke rumah sakit. Kebutuhan datanya meliputi identitas pasien, tekanan darah terakhir, diagnosis, dan obat yang sedang dikonsumsi. Dari daftar singkat ini saja, kamu sudah tahu Resource yang diperlukan: Patient, Observation, Condition, dan MedicationRequest. Analisis kebutuhan yang baik menghemat berhari-hari pekerjaan ulang.

1
Petakan pihak yang bertukar data
Tulis daftar sistem dan pengguna: SIMRS, laboratorium, apotek, Puskesmas, dan platform SATUSEHAT Kemenkes. Tentukan arah data, apakah mengirim, menerima, atau dua arah.
2
Tentukan kasus penggunaan
Contoh: rujukan pasien, kirim hasil lab, atau lapor kunjungan. Satu kasus penggunaan menentukan Resource apa saja yang kamu perlukan.
3
Inventarisasi elemen data
Buka kamus data SIMRS, lalu catat kolom yang benar-benar dibutuhkan. Tidak semua kolom harus dikirim.
4
Tetapkan aturan mutu dan keamanan
Tulis siapa yang boleh mengakses, format identitas, dan kode standar yang dipakai (ICD-10, LOINC). Aturan ini menjadi acuan saat pengujian.
💡 Tips
Buat tabel kebutuhan satu halaman sebelum menulis kode. Tiga kolom sudah cukup: kasus penggunaan, data yang dikirim, dan penerima. Dosen penguji dan rekan tim akan cepat paham apa yang kamu bangun.
🔥 Fakta Menarik
Di Indonesia, Permenkes No. 24 Tahun 2022 tentang Rekam Medis mewajibkan fasilitas pelayanan kesehatan menyelenggarakan rekam medis elektronik yang terhubung dengan platform layanan data Kemenkes, yaitu SATUSEHAT. Kemampuan merancang interoperabilitas kini menjadi kebutuhan kerja nyata, bukan sekadar teori kuliah (Kemenkes RI, 2022).

Diagram Alur: Peta Perjalanan Data dalam Interoperabilitas FHIR

Diagram alur menjawab satu pertanyaan: data lewat jalur mana, dan siapa yang memeriksanya? Bayangkan kamu mengirim paket lewat kurir. Ada pengirim, kantor sortir, pengecekan alamat, lalu penerima. Alur data kesehatan juga begitu.

🔍 Analisis: Diagram Alur Pengiriman Data
┌────────────┐   1. Ambil data    ┌──────────────┐
│ SIMRS Lokal│ ─────────────────▶ │ Mapper /     │
│ (tabel SQL)│                    │ Transformer  │
└────────────┘                    └──────┬───────┘
                                         │ 2. Ubah ke Resource JSON
                                         ▼
                                  ┌──────────────┐
                                  │ Validasi     │ ── gagal ──▶ Log error
                                  │ (profil FHIR)│
                                  └──────┬───────┘
                                         │ 3. Kirim + token OAuth2
                                         ▼
┌────────────┐  4. Respons 201   ┌──────────────┐
│ Pencatat   │ ◀──────────────── │ FHIR Server  │
│ ID Resource│                   │ (SATUSEHAT)  │
└────────────┘                   └──────────────┘

Ada tiga keputusan desain yang wajib kamu tulis di diagram. Pertama, kapan data dikirim: langsung setelah petugas menyimpan (real-time) atau terjadwal per jam. Kedua, apa yang terjadi saat gagal: coba ulang otomatis atau masuk antrean untuk dicek petugas. Ketiga, siapa yang menyimpan ID balasan dari server, karena ID itu kamu perlukan saat memperbarui data yang sama.

Perhatikan titik validasi di tengah. Banyak tim melewatkannya, lalu baru tahu datanya salah setelah server menolak ratusan kiriman. Pasang validasi sebelum data keluar dari sistemmu.

⚡ Insight Penting
Satu diagram alur = satu kasus penggunaan. Jangan gabungkan rujukan, laboratorium, dan farmasi dalam satu gambar. Tiga diagram sederhana jauh lebih mudah diuji dan diperbaiki daripada satu diagram yang penuh panah.
PendekatanFormat DataCara AksesKecocokan
HL7 v2Pesan teks berpembatas “|”Antarsistem internal (messaging)Integrasi RS yang sudah lama berjalan
HL7 CDADokumen XMLPertukaran dokumen klinisRingkasan pasien, surat rujukan
HL7 FHIRResource JSON/XMLREST API (GET, POST, PUT)Aplikasi web, seluler, dan SATUSEHAT

Pemetaan Tabel ke FHIR Resource: Inti Merancang Interoperabilitas FHIR

Inilah bagian paling praktis. Pemetaan artinya kamu mencocokkan setiap tabel dan kolom SIMRS dengan Resource dan elemen FHIR. Analoginya kamus bahasa: kolom tgl_lahir di sistemmu diterjemahkan menjadi birthDate di FHIR.

Tabel SIMRSFHIR ResourcePemetaan Kolom KunciTerminologi
tb_pasienPatientnik → identifier, nama → name, tgl_lahir → birthDateKode gender FHIR
tb_kunjunganEncountertgl_masuk → period.start, jenis → classKode kelas kunjungan
tb_tanda_vitalObservationnadi → valueQuantity, tgl_ukur → effectiveDateTimeLOINC, UCUM
tb_diagnosisConditionkode_icd → code, kunjungan_id → encounterICD-10
tb_resepMedicationRequestobat → medication, dosis → dosageInstructionKFA / kode obat
tb_alergiAllergyIntolerancealergen → code, reaksi → reactionSNOMED CT

Contoh Pemetaan Tabel Pasien

Dua prinsip memudahkan pemetaan. Pertama, petakan dari sisi makna, bukan dari nama kolom. Kolom status_kawin dan elemen maritalStatus punya makna sama walau namanya berbeda. Kedua, bila satu tabel SIMRS memuat banyak hal, pecah menjadi beberapa Resource. Tabel kunjungan yang menyimpan diagnosis dan tanda vital sekaligus akan menjadi Encounter, Condition, dan Observation yang saling merujuk lewat reference.

mapper_pasien.py
def map_pasien(row):
    gender = {"L": "male", "P": "female"}.get(row["jenis_kelamin"], "unknown")
    return {
        "resourceType": "Patient",
        "identifier": [{
            "use": "official",
            "system": "https://fhir.kemkes.go.id/id/nik",
            "value": row["nik"]
        }],
        "active": True,
        "name": [{"use": "official", "text": row["nama"]}],
        "gender": gender,
        "birthDate": row["tgl_lahir"].isoformat()   # format YYYY-MM-DD
    }

Perhatikan juga bagaimana Resource saling terhubung. Observation tidak menyalin nama pasien. Ia hanya menunjuk Patient/ID_PASIEN. Prinsip ini menjaga data tetap ringkas dan konsisten, sama seperti kamu menaruh nomor rekam medis di setiap lembar, bukan menulis ulang biodata lengkap di setiap halaman.

Hasilnya adalah Resource JSON seperti di bawah ini. Setiap pasien yang kamu kirim punya struktur yang sama persis, siapa pun penerimanya.

patient.json
{
  "resourceType": "Patient",
  "identifier": [{
    "use": "official",
    "system": "https://fhir.kemkes.go.id/id/nik",
    "value": "3171000000000001"
  }],
  "active": true,
  "name": [{ "use": "official", "text": "Siti Rahma" }],
  "gender": "female",
  "birthDate": "1998-04-12"
}

Tanda vital perlu kode LOINC supaya penerima tahu persis apa yang kamu ukur. Contoh di bawah mengirim denyut jantung 88 kali per menit.

observation-nadi.json
{
  "resourceType": "Observation",
  "status": "final",
  "category": [{ "coding": [{
    "system": "http://terminology.hl7.org/CodeSystem/observation-category",
    "code": "vital-signs" }] }],
  "code": { "coding": [{
    "system": "http://loinc.org", "code": "8867-4",
    "display": "Heart rate" }] },
  "subject": { "reference": "Patient/ID_PASIEN" },
  "effectiveDateTime": "2026-11-18T08:30:00+07:00",
  "valueQuantity": { "value": 88, "unit": "/min",
    "system": "http://unitsofmeasure.org", "code": "/min" }
}
⚠️ Perhatian
Jangan menebak kode. Kode ICD-10, LOINC, dan SNOMED CT harus berasal dari sumber resmi (WHO, Regenstrief Institute, dan panduan SATUSEHAT). Alamat sistem identitas, seperti URL untuk NIK pada contoh di atas, juga harus kamu cocokkan dengan dokumentasi terbaru platform sebelum dipakai di lingkungan produksi.
🧠 Analisis: Pemetaan Buruk vs Pemetaan Baik
❌ Pemetaan Buruk
Jenis kelamin dikirim sebagai “P” tanpa konversi. Diagnosis berupa teks bebas. Satuan nadi hilang. Penerima harus menebak artinya.
✅ Pemetaan Baik
“P” dikonversi menjadi female. Diagnosis memakai kode ICD-10. Nadi membawa kode LOINC dan satuan UCUM. Penerima langsung paham.

Langkah Praktis Merancang Interoperabilitas FHIR untuk Tugas Kuliahmu

Kesalahan yang paling sering muncul pada proyek mahasiswa bukan di kodenya, melainkan di data sumber: tanggal lahir dengan format campur aduk, NIK kosong, atau diagnosis ditulis bebas. Karena itu, sisihkan waktu untuk membersihkan data sebelum pemetaan. Kamu sebagai calon perekam medis punya keunggulan di sini, sebab kamu paham betul kebiasaan pengisian data di lapangan.

Kamu sudah punya konsepnya. Sekarang rangkai menjadi proyek kecil yang bisa kamu presentasikan. Ikuti urutan ini:

1
Pilih satu kasus penggunaan
Misalnya “kirim data kunjungan rawat jalan”. Tulis tujuan dan penerimanya dalam satu kalimat.
2
Gambar diagram alur
Gunakan draw.io atau kertas. Beri tanda pada titik validasi dan titik otentikasi.
3
Buat tabel pemetaan
Isi kolom tabel SIMRS, Resource FHIR, elemen, dan terminologi. Tandai kolom yang belum punya padanan.
4
Tulis mapper kecil
Mulai dari Patient, lalu Encounter, lalu Observation. Satu Resource per iterasi.
5
Validasi dan uji di server uji
Kirim ke server FHIR publik untuk latihan atau sandbox, baca pesan OperationOutcome, lalu perbaiki. Pengujian lengkap kita bahas di artikel berikutnya.
💡 Tips
Mulai dengan data dummy. Jangan pernah memakai data pasien asli untuk latihan. Buat 10 pasien fiktif dengan variasi nilai kosong dan tidak lazim, karena data nyata selalu lebih berantakan daripada contoh buku.

🎯 Kesimpulan

Merancang interoperabilitas FHIR berjalan dalam tiga lapis. Analisis kebutuhan menentukan apa yang dipertukarkan. Diagram alur menunjukkan jalur dan titik pemeriksaannya. Pemetaan tabel menerjemahkan data SIMRS ke Resource FHIR dengan kode standar. Lewati satu lapis, dan integrasimu hampir pasti bermasalah.

Kamu sudah punya kerangka untuk memulai. Pilih satu kasus penggunaan, gambar alurnya, lalu petakan tabelnya hari ini.

Menurutmu, tabel mana di SIMRS yang paling sulit dipetakan ke FHIR? Tulis di kolom komentar, dan bagikan artikel ini ke temanmu yang sedang mengerjakan proyek integrasi.

📚 Referensi
  1. Bender, D., & Sartipi, K. (2013). HL7 FHIR: An agile and RESTful approach to healthcare information exchange. Proceedings of the 26th IEEE International Symposium on Computer-Based Medical Systems, 326–331.
  2. HL7 International. (2019). HL7 FHIR Release 4 (v4.0.1). https://hl7.org/fhir/R4/
  3. Kementerian Kesehatan Republik Indonesia. (2022). Peraturan Menteri Kesehatan Nomor 24 Tahun 2022 tentang Rekam Medis.
  4. Kementerian Kesehatan Republik Indonesia. Platform SATUSEHAT: Dokumentasi pengembang. https://satusehat.kemkes.go.id/platform
  5. Regenstrief Institute. LOINC: Logical Observation Identifiers Names and Codes. https://loinc.org
  6. World Health Organization. International Statistical Classification of Diseases and Related Health Problems, 10th Revision (ICD-10).
🏷️ Tag
#PertukaranData#PertukaranInformasi#Kesehatan#MerancangInteroperabilitasFHIR
📌 Label
Merancang Interoperabilitas FHIRAnalisis KebutuhanDiagram AlurPemetaan FHIR Resource
📖

Pertukaran Informasi Kesehatan

Kembali ke daftar isi lengkap kuliah D4 MIK, berisi seluruh 16 artikel dalam seri ini.

Buka Daftar Isi Kuliah

No comments:

Post a Comment

saifiahmada.com adalah blog belajar programming Indonesia, membahas lengkap materi bahasa pemrograman: code HTML, CSS, Bootstrap, Desain, PHP, MySQL, coding Java, Query, SQL, dan dunia linux