Webhook-Verbindungen testen
Führen Sie die manuellen Tests in diesem Abschnitt durch, um zu überprüfen, ob Ihre Dokument-Webhook-Implementierung ordnungsgemäß funktioniert. Diese Schritte durchlaufen die Adobe Workfront-Web-Oberfläche und treffen indirekt die Endpunkte für Ihre Webhook-Implementierung.
Voraussetzungen
Zum Ausführen der Tests sind folgende Voraussetzungen erforderlich:
-
Ein Workfront-Konto mit aktiviertem Advanced Document Management (ADM)
-
Ein Workfront-Benutzer für dieses Konto mit Systemadministratorrechten
-
Eine Document Webhook-Instanz mit HTTP-Endpunkten, auf die Workfront zugreifen kann
Bei diesen Tests wird außerdem davon ausgegangen, dass Ihre Document Webhook-Instanz registriert ist. (Sie können Ihre Instanz in Workfront unter Einrichtung > Dokumente > Benutzerdefinierte Integrationen registrieren.)
Test 1: Bereitstellung des Document Webhook-Dienstes für einen Benutzer
Testen Sie die Authentifizierungs-URL und die Token-Endpunkt-URL für OAuth-basierte Webhook-Provider.
- Gehen Sie in Workfront zur Hauptseite "Dokumente", indem Sie in der oberen Navigationsleiste auf den Link Dokumente klicken.
- Klicken Sie auf das Dropdown-Menü Dokumente hinzufügen und wählen Sie Ihren Document Webhook-Dienst unter Dienst hinzufügen aus.
- (Nur OAuth-Dienste) Nach Abschluss des vorherigen Schritts wird die OAuth2-Authentifizierungsseite Ihres Dienstes in einem Popup-Fenster geladen. (Hinweis: Sie werden möglicherweise aufgefordert, sich zuerst bei Ihrem Dienst anzumelden.) Gewähren Sie auf der Authentifizierungsseite Workfront Zugriff auf das Benutzerkonto, indem Sie auf die Schaltfläche Vertrauen oder Zulassen klicken.
- Vergewissern Sie sich, dass Ihr Dienst der Dropdown-Liste Dokumente hinzufügen hinzugefügt wurde. Wenn Sie ihn anfangs nicht sehen, versuchen Sie, den Browser zu aktualisieren.
Test 2: Verknüpfen eines Dokuments mit Workfront Tests die folgenden Endpunkte: /files, /metadata
- Gehen Sie in Workfront zur Hauptseite "Dokumente", indem Sie in der oberen Navigationsleiste auf den Link Dokumente klicken.
- Wählen Sie Ihren Document Webhook-Dienst unter Dokumente hinzufügen aus.
- Navigieren Sie vom Modal aus durch die Ordnerstruktur.
- Stellen Sie sicher, dass Sie in der Ordnerstruktur navigieren können.
- Auswählen und Verknüpfen eines Dokuments mit Workfront
Test 3: Navigieren Sie zu einem Dokument im Content Management System.
Testet die folgenden Endpunkte: /metadata (insbesondere viewLink)
- Dokument in Workfront verknüpfen
- Wählen Sie das Dokument aus und klicken Sie auf den Link Öffnen .
- Überprüfen Sie, ob das Dokument in einer neuen Registerkarte geöffnet wird.
Test 4: Navigieren Sie zu einem Dokument im Content Management System (mit Anmeldung).
Testet die folgenden Endpunkte: /metadata (insbesondere viewLink)
- Stellen Sie sicher, dass Sie vom Content Management System abgemeldet wurden.
- Verknüpfen eines Dokuments mit Workfront
- Wählen Sie das Dokument aus und klicken Sie auf den Link Öffnen .
- Vergewissern Sie sich, dass der Anmeldebildschirm des Content Management-Systems in einer neuen Registerkarte geladen wird.
- Melden Sie sich an und vergewissern Sie sich, dass Sie zum Dokument gelangt sind.
Test 5: Laden Sie das Dokument aus dem Content Management System herunter
Testet die folgenden Endpunkte (insbesondere den Download-Link): /metadata
- Verknüpfen eines Dokuments mit Workfront
- Wählen Sie das Dokument aus und klicken Sie auf den Link Herunterladen .
- Vergewissern Sie sich, dass der Download beginnt.
Test 6: Suche nach Inhalt
Testet die folgenden Endpunkte: /search
- Gehen Sie in Workfront zur Hauptseite "Dokumente", indem Sie in der oberen Navigationsleiste auf den Link Dokumente klicken.
- Wählen Sie Ihren Document Webhook-Dienst unter Dokumente hinzufügen aus.
- Führen Sie im Modal eine Suche durch.
- Überprüfen Sie, ob die Suchergebnisse korrekt sind.
Test 7: Versand eines Dokuments von Workfront an das Content Management System
Testet die folgenden Endpunkte: /files, /uploadInit, /upload
- Gehen Sie in Workfront zur Hauptseite "Dokumente", indem Sie in der oberen Navigationsleiste auf den Link Dokumente klicken.
- Hochladen eines Dokuments von Ihrem Computer in Workfront
- Navigieren Sie zur Seite mit den Dokumentdetails .
- Wählen Sie im Dropdown-Menü Dokumentaktionen unter Senden an Ihren Document Webhook-Dienst aus.
- Wechseln Sie zum gewünschten Zielordner und klicken Sie auf die Schaltfläche Speichern .
- Stellen Sie sicher, dass das Dokument an die richtige Stelle im Content Management System hochgeladen wurde.
Test 8: Anzeigen von Miniaturansichten in Workfront
Testet die folgenden Endpunkte: /thumbnail
- Verknüpfen eines Dokuments mit Workfront
- Wählen Sie das Dokument in der Liste aus.
- Stellen Sie sicher, dass die Miniaturansicht im rechten Bereich angezeigt wird.
Test 9: Abrufen der Inhalts-Bytes
Testet die folgenden Endpunkte: /download
- Verknüpfen eines Dokuments mit Workfront
- Rufen Sie die Seite mit den Dokumentdetails auf.
- Senden Sie das Dokument an Workfront, indem Sie "Dokumentaktionen"> "Senden an…"> "Workfront"auswählen. Dadurch wird eine neue Dokumentversion in Workfront erstellt.
- Laden Sie das Dokument von Workfront herunter, indem Sie auf den Link Herunterladen klicken.
Test 10: Zugriffstoken aktualisieren (nur OAuth2 Webhook-Anbieter)
Testet die folgenden Endpunkte: Token-Endpunkt-URL
- Bereitstellen eines Document Webhook-Dienstes für einen Benutzer
- Invalidierung des Zugriffstokens des Benutzers durch 1) Warten auf eine Zeitüberschreitung oder 2) manuelles Invalidieren des Zugriffs-Tokens im externen System.
- Aktualisieren Sie das Zugriffstoken in Workfront. Dazu können Sie beispielsweise ein Dokument mit Workfront verknüpfen. Sie wissen, dass das Zugriffstoken erfolgreich aktualisiert wurde, wenn Sie zu einem Dokument navigieren und es verknüpfen konnten.