Import Data Keluarga dari Excel

Gunakan panduan ini jika Anda sudah punya data keluarga dalam spreadsheet dan ingin memindahkannya ke Naoto lewat template Excel resmi.

Sebelum Mulai

Fitur ini hanya bisa dipakai oleh owner atau admin di keluarga yang sedang aktif.
File yang diterima adalah .xlsx dari template resmi Naoto.
Maksimal 1000 anggota keluarga per upload.
Ukuran file harus di bawah 5 MB.

Alur Singkat

Buka dialog Import data keluarga dari Excel.
Klik Unduh template.
Isi data di file template.
Upload file lalu klik Periksa file.
Jika hasilnya File siap diimpor, klik Impor data.

Jika masih ada error, file tidak bisa diterapkan dan perlu diperbaiki lalu di-upload ulang.

Struktur Template

Template resmi berisi empat sheet:

Panduan: contoh pengisian. Sheet ini tidak ikut di-import.
Anggota Keluarga: data orang yang akan dibuat.
Pasangan: relasi pasangan antar anggota dari sheet Anggota Keluarga.
Anak: relasi anak ke pasangan dari sheet Pasangan.

Ada juga sheet teknis tersembunyi bernama _meta. Jangan dihapus atau diubah, karena dipakai untuk memeriksa versi template.

Aturan Isi per Sheet

1. Sheet Anggota Keluarga

Kolom utama:

Kode Anggota*
Nama Depan*
Nama Belakang
Nama Panggilan
Jenis Kelamin*
Masih Hidup*
Tanggal Lahir
Tempat Lahir
Tanggal Wafat
Tempat Wafat

Hal penting:

Isi sheet ini lebih dulu.
Jenis Kelamin* hanya menerima Laki-laki atau Perempuan.
Masih Hidup* hanya menerima Ya atau Tidak.
Tanggal harus berformat YYYY-MM-DD.
Kode Anggota* dipakai lagi di sheet Pasangan dan Anak.

2. Sheet Pasangan

Kolom template yang terlihat:

Kode Pasangan*
Kode Suami*
Kode Istri*
Nama Suami
Nama Istri
Urutan Pernikahan
Tanggal Nikah
Tanggal Cerai

Hal penting:

Isi Kode Suami* dan Kode Istri* dengan Kode Anggota dari sheet Anggota Keluarga.
Nama Suami dan Nama Istri adalah kolom helper yang terisi otomatis dari kode.
Urutan Pernikahan opsional, tetapi jika diisi harus angka bulat minimal 1.
Tanggal Cerai harus sesudah Tanggal Nikah.
Sheet ini boleh dikosongkan jika Anda belum ingin membuat relasi pasangan.

3. Sheet Anak

Kolom template yang terlihat:

Kode Pasangan*
Kode Anak*
Nama Pasangan
Nama Anak
Status Anak*
Urutan Kelahiran

Hal penting:

Isi Kode Pasangan* dengan kode dari sheet Pasangan.
Isi Kode Anak* dengan Kode Anggota dari sheet Anggota Keluarga.
Nama Pasangan dan Nama Anak adalah kolom helper yang terisi otomatis.
Status Anak* hanya menerima Anak Kandung atau Anak Angkat.
Urutan Kelahiran opsional, tetapi jika diisi harus angka bulat minimal 1.
Sheet ini boleh dikosongkan jika relasi anak ingin dilengkapi nanti dari web.

Nilai Otomatis dari Template

Template membantu mengurangi salah referensi:

Kode Anggota* dihasilkan otomatis saat Anda mengisi nama depan.
Kode Pasangan* dihasilkan otomatis saat Anda mulai mengisi pasangan.
Kolom nama helper di sheet Pasangan dan Anak diisi otomatis dari kode yang Anda pilih.
Jika kode tidak ditemukan, sel helper menampilkan peringatan seperti Suami tidak ditemukan, Istri tidak ditemukan, Pasangan tidak ditemukan, atau Anak tidak ditemukan.

Kolom helper tetap bisa dipilih, tetapi tidak bisa diedit langsung.

Error yang Memblokir Import

Import akan berhenti di status File perlu diperbaiki jika ada salah satu kondisi berikut:

sheet wajib hilang, header berubah, atau versi template tidak cocok
file kosong
Kode Anggota atau Kode Pasangan duplikat di workbook
kode pasangan, suami, istri, atau anak tidak ditemukan di sheet yang dirujuk
Kode Suami tidak merujuk ke anggota laki-laki
Kode Istri tidak merujuk ke anggota perempuan
suami dan istri memakai orang yang sama
format tanggal tidak valid
Tanggal Wafat lebih awal dari Tanggal Lahir
Tanggal Cerai tidak sesudah Tanggal Nikah
Status Anak bukan Anak Kandung atau Anak Angkat
Urutan Pernikahan atau Urutan Kelahiran bentrok pada relasi yang sama
satu anak punya lebih dari satu relasi Anak Kandung di workbook yang sama
relasi membuat seseorang menjadi keturunan dari dirinya sendiri

Warning yang Masih Boleh Dilanjutkan

Saat ini warning utama yang dicek adalah kemungkinan duplikat dengan anggota keluarga yang sudah ada, berdasarkan kombinasi:

nama depan
nama belakang
gender

Jika hanya ada warning dan tidak ada error, file tetap bisa masuk status File siap diimpor dan tetap bisa diterapkan.

Batasan Penting Implementasi Saat Ini

Import Excel dipakai untuk membuat data baru dari workbook itu sendiri.
Relasi pasangan dan anak hanya bisa merujuk ke anggota yang ikut ada di file yang sama.
Import ini tidak dipakai untuk menyambungkan relasi ke anggota keluarga lama yang sudah ada di database.

Artinya, jika Anda ingin struktur pasangan dan anak ikut terbentuk lewat import, semua orang yang terlibat perlu ikut dimasukkan ke workbook yang sama.

Setelah Klik Impor Data

Jika file sudah lolos pemeriksaan:

semua baris tanpa error akan dibuat sebagai data baru
relasi pasangan dibuat setelah anggota keluarga berhasil dibuat
relasi anak dibuat setelah pasangan berhasil dibuat
perubahan baru masuk ke keluarga setelah Anda menekan Impor data

Jika proses apply gagal di tengah jalan, status import akan berubah menjadi gagal dan data dari file itu tidak dianggap selesai diterapkan.

Lihat juga: