OpenAPICaller

Exemple : Importation d'une spécification OpenAPI et test de la requête

Dans cet exemple, nous allons configurer un OpenAPICaller pour récupérer une liste d'emojis disponibles sur Trello via leur spécification OpenAPI.

Notez que le fichier de spécification doit être téléchargé avant d'être utilisé ici - il ne peut pas être lu via une URL. Il s'agit d'un fichier JSON ou YAML.

Dans la boîte de dialogue des paramètres, utilisez le bouton Sélectionner pour accéder à la boîte de dialogue d'importation.

Dans la boîte de dialogue d'importation, naviguez jusqu'au fichier de spécification précédemment téléchargé.

Une fois le fichier de spécification sélectionné, les options de point de terminaison disponibles sont renseignées.

Nous sélectionnons le point de terminaison emoji et sa méthode GET. Notez que les paramètres de requête applicables sont également récupérés.

Importer des paramètres de requête appliquera les sélections aux paramètres OpenAPICaller appropriés.

Les paramètres applicables ont été configurés.

Pour tester la configuration, nous utilisons le bouton Envoyer une demande de test.

Dans la boîte de dialogue de la demande de test, un aperçu de la requête est affiché.

Notez que s'il y avait des paramètres utilisateur dans la requête, ils seraient disponibles et modifiables pour les tests.

L'option Envoyer une demande de test permet d'exécuter la requête.

Les résultats du test de la requête sont renvoyés dans l'aperçu de la réponse du test.

Ces résultats (et toute modification de configuration apportée aux paramètres utilisateur, le cas échéant) sont enregistrés pour référence ultérieure, mais n'affectent pas les paramètres actuels du Transformer.

Entrée

Ce Transformer accepte tous types d'entités.

Output

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.

Requête

Authentification

Si l'option est activée, fournir les détails d'authentification nécessaires.

Méthode d'authentification	Sélectionnez une méthode pour effectuer l'authentification. Les choix possibles sont les suivants : Basic : (authentification HTTP Basic) : C'est le choix par défaut, et la seule méthode largement utilisée et prise en charge pratiquement partout. Elle envoie le nom d'utilisateur et le 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 : Utilisation d'une connexion Web nommée, permettant l'authentification OAuth2 avec les services Web pris en charge. De nouvelles connexions peuvent être définies à partir du menu déroulant des paramètres de la connexion Web. Connexion unique : Lorsqu'il fonctionne sous Windows, le Single Sign-On permet l'utilisation de l'authentification NTLM en utilisant les informations d'identification du compte utilisateur Windows actuel. Cette méthode est plus sûre car elle permet aux utilisateurs de ne pas enregistrer leurs informations d'identification dans les paramètres du Transformer. Elle permet également à des utilisateurs distincts d'exécuter le traitement sans avoir à modifier les paramètres du Transformer pour qu'ils contiennent leurs propres informations d'identification. Ce paramètre n'a aucun effet sur les plateformes Linux ou MacOS. 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.

URL par paramètres

Ce groupe divise l'URL de la requête complète en plusieurs composants qui peuvent être édités séparément. Toute modification apportée à ces paramètres sera répercutée sur la valeur du paramètre URL de la requête complète.

Hôte	Ce paramètre spécifie l'URL du serveur qui a mis en œuvre l'API importée. Le Transformer peut accéder aux URL http et https. L'URL peut être sélectionnée dans une liste d'options fournie par la spécification importée, saisie manuellement ou construite à partir de valeurs d'attributs.
Variables de chemin	Ce tableau peut être utilisé pour créer des paramètres de requête URL supplémentaires. Les paramètres seront ajoutés à l'URL dans le paramètre URL de la requête complète. Cela peut s'avérer utile lors de l'accès à un point de terminaison de l'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.
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.

URL de la requête complète

Ce paramètre identifie l'URL à laquelle le transformateur accède. L'URL peut être modifiée directement dans ce paramètre ou en modifiant les paramètres du groupe URL par paramètres ci-dessus. Toute modification apportée à ce paramètre sera répercutée dans le groupe URL par paramètres.

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.

Type de données à charger

Ce paramètre identifie le type de données qui sera téléchargé. Le Transformer peut télécharger un fichier, une chaîne de caractères ou une combinaison de plusieurs fichiers et chaînes de caractères.

Corps de la requête

Les données de téléchargement peuvent être saisies à l'aide de ce paramètre. Les données peuvent être saisies directement dans le Transformer ou construites à partir de valeurs d'attributs.

Chemin du fichier à charger

Lors du téléchargement d'un fichier, ce paramètre fournit le chemin du fichier. Le chemin peut être entré directement dans le Transformer ou défini à partir d'une valeur d'attribut.

Type de contenu

Lors du téléchargement d'une valeur de type chaîne ou d'un fichier, ce paramètre fournit le type de contenu des données. La valeur de ce paramètre sera envoyée dans l'en-tête de requête Type de contenu. La liste déroulante contient un certain nombre de valeurs de type de contenu couramment utilisées. Si une valeur différente est requise, elle peut être saisie dans le champ de texte ou dérivée d'une valeur d'attribut.

Chargement multiparties

La table est utilisée pour construire la requête combinée.

Nom

Chaque pièce doit avoir un nom.

Type de téléversement

Sélectionner un type de téléversement :

Chargement de fichier
Chargement de chaîne de caractères

Valeur

Fournir une chaîne ou un fichier à télécharger, selon la sélection du type.

Un type MIME est attribué et peut également être défini manuellement.

Lorsque le Type est Chargement de fichier, le type MIME par défaut est application/octet-stream. Lorsque le type est Chargement de chaîne de caractères, le type MIME par défaut est text/plain.

Le type MIME et les données à télécharger (chaîne ou fichier) sont accessibles via le bouton "...".

Configuration du résultat

Méthode de gestion de la réponse

Ce paramètre utilise l'utilisateur à déterminer comment le corps de la réponse HTTP doit être traité.

Produire des fragments JSON en tant qu'entités

Lorsque le mode de traitement de la réponse est Générer des fragments JSON en tant qu'entités , ce mode effectue un post-traitement JSON sur le corps de la réponse, ce qui équivaut à insérer les transformateurs JSONFlattener et JSONFragmenter après l'OpenAPICaller. Les clés et valeurs d'objet contenues dans le corps de la réponse seront extraites dans des entités FME. Le corps de la réponse peut éventuellement être divisé en plusieurs entités à l'aide du paramètre Requête JSON à Fragment.

Si le corps de la réponse ne contient pas de json valide, l'entité sera émise via le port <Rejected>.

Requête JSON vers Fragment

Le paramètre Requête JSON fait référence aux valeurs JSON qui deviendront des nouvelles entités FME.

Ce paramètre peut être saisi directement dans la zone de texte ou, si une réponse de test JSON valide est enregistrée, en cliquant sur le bouton Parcourir qui ouvre une boîte de dialogue contenant la structure de l'ensemble de données JSON sous forme d'arbre. La sélection d'une valeur dans l'arbre remplit le paramètre avec la chaîne de requête appropriée pour transformer les valeurs sélectionnées en entités.

Enregistrer le corps de la réponse complet

Lorsque le mode de traitement des réponses est Enregistrer le corps de la réponse complet, ce paramètre permet aux utilisateurs de définir la destination du corps de la réponse HTTP.

Enregistrer le corps de la réponse dans

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.

Attribut réponse

Ce paramètre nomme l'attribut qui sera utilisé pour stocker le corps de la réponse. Le nom de l'attribut par défaut est _response_body. Lors de l'exécution d'une demande HTTP HEAD, cet attribut sera vide. Cet attribut peut également être vide si la réponse HTTP ne comporte pas de corps, par exemple avec une réponse HTTP 304.

Encodage de la réponse

Ce paramètre est utilisé pour indiquer l'encodage des caractères de l'attribut cible. Par défaut, l'encodage de l'attribut sera automatiquement déterminé à partir des en-têtes de réponse HTTP. Il est également possible de sélectionner un encodage spécifique dans la liste. Lors du téléchargement de données binaires, le paramètre doit être défini sur Binaire ou Auto-détection à partir des en-têtes HTTP.

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.

Nom du fichier en sortie

Ce paramètre indique le fichier qui sera utilisé lors de l'enregistrement des corps de réponse dans un fichier. Le fichier peut être sélectionné directement, ou défini à partir d'un attribut. Notez que si le fichier est sélectionné directement, il sera écrasé par chaque entité passant par le Transformer. Si plus d'une entité passe par le Transformer, il est recommandé que le chemin d'accès au fichier soit défini par une valeur d'attribut unique, ou que le Transformer soit configuré pour télécharger dans un répertoire.

Attribut Chemin du fichier

Après que le corps de la réponse a été enregistré dans un fichier, l'attribut nommé dans ce paramètre sera défini comme le chemin du fichier. Cela permet au fichier d'être manipulé par d'autres Transformers dans le traitement.

Enregistrer le corps de la réponse dans un dossier

Lorsque cette option est sélectionnée, OpenAPICaller crée un nouveau fichier pour chaque entité traitée.

Dossier créé en sortie	Ce paramètre spécifie l'attribut dans lequel le document JSON mis à jour sera écrit.
Extension de fichier	Ce paramètre spécifie l'extension du type de fichier pour les nouveaux noms de fichiers. L'extension de fichier peut être sélectionnée dans une liste de types de fichiers courants, saisie manuellement ou définie automatiquement en fonction de l'en-tête Content-Type de la réponse HTTP.
Attribut Chemin du fichier	Après que le corps de la réponse ait été enregistré dans un fichier, l'attribut nommé dans ce paramètre sera défini au chemin du fichier.

Attributs d'en-tête et de statut de la réponse

Attribut de liste des en-têtes

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'

Attribut Code statut

Ce paramètre est facultatif. S'il est défini comme un nom d'attribut, le code de réponse HTTP renvoyé par le serveur sera stocké dans l'attribut.

Attribut Erreur

Ce paramètre est facultatif. Si une erreur survient, l'entité ressort via le port <Rejected> et l'attribut nommé via ce paramètre comporte un message d'erreur succinct.

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 qui commence par « multipart », tel que « multipart/mixed ». L'OpenAPICaller dispose de l'option Entité en sortie qui permet de diviser de telles réponses en plusieurs entités. Comme les réponses multipart sont 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.

Entité générée

Ce paramètre contrôle le comportement du Transformer lorsqu'une réponse multipartite est reçue.

Entité unique (par défaut) : Une entité contenant l'intégralité de la réponse est produite. Le nombre d'entités sortant du Transformer est égal au nombre d'entités entrant dans le Transformer.

Plusieurs entités : Une entité distincte sera produite pour chaque partie d'une réponse en plusieurs parties. Il peut y avoir plus d'entités de sortie que d'entités d'entrée. Si les corps de réponse sont enregistrés dans un dossier, un sous-dossier est créé pour la réponse en plusieurs parties et chaque partie est enregistrée dans un fichier de ce sous-dossier.

Attribut de liste d'en-tête multipartite

Chaque partie d'une réponse multipartite peut avoir son propre ensemble d'en-têtes. Lorsque les réponses multipartites sont divisées en entités distinctes, chaque entité possède un attribut list contenant les noms et les valeurs des en-têtes de la partie.

Ce paramètre spécifie le nom de cet attribut de liste. Cette liste sera remplie en plus de l'attribut de liste spécifié par le paramètre Attribut de liste d'en-têtes, et ces deux paramètres doivent avoir des valeurs différentes.

Avancé

Requêtes concurrentes

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.

Répéter les requêtes échouées

Lorsqu'il est activé, le OpenAPICaller 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 max de nouvelles tentatives

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.

Limitation du débit

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.

Options clients HTTP

Version HTTP	Ce paramètre permet aux utilisateurs de contrôler quelle version du protocole HTTP est utilisée dans le Transformer. Lorsque l'option Restreindre à HTTP/1.1 est sélectionnée, l'utilisation de HTTP/2 sera désactivée et seul HTTP/1.1 sera utilisé. Lorsque l'option Utiliser HTTP/2 si possible est sélectionnée, HTTP/2 peut être utilisé si le serveur HTTP le prend en charge. Dans le cas contraire, HTTP/1.1 sera utilisé. En règle générale, ce paramètre doit être configuré pour permettre l'utilisation de HTTP/2. Restreindre le Transformer à HTTP/1.1 ne devrait être utilisé que lors de la connexion à des serveurs qui ne gèrent pas correctement HTTP/2.
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 : OpenAPICaller est utilisé pour se connecter à un service web et une session cookie est enregistrée. Un autre Transformer OpenAPICaller peut être utilisé pour accéder au service web en utilisant la session cookie enregistrée. Un troisième OpenAPICaller est utilisé pour se déconnecter du service web, ce qui invalide les cookies enregistrés.
Suivre les redirections	Ce paramètre contrôle la manière dont les redirections sont gérées dans l'OpenAPICaller. Les options sont les suivantes : Oui - Utiliser GET pour toutes les demandes de redirection : Lorsque cette option est choisie, le Transformer effectue une requête GET lorsqu'il est redirigé. Si la requête originale avait un corps de téléchargement, cette option empêche les données de téléchargement d'être incluses dans la requête de redirection. Oui - Utiliser POST si la demande originale était un POST : Lorsque cette option est choisie, la demande de redirection utilisera la même méthode que la demande originale. Cela peut signifier que les données de téléchargement sont incluses dans la demande de redirection, même si la redirection se fait vers un domaine différent. No - do not follow redirects: When this option is chosen, redirect responses will not be automatically followed.
Authentification par redirection	Ce paramètre contrôle la façon dont les en-têtes de requête liés à l'authentification (s'il y en a) sont traités lors des redirections. Les options sont les suivantes : Envoyer le nom d'utilisateur et le mot de passe au premier domaine uniquement : dans ce cas, les en-têtes d'authentification ne seront envoyés qu'au domaine indiqué dans le paramètre URL de la Requête. Il s'agit de l'option la plus sûre. Envoyer le nom d'utilisateur et le mot de passe à tous les domaines : Dans ce cas, les en-têtes d'authentification seront envoyés dans toutes les requêtes, même lorsqu'elles suivent une redirection vers un domaine différent. Cette méthode est moins sûre, car elle peut conduire à l'exposition d'un nom d'utilisateur/mot de passe à des serveurs auxquels ils ne sont pas destinés.
Délai de connexion (secondes)	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.
Délai de transfert (secondes)	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.

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.

Certificat client HTTPS	Ce paramètre détermine si un certificat client est utilisé et, le cas échéant, où il sera récupéré. Les options sont les suivantes : Aucun - aucun certificat client n'est utilisé. C'est la valeur par défaut. Utiliser le magasin de certificats du système d'exploitation (Windows uniquement) - le certificat client et la clé privée peuvent être récupérées depuis le stockage de certificats Windows. Fichier de certificat PKCS#12 - Le certificat du client est extrait d'un fichier PKCS#12. Ce fichier contient généralement un certificat et une clé privée. Il peut être protégé par un mot de passe. Les extensions typiques de ce type de fichier sont p12 et pfx. Fichier de certificat PEM - Le certificat du client est extrait d'un fichier PEM. Il s'agit d'un fichier texte contenant le certificat. Il peut également contenir une clé privée. La clé privée peut également se trouver dans un fichier PEM distinct. Dans les deux cas, le fichier contenant la clé privée peut être protégé par un mot de passe. L'extension typique de ce type de fichier est pem.
Certificat client	Lorsque l'option Utiliser le magasin de certificats du système d'exploitation est sélectionnée, ce paramètre permet de sélectionner le certificat à utiliser. Lorsqu'il est ouvert, il affiche une liste des certificats disponibles à utiliser pour la connexion HTTPS. Il existe également une option <auto select>, qui permet à Windows de sélectionner automatiquement un certificat approprié à utiliser.
Fichier de Certificat client	Lorsque les options Fichier de certificat PKCS#12 ou Fichier de certificat PEM sont sélectionnées, ce paramètre permet de sélectionner le fichier contenant le certificat du client.
Fichier de clé privée	Lorsque l'option Fichier de certificat PEM est sélectionnée, ce paramètre permet de sélectionner le fichier contenant la clé privée. Cette opération peut ne pas être nécessaire si le fichier PEM sélectionné dans le paramètre Fichier de certificat du client comprend à la fois le certificat et la clé privée.
Mot de passe de clé privée	Lorsque les options Fichier de certificat PKCS#12 ou Fichier de certificat PEM sont sélectionnées, ce paramètre peut être utilisé pour fournir le mot de passe permettant d'accéder à la clé privée. Cela peut ne pas être nécessaire si les fichiers de clés privées ne sont pas protégés par un mot de passe.

Sécurité avancée

Vérifier les certificats HTTPS

Si Oui, le Transformer vérifiera les certificats HTTPS. Cette vérification s'effectue en deux étapes :

Vérification que le certificat est pour l'hôte auquel on tente de se connecter.
Assurez-vous que le certificat est valide. C'est-à-dire qu'il a été signé par une autorité de certification de confiance.

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 :

Utiliser les paramètres par défaut du système d'exploitation : Lorsque cette option est choisie, les connexions seront établies avec les paramètres de sécurité recommandés par chaque plateforme.
Autoriser les algorithmes de chiffrement moins sûrs : Lorsque cette option est choisie, des connexions peuvent être établies avec des serveurs qui ne répondent pas au niveau de sécurité recommandé par le système d'exploitation.

Sous Linux, la sélection de cette option correspond à la sécurité de "niveau 1", comme documenté ici.

Sous Windows, cela correspond à ne pas utiliser l'indicateur SCH_USE_STRONG_CRYPTO, comme documenté ici.

Importer depuis une spécification OpenAPI

Spécification	Spécifiez un fichier de spécification OpenAPI JSON ou YAML à utiliser. Ce fichier doit être téléchargé (les URL ne sont pas prises en charge).
Sélectionner un point de terminaison	Sélectionnez une option disponible pour que ses détails s'affichent dans la fenêtre principale des paramètres.

Définir des valeurs de paramètres

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.

Options - Tables

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 :

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.

Comportement	Les angles de ligne et de texte peuvent être ajoutés en tant qu'attribut de sortie.
Stockage des entités	Non
Dépendances	Aucun
Alias
Historique	Ce Transformer remplace l'option Importer depuis OpenAPI du HTTPCaller.

OpenAPICaller

Importer une spécification depuis OpenAPI

Exemples

Configuration

Ports en entrée

Ports de sortie

Paramètres

Éditer les paramètres des Transformers

Références

FME Community