HTTPCaller
Accède à une URL via HTTP ou HTTPS, en utilisant une variété de méthodes HTTP.
Les méthodes disponibles sont les suivantes :
HEAD
GET
PUT
POST
DELETE
OPTIONS
PATCH
COPY
LOCK
MKCOL
MOVE
PROPFIND
PROPPATCH
UNLOCK
CHECKOUT
CHECKIN
UNCHECKOUT
LINK
UNLINK
Configuration
Ports d'entrée
Ce Transformer accepte tous types d'entités.
Ports de sortie
Le corps de la réponse HTTP peut être enregistré dans un attribut ou dans un fichier. Par défaut, le corps est enregistré dans l'attribut identifié par le paramètre Attribut Réponse.
Le code d'état de la réponse HTTP sera stocké dans l'attribut nommé par le paramètre Attribut du code de statut. Par défaut, il s'agit de l'attribut _http_status_code. Pour plus d'informations sur les codes d'état HTTP, veuillez vous reporter à https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.
En outre, les en-têtes de la réponse HTTP seront enregistrés dans l'attribut de liste spécifié par le paramètre Attribut de liste pour les en-têtes de réponse. Par défaut, les en-têtes sont enregistrés dans l'attribut de liste _headers{}. Pour obtenir une liste des en-têtes de réponse HTTP courants, veuillez consulter le site https://en.wikipedia.org/wiki/List_of_HTTP_header_fields.
Si une erreur se produit lors de l'accès à l'URL, l'entité sera émise via le port <Rejected>. En outre, un message d'erreur sera défini dans l'attribut nommé par le paramètre Attribut Erreur.
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.
Paramètres
URL |
Ce paramètre identifie l'URL qui sera accédée par le Transformer. Le Transformer peut accéder aux URLs http et https. L'URL peut être saisie directement dans le Transformer, ou être construite à partir des valeurs des attributs. |
||||||||||
Méthode HTTP |
Sélectionner une méthode HTTP pour accéder au serveur. La plupart des demandes utilisent la méthode GET. Les demandes de téléchargement de données utilisent généralement la méthode PUT, POST ou PATCH, bien qu'un corps de téléchargement puisse également être fourni avec la méthode DELETE. Les méthodes HEAD , DELETE et OPTIONS peuvent être utiles pour accéder à une API REST. Des méthodes supplémentaires sont disponibles. |
||||||||||
Paramètres complémentaires de la requête |
Ce tableau peut être utilisé pour créer des paramètres de requête d'URL supplémentaires. Les paramètres seront ajoutés à l'URL indiquée dans le paramètre URL de la section Requête. Cela peut être utile pour accéder à un point de terminaison d'API REST qui nécessite de nombreux paramètres. Les noms et valeurs des paramètres peuvent être saisis directement ou construits à partir de valeurs d'attributs. |
||||||||||
En-têtes |
Cette table peut être utilisée pour créer des en-têtes HTTP personnalisés qui seront envoyés avec la requête. Cela peut être utilisé pour personnaliser la demande que FME fera au serveur. Les noms et les valeurs des en-têtes peuvent être saisis directement ou construits à partir de valeurs d'attributs. De plus, la colonne Nom fournit une liste de noms d'en-têtes couramment utilisés. |
||||||||||
Corps |
Ces paramètres sont activement uniquement lorsque la Méthode HTTP est PUT, POST, DELETE, ou PATCH. Un corps de téléchargement n'est pas obligatoire ; par exemple, les demandes DELETE n'ont souvent pas de corps de téléchargement.
|
Enregistrer le corps de la réponse dans |
Ce paramètre permet aux utilisateurs de définir la destination du corps de la réponse HTTP. Le corps peut être enregistré dans un attribut, dans un fichier spécifié par l'utilisateur, ou dans un nouveau fichier dans un répertoire spécifié par l'utilisateur. Note: Si vous téléchargez un corps de réponse très volumineux avec le HTTPCaller, il est recommandé de l'enregistrer dans un fichier. Cela évite de créer un grand attribut sur l'entité. |
||||||
Enregistrer le corps de la réponse dans un attribut |
Lorsque cette option est sélectionnée, chaque corps de réponse HTTP est enregistré dans un attribut de l'entité qui a fait la demande. Les paramètres suivants sont activés pour cette option.
|
||||||
Enregistrement de la réponse dans un fichier |
Lorsque cette option est sélectionnée, chaque réponse HTTP sera enregistrée dans un fichier. Les paramètres suivants sont activés pour cette option.
|
||||||
Enregistrer le corps de la réponse dans un dossier |
Lorsque cette option est sélectionnée, HTTPCaller crée un nouveau fichier pour chaque entité traitée.
|
||||||
En-tête de réponse et attributs d'état |
|
||||||
Traitement des réponses multipartites |
Il est rare, mais possible, qu'un serveur HTTP renvoie une réponse multipartite. C'est-à-dire qu'une seule demande HTTP donnera lieu à une réponse HTTP contenant plusieurs parties différentes. Une réponse multipart aura un en-tête Content-Type qui commence par "multipart", comme "multipart/mixed". Le HTTPCaller a la possibilité de diviser de telles réponses en plusieurs entités. Les réponses multipart étant très rares, le comportement par défaut est de ne pas diviser les réponses multipart en plusieurs entités. Ces paramètres ne sont activés que lorsque les corps de réponse sont enregistrés dans des attributs ou dans un dossier.
|
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 :
|
Vérifier les certificats SSL |
Si Oui, le Transformer vérifiera les certificats SSL. Cette vérification se fait en deux étapes :
Si Non, aucune vérification ne sera effectuée. Cela pourrait permettre l'interception de la demande/réponse HTTP à l'insu du client ou du serveur. Sous MacOS, les requêtes adressées à certains serveurs ne fonctionneront pas si ce paramètre n'est pas défini sur Oui. |
Puissance de chiffrement minimale |
Ce paramètre contrôle la force de cryptage minimale utilisée pour les connexions HTTPS. Les options sont les suivantes :
|
Méthode d'authentification |
Sélectionnez une méthode pour effectuer l'authentification. Les choix possibles sont les suivants :
Note: Bien que la méthode d'authentification d'accès "Basic" ait été conçue pour permettre à un client d'envoyer des requêtes à un serveur protégé, il faut savoir que toutes les requêtes passées du client au serveur peuvent être facilement interceptées à l'intérieur d'une connexion non sécurisée. |
Connexion web |
Sélectionnez ou créez une connexion Web nommée FME. |
Nom d'utilisateur pour l'authentification HTTP |
Fournir un nom d'utilisateur pour les méthodes d'authentification HTTP. |
Mot de passe d'authentification HTTP |
Fournir un mot de passe pour les méthodes d'authentification HTTP. |
Lorsqu'il est activé, le HTTPCaller tente de relancer les demandes qui ont échoué ou qui ont renvoyé une erreur HTTP.
Types d'erreurs à réessayer |
Ce paramètre permet aux utilisateurs de sélectionner les types d'erreurs qui doivent entraîner une nouvelle tentative. Les options disponibles comprennent les erreurs de connexion telles que le dépassement du délai d'attente du réseau ou l'échec du service DNS, ou divers codes d'erreur HTTP de la gamme 4xx-5xx. |
Nombre maximal de tentatives de réessai |
Ce paramètre spécifie le nombre maximum de tentatives de réessai qui seront faites pour une seule entité, avant que cette entité ne soit sortie par le port <Rejected> du Transformer. |
Durée initiale du backoff (msec) |
Ce paramètre indique le temps que le Transformer attendra avant de réessayer une demande qui a échoué. Cette valeur est fournie en millisecondes. Les tentatives ultérieures de la même demande utiliseront un temps d'attente plus long, le temps doublant pour chaque demande. Ce paramètre est ignoré si la réponse à une demande qui a échoué contient un en-tête HTTP "Retry-After". Si cet en-tête est présent, la demande sera réessayée après le temps ou l'intervalle spécifié dans la valeur de l'en-tête. |
É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.
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.
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.
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. |
Plusieurs fonctions sont disponibles dans les deux éditeurs. | |
Fonctions Date/heure | Les fonctions de dates et heures sont disponibles dans l'Editeur texte. |
Ces opérateur sont disponibles dans l'éditeur arithmétique. | |
Elles retournent des valeurs spécifiques aux entités. | |
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 :
|
Couper, Copier et Coller
|
Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :
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.
Ce Transformer remplace les Transformers HTTPFetcher, HTTPUploader, HTTPFileUploader, HTTPMultipartUploader, HTTPDeleter and HTTPHeader.
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.
Mots clefs : URLFetcher