Invoquer une API REST pour récupérer les données du trafic routier - Cloud

Guide des connecteurs des applications Talend Cloud

author
Talend Documentation Team
EnrichVersion
Cloud
EnrichProdName
Talend Cloud
task
Administration et monitoring > Gestion des connexions
Création et développement > Création de Pipelines
EnrichPlatform
Talend Pipeline Designer

Ce scénario a pour objectif de vous aider à configurer et à utiliser des connecteurs dans un pipeline. Ce scénario doit être adapté en fonction de votre environnement et de votre cas d'utilisation.

Procédure

  1. Cliquez sur Connections > ADD CONNECTION.
  2. Dans le panneau qui s'ouvre, donnez un nom à votre connexion, ainsi qu'une description, si nécessaire.

    Exemple

    REST
  3. Sélectionnez votre moteur dans la liste Engine.
    Remarque : Si aucun Remote Engine Gen2 n'a été créé depuis Talend Cloud Management Console ou s'il existe mais semble indisponible, ce qui signifie qu'il n'est pas en cours de fonctionnement, vous ne pourrez pas sélectionner de type de connexion (Connection type) dans la liste ou sauvegarder la nouvelle connexion. Les types de connexion disponibles dépendent du moteur sélectionné.
  4. Sélectionnez le type de connexion à créer.
    Sélectionnez REST.
  5. Renseignez les propriétés de la connexion et l'URL du serveur REST à invoquer, comme décrit dans Propriétés REST. Vérifiez la connexion et cliquez sur Add dataset. Dans cet exemple, le service https://opendata.paris.fr/api/records/1.0/ listant les données librement accessibles est invoqué.
  6. Dans le panneau Add a new dataset, nommez votre jeu de données. Le connecteur REST retourne un JSON avec une entrée de corps parsé.

    Exemple

    Paris road traffic
  7. Renseignez les propriétés requises pour invoquer le service et cliquez sur VIEW SAMPLE pour voir un aperçu de l'échantillon de données :
    1. Dans le champ Type, sélectionnez Batch, comme vous ne souhaitez invoquer le service qu'une seule fois.
    2. Dans le champ Resource, saisissez search.
    3. Sélectionnez GET dans la liste HTTP method.
    4. Dans le champ Answer body format, sélectionnez Text.
    5. Activez l'option Set URL parameter et ajoutez les paramètres de requête : dataset (paramètre) et referentiel-comptages-routiers (valeur).
  8. Cliquez sur VALIDATE pour sauvegarder votre jeu de données.
  9. Répétez l'opération pour ajouter le jeu de données Test à utiliser comme destination dans votre pipeline pour recevoir des logs. Renseignez les propriétés de la connexion comme décrit dans Tester les propriétés de la connexion.
  10. Cliquez sur ADD PIPELINE dans la page Pipelines. Votre nouveau pipeline s’ouvre.
  11. Donnez-lui un nom significatif.

    Exemple

    From Http Rest to Log output - invoke & process
  12. Cliquez sur ADD SOURCE et sélectionnez votre jeu de données source, Paris road traffic dans le panneau qui s'ouvre.
  13. Cliquez sur l'élément ADD DESTINATION dans le pipeline pour ouvrir le panneau vous permettant de sélectionner le jeu de données de sortie dans lequel vos logs de sortie seront stockés.
  14. Dans l'onglet Configuration de la destination, activez l'option Log records to STDOUT afin de capturer les logs dans cette destination de sortie.
  15. Cliquez sur SAVE pour sauvegarder votre configuration.
  16. Dans la barre d'outils en haut de Talend Cloud Pipeline Designer, sélectionnez votre profil d'exécution dans la liste (pour plus d'informations, consultez Run profiles).
  17. Cliquez sur l'icône d'exécution pour exécuter votre pipeline.

Résultats

Votre pipeline est en cours d'exécution. Les données invoquées depuis le service de l'API REST ont été traitées et les logs de sortie sont stockés dans le jeu de données cible défini.