Firma e verifica dei documenti master con GroupDocs.Signature per .NET

Come padroneggiare la firma e la verifica dei documenti con GroupDocs.Signature per .NET

Nell’attuale panorama digitale, soluzioni efficienti per la firma dei documenti sono fondamentali per la gestione di contratti, accordi o qualsiasi altro documento legale. L’automazione di questo processo consente di risparmiare tempo e ridurre gli errori. GroupDocs.Signature per .NET Offre una soluzione affidabile per semplificare la gestione delle firme testuali nelle vostre applicazioni. Questa guida completa vi illustrerà le funzionalità di GroupDocs.Signature per .NET, tra cui la firma, la verifica, la ricerca, l’aggiornamento e l’eliminazione delle firme testuali.

Cosa imparerai

  • Come firmare documenti con firme di testo personalizzabili
  • Tecniche per verificare efficacemente i documenti firmati
  • Metodi per cercare firme di testo esistenti nei documenti
  • Passaggi per aggiornare ed eliminare le firme di testo secondo necessità
  • Best practice per ottimizzare le prestazioni e la gestione della memoria

Cominciamo esaminando i prerequisiti.

Prerequisiti

Prima di iniziare, assicurati che l’ambiente di sviluppo sia configurato con gli strumenti necessari:

Librerie e dipendenze richieste

  • GroupDocs.Signature per .NET: Questa libreria consente di aggiungere funzionalità di firma nelle applicazioni.
  • .NET Framework 4.6.1 o versione successiva (o .NET Core 2.x+)

Requisiti di configurazione dell’ambiente

Per scaricare i pacchetti necessari, avrai bisogno di un ambiente di sviluppo C#, come Visual Studio, e di una connessione Internet.

Prerequisiti di conoscenza

Si consiglia di avere familiarità con i concetti base della programmazione C#. Se non hai familiarità con GroupDocs.Signature per .NET, non preoccuparti: questa guida ti guiderà passo dopo passo.

Impostazione di GroupDocs.Signature per .NET

Per iniziare, dovrai installare la libreria GroupDocs.Signature nel tuo progetto. Ecco come fare:

Installazione tramite .NET CLI

dotnet add package GroupDocs.Signature

Console del gestore dei pacchetti

Install-Package GroupDocs.Signature

Interfaccia utente del gestore pacchetti NuGet

  1. Apri il tuo progetto in Visual Studio.
  2. Vai a Utensili > Gestore pacchetti NuGet > Gestisci i pacchetti NuGet per la soluzione.
  3. Cerca “GroupDocs.Signature” e installa la versione più recente.

Fasi di acquisizione della licenza

Inizializzazione e configurazione di base

Dopo l’installazione, inizializza GroupDocs.Signature nel tuo progetto come segue:

using GroupDocs.Signature;

// Inizializza l'istanza della firma con il percorso del documento.
Signature signature = new Signature("path/to/your/document.pdf");

Ora che hai impostato tutto, vediamo come sfruttare GroupDocs.Signature per diverse funzionalità.

Guida all’implementazione

Firma il documento con la firma testuale

Questa funzionalità consente di aggiungere firme testuali a un documento. Vediamola nel dettaglio:

Panoramica

Puoi personalizzare l’aspetto e la posizione della tua firma testuale utilizzando varie opzioni come la dimensione del carattere, il colore, l’allineamento, ecc.

Implementazione passo dopo passo

Fase 1: Definisce il percorso del file e la posizione di output.

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // Percorso al documento originale
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");

Fase 2: Crea una firma di testo utilizzando TextSignOptions.

using (Signature signature = new Signature(filePath))
{
    TextSignOptions signOptions = new TextSignOptions("John Smith")
    {
        VerticalAlignment = GroupDocs.Signature.Options.VerticalAlignment.Top,
        HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Center,
        Width = 100,
        Height = 40,
        Margin = new Padding(20),
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };

Fase 3: Firma il documento e visualizza i risultati.

    SignResult signResult = signature.Sign(outputFilePath, signOptions);
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signed Text Signature: Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}

Opzioni di configurazione chiave

  • Allineamento verticale e allineamento orizzontaleControlla dove appare la firma sulla pagina.
  • Font: Personalizza la dimensione e lo stile del carattere per la tua firma testuale.

Verifica il documento per la firma del testo

La verifica garantisce che un documento sia stato firmato come previsto. Ecco come implementarla:

Panoramica

Verifica le firme testuali esistenti nei tuoi documenti per confermarne l’autenticità e l’integrità.

Implementazione passo dopo passo

Fase 1: Specificare il percorso del file del documento firmato.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Percorso al documento firmato

Fase 2: Crea opzioni di verifica utilizzando TextVerifyOptions.

using (Signature signature = new Signature(filePath))
{
    TextVerifyOptions verifyOptions = new TextVerifyOptions()
    {
        AllPages = false,
        PageNumber = 1,
        Text = "John Smith",
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact
    };

Fase 3: Verifica il documento.

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Document was verified successfully!");
    }
    else
    {
        Console.WriteLine("Document failed verification process.");
    }
}

Suggerimenti per la risoluzione dei problemi

  • Assicurare il Text la proprietà corrisponde esattamente a ciò che è presente nel documento.
  • Controlla che PageNumber corrisponde alla pagina corretta contenente la firma.

Cerca documento per firma di testo

Grazie a questa funzionalità puoi individuare in modo efficiente le firme testuali nei tuoi documenti.

Panoramica

Cerca in tutte le pagine o in quelle selezionate di un documento per trovare firme di testo specifiche.

Implementazione passo dopo passo

Fase 1: Definisce il percorso del file.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Percorso al documento firmato

Fase 2: Utilizzo TextSearchOptions per la ricerca.

using (Signature signature = new Signature(filePath))
{
    TextSearchOptions searchOptions = new TextSearchOptions()
    {
        AllPages = true,
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact,
        Text = "John Smith"
    };

Fase 3: Esegui la ricerca.

    List<TextSignature> signatures = signature.Search<TextSignature>(searchOptions);
    foreach (TextSignature textSignature in signatures)
    {
        if (textSignature != null)
        {
            Console.WriteLine($"Found Text signature at page {textSignature.PageNumber} with type [{textSignature.SignatureImplementation}] and text '{textSignature.Text}'. Location: {textSignature.Left}-{textSignature.Top}. Size is {textSignature.Width}x{textSignature.Height}.");
        }
    }
}

Aggiorna la firma del testo del documento

Modificare le firme di testo esistenti in un documento quando necessario.

Panoramica

Regola le proprietà delle firme di testo esistenti, come dimensioni e posizione.

Implementazione passo dopo passo

Fase 1: Specificare il percorso del file e gli ID della firma.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Percorso al documento firmato
List<string> signatureIds = new List<string>(); // Supponiamo che questo elenco sia popolato con ID di firma validi

Fase 2: Crea TextSignature oggetti per gli aggiornamenti.

using (Signature signature = new Signature(filePath))
{
    foreach (var item in signatureIds)
    {
        TextSignature temp = new TextSignature(item)
        {
            Width = 150,
            Height = 50,
            HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Right
        };

Fase 3: Aggiorna il documento.

        SignResult signResult = signature.UpdateSignatures(temp);
        if (signResult.Succeeded.Count > 0)
        {
            Console.WriteLine($"Updated Text Signature: Id:{temp.SignatureId}");
        }
    }
}

Opzioni di configurazione chiave

  • Larghezza e altezza: Regola la dimensione della firma.
  • Allineamento orizzontale: Controlla dove appare la firma aggiornata sulla pagina.

Conclusione

Seguendo questa guida, hai imparato come firmare, verificare, cercare, aggiornare ed eliminare firme testuali nei documenti utilizzando GroupDocs.Signature per .NET. Queste funzionalità sono essenziali per automatizzare i processi di firma digitale nelle tue applicazioni. Per informazioni più dettagliate e opzioni avanzate, consulta la pagina documentazione ufficiale.