Invoering

Tekstverwerkingsdocumenten behoren tot de meest voorkomende bestandstypen die worden gebruikt in zakelijke, educatieve en persoonlijke communicatie. Het waarborgen van de authenticiteit, het traceren van de herkomst en het handhaven van de integriteit van deze documenten is cruciaal in veel professionele omgevingen. Een effectieve aanpak om de beveiliging en traceerbaarheid van documenten te verbeteren, is het insluiten van metadatahandtekeningen.

Deze uitgebreide tutorial begeleidt u door het proces van het ondertekenen van tekstverwerkingsdocumenten met metadata met behulp van GroupDocs.Signature voor .NET. Door metadatahandtekeningen toe te voegen, kunt u waardevolle informatie zoals auteursgegevens, tijdstempels van aanmaak, document-ID’s en andere aangepaste eigenschappen rechtstreeks in de documentbestandsstructuur insluiten.

Vereisten

Voordat u met deze tutorial begint, moet u ervoor zorgen dat u over het volgende beschikt:

GroupDocs.Signature voor .NET - Download en installeer de bibliotheek
Ontwikkelomgeving - Visual Studio of een andere .NET-compatibele IDE
Word-document - Een voorbeelddocumentbestand (DOCX, DOC, enz.)
Basiskennis van C# - Kennis van de programmeertaal C#

Naamruimten importeren

Begin met het importeren van de benodigde naamruimten om toegang te krijgen tot de GroupDocs.Signature-functionaliteit:

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

Stap 1: Bestandspaden instellen

Definieer de paden voor uw bron-Worddocument en waar de ondertekende uitvoer moet worden opgeslagen:

// Geef het pad naar uw Word-document op
string filePath = "sample.docx";

// Definieer de uitvoermap en bestandsnaam voor het ondertekende document
string outputDirectory = "Your Document Directory";
string outputFilePath = Path.Combine(outputDirectory, "SignWordProcessingWithMetadata", "SignedWithMetadata.docx");

// Zorg ervoor dat de uitvoermap bestaat
Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));

Stap 2: Initialiseer het handtekeningobject

Maak een exemplaar van de Signature-klasse met uw bron-Worddocument:

using (Signature signature = new Signature(filePath))
{
    // De rest van de code komt hier
}

Stap 3: Metadatahandtekeningen maken en configureren

Definieer vervolgens de metagegevensopties en voeg verschillende typen metagegevenshandtekeningen toe:

// Metadata-optiesobject maken
MetadataSignOptions options = new MetadataSignOptions();

// Voeg verschillende soorten metagegevens toe met behulp van de vloeiende interface
options
    .Add(new WordProcessingMetadataSignature("Author", "Mr.Sherlock Holmes")) // Stringwaarde
    .Add(new WordProcessingMetadataSignature("CreatedOn", DateTime.Now))      // Datum/tijd-waarde
    .Add(new WordProcessingMetadataSignature("DocumentId", 123456))           // Gehele waarde
    .Add(new WordProcessingMetadataSignature("SignatureId", 123.456D))        // Dubbele waarde
    .Add(new WordProcessingMetadataSignature("Amount", 123.456M))             // Decimale waarde
    .Add(new WordProcessingMetadataSignature("Total", 123.456F));             // Vlotterwaarde

Stap 4: Onderteken het document met metagegevens

Pas de metagegevenshandtekeningen toe op het Word-document en sla het resultaat op:

// Onderteken het document en sla het op in het pad van het uitvoerbestand
SignResult result = signature.Sign(outputFilePath, options);

// Succesbericht weergeven
Console.WriteLine($"\nSource document signed successfully with {result.Succeeded.Count} metadata signature(s).");
Console.WriteLine($"Signed document saved at: {outputFilePath}");

Volledig voorbeeld

Hier is het volledige codevoorbeeld dat alle stappen samenbrengt:

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)
        {
            // Geef bestandspaden op
            string filePath = "sample.docx";
            string outputFilePath = Path.Combine("Your Document Directory", "SignWordProcessingWithMetadata", "SignedWithMetadata.docx");
            
            // Zorg ervoor dat de uitvoermap bestaat
            Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));

            // Onderteken het Word-document met metagegevens
            using (Signature signature = new Signature(filePath))
            {
                // Metadata-optiesobject maken
                MetadataSignOptions options = new MetadataSignOptions();
                
                // Verschillende soorten metadatahandtekeningen toevoegen
                options
                    .Add(new WordProcessingMetadataSignature("Author", "Mr.Sherlock Holmes")) // Stringwaarde
                    .Add(new WordProcessingMetadataSignature("CreatedOn", DateTime.Now))      // Datum/tijd-waarde
                    .Add(new WordProcessingMetadataSignature("DocumentId", 123456))           // Gehele waarde
                    .Add(new WordProcessingMetadataSignature("SignatureId", 123.456D))        // Dubbele waarde
                    .Add(new WordProcessingMetadataSignature("Amount", 123.456M))             // Decimale waarde
                    .Add(new WordProcessingMetadataSignature("Total", 123.456F));             // Vlotterwaarde
                
                // Document ondertekenen en opslaan in bestand
                SignResult result = signature.Sign(outputFilePath, options);
                
                // Resultaten weergeven
                Console.WriteLine($"\nSource document signed successfully with {result.Succeeded.Count} signature(s).");
                Console.WriteLine($"File saved at {outputFilePath}.");
            }
        }
    }
}

Geavanceerde Word-documentmetadatatechnieken

Werken met aangepaste en ingebouwde documenteigenschappen

Word-documenten hebben zowel ingebouwde als aangepaste eigenschappen die toegankelijk zijn via het paneel met documenteigenschappen. Met GroupDocs.Signature kunt u met beide werken:

// Ingebouwde eigenschappen toevoegen
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"));

// Aangepaste eigenschappen toevoegen
options.Add(new WordProcessingMetadataSignature("Department", "Legal"));
options.Add(new WordProcessingMetadataSignature("SecurityLevel", "Confidential"));

Zoeken naar metagegevens in ondertekende Word-documenten

Nadat u hebt ondertekend, wilt u mogelijk de metagegevens verifiëren of extraheren:

// Zoekopties voor metadata maken
MetadataSearchOptions searchOptions = new MetadataSearchOptions();

// Zoeken naar metadatahandtekeningen
SearchResult searchResult = signature.Search(searchOptions);

// Gevonden handtekeningen weergeven
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})");
    }
}

Werken met documentvariabelen

Word-documenten ondersteunen ook documentvariabelen, een andere vorm van metadata:

// Documentvariabelen toevoegen
options.Add(new WordProcessingMetadataSignature("DocVariable1", "Custom Value 1", true));
options.Add(new WordProcessingMetadataSignature("DocVariable2", DateTime.Now, true));

Conclusie

In deze uitgebreide tutorial hebt u geleerd hoe u tekstverwerkingsdocumenten kunt ondertekenen met metadata met behulp van GroupDocs.Signature voor .NET. Het insluiten van metadata in Word-documenten verbetert de traceerbaarheid van documenten, biedt waardevolle context en helpt bij het vaststellen van de authenticiteit.

Metadatahandtekeningen in Word-documenten zijn met name nuttig in zakelijke en juridische omgevingen waar de herkomst, het auteurschap en de versieregistratie van documenten belangrijk zijn. De ingesloten metadata kunnen informatie bevatten over de auteur, de aanmaaktijd, document-ID’s en aangepaste eigenschappen die relevant zijn voor de behoeften van uw organisatie.

Door metagegevenshandtekeningen te implementeren met GroupDocs.Signature, kunt u ervoor zorgen dat uw Word-documenten hun integriteit behouden en verifieerbare informatie bieden gedurende hun levenscyclus.

Veelgestelde vragen

Kan ik metagegevens toevoegen aan Word-documenten waarvan de eigenschappen al gedefinieerd zijn?

Ja, u kunt nieuwe metadata toevoegen of bestaande metadata bijwerken in Word-documenten. GroupDocs.Signature verzorgt de integratie door nieuwe eigenschappen toe te voegen of bestaande eigenschappen met dezelfde naam bij te werken.

Welke tekstverwerkingsformaten worden ondersteund voor metadataondertekening?

GroupDocs.Signature voor .NET ondersteunt metadataondertekening voor diverse tekstverwerkingsformaten, waaronder DOCX, DOC, RTF, ODT en meer. Raadpleeg de documentatie.

Zijn metadatahandtekeningen in Word-documenten zichtbaar voor de lezers?

Metadatahandtekeningen zijn niet zichtbaar in de documentinhoud zelf. Ze zijn echter wel te bekijken via het paneel met documenteigenschappen in Microsoft Word of andere compatibele applicaties.

Kan ik programmatisch valideren of er met een Word-document is geknoeid nadat ik metagegevens heb toegevoegd?

Ja, GroupDocs.Signature biedt verificatiemogelijkheden waarmee kan worden vastgesteld of een document na ondertekening is gewijzigd, inclusief wijzigingen in metagegevens.

Is het mogelijk om metagegevens uit een Word-document te verwijderen?

Ja, GroupDocs.Signature biedt opties om indien nodig metadatahandtekeningen uit documenten te verwijderen. Dit kan handig zijn om gevoelige informatie op te schonen voordat u documenten extern deelt.