.NET용 GroupDocs.Signature 마스터하기: 문서 정보를 효율적으로 추출하고 표시하기

소개

애플리케이션 내 문서에서 포괄적인 세부 정보를 효율적으로 추출하고 싶으신가요? 계약서, 합의서 또는 여러 페이지로 구성된 PDF를 관리하든, 강력한 솔루션은 필수적입니다. .NET용 GroupDocs.Signature 양식 필드, 서명, 메타데이터 등의 요소를 검색하고 표시하여 문서 분석을 간소화하도록 설계된 강력한 기능을 제공합니다. 이 튜토리얼에서는 이러한 기능을 활용하여 애플리케이션의 기능을 향상시키는 방법을 안내합니다.

배울 내용:

  • .NET용 GroupDocs.Signature를 사용하여 자세한 문서 정보를 검색하는 방법
  • 다양한 서명 유형 및 양식 필드 세부 정보 표시
  • 메타데이터 및 페이지별 속성 추출

구현에 들어가기 전에 전제 조건을 검토해 보겠습니다.

필수 조건

.NET용 GroupDocs.Signature를 활용하기 전에 환경이 올바르게 설정되어 있는지 확인하십시오. 이 튜토리얼은 C#에 대한 지식과 문서 처리 개념에 대한 기본 지식을 전제로 합니다.

필수 라이브러리 및 종속성

  • .NET용 GroupDocs.Signature: 우리가 주로 사용할 라이브러리입니다.
  • .NET Framework 또는 .NET Core: 프로젝트 설정에 따라 다릅니다.

환경 설정

Visual Studio나 .NET 프로젝트를 지원하는 다른 적합한 IDE로 개발 환경을 준비하세요.

지식 전제 조건

  • C# 프로그래밍에 대한 기본적인 이해.
  • 문서 유형(PDF, Word, Excel)과 해당 속성에 대한 지식이 필요합니다.

.NET용 GroupDocs.Signature 설정

.NET용 GroupDocs.Signature를 사용하려면 라이브러리를 설치해야 합니다. 다음과 같은 몇 가지 방법을 소개합니다.

설치 지침

.NET CLI 사용:

dotnet add package GroupDocs.Signature

패키지 관리자 콘솔 사용:

Install-Package GroupDocs.Signature

NuGet 패키지 관리자 UI: NuGet 패키지 관리자에서 “GroupDocs.Signature"를 검색하여 최신 버전을 설치하세요.

라이센스 취득

GroupDocs.Signature를 최대한 활용하려면 라이선스 취득을 고려하세요.

  • 무료 체험: 무료 체험판을 통해 기능을 살펴보세요.
  • 임시 면허: 장기 테스트를 위해 임시 라이센스를 얻으세요.
  • 구입: 프로덕션 용도로 전체 라이선스를 구매하세요.

설치하고 라이선스를 받으면 아래와 같이 GroupDocs.Signature 환경을 설정하여 프로젝트를 초기화합니다.

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

public class GetDocumentInfoFeature
{
    public static void Run()
    {
        // 분석하려는 문서의 파일 경로를 정의하세요
        string filePath = "YOUR_DOCUMENT_DIRECTORY\Sample_Signed_Multi_Document.pdf";  // 실제 문서 경로로 바꾸세요
        
        SignatureSettings signatureSettings = new SignatureSettings
        {
            IncludeStandardMetadataSignatures = true
        };

        using (Signature signature = new Signature(filePath, signatureSettings))
        {
            IDocumentInfo documentInfo = signature.GetDocumentInfo();
            // 추가 작업이 여기서 수행됩니다...
        }
    }
}

구현 가이드

설정이 완료되었으므로 .NET용 GroupDocs.Signature의 다양한 기능을 구현하는 방법을 살펴보겠습니다.

기본 문서 속성 검색 및 표시

개요: 파일 형식, 크기, 페이지 수와 같은 필수 속성을 추출합니다.

단계별 구현:

  1. 서명 객체 초기화: 인스턴스를 생성합니다. Signature 문서 경로를 포함하는 클래스입니다.
  2. GetDocumentInfo 메서드: 사용하세요 GetDocumentInfo() 문서에 대한 자세한 정보를 검색하는 방법입니다.
  3. 문서 속성 표시: 형식, 확장자, 크기 등의 기본 속성을 출력합니다. Console.WriteLine 디버깅이나 로깅 목적으로.
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}");

각 문서 페이지에 대한 정보 표시

개요: 문서 내 각 페이지에 대한 정보를 검색하고 표시하여 더 자세히 알아보세요.

단계별 구현:

  1. 페이지 반복: 루프 스루 documentInfo.Pages 너비와 높이와 같은 개별 페이지 세부 정보에 액세스합니다.
foreach (PageInfo pageInfo in documentInfo.Pages)
{
    Console.WriteLine($" - page-{pageInfo.PageNumber} Width {pageInfo.Width}, Height {pageInfo.Height}");
}

표시 양식 필드 서명 정보

개요: 문서 내의 양식 필드와 관련된 정보를 추출하여 표시합니다.

단계별 구현:

  1. 액세스 양식 필드: 사용 documentInfo.FormFields 문서에 있는 모든 양식 필드 서명을 검색합니다.
  2. 각 양식 필드의 세부 정보 표시: 각 양식 필드를 반복하여 유형, 이름, 값을 출력합니다.
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}");
}

다양한 서명 정보 표시

개요: 텍스트, 이미지, 디지털, 바코드, QR 코드, 양식 필드 및 메타데이터 서명에 대한 정보를 검색하고 표시합니다.

구현 단계:

  • 텍스트 서명: 입장 documentInfo.TextSignatures 각 텍스트 서명의 ID, 위치, 크기, 생성 날짜를 포함한 세부 정보를 얻습니다.
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()}");
}
  • 이미지 서명: 텍스트 서명과 유사하게 사용 documentInfo.ImageSignatures 이미지 서명의 크기 및 형식과 같은 세부 정보.
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()}");
}
  • 디지털 서명: 디지털 서명의 경우 다음을 활용하세요. documentInfo.DigitalSignatures 서명 ID와 타임스탬프를 추출합니다.
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()}");
}
  • 바코드 및 QR 코드 서명: 사용 documentInfo.BarcodeSignatures 그리고 documentInfo.QrCodeSignatures 각각 바코드와 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}");
}

결론

이 튜토리얼을 따라 하면 .NET용 GroupDocs.Signature를 활용하여 포괄적인 문서 정보를 효율적으로 추출하고 표시하는 방법을 배우게 됩니다. 이 기술을 활용하면 애플리케이션에서 문서를 정확하고 간편하게 관리할 수 있는 능력이 향상됩니다.

다음 단계:

  • GroupDocs.Signature의 추가 기능을 살펴보세요.
  • 애플리케이션 내에서 서명 검증을 구현합니다.
  • 이 기능을 대규모 워크플로에 통합하여 문서를 자동으로 처리합니다.