Maîtriser GroupDocs.Signature pour .NET : extraire et afficher efficacement les informations des documents

Introduction

Vous souhaitez extraire efficacement des informations complètes des documents de vos applications ? Qu’il s’agisse de gérer des contrats, des accords ou des PDF de plusieurs pages, une solution robuste est essentielle. GroupDocs.Signature pour .NET offre de puissantes fonctionnalités conçues pour simplifier l’analyse des documents en récupérant et en affichant des éléments tels que les champs de formulaire, les signatures, les métadonnées, etc. Ce tutoriel vous guidera dans l’utilisation de ces fonctionnalités pour optimiser les fonctionnalités de votre application.

Ce que vous apprendrez :

Comment récupérer des informations détaillées sur un document à l’aide de GroupDocs.Signature pour .NET
Affichage de différents types de signatures et détails des champs de formulaire
Extraction de métadonnées et d’attributs spécifiques à la page

Passons en revue les prérequis avant de nous plonger dans la mise en œuvre.

Prérequis

Avant d’utiliser GroupDocs.Signature pour .NET, assurez-vous que votre environnement est correctement configuré. Ce tutoriel suppose une connaissance de C# et des notions de base en traitement de documents.

Bibliothèques et dépendances requises

GroupDocs.Signature pour .NET:La bibliothèque principale que nous utiliserons.
.NET Framework ou .NET Core:En fonction de la configuration de votre projet.

Configuration de l’environnement

Assurez-vous d’avoir un environnement de développement prêt avec Visual Studio ou un autre IDE approprié prenant en charge les projets .NET.

Prérequis en matière de connaissances

Compréhension de base de la programmation C#.
Connaissance des types de documents (PDF, Word, Excel) et de leurs propriétés.

Configuration de GroupDocs.Signature pour .NET

Pour utiliser GroupDocs.Signature pour .NET, vous devez installer la bibliothèque. Voici plusieurs méthodes :

Instructions d’installation

Utilisation de .NET CLI :

dotnet add package GroupDocs.Signature

Utilisation de la console du gestionnaire de packages :

Install-Package GroupDocs.Signature

Interface utilisateur du gestionnaire de packages NuGet : Recherchez « GroupDocs.Signature » dans le gestionnaire de packages NuGet et installez la dernière version.

Acquisition de licence

Pour tirer pleinement parti de GroupDocs.Signature, envisagez d’acquérir une licence :

Essai gratuit: Commencez par un essai gratuit pour explorer les fonctionnalités.
Licence temporaire:Obtenez une licence temporaire pour des tests prolongés.
Achat: Achetez une licence complète pour une utilisation en production.

Une fois installé et sous licence, initialisez votre projet en configurant l’environnement GroupDocs.Signature comme indiqué ci-dessous :

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

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // Définissez le chemin d'accès au fichier du document que vous souhaitez analyser
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // Remplacez par le chemin d'accès réel de votre document
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // D'autres opérations seront réalisées ici...
        }
    }
}

Guide de mise en œuvre

Une fois la configuration terminée, explorons comment implémenter diverses fonctionnalités de GroupDocs.Signature pour .NET.

Récupérer et afficher les propriétés de base du document

Aperçu: Extraire les propriétés essentielles telles que le format de fichier, la taille et le nombre de pages.

Mise en œuvre étape par étape :

Initialiser l’objet Signature: Créer une instance du Signature classe avec le chemin de votre document.
Méthode GetDocumentInfo:Utilisez le GetDocumentInfo() méthode pour récupérer des informations détaillées sur le document.
Afficher les propriétés du document: Affiche les propriétés de base telles que le format, l’extension et la taille à l’aide de Console.WriteLine à des fins de débogage ou de journalisation.

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

Afficher des informations sur chaque page du document

Aperçu: Plongez plus profondément en récupérant et en affichant des informations sur chaque page du document.

Mise en œuvre étape par étape :

Parcourir les pages: Boucle à travers documentInfo.Pages pour accéder aux détails de chaque page, comme la largeur et la hauteur.

foreach (PageInfo pageInfo in documentInfo.Pages)
{
    Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
}

Afficher les informations sur les signatures des champs de formulaire

Aperçu: Extraire et afficher les informations liées aux champs de formulaire dans le document.

Mise en œuvre étape par étape :

Champs du formulaire d’accès: Utiliser documentInfo.FormFields pour récupérer toutes les signatures de champs de formulaire présentes dans le document.
Afficher les détails de chaque champ de formulaire: Itérer sur chaque champ de formulaire et afficher son type, son nom et sa valeur.

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

Afficher diverses informations sur les signatures

Aperçu: Récupérez et affichez des informations pour les signatures de texte, d’image, numériques, de codes-barres, de codes QR, de champs de formulaire et de métadonnées.

Étapes de mise en œuvre :

Signatures de texte: Accéder documentInfo.TextSignatures pour obtenir des détails sur chaque signature de texte, y compris son identifiant, son emplacement, sa taille et ses dates de création.

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

Signatures d’images: Similaire aux signatures de texte, utilisez documentInfo.ImageSignatures pour des détails tels que la taille et le format des signatures d’image.

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

Signatures numériques:Pour les signatures numériques, utilisez documentInfo.DigitalSignatures pour extraire les identifiants de signature et les horodatages.

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

Signatures de codes-barres et de codes QR: Utiliser documentInfo.BarcodeSignatures et documentInfo.QrCodeSignatures pour collecter respectivement les détails du code-barres et du code 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}");
}

Conclusion

En suivant ce tutoriel, vous avez appris à exploiter GroupDocs.Signature pour .NET afin d’extraire et d’afficher efficacement des informations complètes sur vos documents. Ces compétences amélioreront la capacité de votre application à gérer vos documents avec précision et simplicité.

Prochaines étapes :

Découvrez les fonctionnalités supplémentaires de GroupDocs.Signature.
Implémentez la validation de signature dans vos applications.
Intégrez cette fonctionnalité dans des flux de travail plus vastes pour un traitement automatisé des documents.