[AEM Assets]{class="badge positive" title="Si applica ad AEM Assets)."}

Utilizzare i microservizi delle risorse e i profili di elaborazione get-started-using-asset-microservices

I microservizi per le risorse forniscono elaborazione delle risorse scalabile e resiliente tramite applicazioni native per il cloud, denominate anche processi di lavoro, ovvero unità di elaborazione scalabili in modo indipendente che vengono eseguite nel cloud per gestire le risorse su richiesta. Grazie alla scalabilità elastica di questi lavoratori, la capacità di elaborazione si espande automaticamente durante l’acquisizione di volumi elevati e si contrae quando inattivi, migliorando sia il throughput che l’affidabilità rispetto all’elaborazione a capacità fissa.

Adobe gestisce questi servizi direttamente, garantendo una gestione ottimale di diversi tipi di risorse e opzioni di elaborazione. Questo approccio gestito consente agli amministratori di non dover eseguire il provisioning, il tuning o la manutenzione dell’infrastruttura di elaborazione sottostante, consentendo ai team di concentrarsi sulla configurazione delle risorse anziché sul sovraccarico operativo.

Tipi di file e formati supportati

I microservizi per le risorse elaborano una vasta gamma di tipi di file, che comprende più formati predefiniti rispetto alle versioni precedenti diExperience Manager. Questo supporto nativo esteso rimuove la dipendenza da strumenti esterni per molti flussi di lavoro comuni.

Ad esempio, l’estrazione di miniature di formati PSD (Photoshop Document) e PSB (Photoshop Big) è ora supportata in modalità nativa. Nelle versioni precedenti questo richiedeva soluzioni di terze parti come ImageMagick. La gestione diretta di questi formati all’interno della piattaforma semplifica le pipeline, riduce la complessità dell’integrazione ed elimina il carico di manutenzione dovuto alle dipendenze esterne.

Configurazione dei profili di elaborazione

L’elaborazione delle risorse è gestita dalla configurazione definita in Profili elaborazione. Experience Manager viene fornito con una configurazione predefinita di base e consente agli amministratori di aggiungere una configurazione di elaborazione delle risorse più specifica per soddisfare i propri requisiti.

Gli amministratori sono responsabili delle seguenti attività di configurazione:

Gli sviluppatori possono estendere l’offerta predefinita personalizzando questi flussi di lavoro. Poiché il flusso di lavoro di post-elaborazione è configurabile, gli sviluppatori aggiungono passaggi di elaborazione oltre le funzionalità standard, adattando la pipeline a casi d’uso specializzati.

Relazione con il flusso di lavoro legacy Risorsa di aggiornamento DAM

Comprendere le opzioni di elaborazione delle risorse get-started

Experience Manager (AEM) supporta tre livelli progressivi di elaborazione delle risorse: Configurazione predefinita, Configurazione personalizzata e Profilo personalizzato. Queste opzioni costituiscono un modello di escalation su più livelli, che inizia con i valori predefiniti pronti per l’uso, si estende alle personalizzazioni definite dall’amministratore e si conclude con un’elaborazione nativa per il cloud completamente programmabile per i requisiti avanzati. La scelta del livello giusto dipende dal livello di controllo necessario all’organizzazione sui formati di rendering, sulle risoluzioni e sulla gestione dei tipi di file.

Formati di file supportati supported-file-formats

I microservizi per le risorse supportano un’ampia gamma di formati di file di immagine, documenti, video e audio. In questi formati supportati, i microservizi per le risorse offrono tre funzionalità principali:

La funzionalità specifica disponibile dipende dal tipo di file. Ogni formato supportato è identificato dal relativo tipo MIME (Multipurpose Internet Mail Extensions), l’identificatore standardizzato che indica al sistema come deve essere interpretato un file e quali operazioni di elaborazione vengono applicate al file.

Per l’elenco completo dei tipi MIME supportati e delle funzionalità disponibili per ogni tipo, vedere formati di file supportati.

Configurazione predefinita default-config

Experience Manager viene fornito con valori predefiniti preconfigurati che rendono immediatamente disponibili le rappresentazioni predefinite richieste dalla piattaforma. Le rappresentazioni sono le versioni alternative di una risorsa, ad esempio anteprime, miniature e derivati ottimizzati per il web, che Experience Manager genera da un caricamento originale. La configurazione predefinita garantisce inoltre che le operazioni principali vengano eseguite automaticamente, in modo che:

Di conseguenza, gli utenti possono iniziare a caricare o aggiornare le risorse immediatamente e l’elaborazione di base è disponibile per impostazione predefinita senza alcuna configurazione aggiuntiva.

Profilo di elaborazione predefinito

Con la configurazione predefinita, Experience Manager applica solo il profilo di elaborazione di base. Un profilo di elaborazione definisce il set di operazioni (rendering, gestione dei metadati ed estrazione del testo) che Experience Manager esegue sulle risorse acquisite. Questo profilo di elaborazione predefinito non è visibile nell’interfaccia utente e non è possibile modificarlo.

Questo profilo di elaborazione predefinito viene sempre eseguito per elaborare le risorse caricate, assicurandosi che l’elaborazione della linea di base richiesta da Experience Manager sia completata per ogni risorsa. Poiché viene eseguito incondizionatamente, nessuna risorsa entra nel sistema senza ricevere le rappresentazioni essenziali e le operazioni di estrazione Experience Manager dipendono da per la ricerca, l’anteprima e la consegna.

Configurazione standard standard-config

Experience Manager fornisce funzionalità per generare rappresentazioni più specifiche per i formati comuni in base alle esigenze dell’utente. Un amministratore può creare ulteriori profili di elaborazione per facilitare la creazione di copie trasformate. Gli utenti assegnano quindi uno o più profili disponibili a cartelle specifiche per eseguire l’elaborazione aggiuntiva. Ad esempio, l’elaborazione aggiuntiva può generare rappresentazioni per web, dispositivi mobili e tablet, garantendo che ogni risorsa venga consegnata a una dimensione ottimizzata per il relativo dispositivo e canale di destinazione. Guarda questo video per comprendere come creare e applicare Profili di elaborazione e come accedere alle rappresentazioni create.

Il profilo di elaborazione può includere una rappresentazione FPO (solo per posizionamento). Consulta la Adobe Asset Link documentazione per capire se devi attivarla per il tuo profilo di elaborazione. Per ulteriori informazioni, consulta la documentazione completa di Adobe Asset Link.

Creare un profilo standard create-standard-profile

Profilo personalizzato e casi d’uso custom-config

Asset Compute Service supporta un’ampia gamma di casi d’uso, inclusa l’elaborazione predefinita e l’elaborazione di formati specifici di Adobe come i file Photoshop. Il servizio consente inoltre di implementare un’elaborazione personalizzata o specifica per l’organizzazione in base a requisiti specifici. La personalizzazione che in precedenza richiedeva il flusso di lavoro Risorsa di aggiornamento di Digital Asset Management (DAM) viene ora gestita automaticamente o tramite la configurazione Profili elaborazione. Se queste opzioni di elaborazione non soddisfano esigenze aziendali specifiche, Adobe consiglia di sviluppare e distribuire Asset Compute Service per estendere le funzionalità predefinite. Per una panoramica, vedi comprendere l’estensibilità e quando utilizzarla.

Asset Compute Service trasforma immagini, video, documenti e altri formati di file in più copie trasformate, tra cui miniature, testo e metadati estratti e archivi. Questo consente alle organizzazioni di generare automaticamente le risorse derivate necessarie per la distribuzione, la ricerca e i flussi di lavoro a valle.

Gli sviluppatori possono utilizzare Asset Compute Service per creare applicazioni personalizzate per i casi d’uso supportati. Experience Manager chiama queste applicazioni personalizzate direttamente dall’interfaccia utente utilizzando profili personalizzati configurati dagli amministratori. Di conseguenza, l’elaborazione personalizzata diventa disponibile per gli utenti finali senza interventi manuali. Asset Compute Service supporta i seguenti casi d’uso per la chiamata di servizi esterni:

Creare un profilo personalizzato create-custom-profile

Un profilo di elaborazione personalizzato in Adobe Experience Manager consente agli amministratori di indirizzare le risorse a una applicazione App Builder headless che genera una o più rappresentazioni personalizzate. Per crearne uno, segui la procedura riportata di seguito:

Le applicazioni personalizzate sono applicazioni headless Project App Builder, ovvero vengono eseguite senza un’interfaccia utente e automaticamente come parte della pipeline di elaborazione delle risorse. Un’applicazione personalizzata riceve tutti i file forniti quando è associata a un profilo di elaborazione. L’applicazione deve filtrare i file, perché elabora ogni risorsa che viene trasmessa; il filtro assicura che solo i formati di file previsti e rilevanti vengano trasformati e che gli input non supportati o indesiderati vengano ignorati.

Esempio di profilo personalizzato custom-profile-example

Un profilo di elaborazione personalizzato applica testo personalizzato alle immagini della campagna utilizzando l’API Photoshopdi Adobe per modificare automaticamente tali immagini. In questo esempio viene illustrato un caso d’uso comune: l’aggiunta di sovrapposizioni di testo con marchio o specifiche della campagna alle risorse acquisite in Experience Manager.

Passaggio dei parametri del profilo personalizzato all’API Photoshop

L’integrazione di Asset Compute Service consente a Experience Manager di passare questi parametri all’applicazione personalizzata tramite il campo Parametri servizio. L’applicazione personalizzata chiama quindi l’API Photoshop e trasmette questi valori all’API. In questo modo, la logica di imaging viene eseguita in modo coerente ogni volta che una risorsa viene elaborata, anziché richiedere modifiche manuali.

Tramite il campo Parametri servizio, puoi trasmettere i seguenti parametri per aggiungere testo personalizzato alle immagini della campagna:

Figura: utilizzare il campo Parametri servizio per trasmettere le informazioni aggiunte ai parametri predefiniti incorporati nell’applicazione personalizzata. In questo esempio, poiché il profilo viene applicato al momento dell’acquisizione, il caricamento di un’immagine della campagna attiva automaticamente l’aggiornamento e le immagini vengono sottoposte a rendering con Jumanji testo nel font Arial-BoldMT.

Utilizzare i profili di elaborazione per elaborare le risorse use-profiles

Crea e applica ulteriori profili di elaborazione personalizzati a cartelle specifiche. Questo flusso di lavoro consente a Experience Manager di elaborare le risorse caricate o aggiornate in queste cartelle. Il profilo di elaborazione standard predefinito viene sempre eseguito ma non è visibile nell’interfaccia utente. Se aggiungi un profilo personalizzato, Experience Manager utilizza entrambi i profili per elaborare le risorse caricate. In questo modo l’elaborazione standard predefinita viene sempre applicata mentre vengono aggiunte le rappresentazioni personalizzate.

Metodi per applicare i profili di elaborazione alle cartelle

Applica i profili di elaborazione alle cartelle utilizzando uno dei tre metodi seguenti:

Dopo aver applicato un profilo di elaborazione a una cartella, tutte le nuove risorse caricate (o aggiornate) in tale cartella o nelle relative sottocartelle vengono elaborate automaticamente utilizzando il profilo di elaborazione aggiuntivo configurato. Di conseguenza, l’elaborazione a livello di cartella si propaga lungo l’intera struttura ad albero della cartella. Questa elaborazione si aggiunge al profilo predefinito standard.

Per verificare che le risorse siano state elaborate, visualizza l’anteprima delle rappresentazioni generate nella visualizzazione Rappresentazioni nella barra a sinistra. Apri l’anteprima della risorsa e apri la barra a sinistra per accedere alla visualizzazione Rappresentazioni. Le rappresentazioni specifiche nel profilo di elaborazione, per le quali il tipo di risorsa specifica corrisponde alle regole di inclusione del tipo MIME, sono visibili e accessibili.

Figura: esempio di due rappresentazioni aggiuntive generate da un profilo di elaborazione applicato alla cartella principale.

Workflow di post-elaborazione post-processing-workflows

Flussi di lavoro di post-elaborazione aggiungono l’elaborazione delle risorse completamente personalizzata in aggiunta all’elaborazione configurabile eseguita dai microservizi per le risorse. Utilizzali ogni volta che è necessaria un’elaborazione aggiuntiva delle risorse che non può essere ottenuta utilizzando solo i Profili di elaborazione. Aggiungendo questi flussi di lavoro alla configurazione, gli amministratori estendono Experience Manager oltre le funzionalità di elaborazione standard per soddisfare requisiti specifici.

Al termine dell’elaborazione dei microservizi, Experience Manager automaticamente esegue flussi di lavoro di post-elaborazione o flussi di lavoro con avvio automatico, se configurati. Poiché Experience Manager attiva automaticamente questi flussi di lavoro al completamento dell’elaborazione dei microservizi, non è necessario aggiungere manualmente i moduli di avvio dei flussi di lavoro. Esempi comuni includono:

Per aggiungere una configurazione del flusso di lavoro di post-elaborazione a Experience Manager, eseguire la procedura seguente:

Per informazioni dettagliate sul passaggio del flusso di lavoro standard che può essere utilizzato nel flusso di lavoro di post-elaborazione, vedere passaggi del flusso di lavoro di post-elaborazione nella documentazione per gli sviluppatori.

Creazione di modelli di flussi di lavoro di post-elaborazione in Adobe Experience Manager create-post-processing-workflow-models

I modelli di flusso di lavoro di post-elaborazione sono modelli di flusso di lavoro standard Adobe Experience Manager (AEM) utilizzati per elaborare le risorse digitali nell’archivio Digital Asset Management (DAM). Crea modelli separati quando è necessaria un’elaborazione diversa per posizioni di archivio o tipi di risorse distinti, perché la personalizzazione di un modello per ogni scenario garantisce che le risorse vengano gestite in base alle loro esigenze specifiche.

Creazione del flusso di lavoro: Assembla ogni flusso di lavoro di post-elaborazione dai passaggi di elaborazione che soddisfano le tue esigenze. Puoi combinare:

Requisito chiave — passaggio finale: L’ultimo passaggio di ogni flusso di lavoro di post-elaborazione deve essere DAM Update Asset Workflow Completed Process. Questo passaggio segnala il completamento a Experience Manager. Di conseguenza, Experience Manager riconosce quando l’elaborazione delle risorse è terminata e può cambiare lo stato della risorsa da quello in corso. Se si omette questo passaggio finale, la piattaforma non sarà in grado di rilevare il completamento dell’elaborazione e le risorse potrebbero rimanere bloccate in uno stato di flusso di lavoro non risolto.

Configurare l’esecuzione di un flusso di lavoro di post-elaborazione configure-post-processing-workflow-execution

Dopo che i microservizi per le risorse hanno completato l’elaborazione delle risorse caricate, puoi definire un flusso di lavoro di post-elaborazione per applicare alle risorse ulteriori trasformazioni, arricchimenti o operazioni personalizzate. Per configurare la post-elaborazione utilizzando i modelli di flusso di lavoro, utilizza uno dei metodi seguenti:

Applicare un modello di flusso di lavoro a una cartella apply-workflow-model-to-folder

Per casi di utilizzo tipici di post-elaborazione, applica un flusso di lavoro direttamente a una cartella. Si tratta dell’approccio più semplice e comune. Per applicare un modello di flusso di lavoro nella cartella Proprietà, eseguire la procedura seguente:

Configurare il servizio Custom Workflow Runner configure-custom-workflow-runner-service

Configura il servizio Custom Workflow Runner per configurazioni avanzate che non possono essere facilmente soddisfatte applicando un flusso di lavoro a una cartella. Ad esempio, un flusso di lavoro che utilizza un’espressione regolare per eseguire selettivamente il targeting di percorsi di risorse specifici. Questo servizio è utile perché consente di mappare diversi modelli di flusso di lavoro a percorsi di archivio o modelli di denominazione diversi, che non possono essere ottenuti solo dalla configurazione a livello di cartella. Adobe CQ Digital Asset Management (DAM) Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) è un servizio OSGi (Open Service Gateway initiative). Per la configurazione sono disponibili le due opzioni seguenti:

Per informazioni su come distribuire una configurazione OSGi, vedere distribuire in Experience Manager.

Disattiva esecuzione flusso di lavoro di post-elaborazione

Se la post-elaborazione non è necessaria, disabilitare l’esecuzione creando e applicando un modello di flusso di lavoro “vuoto” nella selezione Flusso di lavoro con avvio automatico. In questo modo si evita l’elaborazione di flussi di lavoro non necessari per le cartelle che non la richiedono.

Creare il modello di flusso di lavoro con avvio automatico disattivato

Applicare il modello di flusso di lavoro con avvio automatico disattivato

Segui i passaggi descritti in Applica un modello di flusso di lavoro a una cartella e imposta Disattiva flusso di lavoro con avvio automatico come Flusso di lavoro con avvio automatico per le cartelle che non richiedono la post-elaborazione delle risorse.

Best practice e limitazioni best-practices-limitations-tips

Best practice

Limitazioni correnti

Consulta anche