Requisiti di Sistema

Gli SDK di Documentize sono progettati per integrarsi con applicazioni .NET e supportano vari sistemi operativi e ambienti di sviluppo. Di seguito sono riportati i requisiti di sistema chiave:

Sistemi Operativi Supportati

Windows

• Windows 7 (x64, x86)
• Windows 8, 8.1 (x64, x86)
• Windows 10 (x64, x86)
• Windows 11 (x64, x86)
• Windows Server 2003 a Windows Server 2022 (x64, x86)
• Cloud: Microsoft Azure

macOS

• macOS 10.12 (Sierra) e versioni successive

Linux

• Compatibile con più distribuzioni Linux:
  • Ubuntu (16.04, 18.04, 20.04, 22.04)
  • CentOS (7, 8)
  • Debian (9, 10)
  • OpenSUSE (Leap 15+, SLES 12+)

Android

• Supporta Android 8.0 (Oreo) e versioni successive.

Ambienti di Sviluppo

• Microsoft Visual Studio:
  • Visual Studio 2010 e versioni successive (incluso 2019 e 2022)
• Supporta qualsiasi ambiente di sviluppo che punta alle piattaforme .NET.

Framework .NET Supportati

• .NET Framework 4.0 e superiori
• .NET Standard 2.0 (.NET Core 3.1+)
• .NET 6.0, .NET 7.0, .NET 8.0

Note Aggiuntive

• Adobe Acrobat non è necessario per eseguire gli SDK di Documentize, ma è consigliato per visualizzare PDF.

Dichiarazione

Gli SDK di Documentize.com richiedono un set di autorizzazioni Full Trust quando vengono utilizzati all’interno delle applicazioni .NET. Questo livello di autorizzazione è essenziale per consentire agli SDK di eseguire alcune operazioni a livello di sistema, come l’accesso alle impostazioni del registro, ai file di sistema e l’analisi dei caratteri.

Perché è necessaria la Full Trust

Gli SDK di Documentize utilizzano classi di sistema .NET fondamentali, che spesso richiedono autorizzazioni elevate per i seguenti motivi:

• Accesso al Registro: Alcune operazioni potrebbero richiedere la lettura o la scrittura nel registro di sistema.
• File di Sistema: L’accesso a file di sistema oltre la directory virtuale dell’applicazione potrebbe essere necessario per alcune operazioni, come la gestione dei caratteri o l’esecuzione di operazioni file.

Limitazioni dell’Ambiente a Fiducia Media

Negli ambienti di hosting che impongono la sicurezza Medium Trust, diverse autorizzazioni importanti sono limitate o non disponibili. Questo potrebbe impedire il corretto funzionamento degli SDK in tali ambienti. Le seguenti restrizioni si applicano sotto Medium Trust:

• OleDbPermission: Impossibile utilizzare il provider dati OLE DB gestito ADO.NET per accedere ai database.
• EventLogPermission: L’accesso al Registro eventi di Windows è vietato.
• ReflectionPermission: Impedisce l’uso della riflessione, il che potrebbe influenzare alcune operazioni dinamiche.
• RegistryPermission: L’accesso al registro di sistema è negato.
• WebPermission: La comunicazione è limitata a indirizzi o intervalli predefiniti come configurato nell’elemento <trust>.
• FileIOPermission: L’accesso ai file è limitato a quelli all’interno della directory virtuale dell’applicazione.

Ambiente Non-Windows

Documentize SDK supporta .NET Standard 2.0, che consente di utilizzarli in applicazioni .NET Core che girano su Linux o altri ambienti non-Windows. Per garantire prestazioni ottimali e un corretto rendering del testo, segui i passi qui sotto:

Configurazione Raccomandata per Linux

1. Installa il pacchetto libgdiplus

Questo pacchetto fornisce le necessarie funzionalità GDI+, che sono fondamentali per il rendering e l’elaborazione dei PDF. Puoi installarlo eseguendo il seguente comando nel tuo terminale:

sudo apt-get install libgdiplus

2. Installa i Font Compatibili con Microsoft

Per un corretto rendering del testo, installa i font TrueType di Microsoft utilizzando il comando:

sudo apt-get install ttf-mscorefonts-installer

Questi font dovrebbero essere collocati nella directory /usr/share/fonts/truetype/msttcorefonts. Se il tuo sistema memorizza i font in una directory diversa, aggiorna il percorso nel tuo codice prima di eseguire qualsiasi operazione con gli SDK di Documentize:

Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<percorso ai font microsoft>"));

Valutazione

Puoi facilmente scaricare gli SDK di Documentize per scopi di valutazione. La versione di valutazione è identica alla versione acquistata, con l’unica differenza nel modo in cui applichi la licenza.

Limitazioni della Versione di Valutazione

Sebbene la versione di valutazione fornisca accesso completo a tutte le funzionalità, include le seguenti limitazioni fino all’applicazione di una licenza:

• Un watermark di valutazione è inserito in tutti i documenti di output.
• Possono essere visualizzate o modificate solo le prime quattro pagine di qualsiasi documento PDF.

Per rimuovere queste limitazioni e sbloccare la versione completa, è sufficiente applicare una licenza aggiungendo alcune righe di codice al tuo progetto.

Aggiuntore di Timestamp PDF

Il Documentize PDF Timestamp Adder per .NET è uno strumento potente progettato per aggiungere timestamp sicuri ai tuoi documenti PDF. Migliora l’integrità e l’autenticità dei tuoi documenti fornendo un riferimento temporale affidabile, garantendo la conformità agli standard delle firme digitali.

Caratteristiche Principali:

• Aggiungi Timestamp Sicuri: Aggiungi senza sforzo timestamp sicuri ai tuoi documenti PDF.
• Server di Timestamp Personalizzabili: Utilizza URL di server di timestamp e credenziali di autenticazione personalizzati.
• Automazione: Integra il timestamping nelle tue applicazioni .NET per flussi di lavoro automatizzati.
• Conformità: Assicurati che i tuoi documenti soddisfino gli standard di settore per firme digitali e timestamp.

Come Aggiungere un Timestamp ai Documenti PDF

Per aggiungere un timestamp sicuro a un documento PDF, segui questi passaggi:

1. Crea un’istanza della classe Timestamp.
2. Crea un’istanza di AddTimestampOptions per configurare il processo di timestamping.
3. Aggiungi il file PDF di input utilizzando il metodo AddInput.
4. Imposta il percorso del file di output utilizzando AddOutput.
5. Esegui il timestamping utilizzando il metodo Process.

 1  
 2// Instanzia il plugin Timestamp  
 3var plugin = new Timestamp();  
 4
 5// Configura le opzioni di timestamping  
 6var opt = new AddTimestampOptions("path_to_pfx", "password_for_pfx", "timestamp_server_url");  
 7
 8// Aggiungi il file PDF di input  
 9opt.AddInput(new FileDataSource("path_to_pdf"));  
10
11// Specifica il file PDF di output  
12opt.AddOutput(new FileDataSource("path_to_result_pdf"));  
13
14// Esegui il processo di timestamping  
15plugin.Process(opt);  

Come Utilizzare l’Autenticazione Personalizzata con il Server di Timestamp

Puoi fornire credenziali di autenticazione di base quando ti connetti al server di timestamp. Questo ti consente di autenticarti con server che richiedono un nome utente e una password.

1. Crea un’istanza della classe Timestamp.
2. Crea un’istanza di AddTimestampOptions, inclusi i serverBasicAuthCredentials.
3. Aggiungi i percorsi del file di input e del file di output.
4. Chiama il metodo Process.

 1  
 2// Instanzia il plugin Timestamp  
 3var plugin = new Timestamp();  
 4
 5// Configura le opzioni di timestamping con autenticazione  
 6var opt = new AddTimestampOptions("path_to_pfx", "password_for_pfx", "timestamp_server_url", "username:password");  
 7
 8// Aggiungi il file PDF di input  
 9opt.AddInput(new FileDataSource("path_to_pdf"));  
10
11// Specifica il file PDF di output  
12opt.AddOutput(new FileDataSource("path_to_result_pdf"));  
13
14// Esegui il processo di timestamping  
15plugin.Process(opt);  

Gestione dei File PFX e delle Password

La classe AddTimestampOptions ti consente di utilizzare un file PFX per la firma digitale insieme alla password.

• Stream o Percorso del File PFX: Puoi fornire uno stream o un percorso del file per il file PFX.
• Protezione della Password: Assicurati di gestire in modo sicuro la password per il file PFX.

Convertitore da PDF a DOC

Il Convertitore da PDF a DOC Documentize per .NET è uno strumento potente progettato per convertire documenti PDF nei formati DOC o DOCX. Questo plugin trasforma senza problemi le pagine PDF in documenti Microsoft Word modificabili, rendendo facile riutilizzare, modificare e condividere contenuti su più piattaforme.

Caratteristiche Principali:

• Conversione DOC/DOCX: Converti documenti PDF in formati Microsoft Word modificabili (DOC o DOCX).
• Mantenere la Formattazione: Mantieni il layout originale, il testo e la formattazione durante il processo di conversione.
• Elaborazione in Batch: Converti più file PDF contemporaneamente.
• Opzioni di Conversione Personalizzate: Affina il processo di conversione con diverse modalità, come Enhanced Flow, per un miglior layout.

Come Convertire PDF in DOC/DOCX

Per convertire un documento PDF nel formato DOC/DOCX, segui questi passaggi:

1. Crea un’istanza della classe PdfDoc.
2. Crea un’istanza di PdfToDocOptions per configurare il processo di conversione.
3. Aggiungi il file PDF di input utilizzando il metodo AddInput.
4. Aggiungi il percorso del file di output per il file DOC/DOCX risultante utilizzando il metodo AddOutput.
5. Esegui il metodo Process per eseguire la conversione.

 1  
 2var pdfToWord = new PdfDoc();  
 3var options = new PdfToDocOptions()  
 4{  
 5    SaveFormat = SaveFormat.DocX,       // Formato di output come DOCX  
 6    ConversionMode = ConversionMode.EnhancedFlow // Ottimizza layout e formattazione  
 7};  
 8
 9// Aggiungi il file PDF di input  
10options.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));  
11
12// Aggiungi il percorso del documento Word di output  
13options.AddOutput(new FileDataSource(@"C:\Samples\output.docx"));  
14
15// Processa la conversione  
16pdfToWord.Process(options);  

Conversione da PDF a DOC con Opzioni Personalizzate

Il plugin Convertitore da PDF a DOC offre diverse opzioni per personalizzare il tuo processo di conversione. Puoi scegliere tra diverse modalità per controllare come il layout e la struttura del PDF sono gestiti durante la conversione.

 1  
 2var pdfToWord = new PdfDoc();  
 3var options = new PdfToDocOptions()  
 4{  
 5    SaveFormat = SaveFormat.Doc,        // Formato di output come DOC  
 6    ConversionMode = ConversionMode.Precise // Mantieni il layout originale del PDF il più possibile  
 7};  
 8
 9// Aggiungi il file PDF di input  
10options.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));  
11
12// Aggiungi il percorso del documento Word di output  
13options.AddOutput(new FileDataSource(@"C:\Samples\output.doc"));  
14
15// Processa la conversione  
16pdfToWord.Process(options);  

Elaborazione in Batch per la Conversione da PDF a DOC/DOCX

Il Convertitore da PDF a DOC supporta l’elaborazione in batch, consentendo di convertire più file PDF contemporaneamente. Ecco un esempio di conversione in batch:

 1  
 2var pdfToWord = new PdfDoc();  
 3var options = new PdfToDocOptions()  
 4{  
 5    SaveFormat = SaveFormat.DocX  
 6};  
 7
 8// Aggiungi più file PDF di input  
 9options.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"));  
10options.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"));  
11
12// Aggiungi i percorsi dei file di output per i file DOCX risultanti  
13options.AddOutput(new FileDataSource(@"C:\Samples\output_file1.docx"));  
14options.AddOutput(new FileDataSource(@"C:\Samples\output_file2.docx"));  
15
16// Processa la conversione in batch  
17pdfToWord.Process(options);  

Convertitore PDF in XLS

Il Convertitore PDF in XLS Documentize per .NET è uno strumento potente che consente la conversione fluida dei documenti PDF in fogli di calcolo Excel (XLS/XLSX). Questo plugin migliora l’accessibilità e l’usabilità dei tuoi contenuti PDF, rendendo facile manipolare e analizzare i dati in formato foglio di calcolo.

Caratteristiche principali:

• Convertire PDF in Excel: Trasforma i file PDF in fogli di calcolo XLS/XLSX per una facile gestione dei dati.
• Opzioni di output personalizzate: Configura il formato di output, l’intervallo di pagine, il nome del foglio di lavoro e altro ancora.
• Conversione ad alta fedeltà: Mantieni il layout, la formattazione e l’accuratezza del contenuto durante la conversione.
• Elaborazione batch: Converti più file PDF in un colpo solo per operazioni su larga scala.

Come convertire PDF in XLS

Per convertire un documento PDF in un file Excel (XLS/XLSX), segui questi passaggi:

1. Crea un’istanza della classe PdfXls.
2. Crea un’istanza di PdfToXlsOptions per configurare le impostazioni di conversione.
3. Aggiungi il file PDF di input utilizzando il metodo AddInput.
4. Specifica il file Excel di output usando il metodo AddOutput.
5. Esegui il metodo Process per avviare la conversione.

1var pdfXlsConverter = new PdfXls();
2var options = new PdfToXlsOptions();
3
4// Aggiungi i percorsi del file di input e output
5options.AddInput(new FileDataSource(@"C:\Samples\sample.pdf"));
6options.AddOutput(new FileDataSource(@"C:\Samples\output.xlsx"));
7
8// Esegui il processo di conversione
9pdfXlsConverter.Process(options);

Personalizzare la conversione da PDF a Excel

Puoi personalizzare le impostazioni di conversione modificando la classe PdfToXlsOptions. Ad esempio, per convertire il PDF in formato XLSX, inserire una colonna vuota e nominare il foglio di lavoro, puoi utilizzare il seguente codice:

 1var options = new PdfToXlsOptions();
 2
 3// Imposta il formato di output su XLSX
 4options.Format = PdfToXlsOptions.ExcelFormat.XLSX;
 5
 6// Inserisci una colonna vuota nella prima posizione
 7options.InsertBlankColumnAtFirst = true;
 8
 9// Imposta il nome del foglio di lavoro
10options.WorksheetName = "MySheet";
11
12// Aggiungi i file di input e output
13options.AddInput(new FileDataSource(@"C:\Samples\sample.pdf"));
14options.AddOutput(new FileDataSource(@"C:\Samples\output.xlsx"));
15
16// Elabora la conversione
17pdfXlsConverter.Process(options);

Gestire i risultati della conversione

Dopo l’elaborazione, il metodo Process restituisce un oggetto ResultContainer che contiene il risultato della conversione. Puoi recuperare il percorso del file convertito o altri dettagli di output:

1var resultContainer = pdfXlsConverter.Process(options);
2
3// Accedi e stampa il percorso del file risultante
4var result = resultContainer.ResultCollection[0];
5Console.WriteLine(result);

Elaborazione batch per la conversione da PDF a XLS

Il plugin Convertitore PDF in XLS supporta anche l’elaborazione batch, consentendo la conversione di più file PDF contemporaneamente.

 1var pdfXlsConverter = new PdfXls();
 2var options = new PdfToXlsOptions();
 3
 4// Aggiungi più PDF di input
 5options.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"));
 6options.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"));
 7
 8// Aggiungi i file Excel di output
 9options.AddOutput(new FileDataSource(@"C:\Samples\output1.xlsx"));
10options.AddOutput(new FileDataSource(@"C:\Samples\output2.xlsx"));
11
12// Elabora la conversione batch
13pdfXlsConverter.Process(options);

Convertitore PDF/A

Il Convertitore PDF/A Documentize per .NET è uno strumento potente progettato per convertire documenti PDF nel formato PDF/A, garantendo che il tuo contenuto rimanga conforme agli standard di archiviazione a lungo termine. Questo plugin supporta anche la validazione dei documenti PDF esistenti per la conformità al PDF/A, offrendo sia funzionalità di conversione che di validazione in una soluzione unica.

Caratteristiche Principali:

• Convertire in PDF/A: Trasforma senza problemi i file PDF nel formato PDF/A (come PDF/A-1a, PDF/A-2b, PDF/A-3b) per garantire la conformità agli standard di archiviazione.
• Validare la Conformità al PDF/A: Controlla i documenti PDF esistenti per la conformità agli standard PDF/A e identifica eventuali problemi se non sono conformi.
• Elaborazione in Batch: Elabora più file contemporaneamente per conversione o validazione.
• Workflow Efficiente: Riduci i tempi e gli sforzi con processi di conversione rapidi e affidabili.

Come Convertire PDF in PDF/A

Per convertire un documento PDF nel formato PDF/A, segui questi passaggi:

1. Crea un’istanza della classe PdfAConverter.
2. Crea un’istanza di PdfAConvertOptions per configurare la conversione.
3. Specifica la versione PDF/A desiderata (ad esempio, PDF/A-3B).
4. Aggiungi il file PDF di input utilizzando il metodo AddInput.
5. Aggiungi il file di output per il PDF/A risultante utilizzando il metodo AddOutput.
6. Chiama il metodo Process per eseguire la conversione.

 1var pdfAConverter = new PdfAConverter();
 2var pdfAOptions = new PdfAConvertOptions
 3{
 4    PdfAVersion = PdfAStandardVersion.PDF_A_3B
 5};
 6
 7// Aggiungi il file PDF di input
 8pdfAOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
 9
10// Specifica il file PDF/A di output
11pdfAOptions.AddOutput(new FileDataSource(@"C:\Samples\output_pdfa.pdf"));
12
13// Elabora la conversione
14pdfAConverter.Process(pdfAOptions);

Validazione della Conformità al PDF/A

Puoi validare i file PDF esistenti per la conformità al PDF/A utilizzando la classe PdfAValidateOptions.

 1var pdfAConverter = new PdfAConverter();
 2var validationOptions = new PdfAValidateOptions
 3{
 4    PdfAVersion = PdfAStandardVersion.PDF_A_1A
 5};
 6
 7// Aggiungi il file PDF da validare
 8validationOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
 9
10// Esegui il processo di validazione
11var resultContainer = pdfAConverter.Process(validationOptions);
12
13// Controlla il risultato della validazione
14var validationResult = (PdfAValidationResult)resultContainer.ResultCollection[0].Data;
15Console.WriteLine("Validazione PDF/A superata: " + validationResult.IsValid);

Elaborazione in Batch per Conversione PDF/A

Questo plugin supporta l’elaborazione in batch, permettendoti di convertire o validare più file PDF per la conformità al PDF/A contemporaneamente.

 1var pdfAConverter = new PdfAConverter();
 2var pdfAOptions = new PdfAConvertOptions
 3{
 4    PdfAVersion = PdfAStandardVersion.PDF_A_3B
 5};
 6
 7// Aggiungi più PDF di input
 8pdfAOptions.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"));
 9pdfAOptions.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"));
10
11// Specifica i file di output per i PDF/A convertiti
12pdfAOptions.AddOutput(new FileDataSource(@"C:\Samples\file1_pdfa.pdf"));
13pdfAOptions.AddOutput(new FileDataSource(@"C:\Samples\file2_pdfa.pdf"));
14
15// Elabora la conversione in batch
16pdfAConverter.Process(pdfAOptions);

Divisore PDF

Il Documentize PDF Splitter per .NET è uno strumento potente che semplifica il processo di suddivisione di grandi documenti PDF in file più piccoli e gestibili. Sia che tu debba estrarre pagine singole o dividere un documento in sezioni specifiche, questo plugin ti consente di farlo in modo efficiente e con il minimo sforzo.

Caratteristiche principali:

• Dividi PDF per Pagina: Scomponi un documento PDF in pagine singole.
• Elaborazione Batch: Dividi grandi lotti di PDF in un colpo solo.
• Opzioni di Divisione Personalizzate: Configura il processo di suddivisione in base alle tue esigenze.
• Output Organizzato: Gestisci facilmente i file di output per ciascuna pagina o sezione divisa.

Come dividere documenti PDF

Per dividere un documento PDF in pagine singole, segui questi passaggi:

1. Crea un’istanza della classe Splitter.
2. Crea un’istanza di SplitOptions per configurare le opzioni di suddivisione.
3. Aggiungi il file PDF di input usando il metodo AddInput.
4. Aggiungi i file di output per ciascuna pagina divisa usando il metodo AddOutput.
5. Esegui il metodo Process per dividere il documento.

 1  
 2var splitter = new Splitter();  
 3var splitOptions = new SplitOptions();  
 4
 5// Aggiungi il file PDF di input  
 6splitOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));  
 7
 8// Specifica i file di output per ciascuna pagina  
 9splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_page_1.pdf"));  
10splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_page_2.pdf"));  
11splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_page_3.pdf"));  
12
13// Esegui l'operazione di divisione  
14splitter.Process(splitOptions);  

Suddivisione PDF per Intervalli di Pagine

Puoi anche dividere un PDF specificando intervalli di pagine. Questo ti consente di estrarre sezioni specifiche o più pagine da un PDF in documenti separati.

 1  
 2var splitter = new Splitter();  
 3var splitOptions = new SplitOptions();  
 4
 5// Aggiungi il PDF di input  
 6splitOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));  
 7
 8// Definisci l'output per gli intervalli di pagine (ad es., pagine 1-3)  
 9splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_pages_1_to_3.pdf"));  
10
11// Esegui la divisione  
12splitter.Process(splitOptions);  

Come gestire la suddivisione batch

Il PDF Splitter plugin è ottimizzato per gestire grandi lotti di documenti PDF. Puoi suddividere centinaia di PDF in pagine o sezioni singole sfruttando l’elaborazione batch.

 1  
 2var splitter = new Splitter();  
 3var splitOptions = new SplitOptions();  
 4
 5// Aggiungi file PDF di input in un batch  
 6splitOptions.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"));  
 7splitOptions.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"));  
 8
 9// Definisci l'output per ciascun file  
10splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_file1_page1.pdf"));  
11splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_file2_page1.pdf"));  
12
13// Esegui la divisione batch  
14splitter.Process(splitOptions);  

Estrattore di Testo PDF

L’Estrattore di Testo PDF Documentize per .NET semplifica l’estrazione del testo da documenti PDF. Che tu abbia bisogno di testo puro, grezzo o semplice, questo plugin consente di estrarre testo in modo efficiente preservando la formattazione o omettendola in base alle tue preferenze.

Caratteristiche Principali:

• Modalità Pura: Estrae testo preservando la formattazione originale.
• Modalità Grezza: Estrae testo senza alcuna formattazione.
• Modalità Semplice: Estrae testo senza caratteri speciali o formattazione.
• Elaborazione Batch: Estrai testo da più PDF contemporaneamente.

Come Estrarre Testo da Documenti PDF

Per estrarre testo da un documento PDF, segui questi passaggi:

1. Crea un’istanza della classe TextExtractor.
2. Crea un’istanza di TextExtractorOptions per configurare le opzioni di estrazione.
3. Aggiungi il file PDF di input utilizzando il metodo AddInput.
4. Esegui il metodo Process per estrarre il testo.
5. Accedi al testo estratto utilizzando ResultContainer.ResultCollection.

 1  
 2using var extractor = new TextExtractor();  
 3var textExtractorOptions = new TextExtractorOptions();  
 4
 5// Aggiungi il PDF di input  
 6textExtractorOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));  
 7
 8// Elabora l'estrazione del testo  
 9var resultContainer = extractor.Process(textExtractorOptions);  
10
11// Stampa il testo estratto  
12var extractedText = resultContainer.ResultCollection[0];  
13Console.WriteLine(extractedText);  

Estrazione di Testo da Più PDF

Il plugin ti consente di estrarre testo da più PDF simultaneamente, garantendo un’elaborazione rapida ed efficiente.

 1  
 2using var extractor = new TextExtractor();  
 3var textExtractorOptions = new TextExtractorOptions();  
 4
 5// Aggiungi più PDF di input  
 6textExtractorOptions.AddInput(new FileDataSource(@"C:\Samples\input1.pdf"));  
 7textExtractorOptions.AddInput(new FileDataSource(@"C:\Samples\input2.pdf"));  
 8
 9// Elabora l'estrazione  
10var resultContainer = extractor.Process(textExtractorOptions);  
11
12// Output del testo estratto  
13foreach (var result in resultContainer.ResultCollection)  
14{  
15    Console.WriteLine(result);  
16}  

Modalità di Estrazione del Testo

Il plugin TextExtractor offre tre modalità di estrazione, fornendo flessibilità in base alle tue esigenze.

1. Modalità Pura: Preserva la formattazione originale, inclusi spazi e allineamento.
2. Modalità Grezza: Estrae il testo senza formattazione, utile per l’elaborazione di dati grezzi.
3. Modalità Semplice: Estrae testo senza caratteri speciali o formattazione aggiuntiva.

 1  
 2var textExtractorOptions = new TextExtractorOptions();  
 3
 4// Imposta in modalità Pura  
 5textExtractorOptions.Mode = ExtractionMode.Pure;  
 6textExtractorOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));  
 7
 8// Elabora e output  
 9var resultContainer = extractor.Process(textExtractorOptions);  
10Console.WriteLine(resultContainer.ResultCollection[0]);  

Come Gestire l’Elaborazione Batch

Per grandi quantità di documenti, puoi sfruttare l’elaborazione batch, permettendoti di estrarre testo da più PDF in una volta.

 1  
 2using var extractor = new TextExtractor();  
 3var textExtractorOptions = new TextExtractorOptions();  
 4
 5// Aggiungi più PDF di input  
 6textExtractorOptions.AddInput(new FileDataSource(@"C:\Samples\batch1.pdf"));  
 7textExtractorOptions.AddInput(new FileDataSource(@"C:\Samples\batch2.pdf"));  
 8
 9// Definisci l'output per ogni file  
10var resultContainer = extractor.Process(textExtractorOptions);  
11
12// Gestisci il testo estratto  
13foreach (var result in resultContainer.ResultCollection)  
14{  
15    Console.WriteLine(result);  
16}  

Firma PDF

Il plugin Documentize PDF Signature per .NET consente agli utenti di firmare digitalmente documenti PDF. Offre un processo semplificato per aggiungere firme, garantire autenticità e proteggere il contenuto PDF. Il plugin supporta sia firme visibili che invisibili e fornisce opzioni per personalizzare la posizione della firma, il motivo, le informazioni di contatto e altro ancora.

Caratteristiche Principali:

• Firma Digitalmente Documenti PDF: Sicurezza per i tuoi documenti con firme digitali visibili o invisibili.
• Supporto PFX: Firma file PDF utilizzando un certificato PFX.
• Opzioni Personalizzabili: Configura le impostazioni della firma come motivo, posizione e dettagli di contatto.
• Firme Visibili e Invisibili: Scegli se la firma deve essere visibile sul documento.

Come Firmare Documenti PDF

Per firmare un documento PDF utilizzando un file PFX, segui questi passaggi:

1. Crea un’istanza della classe Signature.
2. Instanzia la classe SignOptions con il percorso del file PFX e la password.
3. Aggiungi il PDF di input e il file di output alle opzioni.
4. Esegui il metodo Process per applicare la firma.

 1var signature = new Signature();
 2var signOptions = new SignOptions(@"C:\certificates\myCertificate.pfx", "pfxPassword");
 3
 4// Aggiungi il PDF di input e specifica il file di output
 5signOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
 6signOptions.AddOutput(new FileDataSource(@"C:\Samples\signedOutput.pdf"));
 7
 8// Configura le opzioni della firma
 9signOptions.Reason = "Contratto di Accordo";
10signOptions.Contact = "johndoe@example.com";
11signOptions.Location = "New York";
12signOptions.PageNumber = 1;
13signOptions.Visible = true;
14signOptions.Rectangle = new Rectangle(100, 100, 200, 150);
15
16// Applica la firma al documento
17signature.Process(signOptions);

Come Utilizzare uno Stream per il File PFX

Puoi anche firmare un PDF utilizzando un certificato PFX fornito come stream invece che come percorso di file. Questo consente una gestione più flessibile della memorizzazione del certificato.

1. Crea un’istanza della classe Signature.
2. Instanzia SignOptions con uno stream contenente il PFX e la password.
3. Aggiungi i file di input e output.
4. Esegui il metodo Process per applicare la firma.

 1using var pfxStream = File.OpenRead(@"C:\certificates\myCertificate.pfx");
 2var signature = new Signature();
 3var signOptions = new SignOptions(pfxStream, "pfxPassword");
 4
 5// Aggiungi i file di input e output
 6signOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
 7signOptions.AddOutput(new FileDataSource(@"C:\Samples\signedOutput.pdf"));
 8
 9// Applica la firma
10signature.Process(signOptions);

Come Applicare Firme Invisibili

Per aggiungere una firma invisibile (una che protegge il documento senza mostrare la firma sul documento), imposta semplicemente la proprietà Visible su false.

1. Crea un’istanza di SignOptions.
2. Imposta Visible su false.
3. Aggiungi i file di input e output.
4. Chiama Process per applicare la firma invisibile.

 1var signature = new Signature();
 2var signOptions = new SignOptions(@"C:\certificates\myCertificate.pfx", "pfxPassword");
 3
 4// Configura la firma invisibile
 5signOptions.Visible = false;
 6
 7// Aggiungi i file di input e output
 8signOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
 9signOptions.AddOutput(new FileDataSource(@"C:\Samples\invisiblySigned.pdf"));
10
11// Processa la firma
12signature.Process(signOptions);

Ottimizzatore PDF

L’Ottimizzatore PDF Documentize è un plugin completo che migliora i documenti PDF attraverso tecniche avanzate di ottimizzazione. È progettato per aiutare a ridurre le dimensioni dei file, ruotare le pagine, ritagliare i contenuti e ridimensionare i documenti. Queste operazioni migliorano la qualità e la gestibilità dei file PDF, rendendoli più facili da archiviare, condividere e visualizzare.

Caratteristiche Principali:

• Ottimizzazione: Riduci la dimensione dei file PDF senza perdere qualità.
• Rotazione: Regola l’orientamento delle pagine PDF.
• Ritaglio: Rimuovi margini o contenuti non necessari dal documento.
• Ridimensionamento: Ridimensiona le pagine a dimensioni specifiche (ad es. A4, Lettera).

Ottimizza Documento PDF

I seguenti passaggi dimostrano come ottimizzare un documento PDF riducendo la sua dimensione mentre si mantiene la qualità.

1. Crea un’istanza della classe Optimizer.
2. Crea un oggetto OptimizeOptions per configurare le impostazioni di ottimizzazione.
3. Aggiungi i file PDF di input e imposta una posizione di output per il file ottimizzato.
4. Esegui il metodo Process per eseguire l’ottimizzazione.

1  
2var optimizer = new Optimizer();  
3var optimizeOptions = new OptimizeOptions();  
4optimizeOptions.AddInput(new FileDataSource("input.pdf"));  
5optimizeOptions.AddOutput(new FileDataSource("output.pdf"));  
6optimizer.Process(optimizeOptions);  

Ridimensiona Documento PDF

Per ridimensionare un documento PDF, si utilizza la classe ResizeOptions per specificare la nuova dimensione della pagina per il documento.

1. Instanzia la classe Optimizer.
2. Crea un oggetto ResizeOptions per definire la dimensione della pagina.
3. Aggiungi il file di input e definisci la posizione di output desiderata.
4. Usa il metodo SetPageSize per specificare la nuova dimensione (ad es. A4).
5. Chiama il metodo Process per applicare le modifiche.

1  
2var optimizer = new Optimizer();  
3var resizeOptions = new ResizeOptions();  
4resizeOptions.AddInput(new FileDataSource("input.pdf"));  
5resizeOptions.SetPageSize(PageSize.A4);  
6resizeOptions.AddOutput(new FileDataSource("output.pdf"));  
7optimizer.Process(resizeOptions);  

Ruota Pagine PDF

Usa la classe RotateOptions per regolare l’orientamento delle pagine in un file PDF.

1. Instanzia la classe Optimizer.
2. Crea un oggetto RotateOptions e configura l’angolo di rotazione.
3. Aggiungi il file PDF di input e specifica la posizione del file di output.
4. Imposta l’angolo di rotazione (ad es. 90 gradi) utilizzando il metodo SetRotation.
5. Esegui la rotazione con il metodo Process.

1  
2var optimizer = new Optimizer();  
3var rotateOptions = new RotateOptions();  
4rotateOptions.AddInput(new FileDataSource("input.pdf"));  
5rotateOptions.SetRotation(90);  
6rotateOptions.AddOutput(new FileDataSource("output.pdf"));  
7optimizer.Process(rotateOptions);  

Ritaglia Documento PDF

Il ritaglio rimuove contenuti o margini indesiderati da un documento PDF. La classe CropOptions può essere utilizzata per definire l’area di ritaglio.

1. Crea un’istanza della classe Optimizer.
2. Definisci l’area di ritaglio con l’oggetto CropOptions.
3. Aggiungi il file di input e specifica la posizione del file di output.
4. Usa il metodo SetCropBox per definire l’area di ritaglio.
5. Esegui il ritaglio con il metodo Process.

1  
2var optimizer = new Optimizer();  
3var cropOptions = new CropOptions();  
4cropOptions.AddInput(new FileDataSource("input.pdf"));  
5cropOptions.SetCropBox(new Rectangle(50, 50, 500, 700)); // Definisce l'area di ritaglio  
6cropOptions.AddOutput(new FileDataSource("output.pdf"));  
7optimizer.Process(cropOptions);  

PDF ChatGPT

Il plugin Documentize ChatGPT per .NET è uno strumento potente progettato per integrare l’API di ChatGPT con le applicazioni PDF. Questo plugin consente agli sviluppatori di generare risposte in chat basate su messaggi di input e salvare l’output in formato PDF, rendendolo adatto per creare interfacce conversazionali o report di analisi direttamente all’interno dei documenti PDF.

Caratteristiche Principali:

• Completamenti in Chat: Genera risposte utilizzando l’API di ChatGPT basate su input personalizzati.
• Messaggi di Sistema e Utente: Fornisce sia il contesto del sistema che l’input dell’utente per creare conversazioni dinamiche.
• Output PDF: Salva i completamenti della chat generati in un file PDF strutturato per ulteriori utilizzi.
• Elaborazione Asincrona: Garantisce applicazioni reattive elaborando i completamenti della chat in modo asincrono.

Generare Risposte in Chat

Per generare risposte in chat e salvarle in un file PDF utilizzando il plugin ChatGPT, segui questi passaggi:

1. Crea un’istanza della classe PdfChatGptRequestOptions per configurare le opzioni della richiesta.
2. Aggiungi i file PDF di input e output.
3. Imposta la chiave API e specifica i parametri come il conteggio massimo dei token e la query per il modello ChatGPT.
4. Esegui il metodo ProcessAsync per generare il completamento della chat.

 1var options = new PdfChatGptRequestOptions();
 2options.ApiKey = "sk-******";  // Imposta la tua chiave API
 3options.MaxTokens = 1000;  // Imposta il numero massimo di token
 4options.Query = "Analizza questo testo per temi chiave.";
 5
 6// Aggiungi il file PDF di input
 7options.AddInput(new FileDataSource("input.pdf"));
 8
 9// Specifica dove salvare il PDF di output con le risposte in chat
10options.AddOutput(new FileDataSource("output.pdf"));
11
12// Crea un'istanza del plugin PdfChatGpt
13var plugin = new PdfChatGpt();
14
15// Esegui il processo in modo asincrono
16var result = await plugin.ProcessAsync(options);

Aggiungere Messaggi di Sistema e Utente

Per creare una conversazione più interattiva, puoi aggiungere sia messaggi di sistema che messaggi dell’utente. Questi messaggi aiutano a plasmare il contesto della conversazione.

1. Aggiungi un messaggio di sistema che stabilisce il contesto per ChatGPT.
2. Aggiungi un messaggio dell’utente che rappresenta l’input dell’utente per la conversazione.

 1var options = new PdfChatGptRequestOptions();
 2options.ApiKey = "sk-******";  // Imposta la tua chiave API
 3
 4// Aggiungi un messaggio di sistema per il contesto
 5options.AddSystemMessage("Sei un'IA addestrata a riassumere testi.");
 6
 7// Aggiungi un messaggio dell'utente per interrogare il modello ChatGPT
 8options.AddUserMessage("Per favore, riassumi il documento allegato.");
 9
10// Aggiungi i PDF di input e output
11options.AddInput(new FileDataSource("input.pdf"));
12options.AddOutput(new FileDataSource("output.pdf"));
13
14// Elabora la richiesta in modo asincrono
15var plugin = new PdfChatGpt();
16var result = await plugin.ProcessAsync(options);

Sicurezza PDF

La Documentize Sicurezza PDF per .NET è uno strumento potente progettato per migliorare la sicurezza dei tuoi documenti PDF fornendo funzionalità di crittografia e decrittazione. Garantisce che le tue informazioni sensibili rimangano riservate e protette da accessi non autorizzati.

Caratteristiche Principali:

• Cripta Documenti PDF: Sicurezza dei tuoi file PDF aggiungendo password per utenti e proprietari.
• Decripta Documenti PDF: Rimuovi la crittografia dai PDF quando necessario.
• Imposta Permessi: Controlla permessi come stampa, copia e modifica dei contenuti.
• Automazione: Integra la crittografia e la decrittazione nelle tue applicazioni .NET per flussi di lavoro automatizzati.
• Conformità: Assicura che i tuoi documenti rispettino gli standard di settore per la sicurezza dei documenti.

Come Criptare un Documento PDF

Per criptare un documento PDF, segui questi passaggi:

1. Crea un’istanza della classe Security.
2. Crea un’istanza di EncryptionOptions con le password desiderate per l’utente e per il proprietario.
3. Aggiungi il file PDF di input utilizzando il metodo AddInput.
4. Imposta il percorso del file di output utilizzando AddOutput.
5. Esegui la crittografia utilizzando il metodo Process.

 1  
 2// Instanzia il plugin di Sicurezza  
 3var plugin = new Security();  
 4
 5// Configura le opzioni di crittografia  
 6var opt = new EncryptionOptions("user_password", "owner_password");  
 7
 8// Aggiungi il file PDF di input  
 9opt.AddInput(new FileDataSource("path_to_pdf"));  
10
11// Specifica il file PDF crittografato di output  
12opt.AddOutput(new FileDataSource("path_to_encrypted_pdf"));  
13
14// Esegui il processo di crittografia  
15plugin.Process(opt);  

Come Decriptare un Documento PDF

Per decriptare un documento PDF, segui questi passaggi:

1. Crea un’istanza della classe Security.
2. Crea un’istanza di DecryptionOptions con la password necessaria.
3. Aggiungi il file PDF crittografato utilizzando il metodo AddInput.
4. Imposta il percorso del file di output utilizzando AddOutput.
5. Esegui la decrittazione utilizzando il metodo Process.

 1  
 2// Instanzia il plugin di Sicurezza  
 3var plugin = new Security();  
 4
 5// Configura le opzioni di decrittazione  
 6var opt = new DecryptionOptions("user_password");  
 7
 8// Aggiungi il file PDF crittografato di input  
 9opt.AddInput(new FileDataSource("path_to_encrypted_pdf"));  
10
11// Specifica il file PDF decriptato di output  
12opt.AddOutput(new FileDataSource("path_to_decrypted_pdf"));  
13
14// Esegui il processo di decrittazione  
15plugin.Process(opt);  

Impostazione dei Permessi sui Documenti PDF

Quando criptando un PDF, puoi impostare vari permessi per controllare come il documento può essere utilizzato.

• Stampa: Consenti o vieta la stampa del documento.
• Copia: Consenti o vieta la copia dei contenuti.
• Modifica: Consenti o vieta modifiche al documento.

Per impostare i permessi, puoi configurare le EncryptionOptions di conseguenza.

Unione PDF

Il Documentize PDF Merger per .NET è uno strumento versatile progettato per unire più documenti PDF in un unico file. Semplifica la consolidazione dei file PDF, assicurando che i tuoi documenti vengano uniti in modo efficiente e mantenendo la coerenza del contenuto. Il plugin gestisce le risorse interne come caratteri e immagini per ottimizzare il documento unito.

Caratteristiche Principali:

• Unisci più PDF: Combina facilmente più file PDF in uno solo.
• Ottimizzazione delle Risorse: Rimuove i caratteri e le immagini duplicati durante l’unione.
• Elaborazione in Batch: Unisci grandi lotti di documenti PDF in un solo colpo.
• Unione Sicura: Garantire l’integrità del documento senza perdita di dati o corruzione dei contenuti.

Come unire documenti PDF

Per unire più documenti PDF in un unico file, segui questi passaggi:

1. Crea un’istanza della classe Merger.
2. Crea un’istanza di MergeOptions per configurare il processo di unione.
3. Aggiungi file PDF di input utilizzando il metodo AddInput.
4. Imposta il percorso del file di output utilizzando AddOutput.
5. Esegui l’unione utilizzando il metodo Process.

 1  
 2var merger = new Merger();  
 3var mergeOptions = new MergeOptions();  
 4
 5// Aggiungi file PDF di input da unire  
 6mergeOptions.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"));  
 7mergeOptions.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"));  
 8mergeOptions.AddInput(new FileDataSource(@"C:\Samples\file3.pdf"));  
 9
10// Specifica il percorso del file di output  
11mergeOptions.AddOutput(new FileDataSource(@"C:\Samples\mergedOutput.pdf"));  
12
13// Unisci i PDF  
14merger.Process(mergeOptions);  

Come unire PDF con intervallo di pagine

Puoi anche unire intervalli di pagine specifici dai file PDF di input utilizzando la classe MergeOptions. Questo ti consente di combinare pagine selezionate nel documento di output finale.

1. Crea un’istanza della classe Merger.
2. Configura gli intervalli di pagina utilizzando MergeOptions.
3. Aggiungi i file di input con intervalli di pagina specificati.
4. Imposta il percorso di output.
5. Chiama il metodo Process.

 1  
 2var merger = new Merger();  
 3var mergeOptions = new MergeOptions();  
 4
 5// Unisci pagine specifiche dai PDF di input  
 6mergeOptions.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"), new PageRange(1, 3));  
 7mergeOptions.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"), new PageRange(2, 5));  
 8
 9// Specifica il percorso del file di output  
10mergeOptions.AddOutput(new FileDataSource(@"C:\Samples\outputWithSpecificPages.pdf"));  
11
12// Unisci i PDF  
13merger.Process(mergeOptions);  

Come gestire l’unione in batch

Il plugin PDF Merger è ottimizzato per gestire grandi lotti di documenti PDF. Sfruttando la funzione di elaborazione in batch, puoi unire centinaia di PDF in un’unica operazione, garantendo una gestione dei documenti efficiente e rapida.

1. Instanzia la classe Merger.
2. Aggiungi tutti i file PDF di input alla classe MergeOptions.
3. Specifica il percorso di output.
4. Chiama il metodo Process per unire tutti i file del lotto.

 1  
 2var merger = new Merger();  
 3var mergeOptions = new MergeOptions();  
 4
 5// Aggiungi un grande lotto di PDF da unire  
 6for (int i = 1; i <= 100; i++)  
 7{  
 8    mergeOptions.AddInput(new FileDataSource($@"C:\Samples\file{i}.pdf"));  
 9}  
10
11// Specifica il percorso del file di output  
12mergeOptions.AddOutput(new FileDataSource(@"C:\Samples\batchMergedOutput.pdf"));  
13
14// Elabora l'unione in batch  
15merger.Process(mergeOptions);