Padroneggiare la gestione dei documenti: implementazione dell’integrazione della firma del codice a barre .NET con GroupDocs.Signature

Nell’era digitale odierna, garantire l’autenticità e l’integrità dei documenti è fondamentale in diversi settori. Questa guida illustra come integrare le firme con codice a barre nel flusso di lavoro documentale utilizzando GroupDocs.Signature per .NETChe tu debba firmare, verificare, cercare, aggiornare o eliminare firme con codice a barre nei documenti, questo tutorial coprirà tutti gli aspetti essenziali.

Cosa imparerai

  • Impostazione di GroupDocs.Signature per .NET
  • Firmare un documento con una firma con codice a barre passo dopo passo
  • Tecniche per la verifica, la ricerca, l’aggiornamento e l’eliminazione delle firme dei codici a barre
  • Esplorazione delle applicazioni del mondo reale e delle possibilità di integrazione
  • Ottimizzazione delle prestazioni e gestione efficace delle risorse

Pronti a migliorare il vostro sistema di gestione documentale? Cominciamo!

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

  • .NET Core 3.1 o installato successivamente sul tuo computer.
  • Conoscenza di base della programmazione C# e familiarità con la configurazione dell’ambiente .NET.

Librerie e dipendenze richieste

Per iniziare a utilizzare GroupDocs.Signature per .NET, installare la libreria tramite un gestore di pacchetti:

Interfaccia a riga di comando .NET

dotnet add package GroupDocs.Signature

Gestore dei pacchetti

Install-Package GroupDocs.Signature

Interfaccia utente del gestore pacchetti NuGet

Cerca “GroupDocs.Signature” e installa la versione più recente.

Acquisizione della licenza

Ottieni una prova gratuita, una licenza temporanea o acquista una licenza completa da Documenti di gruppoSe desideri effettuare una prova prima di acquistare, segui le istruzioni per ottenere una licenza temporanea.

Impostazione di GroupDocs.Signature per .NET

Una volta installata la libreria, inizializza e configura l’applicazione con una licenza valida. Ecco come procedere:

  1. Installa GroupDocs.Signature: Utilizzare uno dei comandi del gestore pacchetti menzionati sopra.
  2. Acquisisci licenza: Segui il fasi di acquisizione della licenza per l’opzione scelta.
  3. Inizializza GroupDocs.Signature:
    // Richiedi la licenza se ne hai una
License lic = new License();
lic.SetLicense("path/to/your/license/file.lic");

Guida all’implementazione

Esplora le funzionalità principali dell’implementazione dell’integrazione della firma del codice a barre .NET con GroupDocs.Signature.

Firma il documento con la firma del codice a barre

Panoramica

Questa funzione mostra come firmare un documento utilizzando una firma con codice a barre, incorporando testo specifico codificato nel codice a barre per una maggiore sicurezza.

Fasi di implementazione

  1. Prepara il tuo ambiente: Assicurati di aver impostato le directory di origine e di output.
  2. Impostare le opzioni di firma:
    string filePath = "YOUR_DOCUMENT_DIRECTORY/YourDocument.docx";
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");
string bcText = "John Smith";

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

    SignResult signResult = signature.Sign(outputFilePath, signOptions);
}
  3. Comprendere i parametri:
    • bcText: Il testo che si desidera codificare nel codice a barre.
    • BarcodeTypes.Code128: Specifica il tipo di codice a barre.
    • Opzioni di aspetto come VerticalAlignment, HorizontalAlignment, Width, E Height determina l’aspetto della tua firma sul documento.

Verifica del documento per la firma del codice a barre

Panoramica

Verificare se un documento contiene una firma con codice a barre specifica per confermarne l’autenticità.

Fasi di implementazione

  1. Imposta le opzioni di verifica:
    string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
string bcText = "John Smith";

using (Signature signature = new Signature(outputFilePath))
{
    BarcodeVerifyOptions verifyOptions = new BarcodeVerifyOptions()
    {
        AllPages = false,
        PageNumber = 1,
        EncodeType = BarcodeTypes.Code128,
        Text = bcText
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);
}
  2. Spiegazione:
    • AllPages: Controlla se il codice a barre è presente su tutte le pagine o solo su una specifica.
    • PageNumber: Specificare quale pagina controllare per la verifica.

Cerca documento per firma con codice a barre

Panoramica

Cerca in un documento eventuali firme con codice a barre esistenti, utili per audit e controlli di integrità.

Fasi di implementazione

  1. Imposta le opzioni di ricerca:
    string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";

using (Signature signature = new Signature(outputFilePath))
{
    BarcodeSearchOptions searchOptions = new BarcodeSearchOptions()
    {
        AllPages = true
    };

    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(searchOptions);
}
  2. Punti chiave:
    • AllPages: Impostare su true se si desidera che la ricerca copra tutte le pagine.

Aggiorna la firma del codice a barre del documento

Panoramica

Modificare le firme con codice a barre esistenti in un documento, adattandone la posizione o le dimensioni secondo necessità.

Fasi di implementazione

  1. Individuare e modificare le firme:
    string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
List<BarcodeSignature> signatures = new List<BarcodeSignature>(); // Si supponga che sia popolato con firme con codice a barre

foreach (BarcodeSignature bcSignature in signatures)
{
    bcSignature.Left += 100;
    bcSignature.Top += 100;
    bcSignature.Width = 200;
    bcSignature.Height = 50;
}

List<BaseSignature> signaturesToUpdate = signatures.ConvertAll(p => (BaseSignature)p);

using (Signature signature = new Signature(outputFilePath))
{
    UpdateResult updateResult = signature.Update(signaturesToUpdate);
}
  2. Spiegazione:
    • Regolare Left, Top, Width, E Height per riposizionare o ridimensionare le firme.

Elimina la firma del codice a barre del documento tramite ID

Panoramica

Rimuovi specifiche firme con codice a barre da un documento utilizzando i loro ID univoci, utile per ripulire voci obsolete o errate.

Fasi di implementazione

  1. Imposta le opzioni di eliminazione:
    string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
List<string> signatureIds = new List<string>(); // Supponiamo che questo elenco contenga gli ID delle firme da eliminare

List<BaseSignature> signaturesToUpdate = new List<BaseSignature>();
foreach (var item in signatureIds)
{
    BarcodeSignature temp = new BarcodeSignature(item);
    signaturesToUpdate.Add(temp);
}

using (Signature signature = new Signature(outputFilePath))
{
    DeleteResult deleteResult = signature.Delete(signaturesToUpdate);
}
  2. Punti chiave:
    • signatureIdsElenco degli ID delle firme con codice a barre da eliminare.

Applicazioni pratiche

  1. Verifica dei documenti legali: Garantire l’autenticità firmando i contratti con un codice a barre univoco.
  2. Istituzioni educative: Verificare i documenti degli studenti, come carte d’identità o trascrizioni.
  3. Contratti commerciali: Firma e verifica in modo sicuro gli accordi commerciali.
  4. Cartelle cliniche: Mantenere l’integrità delle cartelle cliniche dei pazienti.
  5. Gestione della catena di approvvigionamento: Traccia e autentica le spedizioni utilizzando firme con codice a barre.

Considerazioni sulle prestazioni

  • Ove possibile, utilizzare metodi asincroni per ottimizzare le prestazioni, riducendo i tempi di caricamento nelle applicazioni con elevati requisiti di elaborazione dei documenti.