Travailler avec des paramètres publiés
Les paramètres publiés sont des paramètres que vous exposez dans le traitement. Ceci est utile si vous voulez définir des valeurs par défaut visibles, ou si vous voulez être en mesure de modifier facilement un paramètre de traitement à traitement.
Vous pouvez créer des paramètres utilisateur pour définir de nombreux types de données différents, tels que des références à des jeux de données, des attributs, des systèmes de coordonnées, des fichiers de grille de correction, des géométries, des connexions à des bases de données et à des sites Web, du texte, des chiffres, des dates, etc.
Type de paramètre : | Crée un paramètre pour… |
---|---|
Choix | Choisir une ou plusieurs valeur(s). |
Couleur | Sélectionner une valeur de couleur. |
Date-Heure | Saisissez une date et une heure. Pour plus d'informations sur les formats de sortie, voir Format standard de la date et de l'heure de FME. |
Fichier/URL | Choisir les noms et les chemins d'accès des fichiers ou des dossiers existants, un fichier ou un dossier de sortie, ou une URL. |
Message | Afficher un message au moment de l'exécution. |
Nombre | Entrez un nombre entier ou à virgule flottante. Le nombre peut être borné ou non borné en fonction de la configuration spécifiée. |
Mot de passe | Entrer un mot de passe |
Texte | Entrer une chaîne de caractères. |
Oui/Non | Sélectionner ou désélectionner une case à cocher. |
Nom d'attribut | Choisissez des noms d'attributs de type d'entité ou des éléments dans une liste d'attributs délimitée par des virgules ou des espaces. Les choix ne s'affichent que dans le contexte d'une référence au paramètre publié dans le traitement, par exemple lorsque le paramètre Attributs d'un Transformer StringReplacer fait référence à un paramètre publié Attribute Name. |
Système de coordonnées | Choisir un système de coordonnées. |
Connexion à la base de données | Choisir une connexion à une base de données. |
Géométrie | Saisissez une géométrie comme un ensemble de coordonnées spatiales dans GeoJSON. Lorsqu'un traitement contenant un paramètre publié de type Géométrie est exécuté à partir de FME Flow, une interface est disponible pour afficher les coordonnées spécifiées sur une carte et spécifier la géométrie souhaitée. Pour plus d'informations, voir Utilisation du paramètre Géométrie dans FME Flow. Conseil Pour traiter les données JSON renvoyées par ce paramètre : Utilisez un Transformer GeometryReplacer pour transformer la valeur du paramètre en une géométrie réelle. Spécifier GeoJSON comme GeometryEncoding. Utiliser un JSONExtractor pour extraire les valeurs des coordonnées. Par exemple, pour extraire les valeurs des coordonnées X/Y d'une entité ponctuelle, spécifier json["coordinates"][0] et json["coordinates"][1]. |
Fichier de reprojection | Choisir un fichier de grille de correction pour reprojeter des données. |
Connexion web | Choisir une connexion web |
Script | Accède à un script Python qui affecte la valeur d'un paramètre au traitement au moment de l'exécution. |
Paramètre publié ou privé ?
Il existe deux types de paramètres publiés : publiés et privés.
Paramètres publiés
Lorsque vous définissez les paramètres publiés, vous pouvez choisir d'être invité à fournir des informations susceptibles de changer lors de l'exécution du traitement. Cela rend le traitement plus portable.
Vous pouvez également contrôler la visibilité des paramètres publiés en fonction des valeurs d'autres paramètres spécifiés précédemment dans l'invite.
Les paramètres publiés s'affichent dans le fichier journal tels qu'ils apparaîtraient sur la ligne de commande, ce qui permet de simplifier la migration de traitements vers un environnement basé sur les commandes.
Pour plus d'informations, voir Exécuter un Traitement avec des paramètres publiés.
Paramètres privés
Les paramètres privés sont utilisés en interne, principalement pour partager une valeur de paramètre entre plusieurs Transformers. Par exemple, plusieurs SchemaMappers peuvent faire référence à un seul paramètre pour son jeu de données de table de mappage de schéma. Vous pouvez également créer des paramètres pour les champs nom d'utilisateur/mot de passe dans les tables de base de données couramment utilisées.
Les paramètres privés sont presque identiques aux paramètres publiés mais ils ont pour différences :
- Saisir les paramètres et exécuter ne vous invite pas à saisir des informations pour les paramètres privés.
- La ligne de commande, en haut du journal et du fichier
.fmw
, ne montre pas l'argument de ligne de commande pour définir les paramètres privés. (Toutefois, comme il s'agit de macros dans le fichier de mappage, vous pouvez toujours les modifier).
Créer un paramètre utilisateur
Lorsque vous créez un paramètre publié, vous spécifiez le type de paramètre, s'il est publié ou privé, et toutes ses autres propriétés. Pour plus d'informations, voir Créer et modifier un paramètre publié.
Utilisation des paramètres
Une fois que vous avez créé un paramètre, vous pouvez l'utiliser de plusieurs façons :
- Faire un clic droit sur le paramètre et sélectionner Dupliquer pour créer un autre paramètre avec des valeurs similaires à éditer si désiré.
- Cliquer avec le bouton droit de la souris sur le paramètre et sélectionner Copier. Pour réutiliser le paramètre dans un autre traitement, cliquer avec le bouton droit de la souris dans l'espace de travail et sélectionner Coller. Le paramètre est appliqué au nouveau traitement, ainsi que tous les autres paramètres auxquels il fait référence.
- Cliquer avec le bouton droit de la souris sur le paramètre et sélectionnez Appliquer à pour appliquer ce paramètre à un autre paramètre dans le traitement.
- Utiliser le Transformer ParameterFetcher avec le nom de paramètre spécifié.
Exemples
FME Community comprend des informations supplémentaires et des exemples de paramètres publiés.