Zavedení

Tabulky aplikace Excel často obsahují důležitá obchodní data, finanční informace a důležité výpočty. Zajištění jejich autenticity, sledování jejich původu a ochrana jejich integrity je v mnoha profesionálních prostředích klíčové. Jedním z účinných přístupů ke zvýšení zabezpečení a sledovatelnosti tabulek je vložení podpisů metadat.

Tento komplexní tutoriál vás provede procesem podepisování tabulek aplikace Excel metadaty pomocí nástroje GroupDocs.Signature pro .NET. Přidáním podpisů s metadaty můžete přímo do struktury souboru tabulky vložit cenné informace, jako jsou údaje o autorovi, časová razítka vytvoření, identifikátory dokumentů a další vlastní vlastnosti.

Předpoklady

Než budete pokračovat v tomto tutoriálu, ujistěte se, že máte následující:

  1. GroupDocs.Signature pro .NET - Stáhněte a nainstalujte knihovnu
  2. Vývojové prostředí - Visual Studio nebo jakékoli jiné IDE kompatibilní s .NET
  3. Tabulka Excelu – ukázkový soubor tabulky (XLSX, XLS atd.)
  4. Základní znalost C# - znalost programovacího jazyka C#

Importovat jmenné prostory

Začněte importem potřebných jmenných prostorů pro přístup k funkcím GroupDocs.Signature:

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

Krok 1: Nastavení cest k souborům

Definujte cesty pro zdrojovou tabulku a místo, kam se má uložit podepsaný výstup:

// Zadejte cestu k souboru aplikace Excel
string filePath = "sample.xlsx";

// Definujte výstupní adresář a název souboru pro podepsanou tabulku
string outputDirectory = "Your Document Directory";
string outputFilePath = Path.Combine(outputDirectory, "SignSpreadsheetWithMetadata", "SignedWithMetadata.xlsx");

// Ujistěte se, že výstupní adresář existuje.
Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));

Krok 2: Inicializace objektu Signature

Vytvořte instanci třídy Signature se zdrojovým souborem tabulky:

using (Signature signature = new Signature(filePath))
{
    // Zbytek kódu půjde sem
}

Krok 3: Vytvoření a konfigurace podpisů metadat

Dále definujte možnosti metadat a vytvořte pole podpisů metadat tabulky:

// Vytvořit objekt možností metadat
MetadataSignOptions options = new MetadataSignOptions();

// Vytvořte pole podpisů metadat tabulky s různými datovými typy
SpreadsheetMetadataSignature[] signatures = new SpreadsheetMetadataSignature[]
{
    new SpreadsheetMetadataSignature("Author", "Mr.Sherlock Holmes"), // Řetězcová hodnota
    new SpreadsheetMetadataSignature("CreatedOn", DateTime.Now),      // Hodnota data a času
    new SpreadsheetMetadataSignature("DocumentId", 123456),           // Celočíselná hodnota
    new SpreadsheetMetadataSignature("SignatureId", 123.456D),        // Dvojitá hodnota
    new SpreadsheetMetadataSignature("Amount", 123.456M),             // Desetinná hodnota
    new SpreadsheetMetadataSignature("Total", 123.456F)               // Hodnota s plovoucí desetinnou čárkou
};

// Přidat sbírku podpisů do možností
options.Signatures.AddRange(signatures);

Krok 4: Podepište tabulku metadaty

Použijte podpisy metadat na tabulku a uložte výsledek:

// Podepište dokument a uložte ho do cesty k výstupnímu souboru.
SignResult result = signature.Sign(outputFilePath, options);

// Zobrazit zprávu o úspěchu
Console.WriteLine($"\nSource spreadsheet signed successfully with {result.Succeeded.Count} metadata signature(s).");
Console.WriteLine($"Signed spreadsheet saved at: {outputFilePath}");

Kompletní příklad

Zde je kompletní příklad kódu, který shrnuje všechny kroky dohromady:

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

namespace SignSpreadsheetWithMetadataExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Zadejte cesty k souborům
            string filePath = "sample.xlsx";
            string outputFilePath = Path.Combine("Your Document Directory", "SignSpreadsheetWithMetadata", "SignedWithMetadata.xlsx");
            
            // Ujistěte se, že výstupní adresář existuje.
            Directory.CreateDirectory(Path.GetDirectoryName(outputFilePath));

            // Podepište tabulku metadaty
            using (Signature signature = new Signature(filePath))
            {
                // Vytvořit objekt možností metadat
                MetadataSignOptions options = new MetadataSignOptions();
                
                // Vytvořte pole podpisů metadat tabulky s různými datovými typy
                SpreadsheetMetadataSignature[] signatures = new SpreadsheetMetadataSignature[]
                {
                    new SpreadsheetMetadataSignature("Author", "Mr.Sherlock Holmes"), // Řetězcová hodnota
                    new SpreadsheetMetadataSignature("CreatedOn", DateTime.Now),      // Hodnota data a času
                    new SpreadsheetMetadataSignature("DocumentId", 123456),           // Celočíselná hodnota
                    new SpreadsheetMetadataSignature("SignatureId", 123.456D),        // Dvojitá hodnota
                    new SpreadsheetMetadataSignature("Amount", 123.456M),             // Desetinná hodnota
                    new SpreadsheetMetadataSignature("Total", 123.456F)               // Hodnota s plovoucí desetinnou čárkou
                };
                
                // Přidat sbírku podpisů do možností
                options.Signatures.AddRange(signatures);
                
                // Podepsat dokument a uložit do souboru
                SignResult result = signature.Sign(outputFilePath, options);
                
                // Zobrazit výsledky
                Console.WriteLine($"\nSource spreadsheet signed successfully with {result.Succeeded.Count} signature(s).");
                Console.WriteLine($"File saved at {outputFilePath}.");
            }
        }
    }
}

Pokročilé techniky práce s metadaty v tabulkových procesorech

Práce s vlastními a vestavěnými vlastnostmi tabulky

Tabulky aplikace Excel mají vestavěné i uživatelské vlastnosti, ke kterým lze přistupovat prostřednictvím dialogového okna vlastností souboru. GroupDocs.Signature umožňuje pracovat s oběma:

// Přidat vestavěné vlastnosti
signatures = new SpreadsheetMetadataSignature[]
{
    new SpreadsheetMetadataSignature("Company", "Sherlock Holmes Consulting"),
    new SpreadsheetMetadataSignature("Category", "Financial"),
    new SpreadsheetMetadataSignature("Keywords", "budget,forecast,analysis"),
    new SpreadsheetMetadataSignature("Comments", "This spreadsheet contains confidential information"),
    new SpreadsheetMetadataSignature("Manager", "John Watson")
};
options.Signatures.AddRange(signatures);

// Přidat vlastní vlastnosti
options.Signatures.Add(new SpreadsheetMetadataSignature("Department", "Finance"));
options.Signatures.Add(new SpreadsheetMetadataSignature("SecurityLevel", "Confidential"));

Vyhledávání metadat v podepsaných tabulkách

Po podepsání můžete chtít ověřit nebo extrahovat metadata:

// Vytvořte možnosti vyhledávání pro metadata
MetadataSearchOptions searchOptions = new MetadataSearchOptions();

// Hledání podpisů metadat
SearchResult searchResult = signature.Search(searchOptions);

// Zobrazit nalezené podpisy
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})");
    }
}

Aktualizace existujících metadat

Existující metadata v tabulkách můžete aktualizovat pomocí stejných názvů vlastností:

// Aktualizovat existující metadata
options.Signatures.Add(new SpreadsheetMetadataSignature("Author", "Updated Author Name"));

Závěr

V tomto komplexním tutoriálu jste se naučili, jak podepisovat excelové tabulky metadaty pomocí nástroje GroupDocs.Signature pro .NET. Vložení metadat do souborů tabulek zlepšuje sledovatelnost dokumentů, poskytuje cenný kontext a pomáhá s určením autenticity.

Metadatové podpisy v tabulkách jsou obzvláště užitečné v obchodním prostředí, kde je důležitý původ dokumentu, autorství a sledování verzí. Vložená metadata mohou zahrnovat informace o autorovi, čase vytvoření, identifikátorech dokumentu a vlastních vlastnostech relevantních pro potřeby vaší organizace.

Implementací podpisů metadat pomocí nástroje GroupDocs.Signature si můžete zajistit, aby si vaše tabulky v Excelu zachovaly integritu a poskytovaly ověřitelné informace po celou dobu svého životního cyklu.

Často kladené otázky

Mohu přidat metadata do tabulek, které již mají definované některé vlastnosti?

Ano, můžete přidat nová metadata nebo aktualizovat stávající metadata v tabulkách. GroupDocs.Signature se postará o integraci, a to buď přidáním nových vlastností, nebo aktualizací stávajících se stejnými názvy.

Které formáty tabulek jsou podporovány pro podepisování metadat?

GroupDocs.Signature pro .NET podporuje podepisování metadat pro různé formáty tabulek, včetně XLSX, XLS, XLSM, ODS a dalších. Úplný seznam naleznete v oficiální dokumentace.

Jsou podpisy metadat v tabulkách viditelné pro uživatele?

Podpisy metadat nejsou viditelné v samotném obsahu tabulky. Lze je však zobrazit prostřednictvím panelu vlastností dokumentu v Excelu nebo jiných kompatibilních aplikacích.

Mohu programově ověřit, zda byla tabulka po přidání metadat upravena?

Ano, GroupDocs.Signature poskytuje ověřovací funkce, které mohou pomoci zjistit, zda byl dokument po podepsání upraven, včetně změn metadat.

Ovlivňuje přidání metadat funkčnost tabulky?

Přidání metadat má minimální dopad na velikost souboru a žádný vliv na funkčnost tabulky. Je to jednoduchý způsob, jak vylepšit vlastnosti dokumentu bez ovlivnění výpočtů, vzorců nebo dalších funkcí Excelu.

Kde mohu najít další zdroje a podporu?