Python için Aspose.Words FOSS sorun giderme

Python için Aspose.Words FOSS sorun giderme

Bu kılavuz, Aspose.BarCode FOSS ile çubuk kodları oluştururken en yaygın hataları ve sorunları kapsamaktadır (pip install aspose-barcode-fossHer bölüm hatayı, nedeni ve nasıl düzeltileceğini anlatır.

yaygın hatalar

InvalidInputError

InvalidInputError kodlayıcıya aktarılan veriler, simbololojinin karakter setine veya uzunluğa uygun olmadığında yükseltilir.

Tipik nedenler :

  • Alfabet karakterleri sayısal-sadece bir sembolize geçerek (EAN-13, EAN-8, UPC-A, U PC-E)
  • Simbololojinin sabit uzunluk gereksinimine uygun olmayan bir çubuk sağlar (örneğin EAN-13 tam olarak 12 veya 13 rakam gerektirir)
  • Simbololojinin desteklediği setin dışındaki karakterler dahil etmek (örneğin, Kod 39 taban modu yalnızca üst harfleri, rakamları ve birkaç özel karakter destekler)

düzeltme : İletişim Bilgileri Çağrı Öncesi Doğrulama BarcodeService.generate().Simbolik profilini inceleyin. capabilities ve known_limitations Karakter ayarları ve uzunluk kısıtlamaları için özellikler.

from aspose_barcode_foss import BarcodeService

service = BarcodeService()

# EAN-13 requires exactly 12 or 13 digits
data = "590123412345"  # 12 digits — valid
barcode = service.generate("ean13", data)

EncodingError

EncodingError kodlayıcı, giriş doğrulama geçtikten sonra bir iç eksiklikle karşılaştığında yükseltilir. bu daha az yaygındır. InvalidInputError.

Tipik nedenler :

  • Başlangıç doğrulama geçen ama segment kodlama sırasında başarısız olan veriler (örneğin, seçilen hata düzeltme seviyesini aşan QR Kodu verileri)
  • Saldırı kodlama seçenekleri (örneğin, talep etmek) Code128EncodeMode.CODE_A (Daha aşağıdaki karakterleri içeren verilerle)

düzeltme : Kodu seçenekleri ile ilgili inceleme yapıldı generate().Kod 128 için, kullanın Code128EncodeMode.AUTO QR kodu için en iyi alt set seçeneğini kodlayıcıya izin verin. QrErrorCorrectionLevel Ya da veri uzunluğunu azaltır.

from aspose_barcode_foss import BarcodeService, Code128Options, Code128EncodeMode

service = BarcodeService()
options = Code128Options(encode_mode=Code128EncodeMode.AUTO)
barcode = service.generate("code128", "Hello123", encode=options)

SymbologyNotFoundError

SymbologyNotFoundError İsimler, simbolun adı geçtikten sonra ortaya çıkar. BarcodeService.generate() Kayıtlı değil de, SymbologyRegistry.

Tipik nedenler :

  • Yanlış simbol adı (örneğin,. "code_128" Bunun yerine "code128")
  • Kütüphane tarafından desteklenmeyen bir sembol kullanarak (kütüphanede sadece Kod 128, Kod 39, EAN-13, Ean-8, QR Kod, UPC-A ve U PC-E destekli)

düzeltme : 7 destekli simbol kimlik tanımlayıcısından birini kullanın: "code128", "code39", "ean13", "ean8", "qrcode", "upca", "upce".Adlar durum hassas değildir, ancak kayıtlı kimlikleri eşleşmelidir.

from aspose_barcode_foss import BarcodeService

service = BarcodeService()

# Correct symbology names
barcode = service.generate("code128", "ABC-123")
barcode = service.generate("qrcode", "https://example.com")

RenderingError

RenderingError Renderer kodlanmış bir sembolden çıkış üretemediğinde yükseltilir.

Tipik nedenler :

  • Invalid RenderOptions • Olumsuz değerler (örneğin negatif değerleri) scale veya module_width)
  • Kullanmaya çalışmak PdfRenderer (PDF Rendering Yükseliyor) NotImplementedError (Şu anki versiyonu için)

düzeltme : Kullanım SvgRenderer veya PngRenderer Bunun yerine PdfRenderer.Bu kontrolü yapın RenderOptions Mülklerin olumlu değerleri vardır.

from aspose_barcode_foss import BarcodeService, RenderOptions
from aspose_barcode_foss.rendering import SvgRenderer

service = BarcodeService()
barcode = service.generate("ean13", "590123412345")

options = RenderOptions(scale=2.0, dpi=300)
result = barcode.render(SvgRenderer(), options)

Destek OlmayanKapabiliteError ve DüşükFayfaEror

UnsupportedCapabilityError Bir simbololojinin talep edilen kapasiteyi desteklemediği zaman yükseltilir (örneğin, GS1 modunda GS 1 desteği olmayan bir simboloji için). UnsupportedFeatureError Kütüphanede uygulanan özellikler için yükseltilmiştir.

düzeltme : Simbolik profilini inceleyin. capabilities GS1 modunu destekleyen semboller için talep etmeyin.

Çevre Sorunları

Python versiyonu

Aspose.BarCode FOSS requires Python 3.12 or later. If you see SyntaxError veya ithalat hataları, Python versiyonunu doğrulayın:

python --version

kurulum sorunları

Eğer pip install aspose-barcode-foss Pip güncellenmiş olduğundan emin olun:

pip install --upgrade pip
pip install aspose-barcode-foss

Kütüphane saf Python ile hiçbir yerli bağımlılıklar. yükleme başarısız ama ithalat başarısı varsa, yerel adı verilen bir dosya ile paketi gölgelenmiyor olduğundan emin olun aspose_barcode_foss.py.

İthalat Hataları

Doğru ithalat şunlardır:

import aspose_barcode_foss

veya özel sınıflar ithal etmek:

from aspose_barcode_foss import BarcodeService, RenderOptions

Sıkça Sorulan Sorular

EAN-13 çubuk kodu neden girdiğimden farklı bir sayı gösteriyor?

EAN-13 otomatik olarak bir kontrol sayısını hesaplar. eğer 12 sayı geçerseniz, 13. sayı eklendi. 13 sayı geçtiğinizde, son sayı kontrol sayı olarak doğrulanır. Ean13Options -Kıbrısallow_check_digit_input Bu davranışları kontrol etmek için bir yetki.

PDF çıkışları neden NotImplementedError yükselir?

PdfRenderer.render() ve Barcode.to_pdf() henüz kullanılmamıştır. kullanımı Barcode.to_svg() veya Barcode.to_png() Bunun yerine, ya da bir SvgRenderer veya PngRenderer Doğrudan .

Hangi simbol isimlerinin mevcut olduğunu nasıl anlarım?

Kullanım SymbologyRegistry.get_definition() bir simbololojinin kaydedildiğini kontrol etmek için. eğer yükselirse SymbologyNotFoundError,7 destekli sembolojiler şunlardır: Kod 128, Kod 39, EAN-13, Ean-8, QR Kodu, UPC-A ve U PC-E.

See Also

 Türkçe