giriiş

Barkodlar, modern belge yönetim sistemlerinin ayrılmaz bir parçası haline gelmiş olup, kodlanmış bilgilere hızlı erişim sağlamanın yanı sıra bir güvenlik özelliği de sunmaktadır. GroupDocs.Signature for .NET, belgelerdeki barkod imzalarını doğrulamak, bunların gerçekliğini ve bütünlüğünü garanti altına almak için güçlü bir API sağlar.

Bu kapsamlı eğitim, GroupDocs.Signature kullanarak .NET uygulamalarında barkod doğrulama sürecini incelemektedir. İster iş belgeleri, ister sertifikalar, ister sözleşmeler veya kimlik doğrulama için barkod kullanan herhangi bir belge türüyle çalışıyor olun, bu kılavuz sağlam doğrulama işlevselliğini uygulamanıza yardımcı olacaktır.

Ön koşullar

Barkod doğrulama işlevselliğini uygulamadan önce aşağıdaki ön koşulların mevcut olduğundan emin olun:

GroupDocs.Signature for .NET: Kitaplığı şu adresten indirin ve yükleyin: indirme sayfası.
.NET Geliştirme Ortamı: Visual Studio veya uyumlu herhangi bir .NET geliştirme ortamı.
Temel Bilgi: C# programlama ve .NET framework kavramlarına aşinalık.
Test Belgesi: Doğrulama amaçlı barkod imzalarını içeren belge.

Gerekli Ad Alanlarını İçe Aktar

GroupDocs.Signature işlevine erişmek için gerekli ad alanlarını içe aktararak başlayın:

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

Barkod doğrulama sürecini anlaşılır ve yönetilebilir adımlara bölelim:

Adım 1: Belge Yolunu Belirleyin

// Barkod imzalarını içeren belgenin yolu
string filePath = "sample_multiple_signatures.docx";

Örnek yolu, barkod imzalarını içeren belgenizin gerçek yoluyla değiştirdiğinizden emin olun.

Adım 2: İmza Nesnesini Başlatın

// Belge yolunu geçirerek Signature sınıfının bir örneğini oluşturun
using (Signature signature = new Signature(filePath))
{
    // Doğrulama kodu burada uygulanacaktır
}

Signature sınıfı, GroupDocs.Signature API’sindeki tüm işlemler için ana giriş noktasıdır.

Adım 3: Barkod Doğrulama Seçeneklerini Yapılandırın

// Barkod doğrulama seçeneklerini tanımlayın
BarcodeVerifyOptions options = new BarcodeVerifyOptions()
{
    AllPages = true,           // Belgenin tüm sayfalarını kontrol edin
    Text = "12345",            // Barkod içindeki eşleşme metni
    MatchType = TextMatchType.Contains // Metin eşleştirme ölçütlerini belirtin
};

Doğrulama seçenekleri, doğrulama süreci için belirli kriterleri tanımlamanıza olanak tanır:

AllPages: Tüm belge sayfalarını kontrol etmek için doğru olarak ayarlayın
Text: Barkod içinde eşleşecek metin içeriği
MatchType: Metin eşleştirme yöntemi (İçerir, Tam, Başlangıç, Bitiş)

Adım 4: Doğrulama İşlemini Gerçekleştirin

// Doğrulamayı gerçekleştirin
VerificationResult result = signature.Verify(options);

Bu, belirttiğiniz seçeneklere göre doğrulama işlemini gerçekleştirir.

Adım 5: İşlem Doğrulama Sonuçları

// Doğrulama sonucunu kontrol edin ve buna göre işlem yapın
if (result.IsValid)
{
    Console.WriteLine($"Document {filePath} contains valid barcode signatures!");
    
    // Başarılı imzalar hakkında bilgi görüntüle
    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}");
}

Bu kod, doğrulamanın başarılı olup olmadığını kontrol eder ve doğrulanan barkod imzaları hakkında ayrıntılı bilgi sağlar.

Tam Örnek

İşte barkod doğrulamasını gösteren tam bir çalışma örneği:

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

namespace GroupDocs.Signature.Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            // Belge yolu
            string filePath = "sample_multiple_signatures.docx";
            
            try
            {
                // İmza örneğini başlat
                using (Signature signature = new Signature(filePath))
                {
                    // Kurulum doğrulama seçenekleri
                    BarcodeVerifyOptions options = new BarcodeVerifyOptions()
                    {
                        AllPages = true,
                        Text = "12345",
                        MatchType = TextMatchType.Contains
                    };
                    
                    // Belge imzalarını doğrulayın
                    VerificationResult result = signature.Verify(options);
                    
                    // İşlem doğrulama sonuçları
                    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}");
            }
        }
    }
}

Gelişmiş Doğrulama Senaryoları

GroupDocs.Signature, daha karmaşık doğrulama senaryoları için ek seçenekler sunar:

Belirli Barkod Türlerinin Doğrulanması

Aradığınız belirli barkod türünü biliyorsanız, doğrulamayı bu türle sınırlayabilirsiniz:

BarcodeVerifyOptions options = new BarcodeVerifyOptions()
{
    EncodeType = BarcodeTypes.Code128,  // Yalnızca Code128 barkodlarını doğrulayın
    Text = "PROD-12345",
    MatchType = TextMatchType.Exact
};

Belirli Sayfalardaki Barkodların Doğrulanması

Çok sayfalı belgeler için doğrulamayı belirli sayfalarla sınırlayabilirsiniz:

BarcodeVerifyOptions options = new BarcodeVerifyOptions()
{
    AllPages = false,
    PageNumber = 2,  // Yalnızca 2. sayfada doğrulayın
    Text = "INV-2023"
};

Doğrulama İçin Düzenli İfadelerin Kullanımı

Daha esnek desen eşleştirmesi için düzenli ifadeleri kullanabilirsiniz:

BarcodeVerifyOptions options = new BarcodeVerifyOptions()
{
    Text = "INV-\\d{4}-\\d{2}",  // INV-2023-01 gibi fatura numaralarını eşleştirin
    MatchType = TextMatchType.Regex
};

Birden Fazla Barkod Türünü Aynı Anda Doğrulama

Farklı barkod türlerini kontrol etmek için birden fazla doğrulama seçeneği oluşturabilirsiniz:

// Doğrulama seçeneklerinin bir listesini oluşturun
List<VerifyOptions> listOptions = new List<VerifyOptions>();

// QR Kod doğrulamasını ekleyin
listOptions.Add(new BarcodeVerifyOptions()
{
    EncodeType = BarcodeTypes.QR,
    Text = "Security"
});

// Code128 doğrulamasını ekleyin
listOptions.Add(new BarcodeVerifyOptions()
{
    EncodeType = BarcodeTypes.Code128,
    Text = "12345"
});

// Birden fazla seçenekle doğrulayın
VerificationResult result = signature.Verify(listOptions);

Barkod Doğrulaması için En İyi Uygulamalar

Hata Yönetimi: Beklenmeyen senaryoları zarif bir şekilde yönetmek için her zaman uygun hata yönetimini uygulayın.
Performans Optimizasyonu: Büyük belgeler için tüm belgeyi doğrulamak yerine belirli sayfaları doğrulamayı düşünün.
Günlük Kaydı: Denetim amaçlı doğrulama girişimlerini ve sonuçlarını izlemek için günlük kaydını uygulayın.
Güvenlik Hususları: Doğrulama kriterlerini, özellikle güvenlik altyapınızın bir parçasıysa, güvenli bir şekilde saklayın.
Test: Uyumluluğun sağlanması için çeşitli belge formatları ve barkod türleriyle test doğrulaması.

Yaygın Sorunların Giderilmesi

Barkod Algılanamadı

Barkodun belgede açıkça görünür olduğundan emin olun
Barkod türünün GroupDocs.Signature tarafından desteklenip desteklenmediğini kontrol edin
Barkodun bozulmadığını veya hasar görmediğini doğrulayın

Doğrulama Hataları

Doğrulama kriterlerinin (metin, barkod türü) doğru olduğunu onaylayın
MatchType’ın kullanım durumunuz için uygun olup olmadığını kontrol edin
Barkod uygulandıktan sonra belgenin değiştirilmediğini doğrulayın

Performans Sorunları

Barkodların beklendiği belirli sayfaları hedefleyerek doğrulamayı optimize edin
Önceden biliniyorsa doğrulamayı belirli barkod türleriyle sınırlayın

Çözüm

Barkod doğrulama, modern belge yönetim sistemlerinde belge gerçekliğini ve bütünlüğünü sağlamak için önemli bir araçtır. GroupDocs.Signature for .NET, .NET uygulamalarınızda güçlü barkod doğrulama işlevselliğini uygulamak için kapsamlı ve kullanımı kolay bir API sağlar.

Bu adım adım kılavuzu izleyerek şunları öğrendiniz:

Doğrulama sürecini yapılandırın ve başlatın
Çeşitli doğrulama kriterlerini belirtin
Doğrulama sonuçlarını işleyin ve yorumlayın
Gelişmiş doğrulama senaryolarını uygulayın

Bu yetenekler, çeşitli belge formatlarındaki barkodların doğruluğunu doğrulayabilen güvenli ve güvenilir belge işleme sistemleri oluşturmanıza olanak tanır.

SSS

Barkod doğrulaması için hangi belge formatları destekleniyor?

GroupDocs.Signature, PDF, Word belgeleri (DOC, DOCX), Excel elektronik tabloları (XLS, XLSX), PowerPoint sunumları (PPT, PPTX), resimler ve daha fazlası dahil olmak üzere çok çeşitli belge biçimlerini destekler.

GroupDocs.Signature tek bir belgedeki birden fazla barkodu doğrulayabilir mi?

Evet, GroupDocs.Signature tek bir belgedeki birden fazla barkodu doğrulayabilir. Doğrulama sonuçları, eşleşen tüm barkodları içerecektir.

Doğrulama için hangi barkod türleri destekleniyor?

GroupDocs.Signature, Code39, Code128, EAN13, EAN8, QR Code, DataMatrix, PDF417 ve daha birçok barkod türünü destekler.

Şifreyle korunan belgelerdeki barkodları doğrulayabilir miyim?

Evet, GroupDocs.Signature, doğrulama için korumalı belgeleri açarken belge parolalarını belirtme seçenekleri sunar.

Metin yerine ikili veri içeren barkodları doğrulamak mümkün müdür?

Evet, GroupDocs.Signature, ikili verilerle barkodları doğrulamak için seçenekler sunar BinaryData Doğrulama seçeneklerinin özelliği.