Signature et vérification de documents maîtres avec GroupDocs.Signature pour .NET

Comment maîtriser la signature et la vérification de documents avec GroupDocs.Signature pour .NET

Dans le paysage numérique actuel, des solutions efficaces de signature de documents sont essentielles pour la gestion des contrats, des accords et de tout autre document juridique. L’automatisation de ce processus permet de gagner du temps et de réduire les erreurs. GroupDocs.Signature pour .NET Offre une solution robuste pour simplifier la gestion des signatures textuelles dans vos applications. Ce guide complet vous présente les fonctionnalités de GroupDocs.Signature pour .NET, notamment la signature, la vérification, la recherche, la mise à jour et la suppression des signatures textuelles.

Ce que vous apprendrez

  • Comment signer des documents avec des signatures textuelles personnalisables
  • Techniques pour vérifier efficacement les documents signés
  • Méthodes de recherche de signatures de texte existantes dans les documents
  • Étapes pour mettre à jour et supprimer les signatures de texte selon les besoins
  • Bonnes pratiques pour optimiser les performances et la gestion de la mémoire

Commençons par passer en revue les prérequis.

Prérequis

Avant de commencer, assurez-vous que votre environnement de développement est configuré avec les outils nécessaires :

Bibliothèques et dépendances requises

  • GroupDocs.Signature pour .NET:Cette bibliothèque vous permet d’ajouter des fonctionnalités de signature dans vos applications.
  • .NET Framework 4.6.1 ou supérieur (ou .NET Core 2.x+)

Configuration requise pour l’environnement

Vous aurez besoin d’un environnement de développement C#, tel que Visual Studio, et d’une connexion Internet pour télécharger les packages nécessaires.

Prérequis en matière de connaissances

Il est recommandé de maîtriser les concepts de base de la programmation C#. Si vous débutez avec GroupDocs.Signature pour .NET, pas d’inquiétude : ce guide vous guidera pas à pas.

Configuration de GroupDocs.Signature pour .NET

Pour commencer, vous devez installer la bibliothèque GroupDocs.Signature dans votre projet. Voici comment procéder :

Installation via .NET CLI

dotnet add package GroupDocs.Signature

Console du gestionnaire de paquets

Install-Package GroupDocs.Signature

Interface utilisateur du gestionnaire de packages NuGet

  1. Ouvrez votre projet dans Visual Studio.
  2. Accéder à Outils > Gestionnaire de packages NuGet > Gérer les packages NuGet pour la solution.
  3. Recherchez « GroupDocs.Signature » et installez la dernière version.

Étapes d’acquisition de licence

Initialisation et configuration de base

Après l’installation, initialisez GroupDocs.Signature dans votre projet comme suit :

using GroupDocs.Signature;

// Initialisez l'instance Signature avec le chemin du document.
Signature signature = new Signature("path/to/your/document.pdf");

Maintenant que vous êtes configuré, explorons comment exploiter GroupDocs.Signature pour diverses fonctionnalités.

Guide de mise en œuvre

Signer un document avec une signature textuelle

Cette fonctionnalité vous permet d’ajouter des signatures textuelles à un document. Détaillons-la :

Aperçu

Vous pouvez personnaliser l’apparence et la position de votre signature de texte à l’aide de diverses options telles que la taille de la police, la couleur, l’alignement, etc.

Mise en œuvre étape par étape

Étape 1: Définissez le chemin du fichier et l’emplacement de sortie.

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // Chemin vers le document original
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");

Étape 2: Créez une signature de texte en utilisant 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" }
    };

Étape 3: Signez le document et affichez les résultats.

    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}");
    }
}

Options de configuration clés

  • Alignement vertical et alignement horizontalContrôlez où la signature apparaît sur la page.
  • Fonte:Personnalisez la taille et le style de la police pour votre signature de texte.

Vérifier le document pour la signature du texte

La vérification garantit qu’un document a été signé comme prévu. Voici comment la mettre en œuvre :

Aperçu

Vérifiez les signatures de texte existantes dans vos documents pour confirmer leur authenticité et leur intégrité.

Mise en œuvre étape par étape

Étape 1: Spécifiez le chemin d’accès au fichier du document signé.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Chemin vers le document signé

Étape 2: Créez des options de vérification à l’aide de TextVerifyOptions.

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

Étape 3:Vérifiez le document.

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

Conseils de dépannage

  • Assurer la Text la propriété correspond exactement à ce qui se trouve dans le document.
  • Vérifie ça PageNumber correspond à la page correcte contenant la signature.

Rechercher une signature textuelle dans un document

Localisez efficacement les signatures de texte dans vos documents à l’aide de cette fonctionnalité.

Aperçu

Recherchez dans toutes les pages ou dans certaines pages d’un document pour trouver des signatures de texte spécifiques.

Mise en œuvre étape par étape

Étape 1: Définissez le chemin du fichier.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Chemin vers le document signé

Étape 2: Utiliser TextSearchOptions pour la recherche.

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

Étape 3: Exécuter la recherche.

    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}.");
        }
    }
}

Mettre à jour la signature du texte du document

Modifiez les signatures de texte existantes dans un document si nécessaire.

Aperçu

Ajustez les propriétés des signatures de texte existantes, telles que la taille et l’emplacement.

Mise en œuvre étape par étape

Étape 1: Spécifiez le chemin du fichier et les ID de signature.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Chemin vers le document signé
List<string> signatureIds = new List<string>(); // Supposons que cette liste soit remplie d'identifiants de signature valides

Étape 2: Créer TextSignature objets pour les mises à jour.

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
        };

Étape 3: Mettre à jour le document.

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

Options de configuration clés

  • Largeur et hauteur: Ajustez la taille de la signature.
  • Alignement horizontal: Contrôlez où la signature mise à jour apparaît sur la page.

Conclusion

En suivant ce guide, vous avez appris à signer, vérifier, rechercher, mettre à jour et supprimer des signatures textuelles dans des documents avec GroupDocs.Signature pour .NET. Ces fonctionnalités sont essentielles pour automatiser les processus de signature numérique dans vos applications. Pour plus d’informations et découvrir les options avancées, consultez le documentation officielle.