Cài đặt Documentize thông qua NuGet

Cách Cài Đặt Thông Qua Console Trình Quản Lý Gói NuGet

1. Mở Dự Án Của Bạn:

   • Khởi động Visual Studio và mở ứng dụng .NET của bạn.

2. Truy Cập Console Trình Quản Lý Gói:

   • Điều hướng đến Công cụ > Trình Quản Lý Gói NuGet > Console Trình Quản Lý Gói.

3. Cài Đặt Gói:

   • Để cài đặt phiên bản đầy đủ mới nhất, nhập lệnh Install-Package Documentize.
   • Để cài đặt phiên bản mới nhất bao gồm các bản sửa lỗi nóng, sử dụng Install-Package Documentize -prerelease.
   • Nhấn Enter để thực thi lệnh.

Cách Cập Nhật Gói Thông Qua Console Trình Quản Lý Gói NuGet

Nếu bạn đã cài đặt Documentize thông qua NuGet và muốn cập nhật lên phiên bản mới nhất:

1. Mở Dự Án Của Bạn:

   • Khởi động Visual Studio và mở ứng dụng .NET của bạn.

2. Truy Cập Console Trình Quản Lý Gói:

   • Điều hướng đến Công cụ > Trình Quản Lý Gói NuGet > Console Trình Quản Lý Gói.

3. Cập Nhật Gói:

   • Để cập nhật lên phiên bản đầy đủ mới nhất, nhập Update-Package Documentize.
   • Để cập nhật lên phiên bản mới nhất bao gồm các bản sửa lỗi nóng, sử dụng Update-Package Documentize -prerelease.
   • Nhấn Enter để thực thi lệnh.

Cách Cài Đặt Thông Qua Giao Diện Người Dùng Trình Quản Lý Gói NuGet

1. Mở Dự Án Của Bạn:

   • Khởi động Visual Studio và mở ứng dụng .NET của bạn.

2. Điều Hướng Đến Quản Lý Các Gói NuGet:

   • Từ menu Dự án, chọn Quản lý các gói NuGet.

3. Tìm Kiếm Documentize:

   • Đi đến tab Duyệt và nhập Documentize vào ô tìm kiếm.

4. Cài Đặt Gói:

   • Nhấn Cài đặt/Cập nhật bên cạnh phiên bản mới nhất của Documentize.
   • Xác nhận bằng cách nhấn Chấp nhận trong cửa sổ pop-up.

Ưu Điểm Của Việc Sử Dụng NuGet

• Quản Lý Phụ Thuộc Tự Động:

  • NuGet tự động xử lý các phụ thuộc, đảm bảo rằng tất cả các thư viện cần thiết được bao gồm và cập nhật chính xác. Điều này giảm nguy cơ thiếu hoặc không tương thích các phụ thuộc.

• Cập Nhật Đơn Giản:

  • Việc cập nhật các gói rất đơn giản với NuGet, qua Console Trình Quản Lý Gói hoặc giao diện người dùng. Điều này giúp dễ dàng giữ cho các thư viện của bạn cập nhật với các tính năng và sửa lỗi mới nhất.

• Tích Hợp Với Visual Studio:

  • NuGet được tích hợp liền mạch với Visual Studio, cung cấp một giao diện thân thiện cho việc quản lý các gói mà không cần rời khỏi môi trường phát triển.

• Quản Lý Phiên Bản:

  • NuGet cho phép bạn chỉ định và quản lý các phiên bản khác nhau của thư viện, giúp bạn dễ dàng quay lại các phiên bản trước hoặc thử nghiệm các phiên bản mới mà không gây gián đoạn cho việc phát triển.

Nhược Điểm Của Việc Sử Dụng NuGet

• Giới Hạn Trong Visual Studio:

  • NuGet chủ yếu được thiết kế để sử dụng trong Visual Studio. Mặc dù có thể sử dụng trong các môi trường khác, nhưng sự tích hợp là mạnh mẽ nhất trong Visual Studio.

• Khả Năng Xung Đột Phiên Bản:

  • Trong các dự án lớn với nhiều phụ thuộc, quản lý phiên bản và giải quyết xung đột có thể trở nên phức tạp. NuGet cung cấp các công cụ để quản lý điều này, nhưng cần phải chú ý cẩn thận.

• Phụ Thuộc Vào Mạng:

  • Việc cài đặt và cập nhật các gói yêu cầu kết nối internet. Nếu bạn đang làm việc trong một môi trường có hạn chế hoặc không có kết nối internet, bạn có thể cần sử dụng các phương pháp ngoại tuyến hoặc tải trước các gói.

• Phức Tạp Đối Với Các Dự Án Lớn:

  • Đối với các dự án rất lớn với các cây phụ thuộc rộng rãi, việc quản lý các gói qua NuGet có thể trở nên rườm rà. Trong những trường hợp như vậy, có thể cần thêm các công cụ hoặc chiến lược để quản lý hiệu quả các phụ thuộc.

Cài đặt Documentize qua ZIP

Cách cài đặt qua tệp lưu trữ ZIP

1. Tải xuống tệp lưu trữ ZIP:

   • Nhấp vào v25.7 ZIP để tải xuống phiên bản mới nhất của Documentize dưới dạng tệp lưu trữ.

2. Giải nén nội dung:

   • Sau khi tải xuống, giải nén nội dung của tệp ZIP vào một thư mục tùy chọn của bạn. Bạn có thể chọn giữ các tệp này trong một thư mục chia sẻ hoặc trong cấu trúc dự án của bạn.

3. Thêm tham chiếu vào dự án của bạn:

   • Mở dự án của bạn trong IDE (ví dụ: Visual Studio).
   • Đi tới Dự án > Thêm tham chiếu > Duyệt và tìm đến thư mục nơi bạn đã giải nén các tệp DLL.
   • Chọn các tệp DLL liên quan và thêm chúng làm tham chiếu cho dự án của bạn.

4. Cập nhật thủ công:

   • Nếu một phiên bản mới của Documentize được phát hành, bạn sẽ cần tải xuống thủ công tệp lưu trữ ZIP đã cập nhật và thay thế các tệp DLL cũ trong dự án của bạn bằng các tệp mới.

Ưu điểm của việc sử dụng tệp lưu trữ ZIP

• Kiểm soát hoàn toàn:

  • Bạn có quyền kiểm soát hoàn toàn về nơi và cách các tệp DLL được lưu trữ và tham chiếu trong dự án của bạn. Điều này có thể hữu ích nếu bạn ưa thích một thiết lập tùy chỉnh hoặc cần quản lý các phụ thuộc một cách thủ công.

• Không phụ thuộc vào trình quản lý gói:

  • Khác với NuGet, bạn không phụ thuộc vào một trình quản lý gói để xử lý việc cài đặt. Điều này có thể thuận lợi trong các môi trường mà trình quản lý gói không có sẵn hoặc không được ưa chuộng.

• Tính di động:

  • Tệp lưu trữ ZIP có thể dễ dàng được chia sẻ và di chuyển giữa các hệ thống khác nhau, rất lý tưởng cho các dự án cần tính di động hoặc phân phối mà không cần phụ thuộc vào các công cụ bên ngoài.

Nhược điểm của việc sử dụng tệp lưu trữ ZIP

• Quản lý thủ công:

  • Khác với NuGet, nơi các bản cập nhật và quản lý phụ thuộc là tự động, với tệp lưu trữ ZIP, bạn phải quản lý các bản cập nhật thủ công và đảm bảo rằng tất cả các tệp DLL cần thiết được tham chiếu chính xác.

• Nguy cơ xung đột phiên bản:

  • Nếu bạn quản lý nhiều dự án hoặc làm việc trong một nhóm, có nguy cơ xung đột phiên bản nếu các dự án khác nhau sử dụng các phiên bản khác nhau của các tệp DLL. Điều này đòi hỏi phải theo dõi cẩn thận các phiên bản giữa các dự án.

• Không có bản cập nhật tự động:

  • Bạn sẽ không nhận được các bản cập nhật tự động hoặc thông báo khi có phiên bản mới. Điều này có thể dẫn đến nguy cơ sử dụng các thư viện lỗi thời trừ khi bạn thường xuyên kiểm tra để cập nhật.

Cài đặt Documentize thông qua MSI

Cách cài đặt thông qua trình cài đặt MSI

1. Tải xuống trình cài đặt MSI:

   • Nhấp vào v25.7 MSI để tải xuống trình cài đặt MSI cho phiên bản mới nhất của Documentize.

2. Chạy trình cài đặt:

   • Nhấp đúp vào tệp MSI đã tải xuống để khởi động trình hướng dẫn cài đặt.

3. Theo dõi trình hướng dẫn cài đặt:

   • Theo dõi các hướng dẫn trên màn hình do trình cài đặt cung cấp. Bạn có thể cần đồng ý với thỏa thuận cấp phép và chọn các tùy chọn cài đặt.

4. Hoàn thành cài đặt:

   • Khi cài đặt hoàn tất, các DLL của Documentize sẽ được cài đặt vào Bộ nhớ toàn cầu của hệ thống (GAC) hoặc một vị trí xác định khác.

5. Xác minh cài đặt:

   • Kiểm tra xem các DLL đã được cài đặt đúng cách bằng cách xác minh sự hiện diện của chúng trong thư mục cài đặt chỉ định hoặc GAC.

Ưu điểm của việc sử dụng trình cài đặt MSI

• Dễ sử dụng:

  • Trình cài đặt MSI cung cấp quy trình cài đặt đơn giản và có hướng dẫn. Nó xử lý tất cả các cấu hình cần thiết và đặt các DLL ở một vị trí trung tâm, giúp dễ dàng sử dụng Documentize trong nhiều dự án.

• Cài đặt toàn hệ thống:

  • Phương pháp MSI cài đặt Documentize vào Bộ nhớ toàn cầu của hệ thống (GAC) hoặc một vị trí trung tâm khác. Điều này cho phép bất kỳ ứng dụng nào trên hệ thống truy cập các DLL mà không cần tham chiếu riêng lẻ trong mỗi dự án.

• Cập nhật tự động:

  • Nếu Documentize cung cấp trình cài đặt cập nhật, bạn có thể dễ dàng cập nhật cài đặt của mình bằng cách chạy tệp MSI mới, thường thì quy trình cập nhật sẽ diễn ra suôn sẻ.

• Tính nhất quán:

  • Sử dụng trình cài đặt MSI đảm bảo rằng tất cả các tệp cần thiết được cài đặt đúng cách và nhất quán trên các môi trường khác nhau, giảm thiểu nguy cơ thiếu hoặc đặt sai các DLL.

Nhược điểm của việc sử dụng trình cài đặt MSI

• Tính linh hoạt hạn chế:

  • Trình cài đặt MSI cài đặt Documentize vào một vị trí toàn hệ thống, điều này có thể không phù hợp với tất cả các môi trường phát triển. Nó có thể thiếu tính linh hoạt để đáp ứng các cấu hình hoặc phiên bản cụ thể của dự án.

• Chi phí bổ sung tiềm ẩn:

  • Cài đặt các DLL vào GAC có thể gây ra chi phí bổ sung và phức tạp, đặc biệt trong các tình huống mà nhiều phiên bản của Documentize có thể cần cùng lúc.

• Gỡ cài đặt thủ công:

  • Nếu bạn cần gỡ cài đặt Documentize, bạn phải sử dụng trình gỡ cài đặt do MSI cung cấp, điều này có thể để lại các tệp hoặc cấu hình dư thừa nếu không được quản lý đúng cách.

• Xung đột phiên bản:

  • Cài đặt toàn hệ thống có thể dẫn đến xung đột phiên bản nếu các dự án khác nhau yêu cầu các phiên bản khác nhau của Documentize. Quản lý những xung đột này có thể yêu cầu cấu hình hoặc dọn dẹp bổ sung.

Môi trường không phải Windows

Làm việc với .NET Core DLLs trong môi trường không phải Windows

Vì Documentize cho .NET cung cấp hỗ trợ .NET Standard 2.0 (.NET Core 2.0), nó có thể được sử dụng trong các ứng dụng Core chạy trên các hệ điều hành giống như Linux. Chúng tôi đang không ngừng cải thiện hỗ trợ .NET Core trong API của chúng tôi. Tuy nhiên, có một số thao tác mà chúng tôi khuyến nghị khách hàng thực hiện để có kết quả tốt hơn khi sử dụng các tính năng của Documentize cho .NET. Vui lòng cài đặt:

• gói libgdiplus
• Gói với font tương thích với Microsoft: ttf-mscorefonts-installer (ví dụ: sudo apt-get install ttf-mscorefonts-installer). Những font này nên được đặt trong thư mục /usr/share/fonts/truetype/msttcorefonts vì Documentize cho .NET quét thư mục này trên các hệ điều hành giống như Linux. Trong trường hợp hệ điều hành có thư mục/thư mục mặc định khác cho font, bạn nên sử dụng dòng mã sau trước khi thực hiện bất kỳ thao tác nào sử dụng Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<đường dẫn của người dùng đến các font ms>"));

v24.12

Đã thêm Plugin mới: Bộ chuyển đổi PDF sang PNG

• Class PngConverter: Đại diện cho plugin Documentize.PngConverter. Được sử dụng để chuyển đổi tài liệu PDF thành định dạng PNG.
• Class PdfToPngOptions: Đại diện cho các tùy chọn bộ chuyển đổi PDF sang PNG cho plugin Documentize.PngConverter.

Ví dụ Sử dụng:

// tạo PngConverter
var plugin = new PngConverter();
// tạo đối tượng PdfToPngOptions để thiết lập hướng dẫn
var opt = new PdfToPngOptions();
// thêm đường dẫn tệp đầu vào
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// thiết lập đường dẫn tệp đầu ra
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// thực hiện quá trình
plugin.Process(opt);

Đã thêm Plugin mới: Bộ chuyển đổi PDF sang TIFF

• Class TiffConverter: Đại diện cho plugin Documentize.TiffConverter. Được sử dụng để chuyển đổi tài liệu PDF thành định dạng TIFF.
• Class PdfToTiffOptions: Đại diện cho các tùy chọn bộ chuyển đổi PDF sang TIFF cho plugin Documentize.TiffConverter.

Ví dụ Sử dụng:

// tạo TiffConverter
var plugin = new TiffConverter();
// tạo đối tượng PdfToTiffOptions để thiết lập hướng dẫn
var opt = new PdfToTiffOptions();
// thêm đường dẫn tệp đầu vào
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// thiết lập đường dẫn tệp đầu ra
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// thực hiện quá trình
plugin.Process(opt);

Đã thêm Plugin mới: Trình tạo bảng PDF

• Class TableGenerator: Đại diện cho plugin Documentize.TableGenerator. Được sử dụng để thêm bảng vào tài liệu PDF.
• Class TableBuilder: Lớp đại diện cho bộ xây dựng bảng trong trang pdf.
• Class TableRowBuilder: Lớp đại diện cho bộ xây dựng hàng bảng.
• Class TableCellBuilder: Lớp đại diện cho bộ xây dựng ô bảng.

Ví dụ Sử dụng:

// tạo TableGenerator
var plugin = new TableGenerator();
// tạo đối tượng TableOptions để thiết lập hướng dẫn
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Name")
            .AddCell().AddParagraph("Age")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// thêm đường dẫn tệp đầu vào
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// thiết lập đường dẫn tệp đầu ra
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// thực hiện quá trình
plugin.Process(opt);

Đã đổi tên Class PdfDoc thành DocConverter

• Class DocConverter: Đại diện cho plugin Documentize.DocConverter. Được sử dụng để chuyển đổi tài liệu PDF thành định dạng DOC/DOCX.

Ví dụ Sử dụng:

// tạo DocConverter
var plugin = new DocConverter();
// tạo đối tượng PdfToDocOptions để thiết lập hướng dẫn
var opt = new PdfToDocOptions();
// thêm đường dẫn tệp đầu vào
opt.AddInput(new FileDataSource(inputPath));
// thiết lập đường dẫn tệp đầu ra
opt.AddOutput(new FileDataSource(outputPath));
// thực hiện quá trình
plugin.Process(opt);

v24.11

Thêm Plugin mới: Trình chuyển đổi PDF sang JPEG

• Mục đích: Lớp JpegConverter được thiết kế để chuyển đổi tài liệu PDF thành định dạng JPEG, giúp người dùng dễ dàng xử lý và chia sẻ hình ảnh được lấy từ PDF.
• Constructor:
  • JpegConverter(): Khởi tạo một thể hiện mới của trình chuyển đổi JPEG.

Ví dụ sử dụng:

var plugin = new JpegConverter();  
var opt = new PdfToJpegOptions();  
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));  
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));  
plugin.Process(opt);  

• Phương thức:
  • Process(PdfToJpegOptions options): Bắt đầu quá trình chuyển đổi JPEG sử dụng các tùy chọn đã chỉ định.

Thêm Lớp DirectoryDataSource

• Mục đích: Lớp DirectoryDataSource cho phép người dùng quản lý dữ liệu thư mục cho các thao tác tải và lưu trong các plugin.
• Constructor:
  • DirectoryDataSource(string path): Khởi tạo một đối tượng dữ liệu thư mục mới với đường dẫn đã chỉ định.

Ví dụ sử dụng:

var directorySource = new DirectoryDataSource("path_to_your_directory");  

• Thuộc tính:
  • DataType: Lấy loại nguồn dữ liệu.
  • Path: Lấy đường dẫn của thư mục dữ liệu hiện tại.

Thêm Lớp PdfToJpegOptions

• Mục đích: Lớp này chứa các tùy chọn để cấu hình quá trình chuyển đổi JPEG, cho phép người dùng chỉ định độ phân giải, danh sách trang và chất lượng hình ảnh.
• Constructor:
  • PdfToJpegOptions(): Khởi tạo một thể hiện tùy chọn mới cho trình chuyển đổi JPEG.

Thuộc tính:

• OutputResolution: Chỉ định độ phân giải của các hình ảnh JPEG kết quả.
• PageList: Danh sách các trang để chuyển đổi từ PDF.
• Quality: Đặt chất lượng của đầu ra JPEG.

v24.10

Đã thêm Plugin mới: Bộ chuyển đổi PDF/A

• Một tính năng chuyển đổi PDF/A mới được giới thiệu, cho phép người dùng dễ dàng chuyển đổi các tệp PDF tiêu chuẩn thành tài liệu tuân thủ PDF/A.

Ví dụ Sử Dụng:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

Sửa lỗi

• Đã sửa các vấn đề liên quan đến lớp FileResult dẫn đến đường dẫn đầu ra không chính xác.
• Đã giải quyết một số lỗi nhỏ ảnh hưởng đến HtmlConverter khi xử lý các tệp lớn.

Cải tiến

• Cải thiện hiệu suất của PdfExtractor và ImageExtractor để thời gian xử lý nhanh hơn.
• Cập nhật lớp RotateOptions để hỗ trợ thêm các góc xoay.

v24.9

Đã phát hành