Konfigurera Workfront for Experience Manager enhanced connector assets-integration-overview

Version
Artikellänk
AEM 6.5
Klicka här
AEM as a Cloud Service
Den här artikeln

En användare med administratörsåtkomst i Adobe Experience Manager som Cloud Service konfigurerar den förbättrade anslutningen efter att den har installerats. Instruktioner om hur du installerar finns i Installera anslutningsprogrammet.

IMPORTANT
Från juni 2022 släppte Adobe en ny inbyggd integrering för att ansluta Workfront till Adobe Experience Manager Assets as a Cloud Service. Den här integreringen har blivit den metod som krävs för att ansluta dessa två lösningar. Eventuella framtida nya implementeringar av den utökade anslutningen (1.9.8 och senare) för att ansluta Workfront till AEM Assets as a Cloud Service blockeras.
IMPORTANT
  • Adobe kräver att Adobe Workfront for Experience Manager enhanced connector distribueras och konfigureras endast via certifierade partners eller Adobe Professional Services. Om den distribueras och konfigureras utan en certifierad partner eller Adobe Professional Services stöds den inte av Adobe.

  • Adobe kan släppa uppdateringar till Adobe Workfront och Adobe Experience Manager som gör den här kopplingen överflödig. Om detta inträffar kan kunderna behöva gå över från att använda den här kopplingen.

  • Adobe har stöd för utökade anslutningsversioner 1.7.4 och senare. Tidigare förhandsversioner och anpassade versioner stöds inte. Om du vill kontrollera den utökade anslutningsversionen läser du steg 5(a) i de förbättrade installationsanvisningarna för anslutningsprogrammet.

  • Se Partnercertifieringsprov för Workfront för Experience Manager Assets förbättrade anslutningsprogram. Mer information om provet finns i Handbok för prov.

Konfigurera händelseprenumerationer event-subscriptions

Händelseprenumerationer används för att meddela AEM om händelser som inträffar i Adobe Workfront. Det finns tre Workfront for Experience Manager enhanced connector-funktioner som kräver att händelseprenumerationer fungerar:

  • Automatiskt skapande av projektlänkade mappar.
  • Synkronisering av ändringar i anpassade formulärvärden för Workfront-dokument till AEM metadata för resurser.
  • Automatisk publicering av material till Brand Portal när projektet är klart.

Aktivera händelseprenumerationer om du vill använda dessa funktioner.

  • Redigera konfigurationen för Workfront Tools Cloud Service som du skapade i steg 5 och välj fliken Event Subscriptions.

  • Markera Workfront Custom Integration som du skapade i avsnitt 6.

  • Klicka på Enable Workfront Event Subscriptions.

    Evenemangsprenumeration

Konfigurera länkade mappar linked-folders

Så här prenumererar du på händelserna:

  1. Navigera till fliken Event Subscriptions i molntjänsterna.
  2. Välj den anpassade integrering som skapats i Workfront.
  3. Klicka på Enable Workfront Event Subscriptions.

Konfiguration av länkad mappstruktur linked-folder-structure

  1. Gå till fliken Projektlänkade mappar i molntjänsterna.
  2. Länkad mappens överordnade sökväg: Välj en mapp i DAM där du vill skapa de länkade mapparna. Om det lämnas tomt används /content/dam som standard. Se till att metadatamatchemat för Workfront Tools och Workfront-mappen för länkade mappar har tillämpats på den markerade mappen.
  3. Länkad mappstruktur: Ange kommaavgränsade värden. Varje värde ska vara DE:<some-project-custom-form-field>, Portfolio, Program, År, Namn eller något "Literal String Value" (det sista med citattecken). Den är för närvarande inställd på Portfolio, Program, År, DE:Projekttyp, Namn.
  4. Konfigurera behörigheter: Lägg till jcr:all permissions-behörigheter i /conf/workfront-tools/settings/cloudconfigs för gruppen wf-workfront-users.
  5. Skapa länkad mapptitel i Workfront med hjälp av kryssrutan Mappstrukturnamn bör vara markerad om mappens titel i Workfront ska innehålla alla mappar i strukturen. I annat fall är det den sista mappens namn.
  6. Med undermappsmappar kan du ange en lista med mappar som ska skapas som en underordnad mapp till den länkade mappen.
  7. Projektstatus: Välj den status som projektet måste ställas in för för att skapa den länkade mappen.
  8. Skapa en länkad mapp i projekt med portfölj: Lista med Portfolio som projektet måste tillhöra så att du kan skapa den länkade mappen. Lämna listan tom om du vill skapa den länkade mappen för alla projektportföljer.
  9. Skapa en länkad mapp i projekt med anpassat formulärfält: Anpassat formulärfält och motsvarande värde som projektet måste ha för att du ska kunna skapa den länkade mappen. Den här konfigurationen ignoreras om den lämnas tom. Välj CUSTOM FORMS: Create DAM Linked Folder för fältet och indata Yes för värdet.
  10. Konfigurera behörighet: Konfigurera dessa behörigheter, jcr:all permissions for /conf/workfront-tools/settings/cloudconfigs för wf-workfront-users group.
  11. Klicka på Aktivera automatiskt skapande av länkade mappar. Om du går tillbaka till fliken Händelseabonnemang ser du att det nu finns en händelse för att skapa.

konfiguration av länkad mapp

Mappning av metadataram metadata-schema-mapping

Konfigurera mappning av metadata folder-metadata-mapping

Metadatamappning mellan Workfront-projekt och AEM-mappar definieras AEM mappmetadatamappningar. Mappens metadatascheman ska skapas och konfigureras som vanligt i AEM. Workfront Tools lägger till en automatiskt ifylld listruta på konfigurationsfliken Inställningar i varje formulärfält för mappmetadataram. I den här listrutan kan du ange till vilket Workfront-fält varje AEM ska mappas.

Så här konfigurerar du mappningarna:

  1. Lägg till jcr:read-behörigheter i /conf/global/settings/dam/adminui-extension/foldermetadataschema för gruppen wf-workfront-users.

  2. Navigera till Tools > Assets > Folder Metadata Schemas.

  3. Markera det mappmetadatamatchschema som du vill redigera och klicka på Redigera.

  4. Markera det formulärfält för mappmetadataram som du vill redigera och välj fliken Inställningar på den högra panelen.

  5. I fältet Mapped from Workfront Field markerar du namnet på det Workfront-fält som du vill mappa till den markerade AEM mappegenskapen. Tillgängliga alternativ är:

    • Anpassade formulärfält för projekt
    • Fält för projektöversikt (ID, namn, beskrivning, referensnummer, planerat slutförandedatum, projektägare, projektsponsor, Portfolio eller program)

metadatamappningskonfiguration

Konfigurera metadatamappning för resurser asset-metadata-mapping

Metadatamappning mellan Adobe Workfront-dokument och Assets definieras AEM metadatamappningar. Metadata Schemas ska skapas och konfigureras som vanligt i AEM. Workfront Tools lägger till konfigurationsalternativ på fliken Settings (Inställningar) i varje formulärfält för metadatdataschema. Med dessa alternativ kan du ange till vilket fält varje AEM ska mappas.

Så här konfigurerar du mappningarna:

  1. Navigera till Verktyg > Assets > Metadata Schemas.

  2. Välj det metadatamatchformulär som du vill redigera och klicka på Redigera eller skapa ett metadatamatchema från början.

  3. Markera det formulärfält för metadataschemat som du vill redigera och välj fliken Inställningar på den högra panelen.

  4. I det anpassade formulärfältet Workfront markerar du namnet på det Workfront-fält som du vill mappa till den valda AEM. Tillgängliga alternativ är:

    • Anpassade formulärfält för dokument
    • Anpassade formulärfält för projekt
    • Skapa anpassade formulärfält
    • Anpassade formulärfält för uppgift
    • Projektöversiktsfält (ID, namn, beskrivning eller referensnummer)
  5. Om fältet Workfront som valts i Workfront Custom Form Field är ett Workfront-fält av typen närmast föregående, måste du ange vilket Workfront-användarfält som du vill mappa. Om du vill göra det markerar du Hämta värde från objektfältet som refereras till av Workfront och anger sedan namnet på Workfront User Custom Form Field som värdet ska mappas från.

    konfiguration för metadatamappning

Egenskapen Karta map-property

I det här arbetsflödessteget kan en användare mappa en egenskap till ett Workfront anpassat formulär i ett projekt, en uppgift, ett problem eller ett dokument. Workfront-artefakten som det här steget påverkar har slagits upp med en relativ sökväg från nyttolasten. De egenskaper som ska mappas styrs från inställningarna i dialogrutan för steg.

Typ: I det här fältet kan du välja den Workfront-objekttyp som egenskaperna ska mappas till.

ID-egenskap: I det här fältet kan du ange sökvägen till ID:t för Workfront-objektet som egenskaperna ska mappas till. Sökvägen som anges i det här fältet ska vara relativ till arbetsflödets nyttolast.

Egenskapstilldelningar: Med det här multifältet kan du ange mappningar mellan AEM och Workfront-fält. Varje objekt i flerfältet anger en mappning. Varje mappning ska ha formatet <workfront-field>=<aem-mapped-property>.

  • workfront-field kan vara

    • Ett anpassat formulärfält som identifieras av prefixet DE:.
    • Ett redigerbart fält som identifieras av dess namn. Fältnamnen finns i Workfront API Explorer.
  • aem-mapped-property kan vara:

    • Ett literalt värde. De ska omges av citattecken.
    • En AEM. Den här referensen ska vara relativ till arbetsflödets nyttolast.
    • Ett namngivet värde. Dessa bör omges av hakparenteser.
    • En sammanfogning av de tre ovanstående objekten. Ange det med {+}.
    • En ändring av ovanstående 3 objekt genom att omge värdet med {replace(<value>,"old-char","new-char")}.
  • Exempel:

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

Konfiguration för att mappa egenskap

Ange status set-status

Redigera egenskaperna för Workfront - Set Status på fliken Arguments i arbetsflödesredigeraren.

Redigera arbetsflöde för att ange status

Synkronisering av kommentarer comments-sync

  1. Gå till Tools > Cloud Services > Workfront Tools Configuration i Experience Manager, markera konfigurationen och välj Properties.

    kommentarsynkronisering

  2. Välj fliken Event Subscriptions och klicka på alternativet Enable Comment SyncSend Comments made in Workfront to AEM.

    Synkronisering är aktiverat

Så här testar du synkroniseringen av kommentarer från Workfront till AEM:

  1. Navigera till ett länkat dokument i Workfront och lägg till en kommentar på fliken Uppdateringar.

    lämna kommentarer i Workfront

  2. Navigera till samma länkade dokument i AEM, markera dokumentet och öppna alternativet Timeline i den vänstra navigeringen och välj Comments. Den vänstra sidlisten visar de kommentarer som synkroniserats från Workfront.

Resursversioner asset-versions

Om du vill behålla versionshistorik för resurser i AEM konfigurerar du resursversionshantering i AEM.

  1. Gå till Tools > Cloud Services > Workfront Tools Configuration i Experience Manager och öppna fliken Advanced.

  2. Välj alternativet Store assets with the same name as versions of the existing asset. När du markerar det här alternativet aktiveras lagring av resurser som överförts med samma namn och till samma plats som versionen av den befintliga resursen. Om alternativet inte är markerat skapas en ny resurs med ett annat namn (till exempel asset-name.pdf och asset-name-1.pdf).

  3. Välj alternativet Update asset metadata when creating a new version. När det här alternativet är markerat uppdateras resursens metadata varje gång en ny version av resursen skapas. Om alternativet inte är markerat behåller resursen de metadata som den hade innan den nya versionen skapades.

konfigurera resursversionshantering

NOTE
Versionshantering stöds inte i länkade mappar. När du skapar ett Workfront-korrektur med ett dokument i en länkad mapp tas kommentarerna och anteckningarna i den tidigare versionen av resursen bort.

Bifoga anpassade formulär attach-custom-forms

I det här arbetsflödessteget kan användare bifoga ett anpassat formulär till en Workfront-artefakt. Det här arbetsflödessteget kan läggas till i alla arbetsflödesmodeller. Workfront-artefakten som det här steget påverkar har slagits upp med en relativ sökväg från nyttolasten.

Redigera egenskaperna för arbetsflödessteget Workfront - Attach custom form i arbetsflödesredigeraren i Experience Manager.

anpassade formulär .

Publicera resurser automatiskt auto-publish-assets

  1. Gå till Tools > Cloud Services > Workfront Tools Configuration i Experience Manager och öppna fliken Advanced.

  2. Välj Automatically publish assets when sent from Workfront. Med det här alternativet aktiveras automatisk publicering av resurser när de skickas från Workfront till AEM. Den här funktionen kan aktiveras villkorligt genom att du anger ett anpassat Workfront-formulärfält och vilket värde det ska anges till. När ett dokument skickas till AEM, om det uppfyller villkoret, publiceras resursen automatiskt.

  3. Välj Publish all project assets to Brand Portal upon project completion. Med det här alternativet aktiveras automatisk publicering av resurser till Brand Portal när statusen för det Workfront-projekt de tillhör ändras till Complete.

konfigurera automatisk publicering

Anpassade formuläruppdateringar för Workfront subscribe-workfront-doc-custom-form-updates

Om du vill prenumerera på ändringarna i Workfront anpassade formulär väljer du det relevanta alternativet på fliken Advanced. När du prenumererar på dessa uppdateringar uppdateras dina mappade Experience Manager-metadatafält när motsvarande fält i det anpassade Workfront-dokumentformuläret ändras.

Konfigurationen för anpassade formulär i Workfront uppdateras i Experience Manager

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab