Konfigurieren von Workfront mit Adobe Experience Manager Legacy-Connector
Als Adobe Workfront können Sie Workfront mit Adobe Experience Manager (AEM) Assets integrieren und Ihrem Unternehmen eine umfassende Content-Management-Lösung für die Erstellung, Freigabe und Wartung von Assets in Ihrem Workflow bereitstellen.
Zugriffsanforderungen
Sie müssen über folgenden Zugriff verfügen, um die Schritte in diesem Artikel ausführen zu können:
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront Plan | Beliebig |
| Adobe Workfront Lizenz |
Neu: Standard Oder Aktuell: Plan |
| Konfigurationen der Zugriffsebene | Systemadministrator |
Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation zu Workfront.
Workfront for AEM Assets
Die Workfront for AEM Assets connector ermöglicht Ihrem Unternehmen Folgendes:
-
Zusammenarbeit und Verwaltung kreativer Inhalte durch Verknüpfen von AEM-Assets und -Ordnern mit Projekten, Aufgaben, Problemen und Anfragen in Workfront.
Weitere Informationen zum Konfigurieren von Dokumentationsintegrationen mit Anwendungen von Drittanbietern finden Sie unter Konfigurieren von Dokumentintegrationen.
-
Integration mit dem AEM Digital Asset Management (DAM)-Repository, sodass Sie Workfront verwenden können, um im DAM gespeicherte digitale Assets zu verwalten und freizugeben.
Weitere Informationen zum Verknüpfen von Dokumenten und Asset-Ordnern finden Sie unter Verknüpfen von Dokumenten aus externen Anwendungen.
-
Kombinieren und Anwenden von Metadaten aus beiden Programmen auf ein Asset.
-
Anzeigen eines umfassenden Kommunikations-Streams für ein Asset Aktualisierungen und Kommentare, die in Workfront oder AEM Assets an einem Asset vorgenommen wurden, werden mit dem anderen Programm synchronisiert, wodurch ein umfassender Verlauf der an dem Asset vorgenommenen Kommunikationen erstellt wird.
Weitere Informationen zum Erstellen von Kommentaren in Workfront finden Sie unter Hinzufügen einer Aktualisierung zu einem Dokument.
Voraussetzungen für die Installation des AEM Assets Connectors
Stellen Sie vor der Installation des Workfront-Connectors für AEM Assets sicher, dass die folgenden Voraussetzungen erfüllt sind:
- AEM Assets ist installiert und konfiguriert, Version 6.5 oder höher. Informationen zur Installation von AEM Assets finden Sie unter Adobe Experience Manager Dokumentation.
- (Bedingt) Wenn Ihre Firewall-Regeln Traffic nicht wie erwartet zulassen, fügen Sie die IP-Adresse und/oder Domain Ihres Clusters zu Ihrer Zulassungsliste hinzu. Weitere Informationen finden Sie Zulassungsliste zum Konfigurieren der Firewall.
Installieren des Workfront for AEM Assets Connector-Pakets install-the-workfront-for-aem-assets-connector-package
Um den Workfront for AEM Assets-Connector zu installieren, müssen Sie den Connector mit dem CRX Package Manager} als Paket in AEM .
-
Laden Sie auf einer Workstation, auf der Sie AEM bereits installiert haben, die Installationsdatei für den Workfront for AEM Assets Connector herunter.
Sie können den Workfront for AEM Assets-Connector von Ihrem Workfront abrufen.
-
Melden Sie sich mit einem Administratorkonto bei AEM an.
-
Klicken Sie Tools > Bereitstellung > Pakete. Der CRX Package Manager wird geöffnet.
-
Klicken Sie Paket hochladen.
-
Suchen Sie im Dialogfeld Paket hochladen nach dem Paket Workfront Connector und wählen Sie es aus. Klicken Sie dann auf OK. Das Paket wird im CRX Package Manager angezeigt.
-
Klicken Sie auf Installieren.
-
Ignorieren Sie im Dialogfeld Paket die erweiterten Einstellungen und klicken Sie auf Installieren.
-
(Optional) Um zu bestätigen, dass der Connector erfolgreich installiert wurde, stellen Sie sicher, dass im Aktivitätsprotokoll“ die folgende Anweisung angezeigt :
code language-none Package installed in <time> -
Schließen Sie den CRX Package Manager. Der Connector ist installiert, und Sie können AEM Assets jetzt für die Integration mit Workfront konfigurieren.
-
Fahren Sie mit Konfigurieren AEM Assets fort, um mit zu Workfront.
Konfigurieren von AEM Assets für die Integration mit Workfront configure-aem-assets-to-integrate-with-workfront
Importieren Sie nach der Installation des Connectors das Connector-Paket in AEM und konfigurieren Sie AEM so, dass es eine Verknüpfung mit Dokumenten in Workfront herstellt.
Informationen zur Installation des Connectors finden Sie unter Installieren des Workfront for AEM Assets -Connector-Pakets.
Voraussetzungen prerequisites
Bevor Sie beginnen, müssen Sie Berechtigungen für den Workfront-Service aktivieren:
- Navigieren Sie in AEM zu Tools > Sicherheit > Berechtigungen.
- Wählen Sie oben links im Dropdown-Menü Benutzer aus und geben Sie Workfront-Service in das Feld Suche . Wählen Sie den Workfront-Service-Benutzer aus.
- Klicken Sie auf der rechten Seite des Bildschirms auf ACE hinzufügen, um neue Einträge zu erstellen.
- Aktivieren Sie im Fenster Neuen Eintrag hinzufügen das Kontrollkästchen-Symbol im Feld Pfad und wählen Sie den Ordner aus: /conf
- Geben Sie Feld Folgendes ein: jcr:read
- Klicken Sie oben rechts auf Hinzufügen.
- (Optional) Wiederholen Sie die obigen Schritte, um weitere Einträge zu erstellen.
Integrieren von AEM mit Workfront integrate-aem-with-workfront
-
Melden Sie sich bei AEM Assets als Administrator an.
-
Klicken Sie auf Tools > Cloud Services > Workfront-Integrationskonfiguration > Global-Workfront.
-
(Bedingt) Wenn Sie dies noch nicht getan haben, erstellen Sie eine Workfront Cloud-Konfigurationsdatei:
-
Klicken Sie oben rechts auf der Global-Workfront auf Erstellen.
-
Geben Sie im Feld Workfront URL die URL für Ihre Workfront an.
Beispiel: https://
<account>.my.workfront.com, wobei<account>das Konto ist, das Sie für Integrationen mit AEM verwenden. -
Aktivieren Sie Feld Basisordner das Kontrollkästchen-Symbol.
-
Wählen Sie im Dropdown-Menü den Pfad aus, unter dem mit Workfront Objekten verknüpfte Dokumente gespeichert werden.
-
Folgen Sie im angezeigten AEM-Modal dem Pfad zum Ordner mit den Dokumenten, die mit Workfront Objekten verbunden sind. Wählen Sie den Ordner aus und drücken Auswählen in der oberen rechten Ecke.
Sie können eine Verknüpfung zu einem beliebigen Ordner unter dem Stammverzeichnis /content/dam/ herstellen.
-
Geben Sie im Feld Workfront API-Schlüssel Ihren Workfront-API-Schlüssel an.
So rufen Sie Ihren Workfront-API-Schlüssel ab:
- Öffnen Sie eine Browser-Registerkarte und melden Sie sich als Workfront bei Ihrem Workfront an.
-
-
Klicken Sie auf das Hauptmenü-Symbol
-
Klicken Sie System > Kundeninformationen.
Wenn Sie bereits einen API-Schlüssel generiert haben, wird Ihr Workfront-API-Schlüssel unter der Bezeichnung Der API-Schlüssel Benutzers“ angezeigt.
-
(Bedingt) Wenn Sie noch keinen API-Schlüssel generiert haben, müssen Sie einen generieren:
-
Stellen Sie im Abschnitt API Schlüsseleinstellungen“ sicher, dass die Option Nach der Erstellung laufen die API-Schlüssel in ab auf Keine gesetzt ist.
Wenn Sie einen Gültigkeitszeitraum auswählen, funktioniert der Connector nach Ablauf des API-Schlüssels nicht mehr. Sie müssen dann einen API-Schlüssel neu generieren und Ihre Workfront-Konfiguration aktualisieren.
-
Klicken unter der Beschriftung „API-Schlüssel Ihres Benutzers auf API-Schlüssel generieren. Ein API-Schlüssel für Workfront generiert und zeigt ihn an.
-
-
Kopieren Sie den API-Schlüssel in die Zwischenablage.
-
Öffnen Sie die Browser-Registerkarte für AEM Connector und fügen Sie den kopierten API-Schlüssel in das Workfront API Key ein.
-
(Bedingt) Klicken Sie auf die Erweitert in der oberen linken Ecke der Seite Workfront-Integrationskonfiguration und wählen Sie die folgenden Optionen aus, falls zutreffend:
Durchsuchen von Sammlungen zulassen: Wählen Sie Option aus, wenn Ihr Unternehmen Workfront Benutzern erlaubt, AEM Assets-Sammlungen mit Workfront Objekten zu verknüpfen.
Benutzer Federated ID: Wählen Sie diese Option aus, wenn Ihr Unternehmen Federated IDs oder Single Sign-On (SSO) bei der Anmeldung bei Workfront verwendet.
E-Mail-Domain ignorieren: Wählen Sie diese Option, wenn AEM-Benutzer den Domain-Namen nicht in ihrer Benutzer-ID verwenden.
Zugriff beschränken: Wählen Sie diese Option, um die entsprechenden Workfront IP-Adressen anzugeben, die der Zulassungsliste hinzugefügt werden müssen. Weitere Informationen über die Zulassungsliste finden Sie Zulassungsliste zur Firewall konfigurieren.
-
Klicken Sie oben links auf der Seite Workfront-Integrationskonfiguration auf die Registerkarte Standard und dann auf Verbinden.
note note NOTE Es kann einige Zeit dauern, bis die Änderungen angewendet werden. Ein Neustart des Bundles kann den Prozess beschleunigen.
-
-
(Bedingt) Wenn Sie bereits eine Workfront Cloud-Konfigurationsdatei erstellt haben, wählen Sie global-Workfront aus und klicken Sie dann links oben auf Eigenschaften.
-
Generieren Sie den AEM-API-Schlüssel, indem Generate Key klicken den AEM-API-Schlüssel in die Zwischenablage kopieren.
Sie benötigen den AEM-API-Schlüssel später, wenn Sie Workfront für die Integration mit AEM Assets konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Workfront für die Integration mit AEM Assets.
-
Klicken Sie oben rechts auf Speichern. Das Fenster Global-Workfront" wird angezeigt.
-
(Optional) Synchronisieren Sie die bidirektionale Kommunikation zwischen AEM und Workfront:
-
Klicken Sie auf global-Workfront.
-
Klicken Sie oben links im Fenster auf Eigenschaften. Die Seite Workfront-Integrationskonfiguration wird angezeigt.
-
(Optional) Um die Synchronisierung von Kommentaren zwischen AEM Assets und Workfront zu aktivieren, klicken Sie auf Kommentarsynchronisierung aktivieren.
note important IMPORTANT Sie müssen "" aktivieren um die Assets zu synchronisieren. -
(Optional) Um die Kommentarsynchronisierung zu deaktivieren, klicken Sie auf Kommentarsynchronisierung deaktivieren.
Oder
Löschen Sie das NOTE CREATE-Ereignisabonnement, das bei Ihrer AEM-Instanz registriert ist.
Informationen zu Ereignisabonnements finden Sie unter Ereignisabonnement-API.
-
-
Fahren Sie fort mit Konfigurieren des AEM Externalizer.
Konfigurieren Sie den AEM Externalizer configure-the-aem-externalizer
Mit dem AEM Externalizer kann AEM URLs in einem Format übergeben, das in Workfront verwendet werden kann. Wenn Workfront nicht richtig konfiguriert sind, können Sie die AEM-API nicht aufrufen, und die URLs, die AEM-Dokumente in Workfront verknüpfen, funktionieren nicht.
-
Klicken Sie in AEM auf Tools > Vorgänge > Web-Konsole.
-
Klicken Sie OSGI und dann Dropdown-Menü auf Konfiguration“.
-
Wählen Sie in der Konfigurationsliste /CQ Link Externalizer . Die Seite Externalizer wird angezeigt.
-
Stellen Sie im Abschnitt Domains sicher, dass die im Feld author aufgeführte Domain der Domain-Name ist, auf den AEM-Benutzer extern zugreifen können.
Der Domain-Name im Feld author sollte mit der Domain übereinstimmen, die in der URL-Zeile Ihrer AEM-Instanz aufgeführt ist.
-
(Bedingt) Aktualisieren Sie bei Bedarf die Domain im Feld Autor.
-
Klicken Sie auf Speichern. AEM Assets ist jetzt so konfiguriert, dass Dokumente mit Workfront verknüpft werden.
-
Fahren Sie mit Konfigurieren Workfront fort, um mit zu AEM assets.
Konfigurieren von Workfront für die Integration mit AEM assets configure-workfront-to-integrate-with-aem-assets
Nach der Installation des Connectors für WorkfrontAEM Assets (wie unter Installieren des Connector-Pakets für Workfront für AEM Assets beschrieben) und der Konfiguration von AEM Assets (wie unter Konfigurieren AEM Assets für die Integration mit Workfront beschrieben) müssen Sie Workfront konfigurieren, um Dokumente zwischen Workfront und AEM Assets zu verknüpfen.
-
Melden Sie sich bei Workfront als Administrator an.
note tip TIP Workfront empfiehlt, einen Workfront-Administrator zu erstellen, der ausschließlich Ihrer AEM-Integration dient. Weitere Informationen zum Zuweisen der Admin-Zugriffsebene Workfront zu einem Benutzer finden Sie unter Gewähren von administrativem Zugriff für Benutzer auf bestimmte Bereiche. -
Klicken Sie auf das Hauptmenü-Symbol
-
Klicken Sie auf Dokumente > Benutzerdefinierte Integration.
-
Klicken Sie Benutzerdefinierte Integration hinzufügen.
-
Geben in das Feld den Namen der benutzerdefinierten Integration ein.
Dies ist der Name, den Benutzer sehen, wenn sie die Integration in Workfront verwenden.
-
Geben Sie in das Feld Basis API-URL die URL für Ihre AEM-Instanz ein.
Die Basis-API-URL besteht aus der URL für Ihre AEM-Instanz, gefolgt vom Pfad: /bin/webhooks/api/
-
Wählen Sie im Dropdown Menü Authentifizierungstyp“ die Option APIkey.
-
Fügen Sie im Feld API- den AEM-API-Schlüssel ein, den Sie bei der Konfiguration von AEM Assets kopiert .
-
Klicken Sie auf Speichern.
-
(Optional) Stellen Sie sicher, dass die Integration mit Aktiv markiert ist.
Workfront ist jetzt für die Verwendung mit AEM Assets konfiguriert.
Um auf Assets in AEM zugreifen zu können, muss jeder Workfront, der den Connector verwenden muss, in AEM als Benutzer eingerichtet sein. Informationen zum Erstellen von Benutzern finden Sie unter Einrichten von Benutzern für die Verwendung des Connectors.
Einrichten von Benutzern für die Verwendung des Connectors set-up-users-to-use-the-connector
Damit Benutzer auf den Connector zugreifen können, müssen sie über ein Benutzerprofil in AEM verfügen und zu einer Workfront gehören, die über Zugriffsebenen mit den Berechtigungen Erstellen und Löschen verfügt.
Weitere Informationen zu Workfront finden Sie unter Erstellen oder Ändern benutzerdefinierter Zugriffsebenen.
Einrichten von Benutzern in AEM assets set-up-users-in-aem-assets
-
Melden Sie sich bei AEM Assets als Workfront-Administrator an.
-
Klicken Sie Tools > security > users.
-
(Bedingt) Wenn der/die Benutzende in AEM kein Benutzerprofil hat, erstellen Sie ein AEM-Benutzerprofil.
-
Klicken Sie Benutzer erstellen.
-
Geben Sie die persönlichen Informationen des Benutzers ein.
Das einzige erforderliche Feld ist das ID-Feld. Die AEM-ID des Benutzers muss mit seiner Workfront-ID übereinstimmen, d. h. mit seiner Workfront-E-Mail-Adresse.
Wenn Sie die Option E-Mail-Domain ignorieren ausgewählt haben, als Sie AEM für die Integration mit Workfront konfiguriert haben, stimmt die AEM-ID nicht mit der Workfront E-Mail-Adresse überein.
-
-
(Bedingt) Wenn der/die Benutzende über ein AEM-Profil verfügt, öffnen Sie das AEM-Profil des/r Benutzenden:
-
click user. Die Benutzerverwaltung wird angezeigt.
-
Klicken Sie auf den Benutzer, den Sie hinzufügen möchten, und dann auf Eigenschaften. Die Seite mit den Benutzereinstellungen wird angezeigt.
-
-
Klicken Sie auf Registerkarte Gruppen“.
-
Stellen Sie sicher, dass der Benutzer zu mindestens einer Workfront gehört, die über Zugriffsebenen verfügt, die die Berechtigungen Erstellen und Löschen beinhalten.
-
Um den Benutzer einer vorhandenen Gruppe hinzuzufügen, geben Sie den Gruppennamen in das Feld Gruppennamen eingeben und wählen Sie dann die Gruppe aus, wenn sie im Dropdown-Menü angezeigt wird.
Oder
Um eine Gruppe auszuwählen, der der Benutzer angehört, wählen Sie eine Gruppe im Abschnitt Gruppen, denen dieser Benutzer angehört aus.
-
-
Klicken Sie Speichern.