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.

  1. Buat peran di katalog Peran aplikasi aplikasi Anda di konsol, misalnya siswa dan pengajar.
  2. Beri tahu admin Sentra App ID aplikasi Anda (app_…) dan kunci perannya.
  3. 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 name dan salah satu dari username atau email.
  • Maksimal 2.000 baris data dan 2 MB. Baris kosong dilewati.
  • Kolom yang tidak dikenal atau muncul dua kali membuat seluruh berkas ditolak.
KolomWajibIsi
usernameUsername atau email3–64 karakter: huruf kecil, angka, titik, garis bawah, atau tanda hubung. Boleh hanya angka. Huruf besar diubah menjadi kecil.
emailUsername atau emailOpsional jika ada username. Tanpa username, username dibuat dari email, sama seperti saat mendaftar.
nameYaNama lengkap, maksimal 120 karakter.
app_idBersama roleApp ID aplikasi Anda.
roleBersama app_idKunci peran dari katalog aplikasi itu.
user_typeTidakKunci 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.

KeadaanBuatPerbarui
Akun belum adaBaruBaru
Akun sudah ada, dibuat admin atau lewat imporDiblokirDiperbarui
Akun sudah ada, didaftarkan sendiri oleh penggunanyaDiblokirDiblokir
Baris tidak valid, atau email sudah dipakai akun lainGagalGagal
  • 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_id tidak ditemukan, peran tidak ada di katalog, atau tipe pengguna tidak dikenal. Alasannya ditulis per akun.

Pratinjau, lalu konfirmasi

  1. Unggah. Sentra memeriksa setiap baris tanpa mengubah akun apa pun, lalu menampilkan ringkasan baru, diperbarui, diblokir, dan gagal beserta alasannya.
  2. 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.
KolomIsi
usernameUsername akun, termasuk yang dibuat dari email.
email, nameDari berkas.
sentra_idID akun untuk akun baru dan yang diperbarui. Kosong untuk yang diblokir dan gagal.
outcomenew, updated, blocked, atau failed.
initial_passwordKata sandi awal akun baru.
noteAlasan untuk akun yang diblokir atau gagal.
Kata sandi awal hanya ada di unduhan pertama, tepat setelah konfirmasi. Sentra tidak menyimpannya dan tidak bisa menampilkannya lagi. Kata sandi berlaku 7 hari dan wajib diganti saat pengguna pertama kali masuk. Jika hilang, admin mengatur ulang kata sandi per akun.

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.csv

Setelah itu aplikasi Anda mencari pengguna hanya berdasarkan sentra_id, seperti di Data pengguna.