Aggiungere un codice a barre all'output PDF

Un codice a barre è un pattern di dati che le macchine possono leggere. I clienti possono scansionare i codici a barre con uno scanner o una fotocamera per smartphone. Può essere utile codificare informazioni quali dettagli di prodotto, numeri di inventario o URL di siti web. L’aggiunta di codici a barre consente di acquisire facilmente i dati, migliora l’esperienza del cliente e facilita una migliore gestione e sicurezza dei dati.

È possibile creare uno stile per il codice a barre. e utilizzarlo per inserire un codice a barre in un layout di pagina. Puoi applicare lo stile a un codice a barre di esempio nel layout di pagina desiderato.

Questa esercitazione consente di aggiungere codici a barre nell'output di PDF.

Passaggi per generare un codice a barre

Per generare un codice a barre, effettuare le seguenti operazioni:

Aggiornare il CSS del modello per eseguire il rendering di un valore di codice a barre

Modificare il file layout.css per eseguire il rendering di un codice a barre durante la generazione di PDF. Sono supportati vari tipi di codice a barre come "qrcode" e "pdf417". Per ulteriori dettagli, visualizzare Tipi di codice a barre.

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

}
...

Usa lo stile CSS per generare il codice a barre

Puoi generare il codice a barre in diversi modi. Alcuni esempi sono i seguenti:

Esempio 1

Aggiungi un segnaposto per codice a barre nell’intestazione del modello e applica lo stile:

Puoi visualizzare il codice a barre durante la generazione del PDF di output utilizzando il modello, che include il layout della pagina. Dopo aver eseguito i passaggi precedenti, puoi generare l’output PDF con un codice a barre.

La schermata seguente mostra un codice a barre di esempio in un output PDF.

{width="700"}

Esempio 2

Modificare il file Common.plt nel modello Basic per aggiungere un codice a barre dopo il titolo del progetto.

Per creare un codice a barre per un numero ISBN, aggiungere un numero ISBN. Quindi utilizza il numero ISBN per generare il codice a barre.

...

  <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>
}
...

Esempio 3

Per creare un codice a barre utilizzando i metadati della mappa:

Utilizzare i metadati presenti nell'elemento <topicmeta> di una mappa DITA per visualizzarli come codice a barre. Assicurarsi di utilizzare l'XPath corretto. Ad esempio, è possibile aggiungere <resourceid> in <topicmeta> di una mappa DITA.

Nell’esempio seguente, l’ID risorsa funge da input principale per generare il codice a barre.

<?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>

Puoi utilizzare l’ID risorsa in un layout di pagina come segue:

  <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>
}

Tipi di codice a barre barcode-types

Alcuni dei codici a barre comunemente utilizzati sono i seguenti: