Effectue la transformation de la valeur d'un attribut à partir d'une table de correspondance et stocke le resultat dans un nouvel attribut.Ce Transformer ne modifie pas le type d'entités.

Paramètres

Attribut source

Après avoir connecté ce Transformer, choisir un attribut dans la liste déroulante.

Nouvel attribut

Attribut qui stockera la valeur de correspondance. Vous pouvez utiliser la valeur par défaut ou saisir un nom différent.

Valeur par défaut

Valeur par défaut utilisée si aucune valeur n'est trouvée. Le Transformer retourne la valeur trouvée ou la valeur par défaut si aucune valeur n'est trouvée.

La valeur peut comprendre des séquences d'échappement spécifiés dans la liste suivante. Si la séquence n'est pas décrite dans la liste, le caractère "\" est ignoré. Par exemple "ru\es" sera interprété comme "rues".

Si la valeur ne peut pas être trouvée dans la table, la VALEUR PAR DEFAUT est utilisée à la place. Une valeur par défaut vide signifie que les entités sans correspondance sont associées à la valeur nulle et que le traitement continue. (Notez que dans les versions antérieures à 2009, ce comportement est différent.)

Entrer une clé par défaut

Vous pouvez aussi entrer une valeur par défaut en utilisant un mot clé (KEY). Par exemple, si vous avez les correspondances :

Par exemple, si vous avez les correspondances :

a : 1

b : 2

et une entité a une valeur de "d" qui n' existe pas dans la table de correspondance.

Si vous avez rentré comme valeur par défaut KEY-0, Or, KEY est un mot-clé qui est remplacé automatiquement par sa valeur d'origine. Dans l'exemple ci-dessus, la valeur retournée est donc "d-0".

Inverser la correspondance

Si le paramètre Inverser la correspondance est coché, le sens de la transformation est inversé. La conversion est établie de la source vers la correspondance dans le sens normal et de la correspondance vers la source dans le sens inverse.

Importer

Les valeurs d'attributs peuvent aussi être importées depuis un jeu de données supporté par FME.

Le plus simple est d'importer des valeurs du même jeu de données, mais vous pouvez également importer des valeurs à partir d'une table de correspondance stockée au format texte, CSV ou Excel, ou autres. Cliquer sur le bouton Importer. Un assistant vous aidera lors du processus d'import.

1. Sélectionner le jeu de données à lire. Cliquer sur Suivant.
2. Une liste des types d'entités s'affiche. Les entités du jeu de données sont scannées et les attributs trouvés sont ajoutés à la liste des valeurs. Cliquer sur Suivant.
3. Choisir l'attribut qui représente la Clé. Cet attribut doit correspondre à la valeur de l'attribut entrant dans le Transformer. Cliquer sur Suivant.
4. Choisir l'attribut qui représente la Valeur. La valeur de cet attribut sera ajouté à AttributeValueMapper. Cliquer sur Suivant.
5. Les entités sont scannées et le nombre d'entités parcourues et le nombre de valeurs uniques trouvées sont affichées. Cliquer sur Terminer pour insérer les valeurs dans la table.

Si une seule des deux colonnes de la table de correspondance est disponible dans le fichier d'import, il est recommandé de sélectionner le même attribut pour la source et la correspondance Cela donne une correspondance simple 1 : 1 que vous devez ensuite modifier. Si différentes valeurs sont choisies, alors la correspondance n'est pas de type 1 : 1. AttributeValueMapper peut également être utilisé pour faire correspondre plusieurs valeurs sources à une seule.

Exemple

Vous pouvez utiliser des ValueMapper pour définir un nom de fichier (attribut fme_feature_type) en fonction d'un code et pour affecter une couleur à chaque nom de fichier.

Dans cet exemple, le premier ValueMapper est utilisé pour faire correspondre le code existant aux valeurs road, river et railroad. Ce résultat sera stocké dans l'attribut featureType.

Un deuxième ValueMapper est utilisé pour créer un attribut fme_color qui affecte une couleur différente pour chaque valeur de featureType. Le format de cet attribut est r,g,b ou r, g et b sont des chiffres entre 0 et 1.

Historique du Transformer

Ce transformer était nommé ValueMapper dans les versions antérieures.

Implémentation

Fonction(s) de bas niveau utilisée(s) (Function ou Factory): @lookup