FME Form: 2025.0

Options  FME : Connexions web

Sélectionner Outils> FME Options > Connexions web.

Conseil  Utiliser la fonction Rechercher pour localiser un paramètre dans les Options FME.

De nombreux services Web exigent que vous vous connectiez et que vous vous authentifiiez afin d'effectuer des appels REST vers eux. Par exemple, lorsque vous utilisez un Transformer HTTPCaller, vous pouvez avoir besoin de vous authentifier auprès d'un service Web, tel que Google BigQuery. La page Connexions Web vous permet de gérer les connexions Web et les services Web qui leur sont associés.

Gérer les services web

FME Form doit être enregistré pour pouvoir utiliser les services web auxquels vous souhaitez vous connecter. À des fins de test, un grand nombre des services les plus courants qui s'authentifient à l'aide de la norme OAuth sont déjà enregistrés dans FME. Pour les applications de production, nous vous recommandons d'ajouter vos propres services web.

Dans d'autres cas, FME ne fournit qu'un modèle de référence au service web. Pour utiliser le service, vous devez également fournir vos informations d'identification. Si le service adhère à la norme OAuth 2.0, vous pouvez fournir ces informations d'identification de manière dynamique lors de l'établissement d'une connexion (voir ci-dessous).

Attention Les identifiants d'autorisation, tels que ID Client et Secret Client, qui sont inclus dans les services OAuth préenregistrés, sont sujets à des interruptions de service hors du contrôle de Safe Software. Dans un environnement de production, nous recommandons d'utiliser des services web que vous enregistrez en utilisant vos propres informations d'identification. De cette façon, les informations d'identification sont limitées à votre organisation, et vous pouvez traiter directement avec les fournisseurs de services web en cas de pannes.

Visualiser, ajouter et supprimer des services web

Pour afficher les services Web qui sont disponibles dans FME, cliquez sur Gérer les services. La boîte de dialogue Gérer les services Web s'ouvre et présente la liste des services disponibles.

Pour ajouter un service, dans la boîte de dialogue Gérer les services Web, cliquez sur le bouton Ajouter un service Web . Dans la boîte de dépôt, indiquez le protocole d'autorisation utilisé par le service :

  • OAuth 2.0 Service : Le service web utilise la norme OAuth 2.0 pour échanger un code d'autorisation contre un jeton d'accès.
  • Service de jeton : Le service web utilise la norme OAuth 2.0 pour échanger les informations d'identification de l'application contre un jeton d'accès.
  • Service d'authentification HTTP : Le service web utilise une méthode d'authentification HTTP pour accorder l'accès.

Il est possible d'utiliser un service existant comme modèle en sélectionnant Créer à partir de.

Conseil  Pour ajouter un service Web permettant de se connecter à un FME Flow qui autorise en tant qu'utilisateur importé de Microsoft Azure Active Directory, sélectionnez Créer depuis > Microsoft Azure Active Directory (Template).

Le service Web nouvellement ajouté s'ouvre. Dans la liste des services, saisissez un nom pour le service. Ajoutez les paramètres du service, puis cliquez sur Enregistrer.

Conseil  
  • Dans la mesure du possible, créez de nouveaux services à partir de modèles existants en utilisant l'option Créer à partir de. Dans le modèle, cliquez sur les liens sous Liens externes d'Aide pour savoir comment obtenir les informations d'autorisation, telles que l'identifiant et le secret du client. Par exemple, pour créer votre propre service Web Google Drive, cliquez sur le bouton Ajouter un service web et sélectionnez Créer à partir de > Google Drive. Après avoir spécifié un nom et une description de service Web, développez les Liens externes d'Aide et cliquez sur Aide Google Drive pour obtenir des informations sur l'obtention des informations d'identification du service Web Google Drive.
  • Pour les services qui utilisent le service OAuth 2.0 ou le service Token, vous pouvez tester la validité de vos paramètres. Cliquez sur Test ou, dans le cas des services Google, sur Connexion avec Google.

Pour supprimer un service, dans la fenêtre de gestion des services web, sélectionner le service à supprimer et cliquer sur le bouton .

Note  Vous pouvez éditer ou supprimer des services préenregistrés dans FME Form.

Téléchargement de services Web vers FME Flow et mise à jour de services Web existants

Lorsque vous téléchargez un traitement sur FME Flow, et que ce traitement contient une connexion Web, vous pouvez choisir de télécharger la connexion avec traitement. Ce faisant, vous téléchargez également le service Web associé. Toutefois, vous pouvez également télécharger des services Web directement à partir de Connexions Web, ou mettre à jour un service Web précédemment téléchargé.

  1. Cliquez sur Gérer les services.
  2. Dans la boîte de dialogue Gérer les services Web, sélectionnez le service que vous souhaitez charger, puis cliquez sur Chargement. (Il se peut que vous deviez faire défiler l'écran jusqu'au bas du formulaire du service Web pour voir le bouton Chargement).
  3. Dans la fenêtre de téléversement vers FME Flow, spécifier la connexion à FME Flow.
  4. Selon le protocole sur service web (par exemple OAuth 2.0), spécifiez les identifiants correspondants.
  5. Cliquez sur OK.
  6. (Mise à jour uniquement) Si le service Web est déjà téléchargé sur FME Flow, la boîte de dialogue Service web existant s'ouvre. Cliquez sur Oui pour confirmer la mise à jour, ou sur Non pour l'annuler.

Pour plus d'informations sur l'utilisation des services Web et des connexions Web dans FME Flow, voir Connexions Web dans l'aide de l'interface utilisateur web de FME Flow.

Gérer les connexions web

Utiliser la fenêtre de gestion des connexions web.

Ajout de connexion web

Il est généralement plus pratique d'ajouter une connexion Web au moment où vous souhaitez l'utiliser dans un traitement. Cependant, vous pouvez également ajouter une connexion Web directement dans les Options FME, et l'utiliser ultérieurement dans un traitement.

  1. Cliquer sur le bouton Ajouter et sélectionner Ajouter.
  2. Dans la fenêtre Ajouter une connexion web, spécifiez un Service web.
    3. Attention A des fins de production, nous recommandons de spécifier des services web définis par l'utilisateur plutôt que des services pré-enregistrés déjà fournis. Voir Gérer les services web, ci-dessus.

    Si le service web est conforme à la norme OAuth 2.0 et n'est pas encore défini dans FME, une boîte de dialogue Créer un nouveau <service web> s'ouvre pour vous permettre de créer le service de manière dynamique. Pour plus d'informations, voir Gérer les services web, ci-dessus.

  3. Spécifiez un Nom de connexion.

  4. Visibilité : Ce champ ne s'applique que si l'accès à la base de données, tel que spécifié dans Outils > Options FME > Chemins d'accès par défaut, est Partagé. Indiquez si la connexion est disponible uniquement pour vous ou pour tout utilisateur de la base de données (Partagé). Pour plus d'informations, cliquez sur Aide dans la fenêtre Chemins par défaut sous Outils > Options FME.

  5. Spécifiez des paramètres de connexion
  6. Cliquez sur OK.
Note  Les caractères suivants ne sont pas autorisés dans les noms de connexion : ^ \ / : * ? " < > | & = ' + % #

Importer une connexion web.

  • Cliquer sur le bouton Ajouter et sélectionner Importer.

Téléverser une connexion web vers FME Flow

Vous pouvez téléverser une connexion web directement sur FME Flow à partir de la page Connexions web. Cette opération permet également de téléverser une référence au service web associé et de l'alimenter avec les informations d'identification de la connexion web. Cliquez avec le bouton droit de la souris sur la connexion que vous souhaitez télécharger et sélectionnez Chargement.... Le widget Connexion FME Flow s'ouvre. Pour plus d'informations, voir Connexion à FME Flow.

Editer une connexion web

Vous pouvez modifier les paramètres de connexion d'une connexion Web existante. Après la modification, tous les traitements qui utilisent la connexion web utiliseront les nouveaux paramètres pour se connecter.

  • Double clic sur la connexion à éditer.

Supprimer une connexion web.

  • Sélectionner une connexion et cliquer sur le bouton Supprimer .

Modifier l'emplacement d'un fichier de connexion

Vous pouvez modifier l'emplacement où est stocké le fichier de configuration des connexions. Cette modification s'effectue dans l'outil Outils > Options FME > Chemins par défaut.