Fichier de configuration "labels.xml"

Description du fichier
Définitions des balises XML
Validation de votre fichier labels.xml par le schema labels.xsd

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/

Description du fichier
Définitions des balises XML
Validation de votre fichier labels.xml par le schema labels.xsd