В днешната бързо развиваща се бизнес среда баркод технологията играе решаваща роля в оптимизирането на операциите и подобряването на управлението на данните. Сред различните баркод стандарти, GS1-128 се използва широко в различни индустрии заради своята гъвкавост и способност да кодира подробна информация за продукта. Това ръководство ви води през процеса на генериране на баркодове GS1-128 с Aspose.BarCode for .NET—от разбирането на Application Identifiers (AIs) до персонализирането на външния вид и експортирането на изображения.

Пълен пример

Този пример от край до край:

  • Създава валиден GS1 низ, използвайки общи AI: (01) GTIN-14, (17) Срок YYMMDD, (10) Партида/Лот, (21) Сериен.
  • Валидира дължини/формати.
  • Генерира изображение 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 е a Базиран на Code 128 символика, която кодира данни, използвайки Идентификатори на приложения (AIs). Всеки AI определя какво следва (тип данни & дължина).

Общи AI:

  • (01) GTIN-14 (фиксирани 14 цифри; попълнете с нули отляво, ако е по-кратко)
  • (17) Дата на изтичане (YYMMDD)
  • (10) Партида/Лот (променлива дължина)
  • (21) Serial (променлива дължина)

Обработка на FNC1: Когато предадете човеко‑четим низ със скоби (e.g., (01)1234...(10)LOT), библиотеката автоматично вмъква FNC1 разделители според правилата на GS1—особено необходимо, когато a AI с променлива дължина се следва от друг AI.

Стъпка 2: Конфигуриране на настройките за баркод

Използвай XDimension (дебелина на модула), BarHeight, и маржове за да се балансира плътността на печат и толерантността на скенера. За термални етикети, леко по-висок XDimension и щедри тихи зони подобряват първоначалните скорости на четене.

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: Определете идентификатори на приложението (AI)

Допълнете GTIN до 14 digits, форматирай датите като 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");

Практични съвети & клопки

  • Тихите зони имат значение: Ако скенерът се затруднява, увеличете леко левия/десния марж и XDimension.
  • Термични принтери: Възрастта/износването могат да замъглят фините линии. Удари XDimension (например 3–4 px) и запазете медиа чисти.
  • GTIN контролна цифра: Ако конструирате GTIN‑ове, изчислете/провери Mod10 check digit, за да предотвратите грешки в полето.
  • Прозорци за дата: YY прозорецът в примера е опростен; съобразете се с вашите бизнес правила (например, само 20xx).
  • Контрол на версии: Съхранявайте параметрите за размер/марж в конфигурацията, за да бъдат баркодовете възпроизведими в различни среди.

Заключение

С Aspose.BarCode for .NET, създаване съответстващ на стандартите GS1-128 barcodes е прост. Дефинирайте вашите AI‑те, валидирайте форматите, настройте параметрите за печат и експортирайте чист PNG, готов за етикетиране. Използвайте пълния пример по‑горе като солидна отправна точка, след което коригирайте размерите/маржовете и правилата за валидиране, за да съответстват на вашите принтери, материали и скенери.

More in this category