Mục lục
Ở đâu và ai sử dụngTrước khi bắt đầuBước 1 — Kiểm tra FirebirdSQLBước 2 — Tệp nguồnChuẩn bị bản sao lưu ở UTF-8 và kết nối / Thử kết nốiBước 3 — Bản kiểm kê bảng và tùy chọnBước 4 — Chuyển dữ liệu và tiến độBước 5 — Kết quả và đối chiếuBảng điều khiển bảo trìCác lỗi thường gặpTrên LinuxChuyển dữ liệu từ chương trình cũ (Firebird): Cài đặt › Chuyển đổi dữ liệu
Dữ liệu của chương trình cũ (FirebirdSQL) — thẻ đối tác và thẻ hàng tồn kho, hóa đơn, phiếu giao hàng, séc, công thức, hình ảnh và tài liệu — được chuyển vào HNR sau khi bạn đăng nhập, tại mục Cài đặt › Chuyển đổi dữ liệu (từ chương trình cũ). Trình hướng dẫn Thiết lập ban đầu không còn chuyển dữ liệu nữa. Chỉ quản trị viên hệ thống mới thấy mục này; trên điện thoại (giao diện Garden + Steps), cùng quy trình đó được mở theo từng bước.
Trước tiên hãy tạo công ty bằng trình hướng dẫn: dữ liệu được chuyển vào một công ty đã được tạo sẵn; mục này không tạo công ty mới. Hãy sao lưu công ty đích trước khi chuyển dữ liệu. Cơ sở dữ liệu của chương trình cũ chỉ được đọc: không một dòng nào bị thay đổi trong quá trình chuyển.
Ở đâu và ai sử dụng
Cài đặt › Chuyển đổi dữ liệu (từ chương trình cũ). Chỉ quản trị viên hệ thống mới thấy và sử dụng mục này; người dùng không có quyền Quản trị viên sẽ thấy thông báo “Việc nhập dữ liệu chỉ dành cho quản trị hệ thống.” Nếu máy chủ đang ở chế độ chỉ đọc (cổng ghi đóng), việc chuyển dữ liệu sẽ không bắt đầu.
Nút “Nhập cơ sở dữ liệu (chuyển dữ liệu từ công ty cũ)” trong trình hướng dẫn Thiết lập ban đầu không còn chuyển dữ liệu; nút này chỉ hiển thị một ghi chú thông tin: hãy tạo công ty trước, sau khi đăng nhập thì mở mục Cài đặt › Chuyển đổi dữ liệu.
Trên điện thoại (giao diện Garden + Steps), cùng mục đó được mở theo từng bước: mỗi bước là một màn hình riêng, các nút đủ lớn để chạm thoải mái bằng ngón tay và các bảng được hiển thị dưới dạng thẻ.
Trước khi bắt đầu
- Công ty đích phải được tạo sẵn. Hãy tạo công ty bằng trình hướng dẫn Thiết lập ban đầu và đăng nhập với tư cách quản trị viên.
- Hãy sao lưu công ty đích. Việc chuyển dữ liệu ghi rất nhiều bản ghi vào công ty; hãy có sẵn một bản sao lưu để có thể quay lại nếu xảy ra sự cố.
- Máy tính này phải đã cài đặt và đang chạy FirebirdSQL 3.0, 4.0 hoặc 5.0. Bước 1 sẽ kiểm tra điều này.
- Tệp sao lưu (.FBK) hoặc tệp cơ sở dữ liệu (.FDB) của chương trình cũ phải truy cập được từ máy tính này. Nếu có cơ sở dữ liệu hình ảnh và tài liệu (EK1), tệp đó phải nằm trong cùng thư mục.
- Hãy chuẩn bị sẵn mật khẩu SYSDBA (mặc định là
masterkeynếu không được thay đổi khi cài Firebird). Nếu bạn sẽ chọn bản sao lưu (.FBK), hãy để trống dung lượng đĩa khoảng 4 lần kích thước bản sao lưu.
Bước 1 — Kiểm tra FirebirdSQL
Khi trang mở ra, hệ thống kiểm tra xem FirebirdSQL đã được cài trên máy tính này chưa, có đang chạy không và là phiên bản nào. Dữ liệu của chương trình cũ được đọc bằng FirebirdSQL trên máy tính này: máy chủ là máy tính này (localhost), cổng là 3050 (nếu đã thay đổi khi cài đặt thì là giá trị trong tệp firebird.conf, mục RemoteServicePort) và người dùng là SYSDBA. Những thông tin này không được hỏi; chỉ cần nhập mật khẩu.
| Tình huống | Cần làm gì |
|---|---|
| Chưa cài đặt. Màn hình hiển thị “Hãy cài đặt FirebirdSQL trước.” và bạn không thể tiếp tục. | Cài đặt FirebirdSQL 3.0, 4.0 hoặc 5.0 từ liên kết “Trang tải xuống FirebirdSQL” (firebirdsql.org) với các thiết lập mặc định (cổng 3050, SYSDBA); sau đó nhấn “Kiểm tra lại”. |
| Đã cài đặt nhưng dịch vụ không chạy. Cảnh báo cũng hiển thị phiên bản và cổng. | Mở Windows Services (Dịch vụ) và khởi động dịch vụ “Firebird Server - DefaultInstance”; sau đó nhấn “Kiểm tra lại”. |
| Phiên bản không được hỗ trợ. Xuất hiện cảnh báo “Phiên bản FirebirdSQL này không được hỗ trợ”. | Hãy cài đặt FirebirdSQL 3.0, 4.0 hoặc 5.0. |
| Sẵn sàng. Khung màu xanh lá hiển thị “FirebirdSQL đã được cài đặt và đang chạy”, kèm phiên bản, localhost:cổng và SYSDBA. | Nhấn “Tiếp tục” để sang bước 2. |
Ở bước này còn xuất hiện cảnh báo “Hãy sao lưu công ty đích trước khi nhập dữ liệu.” Nếu trước đây đã từng chuyển dữ liệu, nút “Hiển thị kết quả lần nhập gần nhất” sẽ mở kết quả đó.
Bước 2 — Tệp nguồn
Nút Chọn tệp mở cửa sổ mở tệp của Windows. Hãy chọn bản sao lưu (.FBK) hoặc cơ sở dữ liệu (.FDB) của chương trình cũ; các phần mở rộng .BAK và .GDB cũng được chấp nhận. Tệp thuộc loại khác sẽ bị từ chối (KAYNAK_DOSYA_TURU).
Không cần chọn riêng EK1 (cơ sở dữ liệu hình ảnh và tài liệu; ví dụ HESAP_EK1.FBK hoặc HESAP.FDB_EK1.FBK): tệp này được tự động tìm thấy trong cùng thư mục và bên dưới lựa chọn của bạn sẽ hiện “Đã tìm thấy EK1”. Nếu không tìm thấy, cảnh báo “Không tìm thấy EK1, chỉ tệp chính được chuyển” xuất hiện và hình ảnh, tài liệu sẽ không được chuyển; hãy đặt EK1 vào cùng thư mục với tệp chính rồi chọn lại tệp.
Khi HNR chạy dưới dạng dịch vụ Windows, tệp được chọn bằng cửa sổ chọn tệp của chính trình duyệt. Khi đó, hãy chọn cả tệp EK1 cùng với tệp chính (bằng phím Ctrl) trong cùng một cửa sổ. Các tệp đã chọn được sao chép, kèm chỉ báo phần trăm, vào thư mục chuyển dữ liệu trên máy tính này (aktarim\kaynak); tệp gốc không bị đụng đến.
Cách nhanh cho tệp lớn: với bản sao lưu vài GB, trước tiên hãy sao chép tệp chính và tệp EK1 vào thư mục chuyển dữ liệu trên máy tính này (aktarim\kaynak; đường dẫn đầy đủ hiển thị dưới nút trước khi chọn tệp), sau đó chỉ chọn tệp chính bằng Chọn tệp. Tệp cùng tên và cùng kích thước đã có trong thư mục sẽ không được sao chép lại; màn hình hiện “Tệp đã có sẵn trong thư mục nhập dữ liệu; không sao chép lại.” và EK1 được tự động tìm thấy trong cùng thư mục. Các tệp lớn tải lên từ trình duyệt được gửi theo từng phần.
Sau khi chọn tệp, chỉ cần nhập mật khẩu SYSDBA. SYSDBA / masterkey là giá trị ban đầu của Firebird; nếu mật khẩu đã được thay đổi khi cài Firebird, hãy nhập mật khẩu của bạn.
Chuẩn bị bản sao lưu ở UTF-8 và kết nối / Thử kết nối
Nếu bạn chọn bản sao lưu (.FBK), nút sẽ trở thành Chuẩn bị bản sao lưu ở UTF-8 và kết nối. Bản sao lưu được khôi phục trên máy chủ (“Đang khôi phục bản sao lưu…”), được chuyển sang UTF-8 và nội dung được kiểm chứng (“Chuyển đổi UTF-8 và kiểm chứng nội dung…”); tiến độ được hiển thị bằng số bảng và số dòng. Bản sao vượt qua kiểm chứng được dùng làm nguồn, bản sao lưu gốc vẫn được giữ nguyên. Việc này cần dung lượng đĩa trống khoảng 4 lần kích thước bản sao lưu.
Nếu bạn chọn cơ sở dữ liệu (.FDB), nút sẽ trở thành Thử kết nối: nút này kết nối tới nguồn và hiển thị phiên bản, số bảng và việc có tìm thấy EK1 hay không. Khi thành công sẽ hiện “Đã kết nối · phiên bản … · … bảng” và nút Đọc bản kiểm kê được kích hoạt.
Bước 3 — Bản kiểm kê bảng và tùy chọn
Đọc bản kiểm kê liệt kê tất cả các bảng trong nguồn; không bảng nào bị bỏ sót một cách lặng lẽ. Mỗi bảng đi kèm một trong bốn quyết định:
| Quyết định | Ý nghĩa |
|---|---|
| đối tượng | Thẻ/chứng từ được tạo từ bảng và được lưu qua đường ghi riêng của công ty (ví dụ MUSTERI → thẻ đối tác). |
| sao chép | Nếu ở đích có bảng cùng tên, các cột chung được sao chép từng dòng một. |
| dẫn xuất | Không sao chép: các giá trị như số dư đối tác và tồn kho hiện có được đường ghi tạo lại. |
| bỏ qua | Bảng hệ thống hoặc bảng nhật ký. |
Các tùy chọn chuyển dữ liệu được thiết lập ở cùng bước này:
- Chạy thử (không ghi gì): thử chuyển dữ liệu mà không ghi vào đích; bạn xem trước được các con số và lỗi có thể xảy ra. Nên chạy thử một lần trước khi chuyển dữ liệu thật.
- Nhập cả kho lưu trữ chứng từ đã xóa và Nhập cả các phát sinh trong quá khứ: chuyển thêm bản lưu chứng từ đã xóa và các bảng phát sinh trong quá khứ của chương trình cũ.
- Nhập hình ảnh và tài liệu (EK1): nếu tìm thấy EK1, chuyển thêm các tệp hình ảnh và tài liệu.
- Tiếp tục dù ở đích đã có dữ liệu: nếu công ty đích đã có bản ghi, việc chuyển dữ liệu mặc định sẽ dừng (
HEDEF_DOLU); chỉ đánh dấu khi bạn biết rõ mình đang làm gì và đã sao lưu. - Kích thước lô xử lý: số bản ghi được xử lý mỗi lần (1–5000, mặc định 200).
Số chứng từ được giữ nguyên: số hóa đơn, séc và phiếu trong nguồn vẫn giữ y nguyên ở đích. Nếu chuyển cùng một nguồn lần thứ hai, không có bản ghi trùng lặp nào được ghi; các bản ghi đã có sẽ được bỏ qua.
Bước 4 — Chuyển dữ liệu và tiến độ
Bắt đầu nhập dữ liệu khởi động việc chuyển dữ liệu trên máy chủ. Màn hình hiển thị giai đoạn, phần trăm và thời gian đã trôi qua, số thẻ/chứng từ/đã ghi/đã bỏ qua/lỗi theo từng bảng, số tệp và những dòng cuối của nhật ký chuyển dữ liệu; nếu bộ máy dùng nhiều luồng, số luồng và chi tiết cũng được hiển thị.
Việc chuyển dữ liệu chạy trên máy chủ: dù bạn đóng cửa sổ này hay trình duyệt, công việc vẫn không dừng. Khi mở lại trang, lần chuyển đang chạy sẽ được tìm thấy và tiến độ được hiển thị. Dừng sẽ dừng công việc và hiển thị “Việc nhập dữ liệu đã bị dừng.”
Bước 5 — Kết quả và đối chiếu
Khi chuyển xong, màn hình hiển thị “Việc nhập dữ liệu đã hoàn tất.” và bảng đối chiếu so sánh nguồn với đích: số dư đối tác, tồn kho hiện có, séc, hóa đơn, công thức và tệp. Mỗi dòng hiển thị khoản mục, nguồn, đích, chênh lệch và trạng thái (Khớp / Sai lệch / Sai lệch đã biết); ngoài ra còn có kết quả theo từng bảng, thời gian, ví dụ lỗi dòng và số hiệu chỉnh tự động.
Nếu việc đối chiếu có sai lệch, màn hình hiển thị “Nhập dữ liệu đã xong — NHƯNG việc đối chiếu cho thấy có sai lệch.” và liệt kê các chỉ tiêu bị lệch. Hãy xem kỹ bảng đối chiếu trước khi sử dụng công ty đã chuyển; bạn có thể lấy báo cáo dạng PDF bằng nút Báo cáo đối chiếu với hệ thống cũ · PDF hoặc in bằng In.
Ví dụ về các dòng bị lỗi được liệt kê dưới mục “Ví dụ lỗi dòng”; nếu việc chuyển dữ liệu không hoàn tất được, hãy xem nhật ký chuyển dữ liệu để biết chi tiết.
Bảng điều khiển bảo trì
Bảng Bảo trì bên dưới bước 2 cung cấp hai thao tác:
- Sửa số dư còn mở: nếu số tiền còn lại (số dư còn mở) trên các hóa đơn đến từ chương trình cũ bị trống, số tiền này được tính lại từ các phát sinh của đối tác. Trước tiên “Xem trước” được hiển thị và không có gì được ghi (số hóa đơn sẽ thay đổi, tổng trước và sau, các đối tác bị bỏ qua); nếu thấy phù hợp, hãy nhấn “Áp dụng sửa chữa”.
- Nạp lại từ điển: bổ sung các dòng còn thiếu của bản dịch giao diện; các bản dịch đã được sửa thủ công không thay đổi. Việc này có thể mất vài phút; đừng đóng cửa sổ này.
Các lỗi thường gặp
Thông báo lỗi hiển thị chi tiết từ máy chủ và một mã lỗi trong ngoặc đơn; ví dụ “Các công cụ chuẩn bị bản sao lưu chưa được cấu hình trên máy chủ. — gbak/gfix not found (KAYNAK_HAZIRLIK_AYAR)”. Hãy cung cấp mã này khi liên hệ bộ phận hỗ trợ.
| Mã | Ý nghĩa và cách khắc phục |
|---|---|
FIREBIRD_KURULU_DEGIL | “FirebirdSQL chưa được cài đặt trên máy tính này.” Hãy cài FirebirdSQL 3.0, 4.0 hoặc 5.0 rồi nhấn “Kiểm tra lại”. |
FIREBIRD_CALISMIYOR | FirebirdSQL đã được cài nhưng máy chủ của nó không chạy. Hãy khởi động dịch vụ “Firebird Server - DefaultInstance” trong Windows Services (Dịch vụ) rồi kiểm tra lại. |
KAYNAK_KIMLIK | “Tên đăng nhập hoặc mật khẩu của cơ sở dữ liệu nguồn bị từ chối.” Hãy nhập lại mật khẩu SYSDBA; nếu mật khẩu đã được thay đổi khi cài Firebird, hãy nhập mật khẩu đó (mặc định là masterkey). |
KAYNAK_HAZIRLIK_AYAR | “Các công cụ chuẩn bị bản sao lưu chưa được cấu hình trên máy chủ.” Nếu phần chi tiết ghi gbak/gfix not found, nghĩa là FirebirdSQL chưa được cài; nếu ghi Firebird server not running, hãy khởi động dịch vụ Firebird. Kiểm tra việc cài đặt và dịch vụ rồi thử lại; nếu vẫn tiếp diễn, hãy chuyển mã lỗi cho đội hỗ trợ. |
KAYNAK_HAZIRLIK_DISK | “Không đủ dung lượng đĩa để khôi phục bản sao lưu và tạo bản sao UTF-8.” Hãy giải phóng dung lượng khoảng 4 lần kích thước bản sao lưu trên ổ đĩa chứa thư mục chuyển dữ liệu rồi thử lại. |
KAYNAK_YEDEK_GECERSIZ | “Tệp không phải là bản sao lưu Firebird FBK/BAK hợp lệ.” Tệp có thể bị hỏng hoặc thuộc loại khác; hãy tạo lại bản sao lưu từ chương trình cũ rồi chọn, hoặc chọn tệp FDB. |
KAYNAK_DOSYA_TURU | “Chỉ có thể chọn tệp cơ sở dữ liệu hoặc tệp sao lưu Firebird (.fbk, .fdb, .bak, .gdb).” Hãy chọn tệp có phần mở rộng phù hợp; không chọn tệp EK1 làm tệp chính. |
HEDEF_DOLU | “Công ty đích đã có dữ liệu.” Nếu công ty đã từng được sử dụng, tạo một công ty mới sẽ an toàn hơn; nếu bạn cố ý tiếp tục, hãy sao lưu trước và đánh dấu ô “Tiếp tục dù ở đích đã có dữ liệu” ở bước 3. |
Trong một công ty, mỗi lúc chỉ chạy được một lần chuyển dữ liệu (“Đang có một lần nhập dữ liệu chạy cho công ty này.”). Nếu máy chủ ở chế độ chỉ đọc (“Cổng ghi đang đóng”), việc chuyển dữ liệu sẽ không bắt đầu.
Trên Linux
FirebirdSQL được cài từ trình quản lý gói của bản phân phối bạn dùng hoặc từ firebirdsql.org. Các công cụ gbak và gfix phải nằm trong PATH hoặc dưới /opt/firebird; các bước còn lại giống như trên Windows.
Hướng dẫn liên quan: Cài đặt phần mềm, Cài đặt, Làm sạch dữ liệu.
Hướng dẫn liên quan
- Cài đặt và Đăng ký - Tạo chương trình của bạnCửa sổ Cài đặt đặt cạnh nhau hai loại: cài đặt chỉ của bạn, như giao diện, bố cục cửa sổ, phím tắt; và cài đặt ảnh hưởng hoạt động công ty, như tùy chọn HNR.
- Data Cleanup — A Guide from ScratchOver the years the same customer gets opened two or three times ("ABC Ltd. Şti." and "ABC LİMİTED ŞİRKETİ"), the same screw is entered under two different.
- Tôi dùng một mình: bắt đầu trong 10 phútDành cho cửa hàng, xưởng nhỏ hoặc người làm tự do dùng chương trình một mình: các bước từ cài đặt đến hóa đơn đầu tiên và cuối tháng.
- Hướng dẫn sử dụng thực tếTrang này là dành cho một nhân viên sử dụng chương trình lần đầu tiên và cần phải hoàn thành công việc hàng ngày một cách an toàn.
- Ngày đầu tiên của bạn - Đối với những người ngồi xuống chương trình lần đầu tiênĐây là trang đầu tiên mà mọi người nên đọc và cần phút. Chúng tôi không dạy kế toán ở đây, chỉ Cách di chuyển màn hình: làm thế nào cửa sổ mở.
- The Document Chain - Cấu hình của chương trìnhHướng dẫn này không phải là về một cửa sổ mà là về Các liên kết giữa cửa sổ. Sự ranh giới thực sự trong đầu của một người mới đến không phải là "cái gì nút.