Adobe Experience Manager Assets viene fornito con un set di flussi di lavoro predefiniti e gestori di contenuti multimediali per elaborare le risorse. Un flusso di lavoro definisce le attività da eseguire sulle risorse, quindi delega le attività specifiche ai gestori dei contenuti multimediali, ad esempio la generazione di miniature o l’estrazione dei metadati.
Puoi configurare un flusso di lavoro per l’esecuzione automatica quando viene caricata una risorsa di un particolare tipo MIME. Le fasi di elaborazione sono definite in termini di una serie di Assets gestori di contenuti multimediali. Experience Manager fornisce alcuni gestori incorporati, e quelli aggiuntivi possono essere sviluppato su misura o definito delegando il processo a un strumento a riga di comando.
I gestori di file multimediali sono servizi in Assets che esegue azioni specifiche sulle risorse. Ad esempio, quando un file audio MP3 viene caricato in Experience Manager, un flusso di lavoro attiva un gestore MP3 che estrae i metadati e genera una miniatura. I gestori di file multimediali vengono generalmente utilizzati in combinazione con i flussi di lavoro. I tipi MIME più comuni sono supportati in Experience Manager. È possibile eseguire attività specifiche sulle risorse estendendo/creando flussi di lavoro, estendendo/creando gestori di contenuti multimediali o disabilitando/abilitando gestori di contenuti multimediali.
Consulta la sezione Formati supportati da Assets per una descrizione di tutti i formati supportati da Assets e funzioni supportate per ogni formato.
I seguenti gestori di contenuti multimediali sono disponibili in Assets e gestisce i tipi MIME più comuni:
Nome gestore | Nome del servizio (nella console del sistema) | Tipi MIME supportati |
---|---|---|
TextHandler | com.day.cq.dam.core.impl.handler.TextHandler | text/plain |
PdfHandler | com.day.cq.dam.handler.standard.pdf.PdfHandler |
|
JpegHandler | com.day.cq.dam.core.impl.handler.JpegHandler | image/jpeg |
Mp3Handler | com.day.cq.dam.handler.standard.mp3.Mp3Handler | audio/mpeg Importante - Quando si carica un file MP3, è elaborati utilizzando una libreria di terze parti. La libreria calcola una lunghezza approssimativa non accurata se il MP3 ha un bitrate variabile (VBR). |
ZipHandler | com.day.cq.dam.handler.standard.zip.ZipHandler |
|
PictHandler | com.day.cq.dam.handler.standard.pict.PictHandler | immagine/immagine |
StandardImageHandler | com.day.cq.dam.core.impl.handler.StandardImageHandler |
|
MSOfficeHandler | com.day.cq.dam.handler.standard.msoffice.MSOfficeHandler | application/msword |
MSPowerPointHandler | com.day.cq.dam.handler.standard.msoffice.MSPowerPointHandler | application/vnd.ms-powerpoint |
OpenOfficeHandler | com.day.cq.dam.handler.standard.ooxml.OpenOfficeHandler |
|
EPubHandler | com.day.cq.dam.handler.standard.epub.EPubHandler | application/epub+zip |
GenericAssetHandler | com.day.cq.dam.core.impl.handler.GenericAssetHandler | fallback nel caso in cui non sia stato trovato nessun altro gestore per estrarre dati da una risorsa |
Tutti i gestori eseguono le seguenti attività:
Per visualizzare i gestori di contenuti multimediali attivi:
https://localhost:4502/system/console/components
.com.day.cq.dam.core.impl.store.AssetStoreImpl
.I gestori di file multimediali sono servizi solitamente utilizzati in combinazione con i flussi di lavoro.
Experience Manager dispone di alcuni flussi di lavoro predefiniti per elaborare le risorse. Per visualizzarli, apri la console Flusso di lavoro e fai clic sul pulsante Modelli scheda: i titoli del flusso di lavoro che iniziano con Assets sono le risorse specifiche.
I flussi di lavoro esistenti possono essere estesi e possono essere creati nuovi per elaborare le risorse in base a requisiti specifici.
L’esempio seguente mostra come migliorare il flusso di lavoro di Sincronizzazione AEM Assets in modo che vengano generate le risorse secondarie di tutte le risorse, eccetto i documenti PDF.
I gestori di contenuti multimediali possono essere disattivati o abilitati tramite la console di gestione web Apache Felix. Quando il gestore multimediale è disabilitato, le sue attività non vengono eseguite sulle risorse.
Per abilitare/disabilitare un gestore di file multimediali:
https://<host>:<port>/system/console/components
.com.day.cq.dam.handler.standard.mp3.Mp3Handler
.Per supportare un nuovo tipo di supporto o per eseguire attività specifiche su una risorsa, è necessario creare un nuovo gestore di contenuti multimediali. Questa sezione descrive come procedere.
Il modo migliore per avviare un’implementazione consiste nell’ereditare da un’implementazione astratta fornita che si occupa della maggior parte delle cose e fornisce un comportamento predefinito ragionevole: la com.day.cq.dam.core.AbstractAssetHandler
classe.
Questa classe fornisce già un descrittore di servizio astratto. Quindi, se erediti da questa classe e utilizzi il maven-sling-plugin, assicurati di impostare il flag di ereditarietà su true
.
Implementa i seguenti metodi:
extractMetadata()
: estrae tutti i metadati disponibili.getThumbnailImage()
: crea una miniatura della risorsa passata.getMimeTypes()
: restituisce i tipi MIME della risorsa.Ecco un esempio di modello:
package my.own.stuff; /** * @scr.component inherit="true" * @scr.service */ public class MyMediaHandler extends com.day.cq.dam.core.AbstractAssetHandler { // implement the relevant parts }
L'interfaccia e le classi includono:
com.day.cq.dam.api.handler.AssetHandler
interfaccia: Questa interfaccia descrive il servizio che aggiunge il supporto per tipi MIME specifici. Per implementare questa interfaccia è necessario aggiungere un nuovo tipo MIME. L’interfaccia contiene metodi per importare ed esportare i documenti specifici, per creare miniature ed estrarre metadati.com.day.cq.dam.core.AbstractAssetHandler
Classe: Questa classe funge da base per tutte le altre implementazioni dei gestori di risorse e fornisce funzionalità comuni.com.day.cq.dam.core.AbstractSubAssetHandler
:
È necessario implementare i seguenti metodi:
extractMetadata()
: questo metodo estrae tutti i metadati disponibili.getThumbnailImage()
: questo metodo crea un’immagine di miniatura dalla risorsa passata.getMimeTypes()
: questo metodo restituisce i tipi MIME della risorsa.Ecco un esempio di modello:
package my.own.stuff; /** * @scr.component ereditit="true" * @scr.service */ classe pubblica MyMediaHandler estende com.day.cq.dam.core.AbstractAssetHandler
L'interfaccia e le classi includono:
com.day.cq.dam.api.handler.AssetHandler
interfaccia: Questa interfaccia descrive il servizio che aggiunge il supporto per tipi MIME specifici. Per implementare questa interfaccia è necessario aggiungere un nuovo tipo MIME. L’interfaccia contiene metodi per importare ed esportare i documenti specifici, per creare miniature ed estrarre metadati.com.day.cq.dam.core.AbstractAssetHandler
Classe: Questa classe funge da base per tutte le altre implementazioni dei gestori di risorse e fornisce funzionalità comuni.com.day.cq.dam.core.AbstractSubAssetHandler
Classe: Questa classe funge da base per tutte le altre implementazioni dei gestori di risorse e fornisce funzionalità comuni, oltre a quelle comuni per l’estrazione di risorse secondarie.In questa sezione viene creato un gestore di testo specifico che genera le miniature con una filigrana.
Procedere come segue:
Fai riferimento a Strumenti di sviluppo per installare e configurare Eclipse con un Maven e per impostare le dipendenze necessarie per il Maven progetto.
Dopo aver eseguito la seguente procedura, quando carichi un file TXT in Experience Manager, i metadati del file vengono estratti e vengono generate due miniature con una filigrana.
In Eclipse, crea myBundle
Maven progetto:
Nella barra del menu, fai clic su File > Nuovo > Altro.
Nella finestra di dialogo , espandi la Maven cartella, seleziona Maven progetto e fai clic su Successivo.
Seleziona la casella Crea un progetto semplice e la casella Usa posizioni area di lavoro predefinite , quindi fai clic su Successivo.
Definire un Maven progetto:
com.day.cq5.myhandler
.Fai clic su Fine.
Imposta la Java compilatore alla versione 1.5:
Fai clic con il pulsante destro del mouse sul pulsante myBundle
progetto, seleziona Proprietà.
Seleziona Compilatore Java e impostare le seguenti proprietà su 1.5:
Fai clic su OK. Nella finestra di dialogo, fai clic su Sì.
Sostituisci il codice nel pom.xml
file con il seguente codice:
<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<!-- ====================================================================== -->
<!-- P A R E N T P R O J E C T D E S C R I P T I O N -->
<!-- ====================================================================== -->
<parent>
<groupId>com.day.cq.dam</groupId>
<artifactId>dam</artifactId>
<version>5.2.14</version>
<relativePath>../parent</relativePath>
</parent>
<!-- ====================================================================== -->
<!-- P R O J E C T D E S C R I P T I O N -->
<!-- ====================================================================== -->
<groupId>com.day.cq5.myhandler</groupId>
<artifactId>myBundle</artifactId>
<name>My CQ5 bundle</name>
<version>0.0.1-SNAPSHOT</version>
<description>This is my CQ5 bundle</description>
<packaging>bundle</packaging>
<!-- ====================================================================== -->
<!-- B U I L D D E F I N I T I O N -->
<!-- ====================================================================== -->
<build>
<plugins>
<plugin>
<groupId>org.apache.felix</groupId>
<artifactId>maven-scr-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.sling</groupId>
<artifactId>maven-sling-plugin</artifactId>
<configuration>
<slingUrlSuffix>/libs/dam/install/</slingUrlSuffix>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.felix</groupId>
<artifactId>maven-bundle-plugin</artifactId>
<extensions>true</extensions>
<configuration>
<instructions>
<Bundle-Category>cq5</Bundle-Category>
<Export-Package> com.day.cq5.myhandler </Export-Package>
</instructions>
</configuration>
</plugin>
</plugins>
</build>
<!-- ====================================================================== -->
<!-- D E P E N D E N C I E S -->
<!-- ====================================================================== -->
<dependencies>
<dependency>
<groupId>com.day.cq.dam</groupId>
<artifactId>cq-dam-api</artifactId>
<version>5.2.10</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.day.cq.dam</groupId>
<artifactId>cq-dam-core</artifactId>
<version>5.2.10</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.day.cq</groupId>
<artifactId>cq-commons</artifactId>
</dependency>
<dependency>
<groupId>javax.jcr</groupId>
<artifactId>jcr</artifactId>
</dependency>
<dependency>
<groupId>org.apache.felix</groupId>
<artifactId>org.osgi.compendium</artifactId>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
</dependency>
<dependency>
<groupId>commons-lang</groupId>
<artifactId>commons-lang</artifactId>
</dependency>
<dependency>
<groupId>commons-collections</groupId>
<artifactId>commons-collections</artifactId>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
</dependency>
<dependency>
<groupId>com.day.commons</groupId>
<artifactId>day-commons-gfx</artifactId>
</dependency>
<dependency>
<groupId>com.day.commons</groupId>
<artifactId>day-commons-text</artifactId>
</dependency>
<dependency>
<groupId>com.day.cq.workflow</groupId>
<artifactId>cq-workflow-api</artifactId>
</dependency>
<dependency>
<groupId>com.day.cq.wcm</groupId>
<artifactId>cq-wcm-foundation</artifactId>
<version>5.2.22</version>
</dependency>
</dependencies>
Crea il pacchetto com.day.cq5.myhandler
che contiene Java classi myBundle/src/main/java
:
src/main/java
, selezionare Nuovo, quindi Pacchetto.com.day.cq5.myhandler
e fare clic su Fine.Crea il Java Classe MyHandler
:
myBundle/src/main/java
, fai clic con il pulsante destro del mouse su com.day.cq5.myhandler
pacchetto. Seleziona Nuovo, quindi Classe.MyHandler
e fai clic su Fine. Eclipse crea e apre il file MyHandler.java
.MyHandler.java
sostituisci il codice esistente con quanto segue, quindi salva le modifiche:package com.day.cq5.myhandler;
import java.awt.Color;
import java.awt.Rectangle;
import java.awt.image.BufferedImage;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import javax.jcr.Node;
import javax.jcr.RepositoryException;
import javax.jcr.Session;
import org.apache.commons.io.IOUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.day.cq.dam.api.metadata.ExtractedMetadata;
import com.day.cq.dam.core.AbstractAssetHandler;
import com.day.image.Font;
import com.day.image.Layer;
import com.day.cq.wcm.foundation.ImageHelper;
/**
* The <code>MyHandler</code> can extract text files
* @scr.component inherit="true" immediate="true" metatype="false"
* @scr.service
*
**/
public class MyHandler extends AbstractAssetHandler {
/** * Logger instance for this class. */
private static final Logger log = LoggerFactory.getLogger(MyHandler.class);
/** * Music icon margin */
private static final int MARGIN = 10;
/** * @see com.day.cq.dam.api.handler.AssetHandler#getMimeTypes() */
public String[] getMimeTypes() {
return new String[] {"text/plain"};
}
public ExtractedMetadata extractMetadata(Node asset) {
ExtractedMetadata extractedMetadata = new ExtractedMetadata();
InputStream data = getInputStream(asset);
try {
// read text data
InputStreamReader reader = new InputStreamReader(data);
char[] buffer = new char[4096];
String text = "";
while (reader.read(buffer) != -1) {
text += new String(buffer);
}
reader.close();
long wordCount = this.wordCount(text);
extractedMetadata.setProperty("text", text);
extractedMetadata.setMetaDataProperty("Word Count",wordCount);
setMimetype(extractedMetadata, asset);
} catch (Throwable t) {
log.error("handling error: " + t.toString(), t);
} finally {
IOUtils.closeQuietly(data);
}
return extractedMetadata; }
// ----------------------< helpers >----------------------------------------
protected BufferedImage getThumbnailImage(Node node) {
ExtractedMetadata metadata = extractMetadata(node);
final String text = (String) metadata.getProperty("text");
// create text layer
final Layer layer = new Layer(500, 600, Color.WHITE);
layer.setPaint(Color.black);
Font font = new Font("Arial", 12);
String displayText = this.getDisplayText(text, 600, 12);
if(displayText!=null && displayText.length() > 0) {
// commons-gfx Font class would throw IllegalArgumentException on empty or null text
layer.drawText(10, 10, 500, 600, displayText, font, Font.ALIGN_LEFT, 0, 0);
}
// create watermark and merge with text layer
Layer watermarkLayer;
try {
final Session session = node.getSession();
watermarkLayer = ImageHelper.createLayer(session, "/content/dam/we-retail/en/products/apparel/gloves/Gloves.jpg");
watermarkLayer.setX(MARGIN);
watermarkLayer.setY(MARGIN);
layer.merge(watermarkLayer);
} catch (RepositoryException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace(); }
layer.crop(new Rectangle(510, 600));
return layer.getImage(); }
// ---------------< private >-----------------------------------------------
/**
* This method cuts lines if the text file is too long..
* * @param text
* * text to check
* * @param height
* * text box height (px)
* * @param fontheight
* * font height (px)
* * @return the text which will fit into the box
*/
private String getDisplayText(String text, int height, int fontheight) {
String trimmedText = text.trim();
int numOfLines = height / fontheight;
String lines[] = trimmedText.split("\n");
if (lines.length <= numOfLines) {
return trimmedText;
} else {
String cuttetText = "";
for (int i = 0; i < numOfLines; i++) {
cuttetText += lines[i] + "\n";
}
return cuttetText;
}
}
/**
* * This method counts the number of words in a string
* * @param text the String whose words would like to be counted
* * @return the number of words in the string
* */
private long wordCount(String text) {
// We need to keep track of the last character, if we have two whitespaces in a row we don't want to double count.
// The starting of the document is always a whitespace.
boolean prevWhiteSpace = true;
boolean currentWhiteSpace = true;
char c; long numwords = 0;
int j = text.length();
int i = 0;
while (i < j) {
c = text.charAt(i++);
if (c == 0) { break; }
currentWhiteSpace = Character.isWhitespace(c);
if (currentWhiteSpace && !prevWhiteSpace) { numwords++; }
prevWhiteSpace = currentWhiteSpace;
}
// If we do not end with a whitespace then we need to add one extra word.
if (!currentWhiteSpace) { numwords++; }
return numwords;
}
}
Compila il Java e crea il bundle:
myBundle
progetto, seleziona Esegui come, quindi Installazione Maven.myBundle-0.0.1-SNAPSHOT.jar
(contenente la classe compilata) viene creato in myBundle/target
.In CRX explorer, crea un nuovo nodo sotto /apps/myApp
. Nome = install
, Tipo = nt:folder
.
Copia il bundle myBundle-0.0.1-SNAPSHOT.jar
e archiviarlo /apps/myApp/install
(ad esempio con WebDAV). Il nuovo gestore di testo è ora attivo in Experience Manager.
Nel browser, apri le Console di gestione web Apache Felix. Seleziona la Componenti scheda e disabilita il gestore di testo predefinito com.day.cq.dam.core.impl.handler.TextHandler
.
Experience Manager consente di eseguire qualsiasi strumento della riga di comando all’interno di un flusso di lavoro per convertire le risorse (ad esempio ImageMagick) e per aggiungere il nuovo rendering alla risorsa. È sufficiente installare lo strumento della riga di comando sul disco che ospita il Experience Manager e per aggiungere e configurare un passaggio del processo al flusso di lavoro. Il processo richiamato, denominato CommandLineProcess
, consente anche di filtrare in base a tipi MIME specifici e di creare più miniature in base al nuovo rendering.
Le seguenti conversioni possono essere eseguite e memorizzate automaticamente in Assets:
Nei sistemi non Windows, lo strumento FFmpeg restituisce un errore durante la generazione di rappresentazioni per una risorsa video con una virgoletta singola (') nel nome file. Se il nome del file video include una singola citazione, rimuovila prima di caricare in Experience Manager.
La CommandLineProcess
Il processo esegue le seguenti operazioni nell'ordine in cui sono elencate:
L’esempio seguente mostra come impostare il passaggio del processo della riga di comando in modo che ogni volta che viene aggiunta una risorsa con l’e-type GIF o TIFF miMIME a /content/dam
sulla Experience Manager server, viene creata un'immagine capovolta dell'originale insieme a tre miniature aggiuntive (140x100, 48x48 e 10x250).
A questo scopo, utilizza ImageMagick. ImageMagick è un software gratuito della riga di comando utilizzato per creare, modificare e comporre immagini bitmap.
Installa ImageMagick sul disco che ospita il Experience Manager server:
Installa ImageMagick: Vedi Documentazione di ImageMagick.
Imposta lo strumento in modo da eseguire la conversione sulla riga di comando.
Per verificare se lo strumento è installato correttamente, esegui il seguente comando convert -h
sulla riga di comando.
Viene visualizzata una schermata di aiuto con tutte le opzioni possibili dello strumento di conversione.
In alcune versioni di Windows, il comando di conversione potrebbe non essere eseguito perché è in conflitto con l'utilità di conversione nativa di cui fa parte Windows installazione. In questo caso, indica il percorso completo per il ImageMagick software utilizzato per convertire i file immagine in miniature. Esempio: "C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png
.
Per verificare se lo strumento funziona correttamente, aggiungi un'immagine JPG alla directory di lavoro ed esegui il comando convert <image-name>.jpg -flip <image-name>-flipped.jpg
sulla riga di comando. Un’immagine capovolta viene aggiunta alla directory. Quindi, aggiungi il passaggio della riga di comando al flusso di lavoro Risorsa di aggiornamento DAM.
Vai a Flusso di lavoro console.
In Modelli scheda , modifica Risorsa di aggiornamento DAM modello.
Modificare la Argomenti del Rendering abilitato per web passaggio a: mime:image/gif,mime:image/tiff,tn:140:100,tn:48:48,tn:10:250,cmd:convert ${directory}/${filename} -flip ${directory}/${basename}.flipped.jpg
.
Salva il flusso di lavoro.
Per testare il flusso di lavoro modificato, aggiungi una risorsa a /content/dam
.
myImage.tiff
e copiarlo in /content/dam
, ad esempio utilizzando WebDAV.https://localhost:4502/libs/wcm/core/content/damadmin.html
.Questa sezione descrive come impostare Argomenti processo di CommandLineProcess.
Separa i valori del Argomenti del processo utilizzando la virgola e non avviarla con uno spazio vuoto.
Formato argomento | Descrizione |
---|---|
mime:<mime-type> | Argomento facoltativo. Il processo viene applicato se la risorsa ha lo stesso tipo MIME di quello dell’argomento. È possibile definire diversi tipi MIME. |
tn:<width>:<height> | Argomento facoltativo. Il processo crea una miniatura con le dimensioni definite nell’argomento. È possibile definire diverse miniature. |
Comando: <command> | Definisce il comando eseguito. La sintassi dipende dallo strumento della riga di comando. È possibile definire un solo comando. Per creare il comando è possibile utilizzare le seguenti variabili: ${filename} : nome del file di input, ad esempio original.jpg ${file} : nome del percorso completo del file di input, ad esempio /tmp/cqdam0816.tmp/original.jpg ${directory} : directory del file di input, ad esempio /tmp/cqdam0816.tmp ${basename} : nome del file di input senza estensione, ad esempio originale ${extension} : estensione del file di input, ad esempio JPG. |
Ad esempio, se ImageMagick è installato sul disco che ospita il Experience Manager e se si crea una fase del processo utilizzando CommandLineProcess come Implementazione e i seguenti valori come Argomenti del processo:
mime:image/gif,mime:image/tiff,tn:140:100,tn:48:48,tn:10:250,cmd:convert ${directory}/${filename} -flip ${directory}/${basename}.flipped.jpg
quindi, quando il flusso di lavoro viene eseguito, il passaggio si applica solo alle risorse che hanno image/gif
o mime:image/tiff
come mime-types
, crea un’immagine capovolta dell’originale, la converte in JPG e crea tre miniature con le dimensioni seguenti: 140x100, 48x48 e 10x250.
Utilizza quanto segue Argomenti del processo per creare le tre miniature standard utilizzando ImageMagick:
mime:image/tiff,mime:image/png,mime:image/bmp,mime:image/gif,mime:image/jpeg,cmd:convert ${filename} -define jpeg:size=319x319 -thumbnail "319x319>" -background transparent -gravity center -extent 319x319 -write png:cq5dam.thumbnail.319.319.png -thumbnail "140x100>" -background transparent -gravity center -extent 140x100 -write cq5dam.thumbnail.140.100.png -thumbnail "48x48>" -background transparent -gravity center -extent 48x48 cq5dam.thumbnail.48.48.png
Utilizza quanto segue Argomenti del processo per creare il rendering abilitato per il web utilizzando ImageMagick:
mime:image/tiff,mime:image/png,mime:image/bmp,mime:image/gif,mime:image/jpeg,cmd:convert ${filename} -define jpeg:size=1280x1280 -thumbnail "1280x1280>" cq5dam.web.1280.1280.jpeg
La CommandLineProcess il passaggio si applica solo alle risorse (nodi di tipo dam:Asset
) o discendenti di una risorsa.