Filtre de texte structuré

Pour en savoir plus sur les filtres en général, consulter l'article Comprendre les filtres.

Utiliser ce filtre pour chaque réception d'un fichier texte structuré. Ce sont des fichiers texte dans lesquels les champs sont identifiés par l'une des méthodes suivantes :

Les champs sont délimités par un caractère : Les caractères de délimitation habituels sont la virgule ou le point-virgule. Le fichier CSV (valeurs séparées par une virgule) est un exemple typique.
Les champs contiennent un nombre fixe de caractères : Autrement dit, les champs sont définis par des colonnes de largeur fixe.

Pour des exemples de données de texte structuré, voir l'article Base de données texte.

Définition de la structure

Voici les options suivantes permettant de définir la structure du fichier de texte :

Importer la structure en utilisant l'Assistant de fichier texte : Dans ce cas, cliquer sur le bouton Importer la structure des données dans le ruban et suivre les instructions à l'écran. Quand l'Assistant est terminé, le type de base de données texte et tous les champs sont définis. Si la première ligne de données contient les noms de champs, l'Assistant peut les importer. Il s'agit de la méthode recommandée si le déclencheur reçoit toujours les données dont la structure reste inchangée.
Définir les champs manuellement : Dans ce cas, il faut définir le type de données manuellement (champs délimités ou de largeur fixe) et ensuite définir les noms de ces champs. Pour plus d'informations, voir la section Définition des champs.
Lire les champs dynamiquement : Dans ce cas, le déclencheur peut recevoir des données structurées différemment. Par exemple, les nouveaux champs – La structure dynamique élimine le besoin de mettre à jour le filtre à chaque changement de structure. La prise en charge de la structure dynamique lit automatiquement tous les champs de données, même si de nouveaux champs existent ou si certains des anciens champs sont manquants. Elle les mappe automatiquement aux variables utilisant les mêmes noms. Pour plus d'informations, consulter l'article Activer la structure dynamique.

La section Aperçu de données simplifie la configuration. Dans le panneau de l'aperçu, le résultat d'un filtre défini est mis en évidence dans la zone d'aperçu à chaque changement de configuration. L'aperçu des données vous permet de vérifier quelles données sont extraites avec chaque règle.

Définition des champs

Pour les fichiers de texte structuré, la définition des champs est très simple. Il y a deux options :

Un séparateur définit les champs : Dans ce cas, il y a un caractère de délimitation, tel que virgule ou point-virgule entre les champs. Il suffit de définir les noms de champs dans le même ordre d'apparition dans les données reçues par un déclencheur.
Champs de largeur fixe : Dans ce cas, définir les noms de champs dans le même ordre d'apparition dans les données reçues par un déclencheur, et définir le nombre de caractères que le champ va occuper. Cette quantité de caractères sera lue dans les données destinées à ce champ.

Aperçu des données

Cette section fournit un aperçu de la définition du champ. Si l'élément défini est sélectionné, l'aperçu surligne son emplacement dans les données prévisualisées.

Aperçu du nom de fichier : Spécifie le fichier qui contient l'échantillon de données qui sera analysé dans le filtre. Le fichier d'aperçu est copié de la définition du filtre. Si le nom du fichier d'aperçu est changé, le nouveau nom de fichier sera enregistré.
Ouvrir : Sélectionne un autre fichier sur lequel les règles du filtre vont s'appliquer.
Actualiser : Relance le filtre sur le contenu du fichier d'aperçu. Automation Met à jour la section Aperçu des données avec le résultat.

Options de formatage

Cette section définit les fonctions de manipulation de chaînes de caractères qui seront appliquées aux variables ou champs sélectionnés. Sélectionner une ou plusieurs fonctions. Ces fonctions s'appliquent dans l'ordre sélectionné dans l'interface utilisateur, de haut en bas.

Supprimer les espaces au début : Enlève tous les caractères d'espacement (code décimal ASCII 32) du début de la chaîne de caractères.
Supprimer les espaces à la fin : Enlève tous les caractères d'espacement (code décimal ASCII 32) à la fin de la chaîne de caractères.
Effacer le caractère d'ouverture et de fermeture : Efface la première occurrence du caractère d'ouverture et de fermeture trouvé dans la chaîne de caractères.

Exemple 2. Exemple

Si vous utilisez "{" comme caractère d'ouverture et "}" comme caractère de fermeture, la chaîne d'entrée {{selection}} est convertie en {selection}.
Rechercher et remplacer : Exécute une recherche classique et remplace la fonction selon la valeur fournie pour rechercher et remplacer par. Vous pouvez aussi utiliser des expressions classiques.

Note

Il y a plusieurs implémentations des expressions classiques utilisées. utilise la syntaxe .NET Framework pour les expressions classiques. Pour plus d'informations, consulter la Base de Connaissances article.
Remplacer les caractères non imprimables avec des espaces : Remplace tous les caractères de contrôle de la chaîne par un espace (code décimal ASCII 32). Les caractères non imprimables sont des caractères ayant une valeur ASCII décimale comprise entre 0-31 et 127-159.
Supprimer les caractères non imprimables : Enlève tous les caractères de contrôle de la chaîne. Les caractères non imprimables sont des caractères ayant une valeur ASCII décimale comprise entre 0-31 et 127-159.
Décoder les caractères spéciaux : Décode les caractères (ou codes de contrôle) qui sont indisponibles sur le clavier, comme le retour chariot ou le passage à la ligne. utilise une notation pour encoder de tels caractères sous forme lisible, tels que <CR> pour Retour Chariot et <LF> pour Passage à la Ligne. Pour plus d'informations, consulter la section Introduire des caractères spéciaux (Codes de Contrôle).

Cette option convertit les caractères spéciaux de la syntaxe en caractères binaires réels.

Exemple 3. Exemple

Quand vous recevez la séquence de données "<CR><LF>", les utilise comme une chaîne complète de 8 caractères. Activer cette nouvelle option pour interpréter et utiliser les données comme deux caractères binaires CR (Retour Chariot - code ASCII 13) et LF (Passage à la Ligne - code ASCII 10).
Rechercher et supprimer tout avant : Trouve la chaîne de caractères fournie et efface tous les caractères du début des données jusqu'à la chaîne de caractères. La chaîne de caractères trouvée peut aussi être effacée.
Rechercher et supprimer tout après : Trouve la chaîne de caractères fournie et efface tous les caractères depuis la chaîne de caractères jusqu'à la fin des données. La chaîne de caractères trouvée peut aussi être effacée.
Changement de casse : Modifie tous les caractères dans vos chaînes en lettres capitales ou minuscules.

Activer la structure dynamique

Le filtre de texte structuré peut identifier automatiquement les champs et leurs valeurs dans les données reçues. Ainsi, le mappage manuel de variable au champ n'est pas requis.

La fonction de Structure dynamique est utile si le déclencheur reçoit les données avec une structure changeante. Dans ce cas, la structure des données principale reste inchangée (par ex. : les champs sont délimités par une virgule) ou conserve la même structure, mais l'ordre et/ou le nombre de champs change. Il peut y avoir de nouveaux champs, ou certains des vieux champs ne sont plus disponibles. Avec la Structure dynamique activée, le filtre identifie automatiquement la structure du fichier reçu. Simultanément, le filtre lit les noms et les valeurs de champs (paires nom-valeur) à partir des données. Cela élimine le besoin de mappage manuel des champs vers les variables.

L'action Utiliser un filtre de données ne propose pas de possibilités de mappage, car elle effectue le mappage de manière dynamique. Il n'y a même pas besoin de définir les variables d'étiquettes dans la configuration du déclencheur. L'action assigne les valeurs de champs aux variables d'étiquettes de même nom sans avoir besoin des variables importées de l'étiquette. Toutefois, la règle s'applique seulement à l'action Imprimer l'étiquette. Pour utiliser les valeurs de champs dans une autre action, il faut définir les variables dans le déclencheur, tout en conservant le mappage automatique variable-à-champ.

Note

Aucune erreur n'est signalée si le champ disponible dans les données d'entrée n'a pas de variable d'étiquette correspondant. Ignore en silence les variables manquantes.

Configuration de la structure dynamique

Pour configurer la structure dynamique, activer l'option Structure dynamique dans les propriétés du Filtre de texte structuré.

La première ligne de données doit contenir les noms de champs.
La ligne sélectionnée pour Commencer l'importation à la ligne doit être la ligne contenant les noms de champs (généralement la première ligne dans les données).
La structure de données doit être délimitée.
Vous pouvez formater les données si nécessaire.

Options de formatage

Supprimer les espaces au début : Enlève tous les caractères d'espacement (code décimal ASCII 32) du début de la chaîne de caractères.
Supprimer les espaces à la fin : Enlève tous les caractères d'espacement (code décimal ASCII 32) à la fin de la chaîne de caractères.
Effacer le caractère d'ouverture et de fermeture : Efface la première occurrence du caractère d'ouverture et de fermeture trouvé dans la chaîne de caractères.

Exemple 4. Exemple

Si vous utilisez "{" comme caractère d'ouverture et "}" comme caractère de fermeture, la chaîne d'entrée {{selection}} est convertie en {selection}.
Rechercher et remplacer : Exécute une recherche classique et remplace la fonction selon la valeur fournie pour rechercher et remplacer par. Vous pouvez aussi utiliser des expressions classiques.

Note

Il y a plusieurs implémentations des expressions classiques utilisées. utilise la syntaxe .NET Framework pour les expressions classiques. Pour plus d'informations, consulter la Base de Connaissances article.
Remplacer les caractères non imprimables avec des espaces : Remplace tous les caractères de contrôle de la chaîne par un espace (code décimal ASCII 32). Les caractères non imprimables sont des caractères ayant une valeur ASCII décimale comprise entre 0-31 et 127-159.
Supprimer les caractères non imprimables : Enlève tous les caractères de contrôle de la chaîne. Les caractères non imprimables sont des caractères ayant une valeur ASCII décimale comprise entre 0-31 et 127-159.
Décoder les caractères spéciaux : Décode les caractères (ou codes de contrôle) qui sont indisponibles sur le clavier, comme le retour chariot ou le passage à la ligne. utilise une notation pour encoder de tels caractères sous forme lisible, tels que <CR> pour Retour Chariot et <LF> pour Passage à la Ligne. Pour plus d'informations, consulter la section Introduire des caractères spéciaux (Codes de Contrôle).

Cette option convertit les caractères spéciaux de la syntaxe en caractères binaires réels.

Exemple 5. Exemple

Quand vous recevez la séquence de données "<CR><LF>", les utilise comme une chaîne complète de 8 caractères. Activer cette nouvelle option pour interpréter et utiliser les données comme deux caractères binaires CR (Retour Chariot - code ASCII 13) et LF (Passage à la Ligne - code ASCII 10).
Rechercher et supprimer tout avant : Trouve la chaîne de caractères fournie et efface tous les caractères du début des données jusqu'à la chaîne de caractères. La chaîne de caractères trouvée peut aussi être effacée.
Rechercher et supprimer tout après : Trouve la chaîne de caractères fournie et efface tous les caractères depuis la chaîne de caractères jusqu'à la fin des données. La chaîne de caractères trouvée peut aussi être effacée.
Changement de casse : Modifie tous les caractères dans vos chaînes en lettres capitales ou minuscules.