DocumentatieAEM as a Cloud ServiceHandboek

Middelenmicroservices en verwerkingsprofielen gebruiken get-started-using-asset-microservices

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar
  • Beheerder
Beste praktijken van het Onderzoek
Beste praktijken van Meta-gegevens
Content Hub
Dynamic Media met mogelijkheden OpenAPI
de ontwikkelaarsdocumentatie van AEM Assets

Asset microservices zorgen voor schaalbare en veerkrachtige verwerking van middelen met behulp van cloudnative toepassingen (ook wel workers genoemd). Adobe beheert de services voor een optimale afhandeling van verschillende soorten bedrijfsmiddelen en verwerkingsopties.

De microdiensten van activa laten u a brede waaier van dossiertypesbehandelen die meer formaten uit-van-de-doos dan wat met vorige versies van Experience Manager mogelijk is. Zo is het nu mogelijk miniatuurextractie van PSD- en PSB-indelingen uit te voeren, maar hiervoor zijn oplossingen van derden vereist, zoals ImageMagick .

De verwerking van elementen is afhankelijk van de configuratie in Processing Profiles . De Experience Manager verstrekt een basisstandaardopstelling en laat beheerders specifiekere configuratie van de activaverwerking toevoegen. Beheerders maken, onderhouden en wijzigen de configuraties van naverwerkingsworkflows, inclusief optionele aanpassing. Door de workflows aan te passen kunnen ontwikkelaars de standaardaanbieding uitbreiden.

Een mening op hoog niveau van activa verwerkend

NOTE
De hier beschreven elementverwerking vervangt het DAM Update Asset -workflowmodel uit de vorige versies van Experience Manager . De meeste stappen voor het genereren van standaardvertoningen en het genereren van metagegevens worden vervangen door de verwerking van de asset microservices. Eventuele resterende stappen kunnen worden vervangen door de configuratie van de workflow na verwerking.

Opties voor middelenverwerking begrijpen get-started

In Experience Manager zijn de volgende verwerkingsniveaus mogelijk.

Optie
Beschrijving
Gebruikte gevallen
Standaardconfiguratie
Het is beschikbaar zoals is en kan niet worden gewijzigd. Deze configuratie biedt de mogelijkheid voor het genereren van zeer eenvoudige vertoningen.
  • Standaardminiaturen die worden gebruikt door de gebruikersinterface van Assets (48, 140 en 319 pixels)
  • Grote voorvertoning (webuitvoering, 1280 pixels)
  • Metagegevens en tekstextractie.
de configuratie van de Douane
Gevormd door beheerders via gebruikersinterface. Biedt meer opties voor het genereren van vertoningen door de standaardoptie uit te breiden. De optie voor het uit-van-de-doos uitbreiden voor verschillende indelingen en uitvoeringen.
  • FPO-uitvoering.
  • Bestandsindeling en resolutie van afbeeldingen wijzigen
  • Voorwaardelijk van toepassing op gevormde dossiertypes.
profiel van de Douane
Gevormd door beheerders via gebruikersinterface om douanecode door douanetoepassingen te gebruiken om de Dienst van de Asset compute te roepen. Ondersteunt complexere vereisten in een cloudnative en schaalbare methode.
Zie toegestane gebruiksgevallen.

Ondersteunde bestandsindelingen supported-file-formats

Asset microservices bieden ondersteuning voor een groot aantal verschillende bestandsindelingen voor het verwerken, genereren en extraheren van metagegevens. Zie gesteunde dossierformatenvoor de volledige lijst van types MIME en de functionaliteit die voor elk type wordt gesteund.

Standaardconfiguratie default-config

Sommige standaardwaarden zijn vooraf geconfigureerd om ervoor te zorgen dat de standaarduitvoeringen die in Experience Manager worden vereist, beschikbaar zijn. De standaardconfiguratie zorgt er ook voor dat extractie van metagegevens en tekstextractie beschikbaar zijn. Gebruikers kunnen direct beginnen met het uploaden of bijwerken van elementen en de standaardverwerking is standaard beschikbaar.

Met de standaardconfiguratie, slechts wordt het meest basisverwerkingsprofiel gevormd. Een dergelijk verwerkingsprofiel is niet zichtbaar in de gebruikersinterface en u kunt het niet wijzigen. Het wordt altijd uitgevoerd om geüploade elementen te verwerken. Een dergelijk standaardverwerkingsprofiel zorgt ervoor dat de basisverwerking die door Experience Manager wordt vereist, op alle elementen wordt voltooid.

Standaardconfiguratie standard-config

Experience Manager biedt mogelijkheden om specifiekere uitvoeringen te genereren voor veelgebruikte indelingen, afhankelijk van de behoeften van de gebruiker. Een beheerder kan aanvullende Processing Profiles maken om het maken van dergelijke vertoningen te vergemakkelijken. Gebruikers wijzen vervolgens een of meer van de beschikbare profielen toe aan specifieke mappen om de extra verwerking te voltooien. De extra verwerking kan bijvoorbeeld uitvoeringen genereren voor het web, mobiele apparaten en tablets. In de volgende video ziet u hoe u Processing Profiles kunt maken en toepassen en hoe u de gemaakte uitvoeringen kunt openen.

  • de breedte en de hoogte van de Vertoning: De breedte en de hoogtespecificatie van de Vertoning verstrekt maximumgrootte van het geproduceerde uitvoerbeeld. Middelenmicroservices proberen de grootst mogelijke uitvoering te produceren, waarbij de breedte en hoogte niet groter zijn dan respectievelijk de opgegeven breedte en hoogte. De hoogte-breedteverhouding blijft behouden, dat wil zeggen hetzelfde als het origineel. Een lege waarde houdt in dat bij de verwerking van elementen de pixelafmetingen van het origineel worden gebruikt.

  • MIME de regels van de typeopneming: Wanneer een activa met een specifiek MIME type wordt verwerkt, wordt het MIME type eerst gecontroleerd tegen de uitgesloten MIME typewaarde voor de vertoningsspecificatie. Als deze overeenkomt met die lijst, wordt deze specifieke uitvoering niet gegenereerd voor het element (lijst van gewezen personen). Anders wordt het MIME-type gecontroleerd op basis van het opgenomen MIME-type en als het overeenkomt met de lijst, wordt de vertoning gegenereerd (lijst van gewenste personen).

  • Speciale FPO vertoning: Wanneer het plaatsen van grote activa van Experience Manager in Adobe InDesign documenten, wacht een creatieve beroeps op een wezenlijke tijd nadat zij activaplaatsen. Ondertussen kan de gebruiker InDesign niet gebruiken. Dit onderbreekt de creatieve stroom en beïnvloedt de gebruikerservaring negatief. Met Adobe kunt u tijdelijk kleine uitvoeringen in InDesign -documenten plaatsen, die later op verzoek kunnen worden vervangen door middelen met volledige resolutie. Experience Manager biedt uitvoeringen die alleen voor plaatsing worden gebruikt (FPO). Deze FPO-uitvoeringen hebben een kleine bestandsgrootte maar hebben dezelfde hoogte-breedteverhouding.

Het verwerkingsprofiel kan een FPO-uitvoering (alleen voor plaatsing) bevatten. Zie Adobe Asset Link documentatieom te begrijpen als u het voor uw verwerkingsprofiel moet aanzetten. Voor meer informatie, zie {de volledige documentatie van de Verband van Activa van de Adobe 0} 🔗.

Een standaardprofiel maken create-standard-profile

Ga als volgt te werk om een standaard verwerkingsprofiel te maken:

  1. Beheerders openen Tools > Assets > Processing Profiles . Klik op Create.

  2. Geef een naam op waarmee u het profiel op unieke wijze kunt identificeren wanneer u het toepast op een map.

  3. Schakel Create FPO Rendition in op het tabblad Image om FPO-uitvoeringen te genereren. Voer een Quality -waarde in van 1-100.

  4. Als u andere vertoningen wilt genereren, klikt u op Add New en geeft u de volgende informatie op:

    • Bestandsnaam van elke vertoning.
    • Bestandsindeling (PNG, JPEG, GIF of WebP) van elke uitvoering.
    • Breedte en hoogte in pixels van elke uitvoering. Als de waarden niet worden opgegeven, wordt de volledige pixelgrootte van de oorspronkelijke afbeelding gebruikt.
    • Kwaliteit in procenten van elke JPEG en vertoning WebP.
    • MIME-typen zijn opgenomen en uitgesloten om de toepasbaarheid van een profiel te definiëren.

    verwerking-profielen-toevoegend

  5. Klik op Save.

Aangepast profiel en gebruiksscenario's custom-config

Asset Compute Service steunt een verscheidenheid van gebruiksgevallen zoals standaardverwerking, verwerkings Adobe-specifieke formaten zoals de dossiers van Photoshop, en het uitvoeren van douane of organisatie-specifieke verwerking. De in het verleden vereiste aanpassing van de DAM-updateworkflow voor middelen wordt automatisch verwerkt of als configuratie van verwerkingsprofielen. Als met deze verwerkingsopties niet aan de bedrijfsbehoeften wordt voldaan, raadt de Adobe aan de standaardmogelijkheden te ontwikkelen en te gebruiken Asset Compute Service . Voor een overzicht, zie uitbreidbaarheid begrijpen en wanneer om hette gebruiken.

NOTE
Adobe raadt u aan alleen een aangepaste toepassing te gebruiken als de zakelijke vereisten niet kunnen worden vervuld met de standaardconfiguraties of het standaardprofiel.

Het kan beeld, video, document, en andere dossierformaten in verschillende vertoningen met inbegrip van duimnagels, gehaalde tekst en meta-gegevens, en archieven omzetten.

De ontwikkelaars kunnen Asset Compute Service gebruiken om douanetoepassingenvoor de gesteunde gebruiksgevallen tot stand te brengen. Experience Manager kan deze aangepaste toepassingen vanuit de gebruikersinterface aanroepen met behulp van aangepaste profielen die beheerders configureren. Asset Compute Service biedt ondersteuning voor de volgende gevallen waarin externe services worden aangeroepen:

  • Gebruik ImageCutout API van 0}en bewaar het resultaat als vertoning.Adobe Photoshop
  • De systemen van de derde vraag om gegevens, bijvoorbeeld, een PIM systeem bij te werken.
  • Gebruik de Photoshop API om verschillende uitvoeringen te genereren op basis van de Photoshop-sjabloon.
  • Het gebruik Adobe Lightroom APIom de opgenomen activa te optimaliseren en die als vertoningen te bewaren.
NOTE
U kunt de standaardmetagegevens niet bewerken met de aangepaste toepassingen. U kunt alleen aangepaste metagegevens wijzigen.

Een aangepast profiel maken create-custom-profile

Ga als volgt te werk om een aangepast profiel te maken:

  1. Beheerders openen Tools > Assets > Processing Profiles . Klik op Create.

  2. Klik op het tabblad Custom. Klik op Add New. Geef de gewenste bestandsnaam van de vertoning op.

  3. Geef de volgende informatie op.

    Klik op Save.

De douanetoepassingen zijn hoofd App Builderapps van het Project. Uw aangepaste toepassing krijgt alle beschikbare bestanden als deze zijn ingesteld met een verwerkingsprofiel. De toepassing moet de bestanden filteren.

CAUTION
Als de App Builder-app en Experience Manager -account niet van dezelfde organisatie afkomstig zijn, werkt de integratie niet.

Een voorbeeld van een aangepast profiel custom-profile-example

Als u het gebruik van een aangepast profiel wilt illustreren, kunt u het beste een kwestie-case gebruiken om aangepaste tekst toe te passen op campagneafbeeldingen. U kunt een verwerkingsprofiel maken dat de Photoshop API gebruikt om de afbeeldingen te bewerken.

Dankzij de asset compute Service-integratie kan Experience Manager deze parameters aan de aangepaste toepassing doorgeven met behulp van het veld Service Parameters . De aangepaste toepassing roept vervolgens de Photoshop API aan en geeft deze waarden door aan de API. U kunt bijvoorbeeld lettertypenaam, tekstkleur, tekstdikte en tekstgrootte doorgeven om aangepaste tekst toe te voegen aan campagneafbeeldingen.

douane-verwerkings-profiel

Figuur: Het gebied van het gebruik Service Parameters om toegevoegde informatie tot vooraf bepaalde parameters over te gaan bouwt in de douanetoepassing. In dit voorbeeld worden de afbeeldingen bijgewerkt met Jumanji tekst in Arial-BoldMT font.

Verwerkingsprofielen gebruiken om elementen te verwerken use-profiles

Maak en pas de extra aangepaste verwerkingsprofielen toe op specifieke mappen die Experience Manager kan verwerken voor elementen die zijn geüpload naar of bijgewerkt in deze mappen. Het standaard ingebouwde standaard verwerkingsprofiel wordt altijd uitgevoerd, maar is niet zichtbaar in de gebruikersinterface. Als u een aangepast profiel toevoegt, worden beide profielen gebruikt om de geüploade elementen te verwerken.

Pas verwerkingsprofielen toe op mappen met een van de volgende methoden:

  • Beheerders kunnen een definitie van het verwerkingsprofiel selecteren in Tools > Assets > Processing Profiles en Apply Profile to Folders gebruiken. Er wordt een inhoudbrowser geopend waarmee u naar specifieke mappen kunt navigeren, deze kunt selecteren en de toepassing van het profiel kunt bevestigen.

  • Gebruikers kunnen een map selecteren in de gebruikersinterface van Assets, Properties actie gebruiken om het scherm met mapeigenschappen te openen, op de tab Asset Processing klikken en in de lijst Processing Profile het juiste verwerkingsprofiel voor die map selecteren. Klik op Save & Close om de wijzigingen op te slaan.
    pas verwerkingsprofiel op een omslag van het lusje van de Eigenschappen van Activa toe

  • De gebruikers kunnen omslagen of specifieke activa in het gebruikersinterface van Assets selecteren om een verwerkingsprofiel toe te passen, dan selecteren activa opnieuw verwerkingspictogram Reprocess Assets optie van de opties beschikbaar op de bovenkant.

TIP
Er kan slechts één verwerkingsprofiel worden toegepast op een map. Als u meer uitvoeringen wilt genereren, voegt u meer renderdefinities toe aan het bestaande verwerkingsprofiel.

Nadat een verwerkingsprofiel is toegepast op een map, worden alle nieuwe elementen die in deze map of een van de submappen van deze map zijn geüpload (of bijgewerkt), verwerkt met behulp van het extra verwerkingsprofiel dat is geconfigureerd. Deze verwerking is een aanvulling op het standaardprofiel.

NOTE
Een verwerkingsprofiel dat is toegepast op een map, werkt voor de gehele structuur, maar kan worden overschreven door een ander profiel dat is toegepast op een submap. Wanneer middelen aan een omslag worden geupload, controleert de Experience Manager de bevattende omslageigenschappen voor een verwerkingsprofiel. Als er geen toepassing is, wordt gecontroleerd of er een verwerkingsprofiel van toepassing is in een bovenliggende map in de hiërarchie.

Als u wilt controleren of elementen worden verwerkt, bekijkt u een voorvertoning van de gegenereerde uitvoeringen in de weergave Renditions in de linkerrails. Open de voorvertoning van elementen en open de linkerrails voor toegang tot de weergave Renditions . De specifieke uitvoeringen in het verwerkingsprofiel, waarvoor het type van het specifieke element overeenkomt met de regels voor het opnemen van het MIME-type, moeten zichtbaar en toegankelijk zijn.

extra-vertoningen

Cijfer: Voorbeeld van twee extra vertoningen die door een verwerkingsprofiel worden geproduceerd dat op de ouderomslag wordt toegepast.

Nabewerkingsworkflows post-processing-workflows

In een situatie waarin aanvullende verwerking van elementen vereist is die niet met de verwerkingsprofielen kan worden bereikt, kunnen extra nabewerkingsworkflows aan de configuratie worden toegevoegd. Na de verwerking kunt u volledig aangepaste verwerking toevoegen bovenop de configureerbare verwerking met behulp van asset microservices.

De werkschema's na verwerking, of auto-begin werkschema, indien gevormd, worden automatisch uitgevoerd door Experience Manager nadat de microdienstenverwerking eindigt. Het is niet nodig om handmatig starters voor werkstromen toe te voegen om de werkstromen te activeren. De voorbeelden zijn:

  • Aangepaste workflowstappen om elementen te verwerken.
  • Integraties om metagegevens of eigenschappen toe te voegen aan elementen van externe systemen, bijvoorbeeld product- of procesgegevens.
  • Aanvullende verwerking door externe services.

Voer de volgende stappen uit om een workflowconfiguratie voor na verwerking toe te voegen aan Experience Manager :

  • Maak een of meer workflowmodellen. Deze douanemodellen worden bedoeld als post-verwerkende werkschemamodellen in deze documentatie. Dit zijn reguliere Experience Manager workflowmodellen.
  • Voeg de vereiste workflowstappen toe aan deze modellen. Controleer de stappen in de standaardworkflow en voeg alle vereiste standaardstappen toe aan de aangepaste workflow. De stappen worden uitgevoerd op de middelen die op een configuratie van het werkschemamodel worden gebaseerd. Als u bijvoorbeeld automatisch slimme tags wilt toepassen bij het uploaden van elementen, voegt u de stap toe aan het aangepaste workflowmodel voor nabewerking.
  • Voeg DAM Update Asset Workflow Completed Process stap aan het einde toe. Het toevoegen van deze stap zorgt ervoor dat de Experience Manager weet wanneer de verwerking beëindigt en het middel als verwerkt kan worden gemerkt, dat Nieuw op de activa wordt getoond.
  • Creeer een configuratie voor de Dienst van de Runner van het Werkschema van de Douane die toestaat om uitvoering van een model van het post-verwerkingswerkschema of door een weg (omslagplaats) of door een regelmatige uitdrukking te vormen.

Voor details over welke standaardwerkschemastap in het post-verwerkingswerkschema kan worden gebruikt, zie werkschemastappen in postverwerkingswerkschemain de ontwikkelaarsverwijzing.

Workflowmodellen voor naverwerking maken create-post-processing-workflow-models

Workflowmodellen na verwerking zijn standaardworkflowmodellen van Experience Manager . Maak verschillende modellen als u verschillende verwerkingen nodig hebt voor verschillende opslaglocaties of elementtypen.

De verwerkingsstappen worden indien nodig toegevoegd. U kunt zowel de ondersteunde stappen als aangepaste workflowstappen gebruiken.

Zorg ervoor dat de laatste stap van elke naverwerkingsworkflow DAM Update Asset Workflow Completed Process is. De laatste stap helpt ervoor te zorgen dat de Experience Manager weet wanneer de activaverwerking wordt voltooid.

Workflowuitvoering na verwerking configureren configure-post-processing-workflow-execution

Nadat de assetmicroservices de verwerking van de geüploade elementen hebben voltooid, kunt u een workflow voor nabewerking definiëren om de elementen verder te verwerken. Als u naverwerking wilt configureren met behulp van workflowmodellen, kunt u een van de volgende handelingen uitvoeren:

Workflowmodel toepassen op een map apply-workflow-model-to-folder

Voor gangbare gebruiksgevallen na verwerking kunt u de methode gebruiken om een workflow toe te passen op een map. Voer de volgende stappen uit om een workflowmodel toe te passen in de map Properties :

  1. Maak een workflowmodel.

  2. Selecteer een map, klik op Properties op de werkbalk en klik op Assets Processing tab.

  3. Selecteer onder Auto-start Workflow de gewenste workflow, geef een titel op voor de workflow en sla de wijzigingen op.

    pas een post-verwerkingswerkschema op een omslag in zijn Eigenschappen toe

De service Custom Workflow Runner configureren configure-custom-workflow-runner-service

U kunt de aangepaste workflowrunnerservice configureren voor de geavanceerde configuraties die niet gemakkelijk kunnen worden uitgevoerd door een workflow toe te passen op een map. Bijvoorbeeld een werkstroom die een reguliere expressie gebruikt. De Adobe CQ DAM Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) is een OSGi-service. Het verstrekt de volgende twee opties voor configuratie:

  • Workflows na verwerking volgens pad (postProcWorkflowsByPath): meerdere workflowmodellen kunnen worden weergegeven op basis van verschillende repository paden. Scheid paden en modellen met een dubbele punt. Eenvoudige opslagpaden worden ondersteund. Wijs deze toe aan een werkschemamodel in de /var weg. Bijvoorbeeld: /content/dam/my-brand:/var/workflow/models/my-workflow .
  • Workflows na verwerking op expressie (postProcWorkflowsByExpression): er kunnen meerdere workflowmodellen worden weergegeven op basis van verschillende reguliere expressies. Expressies en modellen moeten worden gescheiden door een dubbele punt. De reguliere expressie moet rechtstreeks naar het knooppunt Asset verwijzen en niet naar een van de uitvoeringen of bestanden. Bijvoorbeeld: /content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow .

Om te weten hoe te om een configuratie op te stellen OSGi, zie aan Experience Manager opstellen.

Uitvoering van workflow na verwerking uitschakelen

Wanneer post-verwerking niet nodig is, creeer en gebruik een "leeg"Model van het Werkschema in de auto-begin van het Werkschema selectie.

Het workflowmodel voor automatisch opstarten van uitgeschakelde systemen maken

  1. Ga aan Hulpmiddelen > Werkschema > Modellen

  2. Selecteer creeer > creeer Model van de hoogste actiebar

  3. Geef een titel en naam op voor het nieuwe workflowmodel, bijvoorbeeld:

    • Titel: Auto-start Workflow uitschakelen
    • Naam: disable-auto-start-workflow

  4. Selecteer Gereed om het Model van het Werkschema tot stand te brengen

  5. Uitgezochte en geeft het gecreeerde Model van het Werkschema uit

  6. In de Modelredacteur van het Werkschema, uitgezochte Stap 1 van de modeldefinitie en schrap het

  7. Open het Zijpaneel, en selecteer Stappen

  8. Sleep de voltooide 1} stap van het Activum van de Update DAM in de modeldefinitie

  9. Selecteer de knoop van de Informatie van de Pagina (naast zijComité knevel), en selecteer Open Eigenschappen

  10. Onder het Basis lusje, uitgezochte Voorbijgaande Werkschema

  11. Selecteer sparen & Sluiten van de hoogste actiebar

  12. Selecteer Synchronisatie in de hoogste actiebar

  13. Sluit de Redacteur van het Model van het Werkschema

Het workflowmodel voor automatisch opstarten van uitgeschakelde systemen toepassen

Volg de stappen die in worden geschetst een werkschemamodel op een omslagtoepassen en onbruikbaar maken Auto-Begin Werkschema aangezien Auto-begin Werkschema voor omslagen geen post-verwerking van activa vereist.

Aanbevolen werkwijzen en beperkingen best-practices-limitations-tips

  • Houd rekening met uw behoeften aan alle typen uitvoeringen wanneer u workflows ontwerpt. Als u in de toekomst geen uitvoering nodig hebt, verwijdert u de aanmaakstap uit de workflow. Uitvoeringen kunnen daarna niet bulksgewijs worden verwijderd. Ongewenste vertoningen kunnen na langdurig gebruik van Experience Manager veel opslagruimte in beslag nemen. Voor afzonderlijke elementen kunt u uitvoeringen handmatig uit de gebruikersinterface verwijderen. Voor meerdere elementen kunt u Experience Manager aanpassen om specifieke vertoningen te verwijderen of de elementen verwijderen en deze opnieuw uploaden.
  • Momenteel is de ondersteuning beperkt tot het genereren van uitvoeringen. Het genereren van nieuwe elementen wordt niet ondersteund.
  • De maximale bestandsgrootte voor het uitnemen van metagegevens is momenteel ongeveer 15 GB. Wanneer u zeer grote elementen uploadt, mislukt het uitnemen van metagegevens soms.

zie ook

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