Connecter Adobe Workfront Fusion à un service web qui utilise l’autorisation par jeton API

Certains services ne permettent pas aux solutions d’intégration telles qu’Adobe Workfront Fusion de créer une application que vous pouvez facilement utiliser dans votre scénario.

La solution à ce problème consiste à connecter le service souhaité (application) à Workfront Fusion à l’aide du module HTTP > Effectuer une requête .

Cet article explique comment connecter presque n’importe quel service web à Workfront Fusion à l’aide d’une clé API/d’un jeton API.

Conditions d’accès

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Package Adobe Workfront Tous
Licence Adobe Workfront

Nouveau : Standard

Ou

Actuellement : Travail ou licence supérieure

Licence Adobe Workfront Fusion **

Actuel : aucune exigence de licence Workfront Fusion

Ou

Héritée : n’importe laquelle.

Produit

Nouveau :

  • Sélectionnez ou Prime Workfront Plan : votre entreprise doit acheter Adobe Workfront Fusion.
  • Plan Ultimate Workfront : Workfront Fusion est inclus.

Ou

Actuel : votre entreprise doit acheter Adobe Workfront Fusion.

Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.

Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.

Se connecter à un service web qui utilise un jeton d’API

La procédure de connexion du service via un jeton d’API est similaire pour la plupart des services web.

  1. Créez une application sur le site web du service web comme expliqué dans la section Créer une application et obtenir le jeton d’API de cet article.
  2. Obtenez la clé d’API ou le jeton d’API.
  3. Ajoutez le module HTTP > Make a Request de Workfront Fusion à votre scénario.
  4. Configurez le module en fonction de la documentation de l’API du service web et de l’exécution du scénario, comme expliqué dans la section Configurer le module HTTP de cet article.
NOTE
Cet exemple se connecte au service de notification push.

Créer une application et obtenir le jeton d’API

NOTE
Les services web peuvent créer et distribuer des clés d’API ou des jetons d’API de nombreuses manières. Pour obtenir des instructions sur l’obtention d’une clé et d’un jeton d’API pour le service web souhaité, rendez-vous sur le site web du service et recherchez « Clé d’API » ou « Jeton d’API ».
Nous incluons des instructions pour l’obtention d’une clé d’API Pushover uniquement à titre d’exemple de ce que vous pourriez trouver.
  1. Connectez-vous à votre compte Pushover.
  2. Cliquez sur Créer une application/un jeton d’API au bas de la page.
  3. Renseignez les informations de l’application et cliquez sur Créer une application.
  4. Stockez le jeton d’API fourni dans un endroit sûr. Vous en aurez besoin pour le HTTP Workfront Fusion > Effectuer une requête pour vous connecter au service web souhaité (Pushover, dans ce cas).

Configuration du module HTTP

Pour connecter un service web à votre scénario Workfront Fusion, vous devez utiliser HTTP > Créer un module de requête dans le scénario et configurer le module en fonction de la documentation de l’API du service web.

  1. Ajoutez le module HTTP > Make a Request à votre scénario.

  2. Pour envoyer un message push à l’aide de Workfront Fusion, configurez le module HTTP comme suit.

    note note
    NOTE
    Ces paramètres de module correspondent à la documentation de l’API du service web Pushover. Les paramètres peuvent être différents pour d’autres services web. Par exemple, le jeton API peut être inséré dans l’en-tête et non dans le champ Corps .
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    URL

    https://api.pushover.net/1/messages.json

    Le champ URL contient le point d’entrée que vous trouverez dans la documentation de l’API du service web.

    Méthode

    POST

    La méthode utilisée dépend du point d’entrée correspondant. Le point d’entrée de Pushover pour la publication de messages utilise la méthode POST.

    En-têtes Certains services web peuvent utiliser des en-têtes pour spécifier l’authentification par jeton API ou d’autres paramètres. Ce n’est pas le cas dans notre exemple, car le point d’entrée de Pushover pour la publication de messages utilise Body (voir ci-dessous) pour tous les types de requêtes.
    Chaîne de requête Certains services web peuvent utiliser une chaîne de requête pour spécifier d’autres paramètres. Ce n’est pas le cas dans notre exemple, car le service web Pushover utilise Body (voir ci-dessous) pour tous les types de requête.
    Type de corps

    Raw

    Ce paramètre vous permet de sélectionner le type de contenu JSON dans le champ Type de contenu ci-dessous.

    Type de contenu

    JSON (application/json)

    JSON est le type de contenu requis par l’application Pushover. Cela peut différer des autres services web.

    Demander le contenu

    Saisissez le contenu de la demande de corps au format JSON. Vous pouvez utiliser le module JSON > Créer JSON comme expliqué dans Mapper le corps JSON à l’aide du module JSON > Créer JSON dans cet article. Vous pouvez également saisir le contenu JSON manuellement, comme expliqué dans Saisir manuellement le corps du fichier JSON dans cet article.

    Consultez la documentation de l’API du service web pour connaître les paramètres requis pour ce service web.

Saisir le corps JSON manuellement

Spécifiez les paramètres et les valeurs au format JSON.

recommendation-more-help

Exemple :

{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}

Cet exemple comprend les informations suivantes.

utilisateur
Votre USER_KEY. Vous pouvez le trouver dans votre tableau de bord de notification push.
jeton
Votre jeton API/clé API qui a été généré vous avez créé votre application push.
message
Contenu texte de la notification push envoyée à l’appareil ou aux appareils.
title
(Facultatif) Titre de votre message. Si aucune valeur n’est saisie, le nom de votre application est utilisé.

Mappez le corps JSON à l’aide du module JSON > Create JSON .

Le module Créer JSON facilite la spécification du JSON. Il vous donne également la possibilité de définir des valeurs de manière dynamique.

Pour plus d’informations sur les modules JSON, voir Modules JSON.

  1. Saisissez ou mappez les valeurs à partir desquelles vous souhaitez créer JSON.

    Valeurs JSON

  2. Connectez le module JSON > Créer un module JSON au module HTTP > Effectuer une requête .

  3. Mappez la chaîne JSON du module Créer JSON au champ Contenu de la requête dans le HTTP > Effectuer une requête .

Lorsque vous exécutez le scénario, la notification push est envoyée à l’appareil qui a été enregistré dans votre compte Pushover.

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3