GroupDocs.Signature를 사용하여 .NET에서 서명 관리 마스터하기
소개
오늘날의 디지털 환경에서 문서 서명을 효율적으로 관리하는 것은 기업과 개인 모두에게 매우 중요합니다. 계약 확인이나 규정 준수 여부 확인 등 어떤 작업을 하든 적절한 도구가 큰 차이를 만들어낼 수 있습니다. 이 튜토리얼에서는 .NET용 GroupDocs.Signature 문서의 서명을 원활하게 관리하고 삭제합니다.
배울 내용:
- Signature 인스턴스를 초기화하는 방법.
- 서명을 감지하기 위한 다양한 검색 옵션을 추가합니다.
- 문서 내에서 다양한 유형의 서명을 검색합니다.
- 여러 서명을 효율적으로 삭제합니다.
시작할 준비가 되셨나요? 먼저 필수 조건을 살펴보겠습니다.
필수 조건
시작하기에 앞서 다음 사항이 있는지 확인하세요.
- 필수 라이브러리: .NET용 GroupDocs.Signature
- 환경 설정: .NET Framework 또는 .NET Core가 설치된 Visual Studio 2019 이상.
- 지식 전제 조건: C# 및 .NET 개발에 대한 기본적인 이해.
.NET용 GroupDocs.Signature 설정
시작하려면 GroupDocs.Signature 라이브러리를 설치해야 합니다. 설치 방법은 다음과 같습니다.
설치 지침
.NET CLI 사용:
dotnet add package GroupDocs.Signature
패키지 관리자 콘솔:
Install-Package GroupDocs.Signature
NuGet 패키지 관리자 UI: “GroupDocs.Signature"를 검색하여 최신 버전을 설치하세요.
라이센스 취득
무료 체험판을 통해 기능을 체험해 보세요. 장기간 사용하려면 임시 라이선스를 구매하거나 그룹닥스.
구현 가이드
각 기능을 단계별로 살펴보겠습니다.
기능 1: 서명 인스턴스 초기화
이 기능은 .NET용 GroupDocs.Signature를 사용하여 문서의 서명을 관리하기 위한 환경을 설정하는 방법을 보여줍니다.
개요
초기화 중 Signature
인스턴스는 검색 및 삭제와 같은 서명 작업을 위해 문서를 준비하므로 중요합니다.
코드 구현
using System.IO;
using GroupDocs.Signature;
var filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // 디렉토리가 존재하는지 확인하세요.
File.Copy(filePath, outputFilePath, true);
// 문서 경로를 사용하여 Signature 인스턴스를 초기화합니다.
using (Signature signature = new Signature(outputFilePath))
{
// 이제 서명 인스턴스가 작업을 수행할 준비가 되었습니다.
}
설명
filePath
: 소스 문서의 경로입니다.Directory.CreateDirectory(...)
: 파일 작업을 시도하기 전에 디렉토리가 존재하는지 확인합니다.signature
: 서명과 관련된 모든 작업을 용이하게 하는 기본 객체입니다.
기능 2: 검색 옵션 추가
서명을 효율적으로 감지하려면 문서에서 찾고 있는 서명 유형을 지정해야 합니다.
개요
검색 옵션을 추가하면 문서 내에서 텍스트, 바코드, QR 코드 또는 이미지 기반 서명 등 특정 유형의 서명을 타겟팅할 수 있습니다.
코드 구현
using System.Collections.Generic;
using GroupDocs.Signature.Options;
List<SearchOptions> listOptions = new List<SearchOptions>();
listOptions.Add(new TextSearchOptions()); // 텍스트 기반 서명을 검색합니다.
listOptions.Add(new BarcodeSearchOptions()); // 바코드 서명 검색.
listOptions.Add(new QrCodeSearchOptions()); // QR 코드 서명 검색.
listOptions.Add(new ImageSearchOptions()); // 이미지 기반 서명 검색.
// 이제 listOptions에는 문서에서 다양한 유형의 서명을 찾는 데 필요한 모든 검색 옵션이 포함되었습니다.
설명
TextSearchOptions
: 문서 내의 텍스트 서명을 대상으로 합니다.BarcodeSearchOptions
,QrCodeSearchOptions
, 그리고ImageSearchOptions
: 바코드, QR 코드, 이미지 기반 서명을 각각 감지할 수 있습니다.
기능 3: 문서에서 서명 검색
검색 옵션을 설정한 후 이제 문서에서 이러한 서명을 찾을 수 있습니다.
개요
이 기능은 지정된 서명 옵션을 사용하여 문서를 검색하고 그에 따라 결과를 처리하는 방법을 강조합니다.
코드 구현
using System.Collections.Generic;
using GroupDocs.Signature.Domain;
string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // 디렉토리가 존재하는지 확인하세요.
File.Copy(filePath, outputFilePath, true);
using (Signature signature = new Signature(outputFilePath))
{
List<SearchOptions> listOptions = new List<SearchOptions>();
listOptions.Add(new TextSearchOptions());
listOptions.Add(new BarcodeSearchOptions());
listOptions.Add(new QrCodeSearchOptions());
listOptions.Add(new ImageSearchOptions());
// 지정된 옵션을 사용하여 서명을 검색합니다.
SearchResult result = signature.Search(listOptions);
if (result.Signatures.Count > 0)
{
// 문서에서 서명이 발견되었습니다.
}
else
{
// 문서에서 서명이 발견되지 않았습니다.
}
}
설명
SearchResult
: 감지된 모든 서명의 세부 정보가 포함되어 있어 삭제와 같은 추가 처리가 가능합니다.
기능 4: 문서에서 서명 삭제
원치 않는 서명을 파악했다면 다음 단계는 이를 효율적으로 제거하는 것입니다.
개요
이 기능은 .NET용 GroupDocs.Signature를 사용하여 문서에서 여러 유형의 서명을 삭제하는 방법을 보여줍니다.
코드 구현
using System.Collections.Generic;
using GroupDocs.Signature.Domain;
string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // 디렉토리가 존재하는지 확인하세요.
File.Copy(filePath, outputFilePath, true);
using (Signature signature = new Signature(outputFilePath))
{
List<SearchOptions> listOptions = new List<SearchOptions>();
listOptions.Add(new TextSearchOptions());
listOptions.Add(new BarcodeSearchOptions());
listOptions.Add(new QrCodeSearchOptions());
listOptions.Add(new ImageSearchOptions());
// 서명을 검색하세요.
SearchResult result = signature.Search(listOptions);
if (result.Signatures.Count > 0)
{
List<BaseSignature> signaturesToDelete = new List<BaseSignature>();
// 삭제할 서명을 수집합니다.
foreach (BaseSignature temp in result.Signatures)
{
signaturesToDelete.Add(temp);
}
// 문서에서 수집된 서명을 삭제합니다.
DeleteResult deleteResult = signature.Delete(signaturesToDelete);
}
}
설명
signaturesToDelete
: 삭제를 위해 식별된 서명 모음입니다.DeleteResult
삭제 프로세스의 성공 또는 실패에 대한 피드백을 제공합니다.
실제 응용 프로그램
- 계약 관리: 계약서에 있는 오래된 서명을 자동으로 검증하고 삭제합니다.
- 규정 준수 감사: 서명을 감사하고 정리하여 모든 문서가 규정 요구 사항을 준수하는지 확인합니다.
- 문서 수명 주기 관리: 생성부터 보관까지 문서 수명 주기 전반에 걸쳐 문서 서명을 관리합니다.
성능 고려 사항
- 서명을 검색하거나 삭제할 때 문서의 필요한 부분만 처리하여 성능을 최적화합니다.
- 서명 작업 중에도 애플리케이션의 효율성과 반응성을 유지하려면 리소스 사용량을 모니터링하세요.