Panduan Ikhtisar Otomatisasi

Otomatisasi memungkinkan Anda mengekspor dan menyinkronkan data Apple Health secara otomatis ke berbagai tujuan tanpa intervensi manual. Panduan ini memberikan ikhtisar fitur otomatisasi dan tautan ke panduan terperinci untuk setiap jenis otomatisasi.

Ikhtisar

Otomatisasi adalah alur kerja yang dikonfigurasi yang secara otomatis mengekspor data kesehatan Anda ke layanan eksternal, penyimpanan cloud, atau tujuan lain. Setelah dikonfigurasi, otomatisasi dapat berjalan otomatis di latar belakang.

Manfaat:

• Pencadangan dan sinkronisasi data otomatis
• Tidak perlu intervensi manual
• Frekuensi sinkronisasi yang dapat dikonfigurasi
• Beberapa jenis otomatisasi untuk berbagai kasus penggunaan
• Beroperasi di latar belakang (aplikasi tidak perlu dibuka)

Kasus penggunaan:

• Pencadangan cloud otomatis
• Integrasi dengan sistem otomasi rumah
• Integrasi API untuk aplikasi kustom
• Platform analisis dan visualisasi data
• Berbagi data kesehatan dengan penyedia layanan kesehatan

Batasan:

• Akses data kesehatan: Aplikasi tidak diizinkan mengakses data kesehatan saat iPhone terkunci. Otomatisasi hanya berjalan saat perangkat Anda tidak terkunci. Ini adalah batasan Apple yang tidak dapat diatasi. Informasi selengkapnya
• Pemrosesan latar belakang: iOS membatasi pemrosesan latar belakang untuk menghemat baterai. Otomatisasi bergantung pada Penyegaran Aplikasi Latar Belakang dan mungkin tidak langsung berjalan jika:
  • Penyegaran Aplikasi Latar Belakang dinonaktifkan untuk aplikasi
  • perangkat dalam Mode Daya Rendah
  • perangkat tidak aktif dalam waktu lama
  • sumber daya sistem terbatas
  • beberapa aplikasi bersaing untuk waktu eksekusi latar belakang
• Penjadwalan: Terkait pemrosesan latar belakang, iOS juga tidak mengizinkan aplikasi berjalan di latar belakang pada waktu tertentu. Artinya, meskipun Anda menetapkan irama sinkronisasi tertentu, otomatisasi tidak dijamin berjalan tepat pada waktu yang ditentukan. Perangkat harus tidak terkunci dan iOS akan menentukan kapan otomatisasi berjalan di latar belakang. Otomatisasi juga dapat dipicu secara manual melalui metode berikut:
  • Widget Otomatisasi: ketuk ikon widget untuk memicu otomatisasi
  • Shortcuts — Jalankan Otomatisasi: gunakan tindakan Jalankan Otomatisasi untuk memicu otomatisasi yang dikonfigurasi (lihat Jadwalkan Otomatisasi dengan Shortcuts)
  • Picu manual di aplikasi: buka otomatisasi di Health Auto Export, lalu lakukan Ekspor Manual
• Sinkronisasi di latar depan: Saat Health Auto Export terbuka di latar depan, otomatisasi yang memenuhi syarat dapat berjalan lagi secara berkala (sekitar setiap 60 detik). Perangkat tetap aktif selama penggunaan di latar depan sehingga sinkronisasi dapat berlanjut. Loop latar depan hanya berhenti saat perangkat mencapai kondisi termal kritis; kondisi yang lebih hangat (non-kritis) masih dapat memungkinkan sinkronisasi di latar depan. Batasan penjadwalan latar belakang di atas tetap berlaku saat aplikasi tidak di latar depan.

Kinerja

Perlu diingat bahwa iOS dioptimalkan untuk tugas berjalan singkat di perangkat seluler dengan batasan kinerja yang ketat. Tugas latar belakang biasanya harus selesai dalam 30 detik dan dibatasi memori yang dapat digunakan. Health Auto Export menawarkan fleksibilitas dan kustomisasi tinggi, sehingga penting memahami bagaimana konfigurasi tertentu memengaruhi kinerja aplikasi dan hasilnya.

• Konfigurasi: Otomatisasi yang menghasilkan data dalam jumlah besar dapat menyebabkan sistem menghentikan proses sehingga otomatisasi tidak berjalan di latar belakang. Konfigurasi berikut dapat menghasilkan data dalam jumlah besar:
  • Otomatisasi yang dikonfigurasi untuk mengekspor semua metrik kesehatan.
    • Rekomendasi: pilih hanya metrik kesehatan yang memiliki data tersimpan di Apple Health dan data yang benar-benar akan Anda gunakan. Bahkan tipe data kosong memengaruhi kinerja. Pertimbangkan juga membagi metrik yang dipilih ke beberapa otomatisasi agar sistem lebih mudah menanganinya.
  • Otomatisasi dengan pengelompokan waktu dalam detik atau menit, atau dengan ringkasan data nonaktif. Kueri sehalus ini dapat berjalan lama dan bentrok dengan batasan sistem.
    • Rekomendasi: meskipun data sedetail mungkin tampak ideal, pertimbangkan apakah tingkat detail itu diperlukan untuk setiap metrik atau tipe data. Pertimbangkan beberapa otomatisasi dengan pengaturan berbeda.
  • Saat mengekspor latihan luar ruangan seperti bersepeda, lari, hiking, dll. dengan data rute, GPS dan metrik kesehatan terkait dapat menghasilkan payload besar.
• Ukuran payload: Terutama saat menggunakan ekspor REST API, payload besar dapat menyebabkan kesalahan server. Pastikan backend Anda dikonfigurasi untuk menangani payload yang mungkin mencapai beberapa ratus megabyte.
• Frekuensi sinkronisasi: Tambahkan widget Otomatisasi ke Layar Utama untuk membantu memastikan otomatisasi berjalan berhasil di latar belakang (lihat Siapkan widget untuk otomatisasi).

Jenis Otomatisasi yang Tersedia

Health Auto Export mendukung beberapa jenis otomatisasi, masing-masing dirancang untuk kasus penggunaan tertentu:

REST API

Kirim data kesehatan ke layanan web apa pun yang menerima permintaan HTTP POST. Ideal untuk backend kustom, webhook, dan API pihak ketiga.

Panduan: Panduan Otomatisasi REST API

Home Assistant

Sinkronkan metrik kesehatan ke Home Assistant sebagai status sensor. Cocok untuk mengintegrasikan data kesehatan ke otomasi rumah pintar Anda.

Panduan: Panduan Otomatisasi Home Assistant

MQTT

Publikasikan data kesehatan ke broker MQTT. Bagus untuk platform IoT dan sistem berbasis MQTT.

Panduan: Panduan Otomatisasi MQTT

Dropbox

Cadangkan data kesehatan secara otomatis ke Dropbox. File diatur dalam folder dan dapat diakses dari perangkat apa pun.

Panduan: Panduan Otomatisasi Dropbox

Google Drive

Cadangkan data kesehatan secara otomatis ke Google Drive. File CSV dapat dikonversi ke Google Sheets untuk tampilan mudah.

Panduan: Panduan Otomatisasi Google Drive

iCloud Drive

Simpan data kesehatan langsung ke iCloud Drive. Penyiapan sederhana tanpa autentikasi.

Panduan: Panduan Otomatisasi iCloud Drive

Kalender

Buat acara kalender berdasarkan data kesehatan Anda. Visualisasikan latihan, pencapaian kesehatan, dan acara lain di kalender Anda.

Panduan: Panduan Otomatisasi Kalender

Membuat Otomatisasi Pertama Anda

1. Buka layar Ekspor Otomatis dari navigasi utama
2. Ketuk «Otomatisasi Baru»
3. Pilih Jenis Otomatisasi
4. Konfigurasi pengaturan khusus otomatisasi (lihat panduan individual)
5. Konfigurasi pengaturan umum (jenis data, irama sinkronisasi, dll.)
6. Ketuk «Perbarui» untuk menyimpan
7. Aktifkan otomatisasi

Mencadangkan & Memulihkan Otomatisasi Anda

Health Auto Export dapat mencadangkan pengaturan otomatisasi ke iCloud Drive agar Anda dapat memulihkannya di perangkat baru atau setelah menginstal ulang aplikasi. Ini terpisah dari data kesehatan yang diekspor otomatisasi Anda.

• Lokasi cadangan: Pengaturan otomatisasi disimpan sebagai file JSON di iCloud Drive, di folder Auto Export/Automations (terlihat di aplikasi File).
• Kapan dicadangkan: Setiap kali Anda menyimpan otomatisasi (mengetuk Perbarui, atau meninggalkan layar edit), otomatisasi itu dicadangkan secara otomatis.
• Mengaktifkan atau menonaktifkan: Buka daftar otomatisasi dan buka Pengaturan Otomatisasi, lalu gunakan Cadangkan ke iCloud Drive. Secara default aktif. Jika dinonaktifkan, Anda akan ditanya apakah ingin menghapus file cadangan yang ada di iCloud Drive — otomatisasi tetap ada di perangkat Anda.

Memulihkan

Jika Anda membuka Ekspor Otomatis dan belum memiliki otomatisasi tetapi cadangan tersedia di iCloud Drive, tombol Pulihkan dari iCloud Drive muncul. Ketuk untuk mengembalikan otomatisasi Anda.

Beberapa hal yang perlu diketahui setelah pemulihan:

• Hubungkan kembali akun Anda: Demi privasi Anda, token masuk untuk layanan seperti Dropbox dan Google Drive tidak disertakan dalam cadangan. Setelah memulihkan, hubungkan kembali layanan tersebut di setiap otomatisasi.
• Aktifkan kembali otomatisasi: Otomatisasi yang dipulihkan dimulai nonaktif agar tidak ada yang berjalan secara tidak terduga dengan pengaturan usang. Tinjau masing-masing dan aktifkan saat Anda siap.
• Pemulihan sebagian: Jika beberapa otomatisasi tidak dapat dipulihkan (misalnya file belum diunduh, kunci enkripsi belum tersedia, atau dibuat oleh versi aplikasi yang lebih baru), sisanya tetap dipulihkan dan Anda akan melihat yang dilewati.

Catatan: Header permintaan dan kredensial yang Anda ketik ke otomatisasi (seperti kata sandi MQTT) dienkripsi dalam file cadangan iCloud Drive. Pemulihan di perangkat baru memerlukan iCloud Keychain agar aplikasi dapat mendekripsinya. File bagikan/ekspor manual tetap JSON biasa tanpa enkripsi.

Log aktivitas

Setiap otomatisasi memiliki Log aktivitas untuk riwayat jalannya.

1. Buka otomatisasi dan ketuk Lihat Log Aktivitas.
2. Peristiwa dikelompokkan menurut jalankan (jalankan terbaru di atas). Perluas satu jalankan untuk melihat peristiwa individual.
3. Peringatan (misalnya kueri data kesehatan lambat) berarti jalankan selesai tetapi satu langkah memakan waktu lebih lama dari yang diharapkan. Kesalahan berarti langkah gagal (unggah, baca HealthKit, autentikasi, dan sejenisnya).
4. Hapus (bilah alat) hanya menghapus riwayat aktivitas otomatisasi itu, bukan log diagnostik seluruh aplikasi.
5. Bagikan (bilah alat) mengekspor ZIP diagnostik App Event Logs lengkap — paket yang sama dengan Pengaturan → Lanjutan → Ekspor Log Peristiwa. Lihat Panduan Log Peristiwa Aplikasi.

Kueri lambat di log aktivitas

• Jika otomatisasi lama mengambil data kesehatan, Log aktivitas dapat menampilkan peringatan kueri data kesehatan lambat, bukan kesalahan.
• Untuk mempercepat jalankan: pilih lebih sedikit metrik kesehatan, gunakan rentang tanggal lebih pendek, aktifkan Ringkas Data, dan pilih Pengelompokan Waktu yang lebih besar (jam, hari, atau minggu).
• Otomatisasi waktu nyata sengaja menggunakan pengelompokan lebih halus dan dapat lebih sering mencatat peringatan kueri lambat.

Peringatan pengaturan ekspor

Saat mengonfigurasi otomatisasi metrik kesehatan (bukan Home Assistant), catatan kaki dapat muncul di bawah Pengaturan Ekspor jika konfigurasi mungkin lambat:

• Ringkas Data mati, atau pengelompokan waktu menit atau detik, dan
• lebih dari 10 metrik kesehatan dipilih

Catatan kaki menyarankan lebih sedikit metrik, rentang tanggal lebih pendek, Ringkas Data, atau pengelompokan waktu lebih kasar. Tautan ke panduan ini. Peringatan kueri lambat di Log aktivitas terpisah dan muncul setelah jalankan saat kueri melebihi ambang batas.

Praktik terbaik

1. Sinkronisasi otomatis:

• Isi daya perangkat dan gunakan Pencerminan iPhone
  • Saat perangkat diisi daya, iOS membatasi kinerja lebih sedikit sehingga data dapat disinkronkan lebih sering
  • Dengan Pencerminan iPhone, perangkat berperilaku seolah tidak terkunci sehingga Health Auto Export dapat mengakses data kesehatan untuk tindakan otomatis

2. Frekuensi sinkronisasi:

• Keseimbangan antara kesegaran data dan penggunaan sumber daya
• Sinkronisasi harian cocok untuk sebagian besar kasus
• Sinkronisasi lebih sering untuk kebutuhan waktu nyata
• Lebih jarang untuk data ringkasan

3. Pemilihan data:

• Pilih hanya metrik yang Anda butuhkan
• Mengurangi waktu pemrosesan dan ukuran data
• Pertimbangkan otomatisasi terpisah untuk kelompok metrik berbeda

4. Pengujian:

• Jalankan ekspor manual
• Verifikasi data muncul di tujuan
• Periksa Log aktivitas untuk kesalahan
• Pantau sinkronisasi awal dengan saksama

5. Pemantauan:

• Tinjau Log aktivitas secara rutin
• Periksa indikator status otomatisasi
• Atur notifikasi untuk otomatisasi penting
• Pantau tujuan untuk data yang diterima

6. Keamanan:

• Gunakan metode autentikasi yang aman
• Jaga kredensial tetap mutakhir
• Gunakan HTTPS/TLS jika tersedia
• Tinjau pengaturan privasi

7. Kinerja:

• Gunakan pengelompokan waktu yang sesuai
• Pertimbangkan pengaturan rentang tanggal untuk penyimpanan cloud
• Pantau penggunaan baterai dan data
• Tinjau Log aktivitas untuk peringatan kueri lambat

8. Strategi pencadangan:

• Gunakan beberapa jenis otomatisasi untuk redundansi
• Gabungkan penyimpanan cloud dengan integrasi API
• Simpan cadangan lokal jika memungkinkan
• Uji prosedur pemulihan

9. Pemecahan masalah:

• Periksa Log aktivitas terlebih dahulu
• Verifikasi konektivitas jaringan
• Periksa kredensial autentikasi
• Lihat panduan otomatisasi individual untuk masalah spesifik

Widget Otomatisasi

Tambahkan Widget «Otomatisasi» ke Layar Utama untuk:

• memantau status otomatisasi sekilas
• memicu otomatisasi secara manual
• mengoptimalkan unggahan latar belakang

Mendapatkan bantuan

Jika Anda membutuhkan bantuan dengan jenis otomatisasi tertentu:

1. Lihat panduan otomatisasi individual
2. Periksa Log aktivitas untuk pesan kesalahan
3. Tinjau bagian pemecahan masalah
4. Hubungi dukungan jika masalah berlanjut