Dominando GroupDocs.Signature para .NET: Extraiga y muestre información de documentos de manera eficiente

Introducción

¿Busca extraer eficientemente información completa de documentos en sus aplicaciones? Ya sea para gestionar contratos, acuerdos o PDF de varias páginas, una solución robusta es esencial. GroupDocs.Signature para .NET Ofrece potentes funciones diseñadas para optimizar el análisis de documentos mediante la recuperación y visualización de elementos como campos de formulario, firmas, metadatos y más. Este tutorial le guiará en el uso de estas funciones para optimizar la funcionalidad de su aplicación.

Lo que aprenderás:

Cómo recuperar información detallada de un documento usando GroupDocs.Signature para .NET
Visualización de varios tipos de firmas y detalles de campos de formulario
Extracción de metadatos y atributos específicos de la página

Repasemos los requisitos previos antes de sumergirnos en la implementación.

Prerrequisitos

Antes de usar GroupDocs.Signature para .NET, asegúrese de que su entorno esté configurado correctamente. Este tutorial presupone familiaridad con C# y conocimientos básicos de procesamiento de documentos.

Bibliotecas y dependencias requeridas

GroupDocs.Signature para .NET:La biblioteca principal que usaremos.
.NET Framework o .NET Core:Dependiendo de la configuración de su proyecto.

Configuración del entorno

Asegúrese de tener un entorno de desarrollo listo con Visual Studio u otro IDE adecuado que admita proyectos .NET.

Requisitos previos de conocimiento

Comprensión básica de programación en C#.
Familiaridad con los tipos de documentos (PDF, Word, Excel) y sus propiedades.

Configuración de GroupDocs.Signature para .NET

Para usar GroupDocs.Signature para .NET, necesita instalar la biblioteca. Aquí tiene varios métodos:

Instrucciones de instalación

Usando la CLI .NET:

dotnet add package GroupDocs.Signature

Uso de la consola del administrador de paquetes:

Install-Package GroupDocs.Signature

Interfaz de usuario del administrador de paquetes NuGet: Busque “GroupDocs.Signature” en el Administrador de paquetes NuGet e instale la última versión.

Adquisición de licencias

Para aprovechar al máximo GroupDocs.Signature, considere adquirir una licencia:

Prueba gratuitaComience con una prueba gratuita para explorar las funciones.
Licencia temporal:Obtener una licencia temporal para pruebas extendidas.
Compra:Compre una licencia completa para uso en producción.

Una vez instalado y licenciado, inicialice su proyecto configurando el entorno GroupDocs.Signature como se muestra a continuación:

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

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // Define la ruta del archivo del documento que quieres analizar
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // Reemplazar con la ruta actual del documento
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // Aquí se realizarán más operaciones...
        }
    }
}

Guía de implementación

Una vez completada la configuración, exploremos cómo implementar varias características de GroupDocs.Signature para .NET.

Recuperar y mostrar propiedades básicas del documento

Descripción general: Extraiga propiedades esenciales como el formato de archivo, el tamaño y el número de páginas.

Implementación paso a paso:

Inicializar objeto de firma:Crear una instancia de la Signature clase con la ruta de su documento.
Método GetDocumentInfo:Utilice el GetDocumentInfo() Método para recuperar información detallada sobre el documento.
Mostrar propiedades del documento:Propiedades básicas de salida como formato, extensión y tamaño usando Console.WriteLine para fines de depuración o registro.

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

Mostrar información sobre cada página del documento

Descripción general:Profundice recuperando y mostrando información sobre cada página dentro del documento.

Implementación paso a paso:

Iterar a través de las páginas:Recorrer en bucle documentInfo.Pages para acceder a detalles de páginas individuales, como ancho y alto.

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

Mostrar información de firmas de campos de formulario

Descripción general: Extrae y muestra información relacionada con los campos de formulario dentro del documento.

Implementación paso a paso:

Campos de formulario de acceso: Usar documentInfo.FormFields para recuperar todas las firmas de campos de formulario presentes en el documento.
Mostrar los detalles de cada campo del formulario: Itera sobre cada campo de formulario y muestra su tipo, nombre y valor.

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

Mostrar información de varias firmas

Descripción general: Recupere y muestre información de texto, imágenes, firmas digitales, códigos de barras, códigos QR, campos de formulario y metadatos.

Pasos de implementación:

Firmas de texto: Acceso documentInfo.TextSignatures para obtener detalles sobre cada firma de texto, incluido su ID, ubicación, tamaño y fechas de creación.

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

Firmas de imágenes:Similar a las firmas de texto, utilice documentInfo.ImageSignatures para detalles como el tamaño y el formato de las firmas de imágenes.

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

Firmas digitales:Para firmas digitales, utilice documentInfo.DigitalSignatures para extraer identificaciones de firmas y marcas de tiempo.

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

Firmas de códigos de barras y códigos QR: Usar documentInfo.BarcodeSignatures y documentInfo.QrCodeSignatures para recopilar detalles del código de barras y del código QR respectivamente.

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

Conclusión

Al seguir este tutorial, aprendió a aprovechar GroupDocs.Signature para .NET para extraer y mostrar eficientemente información completa de documentos. Este conjunto de habilidades mejorará la capacidad de su aplicación para gestionar documentos con precisión y facilidad.

Próximos pasos:

Explore características adicionales de GroupDocs.Signature.
Implemente la validación de firma dentro de sus aplicaciones.
Integre esta funcionalidad en flujos de trabajo más grandes para el procesamiento automatizado de documentos.