DocumentationWorkfrontGuide Workfront

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

Last update: Tue Sep 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

Certains services n’autorisent pas les solutions d’intégration telles qu’Adobe Workfront Fusion pour créer une application que vous pouvez facilement utiliser dans votre scénario.

Il existe une solution à cette situation. Vous pouvez connecter le service souhaité (application) à Workfront Fusion à l’aide du module HTTP de Workfront Fusion.

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

Conditions d’accès

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

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Conditions requises du produit actuel : si vous disposez de la formule Adobe Workfront Select ou Prime, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.

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 à votre scénario le module HTTP > Effectuer une requête de Workfront Fusion.
  4. Configurez le module conformément à la documentation de l’API du service web et exécutez le scénario comme expliqué dans la section Configurer le module HTTPde cet article.
NOTE
Nous utiliserons le service de notification Pushover comme exemple tout au long de cet article.

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 module HTTP >Effectuer une requête de Workfront Fusion afin de vous connecter au service web souhaité (Pushover dans ce cas).

Configurer le module HTTP

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

  1. Ajoutez à votre scénario le module HTTP >Effectuer une requête.

  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 de service web Pushover. Les paramètres peuvent être différents pour d’autres services web. Par exemple, le jeton d’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.
    Method

    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.
    Headers 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.
    Query String 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 puisque le service web Pushover utilise Body (voir ci-dessous) pour tous les types de requêtes.
    Body Type

    Raw

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

    JSON (application/json)

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

    Saisissez le contenu de la requête Body au format JSON. Vous pouvez utiliser le module JSON > Create JSON comme expliqué dans la section Corps JSON mappé à l’aide du module JSON > Create JSON dans cet article. Vous pouvez également saisir le contenu JSON manuellement, tel qu’expliqué à la section Corps JSON saisi manuellement dans cet article.

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

Corps JSON saisi manuellement

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

INFO
Exemple :
code language-none 
{"user":"12345c2ecu1hq42ypqzhswbyam34",
"token":"123459evz8aepwtxydndydgyumbfx",
"message":"Hello World!",
"title":"The Push Notification"}
user
Votre USER_KEY. Vous pouvez le trouver dans votre tableau de bord Pushover.
token
Votre jeton API/clé API généré lorsque vous avez créé votre application Pushover.
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é.

Corps JSON mappé à l’aide du module JSON >Créer JSON

Le module Créer JSON facilite la spécification de 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.

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

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

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

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43