Padroneggiare GroupDocs.Signature per .NET: estrarre e visualizzare le informazioni sui documenti in modo efficiente

Introduzione

Desideri estrarre in modo efficiente dettagli completi dai documenti all’interno delle tue applicazioni? Che si tratti di gestire contratti, accordi o PDF multipagina, una soluzione affidabile è essenziale. GroupDocs.Signature per .NET Offre potenti funzionalità progettate per semplificare l’analisi dei documenti recuperando e visualizzando elementi come campi modulo, firme, metadati e altro ancora. Questo tutorial ti guiderà nell’utilizzo di queste funzionalità per migliorare le funzionalità della tua applicazione.

Cosa imparerai:

  • Come recuperare informazioni dettagliate sui documenti utilizzando GroupDocs.Signature per .NET
  • Visualizzazione di vari tipi di firma e dettagli dei campi del modulo
  • Estrazione di metadati e attributi specifici della pagina

Prima di passare all’implementazione, esaminiamo i prerequisiti.

Prerequisiti

Prima di utilizzare GroupDocs.Signature per .NET, assicurati che il tuo ambiente sia configurato correttamente. Questo tutorial presuppone familiarità con C# e conoscenze di base sui concetti di elaborazione dei documenti.

Librerie e dipendenze richieste

  • GroupDocs.Signature per .NET: La libreria principale che utilizzeremo.
  • .NET Framework o .NET Core: A seconda della configurazione del progetto.

Configurazione dell’ambiente

Assicurati di avere un ambiente di sviluppo pronto con Visual Studio o un altro IDE adatto che supporti i progetti .NET.

Prerequisiti di conoscenza

  • Conoscenza di base della programmazione C#.
  • Familiarità con i tipi di documento (PDF, Word, Excel) e le loro proprietà.

Impostazione di GroupDocs.Signature per .NET

Per utilizzare GroupDocs.Signature per .NET, è necessario installare la libreria. Ecco diversi metodi:

Istruzioni per l’installazione

Utilizzo di .NET CLI:

dotnet add package GroupDocs.Signature

Utilizzo della console di Package Manager:

Install-Package GroupDocs.Signature

Interfaccia utente del gestore pacchetti NuGet: Cerca “GroupDocs.Signature” in NuGet Package Manager e installa la versione più recente.

Acquisizione della licenza

Per sfruttare appieno GroupDocs.Signature, valuta l’acquisto di una licenza:

  • Prova gratuita: Inizia con una prova gratuita per esplorare le funzionalità.
  • Licenza temporanea: Ottenere una licenza temporanea per test prolungati.
  • Acquistare: Acquista una licenza completa per l’uso in produzione.

Una volta installato e ottenuto il permesso, inizializza il tuo progetto configurando l’ambiente GroupDocs.Signature come mostrato di seguito:

using System;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // Definisci il percorso del file per il documento che vuoi analizzare
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // Sostituisci con il percorso effettivo del tuo documento
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // Ulteriori operazioni verranno eseguite qui...
        }
    }
}

Guida all’implementazione

Una volta completata la configurazione, vediamo come implementare le varie funzionalità di GroupDocs.Signature per .NET.

Recupera e visualizza le proprietà di base del documento

Panoramica: Estrai proprietà essenziali come formato del file, dimensione e numero di pagine.

Implementazione passo dopo passo:

  1. Inizializza l’oggetto firma: Crea un’istanza di Signature classe con il percorso del tuo documento.
  2. Metodo GetDocumentInfo: Usa il GetDocumentInfo() metodo per recuperare informazioni dettagliate sul documento.
  3. Visualizza le proprietà del documento: Emette proprietà di base come formato, estensione e dimensione utilizzando Console.WriteLine per scopi di debug o registrazione.
IDocumentInfo documentInfo = signature.GetDocumentInfo();
Console.WriteLine($"Document properties {Path.GetFileName(filePath)}:");
Console.WriteLine($" - format : {documentInfo.FileType.FileFormat}");
Console.WriteLine($" - extension : {documentInfo.FileType.Extension}");
Console.WriteLine($" - size : {documentInfo.Size}");
Console.WriteLine($" - page count : {documentInfo.PageCount}");

Visualizza informazioni su ciascuna pagina del documento

Panoramica: Approfondisci recuperando e visualizzando informazioni su ogni pagina del documento.

Implementazione passo dopo passo:

  1. Scorrere le pagine: Passa attraverso documentInfo.Pages per accedere ai dettagli delle singole pagine, come larghezza e altezza.
foreach (PageInfo pageInfo in documentInfo.Pages)
{
    Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
}

Visualizza informazioni sulle firme dei campi del modulo

Panoramica: Estrai e visualizza le informazioni relative ai campi del modulo all’interno del documento.

Implementazione passo dopo passo:

  1. Campi del modulo di accesso: Utilizzo documentInfo.FormFields per recuperare tutte le firme dei campi modulo presenti nel documento.
  2. Visualizza i dettagli di ciascun campo del modulo: Esegui l’iterazione su ciascun campo del modulo e visualizza il suo tipo, nome e valore.
Console.WriteLine($"Document Form Fields information: count = {documentInfo.FormFields.Count}");
foreach (FormFieldSignature formField in documentInfo.FormFields)
{
    Console.WriteLine($" - type #{formField.Type}: Name: {formField.Name} Value: {formField.Value}");
}

Visualizza varie informazioni sulle firme

Panoramica: Recupera e visualizza informazioni per firme di testo, immagini, digitali, codici a barre, codici QR, campi modulo e metadati.

Fasi di implementazione:

  • Firme di testo: Accesso documentInfo.TextSignatures per ottenere dettagli su ciascuna firma di testo, tra cui ID, posizione, dimensione e data di creazione.
Console.WriteLine($"Document Text signatures: {documentInfo.TextSignatures.Count}");
foreach (TextSignature textSignature in documentInfo.TextSignatures)
{
    Console.WriteLine($" - #{textSignature.SignatureId}: Text: {textSignature.Text} Location: {textSignature.Left}x{textSignature.Top}. Size: {textSignature.Width}x{textSignature.Height}. CreatedOn/ModifiedOn: {textSignature.CreatedOn.ToShortDateString()} / {textSignature.ModifiedOn.ToShortDateString()}");
}
  • Firme delle immagini: Simile alle firme di testo, usa documentInfo.ImageSignatures per dettagli quali dimensioni e formato delle firme delle immagini.
Console.WriteLine($"Document Image signatures: {documentInfo.ImageSignatures.Count}");
foreach (ImageSignature imageSignature in documentInfo.ImageSignatures)
{
    Console.WriteLine($" - #{imageSignature.SignatureId}: Size: {imageSignature.Size} bytes, Format: {imageSignature.Format}. CreatedOn/ModifiedOn: {imageSignature.CreatedOn.ToShortDateString()} / {imageSignature.ModifiedOn.ToShortDateString()}");
}
  • Firme digitali: Per le firme digitali, utilizzare documentInfo.DigitalSignatures per estrarre gli ID delle firme e i timestamp.
Console.WriteLine($"Document Digital signatures: {documentInfo.DigitalSignatures.Count}");
foreach (DigitalSignature digitalSignature in documentInfo.DigitalSignatures)
{
    Console.WriteLine($" - #{digitalSignature.SignatureId}. CreatedOn/ModifiedOn: {digitalSignature.CreatedOn.ToShortDateString()} / {digitalSignature.ModifiedOn.ToShortDateString()}");
}
  • Firme con codice a barre e codice QR: Utilizzo documentInfo.BarcodeSignatures E documentInfo.QrCodeSignatures per raccogliere rispettivamente i dettagli del codice a barre e del codice QR.
Console.WriteLine($"Document Barcode signatures: {documentInfo.BarcodeSignatures.Count}");
foreach (BarcodeSignature barcodeSignature in documentInfo.BarcodeSignatures)
{
    Console.WriteLine($" - #{barcodeSignature.SignatureId}: Type: {barcodeSignature.EncodeType?.TypeName}. Text: {barcodeSignature.Text}");
}

Console.WriteLine($"Document QR Code signatures: {documentInfo.QrCodeSignatures.Count}");
foreach (QrCodeSignature qrCodeSignature in documentInfo.QrCodeSignatures)
{
    Console.WriteLine($" - #{qrCodeSignature.SignatureId}: Type: {qrCodeSignature.EncodeType?.TypeName}. Text: {qrCodeSignature.Text}");
}

Conclusione

Seguendo questo tutorial, hai imparato come sfruttare GroupDocs.Signature per .NET per estrarre e visualizzare in modo efficiente informazioni complete sui documenti. Queste competenze miglioreranno la capacità della tua applicazione di gestire i documenti con precisione e semplicità.

Prossimi passi:

  • Esplora le funzionalità aggiuntive di GroupDocs.Signature.
  • Implementa la convalida della firma nelle tue applicazioni.
  • Integrare questa funzionalità in flussi di lavoro più ampi per l’elaborazione automatizzata dei documenti.