Accéder au contenu principal Passer au contenu complémentaire
Ressources Qlik
Chargement de la recherche avec SearchUnify Si vous avez besoin d'aide avec votre produit, contactez le Support Qlik.
Qlik Customer Portal
Chargement de la recherche avec SearchUnify Si vous avez besoin d'aide avec votre produit, contactez le Support Qlik.
Qlik Customer Portal

WebHooks dans Talend Management Console

Utilisez les WebHooks pour déclencher des tâches ou des plans de Jobs basés sur les appels d'applications externes.

Lorsque vous utilisez des déclencheurs de WebHook, prenez en compte les précautions de sécurité suivantes :
  • N'incluez pas d'identifiants sensibles à la casse dans la requête de déclenchement de WebHook, car un déclencheur de WebHook ne nécessite pas d'authentification.
  • Maintenez l'URL du WebHook sécurisée, car elle peut être utilisée par n'importe quelle personne afin de déclencher vos tâches.
  • Si l'authentification est requise, utilisez une API au lieu d'un déclencheur de WebHook.

Vous ne pouvez ajouter un WebHook si vous avez déjà d'autres types de déclencheurs. Pour ajouter un WebHook, supprimez des déclenchements existants ou dupliquez la tâche ou le plan si les deux types de déclenchements sont requis.

Paramètres spécifiques au WebHook

Pour utiliser un WebHook, le Job source doit définir le paramètre de contexte resource_webhook_payload. Pour les plans, au moins une tâche de la première étape doit avoir un Job source avec ce paramètre.

Les payloads sont traités comme des tableaux, avec une taille maximale de 5 Ko pour les Jobs Big Data. Les types de payloads supportés sont JSON, XML et plein texte. Pour plus d'informations, consultez Payload de WebHook.

Lorsque vous générez une URL de WebHook dans Talend Management Console, configurez les paramètres suivants :

  • Window threshold (Seuil de la fenêtre) : définit le nombre d'appels de service à regrouper dans une fenêtre de temps.

    Par exemple, si la taille de la fenêtre est 2, au cours du temps configuré dans le paramètre Window threshold (Seuil de la fenêtre), deux payloads consécutifs sont envoyés à l'endpoint du WebHook :

    {"param":"1"}
{"param":"2"}
    Cependant, l'exécution de la tâche ou du plan ne les reçoit pas comme des payloads séparés mais comme un tableau :
    [
{"data":"{"param":"1"}","type":"application/x-www-form-urlencoded"},
{"data":"{"param":"2"}","type":"application/x-www-form-urlencoded"}
]
  • Window duration(in seconds) (Durée de la fenêtre (en secondes) : spécifie l'intervalle de temps (en secondes) pour le regroupement des appels de services.

Le premier événement déclenche l'exécution.

Note InformationsRestriction : Le même plan ou la même tâche peut se trouver un maximum de 50 fois dans la file d'exécution (au statut Pending (En attente) ou Running (En cours d'exécution)) sur une période de 60 minutes. Si vous avez ordonnancé une tâche ou un plan via l'API publique ou via un WebHook afin de l'exécuter un plus grand nombre de fois, chaque nouvelle exécution sera ajoutée à la file après que la limite est atteinte.
Les guillemets doubles dans les payloads de WebHooks ne sont plus échappés. Si certains de vos Jobs utilisent des barres obliques inversées (\) pour les échapper, configurez la propriété suivante dans le fichier de configuration <RemoteEngineInstallation>/etc/org.talend.ipaas.rt.jobserver.client.cfg :
job.ctx.params.passthrough=true

Un appel de WebHook réussi retourne une réponse HTTP 204 (No Content).

Note InformationsImportant : Cas nécessitant une réponse spéciale :
  • Salesforce : Les appels avec des payloads spécifiques à Salesforce (par exemple, contenant des références à soap.sforce.com) répondent par 200 OK au lieu de 204 No Content, même lorsque le corps de la réponse est vide.
  • Dropbox : Lorsque l'en-tête de l'agent utilisateur DropboxWebhooks/1.0 est compris dans la requête, le WebHook répond par 200 OK et inclut la valeur de paramètre challenge dans le corps de la réponse. Par exemple, pour un appel similaire à celui-ci :
    GET https://webhooks.eu.cloud.talend.com/mywebhook/11fe60a514414a2a8b938b29084c4a29?challenge=parameter
           User-Agent: DropboxWebhooks/1.0
    Le corps de la réponse ressemble à ceci :
    Response:
           parameter
           Content-Type: text/plain;charset=UTF-8
           Content-Length: 9

Workflow de déclenchement du WebHook

  1. Configurez le paramètre de contexte du WebHook.

    Vous définissez un paramètre de contexte spécifique, resource_webhook_payload, dans le Job, pour traiter les données entrantes du WebHook.

  2. Générer une URL de WebHook

    Vous générez une URL de WebHook dans Talend Management Console et configurez Window threshold (Seuil de la fenêtre) (nombre d'appels) et Window duration (Durée de la fenêtre) (intervalle de temps en secondes).

  3. Partagez l'URL du WebHook.

    Fournissez l'URL générée du WebHook aux systèmes externes ou aux applications l'utilisant pour envoyer des payloads.

  4. Un système externe appelle l'URL du WebHook.

    Les payloads sont envoyés à l'endpoint de WebHook par les systèmes externes.

  5. Talend Management Console traite les payloads pour les utiliser dans votre Job.

    Les payloads entrants sont parsés et convertis en un tableau conforme au schéma attendu par la variable resource_webhook_payload.

  6. L'exécution de la tâche ou du plan est déclenchée.

    Le WebHook déclenche l'exécution en fonction des paramètres configurés.

  7. L'URl du WebHook retourne une réponse au système externe.

    L'endpoint du WebHook envoie une réponse HTTP 204 No Content ou 200 OK.

Dans cette section

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici