ImageFetcher

Catégories

Rasters

Exécution

Récupère une image en exécutant une requête HTTP GET sur l'URL indiquée. Le résultat est utilisé pour définir une géométrie de type Raster.

Si une erreur survient lors de la requête ou lors de la conversion des données téléchargées en raster, le traitement continue et l'entité ressort par le port <Rejected>.

Configuration

Paramètres

URL de l'image

Entrer l'URL (par exemple, http://www.url.com) ou choisir un attribut qui contient l'URL.

Type d'image

Choisir le type d'image. Si l'option <Détection automatique à partir des en-têtes HTTP> est choisie, le Transformer examinera l'en-tête 'Content-Type' dans la réponse HTTP pour trouver un type MIME. Si un type MIME connu est trouvé, le Reader correspondant sera utilisé pour créer la géométrie raster.

Nombre maximum de requêtes HTTP simultanées

Ce paramètre contrôle la façon dont les entités sont traitées par le Transformer. La valeur de ce paramètre indique le nombre maximum de transferts qui seront en cours en même temps.

Lorsque le paramètre est réglé sur 1, un transfert sera entièrement traité avant que le transfert suivant puisse commencer.

Lorsque ce paramètre a une valeur supérieure à 1, le Transformer n'attendra pas la fin de chaque transfert avant de commencer le suivant. Plusieurs transferts peuvent avoir lieu en même temps. Cela peut fournir des avantages significatifs en termes de performance. Cette valeur doit être ajustée en fonction de la capacité du serveur HTTP à traiter plusieurs demandes en même temps, en tenant compte du fait que plusieurs Transformers HTTPCaller peuvent accéder au serveur en même temps.

Ce paramètre doit être réglé sur 1 si le Transformer est utilisé à l'intérieur d'un Transformer personnalisé qui a une sortie en boucle.

Requêtes maximales par intervalle

Il s'agit du nombre maximum de requêtes HTTP que le Transformer lancera dans un intervalle de temps donné. Par exemple, si vous voulez limiter le Transformer à 50 demandes par minute, vous devez définir ce paramètre à 50.

Durée de l'intervalle (secondes)

Il s'agit de la période pendant laquelle les demandes seront limitées. Par exemple, si vous voulez limiter le Transformer à 50 demandes par minute, vous devez régler ce paramètre sur 60. Certaines valeurs prédéfinies sont fournies dans la liste des paramètres, ou n'importe quel nombre peut être saisi manuellement.

Temporisation des requêtes

Ceci contrôle la manière dont les transferts sont lancés dans l'intervalle de temps. Il existe deux options :

  • Exécuter les requêtes dès que possible : Lorsque cette valeur est sélectionnée, les demandes seront lancées dès que possible, tant que le nombre maximum de demandes lancées dans l'intervalle de temps précédent ne dépasse pas le maximum. Cela peut conduire à ce que de nombreuses demandes soient lancées au début de l'intervalle de temps, et que rien ne se passe avant que l'intervalle ne soit écoulé.

  • Exécuter les requêtes de façon régulière pendant l'intervalle : Lorsque cette valeur est sélectionnée, le Transformer essaiera de lancer les requêtes de manière égale dans l'intervalle. En d'autres termes, il divise la longueur de l'intervalle par le nombre maximum de requêtes, puis s'assure qu'au moins ce temps s'écoule entre le lancement de chaque requête. Cela équivaut à insérer un Transformer Decelerator avant le HTTPCaller, et peut alléger la charge d'un serveur HTTP.

Enregistrer les cookies

Si ce paramètre est défini à Oui, les cookies enregistrés correspondant à l'URL spécifiée seront envoyés avec la requête. En outre, tous les cookies contenus dans la réponse seront enregistrés pour être utilisés lors de demandes HTTP ultérieures.

Les cookies enregistrés persistent le temps du traitement mais il ne peuvent pas être utilisés dans les traitements futurs.

L'enregistrement des cookies est utile lorsqu'un service web conserve une "session". Dans ce cas, la séquence d'opérations suivante peut être utilisée :

  1. HTTPCaller est utilisé pour loguer dans un service web et une session cookie est enregistrée.
  2. ImageFetcher est utiliser pour télécharger une image à partir d'un service web en utilisant la session cookie enregistré.
  3. Un deuxième HTTPCaller est utilisé pour se déconnecter du service web qui invalide le cookie enregistré.

Suivre les redirections

Si ce paramètre vaut Oui, le Transformer suit toutes les redirections URL qu'il rencontre, faisant de nouvelles requêtes.

Vérifier les certificats SSL

Si ce paramètre est réglé sur Oui, le Transformer vérifiera les certificats SSL. Cette vérification s'effectue en deux étapes :

  1. Vérification que le certificat est pour l'hôte auquel on tente de se connecter.
  2. Vérification de la validité du certificat.

Durée de connexion avant expiration

Ce paramètre peut être utilisé pour définir un délai d'attente sur les demandes de connexion HTTP. Si une connexion au serveur ne peut être créée dans le nombre de secondes indiqué, la demande échoue et l'entité est émise via le port <Rejected>. Le délai de connexion par défaut est de 60 secondes. Si 0 est entré, il n'y aura pas de délai d'attente, et le Transformer attendra indéfiniment une connexion réussie.

Durée de transfert avant échec

Ce paramètre peut être utilisé pour définir un délai d'attente sur les transferts HTTP. Si les données cessent d'être transférées pendant plus du nombre de secondes indiqué, la demande échoue et l'entité est émise via le port <Rejected>. Le délai de transfert par défaut est de 90 secondes. Si 0 est entré, il n'y aura pas de délai d'attente, et le Transformer attendra indéfiniment que les données reprennent leur transfert.

Activer cette option si l'image est récupérée à partir d'un serveur qui nécessite une authentification de l'utilisateur.

Méthode d'authentification

Spécifie la méthode d'authentification au serveur :

  • Basic (authentification HTTP de base) : C'est le choix par défaut, et la seule méthode largement utilisée et prise en charge pratiquement partout. Elle envoie un nom d'utilisateur et un mot de passe sur le réseau en texte clair, facilement capturable par d'autres.
  • Digest (Authentification HTTP Digest) : cette méthode est plus sûre que la méthode Basic.
  • NTLM : (authentification HTTP NTLM) : NTLM est un protocole propriétaire inventé et utilisé par Microsoft. Il utilise un concept de défi-réponse et de hachage similaire à Digest pour empêcher l'écoute du mot de passe.
  • Connexion web nommée : vous permet de vous authentifier à l'aide d'une connexion de service Web nommée stockée. Pour plus d'informations, consultez la rubrique Utilisation des connexions Web dans l'aide de FME Workbench.

Connexion web nommée

Si la méthode d'authentification est une connexion Web nommée, indiquez la connexion nommée à utiliser pour l'authentification. Pour ajouter une nouvelle connexion nommée, sélectionnez Ajout connexion web nommée dans le menu déroulant.

Nom d'utilisateur HTTP et Mot de passe HTTP

Si la Méthode d'Authentication est Basic, Digest, ou NTLM, spécifier le nom et mot de passe d'authentification.

Code de statut HTTP

(Facultatif) Nom l'attribut pour contenir un message d'erreur pertinent si une erreur se produit. L'entité sera sortie par le port de sortie <Rejected>.

Erreur HTTP

(Facultatif) Nommez l'attribut pour contenir un message d'erreur pertinent si une erreur se produit. L'entité sera sortie par le port de sortie <Rejected>.

Attributs de liste pour les en-têtes de réponse

Ce paramètre est facultatif. S'il est défini comme un nom d'attribut de liste, les en-têtes HTTP renvoyés par le serveur seront stockés dans l'attribut de liste. Les en-têtes seront divisés en noms et en valeurs. Par exemple :

`_headers{0}.name' has value `X-XSS-Protection'

`_headers{0}.value' has value `1; mode=block'

`_headers{1}.name' has value `Date'

`_headers{1}.value' has value `Wed, 25 May 2011 17:20:20 GMT'

`_headers{2}.name' has value `Transfer-Encoding'

`_headers{2}.value' has value `chunked'

`_headers{3}.name' has value `Content-Type'

`_headers{3}.value' has value `text/html; charset=ISO-8859-1'

`_headers{4}.name' has value `Cache-Control'

`_headers{4}.value' has value `private, max-age=0'

É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.

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.

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.

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.

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.