Verificare le connessioni del webhook
Creato per:
- Sviluppatore
Per verificare il corretto funzionamento dell’implementazione del webhook del documento, esegui i test manuali descritti in questa sezione. Questi passaggi passano attraverso l’interfaccia web di Adobe Workfront e indirettamente raggiungono gli endpoint per l’implementazione del webhook.
Prerequisiti
Per eseguire i test sono necessari i seguenti prerequisiti:
-
Un account Workfront con Advanced Document Management (ADM) abilitato
-
Un utente Workfront per questo account con diritti di amministratore di sistema
-
Un'istanza del webhook del documento con endpoint HTTP accessibili a Workfront
Questi test presuppongono inoltre che l’istanza del webhook del documento sia registrata. (Puoi registrare la tua istanza in Workfront in Configurazione > Documenti > Integrazioni personalizzate).
Test 1: provisioning del servizio Document Webhook per un utente
Verifica l’URL di autenticazione e l’URL dell’endpoint del token per i provider Webhook basati su OAuth.
- In Workfront, passare alla pagina principale Documenti facendo clic sul collegamento Documenti nella barra di navigazione superiore.
- Fai clic sul menu a discesa Aggiungi documenti e seleziona il servizio Document Webhook in Aggiungi servizio.
- (Solo per i servizi OAuth) Dopo aver completato il passaggio precedente, visualizzerai la pagina di autenticazione OAuth2 del servizio in una finestra a comparsa. (Nota: potrebbe essere richiesto di accedere prima al servizio.) Dalla pagina di autenticazione, concedi a Workfront l’accesso all’account dell’utente facendo clic sul pulsante Considera attendibili o Consenti.
- Verifica che il servizio sia stato aggiunto al menu a discesa Aggiungi documenti. Se inizialmente non è visibile, prova ad aggiornare il browser.
Test 2: collegare un documento in Workfront Test i seguenti endpoint: /files, /metadata
- In Workfront, passare alla pagina principale Documenti facendo clic sul collegamento Documenti nella barra di navigazione superiore.
- Selezionare il servizio Web Document in Aggiungi documenti.
- Dalla finestra modale, passa alla struttura delle cartelle.
- Verifica di essere in grado di navigare nella struttura di cartelle.
- Selezionare un documento e collegarlo a Workfront
Prova 3: passare a un documento nel sistema di gestione dei contenuti
Verifica i seguenti endpoint: /metadata (in particolare viewLink)
- Collegare un documento a Workfront
- Selezionare il documento e fare clic sul collegamento Apri.
- Verificate che il documento venga aperto in una nuova scheda.
Prova 4: passare a un documento nel sistema di gestione dei contenuti (con accesso)
Verifica i seguenti endpoint: /metadata (in particolare viewLink)
- Assicurarsi di essere disconnessi dal sistema di gestione dei contenuti.
- Collegare un documento a Workfront.
- Selezionare il documento e fare clic sul collegamento Apri.
- Verificare che la schermata di accesso del sistema di gestione dei contenuti venga caricata in una nuova scheda.
- Accedi e verifica di essere reindirizzato al documento
Test 5: scaricare il documento dal sistema di gestione dei contenuti
Verifica i seguenti endpoint (in particolare il collegamento di download): /metadata
- Collegare un documento a Workfront.
- Selezionare il documento e fare clic sul collegamento Scarica.
- Verifica l’inizio del download.
Prova 6: ricerca contenuto
Verifica i seguenti endpoint: /search
- In Workfront, passare alla pagina principale Documenti facendo clic sul collegamento Documenti nella barra di navigazione superiore.
- Selezionare il servizio Web Document in Aggiungi documenti.
- Dal modale, esegui una ricerca.
- Verifica che i risultati della ricerca siano corretti.
Prova 7: invia documento da Workfront a Content Management System
Verifica i seguenti endpoint: /files, /uploadInit, /upload
- In Workfront, passare alla pagina principale Documenti facendo clic sul collegamento Documenti nella barra di navigazione superiore.
- Carica un documento in Workfront dal computer
- Vai alla pagina dei dettagli del documento
- Dal menu a discesa Azioni documento, selezionare il servizio Web Document in Invia a…
- Vai alla cartella di destinazione desiderata e fai clic sul pulsante Salva.
- Verificare che il documento sia caricato nella posizione corretta nel sistema di gestione dei contenuti.
Test 8: visualizzazione miniature in Workfront
Verifica i seguenti endpoint: /thumbnail
- Collegare un documento a Workfront.
- Seleziona il documento nell’elenco.
- Verifica che la miniatura venga visualizzata nel pannello di destra.
Prova 9: ottieni i byte di contenuto
Verifica i seguenti endpoint: /download
- Collegare un documento a Workfront.
- Passare alla pagina dei dettagli del documento.
- Inviare il documento a Workfront selezionando Azioni documento > Invia a… > Workfront. Verrà creata una nuova versione del documento in Workfront.
- Scaricare il documento da Workfront facendo clic sul collegamento Scarica.
Prova 10: aggiorna token di accesso (solo provider del webhook OAuth2)
Verifica i seguenti endpoint: URL endpoint token
- Eseguire il provisioning di un servizio Web Document per un utente
- Annulla la validità del token di accesso dell’utente 1 )in attesa del timeout oppure 2) annullandolo manualmente nel sistema esterno.
- Aggiorna il token di accesso in Workfront. A tale scopo, ad esempio, è possibile collegare un documento in Workfront. Se sei riuscito a passare a un documento e a collegarlo, saprai che il token di accesso è stato aggiornato correttamente.
NOTE