Menginstal Documentize melalui NuGet

Cara Menginstal melalui Konsol Manajer Paket NuGet

1. Buka Proyek Anda:

   • Jalankan Visual Studio dan buka aplikasi .NET Anda.

2. Akses Konsol Manajer Paket:

   • Navigasikan ke Alat > Manajer Paket NuGet > Konsol Manajer Paket.

3. Instal Paket:

   • Untuk menginstal rilis penuh terbaru, masukkan perintah Install-Package Documentize.
   • Untuk menginstal rilis terbaru termasuk perbaikan cepat, gunakan Install-Package Documentize -prerelease.
   • Tekan Enter untuk mengeksekusi perintah.

Cara Memperbarui Paket melalui Konsol Manajer Paket NuGet

Jika Anda sudah menginstal Documentize melalui NuGet dan ingin memperbarui ke versi terbaru:

1. Buka Proyek Anda:

   • Jalankan Visual Studio dan buka aplikasi .NET Anda.

2. Akses Konsol Manajer Paket:

   • Navigasikan ke Alat > Manajer Paket NuGet > Konsol Manajer Paket.

3. Perbarui Paket:

   • Untuk memperbarui ke rilis penuh terbaru, masukkan Update-Package Documentize.
   • Untuk memperbarui ke rilis terbaru termasuk perbaikan cepat, gunakan Update-Package Documentize -prerelease.
   • Tekan Enter untuk mengeksekusi perintah.

Cara Menginstal melalui GUI Manajer Paket NuGet

1. Buka Proyek Anda:

   • Jalankan Visual Studio dan buka aplikasi .NET Anda.

2. Navigasi ke Kelola Paket NuGet:

   • Dari menu Proyek, pilih Kelola Paket NuGet.

3. Cari Documentize:

   • Pergi ke tab Telusuri dan masukkan Documentize ke dalam kotak pencarian.

4. Instal Paket:

   • Klik Instal/Pembaruan di samping versi terbaru dari Documentize.
   • Konfirmasikan dengan mengklik Terima di jendela pop-up.

Kelebihan Menggunakan NuGet

• Manajemen Ketergantungan Otomatis:

  • NuGet secara otomatis menangani ketergantungan, memastikan bahwa semua pustaka yang diperlukan disertakan dan diperbarui dengan benar. Ini mengurangi risiko ketergantungan yang hilang atau tidak kompatibel.

• Pembaruan yang Disederhanakan:

  • Memperbarui paket sangat sederhana dengan NuGet, baik melalui Konsol Manajer Paket atau GUI. Ini memudahkan untuk menjaga pustaka Anda tetap terbaru dengan fitur-fitur dan perbaikan bug terbaru.

• Terintegrasi dengan Visual Studio:

  • NuGet terintegrasi dengan baik di Visual Studio, menyediakan antarmuka yang ramah pengguna untuk mengelola paket tanpa meninggalkan lingkungan pengembangan.

• Versi:

  • NuGet memungkinkan Anda untuk menentukan dan mengelola berbagai versi pustaka, memungkinkan Anda dengan mudah kembali ke versi sebelumnya atau menguji rilis baru tanpa mengganggu pengembangan Anda.

Kekurangan Menggunakan NuGet

• Terbatas pada Visual Studio:

  • NuGet terutama dirancang untuk digunakan di dalam Visual Studio. Meskipun dapat digunakan di lingkungan lain, integrasinya paling kuat di Visual Studio.

• Kemungkinan Konflik Versi:

  • Dalam proyek yang lebih besar dengan banyak ketergantungan, mengelola versi dan menyelesaikan konflik bisa menjadi kompleks. NuGet menyediakan alat untuk mengelola ini, tetapi memerlukan perhatian yang cermat.

• Ketergantungan Jaringan:

  • Menginstal dan memperbarui paket memerlukan koneksi internet. Jika Anda bekerja di lingkungan dengan akses internet yang terbatas atau tidak ada, Anda mungkin perlu menggunakan metode offline atau mengunduh paket sebelumnya.

• Kompleksitas untuk Proyek Besar:

  • Untuk proyek yang sangat besar dengan pohon ketergantungan yang luas, beban pengelolaan paket melalui NuGet bisa menjadi merepotkan. Dalam kasus seperti itu, alat tambahan atau strategi mungkin diperlukan untuk mengelola ketergantungan secara efektif.

Menginstal Documentize melalui MSI

Cara Menginstal melalui Installer MSI

1. Unduh Installer MSI:

   • Klik v24.12 MSI untuk mengunduh installer MSI untuk versi terbaru dari Documentize.

2. Jalankan Installer:

   • Klik dua kali file MSI yang diunduh untuk meluncurkan panduan instalasi.

3. Ikuti Panduan Instalasi:

   • Ikuti petunjuk di layar yang diberikan oleh installer. Anda mungkin perlu menyetujui perjanjian lisensi dan memilih opsi instalasi.

4. Selesaikan Instalasi:

   • Setelah instalasi selesai, DLL Documentize akan diinstal ke dalam Global Assembly Cache (GAC) sistem Anda atau lokasi lain yang ditentukan.

5. Verifikasi Instalasi:

   • Periksa bahwa DLL telah terinstal dengan benar dengan memverifikasi keberadaannya di direktori instalasi yang ditentukan atau GAC.

Kelebihan Menggunakan Installer MSI

• Kemudahan Penggunaan:

  • Installer MSI menyediakan proses instalasi yang sederhana dan terarah. Ini menangani semua konfigurasi yang diperlukan dan menempatkan DLL di lokasi pusat, sehingga mudah untuk menggunakan Documentize di berbagai proyek.

• Instalasi Sistem secara Global:

  • Metode MSI menginstal Documentize ke dalam Global Assembly Cache (GAC) sistem atau lokasi pusat lainnya. Ini memungkinkan aplikasi mana pun di sistem untuk mengakses DLL tanpa perlu merujuknya secara individual di setiap proyek.

• Pembaruan Otomatis:

  • Jika Documentize menyediakan installer yang diperbarui, Anda dapat dengan mudah memperbarui instalasi Anda dengan menjalankan file MSI baru, yang biasanya menangani proses pembaruan dengan lancar.

• Konsistensi:

  • Menggunakan installer MSI memastikan bahwa semua file yang diperlukan diinstal dengan benar dan konsisten di berbagai lingkungan, mengurangi risiko DLL yang hilang atau salah tempat.

Kekurangan Menggunakan Installer MSI

• Fleksibilitas Terbatas:

  • Installer MSI menginstal Documentize ke lokasi global sistem, yang mungkin tidak cocok untuk semua lingkungan pengembangan. Ini mungkin kurang fleksibel untuk mengakomodasi konfigurasi atau versi spesifik proyek.

• Potensi Overhead:

  • Menginstal DLL ke GAC dapat memperkenalkan overhead dan kompleksitas, terutama dalam skenario di mana beberapa versi Documentize mungkin diperlukan secara bersamaan.

• Penghapusan Manual:

  • Jika Anda perlu mencopot pemasangan Documentize, Anda harus menggunakan penghapus yang disediakan oleh MSI, yang mungkin meninggalkan file atau konfigurasi residual jika tidak dikelola dengan baik.

• Konflik Versi:

  • Instalasi sistem secara global dapat menyebabkan konflik versi jika proyek yang berbeda memerlukan versi Documentize yang berbeda. Mengelola konflik ini mungkin memerlukan konfigurasi atau pembersihan tambahan.

Menginstal Documentize melalui ZIP

Cara Menginstal lewat Arsip ZIP

1. Unduh Arsip ZIP:

   • Klik v24.12 ZIP untuk mengunduh versi terbaru dari Documentize dalam format arsip.

2. Ekstrak Konten:

   • Setelah mengunduh, ekstrak isi file ZIP ke direktori pilihan Anda. Anda dapat memilih untuk menyimpan file ini di direktori bersama atau di dalam struktur proyek Anda.

3. Tambahkan Referensi ke Proyek Anda:

   • Buka proyek Anda di IDE Anda (misalnya, Visual Studio).
   • Pergi ke Proyek > Tambah Referensi > Telusuri dan navigasikan ke direktori tempat Anda mengekstrak DLL.
   • Pilih file DLL yang relevan dan tambahkan sebagai referensi ke proyek Anda.

4. Pembaruan Manual:

   • Jika versi baru dari Documentize dirilis, Anda perlu secara manual mengunduh arsip ZIP yang diperbarui dan mengganti file DLL lama di proyek Anda dengan yang baru.

Pro Menggunakan Arsip ZIP

• Kontrol Penuh:

  • Anda memiliki kontrol penuh atas di mana dan bagaimana DLL disimpan dan direferensikan dalam proyek Anda. Ini bisa menguntungkan jika Anda lebih suka pengaturan kustom atau perlu mengelola ketergantungan secara manual.

• Tidak Bergantung pada Manajer Paket:

  • Tidak seperti NuGet, Anda tidak bergantung pada manajer paket untuk menangani instalasi. Ini bisa menguntungkan di lingkungan di mana manajer paket tidak tersedia atau tidak diinginkan.

• Portabilitas:

  • Arsip ZIP dapat dengan mudah dibagikan dan dipindahkan ke berbagai sistem, menjadikannya ideal untuk proyek yang perlu berpindah atau disebarkan tanpa bergantung pada alat eksternal.

Kontra Menggunakan Arsip ZIP

• Pengelolaan Manual:

  • Tidak seperti NuGet, di mana pembaruan dan pengelolaan ketergantungan otomatis, dengan arsip ZIP, Anda harus secara manual mengelola pembaruan dan memastikan semua DLL yang diperlukan direferensikan dengan benar.

• Risiko Konflik Versi:

  • Jika Anda mengelola beberapa proyek atau bekerja dalam tim, ada risiko konflik versi jika proyek yang berbeda menggunakan versi DLL yang berbeda. Ini memerlukan pelacakan versi yang teliti di seluruh proyek.

• Tidak Ada Pembaruan Otomatis:

  • Anda tidak akan menerima pembaruan otomatis atau pemberitahuan saat versi baru tersedia. Ini dapat menyebabkan risiko menggunakan pustaka yang sudah usang kecuali Anda secara rutin memeriksa pembaruan.

Lingkungan Non-Windows

Bekerja dengan DLL .NET Core di Lingkungan Non-Windows

Karena Documentize untuk .NET menyediakan dukungan .NET Standard 2.0 (.NET Core 2.0), ia dapat digunakan dalam Aplikasi Core yang berjalan di sistem operasi mirip Linux. Kami terus bekerja untuk meningkatkan dukungan .NET Core di API kami. Namun, ada beberapa operasi yang kami rekomendasikan agar pelanggan kami lakukan untuk mendapatkan hasil yang lebih baik saat menggunakan fitur Documentize untuk .NET. Silakan instal:

• paket libgdiplus
• Paket dengan font yang kompatibel dengan Microsoft: ttf-mscorefonts-installer (misalnya, sudo apt-get install ttf-mscorefonts-installer). Font ini harus ditempatkan di direktori /usr/share/fonts/truetype/msttcorefonts karena Documentize untuk .NET memindai folder ini di sistem operasi mirip Linux. Jika sistem operasi memiliki folder/direktori default lain untuk font, Anda harus menggunakan baris kode berikut sebelum melakukan operasi apa pun menggunakan Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<jalur pengguna ke font ms>"));

v24.12

Plugin Baru Ditambahkan: Konverter PDF ke PNG

• Class PngConverter: Mewakili plugin Documentize.PngConverter. Digunakan untuk mengonversi dokumen PDF menjadi format PNG.
• Class PdfToPngOptions: Mewakili opsi konverter PDF ke PNG untuk plugin Documentize.PngConverter.

Contoh Penggunaan:

// buat PngConverter
var plugin = new PngConverter();
// buat objek PdfToPngOptions untuk mengatur instruksi
var opt = new PdfToPngOptions();
// tambahkan jalur file input
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// atur jalur file output
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// lakukan proses
plugin.Process(opt);

Plugin Baru Ditambahkan: Konverter PDF ke TIFF

• Class TiffConverter: Mewakili plugin Documentize.TiffConverter. Digunakan untuk mengonversi dokumen PDF menjadi format TIFF.
• Class PdfToTiffOptions: Mewakili opsi konverter PDF ke TIFF untuk plugin Documentize.TiffConverter.

Contoh Penggunaan:

// buat TiffConverter
var plugin = new TiffConverter();
// buat objek PdfToTiffOptions untuk mengatur instruksi
var opt = new PdfToTiffOptions();
// tambahkan jalur file input
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// atur jalur file output
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// lakukan proses
plugin.Process(opt);

Plugin Baru Ditambahkan: Pembuat Tabel PDF

• Class TableGenerator: Mewakili plugin Documentize.TableGenerator. Digunakan untuk menambahkan tabel ke dokumen PDF.
• Class TableBuilder: Kelas yang mewakili pembuat untuk tabel dalam halaman pdf.
• Class TableRowBuilder: Kelas yang mewakili pembuat untuk baris tabel.
• Class TableCellBuilder: Kelas yang mewakili pembuat untuk sel tabel.

Contoh Penggunaan:

// buat TableGenerator
var plugin = new TableGenerator();
// buat objek TableOptions untuk mengatur instruksi
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Nama")
            .AddCell().AddParagraph("Usia")
        .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");
// tambahkan jalur file input
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// atur jalur file output
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// lakukan proses
plugin.Process(opt);

Nama Kelas Diubah dari PdfDoc menjadi DocConverter

• Class DocConverter: Mewakili plugin Documentize.DocConverter. Digunakan untuk mengonversi dokumen PDF menjadi format DOC/DOCX.

Contoh Penggunaan:

// buat DocConverter
var plugin = new DocConverter();
// buat objek PdfToDocOptions untuk mengatur instruksi
var opt = new PdfToDocOptions();
// tambahkan jalur file input
opt.AddInput(new FileDataSource(inputPath));
// atur jalur file output
opt.AddOutput(new FileDataSource(outputPath));
// lakukan proses
plugin.Process(opt);

v24.11

Ditambahkan Plugin Baru: PDF ke JPEG Converter

• Tujuan: Kelas JpegConverter dirancang untuk mengonversi dokumen PDF ke format JPEG, memudahkan pengguna untuk menangani dan membagikan gambar yang diambil dari PDF.
• Konstruktor:
  • JpegConverter(): Menginisialisasi instance baru dari konverter JPEG.

Contoh Penggunaan:

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);

• Metode:
  • Process(PdfToJpegOptions options): Memulai proses konversi JPEG menggunakan opsi yang ditentukan.

Ditambahkan Kelas DirectoryDataSource

• Tujuan: Kelas DirectoryDataSource memungkinkan pengguna untuk mengelola data direktori untuk operasi pemuatan dan penyimpanan dalam plugin.
• Konstruktor:
  • DirectoryDataSource(string path): Menginisialisasi objek data direktori baru dengan jalur yang ditentukan.

Contoh Penggunaan:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• Properti:
  • DataType: Mengambil tipe sumber data.
  • Path: Mendapatkan jalur direktori data saat ini.

Ditambahkan Kelas PdfToJpegOptions

• Tujuan: Kelas ini berisi opsi untuk mengonfigurasi proses konversi JPEG, memungkinkan pengguna untuk menentukan resolusi, daftar halaman, dan kualitas gambar.
• Konstruktor:
  • PdfToJpegOptions(): Menginisialisasi instance opsi baru untuk konverter JPEG.

Properti:

• OutputResolution: Menentukan resolusi gambar JPEG yang dihasilkan.
• PageList: Daftar halaman yang akan dikonversi dari PDF.
• Quality: Mengatur kualitas output JPEG.

v24.10

Plugin Baru Ditambahkan: PDF/A Converter

• Fitur konversi PDF/A baru telah diperkenalkan, memungkinkan pengguna untuk dengan mudah mengonversi file PDF standar menjadi dokumen yang sesuai dengan PDF/A.

Contoh Penggunaan:

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);

Perbaikan Bug

• Memperbaiki masalah yang terkait dengan kelas FileResult yang mengakibatkan jalur output yang tidak benar.
• Menyelesaikan bug kecil yang mempengaruhi HtmlConverter saat menangani file besar.

Peningkatan

• Meningkatkan kinerja PdfExtractor dan ImageExtractor untuk waktu pemrosesan yang lebih cepat.
• Memperbarui kelas RotateOptions untuk mendukung sudut rotasi tambahan.

v24.9

Dirilis