Webhook

Un webhook è una chiamata HTTP attivata da un evento. Puoi utilizzare i webhook per attivare moduli di attivazione istantanea. Qualsiasi applicazione connessa a Internet e che consenta le richieste HTTP può inviare webhook ad Adobe Workfront Fusion.

Requisiti di accesso

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

*Per conoscere il piano, il tipo di licenza o l'accesso di cui si dispone, contattare l'amministratore Workfront.

**Per informazioni su Adobe Workfront Fusion licenze, consulta Adobe Workfront Fusion licenze

Utilizzare un webhook in Workfront Fusion

Per utilizzare un webhook per connettere un’app a Workfront Fusion:

Dopo aver creato un webhook, viene visualizzato un URL univoco. Questo è l’indirizzo a cui il webhook invia i dati. Workfront Fusion convalida i dati inviati a questo indirizzo, quindi li trasmette per l’elaborazione nello scenario.

Configurare la struttura dati del webhook configure-the-webhook-s-data-structure

Al fine di riconoscere la struttura dati del payload in ingresso, Workfront Fusion analizza i dati di esempio inviati all'indirizzo visualizzato. Puoi fornire i dati di esempio apportando una modifica al servizio o all’app che farà sì che il servizio o l’app chiamino il webhook. Ad esempio, puoi rimuovere un file.

Oppure puoi seguire i passaggi seguenti per inviare i dati di esempio tramite il HTTP > Fai una richiesta modulo.

Coda

Se un webhook riceve dati e non esiste uno scenario attivo che preveda tali dati, questi vengono memorizzati nella coda. Una volta attivato lo scenario, elabora in sequenza tutti i bundle in attesa nella coda.

Formati di dati in arrivo supportati

Workfront Fusion supporta 3 formati di dati in arrivo: Stringa di query, Dati modulo e JSON.

Workfront Fusion convalida tutti i dati in arrivo in base alla struttura dati selezionata. Quindi, a seconda delle impostazioni dello scenario, i dati vengono memorizzati nella coda per l’elaborazione o vengono elaborati immediatamente.

Se una parte qualsiasi dei dati non supera la convalida, Workfront Fusion restituisce un codice di stato HTTP 400 e specifica, nel corpo della risposta HTTP, il motivo per cui i controlli di convalida dei dati in arrivo non sono riusciti. Se la convalida dei dati in arrivo ha esito positivo, Workfront Fusion restituisce un "200 accettati".

Stringa di query

GET https://app.workfrontfusion.com/wh/<yourunique32characterslongstring>?name=<yourname>&job=automate

Dati modulo

POST https://app.workfrontfusion.com/wh/<yourunique32characterslongstring>

Content-Type: application/x-www-form-urlencoded

name=<yourname>&job=automate

Dati modulo multipart

POST https://app.workfrontfusion.com/wh/<yourunique32characterslongstring>


Content-Type: multipart/form-data; boundary=---generatedboundary

---generatedboundary

Content-Disposition: form-data; name="file"; filename="file.txt"


Content-Type: text/plain


Content of file.txt


---generatedboundary

Content-Disposition: form-data; name="name"

Workfront Fusion

---generatedboundary

Per ricevere i file codificati con multipart/form-data, è necessario configurare una struttura dati con collection campo di tipo contenente i campi nidificati name, mime, e data. Il campo name è un text e contiene il nome del file caricato. Il mime è un text e contiene un file in formato MIME. Il campo data è un buffer e contiene dati binari per il file da trasferire.

Per ulteriori informazioni sul formato MIME, vedi Moduli MIME.

JSON

POST https://app.workfrontfusion.com/wh/<yourunique32characterslongstring>

Content-Type: application/json

{"name": "Workfront Fusion", "job": "automate"}

Intestazioni webhook

Per accedere alle intestazioni del webhook, abilita Ottieni intestazioni di richiesta durante la configurazione del webhook.

Puoi estrarre un particolare valore di intestazione con la combinazione di map() e get() funzioni.

INFO

Esempio:

L’esempio seguente mostra una formula che estrae il valore del authorization intestazione da Headers[] array. La formula viene utilizzata in un filtro che confronta il valore estratto con il testo specificato per trasmettere solo i webhook in caso di corrispondenza.

Per ulteriori informazioni su come ottenere un elemento di un array con una determinata chiave, consulta Mappare l’elemento di un array con una determinata chiave nell’articolo Mappare le informazioni da un modulo all’altro in Adobe Workfront Fusion.

Risposta ai webhook

La risposta predefinita a una chiamata al webhook è il testo "Accepted" (Accettato). La risposta viene restituita all’app che ha chiamato il webhook durante l’esecuzione del modulo Webhook personalizzato.

Verificare la risposta a un webhook

Se desideri personalizzare la risposta del webhook, utilizza il modulo Risposta del webhook.

La configurazione del modulo contiene due campi: Stato e Corpo.

Il timeout per l’invio di una risposta è di 40 secondi. Se la risposta non è disponibile entro tale periodo, Workfront Fusion restituisce lo stato "200 Accepted" (Accettato).

Esempio di risposta HTML

INFO

Esempio:

Configurare Risposta webhook come segue:

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Stato	Codice di stato HTTP 2xx, ad esempio 200
Body	Codice HTML
Intestazioni personalizzate	> > Chiave: tipo di contenuto > Valore: testo/html >

In questo modo viene generata una risposta di HTML che viene visualizzata in un browser web:

Esempio di reindirizzamento

INFO

Esempio: Configurare Risposta webhook come segue:

table 0-row-2 1-row-2 layout-auto html-authored no-header
Stato	Codice di stato HTTP del reindirizzamento 3xx, ad esempio 303
Intestazioni personalizzate	> > Key: Posizione > Valore : URL a cui desideri reindirizzare. >

Disattivazione webhook

I webhook vengono disattivati automaticamente se si applica una delle seguenti condizioni:

I webhook disattivati vengono eliminati e annullati automaticamente se non sono connessi ad alcun scenario e se sono in stato disattivato da oltre 30 giorni.

Risoluzione dei problemi

Elementi mancanti nel pannello di mappatura

Se nel pannello di mappatura mancano alcuni elementi nella configurazione dei moduli che seguono Webhook > Webhook personalizzato , fai clic sul pulsante Webhook > Webhook personalizzato per aprire la relativa configurazione e fare clic su Rideterminare la struttura dei dati:

Quindi segui i passaggi descritti nella sezione Configurare la struttura dati del webhook in questo articolo.