Tester les connexions de webhook
Pour vérifier que votre implémentation de Document Webhook fonctionne correctement, exécutez les tests manuels de cette section. Ces étapes passent par l’interface web d’Adobe Workfront et accèdent indirectement aux points d’entrée de votre implémentation webhook.
Conditions préalables
Les conditions préalables suivantes sont requises pour exécuter les tests :
-
Un compte Workfront avec la gestion avancée des documents (ADM) activée.
-
Un utilisateur ou une utilisatrice Workfront pour ce compte disposant des droits d’administration système.
-
Une instance de Document Webhook avec des points d’entrée HTTP accessibles par Workfront.
Ces tests supposent également que votre instance Document Webhook est enregistrée. (Vous pouvez enregistrer votre instance dans Workfront dans Configuration > Documents > Intégrations personnalisées.)
Test 1 : mettre en place le service Document Webhook pour un utilisateur ou une utilisatrice
Teste l’URL d’authentification et l’URL du point d’entrée du jeton pour les fournisseurs de webhooks basés sur OAuth.
- Dans Workfront, accédez à la page principale des documents en cliquant sur le lien Documents dans la barre de navigation supérieure.
- Cliquez sur le menu déroulant Ajouter des documents et sélectionnez votre service Document Webhook dans Ajouter un service.
- (Services OAuth uniquement) Après avoir effectué l’étape précédente, vous verrez la page d’authentification OAuth2 de votre service s’afficher dans une fenêtre contextuelle. (Remarque : il se peut que vous receviez d’abord une invitation à vous connecter à votre service.) Sur la page d’authentification, accordez à Workfront l’accès au compte de l’utilisateur ou de l’utilisatrice en cliquant sur le bouton Approuver ou autoriser.
- Vérifiez que votre service a été ajouté au menu déroulant Ajouter des documents. Si en premier lieu vous ne le voyez pas, essayez d’actualiser votre navigateur.
Test 2 : lier un document dans Workfront Teste les points d’entrée suivants : /files, /metadata.
- Dans Workfront, accédez à la page principale des documents en cliquant sur le lien Documents dans la barre de navigation supérieure.
- Sélectionnez votre service Document Webhook dans Ajouter des documents.
- Dans la fenêtre modale, naviguez dans la structure des dossiers.
- Vérifiez que vous pouvez naviguer dans la structure des dossiers.
- Sélectionner et lier un document dans Workfront
Test 3 : naviguer jusqu’à un document dans le système de gestion de contenu
Teste les points d’entrée suivants : /metadata (en particulier le viewLink).
- Lier un document dans Workfront
- Sélectionnez le document et cliquez sur le lien Ouvrir.
- Vérifiez que le document s’ouvre dans un nouvel onglet.
Test 4 : naviguer jusqu’à un document dans le système de gestion de contenu (avec une connexion active)
Teste les points d’entrée suivants : /metadata (en particulier le viewLink).
- Vérifiez que votre connexion au système de gestion de contenu n’est pas effective.
- Liez un document dans Workfront.
- Sélectionnez le document et cliquez sur le lien Ouvrir.
- Vérifiez que l’écran de connexion du système de gestion de contenu se charge dans un nouvel onglet.
- Connectez-vous et vérifiez que cela vous dirige bien vers le document.
Test 5 : télécharger le document à partir du système de gestion de contenu
Teste les points d’entrée suivants (en particulier le lien de téléchargement) : /metadata.
- Liez un document dans Workfront.
- Sélectionnez le document et cliquez sur le lien Télécharger.
- Vérifiez que le téléchargement commence.
Test 6 : rechercher du contenu
Teste les points d’entrée suivants : /search.
- Dans Workfront, accédez à la page principale des documents en cliquant sur le lien Documents dans la barre de navigation supérieure.
- Sélectionnez votre service Document Webhook dans Ajouter des documents.
- Dans la fenêtre modale, effectuez une recherche.
- Vérifiez que les résultats de la recherche sont corrects.
Test 7 : envoyer un document à partir de Workfront vers un système de gestion de contenu
Teste les points d’entrée suivants : /files, /uploadInit, /upload.
- Dans Workfront, accédez à la page principale des documents en cliquant sur le lien Documents dans la barre de navigation supérieure.
- Chargez un document dans Workfront à partir de votre ordinateur.
- Accédez à la page des détails du document.
- Dans le menu déroulant Actions du document, sélectionnez votre service Document Webhook dans Envoyer à…
- Accédez au dossier de destination souhaité et cliquez sur le bouton Enregistrer.
- Vérifiez que le document est chargé au bon endroit dans le système de gestion de contenu.
Test 8 : afficher les vignettes dans Workfront
Teste les points d’entrée suivants : /thumbnail.
- Liez un document dans Workfront.
- Sélectionnez le document dans la liste.
- Vérifiez que la vignette apparaît dans le panneau de droite.
Test 9 : obtenir les octets du contenu
Teste les points d’entrée suivants : /download.
- Liez un document dans Workfront.
- Accédez à la page des détails du document.
- Envoyez le document à Workfront en sélectionnant Actions du document > Envoyer à… > Workfront. Cela crée une nouvelle version du document dans Workfront.
- Téléchargez le document à partir de Workfront en cliquant sur le lien Télécharger.
Test 10 : actualiser le jeton d’accès (fournisseurs de webhooks OAuth2 uniquement)
Teste les points d’entrée suivants : URL du point d’entrée de jeton.
- Mettre à disposition un service Document Webhook pour un utilisateur ou une utilisatrice
- Invalidez le jeton d’accès de l’utilisateur ou de l’utilisatrice soit 1) en attendant que le délai d’expiration soit écoulé, soit 2) en l’invalidant manuellement dans le système externe.
- Actualisez le jeton d’accès dans Workfront. Vous pouvez le faire, par exemple, en liant un document dans Workfront. Vous savez que le jeton d’accès a été actualisé si vous avez été en mesure de naviguer jusqu’à un document et le lier.