צרו תמונה של ברקוד מותאם אישית

פריט בר-קוד הוא ייצוג חזותי של נתונים בצורת קווים מקבילים או דפוסים. פריטי בר-קוד נמצאים בשימוש נרחב בתעשיות שונות כגון קמעונאות, לוגיסטיקה, בריאות, בנקאות ועוד רבים.

Microsoft Word מאפשר למשתמשים להטביע ברקודים ישירות במסמכים באמצעות שדות. המשתמשים יכולים להכניס סוג ספציפי של ברקוד, כגון קוד QR או ברקוד ליניארי, באמצעות השדה BARCODE.

במאמר זה, נבדוק כיצד שדה ה-BARCODE מיושם ב-Aspose.Words וכיצד Aspose.Words מאפשר למשתמשים לעבוד עם מסמכי וורד אליהם הוסף כבר קוד בר.

סוגי ברים הנתמכים על ידי Aspose.Words

מספר Aspose.Words תומך בסוגים שונים של ברקודים. סוג הברקוד מועבר כערך מחרוזת בתכונה BarcodeType.

מכיוון שהעבודה עם ברקודים במסגרת הפונקציונליות של Aspose.Words מוגבלת, המשתמש יכול להשתמש בכל ספרייה, כולל Aspose.Barcode, או לכתוב את הרינדור שלו בעצמו כדי לעבוד עם ברקודים. ניתן ללמוד עוד על סוגי הברקודים supported by Aspose.BarCode.

כאשר שומרים בפורמטים של וורד התומכים בברקודים, ניתן להשתמש בכל סוג ברקוד שמתאים ל-supported by Microsoft Word. אם סופק סוג שגוי של ברקוד, וורד יציג הודעת שגיאה.

כאשר שומרים לפורמטים אחרים, כגון PDF, Aspose.Words מעביר את הדמיית הבר-קוד לקוד המשתמש, כך שהמשתמש מוגבל לסוגי הבר-קוד של היישום או הספרייה בהם משתמש.

הכנס ברקוד למסמך או טעינה של מסמך עם ברקוד שהוסף מראש

Aspose.Words מספק את היכולת:

1. הזן באופן תכנותי קוד סריג לתוך מסמך באמצעות קודי השדות DisplayBarcode ו-MergeBarcode
2. או לטעון מסמך Word עם ברקודים שכבר הוכנסו אליו לביצוע עוד עבודה

Aspose.Words יש ממשק ליצירת ברקודים מותאמים אישית שהופך אותו לקל לשלב Aspose.Words ו-Aspose.BarCode יחד כדי להציג תמונות של ברקוד במסמכי פלט. לדוגמה, ניתן ליצור מסמך DOC, OOXML או RTF ולהוסיף את שדה DISPLAYBARCODE אליו באמצעות Aspose.Words. או שאתה יכול לטעון מסמך DOC, OOXML או RTF עם שדה ה-DISPLAYBARCODE כבר קיים בו ולספק לך את היישום שלך ליצירת ברקוד מותאם אישית.

שדה DISPLAYBARCODE טיפוסי הוא בעל התחביר הבא:

{ DISPLAYBARCODE "SomeData" QR \h 720 }

להלן דוגמה ליצרן קוד המשתמש ב-Aspose.Words ו-Aspose.BarCode API. הדוגמה הזו מראה כיצד להכניס תמונות של קודי סריקה בעמדת ה-“DISPLAYBARCODE” במסמך מילה:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document(getMyDir() + "Field sample - BARCODE.docx");

doc.getFieldOptions().setBarcodeGenerator(new CustomBarcodeGenerator());
        
doc.save(getArtifactsDir() + "WorkingWithBarcodeGenerator.GenerateACustomBarCodeImage.pdf");

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
public class CustomBarcodeGenerator extends DocsExamplesBase implements IBarcodeGenerator
{
    /// <summary>
    /// Converts barcode image height from Word units to Aspose.BarCode units.
    /// </summary>
    /// <param name="heightInTwipsString"></param>
    /// <returns></returns>
    private static float convertSymbolHeight(String heightInTwipsString) throws Exception {
        // Input value is in 1/1440 inches (twips).
        int heightInTwips = tryParseInt(heightInTwipsString);

        if (heightInTwips == Integer.MIN_VALUE)
            throw new Exception("Error! Incorrect height - " + heightInTwipsString + ".");

        // Convert to mm.
        return (float) (heightInTwips * 25.4 / 1440.0);
    }

    /// <summary>
    /// Converts barcode image color from Word to Aspose.BarCode.
    /// </summary>
    /// <param name="inputColor"></param>
    /// <returns></returns>
    private static Color convertColor(String inputColor) throws Exception {
        // Input should be from "0x000000" to "0xFFFFFF".
        int color = tryParseHex(inputColor.replace("0x", ""));

        if (color == Integer.MIN_VALUE)
            throw new Exception("Error! Incorrect color - " + inputColor + ".");

        return new Color((color >> 16), ((color & 0xFF00) >> 8), (color & 0xFF));

        // Backward conversion -
        // return string.Format("0x{0,6:X6}", mControl.ForeColor.ToArgb() & 0xFFFFFF);
    }

    /// <summary>
    /// Converts bar code scaling factor from percent to float.
    /// </summary>
    /// <param name="scalingFactor"></param>
    /// <returns></returns>
    private static float convertScalingFactor(String scalingFactor) throws Exception {
        boolean isParsed = false;
        int percent = tryParseInt(scalingFactor);

        if (percent != Integer.MIN_VALUE && percent >= 10 && percent <= 10000)
            isParsed = true;

        if (!isParsed)
            throw new Exception("Error! Incorrect scaling factor - " + scalingFactor + ".");

        return percent / 100.0f;
    }

    /// <summary>
    /// Implementation of the GetBarCodeImage() method for IBarCodeGenerator interface.
    /// </summary>
    /// <param name="parameters"></param>
    /// <returns></returns>
    public BufferedImage getBarcodeImage(BarcodeParameters parameters) throws Exception {
        if (parameters.getBarcodeType() == null || parameters.getBarcodeValue() == null)
            return null;

        BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.QR);

        String type = parameters.getBarcodeType().toUpperCase();

        switch (type)
        {
            case "QR":
                generator = new BarcodeGenerator(EncodeTypes.QR);
                break;
            case "CODE128":
                generator = new BarcodeGenerator(EncodeTypes.CODE_128);
                break;
            case "CODE39":
                generator = new BarcodeGenerator(EncodeTypes.CODE_39_STANDARD);
                break;
            case "EAN8":
                generator = new BarcodeGenerator(EncodeTypes.EAN_8);
                break;
            case "EAN13":
                generator = new BarcodeGenerator(EncodeTypes.EAN_13);
                break;
            case "UPCA":
                generator = new BarcodeGenerator(EncodeTypes.UPCA);
                break;
            case "UPCE":
                generator = new BarcodeGenerator(EncodeTypes.UPCE);
                break;
            case "ITF14":
                generator = new BarcodeGenerator(EncodeTypes.ITF_14);
                break;
            case "CASE":
                generator = new BarcodeGenerator(EncodeTypes.NONE);
                break;
        }

        if (generator.getBarcodeType().equals(EncodeTypes.NONE))
            return null;

        generator.setCodeText(parameters.getBarcodeValue());

        if (generator.getBarcodeType().equals(EncodeTypes.QR))
            generator.getParameters().getBarcode().getCodeTextParameters().setTwoDDisplayText(parameters.getBarcodeValue());

        if (parameters.getForegroundColor() != null)
            generator.getParameters().getBarcode().setBarColor(convertColor(parameters.getForegroundColor()));

        if (parameters.getBackgroundColor() != null)
            generator.getParameters().setBackColor(convertColor(parameters.getBackgroundColor()));

        if (parameters.getSymbolHeight() != null)
        {
            generator.getParameters().getImageHeight().setPixels(convertSymbolHeight(parameters.getSymbolHeight()));
            generator.getParameters().setAutoSizeMode(AutoSizeMode.NONE);
        }

        generator.getParameters().getBarcode().getCodeTextParameters().setLocation(CodeLocation.NONE);

        if (parameters.getDisplayText())
            generator.getParameters().getBarcode().getCodeTextParameters().setLocation(CodeLocation.BELOW);

        generator.getParameters().getCaptionAbove().setText("");

        // Empiric scaling factor for converting Word barcode to Aspose.BarCode.
        final float SCALE = 2.4f;
        float xdim = 1.0f;

        if (generator.getBarcodeType().equals(EncodeTypes.QR))
        {
            generator.getParameters().setAutoSizeMode(AutoSizeMode.NEAREST);
            generator.getParameters().getImageWidth().setInches(generator.getParameters().getImageWidth().getInches() * SCALE);
            generator.getParameters().getImageHeight().setInches(generator.getParameters().getImageWidth().getInches());
            xdim = generator.getParameters().getImageHeight().getInches() / 25;
            generator.getParameters().getBarcode().getXDimension().setInches(xdim);
            generator.getParameters().getBarcode().getBarHeight().setInches(xdim);
        }

        if (parameters.getScalingFactor() != null)
        {
            float scalingFactor = convertScalingFactor(parameters.getScalingFactor());
            generator.getParameters().getImageHeight().setInches(generator.getParameters().getImageHeight().getInches() * scalingFactor);

            if (generator.getBarcodeType().equals(EncodeTypes.QR))
            {
                generator.getParameters().getImageWidth().setInches(generator.getParameters().getImageHeight().getInches());
                generator.getParameters().getBarcode().getXDimension().setInches(xdim * scalingFactor);
                generator.getParameters().getBarcode().getBarHeight().setInches(xdim * scalingFactor);
            }

            generator.getParameters().setAutoSizeMode(AutoSizeMode.NONE);
        }

        return generator.generateBarCodeImage();

    }

    /// <summary>
    /// Implementation of the GetOldBarcodeImage() method for IBarCodeGenerator interface.
    /// </summary>
    /// <param name="parameters"></param>
    /// <returns></returns>
    public BufferedImage getOldBarcodeImage(BarcodeParameters parameters)
    {
        if (parameters.getPostalAddress() == null)
            return null;

        BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.POSTNET);
        {
            generator.setCodeText(parameters.getPostalAddress());
        }

        return generator.generateBarCodeImage();
    }

    /// <summary>
    /// Parses an integer using the invariant culture. Returns Int.MinValue if cannot parse.
    /// 
    /// Allows leading sign.
    /// Allows leading and trailing spaces.
    /// </summary>
    public static int tryParseInt(String s) {
        try {
            double value = Double.parseDouble(s);
            return castDoubleToInt(value);
        } catch (NumberFormatException e) {
            return Integer.MIN_VALUE;
        }
    }

    /// <summary>
    /// Casts a double to int32 in a way that uint32 are "correctly" casted too (they become negative numbers).
    /// </summary>
    public static int castDoubleToInt(double value)
    {
        long temp = (long) value;
        return (int) temp;
    }

    /// <summary>
    /// Try parses a hex String into an integer value.
    /// on error return int.MinValue
    /// </summary>
    public static int tryParseHex(String s)
    {
        try {
            return Integer.parseInt(s);
        } catch (NumberFormatException e) {
            return Integer.MIN_VALUE;
        }
    }
}

ניתן גם לשמור את המסמך עם ברקוד נטען או שנכנס חדש בפורמטים קבועים של עמודים כגון PDF, XPS, וכו'. הדוגמה הבאה מציגה כיצד לשמור מסמך וורד בפורמט PDF:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document(getMyDir() + "Document.docx");
doc.save(getArtifactsDir() + "BaseConversions.DocxToPdf.pdf");

למידע נוסף על המרת מסמכים מפורמט אחד לאחר, ראה את Convert a Document חלק התיעוד.

ניתן גם להשתמש בממשק IBarcodeGenerator כדי להמיר ברקודים המוטבעים במסמכי Word לתמונות. התמונות שנוצרו ניתן לחלץ מהמסמך – ראו את המאמר “עבודה עם תמונות” לקבלת פרטים נוספים.

ציין אפשרויות ברקוד

כאשר עובדים עם ברקודים ניתן להגדיר תכונות נוספות. Aspose.Words מספק לך את הכיתה – BarcodeParameters כיתה לברקודים פרמטרים להעביר לתוך BarcodeGenerator

Aspose.Words תומכת ברזולוציה מוטבעת של 96 פיקסלים לתמונה שנוצרה באמצעות IBarcodeGenerator, אשר מגבילה את הגודל המינימלי של תמונת ברקוד. כדי להתמודד עם זה, מפתחים יכולים להכניס באופן ידני תמונות ברקוד עם הרזולוציה המכוונות לתוך מסמך וורד ולשמור אותן בפורמט הנדרש. לקבלת פרטים נוספים ודוגמאות על עבודה עם ברקודים, ראו את המאמר Read Barcodes from Word Documents.