Daftar isi
Di mana dan siapa yang menggunakanSebelum memulaiLangkah 1 — Pemeriksaan FirebirdSQLLangkah 2 — Berkas sumberSiapkan cadangan UTF-8 dan hubungkan / Uji koneksiLangkah 3 — Inventaris tabel dan opsiLangkah 4 — Migrasi dan kemajuanLangkah 5 — Hasil dan rekonsiliasiPanel pemeliharaanKesalahan yang sering munculDi LinuxMigrasi data dari program lama (Firebird): Pengaturan › Migrasi data
Data program lama Anda (FirebirdSQL) — kartu pelanggan dan stok, faktur, surat jalan, cek, resep, gambar, dan dokumen — dipindahkan ke HNR setelah Anda masuk, melalui bagian Pengaturan › Migrasi data (dari program lama). Wizard Pengaturan Awal tidak lagi memindahkan data. Bagian ini hanya terlihat oleh administrator sistem; di ponsel (antarmuka Taman + Langkah) alur yang sama dibuka langkah demi langkah.
Buat perusahaan terlebih dahulu dengan wizard: data dipindahkan ke perusahaan yang sudah ada; bagian ini tidak membuat perusahaan baru. Buat cadangan perusahaan tujuan sebelum migrasi. Basis data program lama hanya dibaca: tidak satu baris pun berubah selama migrasi.
Di mana dan siapa yang menggunakan
Pengaturan › Migrasi data (dari program lama). Bagian ini hanya dilihat dan digunakan oleh administrator sistem; pengguna tanpa izin Administrator melihat pesan “Impor data hanya untuk administrator sistem.” Jika server dalam mode hanya-baca (gerbang tulis tertutup), migrasi tidak dimulai.
Tombol “Impor data dari perusahaan lama” di wizard Pengaturan Awal tidak lagi memindahkan data; tombol itu hanya menampilkan catatan informasi: buat perusahaan terlebih dahulu, lalu setelah masuk buka Pengaturan › Migrasi data.
Di ponsel (antarmuka Taman + Langkah) bagian yang sama dibuka langkah demi langkah: setiap langkah adalah layar tersendiri, tombolnya cukup besar untuk diketuk dengan nyaman, dan tabel tampil sebagai kartu.
Sebelum memulai
- Perusahaan tujuan harus sudah ada. Buat perusahaan dengan wizard Pengaturan Awal dan masuk sebagai administrator.
- Buat cadangan perusahaan tujuan. Migrasi menulis banyak catatan ke perusahaan; sediakan cadangan yang dapat Anda gunakan jika terjadi masalah.
- FirebirdSQL 3.0, 4.0, atau 5.0 harus terpasang dan berjalan di komputer ini. Langkah 1 memeriksanya.
- Berkas cadangan (.FBK) atau basis data (.FDB) program lama harus dapat diakses dari komputer ini. Jika ada basis data gambar dan dokumen (EK1), simpan di folder yang sama.
- Siapkan kata sandi SYSDBA (bawaan
masterkeyjika tidak diubah saat Firebird dipasang). Jika Anda akan memilih cadangan (.FBK), sisakan ruang disk kosong sekitar 4 kali ukuran cadangan.
Langkah 1 — Pemeriksaan FirebirdSQL
Saat halaman dibuka, halaman memeriksa apakah FirebirdSQL terpasang di komputer ini, apakah berjalan, dan versinya. Data program lama dibaca dengan FirebirdSQL di komputer ini: server-nya adalah komputer ini (localhost), port 3050 (atau nilai RemoteServicePort di firebird.conf jika diubah saat pemasangan), dan penggunanya SYSDBA. Semua itu tidak ditanyakan; hanya kata sandi yang diminta.
| Situasi | Yang harus dilakukan |
|---|---|
| Belum terpasang. Layar menampilkan “Pasang FirebirdSQL terlebih dahulu.” dan Anda tidak dapat melanjutkan. | Pasang FirebirdSQL 3.0, 4.0, atau 5.0 dari tautan “Halaman unduhan FirebirdSQL” (firebirdsql.org) dengan pengaturan bawaan (port 3050, SYSDBA); lalu tekan “Periksa ulang”. |
| Terpasang tetapi layanannya tidak berjalan. Peringatan juga menampilkan versi dan port. | Buka Layanan (Services) Windows dan jalankan layanan “Firebird Server - DefaultInstance”; lalu tekan “Periksa ulang”. |
| Versi tidak didukung. Muncul peringatan “Versi FirebirdSQL ini tidak didukung”. | Pasang FirebirdSQL 3.0, 4.0, atau 5.0. |
| Siap. Bingkai hijau menampilkan “FirebirdSQL terpasang dan berjalan”, lengkap dengan versi, localhost:port, dan SYSDBA. | Lanjut ke langkah 2 dengan “Lanjutkan”. |
Langkah ini juga menampilkan peringatan “Buat cadangan perusahaan tujuan sebelum mengimpor.” Jika migrasi pernah dijalankan sebelumnya, tombol “Tampilkan hasil impor terakhir” membuka hasil tersebut.
Langkah 2 — Berkas sumber
Tombol Pilih berkas membuka jendela buka berkas Windows. Pilih cadangan (.FBK) atau basis data (.FDB) program lama; ekstensi .BAK dan .GDB juga diterima. Berkas dengan jenis lain ditolak (KAYNAK_DOSYA_TURU).
Untuk EK1 (basis data gambar dan dokumen; misalnya HESAP_EK1.FBK atau HESAP.FDB_EK1.FBK) tidak ada pilihan kedua: berkas ini ditemukan otomatis di folder yang sama, dan di bawah pilihan Anda tertulis “EK1 ditemukan”. Jika tidak ditemukan, muncul peringatan “EK1 tidak ditemukan, hanya berkas utama yang akan diimpor (gambar dan dokumen tidak diimpor)”; letakkan EK1 di folder yang sama dengan berkas utama lalu pilih berkas itu lagi.
Saat HNR berjalan sebagai layanan Windows, berkas dipilih melalui jendela pemilih berkas milik peramban. Dalam kasus itu, pilih berkas EK1 bersama berkas utama (dengan tombol Ctrl) di jendela yang sama. Berkas yang dipilih disalin, dengan indikator persen, ke folder migrasi di komputer ini (aktarim\kaynak); berkas asli tidak disentuh.
Jalan pintas untuk berkas besar: untuk cadangan berukuran beberapa GB, salin dulu berkas utama dan berkas EK1 ke folder migrasi di komputer ini (aktarim\kaynak; jalur lengkapnya tertulis di bawah tombol sebelum berkas dipilih), lalu pilih hanya berkas utama dengan Pilih berkas. Berkas dengan nama dan ukuran yang sama yang sudah ada di folder tidak disalin lagi; layar menampilkan “Berkas sudah ada di folder impor; tidak disalin lagi.” dan EK1 ditemukan otomatis di folder yang sama. Berkas besar yang diunggah dari peramban dikirim per bagian.
Setelah memilih berkas, hanya kata sandi SYSDBA yang dimasukkan. SYSDBA / masterkey adalah nilai awal Firebird; jika kata sandi diubah saat Firebird dipasang, masukkan kata sandi Anda sendiri.
Siapkan cadangan UTF-8 dan hubungkan / Uji koneksi
Jika Anda memilih cadangan (.FBK), tombolnya menjadi Siapkan cadangan UTF-8 dan hubungkan. Cadangan dibuka di server (“Memulihkan cadangan…”), dikonversi ke UTF-8, dan isinya diverifikasi (“Konversi UTF-8 dan verifikasi isi…”); kemajuan ditampilkan dengan jumlah tabel dan baris. Salinan yang lolos verifikasi dipakai sebagai sumber, dan cadangan asli tetap utuh. Pekerjaan ini membutuhkan ruang disk kosong sekitar 4 kali ukuran cadangan.
Jika Anda memilih basis data (.FDB), tombolnya menjadi Uji koneksi: tombol ini menyambung ke sumber dan menampilkan versi, jumlah tabel, serta apakah EK1 ditemukan. Jika berhasil, tertulis “Terhubung · versi … · … tabel” dan tombol Baca inventaris menjadi aktif.
Langkah 3 — Inventaris tabel dan opsi
Baca inventaris menampilkan semua tabel di sumber; tidak ada yang dilewati secara diam-diam. Setiap tabel datang dengan salah satu dari empat keputusan:
| Keputusan | Artinya |
|---|---|
| objek | Kartu/dokumen dibuat dari tabel dan disimpan melalui jalur tulis perusahaan sendiri (mis. MUSTERI → kartu pelanggan). |
| salin | Jika tabel dengan nama yang sama ada di tujuan, kolom yang sama disalin baris demi baris. |
| turunan | Tidak disalin: nilai seperti saldo pelanggan dan stok tersedia dibuat ulang oleh jalur tulis. |
| lewati | Tabel sistem atau log. |
Opsi migrasi ditetapkan pada langkah yang sama:
- Uji coba (tidak ada yang ditulis): mencoba migrasi tanpa menulis ke tujuan; Anda melihat jumlah dan kemungkinan kesalahan lebih dulu. Disarankan melakukan uji coba sekali sebelum migrasi sebenarnya.
- Impor juga arsip dokumen terhapus dan Impor juga riwayat pergerakan: ikut memindahkan cadangan dokumen terhapus program lama dan tabel pergerakan historisnya.
- Impor gambar dan dokumen (EK1): jika EK1 ditemukan, berkas gambar dan dokumen juga ikut dipindahkan.
- Lanjutkan meski tujuan sudah berisi data: jika perusahaan tujuan sudah berisi catatan, migrasi berhenti secara bawaan (
HEDEF_DOLU); centang hanya jika Anda tahu apa yang dilakukan dan sudah membuat cadangan. - Ukuran batch: jumlah catatan yang diproses migrasi sekaligus (1–5000, bawaan 200).
Nomor dokumen dipertahankan: nomor faktur, cek, dan bukti di sumber tetap sama persis di tujuan. Jika sumber yang sama dimigrasikan untuk kedua kalinya, tidak ada catatan ganda yang ditulis; yang sudah ada dilewati.
Langkah 4 — Migrasi dan kemajuan
Mulai impor memulai migrasi di server. Layar menampilkan tahap, persentase, dan waktu berjalan, jumlah kartu/dokumen/tertulis/dilewati/gagal per tabel, jumlah berkas, serta baris terakhir log migrasi; jika mesin memakai beberapa thread, jumlah dan rinciannya juga ditampilkan.
Migrasi berjalan di server: pekerjaan tidak berhenti meskipun Anda menutup jendela ini atau peramban. Saat Anda membuka halaman lagi, migrasi yang sedang berjalan ditemukan dan kemajuannya ditampilkan. Hentikan menghentikan pekerjaan dan menampilkan “Impor dihentikan.”
Langkah 5 — Hasil dan rekonsiliasi
Saat migrasi selesai, tertulis “Impor selesai.” dan tabel rekonsiliasi membandingkan sumber dengan tujuan: saldo pelanggan, stok tersedia, cek, faktur, resep, dan berkas. Setiap baris menampilkan item, sumber, tujuan, selisih, dan status (Cocok / Penyimpangan / Penyimpangan yang diketahui); hasil per tabel, durasi, contoh kesalahan baris, dan jumlah koreksi otomatis juga ditampilkan.
Jika rekonsiliasi menunjukkan penyimpangan, layar menampilkan “Impor selesai — TETAPI rekonsiliasi menunjukkan penyimpangan.” dan mencantumkan ukuran yang menyimpang. Periksa tabel rekonsiliasi sebelum memakai perusahaan hasil migrasi; Anda dapat mengambil laporan sebagai PDF dengan tombol Laporan rekonsiliasi sistem lama · PDF, atau mencetaknya dengan Cetak.
Contoh baris yang menimbulkan kesalahan dicantumkan di bawah “Contoh kesalahan baris”; jika migrasi tidak dapat diselesaikan, lihat log migrasi untuk rinciannya.
Panel pemeliharaan
Panel Pemeliharaan di bawah langkah 2 menyediakan dua operasi:
- Perbaiki saldo terbuka: jika jumlah sisa (saldo terbuka) kosong pada faktur yang berasal dari program lama, jumlah itu dihitung ulang dari pergerakan pelanggan. “Pratinjau” ditampilkan lebih dulu dan tidak ada yang ditulis (jumlah faktur yang akan berubah, total sebelum dan sesudah, pelanggan yang dilewati); jika sudah sesuai, tekan “Terapkan perbaikan”.
- Isi ulang kamus: menambahkan baris terjemahan antarmuka yang belum ada; terjemahan yang diedit manual tidak berubah. Bisa memakan waktu beberapa menit; jangan tutup jendela ini.
Kesalahan yang sering muncul
Pesan kesalahan menampilkan rincian dari server dan, dalam tanda kurung, sebuah kode kesalahan; misalnya “Alat persiapan cadangan belum dikonfigurasi di server. — gbak/gfix not found (KAYNAK_HAZIRLIK_AYAR)”. Sebutkan kode tersebut saat menghubungi dukungan.
| Kode | Arti dan solusi |
|---|---|
FIREBIRD_KURULU_DEGIL | “FirebirdSQL tidak terpasang di komputer ini.” Pasang FirebirdSQL 3.0, 4.0, atau 5.0 lalu tekan “Periksa ulang”. |
FIREBIRD_CALISMIYOR | FirebirdSQL terpasang tetapi servernya tidak berjalan. Jalankan layanan “Firebird Server - DefaultInstance” dari Layanan Windows lalu periksa ulang. |
KAYNAK_KIMLIK | “Nama pengguna atau kata sandi database sumber ditolak.” Masukkan lagi kata sandi SYSDBA; jika kata sandi diubah saat Firebird dipasang, masukkan kata sandi itu (bawaan masterkey). |
KAYNAK_HAZIRLIK_AYAR | “Alat persiapan cadangan belum dikonfigurasi di server.” Jika rinciannya berbunyi gbak/gfix not found, FirebirdSQL belum terpasang; jika berbunyi Firebird server not running, jalankan layanan Firebird. Periksa pemasangan dan layanannya lalu coba lagi; jika berlanjut, teruskan kode ke tim dukungan. |
KAYNAK_HAZIRLIK_DISK | “Ruang disk tidak cukup untuk memulihkan cadangan dan membuat salinan UTF-8.” Kosongkan ruang sekitar 4 kali ukuran cadangan pada disk tempat folder migrasi berada, lalu coba lagi. |
KAYNAK_YEDEK_GECERSIZ | “Berkas bukan cadangan Firebird FBK/BAK yang valid.” Berkas mungkin rusak atau berjenis lain; buat ulang cadangan dari program lama lalu pilih, atau pilih berkas FDB. |
KAYNAK_DOSYA_TURU | “Hanya berkas basis data atau cadangan Firebird yang dapat dipilih (.fbk, .fdb, .bak, .gdb).” Pilih berkas dengan ekstensi yang sesuai; jangan memilih berkas EK1 sebagai berkas utama. |
HEDEF_DOLU | “Perusahaan tujuan sudah berisi data.” Jika perusahaan sudah pernah dipakai, membuat perusahaan baru lebih aman; jika Anda sengaja melanjutkan, buat cadangan terlebih dahulu dan centang “Lanjutkan meski tujuan sudah berisi data” pada langkah 3. |
Hanya satu migrasi yang dapat berjalan dalam satu perusahaan pada satu waktu (“Impor data sedang berjalan untuk perusahaan ini.”). Jika server dalam mode hanya-baca (“Gerbang tulis nonaktif: server sedang hanya-baca”), migrasi tidak dimulai.
Di Linux
FirebirdSQL dipasang dari pengelola paket distribusi Anda atau dari firebirdsql.org. Alat gbak dan gfix harus ada di PATH atau di bawah /opt/firebird; langkah selanjutnya sama seperti di Windows.
Panduan terkait: Pemasangan, Pengaturan, Pembersihan data.
Panduan terkait
- Pengaturan dan Log — Menyesuaikan Program dengan AndaJendela Pengaturan menyimpan dua jenis pengaturan berdampingan: yang milik Anda sendiri (tema, tata letak jendela, pintasan) dan yang memengaruhi operasi.
- Pembersihan Data — Panduan dari NolSelama bertahun-tahun, pelanggan yang sama dibuat dua tiga kali ("ABC Ltd. Şti." dan "ABC LİMİTED ŞİRKETİ"), sekrup yang sama dimasukkan dengan dua kode.
- Saya memakainya sendiri: mulai dalam 10 menitUntuk toko, bengkel kecil atau pekerja lepas yang memakai program sendirian: langkah dari instalasi sampai faktur pertama dan akhir bulan.
- Buku Pegangan Pengguna PraktisHalaman ini dibuat agar karyawan yang baru pertama memakai program dapat menyelesaikan pekerjaan harian dengan aman. Baca dulu aturan umum di sini.
- Hari Pertama — Untuk Anda yang Baru Pertama Kali Memakai Program IniIni halaman pertama yang sebaiknya dibaca semua orang dan memakan sepuluh menit. Di sini kami tidak mengajarkan akuntansi, hanya cara mengendalikan layar.
- Rantai Dokumen — Tulang Punggung ProgramPanduan ini bukan tentang satu jendela, melainkan tentang kaitan antar jendela. Kekosongan sebenarnya di benak pendatang baru bukan "tombol ini untuk apa.