Formatage des allergènes des ingrédients alimentaires

Les obligations concernant l'étiquetage alimentaire dans l'Union Européenne, formalisées dans la Régulation (EU) No. 1169/2011, ne spécifient pas seulement quelles sont les informations concernées, mais aussi la manière de les présenter y compris la police, la couleur et le contraste. La réglementation règle uniquement la taille de la police, mais elle laisse à l'utilisateur la liberté de choisir de quelle manière il va mettre en évidence les allergènes. Dans la liste des ingrédients, les allergènes doivent être imprimés de manière à être distingués du reste de la liste (par exemple en gras, italique, souligné, inversé ou de couleur différente).

NiceLabel dispose de fonctions personnalisées permettant de formater les allergènes. Ces fonctions prédéfinies permettent de mettre en évidence les allergènes dans la liste des ingrédients. Pour les mettre en évidence, on peut les mettre en gras, italique, souligné, en majuscule ou en combinant ces formats. Le résultat de la fonction est une donnée en RTF utilisable avec l'objet Paragraphe enrichi.

Le nom de l'allergène peut apparaître lié à un autre ingrédient non allergène. Dans ce cas, on peut utiliser une fonction de type WithExceptions. Ces fonctions accepteront un autre paramètre d'entrée - une liste d'exceptions. Ce sont les mots ou phrases qui ne doivent pas être formatés même s'ils contiennent le nom d'un allergène. Par exemple, le mot "lait" sera défini comme allergène, il serait donc aussi mis en évidence dans l'ingrédient lait de coco", ce qui serait faux. Il faudra donc définir "lait de coco" comme étant une exception et Desktop Designer ne mettra pas en évidence le mot "lait" lorsqu'il est utilisé avec "lait de coco".

Note

Consulter les exemples et la documentation complémentaire sur le NiceLabelsite Internet de: Normes EU allergènes alimentaires.

Conditions préalables

Les fonctions Food Allergens se connectent aux sources de données pour y lire les allergènes. Pour ouvrir la source de données, les pilotes correspondant à la base de données (Pilotes ODBC) doivent être installés sur l'ordinateur.

Pour les sources de données Excel et Access. Si Microsoft Office est installé sur la même machine, le pilote de la base de données est déjà installé. Si non, installer les pilotes séparément. Aller sur le site de Microsoft Centre de téléchargement, télécharger et installer Microsoft Access Database Engine 2010 Redistribuable ou Microsoft Access 2013 Runtime.
Pour les sources de données MS SQL. Le pilote ODBC a été mis dans le Pack de fonctionnalités de Microsoft SQL Server. Il faut installer l'outil d'utilisation du fournisseur SQLSQLNCLI11. Aller sur le Centre de téléchargement de Microsoft pour télécharger le pilote.

Mise en forme des allergènes

Pour formater les allergènes dans la liste des ingrédients, il faut exécuter la fonction de mise en forme et fournir les paramètres de données. La mise en forme se fait dans une fonction VBScript qui met le résultat dans une variable de sortie utilisable directement dans un objet paragraphe enrichi. La fonction à utiliser doit correspondre à l'emplacement des données comportant la liste des allergènes, par exemple chaînes CSV, tableau Microsoft Excel, ou base de données Microsoft Access.

Pour formater les allergènes mis dans un tableau Excel, procéder comme suit :

Créer une nouvelle étiquette dans Desktop Designer et ouvrir le Gestionnaire de données dynamiques.
Cliquer sur Fonctions, sélectionner VB Script et saisir le Nom de la fonction.
Ouvrir l'éditeur de scripts.
Changer la ligne Result = "0" en Result = et placer le curseur après le signe égal.
Sous Custom functions, étirer Food Alergens et sélectionner FormatAllergensFromExcel
Dans l'éditeur de Script, définir les paramètres de la fonction, par exemple :

Result = FormatAllergensFromExcel([Products.Ingred],"c:\Data\DB.xlsx","Allergens","Allergen","bold,italic,underline")

Cela permettra de lire la liste des ingrédients donnée par la variable Products.Ingred, de lire la liste des allergènes dans le fichier Microsoft DB.xls à la colonne Produit dans la feuille Products et de mettre en gras tous les allergènes concernés.
Cliquer sur OK.
Dans Nom de la variable de sortie, définir le nom de la variable dans laquelle les allergènes formatés vont être enregistrés.

Note

Attention : le nom de la variable doit commencer par le préfixe RTF_, par exemple : RTF_Allergens. Cela permettra à l'objet texte enrichi de respecter les codes spécifiés dans la variable.
Cliquer sur OK.
Sélectionner l'objet Texte enrichi et l'ajouter sur le plan de travail.
Dansl'éditeur de texte RTF, sélectionner votre variable dans la liste et l'ajouter au contenu.

Il est possible d'ajouter d'autres variables ou des textes fixes si nécessaire.
Utiliser les commandes disponibles dans l'éditeur de texte RTF pour changer le format des polices, la taille et la couleur.
Cliquer sur OK.

Syntaxe des fonctions de mise en forme des allergènes

Liste des allergènes pour l'utilisateur

La fonction va récupérer la liste des ingrédients et la liste des allergènes en deux variables et créer le code RTF avec les allergènes mis en évidence. Tous les noms des Allergènes rencontrés dans les Ingrédients seront formatés en fonction des spécifications de Surlignage.

Syntaxe :

FormatAllergens (Ingrédients,Allergènes,Surlignage)

Paramètres

Description

Ingrédients

La liste en CSV des ingrédients.

Allergènes

La liste en CSV des allergènes.

Surlignage

La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000".

C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.

Exemple 139. Exemple

FormatAllergens("farine de blé,sel,matière grasse végétale,noisettes","blé,noisettes","bold,italic")

FormatAllergens(Ingrédients,"blé,noisettes","bold,italic")

Allergènes dans une table Microsoft Excel

Cette fonction récupère la liste des ingrédients et l'emplacement de la feuille de calcul Microsoft Excel. La fonction va récupérer les allergènes dans la table et créer le code RTF avec les allergènes mis en évidence. Tous les mots de la table des allergènes qui correspondent aux Ingrédients seront surlignés au format spécifié.

Syntaxe :

FormatAllergenesFromExcel(Ingrédients,Fichier Excel,Feuille de calcul,Colonne,Surlignage)

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
Fichier Excel	Le chemin complet et le nom du fichier Microsoft Excel contenant les allergènes.
Feuille de calcul	Le nom de la table contenant la liste des allergènes.
Champ	Le nom du champ (nom de la colonne) contenant les allergènes. il est possible de donner aussi l'index de la colonne contenant la liste des allergènes. La colonne A doit s'appeler "1", colonne B : "2", etc.
Surlignage	La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000". C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.

Allergènes dans une base de données Microsoft Access

Cette fonction récupère la liste des ingrédients et l'emplacement de la base de données Microsoft Access. La fonction va récupérer les allergènes dans le tableau et créer le code RTF avec les allergènes mis en évidence. Tous les mots de la table de la base de données qui correspondent aux Ingrédients seront surlignés au format spécifié.

Syntaxe :

FormatAllergensFromAccess (ingrédients,AccessDb,table,champ,surlignage)

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
AccessDb	Le chemin complet et le nom du fichier Microsoft Access contenant les allergènes.
table	Le nom de la table contenant la liste des allergènes.
Champ	Le nom du champ (nom de la colonne) contenant les allergènes. il est possible de donner aussi l'index de la colonne contenant la liste des allergènes. Le champ 1 doit s'appeler "1", le champ 2 doit s'appeler "2", etc.
Surlignage	La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000". C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.

Allergènes dans une base de données Microsoft SQL

Cette fonction récupère la liste des ingrédients et l'emplacement de la base de données Microsoft SQL Server. La fonction va récupérer les allergènes dans le tableau et créer le code RTF avec les allergènes mis en évidence. Tous les mots de la table de la base de données qui correspondent aux Ingrédients seront surlignés au format spécifié.

Syntaxe :

FormatAllergensFromMSSQL(ingredients,sqlserver,dbusername,dbpassword, dbname,table,field,highlight

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
sqlserver	Le chemin complet et le nom du fichier de la base de données Microsoft SQL Server contenant les allergènes.
dbusername	Le nom d'utilisateur défini sur le serveur SQL.
dbpassword	Le mot de passe de cet utilisateur pour accéder à la base de données.
dbname	Nom de la base de données contenant la liste des allergènes.
table	Le nom de la table contenant la liste des allergènes.
Champ	Le nom du champ (nom de la colonne) contenant les allergènes.
Surlignage	La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000". C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.

Allergènes sur SQL Server

Cette fonction récupère la liste des ingrédients et l'emplacement de la base de données SQL Server. La fonction va récupérer les allergènes dans le tableau et créer le code RTF avec les allergènes mis en évidence. Tous les mots de la table de la base de données qui correspondent aux Ingrédients seront surlignés au format spécifié.

Syntaxe :

FormatAllergensFromSQL(ingredients,connectionstring,table,field, highlight)

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
connectionstring	Chaîne de connexion utilisée pour se connecter à la base de données SQL Server.
table	Le nom de la table contenant la liste des allergènes.
Champ	Le nom du champ (nom de la colonne) contenant les allergènes.
Surlignage	La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000". C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.

Allergènes dans les tags

Cette fonction va utiliser la liste des ingrédients dans laquelle les allergènes sont marqués par des balises. La fonction va récupérer les allergènes dans le tableau et créer le code RTF avec les allergènes mis en évidence. Les valeurs situées entre deux balises dans les Ingrédients sont surlignées au format spécifié.

Syntaxe :

FormatAllergensFromTags(ingredients,tag,highlight)

Paramètres

Description

Ingrédients

La liste en CSV des ingrédients.

Balise

Caractère utilisé pour encadrer l'allergène.

Surlignage

C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.

Syntaxe des fonctions de mise en forme des allergènes avec discrimination

Liste des allergènes pour l'utilisateur

La fonction va récupérer la liste des ingrédients et la liste des allergènes en deux variables et créer le code RTF avec les allergènes mis en évidence. Tous les noms des Allergènes rencontrés dans les Ingrédients seront surlignés au format spécifié. Le dernier paramètre contient la liste CSV des expressions à ne pas mettre en évidence même si elles contiennent les noms d'allergènes.

Syntaxe :

FormatAllergensWithExclusions(Ingredients,Allergens,Highlight,Exclusions)

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
Allergènes	La liste en CSV des allergènes.
Surlignage	La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000". C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.
Exclusions	La liste CSV des mots et expressions qui ne seront pas mis en évidence même s'ils contiennent le nom d'un allergène. Le lait est un allergène donc le mot "lait" doit être mis en évidence, sauf s'il est utilisé dans l'expression "lait de coco". Dans ce cas, "lait de coco" doit être défini comme une exclusion.

Exemple 140. Exemple

FormatAllergènesAvecExclusions("farine de blé,sel,huile vég.,noisettes,lait

de coco","blé,noisettes,lait","bold, italic","lait de coco")

Allergènes dans une table Microsoft Excel

Cette fonction récupère la liste des ingrédients et l'emplacement de la table Microsoft Excel. La fonction va récupérer les allergènes dans la table et créer le code RTF avec les allergènes mis en évidence. Tous les mots de la table des allergènes qui correspondent aux Ingrédients seront surlignés au format spécifié. Le dernier paramètre contient la liste CSV des expressions à ne pas mettre en évidence même si elles contiennent les noms d'allergènes.

Syntaxe :

FormatAllergensFromExcelWithExclusions(Ingredients,ExcelFile,Spreadsheet,Field,Highlight,SpreadsheetEx,FieldEx)

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
Fichier Excel	Le chemin complet et le nom du fichier Microsoft Excel contenant les allergènes.
Feuille de calcul	Le nom de la table contenant la liste des allergènes.
Champ	Le nom du champ (nom de la colonne) contenant les allergènes. il est possible de donner aussi l'index de la colonne contenant la liste des allergènes. La colonne A doit s'appeler "1", colonne B : "2", etc.
Surlignage	La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000". C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.
Feuille de calcul	Le nom de la table contenant la liste des mots & expressions contenant un allergène à ne pas mettre en évidence.
FieldEx	Le nom du champ (nom de la colonne) contenant les chaînes à exclure du formatage. il est possible de donner aussi l'index de la colonne contenant la liste des allergènes. La colonne A doit s'appeler "1", colonne B : "2", etc.

Exemple 141. Exemple

FormatAllergensFromExcelWithExceptions("farine de blé,sel,matières grasses végétales,noisettes","c:\files\data.xlsx","Sheet1","1","bold,italic","Sheet2","2")

FormatAllergensFromExcelWithExceptions(Ingredients,"c:\files\data.xlsx","Sheet1","1","bold,italic","Sheet2","2")

Allergènes dans une base de données Microsoft Access

Cette fonction récupère la liste des ingrédients et l'emplacement de la base de données Microsoft Access. La fonction va récupérer les allergènes dans le tableau et créer le code RTF avec les allergènes mis en évidence. Tous les mots de la table des allergènes qui correspondent aux Ingrédients seront surlignés au format spécifié. Le dernier Paramètre contient la liste CSV des expressions à ne pas mettre en évidence même si elles contiennent les noms d'allergènes.

Syntaxe :

FormatAllergensFromAccessWithExclusions(ingredients,accessdb,table_with_allergens,field_with_allergens,highlight,table_with_exclusions,field_with_exclusions)

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
Accessdb	Le chemin complet et le nom du fichier Microsoft Access contenant les allergènes.
table_with_allergens	Le nom de la table contenant la liste des allergènes.
field_with_allergens	Le nom du champ (nom de la colonne) contenant les allergènes.
table_with_exclusions	Le nom de la table contenant la liste des mots & expressions contenant un allergène à ne pas mettre en évidence.
field_with_exclusions	Le nom du champ (nom de la colonne) contenant les chaînes à exclure du formatage.

Allergènes dans une base de données Microsoft SQL

Syntaxe :

FormatAllergensFromMSSQLWithExclusions(ingredients,sqlserver,dbusername,dbpassword,dbname,table_with_allergens,field_with_allergens,highlight,table_with_exclusions,field_with_exclusions)

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
sqlserver	Le chemin complet et le nom du fichier de la base de données Microsoft SQL Server contenant les allergènes.
dbusername	Le nom d'utilisateur défini sur le serveur SQL.
dbpassword	Le mot de passe de cet utilisateur pour accéder à la base de données.
dbname	Nom de la base de données contenant la liste des allergènes.
table_with_allergens	Le nom de la table contenant la liste des allergènes.
field_with_allergens	Le nom du champ (nom de la colonne) contenant les allergènes.
Surlignage	La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000". C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.
table_with_exclusions	Le nom de la table contenant la liste des mots & expressions contenant un allergène à ne pas mettre en évidence.
field_with_exclusions	Le nom du champ (nom de la colonne) contenant les chaînes à exclure du formatage.

Allergènes sur SQL Server

Syntaxe :

FormatAllergensFromSQLWithExclusions(ingredients,connectionstring,table_with_allergens,field_with_allergens,highlight,table_with_exclusions,field_with_exclusions)

Paramètres	Description
Ingrédients	La liste en CSV des ingrédients.
connectionstring	Chaîne de connexion utilisée pour se connecter à la base de données SQL Server.
table_with_allergens	Le nom de la table contenant la liste des allergènes.
field_with_allergens	Le nom du champ (nom de la colonne) contenant les allergènes.
Surlignage	La liste en CSV du mode de formatage à appliquer aux allergènes. Vous pouvez utiliser "bold", "italic", "underline" et/ou "caps", texte en couleur ou fond en couleur. Les couleurs sont formatées en syntaxe hex dans le schéma RVB, par exemple "#FF0000" pour le rouge. Pour la couleur du texte, il suffit de donner le code de couleur, pour l'arrière plan le code couleur aura le préfixe "bg", par exemple : "bg #FF0000". C'est un paramètre facultatif. Si sa valeur est vide (""), le format bold s'appliquera.
field_with_exclusions	Le nom du champ (nom de la colonne) contenant les chaînes à exclure du formatage.

Info Niveau De Produit

Note

Conditions préalables

Mise en forme des allergènes

Note

Syntaxe des fonctions de mise en forme des allergènes

Liste des allergènes pour l'utilisateur

Allergènes dans une table Microsoft Excel

Allergènes dans une base de données Microsoft Access

Allergènes dans une base de données Microsoft SQL

Allergènes sur SQL Server

Allergènes dans les tags

Syntaxe des fonctions de mise en forme des allergènes avec discrimination

Liste des allergènes pour l'utilisateur

Allergènes dans une table Microsoft Excel

Allergènes dans une base de données Microsoft Access

Allergènes dans une base de données Microsoft SQL

Allergènes sur SQL Server