Utilizzare i microservizi delle risorse e i profili di elaborazione

I microservizi per le risorse forniscono un’elaborazione scalabile e resiliente delle risorse utilizzando applicazioni native per il cloud (o processi di lavoro). Adobe gestisce i servizi per una gestione ottimale dei diversi tipi di risorse e opzioni di elaborazione.

I microservizi per le risorse consentono di elaborare un ampia gamma di tipi di file con più formati pronti all'uso rispetto alle versioni precedenti di Experience Manager. Ad esempio, l’estrazione delle miniature dei formati PSD e PSB è ora possibile, ma in precedenza era necessaria una soluzione di terze parti come ImageMagick.

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

Comprendere le opzioni di elaborazione delle risorse

Experience Manager consente i seguenti livelli di elaborazione.

Formati di file supportati

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

Configurazione predefinita

Alcuni valori predefiniti sono preconfigurati per garantire la disponibilità dei rendering predefiniti richiesti in Experience Manager. La configurazione predefinita garantisce inoltre la disponibilità delle operazioni di estrazione dei metadati e di estrazione del testo. Gli utenti possono iniziare a caricare o aggiornare le risorse immediatamente e l’elaborazione di base è disponibile per impostazione predefinita.

Con la configurazione predefinita, viene configurato solo il profilo di elaborazione più semplice. Tale profilo di elaborazione non è visibile sull’interfaccia utente e non è possibile modificarlo. Viene sempre eseguito l’elaborazione delle risorse caricate. Tale profilo di elaborazione predefinito assicura che l'elaborazione di base richiesta da Experience Manager viene completato per tutte le risorse.

Configurazione standard

Experience Manager fornisce funzionalità per generare rappresentazioni più specifiche per i formati comuni in base alle esigenze dell'utente. Un amministratore può creare Profili di elaborazione per facilitare la creazione di copie trasformate. Gli utenti quindi assegnano 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. Il video seguente illustra come creare e applicare Profili di elaborazione e come accedere alle rappresentazioni create.

• Larghezza e altezza del rendering: Le specifiche relative a larghezza e altezza del rendering forniscono le dimensioni massime dell'immagine di output generata. I microservizi per le risorse cercano di produrre il rendering più grande possibile, che larghezza e altezza non sono rispettivamente più grandi della larghezza e dell’altezza specificate. Il rapporto di formato viene mantenuto, ovvero lo stesso 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 rendering. Se corrisponde a tale elenco, questo rendering specifico non viene generato per la risorsa (ad elenco Bloccati). In caso contrario, il tipo MIME viene controllato rispetto al tipo MIME incluso e, se corrisponde all’elenco, il rendering viene generato (elenco Consentiti).

• Rendering FPO speciale: Quando si inseriscono risorse di grandi dimensioni da Experience Manager in Adobe InDesign documenti, un creativo professionista attende per un tempo considerevole dopo inserire una risorsa. Nel frattempo, all'utente è impedito di utilizzare InDesign. Questo interrompe il flusso creativo e influisce negativamente sull’esperienza utente. L’Adobe consente di inserire temporaneamente rappresentazioni di piccole dimensioni in InDesign i documenti con cui iniziare, che possono essere sostituiti successivamente con risorse a risoluzione completa on-demand. Experience Manager fornisce rappresentazioni utilizzate solo per il posizionamento (FPO). Queste rappresentazioni FPO hanno dimensioni file ridotte ma hanno le stesse proporzioni.

Il profilo di elaborazione può includere un rendering FPO (solo posizionamento). Vedi Adobe Asset Link documentazione per capire se è necessario attivarlo per il profilo di elaborazione. Per ulteriori informazioni, consulta Documentazione completa di Adobe Asset Link.

Creare un profilo standard

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

1. Accesso amministratori Strumenti > Risorse > Profili di elaborazione. Fai clic su Crea.

2. Specifica un nome che ti aiuti a identificare in modo univoco il profilo quando lo applichi a una cartella.

3. Per generare rappresentazioni FPO, nella pagina Immagine abilita Crea rappresentazione FPO. Ingresso a Qualità tra 1 e 100.

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

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

   

5. Fai clic su Salva.

Casi di utilizzo e di profilo personalizzati

La Asset Compute Service supporta diversi casi d’uso, ad esempio l’elaborazione predefinita, l’elaborazione di formati specifici per Adobi come i file Photoshop e l’implementazione di un’elaborazione personalizzata o specifica per l’organizzazione. La personalizzazione del flusso di lavoro Risorsa di aggiornamento DAM 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 estendere le funzionalità predefinite. Per una panoramica, vedi comprendere l’estensibilità e quando utilizzarla.

Può trasformare immagini, video, documenti e altri formati di file in diverse rappresentazioni, quali miniature, testo e metadati estratti e archivi.

Gli sviluppatori possono utilizzare Asset Compute Service a creare applicazioni personalizzate per i casi d’uso supportati. Experience Manager può chiamare queste applicazioni personalizzate dall’interfaccia utente utilizzando profili personalizzati configurati dagli amministratori. Asset Compute Service supporta i seguenti casi d’uso per richiamare servizi esterni:

• Utilizzo Adobe Photoshops API ImageCutout e salvare il risultato come rendering.
• Invoca sistemi di terze parti per aggiornare i dati, ad esempio un sistema PIM.
• Utilizzo Photoshop API per generare diverse rappresentazioni basate su modelli Photoshop.
• Utilizzo API Adobe Lightroom per ottimizzare le risorse acquisite e salvarle come rappresentazioni.

Creare un profilo personalizzato

Per creare un profilo personalizzato, effettua le seguenti operazioni:

1. Accesso amministratori Strumenti > Risorse > Profili di elaborazione. Fai clic su Crea.

2. Fai clic su Personalizzato scheda . Fai clic su Aggiungi nuovo. Specifica il nome file desiderato per il rendering.

3. Fornisci le seguenti informazioni.

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

   Fai clic su Salva.

Le applicazioni personalizzate sono headless Progetto Firefly app. 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. Puoi creare un profilo di elaborazione che sfrutta l’API Photoshop per modificare le immagini.

L’integrazione di Asset compute Service consente ad Experience Manager di trasmettere questi parametri all’applicazione personalizzata utilizzando Parametri del servizio campo . L’applicazione personalizzata chiama quindi l’API Photoshop e trasmette questi valori all’API. Ad esempio, puoi passare il nome del font, il colore del testo, il peso del testo e le dimensioni del testo per aggiungere il testo personalizzato alle immagini della campagna.

Figura: Utilizzo Parametri del servizio per passare informazioni aggiunte ai parametri predefiniti generati nell’applicazione personalizzata. In questo esempio, quando le immagini della campagna vengono caricate, le immagini vengono aggiornate con Jumanji testo in Arial-BoldMT font.

Utilizzare i profili di elaborazione per elaborare le risorse

Crea e applica i profili di elaborazione aggiuntivi e personalizzati a cartelle specifiche, ad 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 aggiungi un profilo personalizzato, entrambi i profili vengono utilizzati per elaborare le risorse caricate.

Applica 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 utilizza Applica profilo a cartelle azione. Apre un browser dei contenuti che ti consente di navigare in cartelle specifiche, selezionarle e confermare l’applicazione del profilo.

• Gli utenti possono selezionare una cartella nell’interfaccia utente di Assets, utilizzando Proprietà per aprire la schermata delle proprietà della cartella, fai clic sul pulsante Elaborazione delle risorse e nella Profilo di elaborazione selezionare il profilo di elaborazione appropriato per la cartella. Per salvare le modifiche, fai clic su Salva e chiudi.
  

• Per applicare un profilo di elaborazione, gli utenti possono selezionare cartelle o risorse specifiche nell’interfaccia utente di Assets, quindi selezionare Rielaborazione delle risorse tra le opzioni disponibili nella parte superiore.

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

Per verificare che le risorse siano state elaborate, visualizza in anteprima le rappresentazioni generate nel Rendering nella barra a sinistra. Apri l’anteprima della risorsa e apri la barra a sinistra per accedere al Rendering visualizza. 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 di post-elaborazione

In una situazione in cui è necessaria un’elaborazione aggiuntiva delle risorse che non può essere ottenuta utilizzando i profili di elaborazione, è possibile aggiungere alla configurazione flussi di lavoro aggiuntivi di post-elaborazione. La post-elaborazione consente di aggiungere un’elaborazione completamente personalizzata oltre all’elaborazione configurabile tramite i microservizi per le risorse.

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

• Passaggi del flusso di lavoro personalizzati per elaborare le 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.

Per aggiungere una configurazione del flusso di lavoro di post-elaborazione a Experience Manager, segui questi passaggi:

• Crea uno o più modelli di flusso di lavoro. Questi modelli personalizzati sono denominati modelli di flusso di lavoro di post-elaborazione in questa documentazione. Sono regolari Experience Manager modelli di flusso di lavoro.
• Aggiungi i passaggi del flusso di lavoro richiesti a questi modelli. Esamina i passaggi dal flusso di lavoro predefinito e aggiungi tutti i passaggi predefiniti richiesti al flusso di lavoro personalizzato. I passaggi vengono eseguiti sulle risorse in base alla configurazione di un modello di flusso di lavoro. Ad esempio, se desideri che l’assegnazione tag avanzati avvenga automaticamente al momento del caricamento delle risorse, aggiungi il passaggio al modello di flusso di lavoro di post-elaborazione personalizzato.
• Aggiungi Processo completato flusso di lavoro risorse di aggiornamento DAM passo alla fine. L’aggiunta di questo passaggio garantisce che l’Experience Manager sappia quando termina l’elaborazione e che la risorsa possa essere contrassegnata come elaborata, ovvero Nuovo viene visualizzato sulla risorsa.
• Crea una configurazione per il servizio Custom Workflow Runner Service che consente di configurare l’esecuzione di un modello di flusso di lavoro post-elaborazione tramite un percorso (posizione della cartella) o tramite un’espressione regolare.

Per informazioni dettagliate su quale passaggio del flusso di lavoro standard può essere utilizzato nel flusso di lavoro di post-elaborazione, vedi passaggi del flusso di lavoro nel flusso di lavoro di post-elaborazione in riferimento per gli sviluppatori.

Creare modelli di flusso di lavoro di post-elaborazione

I modelli di flusso di lavoro di post-elaborazione sono regolari Experience Manager modelli di flusso di lavoro. Crea modelli diversi se hai bisogno di un’elaborazione diversa per posizioni di archivio o tipi di risorse diversi.

Le fasi di elaborazione vengono aggiunte in base alle esigenze. Puoi utilizzare entrambi i passaggi supportati disponibili, nonché tutti i passaggi del flusso di lavoro implementati personalizzati.

Assicurati che l’ultimo passaggio di ogni flusso di lavoro di post-elaborazione sia DAM Update Asset Workflow Completed Process. L’ultimo passaggio consente ad Experience Manager di sapere quando viene completata l’elaborazione delle risorse.

Configurare l’esecuzione del flusso di lavoro di post-elaborazione

Al termine dell’elaborazione delle risorse caricate, i microservizi per le risorse possono definire il flusso di lavoro di post-elaborazione per elaborare ulteriormente le risorse. Per configurare la post-elaborazione utilizzando i modelli di flusso di lavoro, puoi effettuare una delle seguenti operazioni:

• Applicare un modello di flusso di lavoro nelle proprietà della cartella.
• Configurare il servizio Workflow Runner personalizzato.

Applicare un modello di flusso di lavoro a una cartella

Per i casi d’uso tipici di post-elaborazione, considera l’utilizzo del metodo per applicare un flusso di lavoro a una cartella. Applicazione di un modello di flusso di lavoro nella cartella Proprietà, segui questi passaggi:

1. Crea un modello di flusso di lavoro.

2. Seleziona una cartella e fai clic su Proprietà dalla barra degli strumenti, quindi fare clic su Elaborazione delle risorse scheda .

3. Sotto Flusso di lavoro con avvio automatico, seleziona il flusso di lavoro richiesto, fornisci un titolo del flusso di lavoro, quindi salva le modifiche.

   

Configurare il servizio Workflow Runner personalizzato

Puoi configurare il servizio di esecuzione dei flussi di lavoro personalizzato per le 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. Il Runner flusso di lavoro personalizzato Adobe CQ DAM (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) è un servizio OSGi. Fornisce le due opzioni seguenti per la configurazione:

• Flussi di lavoro di post-elaborazione per percorso (postProcWorkflowsByPath): È possibile elencare più modelli di flusso di lavoro, basati su diversi percorsi di archivio. Separa i percorsi e i modelli utilizzando due punti. Sono supportati percorsi archivio semplici. Mappatura di questi elementi su un modello di flusso di lavoro nel /var percorso. 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 su come distribuire una configurazione OSGi, vedi distribuire Experience Manager.

Best practice e limitazioni

• Considera le tue esigenze per tutti i tipi di rendering durante la progettazione dei flussi di lavoro. Se non prevedete la necessità di un rendering in futuro, rimuovete il relativo 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, puoi rimuovere manualmente i rendering dall’interfaccia utente. Per più risorse, puoi personalizzare Experience Manager per eliminare rappresentazioni specifiche o eliminare le risorse e caricarle di nuovo.
• Al momento, il supporto è limitato alla generazione di rappresentazioni. La generazione di nuove risorse non è supportata.
• Attualmente, il limite di dimensione del file per l’estrazione dei metadati è di circa 15 GB. Quando si caricano risorse di grandi dimensioni, a volte l’operazione di estrazione dei metadati non riesce.