Impor pengguna
Admin Sentra bisa membuat atau memperbarui banyak akun sekaligus dari berkas CSV, lengkap dengan peran di aplikasi Anda. Halaman ini untuk pemilik aplikasi yang menyiapkan berkasnya bersama admin Sentra.
Sebelum mulai
Hanya admin Sentra yang bisa menjalankan impor. Sebagai pemilik aplikasi, Anda menyiapkan berkas dan menerima hasilnya.
- Buat peran di katalog Peran aplikasi aplikasi Anda di konsol, misalnya
siswadanpengajar. - Beri tahu admin Sentra App ID aplikasi Anda (
app_…) dan kunci perannya. - Siapkan berkas CSV dengan format di bawah, atau mulai dari templat.
Format berkas
- CSV dengan encoding UTF-8. BOM boleh ada.
- Dipisah koma atau titik koma. Sentra memilih pemisah dari baris judul.
- Baris pertama berisi judul kolom. Urutan kolom bebas; kolom yang tidak dipakai boleh dihilangkan, kecuali
namedan salah satu dariusernameatauemail. - Maksimal 2.000 baris data dan 2 MB. Baris kosong dilewati.
- Kolom yang tidak dikenal atau muncul dua kali membuat seluruh berkas ditolak.
| Kolom | Wajib | Isi |
|---|---|---|
username | Username atau email | 3–64 karakter: huruf kecil, angka, titik, garis bawah, atau tanda hubung. Boleh hanya angka. Huruf besar diubah menjadi kecil. |
email | Username atau email | Opsional jika ada username. Tanpa username, username dibuat dari email, sama seperti saat mendaftar. |
name | Ya | Nama lengkap, maksimal 120 karakter. |
app_id | Bersama role | App ID aplikasi Anda. |
role | Bersama app_id | Kunci peran dari katalog aplikasi itu. |
user_type | Tidak | Kunci tipe pengguna yang aktif. Akun baru tanpa tipe mendapat tipe bawaan (biasanya umum). |
Satu orang dengan beberapa peran ditulis dalam beberapa baris, satu baris per peran. Baris dengan username yang sama (atau email yang sama jika tanpa username) dihitung sebagai satu akun, jadi nama dan emailnya harus sama di semua baris itu.
username,email,name,app_id,role,user_type
2024001,,Budi Santoso,app_9fk2mq7xlr4tzw8nb3vh5cyd,siswa,
2024001,,Budi Santoso,app_9fk2mq7xlr4tzw8nb3vh5cyd,asisten,
,rina.putri@contoh.id,Rina Putri,,,
nur.aini,nur.aini@contoh.id,Nur Aini,app_9fk2mq7xlr4tzw8nb3vh5cyd,pengajar,Mode Buat dan Perbarui
Admin memilih mode saat mengunggah. Akun dicocokkan berdasarkan username jika diisi, jika tidak berdasarkan email.
| Keadaan | Buat | Perbarui |
|---|---|---|
| Akun belum ada | Baru | Baru |
| Akun sudah ada, dibuat admin atau lewat impor | Diblokir | Diperbarui |
| Akun sudah ada, didaftarkan sendiri oleh penggunanya | Diblokir | Diblokir |
| Baris tidak valid, atau email sudah dipakai akun lain | Gagal | Gagal |
- Baru: akun dibuat dengan kata sandi awal acak, tipe dari berkas atau tipe bawaan, dan peran aplikasi dari berkas.
- Diperbarui: nama diambil dari berkas, begitu juga email jika diisi; peran aplikasi dan tipe pengguna ditambahkan, tidak pernah dihapus. Kata sandi tidak diubah.
- Diblokir: akun tidak diubah. Di mode Buat, jalankan ulang dengan mode Perbarui jika memang ingin mengubahnya. Akun yang didaftarkan sendiri oleh penggunanya tidak pernah diubah oleh impor.
- Gagal: baris punya masalah, misalnya username atau email tidak valid, nama kosong,
app_idtidak ditemukan, peran tidak ada di katalog, atau tipe pengguna tidak dikenal. Alasannya ditulis per akun.
Pratinjau, lalu konfirmasi
- Unggah. Sentra memeriksa setiap baris tanpa mengubah akun apa pun, lalu menampilkan ringkasan baru, diperbarui, diblokir, dan gagal beserta alasannya.
- Konfirmasi. Admin membaca ringkasan lalu mengonfirmasi. Pratinjau berlaku 30 menit; setelah itu berkasnya harus diunggah ulang.
Saat konfirmasi, setiap akun diperiksa ulang karena data bisa berubah sejak pratinjau. Akun yang hasilnya berubah ditandai di hasil.
Hasil
Setelah konfirmasi, admin mengunduh hasil sebagai CSV, satu baris per akun:
username,email,name,sentra_id,outcome,initial_password,note
2024001,,Budi Santoso,8f3a1c52-7d0e-4b6a-9c21-5e7f0a3d9b14,new,Hq7m-Pk4r-T9zw,
rina.putri,rina.putri@contoh.id,Rina Putri,,blocked,,Akun sudah ada. Jalankan ulang dengan mode Perbarui untuk mengubahnya.| Kolom | Isi |
|---|---|
username | Username akun, termasuk yang dibuat dari email. |
email, name | Dari berkas. |
sentra_id | ID akun untuk akun baru dan yang diperbarui. Kosong untuk yang diblokir dan gagal. |
outcome | new, updated, blocked, atau failed. |
initial_password | Kata sandi awal akun baru. |
note | Alasan untuk akun yang diblokir atau gagal. |
Kemudian, admin bisa mengunduh daftar Sentra ID dari halaman impor itu kapan saja: kolomnya sama, tanpa initial_password. Berkas inilah yang Anda pakai di aplikasi. Jangan simpan berkas berisi kata sandi di aplikasi Anda.
Butuh sentra_id untuk akun yang diblokir di mode Buat? Jalankan berkas yang sama dengan mode Perbarui: setiap akun buatan admin atau impor yang ditemukan muncul sebagai diperbarui, dengan sentra_id-nya. Akun yang didaftarkan sendiri tetap diblokir; tautkan akun itu saat penggunanya masuk.
Tautkan pengguna lama
Simpan sentra_id dari daftar Sentra ID ke pengguna lokal, supaya pengguna langsung dikenali saat masuk pertama kali. Cocokkan baris dengan pengguna lokal berdasarkan data yang Anda tulis sendiri di berkas impor, misalnya username. Contoh perintah Artisan:
// routes/console.php
use App\Models\User;
use Illuminate\Support\Facades\Artisan;
Artisan::command('sentra:link {file}', function (string $file) {
$csv = new SplFileObject($file);
$csv->setFlags(SplFileObject::READ_CSV | SplFileObject::SKIP_EMPTY | SplFileObject::READ_AHEAD);
$header = null;
$linked = 0;
foreach ($csv as $row) {
if ($header === null) {
$header = array_map(fn ($h) => trim($h, "\u{FEFF} "), $row);
continue;
}
$r = array_combine($header, $row);
if ($r['sentra_id'] === '') {
continue;
}
$linked += User::where('username', $r['username'])
->whereNull('sentra_id')
->update(['sentra_id' => $r['sentra_id']]);
}
$this->info("{$linked} pengguna ditautkan.");
});php artisan sentra:link storage/app/impor-sentra-id.csvSetelah itu aplikasi Anda mencari pengguna hanya berdasarkan sentra_id, seperti di Data pengguna.