Cài bản cá nhân

Bản cá nhân chạy ngay trên máy Windows của bạn. Bạn giải nén file zip, bấm đúp SAP AddOns.exe, trình duyệt tự mở SAP AddOns. Không có bộ cài, không cần quyền quản trị máy (Administrator).

Dành cho: Người dùng một máy
License: Cá nhân
Cần: File zip SAP AddOns, mã license trong email

Trước khi bắt đầu

Máy chạy Windows 10 (bản 1803 trở lên) hoặc Windows 11, 64-bit.
Có file zip SAP AddOns (tên dạng SAP-AddOns-1.0.0-ca-nhan.zip) và email có mã license.
Lần đầu, máy cần vào được Internet để kích hoạt license. Sau đó mất mạng vẫn dùng được tối đa 7 ngày (xem Kích hoạt và quản lý license).
Muốn đăng nhập bằng cách SAP đang mở trên máy này (không cần mật khẩu): máy phải cài SAP Business One kèm DI API 64-bit. Đăng nhập bằng Service Layer thì không cần cài SAP Business One trên máy. Xem Đăng nhập bằng tài khoản SAP.

Nhiều người cùng dùng?

Bản cá nhân dành cho một người trên một máy. Công ty muốn nhiều nhân viên cùng dùng qua mạng thì cài bản dùng chung trên máy chủ IIS.

Các bước

Giải nénFile zip vào một thư mục, ví dụ C:\SAP-AddOns
Mở SAP AddOnsBấm đúp SAP AddOns.exe, trình duyệt tự mở
Kích hoạtDán mã license trong email
Đăng nhập SAPBằng tài khoản SAP Business One của bạn

Giải nén file zip
Bấm chuột phải vào file zip đã tải về → Extract All… (Giải nén tất cả), chọn thư mục, ví dụ C:\SAP-AddOns. Thư mục sau khi giải nén có file SAP AddOns.exe, file HUONG-DAN.txt và các thư mục app, iis.

Không chạy thẳng trong file zip
Nếu bấm đúp SAP AddOns.exe khi chưa giải nén, cửa sổ báo Chưa giải nén và không chạy. Đóng cửa sổ, giải nén rồi mở lại từ thư mục vừa giải nén.
Bấm đúp SAP AddOns.exe
Cửa sổ SAP AddOns mở ra, tự chạy ứng dụng và mở SAP AddOns trên trình duyệt mặc định. Lần đầu, cửa sổ báo Lần đầu mở: đã chọn cổng … và lưu lại cho các lần sau. Bạn không phải chọn cổng.

Nếu Windows hiện cảnh báo, xem mục Khi Windows cảnh báo bên dưới.
Kích hoạt license
Trình duyệt hiện màn Kích hoạt SAP AddOns. Dán mã license trong email vào ô Mã license rồi bấm Kích hoạt. Chi tiết: Kích hoạt và quản lý license.
Đăng nhập SAP
Bấm Tiếp tục đăng nhập SAP, rồi đăng nhập bằng user SAP Business One của bạn. Lần đầu bạn khai công ty SAP ngay ở màn đăng nhập. Chi tiết: Đăng nhập bằng tài khoản SAP.
Tạo biểu tượng trên màn hình
Trong cửa sổ SAP AddOns, bấm Tạo biểu tượng trên màn hình. Lần sau chỉ cần bấm đúp biểu tượng SAP AddOns trên màn hình.

Khi Windows cảnh báo

SAP AddOns là phần mềm mới, chưa có nhiều người tải, nên lần đầu mở Windows có thể hiện “Windows protected your PC” (Windows đã bảo vệ PC của bạn).

Bấm More info
Bấm dòng chữ More info (Thông tin thêm) trong hộp cảnh báo.
Bấm Run anyway
Bấm nút Run anyway (Vẫn chạy). Windows chỉ hỏi lần đầu.

Chắc chắn file đúng là của SAP AddOns

Trang tải có đăng mã SHA-256 của từng file zip. Đối chiếu trước khi giải nén nếu bạn hoặc IT của công ty muốn kiểm tra (cách làm ở mục Câu hỏi thường gặp).

Máy có phần mềm bảo mật do IT công ty quản lý

Một số phần mềm bảo mật doanh nghiệp chặn hoặc xóa phần mềm mới: Windows báo “Windows cannot access the specified device, path, or file” và file SAP AddOns.exe biến mất khỏi thư mục. Trường hợp này bấm Run anyway không giúp được. Nhờ IT của công ty cho phép SAP AddOns (gửi IT tên file và mã SHA-256 trên trang tải), rồi giải nén lại file zip.

Cửa sổ SAP AddOns

Cửa sổ SAP AddOns chạy ứng dụng trên máy bạn. Trang SAP AddOns trên trình duyệt chỉ dùng được khi cửa sổ này đang chạy.

Phần trên cửa sổ	Dùng để
● Đang chạy / ○ Đã dừng	Cho biết ứng dụng đang chạy hay đã dừng. Cạnh đó là phiên bản đang dùng.
Địa chỉ	Địa chỉ của SAP AddOns trên máy này, dạng `http://localhost:5361`. Chỉ mở được trên chính máy này.
Mở trình duyệt	Mở lại SAP AddOns trên trình duyệt mặc định, ví dụ khi lỡ đóng tab.
Sao chép liên kết	Dùng trình duyệt khác trên máy này: bấm nút, rồi dán vào thanh địa chỉ của trình duyệt đó trong 2 phút. Liên kết dùng được một lần; cần nữa thì bấm lại.
Dừng / Chạy	Dừng ứng dụng (trang trên trình duyệt không dùng được nữa) hoặc chạy lại.
Tạo biểu tượng trên màn hình	Tạo biểu tượng SAP AddOns trên màn hình. Đã có thì hiện ✓ Đã có biểu tượng trên màn hình.
Gỡ khỏi máy này…	Xóa dữ liệu SAP AddOns trên máy và biểu tượng (xem Chuyển máy hoặc gỡ).

Đóng cửa sổ sẽ dừng SAP AddOns. Khi bạn bấm dấu ×, cửa sổ hỏi lại: chọn Thu nhỏ nếu muốn ứng dụng vẫn chạy, Dừng và đóng nếu muốn tắt hẳn.
Đang ghi vào SAP thì không dừng được. Khi có lần import đang ghi, các nút Dừng, Gỡ khỏi máy này… và việc đóng cửa sổ bị từ chối với thông báo Đang có lần ghi vào SAP. Chờ lần ghi xong (xem tiến độ ở màn import) rồi làm lại.
Bấm đúp SAP AddOns.exe lần nữa khi cửa sổ đang mở: cửa sổ đang mở được đưa lên trước, không mở thêm cái thứ hai.
Cổng bị chương trình khác dùng: SAP AddOns tự chuyển sang cổng khác và báo Đã đổi sang cổng …. Địa chỉ cũ lưu trên trình duyệt không dùng được nữa, và các lựa chọn đã lưu trên trình duyệt (giao diện sáng / tối, menu thu gọn) về mặc định.

Mở SAP AddOns trên trình duyệt

Để người dùng Windows khác trên cùng máy không vào được, bản cá nhân chỉ nhận trình duyệt được mở từ cửa sổ SAP AddOns của bạn. Nếu bạn gõ địa chỉ bằng tay, mở từ dấu trang (bookmark), hoặc phiên làm việc đã hết, trình duyệt hiện trang Mở lại từ cửa sổ SAP AddOns.

Cách mở lại:

Trong cửa sổ SAP AddOns, bấm Mở trình duyệt (hoặc Sao chép liên kết rồi dán vào trình duyệt đang dùng).
Đã đóng cửa sổ: bấm đúp biểu tượng SAP AddOns trên màn hình (hoặc file SAP AddOns.exe trong thư mục đã giải nén). Trình duyệt sẽ tự mở.

Dữ liệu được lưu ở đâu

Thư mục giải nén chỉ chứa chương trình. Dữ liệu của bạn nằm riêng trong thư mục của người dùng Windows: %LOCALAPPDATA%\SAP AddOns. Ở đó có:

kết nối công ty SAP, máy chủ database và mật khẩu database đã lưu (được mã hóa);
file mẫu đã lưu và kết quả các lần import;
license đã kích hoạt;
nhật ký của cửa sổ: %LOCALAPPDATA%\SAP AddOns\logs\SAP AddOns.log (gửi cho bộ phận hỗ trợ khi được yêu cầu).

Mật khẩu SAP của bạn không được lưu ở đâu cả.

Nâng cấp lên bản mới

Chờ các lần ghi vào SAP chạy xong
Không nâng cấp giữa lúc đang import.
Dừng SAP AddOns
Trong cửa sổ SAP AddOns bấm Dừng, rồi đóng cửa sổ.
Giải nén bản mới đè lên thư mục cũ
Giải nén file zip bản mới vào đúng thư mục đang dùng (ví dụ C:\SAP-AddOns), chọn thay thế các file trùng tên.
Mở lại
Bấm đúp biểu tượng SAP AddOns. Kết nối, cấu hình và license được giữ nguyên.

Chuyển máy hoặc gỡ

Muốn dùng license ở máy khác

License vẫn gắn với máy này kể cả sau khi gỡ. Trước khi gỡ, vào Setting › License và bấm Hủy kích hoạt trên máy này… (cần Internet). Xem Đổi máy.

Bấm Gỡ khỏi máy này…
Trong cửa sổ SAP AddOns bấm Gỡ khỏi máy này…. Cửa sổ hỏi Gỡ SAP AddOns khỏi máy này? và liệt kê những gì sẽ bị xóa: kết nối công ty SAP, máy chủ database và mật khẩu đã lưu; file mẫu đã lưu, kết quả các lần import; biểu tượng trên màn hình.
Bấm Gỡ và xóa dữ liệu
Ứng dụng dừng và dữ liệu bị xóa. Cửa sổ báo Đã gỡ SAP AddOns khỏi máy này.
Xóa thư mục chương trình
Đóng cửa sổ, rồi xóa thư mục đã giải nén (ví dụ C:\SAP-AddOns).

Không khôi phục được

Dữ liệu đã xóa không lấy lại được. Việc gỡ không đụng tới dữ liệu trong SAP.

Lỗi thường gặp

Thông báo	Nguyên nhân	Cách sửa
Chưa giải nén	Bấm đúp SAP AddOns.exe ngay trong file zip.	Đóng cửa sổ, giải nén toàn bộ file zip (chuột phải → Extract All…), rồi mở SAP AddOns.exe trong thư mục vừa giải nén.
Thiếu thư mục app	Giải nén thiếu, hoặc thư mục `app` bị xóa / di chuyển.	Giải nén lại toàn bộ file zip SAP AddOns rồi mở lại.
“Windows protected your PC”	Windows chưa biết phần mềm mới này.	Bấm More info → Run anyway.
“Windows cannot access the specified device, path, or file”, SAP AddOns.exe biến mất	Phần mềm bảo mật của công ty đã đưa file vào cách ly.	Nhờ IT của công ty cho phép SAP AddOns, rồi giải nén lại.
SAP AddOns đang được một người dùng Windows khác trên máy này sử dụng	Bản cá nhân chỉ chạy cho một người dùng Windows trên một máy.	Nhờ người đó bấm Dừng trong cửa sổ SAP AddOns (hoặc đăng xuất Windows), rồi bấm Chạy. Cần nhiều người dùng: chuyển sang bản dùng chung.
Không chạy được SAP AddOns / SAP AddOns dừng bất thường	Ứng dụng không khởi động được hoặc dừng giữa chừng.	Bấm Chạy lại. Lặp lại thì gửi file nhật ký ghi trong thông báo (thư mục `%LOCALAPPDATA%\SAP AddOns\logs`) cho bộ phận hỗ trợ.
Trang Mở lại từ cửa sổ SAP AddOns	Trình duyệt không được mở từ cửa sổ, liên kết đã quá 2 phút hoặc đã được dùng, hoặc phiên đã hết.	Bấm Mở trình duyệt trong cửa sổ SAP AddOns.
Chưa tạo được biểu tượng	Windows không cho tạo biểu tượng trên màn hình.	Giữ phím `Alt` và kéo file SAP AddOns.exe ra màn hình để tạo biểu tượng.

Câu hỏi thường gặp

Có cần quyền quản trị máy (Administrator) không?

Không. Bản cá nhân giải nén là chạy, dữ liệu lưu trong thư mục của chính người dùng Windows.

Dùng trình duyệt khác với trình duyệt mặc định được không?

Được. Trong cửa sổ SAP AddOns bấm Sao chép liên kết, rồi dán vào thanh địa chỉ của trình duyệt đó trong vòng 2 phút.

Cài lại Windows hoặc đổi máy thì sao?

Cài lại Windows trên cùng máy: giải nén lại, mở SAP AddOns và nhập lại mã license, không tính là đổi máy. Đổi sang máy khác: hủy kích hoạt ở máy cũ trước. Xem Đổi máy.

Chi tiết cho IT: kiểm tra mã SHA-256 của file zip

Mở PowerShell trong thư mục có file zip và chạy:

Get-FileHash .\SAP-AddOns-1.0.0-ca-nhan.zip -Algorithm SHA256

So chuỗi ở cột Hash với mã SHA-256 đăng trên trang tải (không phân biệt chữ hoa, chữ thường). Khác nhau thì không dùng file đó; tải lại từ trang tải chính thức.

Giới hạn hiện tại

Không có bộ cài và không tự cập nhật: nâng cấp bằng cách giải nén bản mới đè lên thư mục cũ.
File chạy chưa có chữ ký số, nên Windows có thể cảnh báo lần đầu; phần mềm bảo mật doanh nghiệp có thể cần IT cho phép.
Một máy chỉ chạy một SAP AddOns bản cá nhân, cho một người dùng Windows tại một thời điểm.