Podepisování a ověřování hlavních dokumentů pomocí GroupDocs.Signature pro .NET

Jak zvládnout podepisování a ověřování dokumentů pomocí GroupDocs.Signature pro .NET

V dnešní digitální krajině jsou efektivní řešení pro podepisování dokumentů klíčová pro správu smluv, dohod nebo jakékoli právní dokumentace. Automatizace tohoto procesu šetří čas a snižuje počet chyb. GroupDocs.Signature pro .NET nabízí robustní řešení pro zefektivnění správy textových podpisů ve vašich aplikacích. Tato komplexní příručka vás provede funkcemi GroupDocs.Signature pro .NET, včetně podepisování, ověřování, vyhledávání, aktualizace a mazání textových podpisů.

Co se naučíte

  • Jak podepisovat dokumenty pomocí přizpůsobitelných textových podpisů
  • Techniky pro efektivní ověřování podepsaných dokumentů
  • Metody pro vyhledávání existujících textových podpisů v dokumentech
  • Kroky pro aktualizaci a odstranění textových podpisů podle potřeby
  • Nejlepší postupy pro optimalizaci výkonu a správy paměti

Začněme tím, že si projdeme předpoklady.

Předpoklady

Než začnete, ujistěte se, že máte ve svém vývojovém prostředí připravené potřebné nástroje:

Požadované knihovny a závislosti

  • GroupDocs.Signature pro .NETTato knihovna vám umožňuje přidávat do vašich aplikací funkce pro podpis.
  • .NET Framework 4.6.1 nebo vyšší (nebo .NET Core 2.x+)

Požadavky na nastavení prostředí

Budete potřebovat vývojové prostředí C#, například Visual Studio, a připojení k internetu pro stažení potřebných balíčků.

Předpoklady znalostí

Doporučuje se znalost základních konceptů programování v C#. Pokud s GroupDocs.Signature pro .NET teprve začínáte, nebojte se – tato příručka vás provede každým krokem.

Nastavení GroupDocs.Signature pro .NET

Chcete-li začít, budete muset do svého projektu nainstalovat knihovnu GroupDocs.Signature. Postupujte takto:

Instalace přes .NET CLI

dotnet add package GroupDocs.Signature

Konzola Správce balíčků

Install-Package GroupDocs.Signature

Uživatelské rozhraní Správce balíčků NuGet

  1. Otevřete svůj projekt ve Visual Studiu.
  2. Přejít na Nástroje > Správce balíčků NuGet > Správa balíčků NuGet pro řešení.
  3. Vyhledejte „GroupDocs.Signature“ a nainstalujte nejnovější verzi.

Kroky získání licence

Základní inicializace a nastavení

Po instalaci inicializujte soubor GroupDocs.Signature ve vašem projektu takto:

using GroupDocs.Signature;

// Inicializujte instanci Signature cestou k dokumentu.
Signature signature = new Signature("path/to/your/document.pdf");

Nyní, když máte vše nastavené, pojďme se podívat, jak využít GroupDocs.Signature pro různé funkce.

Průvodce implementací

Podepsat dokument textovým podpisem

Tato funkce umožňuje přidat do dokumentu textové podpisy. Pojďme si to rozebrat:

Přehled

Vzhled a umístění textového podpisu si můžete přizpůsobit pomocí různých možností, jako je velikost písma, barva, zarovnání atd.

Postupná implementace

Krok 1Definujte cestu k souboru a umístění výstupu.

string filePath = "YOUR_DOCUMENT_DIRECTORY"; // Cesta k původnímu dokumentu
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");

Krok 2Vytvořte textový podpis pomocí TextSignOptions.

using (Signature signature = new Signature(filePath))
{
    TextSignOptions signOptions = new TextSignOptions("John Smith")
    {
        VerticalAlignment = GroupDocs.Signature.Options.VerticalAlignment.Top,
        HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Center,
        Width = 100,
        Height = 40,
        Margin = new Padding(20),
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };

Krok 3Podepište dokument a vytiskněte výsledky.

    SignResult signResult = signature.Sign(outputFilePath, signOptions);
    foreach (BaseSignature temp in signResult.Succeeded)
    {
        Console.WriteLine($"Signed Text Signature: Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
    }
}

Možnosti konfigurace klíčů

  • Vertikální zarovnání a horizontální zarovnáníUrčete, kde se podpis na stránce zobrazí.
  • Písmo: Přizpůsobte si velikost a styl písma pro svůj textový podpis.

Ověření dokumentu pro textový podpis

Ověření zajišťuje, že dokument byl podepsán tak, jak bylo zamýšleno. Zde je návod, jak ho implementovat:

Přehled

Ověřte stávající textové podpisy ve vašich dokumentech, abyste potvrdili jejich pravost a integritu.

Postupná implementace

Krok 1: Zadejte cestu k souboru podepsaného dokumentu.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Cesta k podepsanému dokumentu

Krok 2Vytvořte možnosti ověření pomocí TextVerifyOptions.

using (Signature signature = new Signature(filePath))
{
    TextVerifyOptions verifyOptions = new TextVerifyOptions()
    {
        AllPages = false,
        PageNumber = 1,
        Text = "John Smith",
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact
    };

Krok 3Ověřte dokument.

    VerificationResult verifyResult = signature.Verify(verifyOptions);
    if (verifyResult.IsValid)
    {
        Console.WriteLine("Document was verified successfully!");
    }
    else
    {
        Console.WriteLine("Document failed verification process.");
    }
}

Tipy pro řešení problémů

  • Zajistěte, aby Text vlastnost přesně odpovídá tomu, co je v dokumentu.
  • Zkontrolujte to PageNumber odpovídá správné stránce obsahující podpis.

Vyhledat dokument pro textový podpis

Pomocí této funkce efektivně vyhledávejte textové podpisy ve svých dokumentech.

Přehled

Prohledejte všechny nebo vybrané stránky dokumentu a najděte konkrétní textové podpisy.

Postupná implementace

Krok 1: Definujte cestu k souboru.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Cesta k podepsanému dokumentu

Krok 2Použití TextSearchOptions pro hledání.

using (Signature signature = new Signature(filePath))
{
    TextSearchOptions searchOptions = new TextSearchOptions()
    {
        AllPages = true,
        MatchType = GroupDocs.Signature.Options.TextMatchType.Exact,
        Text = "John Smith"
    };

Krok 3: Provést vyhledávání.

    List<TextSignature> signatures = signature.Search<TextSignature>(searchOptions);
    foreach (TextSignature textSignature in signatures)
    {
        if (textSignature != null)
        {
            Console.WriteLine($"Found Text signature at page {textSignature.PageNumber} with type [{textSignature.SignatureImplementation}] and text '{textSignature.Text}'. Location: {textSignature.Left}-{textSignature.Top}. Size is {textSignature.Width}x{textSignature.Height}.");
        }
    }
}

Aktualizovat podpis textu dokumentu

V případě potřeby upravte existující textové podpisy v dokumentu.

Přehled

Upravte vlastnosti existujících textových podpisů, jako je velikost a umístění.

Postupná implementace

Krok 1Zadejte cestu k souboru a ID podpisu.

string filePath = "YOUR_OUTPUT_DIRECTORY"; // Cesta k podepsanému dokumentu
List<string> signatureIds = new List<string>(); // Předpokládejme, že tento seznam je naplněn platnými ID podpisů.

Krok 2Vytvořit TextSignature objekty pro aktualizace.

using (Signature signature = new Signature(filePath))
{
    foreach (var item in signatureIds)
    {
        TextSignature temp = new TextSignature(item)
        {
            Width = 150,
            Height = 50,
            HorizontalAlignment = GroupDocs.Signature.Options.HorizontalAlignment.Right
        };

Krok 3: Aktualizovat dokument.

        SignResult signResult = signature.UpdateSignatures(temp);
        if (signResult.Succeeded.Count > 0)
        {
            Console.WriteLine($"Updated Text Signature: Id:{temp.SignatureId}");
        }
    }
}

Možnosti konfigurace klíčů

  • Šířka a výška: Upravte velikost podpisu.
  • HorizontálníZarovnání: Určete, kde se na stránce zobrazí aktualizovaný podpis.

Závěr

Dodržováním tohoto průvodce jste se naučili, jak podepisovat, ověřovat, vyhledávat, aktualizovat a mazat textové podpisy v dokumentech pomocí GroupDocs.Signature pro .NET. Tyto funkce jsou nezbytné pro automatizaci procesů digitálního podepisování ve vašich aplikacích. Podrobnější informace a pokročilé možnosti naleznete v oficiální dokumentace.