AttributeValueMapper

Compare les valeurs des attributs à une table de correspondance et attribue de nouvelles valeurs lorsque des correspondances sont trouvées. Les valeurs mappées peuvent être stockées dans un nouvel attribut, ou écraser un attribut existant, y compris la source originale .

Aller à la configuration

Cas d'utilisation courants

Ajouter ou altérer des valeurs d'attribut selon une table de correspondance définie par l'utilisateur
Nettoyer des valeurs d'attribut
Créer des valeurs alternatives, codées, pour les attributs

Comment fonctionne-t-il ?

AttributeValueMapper est piloté par une table de consultation définie par l'utilisateur - la Table de correspondance. Un attribut d'entrée est sélectionné, et ses valeurs seront comparées à la table de consultation pour mettre en correspondance les nouvelles valeurs. Les nouvelles valeurs peuvent être stockées dans un nouvel attribut (comportement par défaut) ou écraser un attribut existant (y compris l'attribut d'entrée).

La correspondance des valeurs peut être créée manuellement ou en important tout jeu de données pris en charge par FME. L'importation est particulièrement utile pour utiliser une carte prédéfinie qui contient déjà les valeurs en entrée et en sortie (comme une feuille de calcul), et pour analyser un jeu de données afin de trouver toutes les valeurs existantes pour un attribut donné.

Si une valeur d'attribut n'est pas trouvée dans la carte des valeurs, le nouvel attribut se verra attribuer la Valeur en sortie par défaut, qui peut être laissée vide.

Paramétrage de valeurs supplémentaires

La valeur en sortie, la valeur en entrée et la valeur en sortie par défaut peuvent être définies sur une valeur fixe ou utiliser une valeur prédéfinie par FME. Dans le cas des valeurs d'entrée et de sortie, celles-ci peuvent être définies par ligne dans la table de correspondance des valeurs, de sorte que des valeurs d'attribut différentes peuvent entraîner des actions différentes.

Les valeurs disponibles sont :

Null

Valeur en entrée : Les valeurs nulles d'entrée seront mises en correspondance avec une valeur en sortie.

Valeur en sortie : La valeur source sera mise en correspondance avec une valeur en sortie nulle.

L'inverse est vrai si Sens de la correspondance est défini sur Inverse (sortie vers entrée).

Pas d'action

Aucune action ne sera entreprise. Lors d'une correspondance in situ (c'est-à-dire, si la nouvelle valeur écrase la valeur en entrée), la valeur de l'attribut en entrée sera préservée.

Autrement, aucun attribut en sortie ne sera créé pour la valeur en entrée spécifiée.

Support de valeur nulle, manquante et des chaînes vides.

Lors du mappage de l'entrée vers la sortie, il existe trois valeurs d'attribut qui ne sont pas prises en charge par le paramètre Valeur en sortie par défaut ou par la table de correspondance des valeurs. Il s'agit des valeurs manquantes, nulles et des chaînes vides. Les exceptions sont indiquées ci-dessous.

Il est possible de mapper ou spécifier une valeur par défaut nulle en utilisant la constante null, disponible dans la liste déroulante.

De plus, il est possible de "mapper" une chaîne vide comme valeur source vers une valeur destination, ou de spécifier une chaîne vide comme valeur par défaut.

Notez que si une valeur nulle ou manquante est spécifiée comme destination ou valeur par défaut via un attribut, elle sera convertie en chaîne vide.

Exemples

Exemple : nettoyage de valeurs d'attribut

Dans cet exemple, nous disposons d'un jeu de données sur les vendeurs de produits alimentaires, dans lequel les valeurs de l'attribut DESCRIPTION comportent un certain nombre d'erreurs et de différences de style, comme la capitalisation. Il y a également certaines valeurs que nous voulons combiner dans des catégories plus larges.

Les entités sont acheminées dans un AttributeValueMapper. Afin de trouver toutes les valeurs possibles dans le jeu de données, nous utiliserons l'assistant d'importation dans la boîte de dialogue des paramètres.

La première étape est de sélectionner le jeu de données à importer - choisissez le même jeu de données que nous voulons nettoyer.

Notez que dans la seconde boîte de dialogue, Préciser mode d'importation, nous devons changer le Mode d'importation en Valeurs d'attributs.

Ensuite, dans la boîte de dialogue Sélectionner des attributs, nous spécifions la Valeur en entrée comme DESCRIPTION. Nous n'importons pas de Valeurs en sortie (comme nous le ferions si nous chargions une carte de valeurs prédéfinie), c'est pourquoi nous laissons ce champ vide. Cliquez sur Importer pour terminer.

Le jeu de données est analysé pour trouver toutes les valeurs existantes, et elles sont chargées dans la table de Correspondance des valeurs. Ensuite, nous complétons le côté Valeur en sortie du tableau. Notez les choix suivants :

Toutes les variations de Hot Dogs (hot dogs, HotDogs, HOT DOGS, et ainsi de suite) sont mappées à Hot Dogs.
Plusieurs valeurs qui sont déjà dans la forme souhaitée (Indian Cuisine, Italian Cuisine) ont <Aucune action> attribué, et ne seront donc pas modifiées.
Quelques types relatifs sont assignés à un nom commun et seront donc combinés (Korean Cuisine, Mexican Cuisine).

Notez que l'attribut de sortie est le même que l'attribut d'entrée. Les nouvelles valeurs remplaceront donc les valeurs originales (sauf pour celles qui sont indiquées par <Aucune action>).

Le nettoyage des entités en sortie reflète les changements désirés.

Notes

Si vous avez besoin de mapper de ou vers des valeurs de chaînes absentes, manquantes ou nulles, considérez l'utilisation de NullAttributeMapper.

Configuration

Ports d'entrée

Ports de sortie

Paramètres

Correspondance des valeurs

Valeur en sortie par défaut

La valeur à donner à l'attribut de sortie si la valeur de l'attribut d'entrée n'est pas trouvée dans la table de correspondance des valeurs. L'inverse est vrai lorsque le paramètre Sens de la correspondance est défini sur Inversion (sortie vers entrée).

La valeur par défaut peut être une constante ou une valeur calculée (comme une valeur d'attribut), la valeur d'un paramètre utilisateur, la valeur d'un paramètre système ou une expression contenant l'ensemble de ces valeurs.

Vous pouvez également saisir une valeur par défaut contenant le mot KEY (en majuscules), où KEY sera remplacé par la valeur de l'attribut d'entrée. Si, par exemple, vous avez entré une valeur par défaut de KEY-0 et que l'attribut d'entrée a une valeur d qui n'est pas dans la table de correspondance, la valeur de l'attribut de destination sera définie sur d-0 parce que KEY est remplacé par la valeur originale d. Si vous laissez le champ vide et que des valeurs correspondantes ne sont pas trouvées, une chaîne vide est attribuée.

Sens de la correspondance

Détermine si les valeurs seront mises en correspondance de l'attribut d'entrée vers l'attribut de sortie, ou l'inverse. Cela peut être utile lors du changement de direction, sans avoir à recréer toute la table de consultation inversée.

Valeur en entrée et Valeur en sortie

Cette table de valeurs spécifie les informations de correspondance.

Lorsque le Sens de la correspondance est définie sur Vers l'avant (entrée vers sortie), si la valeur de l'attribut d'entrée est spécifiée dans la colonne Valeur en entrée, l'attribut de sortie sera créé avec la valeur spécifiée dans la colonne Valeur en sortie correspondant à cette valeur en entrée.

Ce processus est inversé si le Sens de la correspondance est définie sur Inversion (sortie vers entrée).

La valeur en entrée et la valeur en sortie peuvent être une valeur constante ou une valeur calculée telle qu'une valeur d'attribut, la valeur d'un paramètre publié, la valeur d'un paramètre FME ou une expression contenant ces éléments.

Importer

Vous pouvez importer des valeurs d'attributs (valeur en entrée, valeur en sortie ou les deux) à partir de n'importe quel jeu de données source pris en charge par FME.

Cette fonction est généralement utilisée pour importer toutes les valeurs existantes du jeu de données qui est mappé, ou pour importer une table de consultation prédéfinie (souvent stockée dans une feuille de calcul ou un fichier texte). Cliquez sur le bouton Importer pour lancer l'assistant d'importation, et suivez les instructions.

Sélectionner un jeu de données source

Choisissez un jeu de données externes à lire.

Préciser le Mode d'importation et les Types d'entités à sélectionner

Sélectionnez le type d'entités à lire. Dans la plupart des cas, sélectionner Importer depuis : Valeurs d'attributs pour scanner des valeurs.

Sélectionner des attributs

Vous pouvez choisir les attributs disponibles pour la valeur en entrée et/ou en sortie. Si l'un de ces attributs est laissé vide, la colonne ne sera pas remplie.

Si vous chargez une table de correspondance prédéfinie, un attribut doit être attribué à chacun d'eux. Si vous recherchez des valeurs existantes, seule la valeur en entrée sera probablement sélectionnée.

Éditer les paramètres des Transformers

À l'aide d'un ensemble d'options de menu, les paramètres du Transformer peuvent être attribués en faisant référence à d'autres éléments de traitement. Des fonctions plus avancées, telles qu'un éditeur avancé et un éditeur arithmétique, sont également disponibles dans certains Transformers. Pour accéder à un menu de ces options, cliquez sur à côté du paramètre applicable. Pour plus d'informations, voir Options de menus et paramètres de Transformer.

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple est de simplement taper une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types comme des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres de traitement. Il existe un certain nombre d'outils et de raccourcis qui peuvent aider à construire des valeurs, généralement disponibles dans le menu contextuel déroulant adjacent au champ de valeur.

Définir des valeurs de paramètres

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

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

Outils de tableau

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.

Références

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

FME Community

FME Community est l'endroit où trouver des démos, des tutoriaux, des articles, des FAQ et bien plus encore. Obtenez des réponses à vos questions, apprenez des autres utilisateurs et suggérez, votez et commentez de nouvelles entités.

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

Les exemples peuvent contenir des informations sous licence Open Government - Vancouver et/ou Open Government - Canada.

Attribut en entrée	Attribut dont la valeur doit être utilisée.
Attribut en sortie	L'attribut qui stockera la valeur recherchée. Vous pouvez utiliser le nom par défaut ou spécifier un nouveau nom d'attribut. Vous pouvez également saisir le nom d'un attribut existant, y compris l'attribut d'entrée. Si un attribut existant ou l'attribut d'entrée est spécifié, la valeur existante de l'attribut est écrasée.