Processar ativos usando manipuladores e fluxos de trabalho de mídia processing-assets-using-media-handlers-and-workflows

Adobe Experience Manager Assets O vem com um conjunto de fluxos de trabalho e manipuladores de mídia padrão para processar ativos. Um fluxo de trabalho define as tarefas a serem executadas nos ativos e delega as tarefas específicas aos manipuladores de mídia, por exemplo, geração de miniaturas ou extração de metadados.

Um workflow pode ser configurado para ser executado automaticamente quando um ativo de um tipo MIME específico é carregado. As etapas de processamento são definidas em termos de uma série Assets manipuladores de mídia. Experience Manager fornece alguns manipuladores integrados, e outros podem ser desenvolvido de forma personalizada ou definido por meio da delegação do processo a um ferramenta de linha de comando.

Os manipuladores de mídia são serviços na Assets que executam ações específicas em ativos. Por exemplo, quando um arquivo de áudio MP3 é carregado em Experience Manager, um fluxo de trabalho aciona um manipulador MP3 que extrai os metadados e gera uma miniatura. Geralmente, os manipuladores de mídia são usados em combinação com fluxos de trabalho. Os tipos MIME mais comuns são suportados no Experience Manager. Tarefas específicas podem ser executadas em ativos estendendo/criando fluxos de trabalho, estendendo/criando manipuladores de mídia ou desativando/ativando manipuladores de mídia.

NOTE
Consulte a Formatos de ativos compatíveis para obter uma descrição de todos os formatos compatíveis com o Assets e recursos compatíveis com cada formato.

Manipuladores de mídia padrão default-media-handlers

Os seguintes manipuladores de mídia estão disponíveis no Assets e lidam com os tipos MIME mais comuns:

Nome do manipulador
Nome do serviço (no console do sistema)
Tipos MIME suportados
ManipuladorTexto
com.day.cq.dam.core.impl.handler.TextHandler
text/plain
PdfHandler
com.day.cq.dam.handler.standard.pdf.PdfHandler
  • application/pdf
  • application/illustrator
JpegHandler
com.day.cq.dam.core.impl.handler.JpegHandler
image/jpeg
Mp3Handler
com.day.cq.dam.handler.standard.mp3.Mp3Handler
audio/mpeg
Importante - Ao fazer upload de um arquivo MP3, é processado usando uma biblioteca de terceiros. A biblioteca calcula um comprimento aproximado não preciso se o MP3 tiver taxa de bits variável (VBR).
ZipHandler
com.day.cq.dam.handler.standard.zip.ZipHandler
  • application/java-archive
  • application/zip
PictHandler
com.day.cq.dam.handler.standard.pict.PictHandler
image/pict
StandardImageHandler
com.day.cq.dam.core.impl.handler.StandardImageHandler
  • image/gif
  • image/png
  • application/photoshop
  • image/jpeg
  • image/tiff
  • image/x-ms-bmp
  • image/bmp
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
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
EPubHandler
com.day.cq.dam.handler.standard.epub.EPubHandler
application/epub+zip
GenericAssetHandler
com.day.cq.dam.core.impl.handler.GenericAssetHandler
fallback caso nenhum outro manipulador seja encontrado para extrair dados de um ativo

Todos os manipuladores executam as seguintes tarefas:

  • extrair todos os metadados disponíveis do ativo.
  • criar uma imagem em miniatura de um ativo.

Para exibir os manipuladores de mídia ativos:

  1. No navegador, navegue até https://localhost:4502/system/console/components.
  2. Clique em com.day.cq.dam.core.impl.store.AssetStoreImpl.
  3. Uma lista com todos os manipuladores de mídia ativos é exibida. Por exemplo:

chlimage_1-437

Usar manipuladores de mídia em fluxos de trabalho para executar tarefas em ativos using-media-handlers-in-workflows-to-perform-tasks-on-assets

Os manipuladores de mídia são serviços que geralmente são usados em combinação com fluxos de trabalho.

Experience Manager O tem alguns fluxos de trabalho padrão para processar ativos. Para visualizá-las, abra o console Fluxo de trabalho e clique no link Modelos guia: os títulos do fluxo de trabalho que começam com Assets são os ativos específicos.

Os workflows existentes podem ser estendidos e novos podem ser criados para processar ativos de acordo com requisitos específicos.

O exemplo a seguir mostra como aprimorar o fluxo de trabalho de Sincronização do AEM Assets para que os ativos secundários sejam gerados para todos os ativos, exceto documentos PDF.

Desativar ou ativar um manipulador de mídia disabling-enabling-a-media-handler

Os manipuladores de mídia podem ser desativados ou ativados por meio do console de gerenciamento Web do Apache Felix. Quando o manipulador de mídia está desativado, as tarefas não são executadas nos ativos.

Para ativar/desativar um manipulador de mídia:

  1. No navegador, navegue até https://<host>:<port>/system/console/components.
  2. Clique em Desativar ao lado do nome do manipulador de mídia. Por exemplo: com.day.cq.dam.handler.standard.mp3.Mp3Handler.
  3. Atualizar a página: um ícone é exibido ao lado do manipulador de mídia indicando que o recurso está desativado.
  4. Para ativar o manipulador de mídia, clique em Ativar ao lado do nome do manipulador de mídia.

Criar um manipulador de mídia creating-a-new-media-handler

Para suportar um novo tipo de mídia ou executar tarefas específicas em um ativo, é necessário criar um manipulador de mídia. Esta seção descreve como proceder.

Classes e interfaces importantes important-classes-and-interfaces

A melhor maneira de iniciar uma implementação é herdar de uma implementação abstrata fornecida que cuida da maioria das coisas e fornece um comportamento padrão razoável: o com.day.cq.dam.core.AbstractAssetHandler classe.

Esta classe já fornece um descritor de serviço abstrato. Portanto, se você herdar desta classe e usar o maven-sling-plugin, defina o sinalizador de herança como true.

Implemente os seguintes métodos:

  • extractMetadata(): extrai todos os metadados disponíveis.
  • getThumbnailImage(): cria uma imagem em miniatura do ativo passado.
  • getMimeTypes(): retorna os tipos MIME do ativo.

Este é um exemplo de template:

package my.own.stuff; /** * @scr.component inherit="true" * @scr.service */ public class MyMediaHandler extends com.day.cq.dam.core.AbstractAssetHandler { // implement the relevant parts }

A interface e as classes incluem:

  • com.day.cq.dam.api.handler.AssetHandler interface: esta interface descreve o serviço que adiciona suporte para tipos MIME específicos. A adição de um novo tipo MIME requer a implementação dessa interface. A interface contém métodos para importar e exportar os documentos específicos, para criar miniaturas e extrair metadados.

  • com.day.cq.dam.core.AbstractAssetHandler classe: essa classe serve como base para todas as outras implementações do manipulador de ativos e fornece funcionalidades comuns usadas.

  • classe com.day.cq.dam.core.AbstractSubAssetHandler:

    • Essa classe serve como base para todas as outras implementações do manipulador de ativos e fornece a funcionalidade comum usada, além da funcionalidade usada frequentemente na extração de ativos secundários.
    • A melhor maneira de iniciar uma implementação é herdar de uma implementação abstrata fornecida que cuida da maioria das coisas e fornece o comportamento padrão razoável: a classe com.day.cq.dam.core.AbstractAssetHandler.
    • Esta classe já fornece um descritor de serviço abstrato. Portanto, se você herdar desta classe e usar o maven-sling-plugin, defina o sinalizador de herança como true.

Os seguintes métodos precisam ser implementados:

  • extractMetadata(): esse método extrai todos os metadados disponíveis.
  • getThumbnailImage(): esse método cria uma imagem em miniatura do ativo passado.
  • getMimeTypes(): esse método retorna os tipos MIME do ativo.

Este é um exemplo de template:

empacotar my.own.stuff; /** * @scr.component inherit="true" * @scr.service */ public class MyMediaHandler extends com.day.cq.dam.core.AbstractAssetHandler

A interface e as classes incluem:

  • com.day.cq.dam.api.handler.AssetHandler interface: esta interface descreve o serviço que adiciona suporte para tipos MIME específicos. A adição de um novo tipo MIME requer a implementação dessa interface. A interface contém métodos para importar e exportar os documentos específicos, para criar miniaturas e extrair metadados.
  • com.day.cq.dam.core.AbstractAssetHandler classe: essa classe serve como base para todas as outras implementações do manipulador de ativos e fornece funcionalidades comuns usadas.
  • com.day.cq.dam.core.AbstractSubAssetHandler classe: essa classe serve como base para todas as outras implementações do manipulador de ativos e fornece a funcionalidade comum usada, além da funcionalidade comum usada para a extração de ativos secundários.

Exemplo: criar um manipulador de texto específico example-create-a-specific-text-handler

Nesta seção, você criará um Manipulador de texto específico que gera miniaturas com uma marca d'água.

Proceda da seguinte forma:

Consulte Ferramentas de desenvolvimento para instalar e configurar o Eclipse com um Maven plug-in e para configurar as dependências necessárias para o Maven projeto.

Depois de executar o procedimento a seguir, ao fazer upload de um arquivo TXT no Experience Manager, os metadados do arquivo são extraídos e duas miniaturas com uma marca d'água são geradas.

  1. No Eclipse, crie myBundle Maven projeto:

    1. Na barra de menus, clique em Arquivo > Novo > Outro.

    2. Na caixa de diálogo, expanda a variável Maven , selecione Maven projeto e clique em Próxima.

    3. Marque a caixa Criar um projeto simples e a caixa Usar locais padrão do Workspace e clique em Próxima.

    4. Definir um Maven projeto:

      • ID do grupo: com.day.cq5.myhandler.
      • ID do artefato: myBundle.
      • Nome: Meu Experience Manager pacote.
      • Descrição: Este é meu Experience Manager pacote.
    5. Clique em Concluir.

  2. Defina o Java compilador para a versão 1.5:

    1. Clique com o botão direito do mouse no myBundle projeto, selecione Propriedades.

    2. Selecionar Compilador Java e defina as seguintes propriedades como 1.5:

      • Nível de conformidade do compilador
      • Compatibilidade de arquivos .class gerados
      • Compatibilidade de origem
    3. Clique em OK. Na janela de diálogo, clique em Sim.

  3. Substitua o código na pom.xml com o seguinte código:

    code language-xml
    <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>
    
  4. Criar o pacote com.day.cq5.myhandler que contém o Java classes em myBundle/src/main/java:

    1. Em meu pacote, clique com o botão direito do mouse src/main/java, selecione Novo e, em seguida, Pacote.
    2. Nomear como com.day.cq5.myhandler e clique em Finish.
  5. Crie o Java classe MyHandler:

    1. Entrada Eclipse, em myBundle/src/main/java, clique com o botão direito do mouse no com.day.cq5.myhandler pacote. Selecionar Novo, depois Classe.
    2. Na janela de diálogo, nomeie o Java classe MyHandler e clique em Concluir. Eclipse cria e abre o arquivo MyHandler.java.
    3. Entrada MyHandler.java substitua o código existente pelo seguinte e salve as alterações:
    code language-java
    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 do not 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;
     }
    }
    
  6. Compilar o Java e crie o pacote:

    1. Clique com o botão direito do mouse no myBundle projeto, selecione Executar como, depois Instalação do Maven.
    2. O pacote myBundle-0.0.1-SNAPSHOT.jar (contendo a classe compilada) é criado em myBundle/target.
  7. No CRX Explorer, crie um nó em /apps/myApp. Nome = install, Tipo = nt:folder.

  8. Copiar o pacote myBundle-0.0.1-SNAPSHOT.jar e armazená-lo em /apps/myApp/install (por exemplo, com WebDAV). O novo manipulador de texto agora está ativo no Experience Manager.

  9. No navegador, abra o Console de gerenciamento Web Apache Felix. Selecione o Componentes e desativar o manipulador de texto padrão com.day.cq.dam.core.impl.handler.TextHandler.

Manipulador de mídia baseado na linha de comando command-line-based-media-handler

Experience Manager permite executar qualquer ferramenta de linha de comando em um fluxo de trabalho para converter ativos (como ImageMagick) e para adicionar a nova representação ao ativo. Você só precisa instalar a ferramenta de linha de comando no disco que hospeda o Experience Manager e para adicionar e configurar uma etapa do processo ao fluxo de trabalho. O processo chamado, chamado CommandLineProcessO também permite filtrar de acordo com tipos MIME específicos e criar várias miniaturas com base na nova representação.

As seguintes conversões podem ser executadas e armazenadas automaticamente no Assets:

  • Transformação do EPS e da IA usando ImageMagick e Ghostscript.
  • Transcodificação de vídeo FLV usando FFmpeg.
  • Codificação de MP3 usando MANCO.
  • Processamento de áudio usando SOX.
NOTE
Em sistemas não Windows, a ferramenta FFmpeg retorna um erro ao gerar representações para um ativo de vídeo que tem uma aspa simples (') em seu nome de arquivo. Se o nome do arquivo de vídeo incluir uma aspa simples, remova-a antes de fazer upload no Experience Manager.

A variável CommandLineProcess O processo do executa as seguintes operações na ordem em que estão listadas:

  • Filtra o arquivo de acordo com tipos MIME específicos, se especificado.
  • Cria um diretório temporário no disco que hospeda o Experience Manager servidor.
  • Transfere o arquivo original para o diretório temporário.
  • Executa o comando definido pelos argumentos da etapa. O comando está sendo executado no diretório temporário com as permissões do usuário em execução Experience Manager.
  • Transfere o resultado de volta para a pasta de representação do Experience Manager servidor.
  • Exclui o diretório temporário.
  • Cria miniaturas com base nessas representações, se especificado. O número e as dimensões das miniaturas são definidas pelos argumentos da etapa.

Um exemplo usando ImageMagick an-example-using-imagemagick

O exemplo a seguir mostra como configurar a etapa do processo da linha de comando para que sempre que um ativo com o GIF ou TIFF do tipo e miMIME for adicionado ao /content/dam no Experience Manager uma imagem invertida do original é criada junto com três miniaturas adicionais (140x100, 48x48 e 10x250).

Para fazer isso, use ImageMagick. ImageMagick O é um software gratuito de linha de comando usado para criar, editar e compor imagens bitmap.

Instalar ImageMagick no disco que hospeda o Experience Manager servidor:

  1. Instalar ImageMagick: Consulte Documentação do ImageMagick.

  2. Configure a ferramenta para executar a conversão na linha de comando.

  3. Para verificar se a ferramenta está instalada corretamente, execute o comando a seguir convert -h na linha de comando.

    Ele exibe uma tela de ajuda com todas as opções possíveis da ferramenta de conversão.

    note note
    NOTE
    Em algumas versões do Windows, o comando convert pode falhar ao ser executado por estar em conflito com o utilitário de conversão nativo que faz parte do Windows instalação. Nesse caso, mencione o caminho completo para o ImageMagick software usado para converter arquivos de imagem em miniaturas. Por exemplo, "C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png.
  4. Para ver se a ferramenta é executada corretamente, adicione uma imagem de JPG ao diretório de trabalho e execute o comando convert <image-name>.jpg -flip <image-name>-flipped.jpg na linha de comando. Uma imagem invertida é adicionada ao diretório. Em seguida, adicione a etapa do processo da linha de comando à Ativo de atualização DAM fluxo de trabalho.

  5. Vá para a Fluxo de trabalho console.

  6. No Modelos , edite o Ativo de atualização DAM modelo.

  7. Altere o Argumentos do Representação ativada pela Web etapa para: mime:image/gif,mime:image/tiff,tn:140:100,tn:48:48,tn:10:250,cmd:convert ${directory}/${filename} -flip ${directory}/${basename}.flipped.jpg.

  8. Salve o workflow.

Para testar o fluxo de trabalho modificado, adicione um ativo ao /content/dam.

  1. No sistema de arquivos, obtenha uma imagem TIFF de sua escolha. Renomear para myImage.tiff e copiá-lo em /content/dam, por exemplo, usando WebDAV.
  2. Vá para a DAM CQ5 console, por exemplo, https://localhost:4502/libs/wcm/core/content/damadmin.html.
  3. Abrir o ativo myImage.tiff e verifique se a imagem virada e as três miniaturas foram criadas.

Configurar a etapa do processo CommandLineProcess configuring-the-commandlineprocess-process-step

Esta seção descreve como definir os Argumentos de processo do CommandLineProcess.

Separe os valores de Argumentos do processo usando vírgula e não inicie com espaço em branco.

Argument-Format
Descrição
mime:<mime-type>
Argumento opcional. O processo é aplicado se o ativo tiver o mesmo tipo MIME que o do argumento.
Vários tipos MIME podem ser definidos.
tn:<width>:<height>
Argumento opcional. O processo cria uma miniatura com as dimensões definidas no argumento.
Várias miniaturas podem ser definidas.
cmd <command>
Define o comando que é executado. A sintaxe depende da ferramenta de linha de comando. Somente um comando pode ser definido.
As variáveis a seguir podem ser usadas para criar o comando:
${filename}: nome do arquivo de entrada, como original.jpg
${file}: nome do caminho completo do arquivo de entrada, por exemplo, /tmp/cqdam0816.tmp/original.jpg
${directory}: diretório do arquivo de entrada, por exemplo, /tmp/cqdam0816.tmp
${basename}: nome do arquivo de entrada sem sua extensão, por exemplo, original
${extension}: extensão do arquivo de entrada, por exemplo, JPG.

Por exemplo, se ImageMagick O está instalado no disco que hospeda o Experience Manager e se você criar uma etapa do processo usando ProcessoDeLinhaDeComando como Implementação e os seguintes valores como Argumentos do 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

em seguida, quando o fluxo de trabalho é executado, a etapa se aplica somente aos ativos que têm image/gif ou mime:image/tiff as mime-types, cria uma imagem invertida do original, converte-a em JPG e cria três miniaturas com as dimensões: 140x100, 48x48 e 10x250.

Use o seguinte Argumentos do processo para criar as três miniaturas padrão usando 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

Use o seguinte Argumentos do processo para criar a representação ativada pela web usando 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

NOTE
A variável ProcessoDeLinhaDeComando a etapa se aplica somente a ativos (nós do tipo dam:Asset) ou descendentes de um ativo.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2