AttributeSplitter

Découpe les valeurs d'un attribut en sa basant sur un délimiteur ou une largeur déterminée puis crée un attribut de liste contenant un élément de liste pour chaque partie.

Aller à la configuration

Cas d'utilisation courants

Convertir une liste délimitée de valeurs en un attribut de liste FME
Extraire une partie de la valeur d'un attribut basée sur un texte aligné en colonnes avec une structure connue

Comment fonctionne-t-il ?

Une fois connecté à un flux d'entités d'entrée, AttributeSplitter vous permet de sélectionner un attribut à découper. La valeur de cet attribut est divisée en parties en fonction des sélections de paramètres, et les résultats sont ajoutés à un nouvel attribut de liste.

Fournir une chaîne de caractères à utiliser pour le fractionnement, dans le format de votre choix :

Dans le cas d'une liste délimitée, le nombre de parties de la valeur peut être variable. Un caractère qualificatif de champ peut également être spécifié dans les cas où le délimiteur apparaît dans la chaîne comme une valeur non délimitante (comme les virgules dans les adresses dans les chaînes séparées par des virgules).

Pour les découpages à largeur fixe, les parties seront extraites selon la chaîne de formatage indiquée.

Les espaces peuvent être supprimés des valeurs résultats, et les éléments vides - parties sans valeur résultat - peuvent être supprimés ou conservés.

Les nouveaux attributs de liste peuvent être utilisés avec d'autres Transformers basés sur des listes. Vous pouvez également exposer des éléments de liste spécifiques pour qu'ils soient utilisés comme attributs individuels (voir l'exemple ci-dessous).

Exemples

Exemple : découpage délimité d'adresses en attributs (exposition d'éléments individuels de listes)

Dans cet exemple, nous avons un fichier de forme contenant des points d'intérêt, avec des adresses postales incluses comme un seul attribut. Les parties des adresses sont séparées par des virgules.

Contrairement au premier exemple (avec un nombre variable de types d'arbres), nous savons de combien de parties ces attributs se composent.

Dans la boîte de dialogue des paramètres, le délimiteur est défini comme une virgule (,), nous allons couper les espaces blancs et créer un nouvel attribut de liste appelé Adresse. Notez que l'option Supprimer les éléments vides est réglée sur Non - si une partie de l'adresse est manquante, la suppression de cette partie entraînerait l'insertion des autres parties dans le mauvais élément de liste.

Une fois l'AttributeSplitter configuré, la liste Address{} est maintenant disponible dans la sortie du Transformer. Un clic droit (menu contextuel) sur le nom de la liste, et nous pouvons exposer les éléments de la liste.

Les éléments de liste sont numérotés en commençant par zéro (0). Dans la boîte de dialogue Sélection Eléments de liste, la saisie de la plage 0-3 permet d'afficher les quatre éléments de liste qui composent l'adresse.

Avec ces éléments de liste accessibles et exposés, un AttributeManager est utilisé pour les renommer selon leur contenu.

Les entités en sortie ont maintenant des attributs individuels de composants d'adresses.

Notes

Les listes sont indiquées dans FME Workbench par leur nom suivi d'une paire d'accolades : maListe{}.
Un élément de liste spécifique contient son numéro entre les accolades - maListe{0}
Pour accéder à des éléments d'une liste dans FME Workbench, faites un clic droit sur le nom de la liste dans l'attribut de liste et choisissez Exposer les éléments.
Pour plus d'informations sur comment travailler avec des listes, consultez List Attributes.
Pour découper les attributs en utilisant une expression régulière, considérez plutôt l'utilisation de StringSearcher.

Configuration

Ports d'entrée

Ports de sortie

Paramètres

Général

Attribut à découper	Une fois le Transformer connecté à un flux d'entités en entrée, choisissez un attribut dans le menu déroulant.
Délimiteur ou chaîne de formatage :	Fournir une chaîne de caractères à utiliser pour le fractionnement, dans le format de votre choix : Si Délimiteur : saisissez le caractère ou la chaîne de caractères utilisé comme délimiteur. Les caractères spéciaux peuvent être saisis à l'aide de l'éditeur de texte à partir du menu déroulant. Si vous utilisez une chaîne de formatage (largeur fixe) : fournissez une chaîne au format #s#s#s, où chaque nombre est la longueur de la sous-chaîne que vous souhaitez extraire. Un nombre quelconque de composants #s est autorisé. Des chaînes vides sont produites si la chaîne à diviser est trop courte pour compléter la chaîne de format. Exemple : La chaîne de caractères en entrée 123456 avec la chaîne de formatage 2s1s3s1s produira cette liste : `_list{0}' a la valeur `12' `_list{1}' a la valeur `3' `_list{2}' a la valeur `456' `_list{3}’ a la valeur `’
Qualificateur de texte	Lors de l'utilisation d'un délimiteur, si une valeur est fournie ici, les délimiteurs entre les paires du caractère qualificateur de texte spécifié seront traités comme des chaînes de caractères ordinaires et non comme des caractères de délimitation (également connus sous le nom d'échappement). Prenons par exemple cet enregistrement délimité par des virgules : FA035,2009,City Hall Lawn Garden,"453 W 12th Av, Vancouver BC",Yes Si le caractère qualificateur de texte est défini sur ", l'adresse sera extraite sous la forme d'une chaîne intacte comprenant une virgule : "453 W 12th Av, Vancouver BC" Sans cela, l'adresse sera fragmentée à la virgule Notez que le caractère qualificateur de texte n'est pas supprimé de la chaîne.
Supprimer les espaces	Par défaut, les chaînes résultantes ont en tête et en fin (gauche et droite) des espaces qui ont été supprimés mais vous pouvez modifier ces paramètres à droite, à gauche ou aucun.
Liste	Entrez un nom pour le nouvel attribut de liste.
Supprimer les éléments vides	Détermine si l'on doit conserver les pièces vides résultant du fractionnement. Par défaut, toutes les parties seront retournées, qu'elles soient vides ou non. Si ce paramètre vaut Oui, seules les parties non vides sont retournées. Si ce paramètre vaut Non, le découpage de a,b,,,c,d,e avec les virgules retournera la liste suivantes : `_list{0}' a la valeur `a' `_list{1}' a la valeur `b' `_list{2}' a la valeur`' `_list{3}' a la valeur`' `_list{4}' a la valeur `c' `_list{5}' a la valeur `d' `_list{6}' a la valeur `e' Si ce paramètre vaut Oui, le découpage de a,b,,,c,d,e avec les virgules retournera la liste suivante : `_list{0}' a la valeur `a' `_list{1}' a la valeur `b' `_list{2}' a la valeur `c' `_list{3}' a la valeur `d' `_list{4}' a la valeur `e'

Éditer les paramètres des Transformers

Les paramètres du Transformer peuvent être définis en saisissant directement des valeurs, en utilisant des expressions ou en faisant référence à d'autres éléments de l'espace de travail tels que des valeurs d'attributs ou des paramètres utilisateur. Divers éditeurs et menus contextuels sont disponibles pour vous aider. Pour voir ce qui est disponible, cliquez sur à côté du paramètre concerné.

Définir des valeurs de paramètres

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple consiste à saisir simplement une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types telles que des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres traitement.

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Types de contenu

Fonctions chaînes de caractères	Ces fonctions manipulent les chaînes de caractères.
Caractères spéciaux	Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.
Fonctions mathématiques	Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure	Les fonctions de dates et heures sont disponibles dans l'Editeur texte.
Opérateurs mathématiques	Ces opérateur sont disponibles dans l'éditeur arithmétique.
Fonctions d'entités	Elles retournent des valeurs spécifiques aux entités.
Paramètres FME	Les paramètres FME et spécifiques au traitement peuvent être utilisés.
Créer et modifier un paramètre publié	Créer ses propres paramètres éditables.

Options - Tables

Outils de tableau

Les Transformers avec des paramètres de style table possèdent des outils additionnels pour remplir et manipuler des valeurs.

Réordonner

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Ajouter une ligne
Supprimer une ligne
Déplacer la ligne en cours au dessus
Déplacer la ligne en cours en dessous
Déplacer la ligne en cours en haut de liste
Déplacer la ligne en cours en bas de liste

Couper, Copier et Coller

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Couper une ligne - supprime et copie dans le presse-papiers.
Copie une ligne dans le presse-papiers.
Colle une ligne depuis le presse-papiers.

Copier, copier et coller peuvent être utilisés au sein d'un Transformer ou entre Transfromers.

Filtre

Commencez à taper une chaîne de caractères, et la matrice n'affichera que les lignes correspondant à ces caractères. Recherche dans toutes les colonnes. Cela n'affecte que l'affichage des attributs dans le Transformer - cela ne change pas les attributs qui sont sortis.

Importer

Le bouton d'import remplit la table avec un jeu de nouveaux attributs lus depuis un jeu de données. L'application spécifique varie selon les Transformers.

Réinitialiser/Rafraîchir

Réinitialise la table à son état initial, et peut fournir des options additionnelles pour supprimer des entrées invalides. Le comportement varie d'un Transformer à l'autre.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.

Pour plus d'information, consulter la section Options des Transformers.

Références

Comportement	Basé sur des entités
Stockage des entités	Non
Dépendances	Aucun
Alias
Historique

FME Community

FME Community dispose d'une mine de connaissances sur FME, avec plus de 20 000 membres actifs dans le monde entier. Obtenez de l'aide sur FME, partagez vos connaissances et entrez en contact avec des utilisateurs du monde entier.

Voir tous les résultats à propos de ce Transformer sur FME Community.

Examples may contain information licensed under the Open Government Licence – Vancouver, Open Government Licence - British Columbia, and/or Open Government Licence – Canada.