Ajout d’un code à barres à la sortie PDF
Un code à barres est un modèle de données que les machines peuvent lire. Les clients peuvent scanner des codes-barres avec un scanner de codes-barres ou leur appareil photo de smartphone. Le codage d’informations telles que les détails du produit, les numéros d’inventaire ou les URL de site web peut s’avérer utile. L’ajout de codes à barres permet de capturer facilement les données, d’améliorer l’expérience client et de faciliter une meilleure gestion et sécurité des données.
Vous pouvez créer un style pour le code à barres. et utilisez-le pour insérer un code-barres dans une mise en page. Vous pouvez appliquer le style à un exemple de code-barres dans la mise en page souhaitée.
Ce tutoriel vous aide à ajouter des codes à barres dans la sortie PDF.
Procédure de génération d’un code-barres
Pour générer un code à barres, procédez comme suit :
Mettez à jour le CSS du modèle pour effectuer le rendu d’une valeur de code à barres
Modifiez le fichier layout.css pour effectuer le rendu d’un code à barres pendant la génération PDF. Différents types de code à barres tels que 'qrcode' et 'pdf417' sont pris en charge. Pour plus d’informations, voir Types de code-barres.
...
.barcode {
-ro-replacedelement: barcode;
-ro-barcode-type: code128;
-ro-barcode-size: 100%;
-ro-barcode-content: content();
object-fit: contain;
margin-top: 2mm;
}
...
Utiliser le style CSS pour générer le code à barres
Vous pouvez générer le code-barres de différentes manières. Voici quelques exemples :
Exemple 1
Ajoutez un espace réservé de code à barres dans l’en-tête du modèle et appliquez le style :
-
Modifiez Modèles > Mises En Page
-
Sélectionnez une mise en page. Par exemple, vous pouvez sélectionner la disposition Page de couverture arrière, qui contient l’en-tête ou le pied de page.
-
Ajoutez l’étendue suivante à l’emplacement où vous souhaitez insérer le code à barres.
<span class="barcode">Sample barcode</span></p>.note note NOTE Utilisez le même nom de classe que celui que vous avez défini dans le layout.css. -
Remplacez
<Sample barcode>par la valeur que le lecteur de code-barres doit lire.
Vous pouvez afficher le code à barres lors de la génération du PDF de sortie à l’aide du modèle, qui inclut la mise en page. Une fois les étapes précédentes effectuées, vous pouvez générer la sortie PDF avec un code à barres.
La capture d’écran suivante affiche un exemple de code à barres dans une sortie PDF.
Exemple 2
Modifiez le fichier Common.plt dans le modèle De base pour ajouter un code à barres après le titre du projet.
Pour créer un code-barres pour un numéro ISBN, ajoutez un numéro ISBN. Utilisez ensuite le numéro ISBN pour générer le code à barres.
...
<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>
}
...
Exemple 3
Pour créer un code à barres à l’aide des métadonnées de carte :
Utilisez les métadonnées présentes dans l'élément <topicmeta> d'un plan DITA à afficher sous forme de code-barres. Veillez à utiliser le XPath correct. Par exemple, vous pouvez ajouter un <resourceid> dans le <topicmeta> d'un plan DITA.
Dans l’exemple suivant, l’ID de ressource sert d’entrée principale pour générer le code à barres.
<?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>
Vous pouvez utiliser l’identifiant de ressource dans une mise en page comme suit :
<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>
}
Types de code-barres barcode-types
Voici quelques-uns des codes à barres couramment utilisés :