Installare Documentize tramite NuGet

Come Installare tramite la Console del Gestore Pacchetti NuGet

1. Apri il tuo progetto:

   • Avvia Visual Studio e apri la tua applicazione .NET.

2. Accedi alla Console del Gestore Pacchetti:

   • Vai su Strumenti > Gestore pacchetti NuGet > Console del gestore pacchetti.

3. Installa il pacchetto:

   • Per installare l’ultima versione completa, inserisci il comando Install-Package Documentize.
   • Per installare l’ultima versione inclusa le correzioni, usa Install-Package Documentize -prerelease.
   • Premi Invio per eseguire il comando.

Come Aggiornare il Pacchetto tramite la Console del Gestore Pacchetti NuGet

Se hai già installato Documentize tramite NuGet e desideri aggiornare all’ultima versione:

1. Apri il tuo progetto:

   • Avvia Visual Studio e apri la tua applicazione .NET.

2. Accedi alla Console del Gestore Pacchetti:

   • Vai su Strumenti > Gestore pacchetti NuGet > Console del gestore pacchetti.

3. Aggiorna il pacchetto:

   • Per aggiornare all’ultima versione completa, inserisci Update-Package Documentize.
   • Per aggiornare all’ultima versione inclusa le correzioni, usa Update-Package Documentize -prerelease.
   • Premi Invio per eseguire il comando.

Come Installare tramite l’Interfaccia Grafica del Gestore Pacchetti NuGet

1. Apri il tuo progetto:

   • Avvia Visual Studio e apri la tua applicazione .NET.

2. Naviga per Gestire i Pacchetti NuGet:

   • Dal menu Progetto, seleziona Gestisci pacchetti NuGet.

3. Cerca Documentize:

   • Vai alla scheda Sfoglia e inserisci Documentize nella casella di ricerca.

4. Installa il pacchetto:

   • Clicca su Installa/Aggiorna accanto all’ultima versione di Documentize.
   • Conferma cliccando su Accetta nella finestra pop-up.

Vantaggi dell’Utilizzo di NuGet

• Gestione Automatica delle Dipendenze:

  • NuGet gestisce automaticamente le dipendenze, assicurando che tutte le librerie necessarie siano incluse e aggiornate correttamente. Questo riduce il rischio di dipendenze mancanti o incompatibili.

• Aggiornamenti Semplificati:

  • Aggiornare i pacchetti è semplice con NuGet, sia attraverso la Console del Gestore Pacchetti che l’interfaccia grafica. Questo rende facile mantenere le librerie aggiornate con le ultime funzionalità e correzioni di bug.

• Integrato con Visual Studio:

  • NuGet è perfettamente integrato con Visual Studio, fornendo un’interfaccia utente facile da usare per gestire i pacchetti senza lasciare l’ambiente di sviluppo.

• Versionamento:

  • NuGet consente di specificare e gestire diverse versioni delle librerie, permettendo di ripristinare facilmente versioni precedenti o testare nuove versioni senza interrompere lo sviluppo.

Svantaggi dell’Utilizzo di NuGet

• Limitato a Visual Studio:

  • NuGet è progettato principalmente per essere utilizzato all’interno di Visual Studio. Sebbene possa essere utilizzato in altri ambienti, l’integrazione è più robusta in Visual Studio.

• Potenziale per Conflitti di Versione:

  • In progetti più grandi con molte dipendenze, gestire le versioni e risolvere i conflitti può diventare complesso. NuGet fornisce strumenti per gestire questo, ma richiede attenzione.

• Dipendenza dalla Rete:

  • L’installazione e l’aggiornamento dei pacchetti richiedono una connessione a Internet. Se lavori in un ambiente con accesso a Internet limitato o assente, potresti dover utilizzare metodi offline o pre-scaricare i pacchetti.

• Complessità per Grandi Progetti:

  • Per progetti molto grandi con alberi di dipendenze estesi, la gestione dei pacchetti tramite NuGet può diventare gravosa. In tali casi, potrebbero essere necessari strumenti o strategie aggiuntive per gestire efficacemente le dipendenze.

Installare Documentize tramite MSI

Come installare tramite l’installer MSI

1. Scarica l’installer MSI:

   • Clicca sul v24.12 MSI per scaricare l’installer MSI per l’ultima versione di Documentize.

2. Esegui l’installer:

   • Fai doppio clic sul file MSI scaricato per avviare la procedura guidata di installazione.

3. Segui la procedura guidata di installazione:

   • Segui le istruzioni visualizzate dall’installer. Potrebbe essere necessario accettare il contratto di licenza e selezionare le opzioni di installazione.

4. Completa l’installazione:

   • Una volta completata l’installazione, le DLL di Documentize verranno installate nella Global Assembly Cache (GAC) del tuo sistema o in un’altra posizione specificata.

5. Verifica l’installazione:

   • Controlla che le DLL siano installate correttamente verificando la loro presenza nella directory di installazione designata o nella GAC.

Vantaggi dell’uso dell’installer MSI

• Facilità d’uso:

  • L’installer MSI fornisce un processo di installazione semplice e guidato. Gestisce tutte le configurazioni necessarie e colloca le DLL in una posizione centrale, facilitando l’uso di Documentize in più progetti.

• Installazione a livello di sistema:

  • Il metodo MSI installa Documentize nella Global Assembly Cache (GAC) del sistema o in un’altra posizione centrale. Questo consente a qualsiasi applicazione nel sistema di accedere alle DLL senza doverle riferire individualmente in ciascun progetto.

• Aggiornamenti automatizzati:

  • Se Documentize fornisce un installer aggiornato, puoi facilmente aggiornare la tua installazione eseguendo il nuovo file MSI, che solitamente gestisce il processo di aggiornamento senza problemi.

• Coerenza:

  • Utilizzare l’installer MSI assicura che tutti i file necessari siano installati correttamente e in modo coerente in diversi ambienti, riducendo il rischio di DLL mancanti o dislocate.

Svantaggi dell’uso dell’installer MSI

• Flessibilità limitata:

  • L’installer MSI installa Documentize in una posizione a livello di sistema, che potrebbe non essere adatta per tutti gli ambienti di sviluppo. Potrebbe mancare della flessibilità necessaria per adattarsi a configurazioni o versioni specifiche del progetto.

• Sovraccarico potenziale:

  • Installare DLL nella GAC può introdurre sovraccarico e complessità, in particolare in scenari in cui potrebbero essere necessarie più versioni di Documentize contemporaneamente.

• Rimozione manuale:

  • Se è necessario disinstallare Documentize, devi utilizzare il disinstaller fornito dall’MSI, che può lasciare file residui o configurazioni dietro se non gestito correttamente.

• Conflitti di versione:

  • Le installazioni a livello di sistema possono portare a conflitti di versione se diversi progetti richiedono versioni diverse di Documentize. La gestione di questi conflitti potrebbe richiedere configurazioni o pulizie aggiuntive.

Ambiente Non-Windows

Lavorare con DLL .NET Core in un Ambiente Non-Windows

Poiché Documentize per .NET offre supporto per .NET Standard 2.0 (.NET Core 2.0), può essere utilizzato nelle Applicazioni Core che girano su sistemi operativi simili a Linux. Stiamo costantemente lavorando per migliorare il supporto per .NET Core nella nostra API. Tuttavia, ci sono alcune operazioni che raccomandiamo ai nostri clienti di eseguire per ottenere risultati migliori durante l’utilizzo delle funzionalità di Documentize per .NET. Si prega di installare:

• pacchetto libgdiplus
• Pacchetto con font compatibili con Microsoft: ttf-mscorefonts-installer (ad esempio, sudo apt-get install ttf-mscorefonts-installer). Questi font dovrebbero essere posizionati nella directory /usr/share/fonts/truetype/msttcorefonts poiché Documentize per .NET scansiona questa cartella sui sistemi operativi simili a Linux. Nel caso in cui il sistema operativo abbia un’altra cartella/directory predefinita per i font, è necessario utilizzare la seguente riga di codice prima di eseguire qualsiasi operazione utilizzando Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<percorso dell'utente ai font ms>"));

v24.12

Aggiunto nuovo Plugin: Convertitore PDF in PNG

• Classe PngConverter: Rappresenta il plugin Documentize.PngConverter. Utilizzato per convertire documenti PDF in formato PNG.
• Classe PdfToPngOptions: Rappresenta le opzioni del convertitore da PDF a PNG per il plugin Documentize.PngConverter.

Esempio di utilizzo:

// crea PngConverter
var plugin = new PngConverter();
// crea oggetto PdfToPngOptions per impostare istruzioni
var opt = new PdfToPngOptions();
// aggiungi percorso del file di input
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// imposta percorso del file di output
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// esegui il processo
plugin.Process(opt);

Aggiunto nuovo Plugin: Convertitore PDF in TIFF

• Classe TiffConverter: Rappresenta il plugin Documentize.TiffConverter. Utilizzato per convertire documenti PDF in formato TIFF.
• Classe PdfToTiffOptions: Rappresenta le opzioni del convertitore da PDF a TIFF per il plugin Documentize.TiffConverter.

Esempio di utilizzo:

// crea TiffConverter
var plugin = new TiffConverter();
// crea oggetto PdfToTiffOptions per impostare istruzioni
var opt = new PdfToTiffOptions();
// aggiungi percorso del file di input
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// imposta percorso del file di output
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// esegui il processo
plugin.Process(opt);

Aggiunto nuovo Plugin: Generatore di Tabelle PDF

• Classe TableGenerator: Rappresenta il plugin Documentize.TableGenerator. Utilizzato per aggiungere una tabella a un documento PDF.
• Classe TableBuilder: Classe che rappresenta il costruttore per la tabella nella pagina pdf.
• Classe TableRowBuilder: Classe che rappresenta il costruttore per la riga della tabella.
• Classe TableCellBuilder: Classe che rappresenta il costruttore per la cella della tabella.

Esempio di utilizzo:

// crea TableGenerator
var plugin = new TableGenerator();
// crea oggetto TableOptions per impostare istruzioni
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Nome")
            .AddCell().AddParagraph("Età")
        .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");
// aggiungi percorso del file di input
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// imposta percorso del file di output
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// esegui il processo
plugin.Process(opt);

Rinominata la Classe PdfDoc in DocConverter

• Classe DocConverter: Rappresenta il plugin Documentize.DocConverter. Utilizzato per convertire documenti PDF in formato DOC/DOCX.

Esempio di utilizzo:

// crea DocConverter
var plugin = new DocConverter();
// crea oggetto PdfToDocOptions per impostare istruzioni
var opt = new PdfToDocOptions();
// aggiungi percorso del file di input
opt.AddInput(new FileDataSource(inputPath));
// imposta percorso del file di output
opt.AddOutput(new FileDataSource(outputPath));
// esegui il processo
plugin.Process(opt);

v24.11

Aggiunto nuovo Plugin: Convertitore PDF in JPEG

• Scopo: La classe JpegConverter è progettata per convertire documenti PDF in formato JPEG, rendendo più facile per gli utenti gestire e condividere immagini derivate dai PDF.
• Costruttore:
  • JpegConverter(): Inizializza una nuova istanza del convertitore JPEG.

Esempio di Utilizzo:

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

• Metodo:
  • Process(PdfToJpegOptions options): Avvia il processo di conversione JPEG utilizzando le opzioni specificate.

Aggiunta Classe DirectoryDataSource

• Scopo: La classe DirectoryDataSource consente agli utenti di gestire i dati delle directory per le operazioni di caricamento e salvataggio all’interno dei plugin.
• Costruttore:
  • DirectoryDataSource(string path): Inizializza un nuovo oggetto di dati di directory con il percorso specificato.

Esempio di Utilizzo:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• Proprietà:
  • DataType: Recupera il tipo di origine dati.
  • Path: Ottiene il percorso della directory dati corrente.

Aggiunta Classe PdfToJpegOptions

• Scopo: Questa classe contiene opzioni per configurare il processo di conversione JPEG, consentendo agli utenti di specificare risoluzione, elenchi di pagine e qualità dell’immagine.
• Costruttore:
  • PdfToJpegOptions(): Inizializza una nuova istanza di opzioni per il convertitore JPEG.

Proprietà:

• OutputResolution: Specifica la risoluzione delle immagini JPEG risultanti.
• PageList: Un elenco di pagine da convertire dal PDF.
• Quality: Imposta la qualità dell’output JPEG.

v24.10

Aggiunto nuovo Plugin: Convertitore PDF/A

• È stata introdotta una nuova funzione di conversione PDF/A, che consente agli utenti di convertire facilmente file PDF standard in documenti conformi a PDF/A.

Esempio d’uso:

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

Risoluzione dei problemi

• Risolti problemi relativi alla classe FileResult che causavano percorsi di output errati.
• Risolti bug minori che influenzavano l’HtmlConverter durante la gestione di file di grandi dimensioni.

Miglioramenti

• Prestazioni potenziate di PdfExtractor e ImageExtractor per tempi di elaborazione più rapidi.
• Aggiornata la classe RotateOptions per supportare angoli di rotazione aggiuntivi.

v24.9

Rilasciato