Utilizzare i microservizi delle risorse e i profili di elaborazione

I microservizi delle risorse consentono l’elaborazione scalabile e resiliente delle risorse mediante applicazioni native per il cloud (o "lavoratori"). Adobe gestisce i servizi per una gestione ottimale dei diversi tipi di risorse e opzioni di elaborazione.

I microservizi delle risorse consentono di elaborare una vasta gamma di tipi di file che include più formati out-of-the-box di quanto sia possibile con le versioni precedenti di Experience Manager. Ad esempio, l'estrazione delle miniature dei formati PSD e PSB ora è possibile che soluzioni di terze parti come ImageMagick precedentemente richieste.

L'elaborazione delle risorse dipende dalla configurazione in Profili di elaborazione. Experience Manager fornisce una configurazione di base predefinita e consente agli amministratori di aggiungere una configurazione di elaborazione delle risorse più specifica. Gli amministratori creano, mantengono e modificano le configurazioni dei flussi di lavoro post-elaborazione, inclusa la personalizzazione facoltativa. La personalizzazione dei flussi di lavoro consente agli sviluppatori di ampliare l'offerta predefinita.

Informazioni sulle opzioni di elaborazione delle risorse

Experience Manager consente i seguenti livelli di elaborazione.

Opzione	Descrizione	Casi di utilizzo coperti
Configurazione predefinita	È disponibile così come è e non può essere modificato. Questa configurazione fornisce funzionalità di generazione delle rappresentazioni di base.	Miniature standard utilizzate dall'interfaccia utente Assets (48, 140 e 319 pixel) Anteprima grande (rappresentazione Web - 1280 pixel) Estrazione di metadati e testo.
Configurazione personalizzata	Configurato dagli amministratori tramite l'interfaccia utente. Offre più opzioni per la generazione della rappresentazione, estendendo l'opzione predefinita. Estendete l’opzione out-of-the-box per fornire formati e rappresentazioni diversi.	Rendering FPO. Modificare il formato file e la risoluzione delle immagini Applicabile in modo condizionale ai tipi di file configurati.
Profilo personalizzato	Configurato dagli amministratori tramite l'interfaccia utente per utilizzare il codice personalizzato attraverso le applicazioni personalizzate per chiamare Asset compute Service. Supporta requisiti più complessi in un metodo scalabile e nativo per il cloud.	Vedere casi di utilizzo consentiti.

Formati di file supportati

I microservizi delle risorse supportano un’ampia varietà di formati di file per elaborare, generare rappresentazioni o estrarre metadati. Vedere formati di file supportati per l'elenco completo dei tipi MIME e le funzionalità supportate per ciascun tipo.

Configurazione predefinita

Alcune impostazioni predefinite sono preconfigurate per garantire la disponibilità delle rappresentazioni predefinite richieste nel Experience Manager. La configurazione predefinita garantisce inoltre la disponibilità di operazioni di estrazione dei metadati e di estrazione del testo. Gli utenti possono iniziare a caricare o aggiornare immediatamente le risorse e per impostazione predefinita è disponibile l’elaborazione di base.

Con la configurazione predefinita, è configurato solo il profilo di elaborazione di base. Tale profilo di elaborazione non è visibile nell'interfaccia utente e non è possibile modificarlo. Viene sempre eseguito per elaborare le risorse caricate. Questo profilo di elaborazione predefinito garantisce che l'elaborazione di base richiesta da Experience Manager sia completata su tutte le risorse.

Configurazione standard

Experience Manager forniscono funzionalità per generare rappresentazioni più specifiche per i formati comuni in base alle esigenze dell'utente. Un amministratore può creare Profili di elaborazione aggiuntivi per facilitare la creazione di rappresentazioni. Gli utenti quindi assegnano uno o più dei profili disponibili a cartelle specifiche per completare l’elaborazione aggiuntiva. Ad esempio, l'elaborazione aggiuntiva può generare rappresentazioni per Web, dispositivi mobili e tablet. Il seguente video illustra come creare e applicare Profili di elaborazione e come accedere alle rappresentazioni create.

• Larghezza e altezza rappresentazione: Le specifiche relative a larghezza e altezza della rappresentazione forniscono le dimensioni massime dell’immagine di output generata. I microservizi risorse cercano di produrre la rappresentazione più grande possibile, che larghezza e altezza non sono maggiori rispettivamente della larghezza e dell’altezza specificate. Le proporzioni vengono mantenute, ovvero sono uguali a quelle dell’originale. Un valore vuoto indica che l'elaborazione delle risorse assume la dimensione in pixel dell'originale.

• Regole di inclusione del tipo MIME: Quando viene elaborata una risorsa con un tipo MIME specifico, il tipo MIME viene prima controllato rispetto al valore dei tipi MIME esclusi per la specifica di rappresentazione. Se corrisponde a tale elenco, questa rappresentazione specifica non viene generata per la risorsa (elenco Bloccati ). In caso contrario, il tipo MIME viene controllato rispetto al tipo MIME incluso e, se corrisponde all'elenco, viene generata la rappresentazione ( elenco Consentiti).

• Rappresentazioni FPO speciali: Quando si inseriscono risorse di grandi dimensioni Experience Manager in Adobe InDesign documenti, un creativo professionista attende molto tempo dopo aver inserito una risorsa. Nel frattempo, l'utente non può utilizzare InDesign. Questo interrompe il flusso creativo e influisce negativamente sull'esperienza dell'utente. Adobe consente di inserire temporaneamente le rappresentazioni di piccole dimensioni nei documenti InDesign, da sostituire successivamente con risorse a risoluzione piena su richiesta. Experience Manager fornisce rappresentazioni utilizzate solo per il posizionamento (FPO). Tali rappresentazioni FPO hanno una dimensione file ridotta ma hanno le stesse proporzioni.

Il profilo di elaborazione può includere una rappresentazione FPO (solo per posizionamento). Per informazioni su come attivarla per il profilo di elaborazione, vedere Adobe Asset Link documentazione. Per ulteriori informazioni, consultate la documentazione completa collegamento risorse di Adobe.

Creare un profilo standard

Per creare un profilo di elaborazione standard, effettuate le seguenti operazioni:

1. Gli amministratori accedono a Strumenti > Risorse > Profili di elaborazione. Fai clic su Crea.

2. Specificate un nome che consenta di identificare in modo univoco il profilo quando si applica a una cartella.

3. Per generare le rappresentazioni FPO, nella scheda Standard abilitare Crea rappresentazione FPO. Immettete un valore Quality compreso tra 1 e 100.

4. Per generare altre rappresentazioni, fate clic su Aggiungi nuovo e fornite le seguenti informazioni:

   • Nome file di ogni rappresentazione.
   • Formato file (PNG, JPEG, GIF o WebP) di ciascuna rappresentazione.
   • Larghezza e altezza in pixel di ciascuna rappresentazione. Se i valori non sono specificati, viene usata la dimensione in pixel dell’immagine originale.
   • Qualità in percentuale di ciascuna rappresentazione JPEG e WebP.
   • Tipi MIME inclusi ed esclusi per definire l'applicabilità di un profilo.

   

5. Fai clic su Salva.

Profilo personalizzato e casi di utilizzo

Asset Compute Service supporta una serie di casi d'uso, ad esempio l'elaborazione predefinita, l'elaborazione formati specifici del Adobe come i file Photoshop e l'implementazione di un'elaborazione personalizzata o specifica per l'organizzazione. La personalizzazione del flusso di lavoro di DAM Update Asset richiesta in passato, viene gestita automaticamente o tramite la configurazione dei profili di elaborazione. Se queste opzioni di elaborazione non soddisfano le esigenze aziendali, Adobe consiglia di sviluppare e utilizzare Asset Compute Service per estendere le funzionalità predefinite. Per una panoramica, vedere comprendere l'estensibilità e quando utilizzarla.

Può trasformare immagini, video, documenti e altri formati di file in diverse rappresentazioni, come miniature, testo estratto e metadati, nonché archivi.

Gli sviluppatori possono utilizzare Asset Compute Service per creare applicazioni personalizzate per i casi di utilizzo supportati. Experience Manager possono chiamare queste applicazioni personalizzate dall'interfaccia utente utilizzando profili personalizzati che gli amministratori configurano. Asset Compute Service supporta i seguenti casi di utilizzo di servizi esterni:

• Utilizzate Adobe Photoshop's ImageCutout API e salvate il risultato come rappresentazione.
• Chiama sistemi di terze parti per aggiornare i dati, ad esempio un sistema PIM.
• Utilizzate l'API Photoshop per generare diverse rappresentazioni basate sul modello Photoshop.
• Utilizzate l'API Lightroom Adobe per ottimizzare le risorse acquisite e salvarle come rappresentazioni.

Creare un profilo personalizzato

Per creare un profilo personalizzato, attenetevi alla procedura seguente:

1. Gli amministratori accedono a Strumenti > Risorse > Profili di elaborazione. Fai clic su Crea.

2. Fare clic sulla scheda Personalizzato. Fare clic su Aggiungi nuovo. Specificate il nome file desiderato per la rappresentazione.

3. Fornite le seguenti informazioni.

   • Nome file di ogni rappresentazione e estensione file supportata.
   • URL punto finale di un'app Firefly personalizzata. L'app deve provenire dalla stessa organizzazione dell'account del Experience Manager .
   • Aggiungi parametri di servizio a trasmettere informazioni o parametri aggiuntivi all'applicazione personalizzata.
   • Sono inclusi ed esclusi i tipi MIME per limitare l'elaborazione ad alcuni formati di file specifici.

   Fai clic su Salva.

Le applicazioni personalizzate sono app Project Firefly senza testa. L'applicazione personalizzata ottiene tutti i file forniti se sono configurati con un profilo di elaborazione. L'applicazione deve filtrare i file.

Esempio di profilo personalizzato

Per illustrare l'utilizzo del profilo personalizzato, consideriamo un caso d'uso per applicare del testo personalizzato alle immagini della campagna. Potete creare un profilo di elaborazione che sfrutta l'API di Photoshop per modificare le immagini.

'integrazione del servizio di Asset compute consente Experience Manager di trasmettere questi parametri all'applicazione personalizzata utilizzando il campo Service Parameters. L'applicazione personalizzata chiama quindi l'API Photoshop e trasmette questi valori all'API. Ad esempio, potete trasmettere il nome del font, il colore del testo, lo spessore del testo e la dimensione del testo per aggiungere il testo personalizzato alle immagini della campagna.

Figura: Utilizzate Service Parameters field per trasmettere informazioni aggiunte ai parametri predefiniti creati nell'applicazione personalizzata. In questo esempio, quando le immagini della campagna vengono caricate, le immagini vengono aggiornate con il testo Jumanji nel font Arial-BoldMT.

Utilizzare i profili di elaborazione per elaborare le risorse

Potete creare e applicare profili di elaborazione personalizzati aggiuntivi a cartelle specifiche per Experience Manager per 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 aggiungete un profilo personalizzato, entrambi i profili vengono utilizzati per elaborare le risorse caricate.

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

• Gli amministratori possono selezionare una definizione di profilo di elaborazione in Strumenti > Risorse > Profili di elaborazione e utilizzare l'azione Applica profilo alle cartelle. Viene aperto un browser del contenuto che consente di passare a cartelle specifiche, selezionarle e confermare l’applicazione del profilo.
• Gli utenti possono selezionare una cartella nell'interfaccia utente Risorse, utilizzare l'azione Proprietà per aprire la schermata delle proprietà della cartella, fare clic sulla scheda Profili di elaborazione e, nell'elenco a comparsa, selezionare il profilo di elaborazione appropriato per quella cartella. Per salvare le modifiche, fare clic su Salva e chiudi.
  

Dopo aver applicato un profilo di elaborazione a una cartella, tutte le nuove risorse caricate (o aggiornate) in questa cartella o in una delle sottocartelle vengono elaborate utilizzando il profilo di elaborazione aggiuntivo configurato. Questa elaborazione si aggiunge al profilo standard predefinito.

Per verificare che le risorse siano state elaborate, visualizzate l'anteprima delle rappresentazioni generate nella vista Rappresentazioni nella parte sinistra. Aprite l'anteprima delle risorse e aprite la barra a sinistra per accedere alla vista Rappresentazioni. Le rappresentazioni specifiche nel profilo di elaborazione, per le quali il tipo di risorsa specifico corrisponde alle regole di inclusione del tipo MIME, devono essere visibili e accessibili.

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

Flussi di lavoro post-elaborazione

Per situazioni in cui è necessaria un’ulteriore elaborazione delle risorse che non può essere ottenuta utilizzando i profili di elaborazione, alla configurazione possono essere aggiunti ulteriori flussi di lavoro di post-elaborazione. Questo consente di aggiungere un'elaborazione completamente personalizzata al di sopra dell'elaborazione configurabile tramite i microservizi delle risorse.

I flussi di lavoro post-elaborazione, se configurati, vengono eseguiti automaticamente da Experience Manager al termine dell'elaborazione dei microservizi. Non è necessario aggiungere manualmente gli avviatori del flusso di lavoro per attivarli. Gli esempi includono:

• Passaggi del flusso di lavoro personalizzati per l’elaborazione delle risorse.
• Integrazioni per aggiungere metadati o proprietà alle risorse da sistemi esterni, ad esempio informazioni su prodotti o processi.
• Elaborazione aggiuntiva eseguita da servizi esterni.

L'aggiunta di una configurazione di flusso di lavoro post-elaborazione a Experience Manager comprende i seguenti passaggi:

• Creare uno o più modelli di workflow. Nei documenti viene indicato come modelli di flusso di lavoro post-elaborazione, ma si tratta di modelli di flusso di lavoro Experience Manager standard.
• A questi modelli potete aggiungere specifici passaggi del flusso di lavoro. I passaggi vengono eseguiti sulle risorse in base alla configurazione di un modello di workflow.
• Aggiungete il passaggio Flusso di lavoro aggiornamento risorse DAM Completato alla fine. L'aggiunta di questo passaggio fa sì che Experience Manager sappia quando l'elaborazione termina e la risorsa può essere contrassegnata come elaborata, ovvero New viene visualizzata sulla risorsa.
• Create una configurazione per il servizio Custom Workflow Runner Service che consenta di configurare l'esecuzione di un modello di flusso di lavoro post-elaborazione tramite un percorso (percorso della cartella) o mediante un'espressione regolare.

Creare modelli di flusso di lavoro post-elaborazione

I modelli di flusso di lavoro post-elaborazione sono normali modelli di flusso di lavoro Experience Manager. Create modelli diversi se avete bisogno di un'elaborazione diversa per diverse posizioni di repository o tipi di risorse.

Le fasi di elaborazione devono essere aggiunte in base alle esigenze. Potete utilizzare tutti i passaggi supportati disponibili, nonché eventuali passaggi di flusso di lavoro implementati personalizzati.

Assicurarsi che l'ultimo passaggio di ogni flusso di lavoro di post-elaborazione sia DAM Update Asset Workflow Completed Process. L’ultimo passaggio consente di garantire che Experience Manager sia a conoscenza del completamento dell’elaborazione delle risorse.

Configurare l'esecuzione del flusso di lavoro post-elaborazione

Per configurare i modelli di flusso di lavoro post-elaborazione da eseguire per le risorse caricate o aggiornate nel sistema al termine dell’elaborazione dei microservizi di risorse, è necessario configurare il servizio Custom Workflow Runner.

Il servizio Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) è un servizio OSGi e offre due opzioni per la configurazione:

• Flussi di lavoro di post-elaborazione per percorso (postProcWorkflowsByPath): È possibile elencare più modelli di workflow, basati su percorsi di repository diversi. I percorsi e i modelli devono essere separati da due punti. I percorsi dell'archivio semplici sono supportati e devono essere mappati su un modello di workflow nel percorso /var. Esempio: /content/dam/my-brand:/var/workflow/models/my-workflow.
• Flussi di lavoro di post-elaborazione per espressione (postProcWorkflowsByExpression): È possibile elencare più modelli di flusso di lavoro, in base a diverse espressioni regolari. Le espressioni e i modelli devono essere separati da due punti. L'espressione regolare deve puntare direttamente al nodo Asset, e non a una delle rappresentazioni o dei file. Esempio: /content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.

Per informazioni dettagliate sul passaggio del flusso di lavoro standard da utilizzare nel flusso di lavoro di post-elaborazione, consultate passaggi del flusso di lavoro nel flusso di lavoro di post-elaborazione nel riferimento per lo sviluppatore.

Best practice e limitazioni

• Considerate le vostre esigenze per tutti i tipi di rappresentazioni durante la progettazione di flussi di lavoro. Se non prevedete la necessità di una rappresentazione in futuro, rimuovete il passaggio di creazione dal flusso di lavoro. Le rappresentazioni non possono essere eliminate in blocco in seguito. Le rappresentazioni indesiderate possono occupare molto spazio di archiviazione dopo un uso prolungato di Experience Manager. Per le singole risorse, potete rimuovere manualmente i rendering dall’interfaccia utente. Per più risorse, potete personalizzare Experience Manager per eliminare rappresentazioni specifiche oppure eliminare le risorse e caricarle di nuovo.
• Al momento, il supporto è limitato alla generazione di rappresentazioni. La generazione di nuova risorsa non è supportata.
• Attualmente, la dimensione massima per l’estrazione dei metadati è di circa 10 GB. Quando si caricano risorse molto grandi, talvolta l’operazione di estrazione dei metadati non riesce.