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 di Workfront.

**Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze

Utilizza 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

Per 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 modulo HTTP > Fai una richiesta.

La coda del webhook

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 ingresso: Stringa 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 dati in arrivo non hanno superato i controlli di convalida. Se la convalida dei dati in arrivo viene eseguita correttamente, Workfront Fusion restituirà lo stato "200 Accepted".

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 di dati con un campo di tipo collection contenente i campi nidificati name, mime e data. Il campo name è di tipo text e contiene il nome del file caricato. mime è un tipo text e contiene un file in formato MIME. Il campo data è di tipo buffer e contiene dati binari per il file da trasferire.

Per ulteriori informazioni sul formato MIME, vedere 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.

È possibile 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 dell'intestazione authorization dall'array Headers[]. 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, vedere 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:

Configura il modulo 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: text/html >

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

Esempio di reindirizzamento

INFO

Esempio: Configura il modulo 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: Location > Value: l'URL a cui si desidera 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 il modulo Webhook > Webhook personalizzato, fai clic sul modulo Webhook > Webhook personalizzato per aprirne la configurazione e fai clic su Ridetermina la struttura dati:

Segui quindi i passaggi descritti nella sezione Configurare la struttura dati del webhook in questo articolo.