Formattazione di allergeni per ingredienti alimentari

La legislazione dell'Unione Europea sull'etichettatura obbligatoria, formalizzata nel Regolamento (UE) N. 1169/2011 non soltanto specifica quali informazioni devono essere riportate, ma anche come devono venire presentate, compresi i caratteri, i colori e il contrasto. Il regolamento descrive in dettaglio le dimensioni dei caratteri, ma consente all'utente la facoltà di scegliere l'esatta evidenziazione del tipo di allergene. Gli allergeni degli ingredienti devono essere stampati utilizzando un carattere che li distingua dal resto dell'elenco (come ad esempio grassetto, corsivo, sottolineato, invertito o un colore diverso).

NiceLabel offre un supporto incorporato per la formattazione degli allergeni mediante funzioni personalizzate. Si tratta di funzioni predefinite utilizzabili per evidenziare gli allergeni nell'elenco di ingredienti. Per evidenziarli, è possibile usare i formati grassetto, corsivo, sottolineato, MAIUSCOLO o una combinazione di queste formattazioni. Il risultato della funzione sono i dati in formato RTF utilizzabili con l'oggetto Casella di testo arricchito.

La parola "allergene" può apparire in riferimento a un determinato ingrediente non classificato come allergene. In questo caso, è possibile usare il tipo di funzioni "Con Eccezioni". Tali funzioni accettano un altro parametro di input: un elenco di eccezioni. Si tratta di parole o frasi che non devono essere formattate, anche se contengono la parola allergene. Ad esempio, se si definisce la parola "latte" come allergene, essa sarà evidenziata nell'ingrediente "lattedi noce di cocco", il che è corretto. Il "latte di noce di cocco" può essere definito come un'eccezione e Desktop Designer non evidenzia la parola "latte" quando essa è utilizzata nella combinazione "latte di noce di cocco".

Nota

Per esempi e ulteriore documentazione pratica, vedere la pagina Web NiceLabel: EU Food Allergen Labeling Regulation (Regolamento UE sull'etichettatura degli allergeni alimentari).

Prerequisiti

Le funzioni Allergeni alimentari contengono un collegamento all'origine dati fornita e leggono gli allergeni inclusi. Per aprire l'origine dati, i driver di database appropriati (driver ODBC) devono essere installati nel computer.

  • Per le origini dati Excel e Access. Se nello stesso computer è installato Microsoft Office, si dispone già dei driver di database. In caso contrario, installare i driver separatamente. Visitare l'Area download Microsoft per scaricare e installare Microsoft Access Database Engine 2010 Redistributable o Microsoft Access 2013 Runtime.

  • Per le origini dati MS SQL. Il driver ODBC è stato rilasciato all'interno di Microsoft SQL Server Feature Pack. È necessario aver installato il supporto per il provider SQLSQLNCLI11. Visitare l'Area download Microsoft e scaricare il driver.

Applicazione della formattazione agli allergeni

Per formattare gli allergeni nell'elenco di ingredienti è necessario eseguire la funzione di formattazione e specificare i parametri di input. Le funzioni di formattazione vengono eseguite come funzione VBScript e forniscono i risultati nella variabile di output, la quale può essere utilizzata direttamente nell'oggetto Casella di testo arricchito. La funzione da utilizzare deve corrispondere alla posizione dei dati, dove sono conservati gli elenchi di allergeni, come la stringa CSV, il foglio di calcolo Microsoft Excel o il database Microsoft Access.

Per formattare gli allergeni da un elenco di Excel, procedere come segue:

  1. Creare una nuova etichetta in Desktop Designer e aprire Gestione dati dinamici.

  2. Fare clic su Funzioni, selezionare VBScript e digitare la funzione Nome.

  3. Aprire Editor di script.

  4. Modificare la riga Result = "0" in Result = e posizionare il cursore dopo il segno uguale.

  5. In Elementi di script disponibili espandere Allergeni alimentari e selezionare FormatAllergensFromExcel

  6. Nella categoria Campo di modifica di script, definire i parametri delle funzioni, ad esempio:

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

    Verranno letti l'elenco di ingredienti forniti nella variabile Products.Ingred, l'elenco di allergeni dal file Microsoft Excel DB.xls nella colonna Prodotto del foglio Prodotti e verrà applicata la formattazione grassetto a tutti gli allergeni all'interno.

  7. Fare clic su OK.

  8. In Nome variabile output, definire il nome della variabile, nella quale saranno salvati gli allergeni formattati.

    Nota

    Assicurarsi che la variabile inizi con il prefisso RTF_, come ad esempio RTF_FormattedIngredients. In tal modo, l'oggetto Testo arricchito rispetterà i codici di controllo specificati nella variabile.

  9. Fare clic su OK.

  10. Selezionare l'oggetto Casella di testo arricchito e aggiungerlo alla superficie del progetto.

  11. In Editor testo arricchito, selezionare la variabile nell'elenco e aggiungerla al contenuto.

    Se necessario, è possibile aggiungere altre variabili o testo fisso.

  12. Per formattare il tipo, le dimensioni e i colori dei caratteri è possibile usare i controlli disponibili nell'Editor testo arricchito.

  13. Fare clic su OK.

Sintassi delle funzioni di formattazione degli allergeni

Elenco di allergeni fornito dall'utente

Questa funzione accetta l'elenco di ingredienti e di allergeni in due variabili e crea il codice RTF con gli allergeni evidenziati. Tutte le parole contenute in Allergeni che hanno un corrispondente in Ingredienti saranno formattate dalla specifica Evidenzia.

Sintassi:

FormatAllergens(Ingredients,Allergens,Highlight)

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

Allergeni

L'elenco CSV degli allergeni.

Evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

Esempio 139. Esempio

FormatAllergens("wheat flour,salt,veg fat,hazelnuts","wheat,hazelnuts","bold,italic")

FormatAllergens(Ingredients,"wheat,hazelnuts","bold,italic")


Allergeni dal foglio di calcolo Microsoft Excel

Questa funzione accetta l'elenco di ingredienti e la posizione del foglio di calcolo Microsoft Excel. La funzione legge gli allergeni dal foglio di calcolo e crea il codice RTF con allergeni evidenziati. Tutte le parole del foglio di calcolo che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia.

Sintassi:

FormatAllergensFromExcel(Ingredients,ExcelFile,Spreadsheet,Column,Highlight)

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

File Excel

Il percorso completo e il nome del file Microsoft Excel contenente gli allergeni.

Foglio di calcolo

Il nome del foglio di calcolo contenente l'elenco di allergeni.

Campo

Il nome del campo (nome colonna) contenente gli allergeni.

È anche possibile specificare il numero di indice della colonna contenente l'elenco di allergeni. La colonna A deve essere specificata come "1", la colonna B come "2", ecc.

Evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

Allergeni del database Microsoft Access

Questa funzione accetta l'elenco di ingredienti e la posizione del database Microsoft Access. La funzione legge gli allergeni dalla tabella e crea il codice RTF con allergeni evidenziati. Tutte le parole della tabella di database che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia.

Sintassi:

FormatAllergensFromAccess(ingredients,AccessDb,table,field,highlight)

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

AccessDb

Il percorso completo e il nome del file di database Microsoft Access contenente gli allergeni.

tabella

Il nome della tabella contenente l'elenco di allergeni.

campo

Il nome del campo (nome colonna) contenente gli allergeni.

È anche possibile specificare il numero di indice della colonna contenente l'elenco di allergeni. Field1 deve essere specificato come "1", Field2 come "2", ecc.

evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

Allergeni del database Microsoft SQL

Questa funzione accetta l'elenco di ingredienti e la posizione del database Microsoft SQL Server. La funzione legge gli allergeni dalla tabella e crea il codice RTF con allergeni evidenziati. Tutte le parole della tabella di database che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia.

Sintassi:

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

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

sqlserver

Il percorso completo e il nome del file di database Microsoft SQL Server contenente gli allergeni.

dbusername

Nome utente per accedere al database.

dbpassword

Password per accedere al database.

dbname

Il nome del database contenente l'elenco di allergeni.

tabella

Il nome della tabella contenente l'elenco di allergeni.

campo

Il nome del campo (nome colonna) contenente gli allergeni.

evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

Allergeni da SQL Server

Questa funzione accetta l'elenco di ingredienti e la posizione del database SQL Server. La funzione legge gli allergeni dalla tabella e crea il codice RTF con allergeni evidenziati. Tutte le parole della tabella di database che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia.

Sintassi:

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

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

connectionstring

Stringa di connessione utilizzata per connettersi al database SQL Server.

tabella

Il nome della tabella contenente l'elenco di allergeni.

campo

Il nome del campo (nome colonna) contenente gli allergeni.

evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

Allergeni dai tag

Questa funzione legge i formati racchiusi tra i tag personalizzati per evidenziare gli allergeni tra gli ingredienti. La funzione legge gli allergeni dalla tabella e crea il codice RTF con allergeni evidenziati. Tutte le parole che includono tag corrispondenti in Ingredienti sono formattate dalla specifica Evidenzia.

Sintassi:

FormatAllergensFromTags(ingredients,tag,highlight)

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

tag

Tag usato per identificare l'ingrediente come allergene.

evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

Sintassi delle funzioni di formattazione degli allergeni con supporto delle esclusioni

Elenco di allergeni fornito dall'utente

Questa funzione accetta l'elenco di ingredienti e di allergeni in due variabili e crea il codice RTF con gli allergeni evidenziati. Tutte le parole da Allergeni che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia. L'ultimo parametro fornisce l'elenco CSV delle frasi che non devono essere evidenziate, anche se contengono la parola "allergene".

Sintassi:

FormatAllergensWithExclusions(Ingredients,Allergens,Highlight,Exclusions)

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

Allergeni

L'elenco CSV degli allergeni.

Evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

Esclusioni

L'elenco CSV di parole e frasi che non saranno evidenziate anche se contengono la parola "allergene".

Il latte è un allergene, quindi la parola "latte" deve essere evidenziata, ma non quando è utilizzata nel contesto "latte di noce di cocco". In questo caso "latte di noce di cocco" deve essere definito come eccezione.

Esempio 140. Esempio

FormatAllergensWithExclusions("wheat flour,salt,veg fat,hazelnuts, coconut

milk","wheat,hazelnuts,milk","bold,italic","coconut milk")


Allergeni dal foglio di calcolo Microsoft Excel

Questa funzione accetta l'elenco di ingredienti e la posizione del foglio di calcolo Microsoft Excel. La funzione legge gli allergeni dal foglio di calcolo e crea il codice RTF con allergeni evidenziati. Tutte le parole del foglio di calcolo che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia. L'ultimo parametro fornisce l'elenco CSV delle frasi che non devono essere evidenziate, anche se contengono la parola "allergene".

Sintassi:

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

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

File Excel

Il percorso completo e il nome del file Microsoft Excel contenente gli allergeni.

Foglio di calcolo

Il nome del foglio di calcolo contenente l'elenco di allergeni.

Campo

Il nome del campo (nome colonna) contenente gli allergeni.

È anche possibile specificare il numero di indice della colonna contenente l'elenco di allergeni. La colonna A deve essere specificata come "1", la colonna B come "2", ecc.

Evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

SpreadsheetEx

Il nome del foglio di calcolo contenente l'elenco di parole e frasi da escludere dalla formattazione degli allergeni.

FieldEx

Il nome del campo (nome colonna) contenente le stringhe da escludere dalla formattazione.

È anche possibile specificare il numero di indice della colonna contenente l'elenco di allergeni. La colonna A deve essere specificata come "1", la colonna B come "2", ecc.

Esempio 141. Esempio

FormatAllergensFromExcelWithExclusions("wheat flour,salt,veg fat,hazelnuts","c:\files\data.xlsx","Sheet1","1","bold,italic","Sheet2","2")

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


Allergeni del database Microsoft Access

Questa funzione accetta l'elenco di ingredienti e la posizione del database Microsoft Access. La funzione legge gli allergeni dalla tabella e crea il codice RTF con allergeni evidenziati. Tutte le parole del foglio di calcolo che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia. L'ultimo parametro fornisce l'elenco delle stringhe che non devono essere evidenziate, anche se contengono la parola "allergene".

Sintassi:

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

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

accessdb

Il percorso completo e il nome del file di database Microsoft Access contenente gli allergeni.

table_with_allergens

Il nome della tabella contenente l'elenco di allergeni.

field_with_allergens

Il nome del campo (nome colonna) contenente gli allergeni.

table_with_exclusions

Il nome della tabella contenente l'elenco di parole e frasi da escludere dalla formattazione degli allergeni.

field_with_exclusions

Il nome del campo (nome colonna) contenente le stringhe da escludere dalla formattazione.

Allergeni del database Microsoft SQL

Questa funzione accetta l'elenco di ingredienti e la posizione del database Microsoft SQL Server. La funzione legge gli allergeni dalla tabella e crea il codice RTF con allergeni evidenziati. Tutte le parole della tabella di database che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia. L'ultimo parametro fornisce l'elenco delle stringhe che non devono essere evidenziate, anche se contengono la parola "allergene".

Sintassi:

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

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

sqlserver

Il percorso completo e il nome del file di database Microsoft SQL Server contenente gli allergeni.

dbusername

Nome utente per accedere al database.

dbpassword

Password per accedere al database.

dbname

Il nome del database contenente l'elenco di allergeni.

table_with_allergens

Il nome della tabella contenente l'elenco di allergeni.

field_with_allergens

Il nome del campo (nome colonna) contenente gli allergeni.

evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

table_with_exclusions

Il nome della tabella contenente l'elenco di parole e frasi da escludere dalla formattazione degli allergeni.

field_with_exclusions

Il nome del campo (nome colonna) contenente le stringhe da escludere dalla formattazione.

Allergeni da SQL Server

Questa funzione accetta l'elenco di ingredienti e la posizione del database SQL Server. La funzione legge gli allergeni dalla tabella e crea il codice RTF con allergeni evidenziati. Tutte le parole della tabella di database che hanno un corrispondente in Ingredienti sono formattate dalla specifica Evidenzia. L'ultimo parametro fornisce l'elenco delle stringhe che non devono essere evidenziate, anche se contengono la parola "allergene".

Sintassi:

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

Parametro

Descrizione

Ingredienti

L'elenco CSV degli ingredienti.

connectionstring

Stringa di connessione utilizzata per connettersi al database SQL Server.

table_with_allergens

Il nome della tabella contenente l'elenco di allergeni.

field_with_allergens

Il nome del campo (nome colonna) contenente gli allergeni.

evidenzia

L'elenco CSV dei parametri di formattazione da applicare all'allergene. È possibile usare "bold" (grassetto), "italic" (corsivo), "underline" (sottolineato), "caps" (maiuscolo), colore del testo e/o colore di sfondo. I colori sono formattati in sintassi esadecimale per lo schema RGB, ad esempio "#FF0000" per il colore rosso. Per il colore del testo, è sufficiente specificare il codice del colore, per lo sfondo è necessario aggiungere il prefisso "bg:" al codice del colore, come "bg:#FF0000".

Questo è un parametro opzionale. Se viene fornito come valore vuoto, (""), viene utilizzato il formato bold (grassetto).

field_with_exclusions

Il nome del campo (nome colonna) contenente le stringhe da escludere dalla formattazione.