Transformers FME: 2025.0
Transformers FME: 2025.0
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
Exemples

Dans cet exemple, nous configurons un HTTPCaller pour accéder à Jira à l'aide de la méthode GET.
Pour tester la configuration, nous utilisons l'Envoi d'une requête de test.
Dans la fenêtre de paramètres, notez que les paramètres utilisateur employés pour la configuration sont disponibles et complétés. Pour tester la configuration, utiliser Envoi d'une requête de test.
Les résultats sont présentés dans la Prévisualisation de réponse de test.
D'autres tests peuvent être effectués en modifiant les valeurs des paramètres utilisateur, mais ces valeurs ne servent qu'à des fins de test et ne seront pas appliquées comme valeurs réelles dans le traitement.
Cliquer sur OK sauvegardera la réponse actuelle et toutes les valeurs de paramètres utilisateur pour utilisation future.
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.
De plus, 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 d'en-têtes multipartites. Par défaut, les en-têtes sont stockés dans l'attribut de liste _headers{}. Pour obtenir une liste des en-têtes de réponse HTTP courants, veuillez consulter 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 d'authentification |
Si l'option est activée, fournir les détails d'authentification nécessaires.
|
||||||||||||||||
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.
|
||||||
Attributs d'en-tête et de statut de la réponse |
|
||||||
Traitement des réponses multipartites |
Il est rare, mais possible, qu'un serveur HTTP renvoie une réponse en plusieurs parties. En d'autres termes, une requête HTTP unique donnera lieu à une réponse HTTP contenant plusieurs parties différentes. Une réponse multipartite aura un en-tête Content-Type commençant par "multipart", tel que "multipart/mixed". HTTPCaller dispose de l'option Entité générée pour diviser de telles réponses en plusieurs entités. Les réponses multipartites étant très rares, le comportement par défaut est de ne pas diviser les réponses multipartites 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.
|

Requêtes concurrentes |
|
||||||||||
Répéter les requêtes échouées |
Lorsqu'il est activé, le HTTPCaller tente de relancer les demandes qui ont échoué ou qui ont renvoyé une erreur HTTP.
|
||||||||||
Limitation du débit |
|
||||||||||
Options clients HTTP |
|||||||||||
Certificat client HTTPS
|
Dans une connexion HTTPS classique, le serveur fournit un certificat qui est authentifié par le client. Cela garantit la sécurité de la connexion. Il est également possible pour le client de s'authentifier auprès du serveur par le biais d'un certificat, appelé certificat client. C'est ce qu'on appelle le « TLS mutuel », qui permet au serveur de n'accepter que les connexions des clients disposant d'un certificat valide. Ce type d'authentification est rare et n'est généralement utilisé que lorsqu'une sécurité avancée est requise. Lors de l'utilisation d'un certificat client, une clé privée est également nécessaire.
|
||||||||||
Sécurité avancée |
|
Éditer les paramètres des Transformers
Les paramètres du Transformer peuvent être définis en saisissant directement des valeurs, en utilisant des expressions ou en faisant référence à d'autres éléments de l'espace de travail tels que des valeurs d'attributs ou des paramètres utilisateur. Divers éditeurs et menus contextuels sont disponibles pour vous aider. Pour voir ce qui est disponible, cliquez sur à côté du paramètre concerné.

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

Outils de tableau
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.
Pour plus d'information, consulter la section Options des Transformers.
Références
Comportement |
|
Stockage des entités |
Non |
Dépendances | Aucun |
Alias | |
Historique |
Ce Transformer remplace les Transformers HTTPFetcher, HTTPUploader, HTTPFileUploader, HTTPMultipartUploader, HTTPDeleter and HTTPHeader. |
FME Community
FME Community dispose d'une mine de connaissances sur FME, avec plus de 20 000 membres actifs dans le monde entier. Obtenez de l'aide sur FME, partagez vos connaissances et entrez en contact avec des utilisateurs du monde entier.
Voir tous les résultats à propos de ce Transformer sur FME Community.
Examples may contain information licensed under the Open Government Licence – Vancouver, Open Government Licence - British Columbia, and/or Open Government Licence – Canada.