Dominando o GroupDocs.Signature para .NET: Extraia e exiba informações de documentos com eficiência

Introdução

Deseja extrair detalhes abrangentes de documentos com eficiência em seus aplicativos? Seja gerenciando contratos, acordos ou PDFs de várias páginas, uma solução robusta é essencial. GroupDocs.Signature para .NET oferece recursos poderosos projetados para otimizar a análise de documentos, recuperando e exibindo elementos como campos de formulário, assinaturas, metadados e muito mais. Este tutorial guiará você na utilização desses recursos para aprimorar a funcionalidade do seu aplicativo.

O que você aprenderá:

Como recuperar informações detalhadas de documentos usando GroupDocs.Signature para .NET
Exibindo vários tipos de assinatura e detalhes de campos de formulário
Extração de metadados e atributos específicos da página

Vamos revisar os pré-requisitos antes de começar a implementação.

Pré-requisitos

Antes de utilizar o GroupDocs.Signature para .NET, certifique-se de que seu ambiente esteja configurado corretamente. Este tutorial pressupõe familiaridade com C# e conhecimento básico de conceitos de processamento de documentos.

Bibliotecas e dependências necessárias

GroupDocs.Signature para .NET: A biblioteca primária que usaremos.
.NET Framework ou .NET Core:Dependendo da configuração do seu projeto.

Configuração do ambiente

Certifique-se de ter um ambiente de desenvolvimento pronto com o Visual Studio ou outro IDE adequado que suporte projetos .NET.

Pré-requisitos de conhecimento

Noções básicas de programação em C#.
Familiaridade com tipos de documentos (PDF, Word, Excel) e suas propriedades.

Configurando GroupDocs.Signature para .NET

Para usar o GroupDocs.Signature para .NET, você precisa instalar a biblioteca. Aqui estão alguns métodos:

Instruções de instalação

Usando o .NET CLI:

dotnet add package GroupDocs.Signature

Usando o Console do Gerenciador de Pacotes:

Install-Package GroupDocs.Signature

Interface do Gerenciador de Pacotes NuGet: Procure por “GroupDocs.Signature” no Gerenciador de Pacotes NuGet e instale a versão mais recente.

Aquisição de Licença

Para aproveitar ao máximo o GroupDocs.Signature, considere adquirir uma licença:

Teste grátis: Comece com um teste gratuito para explorar os recursos.
Licença Temporária: Obtenha uma licença temporária para testes estendidos.
Comprar: Compre uma licença completa para uso em produção.

Depois de instalado e licenciado, inicialize seu projeto configurando o ambiente GroupDocs.Signature conforme mostrado abaixo:

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

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // Defina o caminho do arquivo para o documento que você deseja analisar
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // Substitua pelo caminho real do seu documento
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // Outras operações serão realizadas aqui...
        }
    }
}

Guia de Implementação

Com a configuração concluída, vamos explorar como implementar vários recursos do GroupDocs.Signature para .NET.

Recuperar e exibir propriedades básicas do documento

Visão geral: Extraia propriedades essenciais como formato de arquivo, tamanho e contagem de páginas.

Implementação passo a passo:

Inicializar objeto de assinatura: Crie uma instância do Signature classe com o caminho do seu documento.
Método GetDocumentInfo:Use o GetDocumentInfo() método para recuperar informações detalhadas sobre o documento.
Exibir propriedades do documento: Propriedades básicas de saída, como formato, extensão e tamanho usando Console.WriteLine para fins de depuração ou 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}");

Exibir informações sobre cada página do documento

Visão geral:Aprofunde-se recuperando e exibindo informações sobre cada página do documento.

Implementação passo a passo:

Iterar pelas páginas: Loop através documentInfo.Pages para acessar detalhes individuais da página, como largura e altura.

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

Exibir informações de assinaturas de campos de formulário

Visão geral: Extraia e exiba informações relacionadas aos campos do formulário dentro do documento.

Implementação passo a passo:

Campos do formulário de acesso: Usar documentInfo.FormFields para recuperar todas as assinaturas de campos de formulário presentes no documento.
Exibir detalhes de cada campo do formulário: Itere sobre cada campo do formulário e exiba seu tipo, nome e 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}");
}

Exibir várias informações de assinaturas

Visão geral: Recupere e exiba informações de assinaturas de texto, imagem, digital, código de barras, código QR, campo de formulário e metadados.

Etapas de implementação:

Assinaturas de texto: Acesso documentInfo.TextSignatures para obter detalhes sobre cada assinatura de texto, incluindo seu ID, localização, tamanho e datas de criação.

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

Assinaturas de imagem: Semelhante às assinaturas de texto, use documentInfo.ImageSignatures para detalhes como tamanho e formato das assinaturas de imagem.

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

Assinaturas Digitais:Para assinaturas digitais, utilize documentInfo.DigitalSignatures para extrair IDs de assinatura e carimbos de data/hora.

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

Assinaturas de código de barras e QR Code: Usar documentInfo.BarcodeSignatures e documentInfo.QrCodeSignatures para coletar detalhes de código de barras e 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}");
}

Conclusão

Ao seguir este tutorial, você aprendeu a utilizar o GroupDocs.Signature para .NET para extrair e exibir informações abrangentes de documentos com eficiência. Este conjunto de habilidades aprimorará a capacidade do seu aplicativo de gerenciar documentos com precisão e facilidade.

Próximos passos:

Explore recursos adicionais do GroupDocs.Signature.
Implemente a validação de assinatura em seus aplicativos.
Integre esta funcionalidade em fluxos de trabalho maiores para processamento automatizado de documentos.