Mengelola resource FHIR menggunakan FHIR Engine Library

1. Sebelum memulai

Yang akan Anda build

Dalam codelab ini, Anda akan membangun aplikasi Android menggunakan FHIR Engine Library. Aplikasi Anda akan menggunakan FHIR Engine Library untuk mendownload resource FHIR dari server FHIR, dan mengupload semua perubahan lokal ke server.

Yang akan Anda pelajari

  • Cara membuat server HAPI FHIR lokal menggunakan Docker
  • Cara mengintegrasikan FHIR Engine Library ke dalam aplikasi Android Anda
  • Cara menggunakan Sync API untuk menyiapkan tugas satu kali atau berkala guna mendownload dan mengupload resource FHIR
  • Cara menggunakan Search API
  • Cara menggunakan Data Access API untuk membuat, membaca, memperbarui, dan menghapus resource FHIR secara lokal

Yang Anda butuhkan

Jika belum pernah membuat aplikasi Android, Anda dapat mulai dengan membuat aplikasi pertama Anda.

2. Menyiapkan server HAPI FHIR lokal dengan data pengujian

HAPI FHIR adalah server FHIR open source yang populer. Kita menggunakan server FHIR HAPI lokal dalam codelab untuk terhubung ke aplikasi Android.

Menyiapkan server HAPI FHIR lokal

  1. Jalankan perintah berikut di terminal untuk mendapatkan image HAPI FHIR terbaru
    docker pull hapiproject/hapi:latest
  2. Buat container HAPI FHIR dengan menggunakan Desktop Docker untuk menjalankan image yang telah didownload hapiproject/hapi, atau menjalankan perintah berikut
    docker run -p 8080:8080 hapiproject/hapi:latest
    Pelajari lebih lanjut.
  3. Periksa server dengan membuka URL http://localhost:8080/ di browser. Anda akan melihat antarmuka web HAPI FHIR.Antarmuka web HAPI FHIR

Mengisi server HAPI FHIR lokal dengan data pengujian

Untuk menguji aplikasi, kita memerlukan beberapa data uji di server. Kita akan menggunakan data sintetis yang dihasilkan oleh Synthea.

  1. Pertama, kita perlu mendownload data sampel dari synthea-samples. Download dan ekstrak synthea_sample_data_fhir_r4_sep2019.zip. Sampel data yang diekstrak memiliki banyak file .json, masing-masing berupa paket transaksi untuk satu pasien.
  2. Kita akan mengupload data tes untuk tiga pasien ke server HAPI FHIR lokal. Jalankan perintah berikut di direktori yang berisi file JSON
    curl -X POST -H "Content-Type: application/json" -d @./Aaron697_Brekke496_2fa15bc7-8866-461a-9000-f739e425860a.json http://localhost:8080/fhir/
curl -X POST -H "Content-Type: application/json" -d @./Aaron697_Stiedemann542_41166989-975d-4d17-b9de-17f94cb3eec1.json http://localhost:8080/fhir/
curl -X POST -H "Content-Type: application/json" -d @./Abby752_Kuvalis369_2b083021-e93f-4991-bf49-fd4f20060ef8.json http://localhost:8080/fhir/
  3. Untuk mengupload data tes untuk semua pasien ke server, jalankan
    for f in *.json; do curl -X POST -H "Content-Type: application/json" -d @$f http://localhost:8080/fhir/ ; done
    Namun, proses ini bisa memakan waktu lama dan tidak diperlukan untuk codelab.
  4. Pastikan data pengujian tersedia di server dengan membuka URL http://localhost:8080/fhir/Patient/ di browser. Anda akan melihat teks HTTP 200 OK dan bagian Response Body di halaman yang berisi data pasien di Paket FHIR sebagai hasil penelusuran dengan jumlah total.Menguji data di server

3. Menyiapkan aplikasi Android

Mendownload Kode

Guna mendownload kode untuk codelab ini, clone repositori Android FHIR SDK: git clone https://github.com/google/android-fhir.git

Project awal untuk codelab ini terletak di codelabs/engine.

Mengimpor aplikasi ke Android Studio

Kita mulai dengan mengimpor aplikasi awal ke Android Studio.

Buka Android Studio, pilih Import Project (Gradle, Eclipse ADT, etc.) dan pilih folder codelabs/engine/ dari kode sumber yang telah Anda download sebelumnya.

Layar mulai Android Studio

Menyinkronkan project dengan file Gradle

Untuk memudahkan Anda, dependensi Library FHIR Engine telah ditambahkan ke project. Hal ini memungkinkan Anda mengintegrasikan Library FHIR Engine di aplikasi Anda. Amati baris berikut hingga akhir file app/build.gradle.kts project Anda:

dependencies {
    // ...

    implementation("com.google.android.fhir:engine:0.1.0-beta05")
}

Guna memastikan bahwa semua dependensi tersedia untuk aplikasi, Anda harus menyinkronkan project dengan file gradle pada tahap ini.

Pilih Sync Project with Gradle Files (Tombol sinkronisasi Gradle) dari toolbar Android Studio. Anda juga menjalankan aplikasi kembali untuk memeriksa apakah dependensi berfungsi dengan benar.

Menjalankan aplikasi awal

Setelah mengimpor project ke Android Studio, Anda siap menjalankan aplikasi untuk pertama kalinya.

Mulai emulator Android Studio, lalu klik Run (Tombol Run) di toolbar Android Studio.

Aplikasi Hello World

4. Membuat instance FHIR Engine

Untuk menggabungkan FHIR Engine ke dalam aplikasi Android, Anda harus menggunakan Library FHIR Engine dan memulai instance FHIR Engine. Langkah-langkah yang diuraikan di bawah ini akan memandu Anda melalui prosesnya.

  1. Buka class Aplikasi Anda, yang dalam contoh ini adalah FhirApplication.kt, yang terletak di app/src/main/java/com/google/android/fhir/codelabs/engine.
  2. Di dalam metode onCreate(), tambahkan kode berikut untuk melakukan inisialisasi FHIR Engine:
      FhirEngineProvider.init(
      FhirEngineConfiguration(
        enableEncryptionIfSupported = true,
        RECREATE_AT_OPEN,
        ServerConfiguration(
          baseUrl = "http://10.0.2.2:8080/fhir/",
          httpLogger =
            HttpLogger(
              HttpLogger.Configuration(
                if (BuildConfig.DEBUG) HttpLogger.Level.BODY else HttpLogger.Level.BASIC,
              ),
            ) {
              Log.d("App-HttpLog", it)
            },
        ),
      ),
  )
    Catatan:
    • enableEncryptionIfSupported: Mengaktifkan enkripsi data jika perangkat mendukungnya.
    • RECREATE_AT_OPEN: Menentukan strategi error database. Dalam hal ini, pembuatan ulang database jika terjadi error saat membuka.
    • baseUrl di ServerConfiguration: Ini adalah URL dasar server FHIR. Alamat IP yang diberikan 10.0.2.2 secara khusus dicadangkan untuk localhost, dan dapat diakses dari emulator Android. Pelajari lebih lanjut.
  3. Di class FhirApplication, tambahkan baris berikut untuk membuat instance FHIR Engine dengan lambat:
      private val fhirEngine: FhirEngine by
      lazy { FhirEngineProvider.getInstance(this) }
    Hal ini memastikan instance FhirEngine hanya dibuat saat pertama kali diakses, bukan langsung saat aplikasi dimulai.
  4. Tambahkan metode praktis berikut di class FhirApplication untuk memudahkan akses di seluruh aplikasi Anda:
    companion object {
    fun fhirEngine(context: Context) =
        (context.applicationContext as FhirApplication).fhirEngine
}
    Metode statis ini memungkinkan Anda mengambil instance FHIR Engine dari mana saja di aplikasi menggunakan konteks.

5. Menyinkronkan data dengan server FHIR

  1. Buat class baru DownloadWorkManagerImpl.kt. Di class ini, Anda akan menentukan cara aplikasi mengambil resource berikutnya dari daftar yang akan didownload:
      class DownloadWorkManagerImpl : DownloadWorkManager {
    private val urls = LinkedList(listOf("Patient"))

    override suspend fun getNextRequest(): DownloadRequest? {
      val url = urls.poll() ?: return null
      return DownloadRequest.of(url)
    }

    override suspend fun getSummaryRequestUrls() = mapOf<ResourceType, String>()

    override suspend fun processResponse(response: Resource): Collection<Resource> {
      var bundleCollection: Collection<Resource> = mutableListOf()
      if (response is Bundle && response.type == Bundle.BundleType.SEARCHSET) {
        bundleCollection = response.entry.map { it.resource }
      }
      return bundleCollection
    }
  }
    Class ini memiliki antrean jenis resource yang ingin didownload. API ini memproses respons dan mengekstrak resource dari paket yang ditampilkan, yang kemudian disimpan ke dalam database lokal.
  2. Membuat class baru AppFhirSyncWorker.kt Class ini menentukan cara aplikasi akan disinkronkan dengan server FHIR jarak jauh menggunakan pekerja latar belakang.
    class AppFhirSyncWorker(appContext: Context, workerParams: WorkerParameters) :
  FhirSyncWorker(appContext, workerParams) {

  override fun getDownloadWorkManager() = DownloadWorkManagerImpl()

  override fun getConflictResolver() = AcceptLocalConflictResolver

  override fun getFhirEngine() = FhirApplication.fhirEngine(applicationContext)
}
    Di sini, kami telah menentukan pengelola download, resolver konflik, dan instance mesin FHIR yang akan digunakan untuk sinkronisasi.
  3. Di ViewModel, PatientListViewModel.kt, Anda akan menyiapkan mekanisme sinkronisasi satu kali. Temukan dan tambahkan kode ini ke fungsi triggerOneTimeSync():
    viewModelScope.launch {
      Sync.oneTimeSync<AppFhirSyncWorker>(getApplication())
        .shareIn(this, SharingStarted.Eagerly, 10)
        .collect { _pollState.emit(it) }
    }
    Coroutine ini memulai sinkronisasi satu kali dengan server FHIR menggunakan AppFhirSyncWorker yang telah kita tentukan sebelumnya. Kemudian, UI akan diupdate berdasarkan status proses sinkronisasi.
  4. Dalam file PatientListFragment.kt, perbarui isi fungsi handleSyncJobStatus:
    when (syncJobStatus) {
    is SyncJobStatus.Finished -> {
        Toast.makeText(requireContext(), "Sync Finished", Toast.LENGTH_SHORT).show()
        viewModel.searchPatientsByName("")
    }
    else -> {}
}
    Di sini, ketika proses sinkronisasi selesai, pesan toast akan menampilkan memberi tahu pengguna, dan aplikasi kemudian akan menampilkan semua pasien dengan memanggil penelusuran dengan nama kosong.

Setelah semuanya siap, jalankan aplikasi Anda. Klik tombol Sync di menu. Jika semuanya berfungsi dengan benar, Anda akan melihat pasien dari server FHIR lokal didownload dan ditampilkan di aplikasi.

Daftar pasien

6. Mengubah dan Mengupload Data Pasien

Di bagian ini, kami akan memandu Anda melalui proses modifikasi data pasien berdasarkan kriteria tertentu dan mengupload data yang telah diperbarui ke server FHIR Anda. Khususnya, kita akan menukar kota alamat untuk pasien yang tinggal di Wakefield dan Taunton.

Langkah 1: Menyiapkan Logika Modifikasi di PatientListViewModel

Kode di bagian ini ditambahkan ke fungsi triggerUpdate di PatientListViewModel

  1. Mengakses FHIR Engine:Mulai dengan mendapatkan referensi ke mesin FHIR di PatientListViewModel.kt.
    viewModelScope.launch {
   val fhirEngine = FhirApplication.fhirEngine(getApplication())
    Kode ini meluncurkan coroutine dalam cakupan ViewModel dan menginisialisasi mesin FHIR.
  2. Telusuri Pasien dari Wakefield:Gunakan mesin FHIR untuk mencari pasien dengan kota alamat Wakefield.
    val patientsFromWakefield =
     fhirEngine.search<Patient> {
       filter(
         Patient.ADDRESS_CITY,
         {
           modifier =  StringFilterModifier.MATCHES_EXACTLY
           value = "Wakefield"
         }
       )
     }
    Di sini, kita menggunakan metode search mesin FHIR untuk memfilter pasien berdasarkan kota alamat mereka. Hasilnya adalah daftar pasien dari Wakefield.
  3. Telusuri Pasien dari Taunton:Demikian pula, cari pasien dengan kota alamat Taunton.
    val patientsFromTaunton =
     fhirEngine.search<Patient> {
       filter(
         Patient.ADDRESS_CITY,
         {
           modifier =  StringFilterModifier.MATCHES_EXACTLY
           value = "Taunton"
         }
       )
     }
    Sekarang kita memiliki dua daftar pasien, satu dari Wakefield dan lainnya dari Taunton.
  4. Ubah Alamat Pasien:Telusuri setiap pasien dalam daftar patientsFromWakefield, ubah kota mereka menjadi Taunton, dan perbarui di mesin FHIR.
    patientsFromWakefield.forEach {
     it.resource.address.first().city = "Taunton"
     fhirEngine.update(it.resource)
}
    Demikian pula, perbarui setiap pasien dalam daftar patientsFromTaunton agar kotanya diubah menjadi Wakefield.
    patientsFromTaunton.forEach {
     it.resource.address.first().city = "Wakefield"
     fhirEngine.update(it.resource)
}
  5. Memulai Sinkronisasi:Setelah mengubah data secara lokal, picu sinkronisasi satu kali untuk memastikan data diperbarui di server FHIR.
    triggerOneTimeSync()
}
    Kurung kurawal penutup } menandakan akhir coroutine yang diluncurkan di awal.

Langkah 2: Uji Fungsi

  1. Pengujian UI:Jalankan aplikasi Anda. Klik tombol Update di menu. Anda akan melihat kota alamat untuk pasien Aaron697 dan Abby752 ditukar.
  2. Verifikasi Server:Buka browser dan klik http://localhost:8080/fhir/Patient/. Verifikasi bahwa kota alamat untuk pasien Aaron697 dan Abby752 telah diperbarui di server FHIR lokal.

Dengan mengikuti langkah ini, Anda telah berhasil menerapkan mekanisme untuk memodifikasi data pasien dan menyinkronkan perubahan dengan server FHIR.

7. Telusuri Pasien berdasarkan Nama

Mencari pasien berdasarkan nama mereka dapat memberikan cara yang mudah digunakan untuk mengambil informasi. Di sini, kami akan memandu Anda melalui proses penerapan fitur ini di permohonan.

Langkah 1: Perbarui Tanda Tangan Fungsi

Buka file PatientListViewModel.kt Anda dan temukan fungsi bernama searchPatientsByName. Kita akan menambahkan kode ke dalam fungsi ini.

Untuk memfilter hasil berdasarkan kueri nama yang diberikan, dan menampilkan hasil untuk UI yang akan diperbarui, sertakan blok kode kondisional berikut:

    viewModelScope.launch {
      val fhirEngine = FhirApplication.fhirEngine(getApplication())
      if (nameQuery.isNotEmpty()) {
        val searchResult = fhirEngine.search<Patient> {
          filter(
            Patient.NAME,
            {
              modifier = StringFilterModifier.CONTAINS
              value = nameQuery
            },
          )
        }
        liveSearchedPatients.value  =  searchResult.map { it.resource }
      }
    }

Di sini, jika nameQuery tidak kosong, fungsi penelusuran akan memfilter hasil agar hanya menyertakan pasien yang namanya berisi kueri yang ditentukan.

Langkah 2: Uji Fungsi Penelusuran Baru

  1. Luncurkan ulang Aplikasi:Setelah melakukan perubahan ini, bangun ulang dan jalankan aplikasi Anda.
  2. Telusuri Pasien: Di layar daftar pasien, gunakan fungsi penelusuran. Sekarang Anda dapat memasukkan nama (atau bagian dari nama) untuk memfilter daftar pasien yang sesuai.

Dengan menyelesaikan langkah-langkah ini, Anda telah meningkatkan kualitas aplikasi dengan memberi pengguna kemampuan untuk mencari pasien berdasarkan nama mereka secara efisien. Hal ini dapat meningkatkan pengalaman pengguna dan efisiensi dalam pengambilan data secara signifikan.

8. Selamat!

Anda telah menggunakan Library FHIR Engine untuk mengelola resource FHIR di aplikasi Anda:

  • Menggunakan Sync API untuk menyinkronkan resource FHIR dengan server FHIR
  • Menggunakan Data Access API untuk membuat, membaca, memperbarui, dan menghapus resource FHIR lokal
  • Menggunakan Search API untuk menelusuri resource FHIR lokal

Yang telah kita bahas

  • Cara menyiapkan server HAPI FHIR lokal
  • Cara mengupload data pengujian ke Server FHIR HAPI lokal
  • Cara membangun aplikasi Android menggunakan FHIR Engine Library
  • Cara menggunakan Sync API, Data Access API, dan Search API di FHIR Engine Library

Langkah Berikutnya

  • Pelajari dokumentasi untuk Library FHIR Engine
  • Mempelajari fitur lanjutan Search API
  • Menerapkan Library FHIR Engine di aplikasi Android Anda sendiri

Pelajari Lebih Lanjut