NiceLabel Automation utilise des filtres pour définir la structure des données reçues par les déclencheurs. Chaque fois qu'un déclencheur reçoit des données, un ou plusieurs filtres analysent les données reçues. Ce processus extrait les valeurs pertinentes pour votre configuration. Chaque filtre inclut des règles pour identifier les champs dans les données reçues.
Note
Le résultat fourni par le filtre est une liste de champs et leurs valeurs (paires nom-valeur
).
Types de filtres
Pour plus d'informations, consulter les sections Filtre de texte structuré, Filtre de données non structurées, Filtre XML, et Filtre JSON.
Structure de données
La complexité du filtre dépend de la structure des données. Les fichiers aux données structurées, tels que CSV ou XML, facilitent l'extraction. Dans ce cas, les noms des champs sont déjà définis par les données. L'extraction des paires nom-valeur
est rapide. Quand les données n'ont pas de structure claire, la définition des règles d'extraction prend plus de temps. Vous pouvez tomber sur ce type de données en exportant des documents et des rapports d'anciens systèmes, de communication interceptée entre deux périphériques, et d'une capture d'un flux d'impression.
Le filtre définit une liste de champs qui sont extraits des données entrantes dès l'exécution du filtre.
NiceLabel Automation supporte différents types de données d'entrée qui peuvent tous être analysés par l'une des méthodes de filtrage. Assurez-vous de choisir le filtre qui correspond au type de données entrantes. Par exemple, le Filtre de texte structuré pour des données CSV entrantes, le Filtre JSON pour des données JSON entrantes, et le Filtre XML pour des données XML entrantes. Pour toutes données non structurées, utiliser le Filtre de données non structurées. Pour plus d'informations, voir l'article Comprendre les structures de données.
Extraction de données
Le filtre est un ensemble de règles qui n'effectue aucune extraction par lui-même. Pour exécuter le filtre, lancer l'action Utiliser le Filtre de Données. Cette action exécute les règles du filtre sur les valeurs et extrait les informations.
Chaque type de déclencheur peut exécuter autant d'actions Utiliser le Filtre de Données que nécessaires. Si vous recevez des données d'entrée composées qui ne peuvent pas être analysées par un seul filtre, définir et exécuter les règles de plusieurs filtres dans une séquence d'actions Utiliser le Filtre de Données. À la fin, utiliser les valeurs extraites par toutes les actions pour une même étiquette.
Associer les champs aux variables
Pour utiliser les valeurs extraites, il faut les enregistrer dans des variables. L'action Utiliser le Filtre de Données extrait les valeurs et les enregistre dans les variables. Pour configurer ce processus, mapper chaque variable au champ respectif. La valeur du champ est ensuite enregistrée dans la variable mappée.
Astuce
Il est conseillé de définir les champs et variables dont les noms correspondent. Dans ce cas, le mappage automatique associe les variables aux champs de mêmes noms, éliminant le besoin de mappage manuel.
Le mappage automatique est disponible pour tous les types de filtres. Quand le mappage automatique est activé, l'action Utiliser le Filtre de Données extrait automatiquement les valeurs et les associe aux variables ayant le même nom que les champs. Pour plus d'informations, consulter les sections Activer la structure dynamique pour Filtre de texte structuré, Définir la zone d'affectation pour Filtre de données non structurées et Définir la zone d'affectation pour les filtres XML ou JSON.
Exécuter des actions avec l'extraction de données
Généralement, il faut exécuter des actions avec les données extraites, telles qu'Ouvrir l'étiquette, Imprimer l'étiquette ou une des actions de connectivité de sortie. Il est extrêmement important d'indenter ces actions dans l'action Utiliser le Filtre de Données. Ainsi, les actions indentées sont exécutées pour chaque extraction de données.
Exemple 1. Exemple
Avec un fichier CSV de 5 lignes, l'action indentée est aussi exécutée 5 fois, une fois pour chaque extraction de données. Si les actions ne sont pas indentées, elles ne s'effectuent qu'une seule fois et contiennent les données de la dernière extraction de données. Comme pour l'exemple ci-dessus, la 5e ligne du CSV serait imprimée avec les quatre premières lignes non imprimées. Avec des sous-zones, il faut indenter votre action dans le bon espace réservé.