Använda mikrotjänster och bearbetningsprofiler

Resursmikrotjänster ger skalbar och flexibel bearbetning av resurser med molnbaserade program (kallas även arbetare). Adobe hanterar tjänsterna för optimal hantering av olika tillgångstyper och bearbetningsalternativ.

Med Resursmikrotjänster kan du bearbeta en många olika filtyper som täcker fler format som är färdiga än vad som är möjligt med tidigare versioner av Experience Manager. Miniatyrbildsextrahering av PSD och PSB-format är nu möjligt men tidigare krävda tredjepartslösningar som ImageMagick.

Resursbearbetningen beror på konfigurationen i Processing Profiles. Experience Manager har en grundläggande standardkonfiguration och låter administratörer lägga till mer specifik konfiguration för bearbetning av resurser. Administratörer kan skapa, underhålla och ändra konfigurationerna för efterbehandlingsarbetsflöden, inklusive valfri anpassning. Genom att anpassa arbetsflödena kan utvecklarna utöka standarderbjudandet.

En högnivåvy över bearbetning av resurser

OBSERVERA

Bearbetningen av tillgångar som beskrivs här ersätter DAM Update Asset arbetsflödesmodell som finns i tidigare versioner av Experience Manager. De flesta standardstegen för generering av återgivning och metadatarelaterade steg ersätts av bearbetningen av resursmikrotjänsterna, och eventuella återstående steg kan ersättas av arbetsflödeskonfigurationen för efterbearbetning.

Förstå alternativ för tillgångsbearbetning

Experience Manager tillåter följande nivåer av bearbetning.

Alternativ Beskrivning Användningsexempel
Standardkonfiguration Den är tillgänglig som den är och kan inte ändras. Den här konfigurationen har mycket grundläggande funktioner för att skapa renderingar.
  • Standardminiatyrbilder som används av Assets användargränssnitt (48, 140 och 319 pixlar)
  • Stor förhandsgranskning (webbåtergivning - 1 280 pixlar)
  • Metadata och textrahering.
Anpassad konfiguration Konfigureras av administratörer via användargränssnittet. Ger fler alternativ för generering av återgivning genom att utöka standardalternativet. Utöka det färdiga alternativet om du vill ha olika format och renderingar.
  • FPO-återgivning.
  • Ändra filformat och upplösning för bilder
  • Tillämpa villkoren på konfigurerade filtyper.
Egen profil Konfigureras av administratörer via användargränssnittet för att använda anpassad kod via anpassade program för anrop Tjänsten Asset compute. Stöder mer komplexa krav med en molnbaserad och skalbar metod. Se tillåtna användningsfall.

Filformat som stöds

Resursmikrotjänsterna har stöd för en mängd olika filformat för att bearbeta, generera renderingar eller extrahera metadata. Se filformat som stöds för en fullständig lista över MIME-typer och de funktioner som stöds för varje typ.

Standardkonfiguration

Vissa standardinställningar är förkonfigurerade för att säkerställa att standardåtergivningarna som krävs i Experience Manager är tillgängliga. Standardkonfigurationen ser också till att metadataextrahering och textrahering är tillgängliga. Användare kan börja ladda upp eller uppdatera resurser direkt och grundläggande bearbetning är tillgänglig som standard.

Med standardkonfigurationen konfigureras bara den mest grundläggande bearbetningsprofilen. En sådan bearbetningsprofil visas inte i användargränssnittet och du kan inte ändra den. Det körs alltid för att bearbeta överförda resurser. En sådan standardbearbetningsprofil säkerställer att den grundläggande bearbetning som krävs av Experience Manager har slutförts för alla resurser.

Standardkonfiguration

Experience Manager har funktioner för att generera mer specifika renderingar för vanliga format efter användarens behov. En administratör kan skapa ytterligare Processing Profiles för att underlätta skapandet av en sådan återgivning. Användarna tilldelar sedan en eller flera av de tillgängliga profilerna till specifika mappar för att få den ytterligare bearbetningen klar. Den extra bearbetningen kan till exempel generera renderingar för webben, mobiler och surfplattor. I följande video visas hur du skapar och använder Processing Profiles och hur du får åtkomst till de återgivningar som skapats.

  • Återgivningens bredd och höjd: Specifikationen för återgivningens bredd och höjd ger maximala storlekar för den genererade utdatabilden. Resursmikrotjänsterna försöker skapa den största möjliga återgivningen, som inte är större än den angivna bredden och höjden. Proportionerna bevaras, det vill säga de ursprungliga. Ett tomt värde innebär att resursbearbetningen baseras på originalets pixeldimension.

  • Inkluderingsregler för MIME-typ: När en resurs med en viss MIME-typ bearbetas kontrolleras MIME-typen först mot det utelämnade MIME-typvärdet för återgivningsspecifikationen. Om den matchar den listan genereras inte den här specifika återgivningen för resursen (blockeringslista). Annars kontrolleras MIME-typen mot den inkluderade MIME-typen, och om den matchar listan genereras återgivningen (tillåtelselista).

  • Särskild FPO-återgivning: När du monterar stora resurser från Experience Manager till Adobe InDesign dokument, en kreatör väntar länge efter att de placera en resurs. Användaren kan inte använda InDesign. Detta stör det kreativa flödet och påverkar användarupplevelsen negativt. Med Adobe kan du tillfälligt placera små renderingar i InDesign till att börja med, som kan ersättas med högupplösta resurser på begäran senare. Experience Manager innehåller återgivningar som endast används för placering (FPO). Dessa FPO-återgivningar har en liten filstorlek men har samma proportioner.

Bearbetningsprofilen kan innehålla en FPO-återgivning (endast för placering). Se Adobe Asset Link dokumentation för att förstå om du behöver aktivera det för din bearbetningsprofil. Mer information finns i Adobe Asset Link - fullständig dokumentation.

Skapa en standardprofil

Så här skapar du en standardbearbetningsprofil:

  1. Administratörsåtkomst Tools > Assets > Processing Profiles. Klicka på Create.

  2. Ange ett namn som hjälper dig att identifiera profilen unikt när du använder den i en mapp.

  3. Om du vill generera FPO-återgivningar går du till Image flik, aktivera Create FPO Rendition. Ange en Quality värde mellan 1 och 100.

  4. Om du vill generera andra återgivningar klickar du på Add New och lämna följande information:

    • Filnamn för varje återgivning.
    • Filformat (PNG, JPEG, GIF eller WebP) för varje återgivning.
    • Bredd och höjd i pixlar för varje återgivning. Om värdena inte anges används den ursprungliga bildens fullständiga pixelstorlek.
    • Kvalitet i procent av varje JPEG- och WebP-återgivning.
    • Inkluderade och exkluderade MIME-typer för att definiera en profils tillämplighet.

    processing-profiles-adding

  5. Klicka på Save.

Anpassade profil- och användningsfall

The Asset Compute Service har stöd för en mängd olika användningsområden, t.ex. standardbearbetning, bearbetning av Adobe-specifika format som Photoshop-filer samt implementering av anpassad eller organisationsspecifik bearbetning. Den anpassning av arbetsflödet för DAM-uppdatering av tillgångar som tidigare krävdes hanteras antingen automatiskt eller via konfiguration av bearbetningsprofiler. Adobe rekommenderar att man utvecklar och använder Asset Compute Service för att utöka standardfunktionerna. En översikt finns på förstå hur utbyggbar den är och när den ska användas.

OBSERVERA

Adobe rekommenderar att du bara använder ett anpassat program när affärskraven inte kan uppfyllas med standardkonfigurationerna eller standardprofilen.

Det kan omvandla bild, video, dokument och andra filformat till olika renderingar, bland annat miniatyrer, extraherad text och metadata samt arkiv.

Utvecklare kan använda Asset Compute Service till skapa anpassade program för de användningsfall som stöds. Experience Manager kan anropa dessa anpassade program från användargränssnittet med hjälp av anpassade profiler som administratörer konfigurerar. Asset Compute Service har stöd för följande användningsområden när externa tjänster anropas:

  • Använd Adobe Photoshop's ImageCutout API och spara resultatet som rendering.
  • Anropa tredjepartssystem för att uppdatera data, till exempel ett PIM-system.
  • Använd Photoshop API för att generera olika renderingar baserat på Photoshop-mall.
  • Använd Adobe Lightroom API för att optimera inkapslade resurser och spara dem som återgivningar.
OBSERVERA

Du kan inte redigera standardmetadata med de anpassade programmen. Du kan bara ändra anpassade metadata.

Skapa en anpassad profil

Så här skapar du en anpassad profil:

  1. Administratörsåtkomst Tools > Assets > Processing Profiles. Klicka på Create.

  2. Klicka på fliken Custom. Klicka på Add New. Ange önskat filnamn för återgivningen.

  3. Ange följande information.

    Klicka på Save.

De anpassade programmen är headless Project Fire appar. Anpassat program får alla angivna filer om de är konfigurerade med en bearbetningsprofil. Programmet måste filtrera filerna.

FÖRSIKTIGHET

Om appen Firefly och Experience Manager kontot inte kommer från samma organisation, integreringen fungerar inte.

Ett exempel på en anpassad profil

För att illustrera hur den anpassade profilen används ska vi överväga ett användningsexempel för att använda anpassad text på kampanjbilder. Du kan skapa en bearbetningsprofil som använder Photoshop API för att redigera bilderna.

Integreringen av Asset compute-tjänsten gör att Experience Manager kan skicka dessa parametrar till det anpassade programmet med Service Parameters fält. Det anpassade programmet anropar sedan Photoshop API och skickar dessa värden till API:t. Du kan till exempel skicka teckensnittsnamn, textfärg, textvikt och textstorlek för att lägga till den anpassade texten i kampanjbilder.

custom-processing-profile

Bild: Använd Service Parameters fält för att skicka tillagd information till fördefinierade parametrar som byggs in i det anpassade programmet. I det här exemplet uppdateras bilderna med Jumanji text in Arial-BoldMT teckensnitt.

Använda bearbetningsprofiler för att bearbeta resurser

Skapa och använd de extra anpassade bearbetningsprofilerna på specifika mappar som Experience Manager kan bearbeta för resurser som har överförts till eller uppdaterats i dessa mappar. Den inbyggda standardbearbetningsprofilen körs alltid som standard, men visas inte i användargränssnittet. Om du lägger till en anpassad profil används båda profilerna för att bearbeta de överförda resurserna.

Använd bearbetningsprofiler på mappar på något av följande sätt:

  • Administratörer kan välja en bearbetningsprofildefinition i Tools > Assets > Processing Profiles och använda Apply Profile to Folder(s) åtgärd. Den öppnar en innehållsläsare där du kan navigera till specifika mappar, markera dem och bekräfta programmet för profilen.

  • Användare kan välja en mapp i Assets-användargränssnittet och använda Properties åtgärd för att öppna fönstret för mappegenskaper klickar du på Asset Processing och i Processing Profile väljer du lämplig bearbetningsprofil för den mappen. Spara ändringarna genom att klicka på Save & Close.
    Använda bearbetningsprofil på en mapp från fliken Resursegenskaper

  • Användarna kan välja mappar eller specifika resurser i Assets-användargränssnittet för att tillämpa en bearbetningsprofil och sedan välja ikon för ombearbetning av resurser Reprocess Assets från de tillgängliga alternativen överst.

TIPS

Endast en bearbetningsprofil kan användas för en mapp. Om du vill generera fler återgivningar lägger du till fler återgivningsdefinitioner i den befintliga bearbetningsprofilen.

När en bearbetningsprofil har tillämpats på en mapp bearbetas alla nya resurser som har överförts (eller uppdaterats) i den här mappen eller någon av dess undermappar med hjälp av den extra bearbetningsprofil som har konfigurerats. Den här bearbetningen är utöver standardprofilen.

OBSERVERA

En bearbetningsprofil som används på en mapp fungerar för hela trädet, men kan åsidosättas om en annan profil används på en undermapp. När resurser överförs till en mapp kontrollerar Experience Manager egenskaperna för den innehållande mappen för att hitta en bearbetningsprofil. Om ingen används kontrolleras en överordnad mapp i hierarkin för att en bearbetningsprofil ska användas.

Kontrollera att resurserna bearbetas genom att förhandsgranska de genererade återgivningarna i dialogrutan Renditions till vänster. Öppna förhandsgranskningen av resursen och öppna den vänstra listen för att komma åt Renditions vy. De specifika återgivningarna i bearbetningsprofilen, för vilka den specifika resursens typ matchar reglerna för MIME-typinkludering, bör vara synliga och tillgängliga.

additional-renditions

Bild: Exempel på två extra återgivningar som genereras av en bearbetningsprofil som tillämpas på den överordnade mappen.

Efterbehandlingsarbetsflöden

I en situation där ytterligare bearbetning av resurser krävs som inte kan utföras med bearbetningsprofilerna, kan ytterligare efterbearbetningsarbetsflöden läggas till i konfigurationen. Med efterbearbetning kan du lägga till helt anpassad bearbetning utöver den konfigurerbara bearbetningen med hjälp av objektmikrotjänster.

Efterbehandlingsarbetsflöden, eller Starta arbetsflödet automatiskt, om detta är konfigurerat, körs automatiskt av Experience Manager när mikrotjänsterna har behandlats klart. Du behöver inte lägga till startprogram för arbetsflöden manuellt för att utlösa arbetsflödena. Exemplen innehåller:

  • Anpassade arbetsflödessteg för att bearbeta resurser.
  • Integreringar för att lägga till metadata eller egenskaper i resurser från externa system, till exempel produkt- eller processinformation.
  • Ytterligare bearbetning utförd av externa tjänster.

Lägga till en arbetsflödeskonfiguration för efterbearbetning i Experience Managergör du så här:

  • Skapa en eller flera arbetsflödesmodeller. Dessa anpassade modeller kallas arbetsflödesmodeller för efterbearbetning i den här dokumentationen. De där är vanliga Experience Manager arbetsflödesmodeller.
  • Lägg till de arbetsflödessteg som krävs till dessa modeller. Granska stegen från standardarbetsflödet och lägg till alla nödvändiga standardsteg i det anpassade arbetsflödet. Stegen körs på resurserna baserat på en arbetsflödesmodellkonfiguration. Om du till exempel vill att smart taggning ska ske automatiskt när resurser överförs lägger du till steget i den anpassade arbetsflödesmodellen för efterbearbetning.
  • Lägg till DAM Update Asset Workflow Completed Process i slutet. Om du lägger till det här steget vet Experience Manager när bearbetningen avslutas och resursen kan markeras som bearbetad, det vill säga Nytt visas på resursen.
  • Skapa en konfiguration för tjänsten Custom Workflow Runner som gör att du kan konfigurera körning av en arbetsflödesmodell efter bearbetning antingen med en sökväg (mappsökväg) eller med ett reguljärt uttryck.

Mer information om vilket standardarbetsflödessteg som kan användas i efterbearbetningsarbetsflödet finns i arbetsflödessteg i efterbearbetningsarbetsflöde i utvecklarreferensen.

Skapa arbetsflödesmodeller för efterbearbetning

Arbetsflödesmodellerna för efterbearbetning är regelbundna Experience Manager arbetsflödesmodeller. Skapa olika modeller om du behöver olika bearbetning för olika databasplatser eller resurstyper.

Bearbetningsstegen läggs till efter behov. Du kan använda båda, de steg som stöds och alla anpassade arbetsflödessteg.

Se till att det sista steget i varje efterbehandlingsarbetsflöde är DAM Update Asset Workflow Completed Process. I det sista steget ser du till att Experience Manager vet när bearbetningen av mediefiler är klar.

Konfigurera arbetsflödeskörning efter bearbetning

När objektets mikrotjänster har slutfört bearbetningen av de överförda resurserna kan du definiera arbetsflödet för efterbearbetning för ytterligare bearbetning av resurserna. Om du vill konfigurera efterbearbetning med arbetsflödesmodeller kan du göra något av följande:

Tillämpa en arbetsflödesmodell på en mapp

För vanliga fall av efterbearbetning bör du överväga att använda metoden för att tillämpa ett arbetsflöde på en mapp. Använda en arbetsflödesmodell i mappen Propertiesgör du så här:

  1. Skapa en arbetsflödesmodell.

  2. Välj en mapp och klicka på Properties i verktygsfältet och klicka sedan på Assets Processing -fliken.

  3. Under Auto-start Workflow, väljer önskat arbetsflöde, anger en rubrik för arbetsflödet och sparar sedan ändringarna.

    Tillämpa ett efterbearbetningsarbetsflöde på en mapp i dess egenskaper

Konfigurera tjänsten Custom Workflow Runner

Du kan konfigurera den anpassade arbetsflödets körningstjänst för de avancerade konfigurationer som inte kan uppfyllas på ett enkelt sätt genom att tillämpa ett arbetsflöde på en mapp. Ett arbetsflöde som till exempel använder ett reguljärt uttryck. Adobe CQ DAM Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) är en OSGi-tjänst. Det innehåller följande två konfigurationsalternativ:

  • Efterbehandlingsarbetsflöden efter sökväg (postProcWorkflowsByPath): Flera arbetsflödesmodeller kan listas baserat på olika databassökvägar. Separera banor och modeller med ett kolon. Enkla databassökvägar stöds. Mappa dessa till en arbetsflödesmodell i /var bana. Till exempel: /content/dam/my-brand:/var/workflow/models/my-workflow.
  • Efterbehandlingsarbetsflöden efter uttryck (postProcWorkflowsByExpression): Flera arbetsflödesmodeller kan listas baserat på olika reguljära uttryck. Uttryck och modeller ska separeras med ett kolon. Det reguljära uttrycket ska peka direkt på resursnoden och inte på en av återgivningarna eller filerna. Till exempel: /content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.

Mer information om hur du distribuerar en OSGi-konfiguration finns i distribuera till Experience Manager.

Inaktivera arbetsflödeskörning efter bearbetning

När efterbearbetning inte behövs skapar och använder du en tom arbetsflödesmodell i Starta arbetsflödet automatiskt markering.

Skapa arbetsflödesmodellen Inaktiverad autostart
  1. Navigera till Verktyg > Arbetsflöde > Modeller
  2. Välj Skapa > Skapa modell från det övre åtgärdsfältet
  3. Ange en titel och ett namn för den nya arbetsflödesmodellen, till exempel:
    • Titel: Inaktivera autostart av arbetsflöde
    • Namn: disable-auto-start-workflow
  4. Välj Klar för att skapa arbetsflödesmodellen
  5. Välj och Redigera den nyskapade arbetsflödesmodellen
  6. Välj Steg 1 från modelldefinitionen och ta bort den
  7. Öppna Side Panel och markera Steg
  8. Dra DAM-uppdateringsarbetsflödet för resurser har slutförts steg in i modelldefinitionen
  9. Välj Sidinformation (bredvid Side Panel växla) och markera Öppna egenskaper
  10. Under Grundläggande flik, välja Övergående arbetsflöde
  11. Välj Spara och stäng i det övre åtgärdsfältet
  12. Välj Synkronisera i det övre åtgärdsfältet
  13. Stäng arbetsflödesmodellredigeraren
Använda arbetsflödesmodellen Inaktiverad autostart

Följ stegen som beskrivs i använda en arbetsflödesmodell i en mapp och ange Inaktivera autostart av arbetsflöde som Starta arbetsflödet automatiskt för mappar kräver inte efterbearbetning av resurser.

God praxis och begränsningar

  • Tänk på dina behov av alla typer av återgivningar när du utformar arbetsflöden. Om du inte förutser att en återgivning behövs i framtiden tar du bort steget när du skapar den från arbetsflödet. Det går inte att ta bort återgivningar gruppvis efteråt. Oönskade återgivningar kan ta upp mycket lagringsutrymme efter långvarig användning av Experience Manager. För enskilda resurser kan du ta bort återgivningar manuellt från användargränssnittet. För flera resurser kan du antingen anpassa Experience Manager om du vill ta bort specifika återgivningar eller ta bort resurserna och överföra dem igen.
  • Stödet är för närvarande begränsat till att generera renderingar. Generering av ny resurs stöds inte.
  • För närvarande är filstorleksgränsen för metadataextrahering ungefär 15 GB. När mycket stora resurser överförs misslyckas ibland metadataextraheringen.

På denna sida