В днешната бърза бизнес среда технологията на баркода играе ключова роля в улесняване на операциите и подобряване на управлението на данните. Сред различните стандарти на барокод, GS1-128 се използва широко в различни отрасли за своята многообразие и способност за кодиране на подробна информация за продукта. Този ръководство ви насочва през генерирането на GS1-128-баркодове с Aspose.BarCode за .NET – от разбирането за идентификаторите на приложения (AIs) до персонализирането и износа на изображения.
Пълният пример
В края на краищата този пример:
- Създава валидна GS1 лента с помощта на общи АИ: (01) GTIN-14, (17) Expiry YYMMDD* и (10) Batch/Lot.
- Проверка на дължини / формати.
- Рендерира изображение GS1-128 с печатно-приятно размери/маргини.
- Съхранение на PNG файл. Можете да предавате стойности на твърд код или да ги прехвърлите чрез командни линии.
// File: Program.cs
// Compile: dotnet add package Aspose.BarCode && dotnet build
// Run (examples):
// dotnet run --project . -- 1234567890123 260930 ABC123 SN-00987
// dotnet run --project . -- 400638133393 260930 LOT-77 SER-42 (GTIN will be padded to 14 digits)
using System;
using Aspose.BarCode.Generation;
namespace GS1_128_BarcodeExample
{
class Program
{
static int Main(string[] args)
{
try
{
// ---------------------------
// 1) Read inputs (or defaults)
// ---------------------------
// Args: [0]=GTIN (≤14 digits), [1]=EXP YYMMDD, [2]=BATCH (var len), [3]=SERIAL (var len)
string gtinRaw = args.Length > 0 ? args[0] : "1234567890123";
string expYyMmDd = args.Length > 1 ? args[1] : "260930"; // 2026-09-30
string batchLot = args.Length > 2 ? args[2] : "ABC123";
string serial = args.Length > 3 ? args[3] : "SN-00987";
// ---------------------------
// 2) Normalize & validate
// ---------------------------
// Ensure GTIN is 14 digits (pad left with zeros when shorter)
if (gtinRaw.Length > 14 || !IsAllDigits(gtinRaw))
throw new ArgumentException("GTIN must be numeric and ≤ 14 digits.");
string gtin14 = gtinRaw.PadLeft(14, '0');
if (gtin14.Length != 14) throw new ArgumentException("GTIN must be exactly 14 digits after padding.");
// Optional (advanced): you can calculate or verify GTIN check digit here if desired.
if (!IsValidYyMmDd(expYyMmDd))
throw new ArgumentException("(17) Expiration must be YYMMDD and represent a valid calendar date.");
// Variable-length AIs (10) & (21) can be any non-empty strings; keep them short & scanner-friendly.
if (string.IsNullOrWhiteSpace(batchLot)) throw new ArgumentException("(10) Batch/Lot cannot be empty.");
if (string.IsNullOrWhiteSpace(serial)) throw new ArgumentException("(21) Serial cannot be empty.");
// ---------------------------
// 3) Compose GS1 code text
// ---------------------------
// Parentheses are human-readable; the library handles FNC1 as needed.
string gs1Text = $"(01){gtin14}(17){expYyMmDd}(10){batchLot}(21){serial}";
// ---------------------------
// 4) Configure generator
// ---------------------------
using (var generator = new BarCodeGenerator(EncodeTypes.GS1_128, gs1Text))
{
// Minimum module (bar) thickness — increase for thermal printers / rough media
generator.Parameters.Barcode.XDimension.Pixels = 3;
// Symbol height (for 1D-like linear symbol height inside GS1-128 area)
generator.Parameters.Barcode.BarHeight.Millimeters = 22f;
// Target output size (entire image). Adjust per label stock / DPI.
generator.Parameters.Barcode.ImageWidth.Inches = 2.8f;
generator.Parameters.Barcode.ImageHeight.Inches = 1.2f;
// Quiet zones (margins) — critical for scan reliability
generator.Parameters.Barcode.LeftMargin.Millimeters = 4f;
generator.Parameters.Barcode.RightMargin.Millimeters = 4f;
generator.Parameters.Barcode.TopMargin.Millimeters = 2f;
generator.Parameters.Barcode.BottomMargin.Millimeters = 2f;
// Human-readable text placement and formatting
generator.Parameters.Barcode.CodeTextParameters.Location = CodeLocation.Below;
generator.Parameters.Barcode.CodeTextParameters.FontSize.Point = 8f;
generator.Parameters.Barcode.CodeTextParameters.Space.Millimeters = 1.0f;
// ---------------------------
// 5) Save image (by extension)
// ---------------------------
string fileName = $"GS1_128_{gtin14}_{batchLot}_{serial}.png";
generator.Save(fileName);
Console.WriteLine($"✅ GS1-128 barcode saved: {fileName}");
}
return 0;
}
catch (Exception ex)
{
Console.Error.WriteLine("❌ Error: " + ex.Message);
Console.Error.WriteLine("Usage: <exe> <gtin≤14digits> <expYYMMDD> <batch> <serial>");
return 1;
}
}
// ---- Helpers ---------------------------------------------------------
// Minimal YYMMDD validation (1900–2099 windowing for simplicity)
static bool IsValidYyMmDd(string yymmdd)
{
if (string.IsNullOrWhiteSpace(yymmdd) || yymmdd.Length != 6) return false;
if (!IsAllDigits(yymmdd)) return false;
int yy = int.Parse(yymmdd.Substring(0, 2));
int mm = int.Parse(yymmdd.Substring(2, 2));
int dd = int.Parse(yymmdd.Substring(4, 2));
int year = (yy >= 0 && yy <= 79) ? 2000 + yy : 1900 + yy; // simple window
try
{
var _ = new DateTime(year, mm, dd);
return true;
}
catch
{
return false;
}
}
static bool IsAllDigits(string s)
{
foreach (char c in s)
if (c < '0' || c > '9') return false;
return true;
}
// Optional: GTIN-14 check digit calculator (Mod10). Use if you build GTIN from the first 13 digits.
// static char CalcGtin14CheckDigit(string first13Digits) { ... }
}
}
- Изграждане и бягство*
dotnet new console -n GS1_128_BarcodeExample -f net8.0
cd GS1_128_BarcodeExample
dotnet add package Aspose.BarCode
# Replace Program.cs with the code above, then:
dotnet run -- 1234567890123 260930 ABC123 SN-00987
Изходът на PNG ще бъде написан във вашия работен дневник.
Стъпка по стъпка ръководство
Стъпка 1: Разбиране на GS1-128 Основи
GS1-128 е символика, базирана на код 128**, която кодира данните с помощта на идентификатори за приложения (AI)**.
Съвместни АИ:
- (01) GTIN-14 (фиксирани 14 цифри; падеж с нули на лявата страна, ако е по-кратък)
- (17) Дата на изтичане на срока (YYMMDD)
- (10) Бач / лот (** променлива дължина**)
- (21) Сериал (** променлива дължина**)
FNC1 обработка: Когато преминавате човешко-читаема линия с парентези (например, (01)1234...(10)LOTБиблиотеката автоматично вмъква FNC1 сепаратори според правилата на GS1 – особено необходими, когато променливо-дължина AI е последвана от друга AI.
Стъпка 2: Конфигуриране на настройките на баркода
Използвайте XDimension (дъстота на модула), BarHeight и margins, за да балансирате плътността на печатната и скенерната толерантност.
generator.Parameters.Barcode.XDimension.Pixels = 3;
generator.Parameters.Barcode.BarHeight.Millimeters = 22f;
generator.Parameters.Barcode.LeftMargin.Millimeters = 4f;
generator.Parameters.Barcode.RightMargin.Millimeters = 4f;
generator.Parameters.Barcode.TopMargin.Millimeters = 2f;
generator.Parameters.Barcode.BottomMargin.Millimeters = 2f;
Стъпка 3: Определяне на идентификаторите на приложения (AIs)
Поддържайте GTIN до 14 цифри, форматните дати са YYMMDD и запазвайте променливата дължина на AIs (избягвайте пространства/контролни барабани).
string gtin14 = gtinRaw.PadLeft(14, '0');
string gs1Text = $"(01){gtin14}(17){expYyMmDd}(10){batchLot}(21){serial}";
Стъпка 4: Настройване на баркод текст
Можете да зададете текста на GS1 в конструктора или по-късно чрез generator.CodeTextПримерът го поставя в конструктора и показва как да се възстанови, ако е необходимо.
Стъпка 5: персонализиране на външния вид
Решете дали да покажете човешки-читаем код текст под лентите (CodeLocation.Belowили да го изтриете, ако вашият етикет дизайн отпечатва текст на друго място.
generator.Parameters.Barcode.CodeTextParameters.Location = CodeLocation.Below;
generator.Parameters.Barcode.CodeTextParameters.FontSize.Point = 8f;
generator.Parameters.Barcode.CodeTextParameters.Space.Millimeters = 1.0f;
Стъпка 6: генериране и съхранение
Разширяване на разширяването (.png, .jpg, .bmpЗа работните потоци на етикета PNG обикновено е най-доброто (без загуба).
generator.Save("GS1_128_ProductLabel.png");
Практически съвети и Gotchas
- Quiet зони материя: Ако сканерът се сблъсква, увеличаване на леви / десни маргини и XDизмерване малко.
- Термалните принтери: Възраст/облекло може да избледнява фини ленти.
XDimension(напр. 3–4 px) и поддържане на медиите чисти. - GTIN проверка на цифрата: Ако изграждате GTIN, изчислете/верифицирайте Mod10 проверката за предотвратяване на грешки в полето.
- Прозорци за дата: Прозорците за YY в примера са опростени; съответстват на правилата на бизнеса ви (например, само 20xx).
- Контрол на версията: Съхранявайте параметрите за размери/маргини в конфигурация, така че баркодите да могат да се възпроизвеждат в цялата среда.
заключение
С Aspose.BarCode за .NET, създаването на standards-compliant GS1-128 баркодове е прост. Определете вашите AIs, валидиране на формати, параметри за отпечатване на тонове и експортирайте чист PNG готов за етикетиране. Използвайте пълния пример по-горе като солидна изходна точка, а след това коригирайте правилата за размери/маргини и вализация, за да съответстват на принтерите, материалите и скенерите.
