Använda mikrotjänster och bearbetningsprofiler get-started-using-asset-microservices

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 tillgångsmikrotjänster kan du bearbeta ett brett urval av filtyper som omfattar fler format som är körklara än vad som är möjligt med tidigare versioner av Experience Manager. Miniatyrbildextrahering 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

NOTE
Resursbearbetningen som beskrivs här ersätter arbetsflödesmodellen DAM Update Asset 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 get-started

Experience Manager tillåter följande bearbetningsnivåer.

Alternativ
Beskrivning
Användningsexempel som täcks
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 i användargränssnittet för Assets (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 att anropa Asset Compute-tjänsten. Stöder mer komplexa krav med en molnbaserad och skalbar metod.
Se tillåtna användningsfall.

Filformat som stöds supported-file-formats

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

Standardkonfiguration default-config

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 ser till att den grundläggande bearbetning som krävs av Experience Manager har slutförts för alla resurser.

Standardkonfiguration standard-config

Experience Manager innehåller funktioner för att generera mer specifika återgivningar 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 skapas.

  • Bredd och höjd för återgivning: I specifikationen för återgivningsbredd och -höjd finns 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 stora resurser från Experience Manager monteras i Adobe InDesign -dokument väntar en kreatör en avsevärd tid efter att de har placerat ut en resurs. Under tiden har användaren blockerats från att använda InDesign. Detta stör det kreativa flödet och påverkar användarupplevelsen negativt. Med Adobe kan du tillfälligt placera små återgivningar i InDesign-dokument till att börja med, vilket kan ersättas med högupplösta resurser vid behov senare. Experience Manager innehåller renderingar 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 om du behöver aktivera den för din bearbetningsprofil. Mer information finns i Fullständig dokumentation för Adobe Asset Link.

Skapa en standardprofil create-standard-profile

Så här skapar du en standardbearbetningsprofil:

  1. Administratörer har åtkomst till 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. Aktivera Create FPO Rendition på fliken Image om du vill generera FPO-återgivningar. Ange ett Quality-värde från 1-100.

  4. Om du vill generera andra återgivningar klickar du på Add New och anger 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 custom-config

Asset Compute Service har stöd för en mängd olika användningsfall, till exempel standardbearbetning, bearbetning av Adobe-specifika format som Photoshop-filer och 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 genom att profilkonfigurationen bearbetas. Om affärsbehoven inte uppfylls av dessa bearbetningsalternativ rekommenderar Adobe att du utvecklar och använder Asset Compute Service för att utöka standardfunktionerna. En översikt finns i Förstå utökningsmöjligheter och när du ska använda dem.

NOTE
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 miniatyrbilder, extraherad text och metadata samt arkiv.

Utvecklare kan använda Asset Compute Service för att skapa anpassade program för de användningsområden 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ändningsfall för anrop av externa tjänster:

  • Använd ImageCutout API för Adobe Photoshop och spara resultatet som rendering.
  • Anropa tredjepartssystem för att uppdatera data, till exempel ett PIM-system.
  • Använd Photoshop-API:t för att skapa olika renderingar baserat på Photoshop-mallen.
  • Använd Adobe Lightroom API för att optimera de kapslade resurserna och spara dem som återgivningar.
NOTE
Du kan inte redigera standardmetadata med de anpassade programmen. Du kan bara ändra anpassade metadata.

Skapa en anpassad profil create-custom-profile

Så här skapar du en anpassad profil:

  1. Administratörer har åtkomst till 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 App Builder-appar. Ditt anpassade program får alla angivna filer om de är konfigurerade med en bearbetningsprofil. Programmet måste filtrera filerna.

CAUTION
Om App Builder-programmet och Experience Manager-kontot inte kommer från samma organisation fungerar inte integreringen.

Ett exempel på en anpassad profil custom-profile-example

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.

Integrering med Asset Compute Service gör att Experience Manager kan skicka dessa parametrar till det anpassade programmet med hjälp av fältet Service Parameters. 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

Figur: Använd fältet Service Parameters 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 i Arial-BoldMT font när kampanjbilder överförs.

Använda bearbetningsprofiler för att bearbeta resurser use-profiles

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 åtgärden Apply Profile to Folders. 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änssnitt, använda åtgärden Properties för att öppna fönstret för mappegenskaper, klicka på fliken Asset Processing och i listan Processing Profile väljer du lämplig bearbetningsprofil för den mappen. Klicka på Save & Close om du vill spara ändringarna.
    Använd bearbetningsprofil på en mapp från fliken Resursegenskaper

  • Användare kan välja mappar eller specifika resurser i Assets användargränssnitt för att tillämpa en bearbetningsprofil och sedan välja alternativet Ikon för ombearbetning av resurser Reprocess Assets bland de tillgängliga alternativen överst.

TIP
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.

NOTE
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 vyn Renditions i den vänstra listen. Öppna förhandsgranskningen av resursen och öppna den vänstra listen för att komma åt vyn Renditions. 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.

extra-renderingar

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

Post arbetsflöden post-processing-workflows

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 Post-bearbetning kan du lägga till helt anpassad bearbetning utöver den konfigurerbara bearbetningen med hjälp av objektmikrotjänster.

Post-bearbetningsarbetsflöden, eller Autostart, om dessa har konfigurerats, körs automatiskt av Experience Manager när bearbetningen av mikrotjänsterna har slutförts. 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.

Så här lägger du till en arbetsflödeskonfiguration för efterbearbetning i Experience Manager:

  • Skapa en eller flera arbetsflödesmodeller. Dessa anpassade modeller kallas arbetsflödesmodeller för efterbearbetning i den här dokumentationen. Det ä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 steg 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 innebär att 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ödet i utvecklarreferensen.

Skapa arbetsflödesmodeller för efterbearbetning create-post-processing-workflow-models

Arbetsflödesmodeller för Post-bearbetning är vanliga 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 eventuella anpassade arbetsflödessteg.

Kontrollera att det sista steget i varje efterbearbetningsarbetsflö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 configure-post-processing-workflow-execution

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 apply-workflow-model-to-folder

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. Så här använder du en arbetsflödesmodell i mappen Properties:

  1. Skapa en arbetsflödesmodell.

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

  3. Under Auto-start Workflow väljer du ö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 configure-custom-workflow-runner-service

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 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:

  • Arbetsflöden för Post-bearbetning 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 sökvägen /var. Till exempel: /content/dam/my-brand:/var/workflow/models/my-workflow.
  • Post-bearbetningsarbetsflö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 Automatisk start av arbetsflöde -valet.

Skapa arbetsflödesmodellen Inaktiverad autostart
  1. Navigera till Verktyg > Arbetsflöde > Modeller

  2. Välj Skapa > Skapa modell i 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. Markera och Redigera den skapade arbetsflödesmodellen

  6. Välj Steg 1 från modelldefinitionen i arbetsflödesmodellredigeraren och ta bort det

  7. Öppna sidopanelen och välj Steg

  8. Dra steget DAM Update Asset Workflow Completed till modelldefinitionen

  9. Markera knappen Sidinformation (bredvid växlingsknappen Side Panel) och välj Öppna egenskaper

  10. Välj Övergående arbetsflöde på fliken Grundläggande

  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 tillämpa en arbetsflödesmodell på en mapp och ange Inaktivera autostart av arbetsflöde eftersom autostart av arbetsflöde för mappar inte kräver efterbearbetning av resurser.

Bästa praxis och begränsningar best-practices-limitations-tips

  • 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. Återgivningar kan inte tas bort gruppvis efteråt. Oönskade återgivningar kan ta upp stora mängder 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 för att 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.

Se även

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