Connettere Adobe Workfront Fusion a un servizio web che utilizza l’autorizzazione del token API

Alcuni servizi non consentono alle soluzioni di integrazione, come Adobe Workfront Fusion, di creare un’app che puoi facilmente utilizzare nel tuo scenario.

Per ovviare a questa situazione, è necessario collegare il servizio desiderato (app) a Workfront Fusion tramite il modulo HTTP > Crea una richiesta.

Questo articolo spiega come connettere quasi tutti i servizi web a Workfront Fusion utilizzando un token API/chiave.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità in questo articolo.

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront Qualsiasi
Licenza Adobe Workfront

Nuovo: Standard

Oppure

Corrente: Lavoro o versione successiva

Licenza Adobe Workfront Fusion**

Corrente: nessun requisito di licenza Workfront Fusion.

Oppure

Legacy: qualsiasi

Prodotto

Nuovo:

  • Selezionare o Prime Workfront Plan: l'organizzazione deve acquistare Adobe Workfront Fusion.
  • Piano Ultimate Workfront: Workfront Fusion è incluso.

Oppure

Corrente: la tua organizzazione deve acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, vedere Requisiti di accesso nella documentazione.

Per informazioni sulle licenze di Adobe Workfront Fusion, vedere Licenze di Adobe Workfront Fusion.

Connettersi a un servizio Web che utilizza un token API

La procedura di connessione del servizio tramite un token API è simile per la maggior parte dei servizi web.

  1. Creare un'applicazione nel sito Web del servizio Web, come descritto nella sezione Creare una nuova applicazione e ottenere il token API in questo articolo.
  2. Ottieni la chiave API o il token API.
  3. Aggiungi HTTP di Workfront Fusion > Crea un modulo di richiesta al tuo scenario.
  4. Configurare il modulo in base alla documentazione API del servizio Web ed eseguire lo scenario, come descritto nella sezione Configurare il modulo HTTP in questo articolo.
NOTE
Questo esempio si connette al servizio di notifica push.

Creare una nuova applicazione e ottenere il token API

NOTE
Esistono molti modi diversi in cui i servizi web creano e distribuiscono chiavi API o token API. Per istruzioni su come ottenere una chiave API e un token per il servizio web desiderato, visita il sito web del servizio e cerca "Chiave API" o "Token API".
Stiamo includendo istruzioni per ottenere una chiave API push solo come esempio di ciò che potresti trovare.
  1. Accedi al tuo account Pushover.
  2. Fai clic su Crea un token di applicazione/API nella parte inferiore della pagina.
  3. Compila le informazioni sull'applicazione e fai clic su Crea un'applicazione.
  4. Memorizza il token API fornito in un luogo sicuro. Sarà necessaria per Workfront Fusion HTTP > Creare un modulo di richiesta per connettersi al servizio web desiderato (in questo caso, Pushover).

Configurare il modulo HTTP

Per collegare un servizio web allo scenario Workfront Fusion, devi utilizzare HTTP > Creare un modulo di richiesta nello scenario e configurarlo in base alla documentazione API del servizio web.

  1. Aggiungi HTTP > Crea un modulo di richiesta allo scenario.

  2. Per inviare un messaggio push tramite Workfront Fusion, imposta il modulo HTTP come segue.

    note note
    NOTE
    Queste impostazioni del modulo corrispondono alla documentazione API del servizio web push. Le impostazioni possono essere diverse per altri servizi web. Ad esempio, il token API può essere inserito nell’intestazione e non nel campo Corpo.
    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

    Il campo URL contiene l’endpoint che puoi trovare nella documentazione API del servizio web.

    Metodo

    POST

    Il metodo utilizzato dipende dall’endpoint corrispondente. L’endpoint Pushover per la trasmissione dei messaggi utilizza il metodo POST.

    Intestazioni Alcuni servizi web possono utilizzare le intestazioni per specificare l’autenticazione del token API o altri parametri. Questo non avviene nel nostro esempio, poiché l’endpoint di push dei messaggi utilizza il corpo (vedi sotto) per tutti i tipi di richiesta.
    Stringa di query Alcuni servizi web possono utilizzare una stringa di query per specificare altri parametri. Questo non è il caso nel nostro esempio, in quanto il servizio web push utilizza Body (vedi sotto) per tutti i tipi di richiesta.
    Tipo di corpo

    Raw

    Questa impostazione consente di selezionare il tipo di contenuto JSON nel campo Tipo di contenuto sottostante.

    Tipo di contenuto

    JSON (application/json)

    JSON è il tipo di contenuto richiesto dall’app push. Questo può differire da altri servizi web.

    Richiedi contenuto

    Immetti il contenuto della richiesta Body in formato JSON. Puoi utilizzare il modulo JSON > Crea JSON come spiegato in Mappare il corpo del JSON utilizzando il modulo JSON > Crea JSON in questo articolo. Oppure puoi immettere il contenuto JSON manualmente, come spiegato in Inserisci il corpo JSON manualmente in questo articolo.

    Per informazioni sui parametri richiesti per il servizio Web, consulta la documentazione API del servizio Web.

Inserisci manualmente il corpo del codice JSON

Specifica parametri e valori nel formato JSON.

recommendation-more-help

Esempio:

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

Questo esempio include le seguenti informazioni.

utente
USER_KEY. Questo si trova nel dashboard di Pushover.
token
Il token API/chiave API generato ha creato l'app Pushover.
messaggio
Il contenuto testuale della notifica push inviata ai dispositivi.
titolo
(Facoltativo) Titolo del messaggio. Se non viene immesso alcun valore, viene utilizzato il nome dell’app.

Mappa il corpo del JSON utilizzando il modulo JSON > Crea JSON

Il modulo Crea JSON semplifica la specifica di JSON. Consente inoltre di definire i valori in modo dinamico.

Per ulteriori informazioni sui moduli JSON, vedi Moduli JSON.

  1. Immetti o mappa i valori da cui desideri creare il JSON.

    Valori JSON

  2. Connetti il modulo JSON > Crea JSON al modulo HTTP > Crea richiesta.

  3. Mappa la stringa JSON dal modulo Crea JSON al campo Contenuto richiesta in HTTP > Crea un modulo di richiesta.

Quando esegui lo scenario, la notifica push viene inviata al dispositivo registrato nel tuo account Pushover.

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