Accéder au contenu principal Passer au contenu complémentaire

Définir un paramètre de Webhook dans Studio Talend

Vous pouvez définir un paramètre de contexte de WebHook dans un Job, pour permettre à l'utilisateur ou l'utilisatrice Web de générer des URL uniques de tâches depuis Talend Management Console. Ces URL permettent à des applications externes (Salesforce, Box, Dropbox, entre autres) de déclencher l'exécution d'une tâche lorsqu'une modification de données survient.

Avant de commencer

Le Job doit être ouvert dans le Studio Talend et la vue Context (Contexte), sous l'espace de modélisation graphique, doit être sélectionnée.

Pourquoi et quand exécuter cette tâche

Par exemple, le Job suivant récupère les contacts depuis Salesforce. Vous devez déclencher l'exécution de la tâche à chaque fois que les contacts Salesforce sont mis à jour.
Job dans l'espace de modélisation graphique.

Procédure

  1. Dans l'espace de modélisation graphique du Studio Talend, cliquez sur la vue Context (Contexte).

    Si la vue Context (Contexte) ne s'affiche pas dans le Studio Talend, cliquez sur Window (Fenêtre) > Show view (Afficher la vue) > Talend et sélectionnez Context (Contexte).

  2. Cliquez sur le bouton [+] dans la vue Context (Contexte) pour ajouter une ligne à la table.

    Exemple

    Vue Context (Contexte).
  3. Définissez le paramètre de contexte du WebHook en suivant le format resource_webhook_payload, en minuscules.
  4. Configurez le type du paramètre à String.
  5. Saisissez la valeur du paramètre du WebHook.
    Les WebHooks doivent être définis au format JSON, où :
    • type : type de médias du payload provenant de l'en-tête Content-Type, par exemple, application/json.
    • data : données du payload
    Les types de payload suivants sont supportés :
    • application/xml
    • application/json
    • text/plain
    • text/xml
    • Les appels de l'endpoint du WebHook avec un payload vide sont valides et supportés.
    Exemple :
    [ { "type": "text/plain;charset=UTF-8", "data": "Some Data" }, { "type": "application/xml", "data": "<SomeXml/>" } ]
    L'exemple ci-dessus n'affiche pas la structure originale de la requête envoyée au WebHook. En revanche, il présente le schéma vers lequel Talend Management Console convertit les données entrantes, comme la variable resource_webhook_payload nécessite ce format.
    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
  6. Cliquez-droit sur le Job dans la vue Repository et sélectionnez Publish to Cloud.

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.