DokumentationAEM 6.5Benutzerhandbuch

Konfigurieren von Workfront for Experience Manager enhanced connector assets-integration-overview

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Admin
Version
Artikel-Link
AEM as a Cloud Service
Hier klicken
AEM 6.5
Dieser Artikel

Ein Benutzer mit Adminzugriff in Adobe Experience Manager konfiguriert den erweiterten Connector nach der Installation. Anweisungen zur Installation finden Sie unter Installieren des Connectors.

IMPORTANT

  • Adobe erfordert die Bereitstellung und Konfiguration des Adobe Workfront for Experience Manager enhanced connector nur über zertifizierte Partner oder Adobe Professional Services. Wird diese ohne zertifizierten Partner oder Adobe Professional Services bereitgestellt oder konfiguriert, wird sie von Adobe nicht unterstützt.

  • Adobe veröffentlicht möglicherweise Aktualisierungen für Adobe Workfront und Adobe Experience Manager, die diesen Connector redundant machen. In diesem Fall kann es erforderlich sein, dass Kunden diesen Connector nicht mehr verwenden.

  • Adobe unterstützt die Versionen 1.7.4 und höher des erweiterten Connectors. Frühere Vorabversionen und benutzerdefinierte Versionen werden nicht unterstützt. Um die Version des erweiterten Connectors zu überprüfen, gehen Sie zu der Gruppe digital.hoodoo, die im linken Fensterbereich des Package Managers verfügbar ist.

  • Siehe Partnerzertifizierungsprüfung für den erweiterten Connector von Workfront for Experience Manager Assets. Informationen zur Prüfung finden Sie im Prüfungshandbuch.

Konfigurieren von Ereignisabonnements event-subscriptions

Ereignisabonnements werden verwendet, um AEM über Ereignisse zu informieren, die in Adobe Workfront stattfinden. Es gibt drei Workfront for Experience Manager enhanced connector-Funktionen, die Ereignisabonnements benötigen, um zu funktionieren, und zwar:

  • Automatische Erstellung von projektgebundenen Ordnern.
  • Synchronisierung von Änderungen in benutzerdefinierten Formularwerten in Workfront-Dokumenten mit AEM Asset-Metadaten.
  • Automatische Veröffentlichung von Assets in Brand Portal nach Abschluss des Projekts.

Um diese Funktionen nutzen zu können, müssen Sie die Ereignisabonnements aktivieren.

  • Bearbeiten Sie die Cloud Services-Konfiguration Workfront-Tools, die Sie in Schritt 5 erstellt haben, und wählen Sie die Registerkarte Ereignisabonnements.

  • Wählen Sie die benutzerdefinierte Workfront-Integration aus, die Sie in Abschnitt 6 erstellt haben.

  • Klicken Sie auf Workfront-Ereignisabonnements aktivieren.

    Ereignisabonnement

Konfigurieren von verknüpften Ordnern linked-folders

Gehen Sie wie folgt vor, um die Ereignisse zu abonnieren:

  1. Navigieren Sie zur Registerkarte Ereignisabonnements in den Cloud-Services.
  2. Wählen Sie die in Workfront erstellte benutzerdefinierte Integration aus.
  3. Klicken Sie auf Workfront-Ereignisabonnements aktivieren.

Konfiguration der verknüpften Ordnerstruktur linked-folder-structure

  1. Gehen Sie in den Cloud-Services zur Registerkarte „Projektverknüpfte Ordner“.
  2. Übergeordneter Pfad des verknüpften Ordners: Wählen Sie einen Ordner im DAM aus, in dem Sie die verknüpften Ordner erstellen möchten. Wenn Sie das Feld leer lassen, wird standardmäßig /content/dam verwendet. Stellen Sie sicher, dass das Metadatenschema für Workfront-Tools und das Metadatenschema für Workfront-Ordner mit verknüpften Ordnern auf den ausgewählten Ordner angewendet wurden.
  3. Verknüpfte Ordnerstruktur: Geben Sie durch Kommas getrennte Werte ein. Jeder Wert sollte DE:<some-project-custom-form-field>, Portfolio, Programm, Jahr, Name oder ein „literaler Zeichenfolgenwert“ sein (letzteres in Anführungszeichen). Er ist derzeit auf Portfolio,Programm,Jahr,DE:Projekttyp,Name festgelegt.
  4. Konfigurieren der Berechtigungen: Fügen Sie Berechtigungen jcr:all permissions zu /conf/workfront-tools/settings/cloudconfigs für die Gruppe wf-workfront-users hinzu.
  5. Das Kontrollkästchen „Verknüpfte Ordnertitel in Workfront unter Verwendung der Namen der Ordnerstruktur erstellen“ sollte aktiviert werden, wenn der Titel des Ordners in Workfront alle Ordner in der Struktur enthalten soll. Andernfalls ist es der Titel des letzten Ordners.
  6. Im Mehrfachfeld „Unterordner“ können Sie eine Liste von Ordnern angeben, die als Unterordner des verknüpften Ordners erstellt werden sollen.
  7. Projektstatus: Wählen Sie den Status des Projekts aus, um den verknüpften Ordner zu erstellen.
  8. Erstellen eines verknüpften Ordners in Projekten mit Portfolio: Liste der Portfolios, denen das Projekt angehören muss, um den verknüpften Ordner erstellen zu können. Lassen Sie diese Liste leer, wenn der verknüpfte Ordner für alle Projektportfolios erstellt werden soll.
  9. Erstellen eines verknüpften Ordners in Projekten mit benutzerdefiniertem Formularfeld: Das benutzerdefinierte Formularfeld und sein entsprechender Wert, den das Projekt haben muss, damit der verknüpfte Ordner erstellt werden kann. Diese Konfiguration wird ignoriert, wenn sie leer gelassen wird. Wählen Sie CUSTOM FORMS: Create DAM Linked Folder als Feld und geben Sie Yes als Wert ein.
  10. Klicken Sie auf „Automatische Erstellung verknüpfter Ordner aktivieren“. Wenn Sie zur Registerkarte „Ereignisabonnements“ zurückkehren, sehen Sie, dass es jetzt ein Erstellungsereignis gibt.

Konfiguration verknüpfter Ordner

Metadatenschema-Zuordnung metadata-schema-mapping

Konfigurieren der Ordner-Metadatenzuordnung folder-metadata-mapping

Die Metadaten-Zuordnung zwischen Workfront-Projekten und AEM-Ordnern wird in AEM-Ordner-Metadatenschemata definiert. Ordner-Metadatenschemata sollten wie gewohnt in AEM erstellt und konfiguriert werden. Workfront Tools fügt für jedes Metadatenschema-Formularfeld ein Dropdown-Menü mit automatischer Vervollständigung zu dessen Registerkarte „Einstellungen“ hinzu. In diesem Dropdown-Menü mit automatischer Vervollständigung können Sie angeben, welchem Workfront-Feld jede AEM-Ordnereigenschaft zugeordnet werden soll.

Gehen Sie wie folgt vor, um die Zuordnungen zu konfigurieren:

  1. Fügen Sie jcr:read-Berechtigungen zu /conf/global/settings/dam/adminui-extension/foldermetadataschema für die Gruppe wf-workfront-users hinzu.

  2. Navigieren Sie zu Tools > Assets > Ordner-Metadatenschemata.

  3. Wählen Sie das Formular für das Ordner-Metadatenschema, das Sie bearbeiten möchten, und klicken Sie auf „Bearbeiten“.

  4. Wählen Sie das Formularfeld des Ordner-Metadatenschemas aus, das Sie bearbeiten möchten, und klicken Sie im rechten Bedienfeld auf die Registerkarte „Einstellungen“.

  5. Wählen Sie im Feld Aus Workfront-Feld zugeordnet den Namen des Workfront-Felds aus, das Sie der ausgewählten AEM-Ordnereigenschaft zuordnen möchten. Verfügbare Optionen sind:

    • Benutzerdefinierte Formularfelder für Projekte
    • Felder mit Projektübersicht (ID, Name, Beschreibung, Referenznummer, Geplantes Abschlussdatum, Projektinhaber, Projekt-Sponsor, Portfolio oder Programm)

Konfiguration der Metadatenzuordnung

Konfigurieren der Asset-Metadatenzuordnung asset-metadata-mapping

Die Zuordnung von Metadaten zwischen Adobe Workfront-Dokumenten und Assets wird in AEM-Metadatenschemata definiert. Metadatenschemata sollten wie gewohnt in AEM erstellt und konfiguriert werden. Workfront Tools fügt für jedes Metadatenschema-Formularfeld Konfigurationsoptionen zu dessen Registerkarte „Einstellungen“ hinzu. Mit diesen Optionen können Sie angeben, welchen Workfront-Feldern die einzelnen AEM-Eigenschaften zugeordnet werden sollen.

Gehen Sie wie folgt vor, um die Zuordnungen zu konfigurieren:

  1. Navigieren Sie zu Tools > Assets > Metadatenschemata.

  2. Wählen Sie das Metadatenschema-Formular aus, das Sie bearbeiten möchten, und klicken Sie auf Bearbeiten oder erstellen Sie ein neues Metadatenschema von Grund auf.

  3. Wählen Sie das Metadatenschema-Formularfeld aus, das Sie bearbeiten möchten, und wählen Sie die Registerkarte Einstellungen im rechten Bedienfeld.

  4. Wählen Sie in Workfront unter „Benutzerdefiniertes Formularfeld“ den Namen des Workfront-Feldes, das Sie der ausgewählten AEM-Eigenschaft zuordnen möchten. Verfügbare Optionen sind:

    • Benutzerdefinierte Formularfelder für Dokumente
    • Benutzerdefinierte Formularfelder für Projekte
    • Benutzerdefinierte Formularfelder für Probleme
    • Benutzerdefinierte Formularfelder für Aufgaben
    • Felder zur Projektübersicht (ID, Name, Beschreibung oder Referenznummer)

  5. Wenn das als Benutzerdefiniertes Workfront-Formularfeld ausgewählte Workfront-Feld ein Workfront-Benutzerfeld mit Eingabepuffer ist, müssen Sie angeben, welches Workfront-Benutzerfeld Sie zuordnen möchten. Aktivieren Sie dazu die Option „Wert aus dem von Workfront referenzierten Objektfeld abrufen“ und geben Sie dann den Namen des benutzerdefinierten Workfront-Formularfelds an, von dem der zuzuordnende Wert abgerufen werden soll.

    Konfiguration der Metadatenzuordnung

Zuordnungseigenschaft map-property

Mit diesem Workflow-Schritt kann ein Benutzer eine Eigenschaft einem benutzerdefinierten Workfront-Formular für ein Projekt, eine Aufgabe, ein Problem oder ein Dokument zuordnen. Das Workfront-Artefakt, auf das sich dieser Schritt auswirkt, wird mithilfe eines relativen Pfads aus der Payload nachgeschlagen. Die Eigenschaften, die zugeordnet werden sollen, werden in der Konfiguration des Schrittdialogfelds gesteuert.

Typ: In diesem Feld können Sie den Typ des Workfront-Objekts auswählen, dem die Eigenschaften zugeordnet werden sollen.

ID-Eigenschaft: In diesem Feld können Sie den Pfad zur ID des Workfront-Objekts angeben, dem die Eigenschaften zugeordnet werden sollen. Der in diesem Feld angegebene Pfad sollte relativ zur Payload des Workflows sein.

Eigenschaftszuweisungen: In diesem Mehrfachfeld können Sie die Zuordnungen zwischen AEM-Eigenschaften und Workfront-Feldern festlegen. Jedes Element im Mehrfachfeld gibt eine Zuordnung an. Jede Zuordnung sollte das Format <workfront-field>=<aem-mapped-property> haben.

  • Beim workfront-field kann es sich handeln um:

    • Ein benutzerdefiniertes Formularfeld, das durch das Präfix DE: identifiziert wird.
    • Ein editierbares Feld, das durch seinen Namen identifiziert wird. Die Feldnamen finden Sie unter Workfront API-Explorer.

  • aem-mapped-property kann sein:

    • Ein literaler Wert. Diese sollten von Anführungszeichen umgeben sein.
    • Eine AEM-Eigenschaft. Diese Referenz sollte relativ zur Payload des Workflows sein.
    • Ein benannter Wert. Diese sollten von Klammern umgeben sein.
    • Eine Verkettung der drei oben genannten Elemente. Geben Sie dies mithilfe von {+} an.
    • Eine Abwandlung der drei oben genannten Elemente, indem der Wert mit {replace(<value>,"old-char","new-char")} umschlossen wird.

  • Einige Beispiele:

    • status="INP"
    • DE:Asset Type=jcr:content/metadata/assetType
    • DE:Path={path}
    • URL="https://my-aem-author/assets.html"{+}{path}

Konfiguration für Zuordnungseigenschaft

Festlegen des Status set-status

Bearbeiten Sie im Workflow-Editor die Eigenschaften von Workfront - Status festlegen auf der Registerkarte Argumente.

Workflow bearbeiten, um Status festzulegen

Kommentarsynchronisierung comments-sync

  1. Gehen Sie in Experience Manager zu Tools > Cloud Services > Konfiguration der Workfront-Tools, wählen Sie die Konfiguration aus und wählen Sie dann Eigenschaften.

    Kommentarsynchronisierung

  2. Wählen Sie die Registerkarte Ereignis-Abonnements und klicken Sie auf Kommentarsynchronisierung aktivieren unter der Option Kommentare aus Workfront an AEM senden.

    Synchronisierung ist aktiviert

Gehen Sie wie folgt vor, um die Synchronisierung von Kommentaren von Workfront nach AEM zu testen:

  1. Navigieren Sie zu einem verknüpften Dokument in Workfront und fügen Sie auf der Registerkarte „Aktualisierungen“ einen Kommentar hinzu.

    Kommentar in Workfront hinterlassen

  2. Gehen Sie zum selben verknüpften Dokument in AEM, wählen Sie das Dokument aus und öffnen Sie die Option Zeitleiste in der linken Navigation und wählen Sie dann Kommentare aus. In der linken Seitenleiste werden die Kommentare angezeigt, die aus Workfront synchronisiert wurden.

Asset-Versionen asset-versions

Um den Versionsverlauf von Assets in AEM beizubehalten, konfigurieren Sie die Asset-Versionierung in AEM.

  1. Gehen Sie in Experience Manager zu Tools > Cloud Services > Konfiguration der Workfront-Tools und öffnen Sie die Registerkarte Erweitert.

  2. Wählen Sie die Option Assets mit demselben Namen wie Versionen des vorhandenen Assets speichern. Wenn diese Option aktiviert ist, können Sie Assets speichern, die mit demselben Namen und demselben Speicherort wie die Version des vorhandenen Assets hochgeladen wurden. Wenn diese Option deaktiviert ist, wird ein neues Asset mit einem anderen Namen erstellt (z. B. asset-name.pdf und asset-name-1.pdf).

  3. Wählen Sie die Option Asset-Metadaten beim Erstellen einer Version aktualisieren. Wenn diese Option aktiviert ist, werden die Asset-Metadaten bei jeder Erstellung einer neuen Version des Assets aktualisiert. Wenn diese Option deaktiviert ist, behält das Asset die Metadaten bei, die es vor dem Erstellen der neuen Version hatte.

Asset-Versionierung konfigurieren

NOTE
Die Versionierung wird in verknüpften Ordnern nicht unterstützt. Beim Erstellen eines Workfront-Korrekturabzugs mit einem Dokument innerhalb eines verknüpften Ordners werden die Kommentare und Anmerkungen zur vorherigen Version des Assets entfernt.

Anhängen benutzerdefinierter Formulare attach-custom-forms

Mit diesem Workflow-Schritt können Benutzer ein benutzerdefiniertes Formular an ein Workfront-Artefakt anhängen. Dieser Workflow-Schritt kann zu jedem Workflow-Modell hinzugefügt werden. Das Workfront-Artefakt, das von diesem Schritt beeinflusst wird, wird mithilfe eines relativen Pfads aus der Payload nachgeschlagen.

Bearbeiten Sie im Workflow-Editor in Experience Manager die Eigenschaften des Workflow-Schritt Workfront - Benutzerdefiniertes Formular anhängen.

benutzerdefinierte Formulare .

Automatisches Veröffentlichen von Assets auto-publish-assets

  1. Gehen Sie in Experience Manager zu Tools > Cloud Services > Konfiguration der Workfront-Tools und öffnen Sie die Registerkarte Erweitert.

  2. Wählen Sie Assets, die aus Workfront gesendet werden, automatisch veröffentlichen. Diese Option ermöglicht die automatische Veröffentlichung von Assets, wenn sie von Workfront an AEM gesendet werden. Diese Funktion kann bedingt aktiviert werden, indem ein benutzerdefiniertes Workfront-Formularfeld und der Wert angegeben werden, auf den es eingestellt werden soll. Wenn ein Dokument an AEM gesendet wird und die Bedingung erfüllt, wird das Asset automatisch veröffentlicht.

  3. Wählen Sie Alle Projekt-Assets nach Abschluss des Projekts in Brand Portal veröffentlichen. Diese Option ermöglicht die automatische Veröffentlichung von Assets in Brand Portal, wenn der Status des Workfront-Projekts, zu dem sie gehören, in Complete geändert wird.

Konfigurieren automatischer Veröffentlichungen

Aktualisierungen des benutzerdefinierten Formulars im Workfront-Dokument subscribe-workfront-doc-custom-form-updates

Um Änderungen in benutzerdefinierten Formularen von Workfront-Dokumenten zu abonnieren, wählen Sie die entsprechende Option auf der Registerkarte Erweitert. Wenn Sie diese Aktualisierungen abonnieren, werden Ihre zugeordnete Experience Manager-Metadatenfelder aktualisiert, sobald das entsprechende Feld im benutzerdefinierten Formular des Workfront-Dokuments geändert wurde.

Konfiguration für benutzerdefinierte Formularaktualisierungen im Workfront-Dokument in Experience Manager

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2