﻿========================================================================

Ứng dụng sao lưu SharePoint

Exceed One Backup
             cho SharePoint và OneDrive

Sản xuất và bán phần mềm: Exceed One Co., Ltd.

========================================================================

Tài liệu này giải thích về "Exceed One Backup" ("EOB"),
cách sử dụng EOB và các thông tin quan trọng khác.

Để biết thêm về các tính năng mới nhất của sản phẩm, vui lòng truy cập
trang web của Exceed One Co., Ltd. ("Exceed One").


------------------------------------------------------------------------
Mục lục
------------------------------------------------------------------------

1. Tổng quan ứng dụng
2. Yêu cầu hệ thống
3. Phiên bản sản phẩm
4. Điều khoản cấp phép phần mềm
5. Cách sử dụng EOB
6. Liên hệ / Mua hàng
7. Khác
8. Lịch sử cập nhật


------------------------------------------------------------------------
1. Tổng quan ứng dụng
------------------------------------------------------------------------

EOB sao lưu dữ liệu từ "SharePoint Online" và "OneDrive for Business"
vào bộ nhớ cục bộ theo cấp độ tệp.

[Tổng quan chức năng]
 - Lưu tài liệu, tệp và tham chiếu cơ sở dữ liệu trong trang web
 - Lưu các thành phần trang web có cùng bố cục vào thư mục do EOB tạo
 - Xuất nội dung cơ sở dữ liệu đã chọn sang tệp XML rồi lưu


------------------------------------------------------------------------
2. Yêu cầu hệ thống
------------------------------------------------------------------------

SharePoint
 - SharePoint Online (Office 365)

Hệ điều hành
 - Microsoft Windows 10 (21H2 trở lên), 11
 - Microsoft Windows Server 2022 trở lên (Windows Server 2016 / 2019 không được hỗ trợ vì yêu cầu .NET Framework 4.8.1)

.NET Framework
 - .NET Framework 4.8.1


------------------------------------------------------------------------
3. Phiên bản sản phẩm
------------------------------------------------------------------------

EOB có các phiên bản với mức chức năng và cấp phép khác nhau.

[Phiên bản Free]
 - Phần mềm miễn phí
 - Phiên bản này có giới hạn chức năng.

[Phiên bản Professional]
 - Phiên bản trả phí.
 - Tất cả chức năng đều có sẵn, ngoại trừ:
   Trang cá nhân
   Trang nhóm

[Phiên bản Professional Plus]
 - Phiên bản trả phí.
 - Tất cả chức năng trong EOB đều có sẵn.


------------------------------------------------------------------------
4. Điều khoản cấp phép phần mềm
------------------------------------------------------------------------

Bạn phải chấp nhận "Điều khoản cấp phép phần mềm" để sử dụng
sản phẩm "EOB" này.
Nếu bạn không đồng ý, vui lòng không tải về và cài đặt EOB.
Tuy nhiên, phiên bản Free không áp dụng điều này.
Phiên bản Free áp dụng thỏa thuận cấp phép riêng.

[Thỏa thuận cấp phép riêng cho phiên bản Free]
Chúng tôi đồng ý cho bạn sử dụng "phiên bản Free" của EOB miễn phí.


------------------------------------------------------------------------
5. Cách sử dụng
------------------------------------------------------------------------

[Cài đặt]
 - Tạo một thư mục bất kỳ trên PC, sau đó sao chép thư mục đã giải nén
   của EOB vào đó.
 - Thiết lập để EOB truy cập SharePoint để sao lưu.
 - Đăng ký ứng dụng và thiết lập quyền truy cập EOB vào Azure AD.

[Gỡ cài đặt]
 - Xóa quyền truy cập EOB trong SharePoint và hủy kết nối SharePoint
   khỏi giấy phép người dùng hợp lệ.
 - Xóa ứng dụng EOB khỏi Azure AD.
 - Nếu bạn đã đăng ký giấy phép EOB, hãy hủy kết nối ứng dụng khỏi
   giấy phép người dùng hợp lệ.
   Bạn có thể hủy đăng ký giấy phép từ menu ứng dụng "Hủy đăng ký".
 - Xóa tất cả tệp và thư mục đã tạo khi cài đặt EOB.

[Mật khẩu chứng chỉ]
 - Chứng chỉ tạo bằng "Tạo chứng chỉ" (Certs\EOB.pfx) được bảo vệ bằng mật
   khẩu riêng cho PC này. Mật khẩu được tạo tự động, mã hóa bằng Windows (DPAPI)
   và lưu trong Certs\EOB.pfx.key. Không thể sử dụng trên PC khác; trên PC khác,
   hãy tạo lại chứng chỉ và đăng ký lại với Entra ID.
 - Chứng chỉ tạo bởi phiên bản cũ được bảo vệ bằng mật khẩu chung cho tất cả bản
   sao của sản phẩm. Hãy bảo vệ bằng mật khẩu riêng cho PC này bằng lệnh sau (cặp
   khóa không thay đổi, nên đăng ký Entra ID không thay đổi).
     EOBCmd.exe /c:EOBBatch.xml /protectcert

[Khôi phục (Professional trở lên)]
 Bạn có thể khôi phục tệp và danh sách đã sao lưu lên SharePoint từ dòng lệnh,
 về vị trí gốc, sang thư viện hoặc thư mục khác, hoặc sang thư viện mới.

 EOBCmd.exe /c:config /restore:folder /to:url
     [/ifexists:skip|overwrite|rename] [/dryrun | /yes] [/create] [/l:logfile]

   /restore:  Thư mục của thư viện, thư mục hoặc danh sách trong thư mục sao lưu
   /to:       URL của thư viện, thư mục hoặc danh sách SharePoint đích
   /ifexists: Khi có tệp cùng tên
              skip (mặc định) / overwrite / rename (lưu thành "tên (1).ext")
   /dryrun:   Chỉ kiểm tra. Hiển thị nội dung sẽ khôi phục; SharePoint không bị thay đổi
   /yes:      Thực hiện không hỏi (cho Task Scheduler và script)
   /create:   Tạo thư viện, thư mục hoặc danh sách đích nếu chưa có

 - Nếu không có /yes, kế hoạch sẽ được hiển thị trước (thư mục sẽ tạo, số tệp mới,
   ghi đè, đổi tên và bỏ qua, cùng danh sách tệp sẽ ghi đè), và hỏi "Thực hiện khôi
   phục? (Y/N)". Bất kỳ câu trả lời nào khác Y, hoặc không nhập, sẽ hủy khôi phục
   (mã thoát -41).
 - Ngày tạo và ngày cập nhật sẽ được khôi phục. Khi khôi phục về cùng site
   collection, người tạo và người cập nhật cũng được khôi phục (nếu người dùng tồn tại).
 - Khi đích là danh sách, các mục và tệp đính kèm được tạo lại từ XML đã lưu.
   Nếu danh sách đích chưa có, /create sẽ tạo danh sách và các cột (chỉ danh sách
   tùy chỉnh; định nghĩa cột _def_<tên danh sách>.xml được lưu bởi bản sao lưu từ
   phiên bản này trở đi).
 - Nếu bật lịch sử phiên bản, nội dung cũ của tệp bị ghi đè vẫn được giữ trong SharePoint.

 Ví dụ (kiểm tra trước, rồi xác nhận và thực hiện)
   EOBCmd.exe /c:EOBBatch.xml "/restore:c:\Backup\contoso_sharepoint_com\sites\Sales\Shared Documents"
              /to:https://contoso.sharepoint.com/sites/Sales/Restore /dryrun
   EOBCmd.exe /c:EOBBatch.xml "/restore:c:\Backup\contoso_sharepoint_com\sites\Sales\Shared Documents"
              /to:https://contoso.sharepoint.com/sites/Sales/Restore /create
   (Các ví dụ được ngắt dòng cho dễ đọc. Nhập mỗi lệnh trên một dòng.)

[Nhật ký hỗ trợ]
 Khi liên hệ hỗ trợ, bạn có thể tạo tệp zip chứa nhật ký gần đây và thông tin
 môi trường. Dữ liệu nhạy cảm như tên thuê, URL trang, tên người dùng và ID được
 tự động thay bằng bí danh.
 Bảng đối chiếu (EOBLogMap.txt) chỉ lưu trên PC của bạn; không nằm trong zip.

 Lệnh
   EOBCmd.exe /c:config /supportlog
   EOBCmd.exe /c:config /supportlog:output.zip

 Trong giao diện, dùng Trợ giúp > "Tạo nhật ký hỗ trợ...".
 Đăng nhập trước khi tạo nhật ký sẽ cải thiện độ chính xác của việc ẩn thông tin.


Để biết thêm thông tin, vui lòng xem hướng dẫn sử dụng EOB.


------------------------------------------------------------------------
6. Liên hệ / Mua hàng
------------------------------------------------------------------------

Nếu bạn muốn liên hệ về EOB và thắc mắc về giấy phép,
vui lòng xem trang web của chúng tôi.

Sản xuất và bán phần mềm: Exceed One Co., Ltd.

[Trang web]
http://www.exceedone.com/

[Trang sản phẩm]
http://www.exceedone.com/eob_en/


------------------------------------------------------------------------
7. Khác
------------------------------------------------------------------------

Tên công ty và tên sản phẩm trong tài liệu này là nhãn hiệu hoặc
nhãn hiệu đã đăng ký của các công ty tương ứng.


------------------------------------------------------------------------
8. Lịch sử cập nhật
------------------------------------------------------------------------
04/02/2015 ver 1.0.0
 - Phát hành

25/03/2015 ver 1.0.0.1
 - Sửa lỗi hiển thị

07/05/2015 ver 1.0.0.2
 - Thêm chức năng xóa khoảng trắng thừa từ giá trị nhập.

12/06/2015 ver 1.5.0
 - Thêm chức năng thực thi hàng loạt
 - Thêm chế độ tự động

26/08/2015 ver 1.6.0
 - Thêm phiên bản Professional Plus
 - Thêm gói không cần trung tâm quản trị SharePoint

01/03/2016 ver 1.7.0
 - Hỗ trợ thư viện tài liệu của nhóm

24/06/2016 ver 1.7.1
 - Tối ưu hóa quá trình tải xuống.
 - Hỗ trợ đường dẫn dài hơn 260 ký tự.
 - Hỗ trợ tệp lớn hơn 2GB.

30/01/2017 ver 1.7.2
 - Hỗ trợ tên tệp chứa dấu nháy đơn.

28/11/2018 ver 1.7.3
 - Hỗ trợ tên tệp chứa dấu thăng và phần trăm.

22/04/2020 ver 1.7.4
 - Hỗ trợ xác thực hiện đại. (SharePointOnlineCredentials --> AccessToken)

02/07/2021 ver 1.7.5
 - Hỗ trợ TLS 1.1 / 1.2
   Chuyển sang .NET Framework 4.6.0 (hỗ trợ TLS 1.1 / TLS 1.2)

31/10/2025 ver 2.0.1
 - Xác thực đổi sang xác thực dựa trên chứng chỉ.
   Trước: Microsoft Graph (Authorization Code + PKCE flow), SharePoint (Azure Access Control Services (ACS))
   Nay: Client Credentials flow sử dụng xác thực chứng chỉ.
   Lưu ý: Client Secret không thể sử dụng với SharePoint CSOM, nên đã chuyển sang chứng chỉ.
 - Nâng cấp lên .NET Framework 4.8.1 (từ .NET Framework 4.6.0).
   Lưu ý: .NET Framework 4.8.1 dựa vào SChannel của hệ điều hành cho TLS; khả năng sử dụng TLS 1.3 phụ thuộc vào phiên bản Windows và bản cập nhật.

17/07/2026 ver 2.0.2
 - Cải thiện tốc độ xử lý và sửa lỗi kết thúc bất thường do hết thời gian chờ.
   - Tối ưu hóa cách lấy access token.
   - Thiết lập thời gian chờ rõ ràng (10 phút mỗi lần) cho giao tiếp HTTP khi tải tệp.
   - Thêm tự động thử lại khi bị SharePoint Online điều tiết (HTTP 429/503) hoặc
     lỗi giao tiếp tạm thời.
 - Cải thiện nhật ký.
   - Khi xảy ra lỗi, thông tin chi tiết để khắc phục sự cố được ghi vào nhật ký.
   - Thêm tính năng xuất thông tin hiệu suất định kỳ.

29/07/2026 ver 2.0.3
 - Sửa lỗi kết thúc bất thường khi lấy thông tin danh sách SharePoint.
 - Sửa lỗi xử lý song song không có hiệu quả.
 - Cải thiện hiển thị lỗi cho thất bại do hết thời gian chờ.

31/07/2026 ver 2.0.4
 - Sửa lỗi tệp đính kèm danh sách không được sao lưu.
 - Sửa lỗi số lượng lỗi và danh sách SKIP gấp đôi thực tế trong phiên bản Free.

04/11/2026 ver 2.0.6
 - Khôi phục dễ dàng: Giờ đây bạn có thể khôi phục các tệp và danh sách đã sao lưu từ giao diện trở lại SharePoint.
	- Mở "Khôi phục" > "Khôi phục lên SharePoint" từ menu để mở hộp thoại khôi phục.
	- Chọn thư mục nguồn, URL đích và cách xử lý trùng tên
	  (bỏ qua / ghi đè / ghi đè nếu mới hơn / đổi tên).
	- Dùng nút "Duyệt" để chọn site và thư viện từ danh sách (Trình duyệt bản sao lưu).
	- "Chạy thử" cho phép xem trước nội dung khôi phục mà không ghi dữ liệu.
	- Hộp thoại tiến trình hiển thị số mục và thời gian; có thể hủy giữa chừng.
	- Các mục danh sách cũng có thể khôi phục (danh sách tùy chỉnh, giữ nguyên ngày tạo/sửa và tác giả).
	- Nếu thiếu cột trên danh sách đích, chúng sẽ được tạo tự động từ bản sao lưu (tùy chọn /CREATE).
	- Đo lường: 5.200 mục danh sách trong ~2 phút 17 giây, 455 tệp trong ~2 phút 40 giây (song song 4, thử nghiệm nội bộ).
	  * Tính năng này yêu cầu phiên bản Professional trở lên. Không khả dụng trong phiên bản Free.
 - Sao lưu nhanh hơn: Sao lưu lần 2 trở đi nhanh hơn đáng kể.
	- Danh sách không thay đổi được bỏ qua hoàn toàn (giảm ~95%).
	- Danh sách thay đổi chỉ tải các mục đã thay đổi (phương pháp change-token).
	- Siêu dữ liệu tệp đính kèm được tải cùng với dữ liệu mục (giảm số lần gọi).
	- Đo lường (8 danh sách, 5.690 mục, 460 tệp): lần đầu 38 giây → không thay đổi 2 giây, thay đổi một phần 4 giây.
 - Giao diện hiện đại: Cập nhật phông chữ Segoe UI, nút phẳng, bảng màu sáng hơn.
	- Hỗ trợ DPI cao (125%/150%) — điều khiển không còn mờ hoặc tràn.
 - Tìm kiếm cây: Lọc nhanh site và danh sách theo tên trong chế độ xem cây.
 - Bộ lọc loại site: Chọn loại site cần tải (Chung / OneDrive / Nhóm). Bỏ loại không cần giúp tải nhanh hơn.
 - Bộ nhớ đệm danh sách site: Ghi nhớ danh sách site trước đó để rút ngắn thời gian khởi động.
 - Cải thiện nhật ký:
	- Mức nhật ký thống nhất: Chuẩn / Chi tiết / Chẩn đoán. Có thể chọn "Chi tiết cho lần chạy tiếp theo".
	- Định dạng dòng nhất quán (ngày giờ, mức, ID luồng, thông báo) với tóm tắt cuối mỗi lần sao lưu.
 - Mật khẩu chứng chỉ giờ là mật khẩu ngẫu nhiên theo máy, được bảo vệ bằng DPAPI.
	- Chứng chỉ cũ vẫn hoạt động. Nhật ký sẽ hiện thông báo bảo vệ lại.
 - Đã xóa "Cài đặt kết nối" khỏi menu Cài đặt (kết nối qua nút "Lấy" thay thế).
 - Hiển thị thông báo hướng dẫn rõ ràng khi thiếu chứng chỉ hoặc sai mật khẩu.
 - Hỗ trợ giao diện tiếng Việt (Cài đặt → Ngôn ngữ → Tiếng Việt).
 - Sửa lỗi tùy chọn /L: trong chế độ batch (EOBCmd) không có tác dụng.

02/11/2026 ver 2.0.5
 - Giảm số lượng tệp phân phối (118 xuống 12).
 - EOB.exe và EOBCmd.exe được ký mã bởi Exceedone Co., Ltd.
 - Phiên bản EOBCmd.exe nay là 2.0.5, giống với EOB.exe.

[EOF]
