소개

워드 프로세싱 문서는 비즈니스, 교육 및 개인 커뮤니케이션에 가장 일반적으로 사용되는 파일 형식 중 하나입니다. 이러한 문서의 진위성 보장, 출처 추적 및 무결성 유지는 많은 전문 환경에서 매우 중요합니다. 문서 보안 및 추적성을 강화하는 효과적인 방법 중 하나는 메타데이터 서명을 내장하는 것입니다.

이 포괄적인 튜토리얼에서는 GroupDocs.Signature for .NET을 사용하여 워드 프로세싱 문서에 메타데이터를 서명하는 과정을 안내합니다. 메타데이터 서명을 추가하면 작성자 정보, 생성 타임스탬프, 문서 식별자 및 기타 사용자 지정 속성과 같은 중요한 정보를 문서 파일 구조에 직접 포함할 수 있습니다.

필수 조건

이 튜토리얼을 진행하기 전에 다음 사항이 있는지 확인하세요.

.NET용 GroupDocs.Signature - 라이브러리를 다운로드하고 설치하세요
개발 환경 - Visual Studio 또는 기타 .NET 호환 IDE
Word 문서 - 샘플 문서 파일(DOCX, DOC 등)
기본 C# 지식 - C# 프로그래밍 언어에 대한 친숙함

네임스페이스 가져오기

GroupDocs.Signature 기능에 액세스하는 데 필요한 네임스페이스를 가져오는 것으로 시작합니다.

using System;
using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

1단계: 파일 경로 설정

원본 Word 문서의 경로와 서명된 출력이 저장될 위치를 정의합니다.

// Word 문서 경로를 지정하세요
string filePath = "sample.docx";

// 서명된 문서의 출력 디렉토리와 파일 이름을 정의합니다.
string outputDirectory = "Your Document Directory";
string outputFilePath = Path.Combine(outputDirectory, "SignWordProcessingWithMetadata", "SignedWithMetadata.docx");

// 출력 디렉토리가 존재하는지 확인하세요
Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));

2단계: 서명 개체 초기화

소스 Word 문서로 Signature 클래스의 인스턴스를 만듭니다.

using (Signature signature = new Signature(filePath))
{
    // 나머지 코드는 여기에 들어갈 것입니다.
}

3단계: 메타데이터 서명 만들기 및 구성

다음으로, 메타데이터 옵션을 정의하고 다양한 유형의 메타데이터 서명을 추가합니다.

// 메타데이터 옵션 개체 생성
MetadataSignOptions options = new MetadataSignOptions();

// Fluent 인터페이스를 사용하여 다양한 유형의 메타데이터를 추가합니다.
options
    .Add(new WordProcessingMetadataSignature("Author", "Mr.Sherlock Holmes")) // 문자열 값
    .Add(new WordProcessingMetadataSignature("CreatedOn", DateTime.Now))      // DateTime 값
    .Add(new WordProcessingMetadataSignature("DocumentId", 123456))           // 정수 값
    .Add(new WordProcessingMetadataSignature("SignatureId", 123.456D))        // 두 배 값
    .Add(new WordProcessingMetadataSignature("Amount", 123.456M))             // 10진수 값
    .Add(new WordProcessingMetadataSignature("Total", 123.456F));             // 부동 소수점 값

4단계: 메타데이터로 문서 서명

메타데이터 서명을 Word 문서에 적용하고 결과를 저장합니다.

// 문서에 서명하고 출력 파일 경로에 저장합니다.
SignResult result = signature.Sign(outputFilePath, options);

// 성공 메시지 표시
Console.WriteLine($"\nSource document signed successfully with {result.Succeeded.Count} metadata signature(s).");
Console.WriteLine($"Signed document saved at: {outputFilePath}");

완전한 예

모든 단계를 하나로 합친 전체 코드 예는 다음과 같습니다.

using System;
using System.IO;
using GroupDocs.Signature;
using GroupDocs.Signature.Domain;
using GroupDocs.Signature.Options;

namespace SignWordProcessingWithMetadataExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // 파일 경로 지정
            string filePath = "sample.docx";
            string outputFilePath = Path.Combine("Your Document Directory", "SignWordProcessingWithMetadata", "SignedWithMetadata.docx");
            
            // 출력 디렉토리가 존재하는지 확인하세요
            Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));

            // 메타데이터로 Word 문서에 서명
            using (Signature signature = new Signature(filePath))
            {
                // 메타데이터 옵션 개체 생성
                MetadataSignOptions options = new MetadataSignOptions();
                
                // 다양한 유형의 메타데이터 서명 추가
                options
                    .Add(new WordProcessingMetadataSignature("Author", "Mr.Sherlock Holmes")) // 문자열 값
                    .Add(new WordProcessingMetadataSignature("CreatedOn", DateTime.Now))      // DateTime 값
                    .Add(new WordProcessingMetadataSignature("DocumentId", 123456))           // 정수 값
                    .Add(new WordProcessingMetadataSignature("SignatureId", 123.456D))        // 두 배 값
                    .Add(new WordProcessingMetadataSignature("Amount", 123.456M))             // 10진수 값
                    .Add(new WordProcessingMetadataSignature("Total", 123.456F));             // 부동 소수점 값
                
                // 문서에 서명하고 파일에 저장하세요
                SignResult result = signature.Sign(outputFilePath, options);
                
                // 결과 표시
                Console.WriteLine($"\nSource document signed successfully with {result.Succeeded.Count} signature(s).");
                Console.WriteLine($"File saved at {outputFilePath}.");
            }
        }
    }
}

고급 Word 문서 메타데이터 기술

사용자 지정 및 기본 제공 문서 속성 작업

Word 문서에는 문서 속성 패널을 통해 액세스할 수 있는 기본 제공 속성과 사용자 지정 속성이 모두 있습니다. GroupDocs.Signature를 사용하면 다음 두 가지 속성을 모두 사용할 수 있습니다.

// 내장된 속성 추가
options
    .Add(new WordProcessingMetadataSignature("Company", "Sherlock Holmes Consulting"))
    .Add(new WordProcessingMetadataSignature("Category", "Legal Document"))
    .Add(new WordProcessingMetadataSignature("Keywords", "contract,agreement,legal"))
    .Add(new WordProcessingMetadataSignature("Comments", "This document is confidential"))
    .Add(new WordProcessingMetadataSignature("Manager", "John Watson"));

// 사용자 정의 속성 추가
options.Add(new WordProcessingMetadataSignature("Department", "Legal"));
options.Add(new WordProcessingMetadataSignature("SecurityLevel", "Confidential"));

서명된 Word 문서에서 메타데이터 검색

서명 후 메타데이터를 확인하거나 추출할 수 있습니다.

// 메타데이터에 대한 검색 옵션 만들기
MetadataSearchOptions searchOptions = new MetadataSearchOptions();

// 메타데이터 서명 검색
SearchResult searchResult = signature.Search(searchOptions);

// 발견된 서명 표시
Console.WriteLine($"Found {searchResult.Signatures.Count} metadata signatures:");
foreach (var foundSignature in searchResult.Signatures)
{
    MetadataSignature metadataSignature = foundSignature as MetadataSignature;
    if (metadataSignature != null)
    {
        Console.WriteLine($"- {metadataSignature.Name}: {metadataSignature.Value} ({metadataSignature.Value.GetType().Name})");
    }
}

문서 변수 작업

Word 문서는 메타데이터의 또 다른 형태인 문서 변수도 지원합니다.

// 문서 변수 추가
options.Add(new WordProcessingMetadataSignature("DocVariable1", "Custom Value 1", true));
options.Add(new WordProcessingMetadataSignature("DocVariable2", DateTime.Now, true));

결론

이 포괄적인 튜토리얼에서는 GroupDocs.Signature for .NET을 사용하여 Word 프로세싱 문서에 메타데이터로 서명하는 방법을 알아보았습니다. Word 문서에 메타데이터를 포함하면 문서 추적성이 향상되고, 중요한 맥락을 제공하며, 진위 여부를 확인하는 데 도움이 됩니다.

Word 문서의 메타데이터 서명은 문서 출처, 작성자 및 버전 추적이 중요한 비즈니스 및 법률 환경에서 특히 유용합니다. 포함된 메타데이터에는 작성자, 생성 시간, 문서 식별자 및 조직의 요구 사항에 맞는 사용자 지정 속성에 대한 정보가 포함될 수 있습니다.

GroupDocs.Signature를 사용하여 메타데이터 서명을 구현하면 Word 문서의 무결성을 유지하고 문서 수명 주기 전반에 걸쳐 검증 가능한 정보를 제공할 수 있습니다.

자주 묻는 질문

일부 속성이 이미 정의된 Word 문서에 메타데이터를 추가할 수 있나요?

네, Word 문서에 새 메타데이터를 추가하거나 기존 메타데이터를 업데이트할 수 있습니다. GroupDocs.Signature는 새 속성을 추가하거나 이름이 같은 기존 속성을 업데이트하여 통합을 처리합니다.

메타데이터 서명에 지원되는 워드 프로세싱 형식은 무엇입니까?

GroupDocs.Signature for .NET은 DOCX, DOC, RTF, ODT 등 다양한 워드 프로세싱 형식에 대한 메타데이터 서명을 지원합니다. 전체 목록은 다음을 참조하세요. 선적 서류 비치.

Word 문서의 메타데이터 서명이 독자에게 표시되나요?

메타데이터 서명은 문서 콘텐츠 자체에는 표시되지 않습니다. 하지만 Microsoft Word 또는 기타 호환 응용 프로그램의 문서 속성 패널을 통해 확인할 수 있습니다.

메타데이터를 추가한 후 Word 문서가 변조되었는지 프로그래밍 방식으로 확인할 수 있나요?

네, GroupDocs.Signature는 메타데이터 변경을 포함하여 서명 후 문서가 수정되었는지 감지하는 데 도움이 되는 검증 기능을 제공합니다.

Word 문서에서 메타데이터를 제거할 수 있나요?

네, GroupDocs.Signature는 필요한 경우 문서에서 메타데이터 서명을 제거하는 옵션을 제공합니다. 이 기능은 문서를 외부에 공유하기 전에 민감한 정보를 정리하는 데 유용할 수 있습니다.

소개