Hinzufügen eines Barcodes zur PDF-Ausgabe

Letzte Aktualisierung: 19. Dezember 2024

Erstellt für:

  • Benutzende

Ein Barcode ist ein Datenmuster, das Maschinen lesen können. Kunden können Barcodes mit einem Barcodescanner oder ihrer Smartphone-Kamera scannen. Kodierungsinformationen wie Produktdetails, Inventarnummern oder Website-URLs können hilfreich sein. Durch das Hinzufügen von Barcodes können Sie die Daten einfach erfassen, das Kundenerlebnis verbessern und ein besseres Daten-Management und mehr Sicherheit ermöglichen.

Sie können einen Stil für den Barcode erstellen. und fügen Sie damit einen Barcode in ein Seiten-Layout ein. Sie können den Stil auf einen Beispiel-Barcode im gewünschten Seiten-Layout anwenden.

In diesem Tutorial erfahren Sie, wie Sie Barcodes in der PDF-Ausgabe hinzufügen.

Schritte zum Generieren eines Barcodes

Um einen Barcode zu generieren, führen Sie die folgenden Schritte aus:

Aktualisieren des CSS der Vorlage, um einen Barcodewert zu rendern

Ändern Sie die layout.css Datei, um während der PDF-Generierung einen Barcode zu rendern. Es werden verschiedene Barcodetypen wie „qrcode“ und „pdf417“ unterstützt. Weitere Informationen finden Sie unter Barcodetypen.

...
.barcode {
-ro-replacedelement: barcode;
-ro-barcode-type: code128;
-ro-barcode-size: 100%;
-ro-barcode-content: content();
object-fit: contain;
margin-top: 2mm;

}
...

Verwenden des CSS-Stils zum Generieren des Barcodes

Sie können den Barcode auf verschiedene Arten generieren. Einige der Beispiele sind:

Beispiel 1

Fügen Sie einen Barcode-Platzhalter in der Vorlagenkopfzeile hinzu und wenden Sie den Stil an:

  1. Bearbeiten Vorlagen > Seiten-Layouts

  2. Wählen Sie ein Seiten-Layout aus. Sie können beispielsweise das Layout der Rückseite auswählen, das die Kopf- oder Fußzeile enthält.

  3. Fügen Sie den folgenden Bereich an der Stelle hinzu, an der Sie den Barcode einfügen möchten.

    <span class="barcode">Sample barcode</span></p>.

    NOTE
    Verwenden Sie denselben Klassennamen, den Sie im layout.css definiert haben.

  4. Ersetzen Sie <Sample barcode> durch den Wert, den der Barcode-Scanner lesen soll.

Sie können den Barcode beim Generieren der Ausgabe-PDF mithilfe der Vorlage anzeigen, die das Seiten-Layout enthält. Nachdem Sie die vorherigen Schritte ausgeführt haben, können Sie die PDF-Ausgabe mit einem Barcode generieren.

Der folgende Screenshot zeigt einen Beispiel-Barcode in einer PDF-Ausgabe.

Beispielausgabe mit Barcode

Beispiel 2

Ändern Sie die Common.plt in der Basic-Vorlage, um einen Barcode nach dem Projekttitel hinzuzufügen.

Um einen Barcode für eine ISBN-Nummer zu erstellen, fügen Sie eine ISBN-Nummer hinzu. Verwenden Sie dann die ISBN-Nummer, um den Barcode zu generieren.

...

  <div data-region="header">
    <p class="chapter-header"><span data-field="project-title" data-format="default">Project Title</span> </p>
    <p><span class="barcode">978-1-56619-909-4</span></p>
  </div>
}
...

Beispiel 3

So erstellen Sie einen Barcode mit den Zuordnungsmetadaten:

Verwenden Sie beliebige Metadaten, die im <topicmeta> Element einer DITA-Map vorhanden sind, um sie als Barcode anzuzeigen. Stellen Sie sicher, dass Sie den richtigen XPath verwenden. Sie können beispielsweise eine <resourceid> in der <topicmeta> einer DITA-Zuordnung hinzufügen.

Im folgenden Beispiel dient die Ressourcen-ID als Haupteingabe zum Generieren des Barcodes.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "technicalContent/dtd/map.dtd">
<map id="GUID-3c330691-4dac-4020-904a-d2d6246aeeb1-en">
  <title>Barcode Sample</title>
  <topicmeta>
    <resourceid id="7a5bda1c-b1db-4fd8-8763-a731e2e8abba">
    </resourceid>
  </topicmeta>
  <topicref href="GUID-139f6c64-bea3-4f17-8b22-ee131557e249-en.dita" type="topic">
  </topicref>
</map>

Sie können die Ressourcen-ID in einem Seiten-Layout wie folgt verwenden:

  <div data-region="header">
    <p class="chapter-header"><span data-field="project-title" data-format="default">Project Title</span> </p>
    <p><span class="barcode" data-field="metadata" data-format="default" data-subtype="//resourceid/@id">Resource ID (barcode)</span></p>
  </div>
}