Konfigurasi EHR Epic

Halaman ini menjelaskan cara mendaftarkan dan mengonfigurasi aplikasi Epic sebelum Anda membuat penyimpanan data EHR Epic. Organisasi Anda mendaftarkan aplikasi Epic-nya sendiri. Analis Epic Anda biasanya menyelesaikan langkah-langkah ini.

Mendaftarkan aplikasi Epic

Daftarkan aplikasi untuk Gemini Enterprise di Epic on FHIR, dan sediakan di lingkungan Epic Anda. Gunakan setelan berikut:

Setelan Nilai
Audiens Aplikasi Tenaga Klinis atau Pengguna Administratif
API yang akan datang API R4 yang tercantum di Mengaktifkan API Epic
API Keluar Tidak ada
Apakah aplikasi ini akan mendaftarkan klien dinamis? Tidak
Is Confidential Client Ya
Memerlukan Akses Persisten Ya
Menggunakan Token Refresh Bergulir Ya
URL JWK Set Biarkan kosong
Versi SMART on FHIR R4
Versi SMART Scope SMART v1
Skema Pembuatan ID FHIR Menggunakan ID FHIR dengan Batas 64 Karakter untuk Resource FHIR USCDI

Setelan akses persisten organisasi Anda untuk aplikasi menentukan berapa lama otorisasi pengguna berlangsung. Setelah berakhir, pengguna akan memberikan otorisasi lagi kepada konektor.

Menetapkan URI pengalihan

Di aplikasi, daftarkan kedua URI pengalihan berikut persis seperti yang ditampilkan:

  • https://vertexaisearch.cloud.google.com/oauth-redirect
  • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html

Mengaktifkan Epic API

Di aplikasi, aktifkan API baca dan telusuri R4 untuk resource FHIR berikut: Patient, Observation, Condition, MedicationRequest, AllergyIntolerance, DiagnosticReport, DocumentReference, Binary, Encounter, ServiceRequest, Coverage, Immunization, dan Procedure.

Beberapa resource, seperti Observation dan Condition, memiliki API terpisah untuk setiap kategori, misalnya lab dan tanda vital. Aktifkan kategori yang ingin Anda izinkan untuk dikueri pengguna. Jangan aktifkan API tulis.

Jika API tidak diaktifkan, hanya tindakan yang menggunakannya yang akan gagal.

Mendapatkan client ID dan rahasia klien

Epic menerbitkan client ID non-produksi dan client ID produksi untuk aplikasi. Gunakan client ID yang cocok dengan lingkungan Epic yang dituju oleh URL Anda. Karena aplikasi ini adalah klien rahasia, aplikasi ini juga memiliki rahasia klien. Anda memasukkan client ID dan rahasia klien saat membuat penyimpanan data.

Menemukan endpoint Epic Anda

Untuk membuat penyimpanan data, Anda memerlukan tiga URL dari lingkungan Epic: URL dasar FHIR R4, URL otorisasi, dan URL token. Analis Epic Anda dapat memberikannya. Konfigurasi SMART organisasi Anda, di FHIR_BASE_URL/.well-known/smart-configuration, juga mencantumkan URL otorisasi (authorization_endpoint) dan URL token (token_endpoint). Ganti FHIR_BASE_URL dengan URL dasar FHIR R4 Anda.

Masukkan setiap URL dengan https:// dan tanpa garis miring setelahnya. Misalnya, sandbox publik Epic menggunakan URL berikut:

URL Contoh sandbox Epic
URL dasar FHIR R4 https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
URL Otorisasi https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
URL Token https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

Memecahkan masalah

Tabel berikut mencantumkan masalah umum dan cara mengatasinya:

Masalah Resolusi
Konsol akan menampilkan salah satu pesan berikut:
  • "URL Epic FHIR R4 harus berupa URL https:// tanpa garis miring di akhir."
  • "URL Epic Authorize harus berupa URL https:// tanpa garis miring di akhir."
  • "URL Token Epic harus berupa URL https:// tanpa garis miring di akhir."
 Masukkan URL dengan https:// dan tanpa garis miring di akhir.
Konsol menampilkan "Failed to obtain refresh token". Di aplikasi Epic, pilih Is Confidential Client dan Requires Persistent Access, lalu simpan perubahan. Kemudian, di konsol Google Cloud , klik Verify Auth lagi.
Epic melaporkan bahwa URI pengalihan tidak cocok. Daftarkan kedua URI pengalihan persis seperti yang ditunjukkan di Menetapkan URI pengalihan.
Epic menampilkan "Permintaan OAuth 2.0 tidak valid" saat login. Setiap link login Epic hanya berfungsi sekali, jadi memuat ulang jendela login akan menampilkan error ini. Tutup jendela, lalu mulai login lagi tanpa memuat ulang. Jika error berlanjut, pastikan aplikasi memiliki API untuk cakupan yang diminta.
Epic menampilkan invalid_client. Client ID atau rahasia klien salah, memiliki spasi tambahan, atau milik lingkungan Epic lain. Masukkan client ID dan rahasia klien untuk lingkungan yang dituju oleh URL Anda.
Jendela login tidak kembali ke Gemini Enterprise, atau konektor tidak diizinkan setelah login. Tutup jendela login, muat ulang Gemini Enterprise, dan beri otorisasi konektor lagi.
Satu tindakan gagal, dan tindakan lainnya berfungsi. Epic API untuk tindakan tersebut tidak diaktifkan. Aktifkan di aplikasi, lalu minta pengguna mengizinkan konektor lagi.
Gemini Enterprise menampilkan pesan "Maaf, sepertinya Anda tidak diizinkan menjalankan operasi ini. Harap hubungi administrator." kepada pengguna yang telah memberikan otorisasi kepada konektor sebelumnya. Otorisasi Epic pengguna telah berakhir. Pengguna memberikan otorisasi pada konektor lagi.
Gemini Enterprise tidak menemukan pasien berdasarkan nama. Tambahkan tanggal lahir, atau gunakan MRN atau ID pasien Epic.
Gemini Enterprise menyatakan bahwa beberapa data tidak dapat diambil. Keamanan Epic menyembunyikan data ini dari pengguna. Pengguna hanya melihat data yang diizinkan Epic untuk mereka lihat.
Teks laporan atau catatan tidak tersedia. Dokumen dalam format PDF atau format lain yang tidak dapat dibaca oleh konektor. Buka dokumen di Epic.
Otorisasi terus gagal hanya di satu aplikasi. Hapus penyimpanan data Epic EHR dari aplikasi, tambahkan kembali, dan beri otorisasi konektor lagi.

Langkah berikutnya