Wstęp

Kody kreskowe stały się integralną częścią nowoczesnych systemów zarządzania dokumentami, umożliwiając szybki dostęp do zakodowanych informacji, a jednocześnie pełniąc funkcję zabezpieczenia. GroupDocs.Signature for .NET oferuje zaawansowane API do weryfikacji podpisów kodami kreskowymi w dokumentach, gwarantując ich autentyczność i integralność.

Ten kompleksowy samouczek omawia proces wdrażania weryfikacji kodów kreskowych w aplikacjach .NET z wykorzystaniem GroupDocs.Signature. Niezależnie od tego, czy pracujesz z dokumentami biznesowymi, certyfikatami, umowami, czy jakimkolwiek innym typem dokumentów wykorzystującym kody kreskowe do uwierzytelniania, ten przewodnik pomoże Ci wdrożyć solidną funkcjonalność weryfikacji.

Wymagania wstępne

Przed wdrożeniem funkcji weryfikacji kodów kreskowych należy upewnić się, że spełnione są następujące wymagania wstępne:

GroupDocs.Signature dla .NET: Pobierz i zainstaluj bibliotekę z strona pobierania.
Środowisko programistyczne .NET: Visual Studio lub dowolne zgodne środowisko programistyczne .NET.
Wiedza podstawowa: Znajomość programowania w języku C# i koncepcji .NET Framework.
Dokument testowy: Dokument zawierający podpisy w postaci kodów kreskowych służące celom weryfikacji.

Importuj wymagane przestrzenie nazw

Zacznij od zaimportowania niezbędnych przestrzeni nazw, aby uzyskać dostęp do funkcjonalności GroupDocs.Signature:

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

Podzielmy proces weryfikacji kodów kreskowych na jasne i łatwe do opanowania kroki:

Krok 1: Określ ścieżkę dokumentu

// Ścieżka do dokumentu zawierającego podpisy kodem kreskowym
string filePath = "sample_multiple_signatures.docx";

Pamiętaj o zastąpieniu przykładowej ścieżki rzeczywistą ścieżką do dokumentu zawierającego podpisy w postaci kodów kreskowych.

Krok 2: Zainicjuj obiekt podpisu

// Utwórz instancję klasy Signature, przekazując ścieżkę dokumentu
using (Signature signature = new Signature(filePath))
{
    // Tutaj zostanie zaimplementowany kod weryfikacyjny
}

Klasa Signature stanowi główny punkt wejścia dla wszystkich operacji w interfejsie API GroupDocs.Signature.

Krok 3: Skonfiguruj opcje weryfikacji kodu kreskowego

// Zdefiniuj opcje weryfikacji kodów kreskowych
BarcodeVerifyOptions options = new BarcodeVerifyOptions()
{
    AllPages = true,           // Sprawdź wszystkie strony dokumentu
    Text = "12345",            // Tekst pasujący do kodu kreskowego
    MatchType = TextMatchType.Contains // Określ kryteria dopasowania tekstu
};

Opcje weryfikacji umożliwiają zdefiniowanie szczegółowych kryteriów procesu weryfikacji:

AllPages: Ustaw na true, aby sprawdzić wszystkie strony dokumentu
Text:Zawartość tekstu do dopasowania w kodzie kreskowym
MatchType:Metoda dopasowywania tekstu (Zawiera, Dokładny, Zaczyna się od, Kończy się od)

Krok 4: Wykonaj proces weryfikacji

// Wykonaj weryfikację
VerificationResult result = signature.Verify(options);

Na tej podstawie wykonywany jest proces weryfikacji na podstawie określonych opcji.

Krok 5: Wyniki weryfikacji procesu

// Sprawdź wynik weryfikacji i postępuj zgodnie z nim
if (result.IsValid)
{
    Console.WriteLine($"Document {filePath} contains valid barcode signatures!");
    
    // Wyświetl informacje o pomyślnych podpisach
    foreach (BarcodeSignature barcodeSignature in result.Succeeded)
    {
        Console.WriteLine($"\nFound valid barcode signature:");
        Console.WriteLine($"Text: {barcodeSignature.Text}");
        Console.WriteLine($"Type: {barcodeSignature.EncodeType.TypeName}");
        Console.WriteLine($"Location: Page {barcodeSignature.PageNumber}, {barcodeSignature.Left}x{barcodeSignature.Top}");
    }
}
else
{
    Console.WriteLine($"Document {filePath} failed verification process.");
    Console.WriteLine($"Number of failed signatures: {result.Failed.Count}");
}

Kod ten sprawdza, czy weryfikacja przebiegła pomyślnie i udostępnia szczegółowe informacje na temat zweryfikowanych podpisów kodów kreskowych.

Pełny przykład

Oto kompletny przykład działania demonstrujący weryfikację kodów kreskowych:

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

namespace GroupDocs.Signature.Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            // Ścieżka dokumentu
            string filePath = "sample_multiple_signatures.docx";
            
            try
            {
                // Zainicjuj instancję podpisu
                using (Signature signature = new Signature(filePath))
                {
                    // Skonfiguruj opcje weryfikacji
                    BarcodeVerifyOptions options = new BarcodeVerifyOptions()
                    {
                        AllPages = true,
                        Text = "12345",
                        MatchType = TextMatchType.Contains
                    };
                    
                    // Zweryfikuj podpisy dokumentów
                    VerificationResult result = signature.Verify(options);
                    
                    // Wyniki weryfikacji procesu
                    if (result.IsValid)
                    {
                        Console.WriteLine($"Document {filePath} contains valid barcode signatures!");
                        
                        foreach (BarcodeSignature item in result.Succeeded)
                        {
                            Console.WriteLine($"\nValid signature found with text: {item.Text}");
                            Console.WriteLine($"Barcode type: {item.EncodeType.TypeName}");
                            Console.WriteLine($"Page: {item.PageNumber}");
                        }
                    }
                    else
                    {
                        Console.WriteLine($"\nDocument {filePath} failed verification process.");
                    }
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error: {ex.Message}");
            }
        }
    }
}

Zaawansowane scenariusze weryfikacji

GroupDocs.Signature oferuje dodatkowe opcje dla bardziej złożonych scenariuszy weryfikacji:

Weryfikacja określonych typów kodów kreskowych

Jeśli znasz konkretny typ kodu kreskowego, którego szukasz, możesz ograniczyć weryfikację do tego typu:

BarcodeVerifyOptions options = new BarcodeVerifyOptions()
{
    EncodeType = BarcodeTypes.Code128,  // Weryfikuj tylko kody kreskowe Code128
    Text = "PROD-12345",
    MatchType = TextMatchType.Exact
};

Weryfikacja kodów kreskowych na określonych stronach

W przypadku dokumentów wielostronicowych możesz ograniczyć weryfikację do konkretnych stron:

BarcodeVerifyOptions options = new BarcodeVerifyOptions()
{
    AllPages = false,
    PageNumber = 2,  // Sprawdź tylko na stronie 2
    Text = "INV-2023"
};

Używanie wyrażeń regularnych do weryfikacji

Aby uzyskać bardziej elastyczne dopasowywanie wzorców, możesz użyć wyrażeń regularnych:

BarcodeVerifyOptions options = new BarcodeVerifyOptions()
{
    Text = "INV-\\d{4}-\\d{2}",  // Dopasuj numery faktur, takie jak INV-2023-01
    MatchType = TextMatchType.Regex
};

Jednoczesna weryfikacja wielu typów kodów kreskowych

Możesz utworzyć wiele opcji weryfikacji, aby sprawdzić różne typy kodów kreskowych:

// Utwórz listę opcji weryfikacji
List<VerifyOptions> listOptions = new List<VerifyOptions>();

// Dodaj weryfikację kodu QR
listOptions.Add(new BarcodeVerifyOptions()
{
    EncodeType = BarcodeTypes.QR,
    Text = "Security"
});

// Dodaj weryfikację Code128
listOptions.Add(new BarcodeVerifyOptions()
{
    EncodeType = BarcodeTypes.Code128,
    Text = "12345"
});

// Zweryfikuj za pomocą wielu opcji
VerificationResult result = signature.Verify(listOptions);

Najlepsze praktyki weryfikacji kodów kreskowych

Obsługa błędów: Zawsze wdrażaj odpowiednią obsługę błędów, aby sprawnie radzić sobie z nieoczekiwanymi scenariuszami.
Optymalizacja wydajności: W przypadku obszernych dokumentów należy rozważyć weryfikację poszczególnych stron, a nie całego dokumentu.
Rejestrowanie: Wprowadź rejestrowanie, aby śledzić próby weryfikacji i wyniki na potrzeby audytu.
Kwestie bezpieczeństwa: Przechowuj kryteria weryfikacji w bezpiecznym miejscu, zwłaszcza jeśli stanowią część infrastruktury bezpieczeństwa.
Testowanie: Weryfikacja testów przy użyciu różnych formatów dokumentów i typów kodów kreskowych w celu zapewnienia kompatybilności.

Rozwiązywanie typowych problemów

Kod kreskowy nie został wykryty

Upewnij się, że kod kreskowy jest wyraźnie widoczny w dokumencie
Sprawdź, czy typ kodu kreskowego jest obsługiwany przez GroupDocs.Signature
Sprawdź, czy kod kreskowy nie jest zniekształcony lub uszkodzony

Niepowodzenia weryfikacji

Potwierdź, że kryteria weryfikacji (tekst, typ kodu kreskowego) są prawidłowe
Sprawdź, czy MatchType jest odpowiedni dla Twojego przypadku użycia
Sprawdź, czy dokument nie został zmodyfikowany od momentu zastosowania kodu kreskowego

Problemy z wydajnością

Zoptymalizuj weryfikację, wybierając konkretne strony, na których spodziewane są kody kreskowe
Ogranicz weryfikację do określonych typów kodów kreskowych, jeśli są znane wcześniej

Wniosek

Weryfikacja kodów kreskowych to niezbędne narzędzie do zapewnienia autentyczności i integralności dokumentów w nowoczesnych systemach zarządzania dokumentami. GroupDocs.Signature for .NET oferuje kompleksowe i łatwe w użyciu API do wdrażania zaawansowanych funkcji weryfikacji kodów kreskowych w aplikacjach .NET.

Dzięki temu przewodnikowi krok po kroku nauczysz się, jak:

Skonfiguruj i zainicjuj proces weryfikacji
Określ różne kryteria weryfikacji
Przetwarzanie i interpretowanie wyników weryfikacji
Wdrażanie zaawansowanych scenariuszy weryfikacji

Dzięki tym możliwościom możesz tworzyć bezpieczne i niezawodne systemy przetwarzania dokumentów, które potrafią weryfikować autentyczność kodów kreskowych w różnych formatach dokumentów.

Często zadawane pytania

Jakie formaty dokumentów są obsługiwane w przypadku weryfikacji kodów kreskowych?

GroupDocs.Signature obsługuje szeroką gamę formatów dokumentów, w tym pliki PDF, dokumenty Word (DOC, DOCX), arkusze kalkulacyjne Excel (XLS, XLSX), prezentacje PowerPoint (PPT, PPTX), obrazy i wiele innych.

Czy GroupDocs.Signature może zweryfikować wiele kodów kreskowych w jednym dokumencie?

Tak, GroupDocs.Signature może zweryfikować wiele kodów kreskowych w jednym dokumencie. Wyniki weryfikacji będą obejmować wszystkie pasujące kody kreskowe.

Jakie typy kodów kreskowych są obsługiwane przy weryfikacji?

GroupDocs.Signature obsługuje wiele typów kodów kreskowych, w tym Code39, Code128, EAN13, EAN8, QR Code, DataMatrix, PDF417 i wiele innych.

Czy mogę weryfikować kody kreskowe w dokumentach chronionych hasłem?

Tak, GroupDocs.Signature udostępnia opcje określania haseł dokumentów podczas otwierania zabezpieczonych dokumentów w celu weryfikacji.

Czy można weryfikować kody kreskowe zawierające dane binarne zamiast tekstu?

Tak, GroupDocs.Signature zapewnia opcje weryfikacji kodów kreskowych za pomocą danych binarnych za pomocą BinaryData właściwość opcji weryfikacji.