AttributeFileReader

Dans cet exemple, nous allons lire un fichier texte et l'ajouter à une entité raster en tant qu'attribut. Nous voulons ajouter une palette (le fichier texte) à un raster numérique au format GeoTIFF.

La trame est d'abord acheminée par un RasterBandInterpretationCoercer pour répondre aux exigences de traitement - le type de bande doit être un entier non signé pour être compatible avec les palettes.

Ensuite, le raster est transmis à un AttributeFileReader. Notez qu'il possède un attribut exposé, et qu'il consiste en une bande numérique, un entier non signé de 8 bits.

Un fichier texte contenant les informations de la palette a déjà été préparé, comme indiqué ici dans le bloc-note.

Dans les paramètres d'AttributeFileReader, nous conservons le nom par défaut d'attribut du Contenu du fichier en tant que _file_contents, et sélectionnons le fichier Palette_color.txt.

Comme il s'agit d'un fichier texte, préparé sur le même ordinateur que celui sur lequel il est traité, nous pouvons utiliser le codage par défaut du système (fme-system).

En examinant la sortie d'AttributeFileReader, notez que le raster possède maintenant un attribut supplémentaire, _file_contents, qui contient le contenu du fichier texte.

La dernière étape de ce flux de travail consiste à appliquer la palette du nouvel attribut avec un RasterPaletteAdder.

Dans cet exemple, nous avons à la fois un nuage de points et une ortho-image de la même zone, et nous voulons les garder ensemble - nous allons donc attacher l'image à l'entité du nuage de points comme un attribut.

Notez que le nuage de points possède un attribut exposé.

L'orthoimage est un GeoTIFF.

Le nuage de points est acheminé dans un AttributeFileReader.

Dans les paramètres, nous conservons le nom par défaut d l'attribut de contenu de fichier _file_contents, et sélectionnons le fichier StadiumOrthoLowRes.tif.

Le codage des caractères du fichier source est défini sur Binaire (fme-binary), ce qui permet de stocker le GeoTIFF sous forme de Blob.

En examinant la sortie dans FME Data Inspector, notez que le nuage de points possède un nouvel attribut qui contient l'orthoimage, toujours encodée en binaire.

A partir de là, l'image peut être décodée et utilisée à tout moment avec un RasterReplacer, comme dans l'exemple ci-dessous qui utiliserait le raster pour colorer les points du nuage de points avec un PointCloudOnRasterComponentSetter. Une autre utilisation ultérieure pourrait consister à l'écrire dans une colonne Blob d'une base de données.

Entités recevant des fichiers en tant qu'attributs.

Entités avec des fichiers ajoutés comme valeurs d'attribut comme spécifié dans les paramètres.

Si un nom de fichier non valide est spécifié, l'entité sera acheminée vers le port <Rejected>. Les entités rejetées auront un attribut fme_rejection_code avec l'une des valeurs suivantes :

INVALID_FILE_INACCESSIBLE

Gestion des entités rejetées : ce paramètre permet d'interrompre la traduction ou de la poursuivre lorsqu'elle rencontre une entité rejetée. Ce paramètre est disponible à la fois comme option par défaut de FME et comme paramètre de traitement.

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.

Outils de tableau

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

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