Fichier de configuration "labels.xml"


Cette page décrit le schéma XML pour le fichier de paramétrage de la classe Label.

Description du fichier

  • Commencer par une balise d'ouverture <labels> et terminer part une balise de fermeture .
  • Spécifier l'espace de nom (standard de protocole) dans la balise
  • Inclure pour chaque format de d'étiquette ou planche d'étiquette <label> en tant que balise XML parent et lui donner un identifiant comme attribut.
  • Inclure des entrées enfants <width>, <heigth>, <margin> pour chaque balise parent

Toutes les autres balises sont facultatives.

Si votre étiquette fait partie d'une planche d'étiquettes, vous devez définir :

  • un élément enfant <sheet>, et comme attribut le format de la planche (par défaut : A4).
  • des éléments enfant à celui-ci : <rows>, <cols>, <margin>

Exemple de fichier labels.xml

Vous trouverez ci-après un exemple de fichier labels.xml composé d'une étiquette simple et d'une planche d'étiquettes, utilisant toutes les balises facultatives.


<?xml version="1.0" encoding="ISO-8859-1"?>
<labels
	xmlns="http://kiwi.madvic.net/"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://kiwi.madvic.net/xsd/labels/labels.xsd">
    <label id="1">
        <name><![CDATA[Nom de l'étiquette]]></name>
        <description><![CDATA[Déscription de l'étiquette]]></description>
        <brand>Marque / Référence</brand>
        <supplier>Nom du Fournisseur</supplier>
        <width>45.7</width>
        <height>21.2</height>
        <margin>2.5</margin>
        <sheet format="A4" orientation="P" bordercolor="#DCDCDC" borderwidth="0.1">
            <cols>4</cols>
            <rows>12</rows>
            <margins>
                <topmargin>21.41</topmargin>
                <leftmargin>9.75</leftmargin>
            </margins>
        </sheet>     
    </label>
</labels>


Définitions des balises XML

Les balises XML disponibles sont décrites ci-après.

Element/Attribut Description
<labels >obligatoire

Encadre les différents balises "label".

< label> obligatoire

Balise parent de chaque entrée d'URL. Les autres balises sont des enfants de cette balise.

@id obligatoire

Identifiant de l'étiquette, permettant de faire en sorte qu'une étiquette soient unique.

<name> obligatoire

Nom donné à l'étiquette afin de pouvoir la distinguer des autres.

<description> facultatif Description de l'étiquette.
<brand> facultatif

Marque de l'étiquette. Cela sert principalement à mettre de côté les références afin de pouvoir retrouver le produit dans le commerce.

<supplier> facultatif

Fournisseur de l'étiquette. Cela sert principalement à mettre de côté les références afin de pouvoir retrouver le produit dans le commerce.

<width> obligatoire Largeur de l'étiquette.
<height> obligatoire Hauteur de l'étiquette.
<margin> obligatoire Marge intérieure de l'étiquette. C'est une marge de sécurité entre le bord et le début de ce qui va être imprimer.
<sheet> facultatif Si l'étiquette fait partie d'une planche, c'est dans cette balise que l'on fait définir la planche parente.
@format obligatoire Définit le format de papier. Ce format est prédéterminé et provient de la classe TCPDF, vioci la liste des formats acceptés :
  • 4A0
  • 2A0
  • A0
  • A1
  • A2
  • A3
  • A4
  • A5
  • A6
  • A7
  • A8
  • A9
  • A10
  • B0
  • B1
  • B2
  • B3
  • B4
  • B5
  • B6
  • B7
  • B8
  • B9
  • B10
  • C0
  • C1
  • C2
  • C3
  • C4
  • C5
  • C6
  • C7
  • C8
  • C9
  • C10
  • RA0
  • RA1
  • RA2
  • RA3
  • RA4
  • SRA0
  • SRA1
  • SRA2
  • SRA3
  • SRA4
  • LETTER
  • LEGAL
  • EXECUTIVE
  • FOLIO
@orientation facultatif Donne l'orientation de la page. Les valeurs acceptées sont les suivantes :
  • P : Portrait (Par défaut)
  • L : Paysage
@bordercolor facultatif

Couleur de la bordure de l'étiquette. (Par défaut : noir)

@borderwidth facultatif Epaisseur de la bordure en pixel.
<cols> obligatoire Nombre de colonnes de la planche / nombre d'étiquettes en largeur de la planche d'étiquettes.
<rows> obligatoire

Nombre de ligne de la planche / nombre d'étiquettes en hauteur de la planche d'étiquette.

< margins> obligatoire

Encadre les balises de définition des marges de la planche d'étiquette.

<topmargin> obligatoire

Marge du haut de la planche d'étiquette.

<leftmargin> obligatoire

Marge de gauche de la planche d'étiquette.


Validation de votre fichier labels.xml par le schema labels.xsd

Les schémas XML suivants permettent de définir les éléments et attributs susceptibles de figurer dans votre fichier Sitemap.

Vous pouvez télécharger ces schémas à l'aide des liens suivants :

URL du fichier xsd : http://kiwi.madvic.net/xsd/labels/labels.xsd

Vous pouvez tester votre fichier à cette adresse : http://kiwi.madvic.net/xsd/labels/