Crea una nuova riga di firma e imposta l'ID del fornitore

Introduzione

Ciao, appassionati di tecnologia! Vi siete mai chiesti come aggiungere una riga di firma nei vostri documenti Word in modo programmatico? Bene, oggi ci immergiamo proprio in questo usando Aspose.Words per .NET. Questa guida vi guiderà in ogni passaggio, rendendo facile come bere un bicchier d’acqua la creazione di una nuova riga di firma e l’impostazione dell’ID provider nei vostri documenti Word. Che stiate automatizzando l’elaborazione dei documenti o che stiate semplicemente cercando di semplificare il vostro flusso di lavoro, questo tutorial vi coprirà le spalle.

Prerequisiti

Prima di sporcarci le mani, assicuriamoci di avere tutto ciò di cui abbiamo bisogno:

  1. Aspose.Words per .NET: se non lo hai ancora fatto, scaricaloQui.
  2. Ambiente di sviluppo: Visual Studio o qualsiasi altro ambiente di sviluppo C#.
  3. .NET Framework: assicurati di aver installato .NET Framework.
  4. Certificato PFX: per firmare documenti, avrai bisogno di un certificato PFX. Puoi ottenerne uno da un’autorità di certificazione attendibile.

Importazione degli spazi dei nomi

Per prima cosa, importiamo gli spazi dei nomi necessari nel tuo progetto C#:

using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Signing;
using System;

Bene, veniamo al dunque. Ecco una ripartizione dettagliata di ogni passaggio per creare una nuova riga di firma e impostare l’ID del provider.

Passaggio 1: creare un nuovo documento

Per iniziare, dobbiamo creare un nuovo documento Word. Questo sarà il canvas per la nostra riga di firma.

// Percorso verso la directory dei documenti.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

In questo frammento, stiamo inizializzando un nuovoDocument e unDocumentBuilder . ILDocumentBuilder ci aiuta ad aggiungere elementi al nostro documento.

Passaggio 2: definire le opzioni della riga della firma

Successivamente, definiamo le opzioni per la nostra riga di firma. Ciò include il nome del firmatario, il titolo, l’email e altri dettagli.

SignatureLineOptions signatureLineOptions = new SignatureLineOptions
{
    Signer = "vderyushev",
    SignerTitle = "QA",
    Email = "vderyushev@aspose.com",
    ShowDate = true,
    DefaultInstructions = false,
    Instructions = "Please sign here.",
    AllowComments = true
};

Queste opzioni personalizzano la riga della firma, rendendola chiara e professionale.

Passaggio 3: inserire la riga della firma

Una volta impostate le opzioni, possiamo ora inserire la riga della firma nel documento.

SignatureLine signatureLine = builder.InsertSignatureLine(signatureLineOptions).SignatureLine;
signatureLine.ProviderId = Guid.Parse("CF5A7BB4-8F3C-4756-9DF6-BEF7F13259A2");

Qui, ilInsertSignatureLine aggiunge la riga della firma e le assegniamo un ID provider univoco.

Passaggio 4: Salvare il documento

Dopo aver inserito la riga della firma, salviamo il documento.

doc.Save(dataDir + "SignDocuments.SignatureLineProviderId.docx");

In questo modo il documento verrà salvato con la nuova riga della firma aggiunta.

Passaggio 5: Imposta le opzioni di firma

Ora, dobbiamo impostare le opzioni per firmare il documento. Ciò include l’ID della riga di firma, l’ID del provider, i commenti e l’ora della firma.

SignOptions signOptions = new SignOptions
{
    SignatureLineId = signatureLine.Id,
    ProviderId = signatureLine.ProviderId,
    Comments = "Document was signed by vderyushev",
    SignTime = DateTime.Now
};

Queste opzioni garantiscono che il documento venga firmato con i dati corretti.

Passaggio 6: creare il titolare del certificato

Per firmare il documento, useremo un certificato PFX. Creiamo un titolare del certificato per esso.

CertificateHolder certHolder = CertificateHolder.Create(dataDir + "morzal.pfx", "aw");

Assicurati di sostituire"morzal.pfx" con il tuo file di certificato effettivo e"aw" con la password del certificato.

Fase 7: Firmare il documento

Infine, firmiamo il documento utilizzando lo strumento di firma digitale.

DigitalSignatureUtil.Sign(dataDir + "SignDocuments.SignatureLineProviderId.docx", 
    dataDir + "SignDocuments.CreateNewSignatureLineAndSetProviderId.docx", certHolder, signOptions);

Questo firma il documento e lo salva come nuovo file.

Conclusione

Ed ecco fatto! Hai creato con successo una nuova riga di firma e impostato l’ID del provider in un documento Word utilizzando Aspose.Words per .NET. Questa potente libreria semplifica incredibilmente la gestione e l’automazione delle attività di elaborazione dei documenti. Provala e scopri come può semplificare il tuo flusso di lavoro.

Domande frequenti

Posso personalizzare l’aspetto della riga della firma?

Assolutamente! Puoi modificare varie opzioni inSignatureLineOptions per soddisfare le tue esigenze.

Cosa succede se non ho un certificato PFX?

Dovrai ottenerne uno da un’autorità di certificazione attendibile. È essenziale per la firma digitale dei documenti.

Posso aggiungere più righe di firma a un documento?

Sì, puoi aggiungere tutte le righe di firma che desideri ripetendo il processo di inserimento con opzioni diverse.

Aspose.Words per .NET è compatibile con .NET Core?

Sì, Aspose.Words per .NET supporta .NET Core, rendendolo versatile per diversi ambienti di sviluppo.

Quanto sono sicure le firme digitali?

Le firme digitali create con Aspose.Words sono estremamente sicure, a condizione che si utilizzi un certificato valido e attendibile.