使用媒体处理程序和工作流处理资源

Adobe Experience Manager Assets 附带了一组用于处理资产的默认工作流和媒体处理程序。 工作流定义要在资产上执行的任务，然后将特定任务委派给媒体处理程序，例如缩略图生成或元数据提取。

可以将工作流配置为在上传特定MIME类型的资产时自动执行。 处理步骤由一系列步骤定义 Assets 媒体处理程序。 Experience Manager 提供了一些 内置处理程序， 其他选项可以是 已开发自定义 或通过将该流程委派给 命令行工具.

媒体处理程序是中的服务 Assets 对资产执行特定操作的属性。 例如，将MP3音频文件上传到时 Experience Manager，工作流会触发提取元数据并生成缩略图的MP3处理程序。 媒体处理程序通常与工作流结合使用。 中支持的最常见的MIME类型 Experience Manager. 可以通过扩展/创建工作流、扩展/创建媒体处理程序或禁用/启用媒体处理程序对资产执行特定任务。

默认媒体处理程序

以下媒体处理程序在中可用 Assets 并处理最常见的MIME类型：

所有处理程序都会执行以下任务：

• 从资源中提取所有可用的元数据。
• 创建资源的缩略图图像。

要查看活动媒体处理程序，请执行以下操作：

1. 在浏览器中，导航到 https://localhost:4502/system/console/components.
2. 单击 com.day.cq.dam.core.impl.store.AssetStoreImpl.
3. 将显示包含所有活动媒体处理程序的列表。 例如：

在工作流中使用媒体处理程序对资产执行任务

媒体处理程序是与工作流结合使用的服务。

Experience Manager 有一些用于处理资产的默认工作流。 要查看这些工作流，请打开“工作流”控制台，然后单击 模型 选项卡：以开头的工作流标题 Assets 是特定于资产的受众。

可以扩展现有工作流，也可以创建新工作流，以根据特定要求处理资产。

以下示例演示如何增强 AEM Assets 同步工作流，以便为除 PDF 文档外的所有资产生成子资产。

禁用或启用媒体处理程序

可以通过Apache Felix Web管理控制台禁用或启用媒体处理程序。 禁用媒体处理程序时，不会对资产执行其任务。

启用/禁用媒体处理程序：

1. 在浏览器中，导航到 https://<host>:<port>/system/console/components.
2. 单击 禁用 位于媒体处理程序名称旁边。 例如：com.day.cq.dam.handler.standard.mp3.Mp3Handler。
3. 刷新页面：媒体处理程序旁边会显示一个图标，指示该页面已禁用。
4. 要启用媒体处理程序，请单击 启用 位于媒体处理程序名称旁边。

创建新的媒体处理程序

要支持新媒体类型或对资产执行特定任务，需要创建新的媒体处理程序。 本节介绍如何继续。

重要类和接口

开始实施的最佳方法是继承所提供的抽象实施，该实施会处理大多数事务并提供合理的默认行为： com.day.cq.dam.core.AbstractAssetHandler 类。

此类已提供抽象服务描述符。 因此，如果您继承自此类并使用maven-sling-plugin，请确保将继承标记设置为 true.

实施以下方法：

• extractMetadata()：提取所有可用的元数据。
• getThumbnailImage()：根据传递的资源创建缩略图图像。
• getMimeTypes()：返回资源MIME类型。

以下是示例模板：

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

接口和类包括：

• com.day.cq.dam.api.handler.AssetHandler 接口：此接口描述添加了对特定MIME类型的支持的服务。 添加新的MIME类型需要实现此接口。 该界面包含用于导入和导出特定文档、创建缩略图和提取元数据的方法。
• com.day.cq.dam.core.AbstractAssetHandler 类：此类用作所有其他资产处理程序实现的基础，并提供常用功能。
• com.day.cq.dam.core.AbstractSubAssetHandler class:
  • 此类用作所有其他资产处理程序实施的基础，并为子资产提取提供常用功能以及常用功能。
  • 开始实施的最佳方法是继承所提供的抽象实施，该实施会处理大多数事务并提供合理的默认行为：com.day.cq.dam.core.AbstractAssetHandler类。
  • 此类已提供抽象服务描述符。 因此，如果您继承自此类并使用maven-sling-plugin，请确保将继承标记设置为true。

需要实施以下方法：

• extractMetadata()：此方法提取所有可用的元数据。
• getThumbnailImage()：此方法根据传递的资源创建缩略图图像。
• getMimeTypes()：此方法返回资产MIME类型。

以下是示例模板：

包my.own.stuff； /&ast；&ast； &ast； @scr.component inherit="true" &ast； @scr.service &ast；/公共类MyMediaHandler扩展com.day.cq.dam.core.AbstractAssetHandler

接口和类包括：

• com.day.cq.dam.api.handler.AssetHandler 接口：此接口描述添加了对特定MIME类型的支持的服务。 添加新的MIME类型需要实现此接口。 该界面包含用于导入和导出特定文档、创建缩略图和提取元数据的方法。
• com.day.cq.dam.core.AbstractAssetHandler 类：此类用作所有其他资产处理程序实现的基础，并提供常用功能。
• com.day.cq.dam.core.AbstractSubAssetHandler 类：此类用作所有其他资产处理程序实施的基础，并为子资产提取提供常用功能以及常用功能。

示例：创建特定的文本处理程序

在此部分中，您将创建一个特定的文本处理程序，用于生成带有水印的缩略图。

按照以下步骤操作：

请参阅 开发工具 要安装和设置Eclipse，请使用 Maven 插件和来设置所需的依赖项 Maven 项目。

执行以下步骤后，将TXT文件上传到 Experience Manager时，将提取文件的元数据，并生成两个带水印的缩略图。

1. 在Eclipse中，创建 myBundle Maven 项目：

   1. 在菜单栏中，单击 文件 > 新 > 其他.

   2. 在对话框中，展开 Maven 文件夹，选择 Maven 项目并单击 下一个.

   3. 选中创建简单项目框和使用默认工作区位置框，然后单击 下一个.

   4. 定义 Maven 项目：

      • 组ID： com.day.cq5.myhandler.
      • 工件Id：myBundle。
      • 名称：我的 Experience Manager 捆绑。
      • 描述：这是我的 Experience Manager 捆绑。

   5. 单击 完成.

2. 设置 Java 编译器到版本1.5：

   1. 右键单击 myBundle 项目，选择 属性.

   2. 选择 Java编译器 并将以下属性设置为1.5：

      • 编译器符合性级别
      • 生成的.class文件兼容性
      • 源兼容性

   3. 单击​确定。在对话框窗口中，单击 是.

3. 在中替换代码 pom.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. 创建包 com.day.cq5.myhandler 包含 Java 下的类 myBundle/src/main/java：

   1. 在myBundle下，右键单击 src/main/java，选择新建，然后选择包。
   2. 将其命名 com.day.cq5.myhandler ，然后单击“完成”。

5. 创建 Java 类 MyHandler：

   1. In Eclipse，下 myBundle/src/main/java，右键单击 com.day.cq5.myhandler 包。 选择 新，则 类.
   2. 在对话框窗口中，命名 Java 类 MyHandler 并单击 完成. Eclipse 创建并打开文件 MyHandler.java.
   3. In MyHandler.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 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;
    }
   }
   

6. 编译 Java 类并创建捆绑包：

   1. 右键单击 myBundle 项目，选择 运行方式，则 Maven安装.
   2. 捆绑包 myBundle-0.0.1-SNAPSHOT.jar （包含编译的类）创建于 myBundle/target.

7. 在CRX资源管理器中，在 /apps/myApp. 名称= install，类型= nt:folder.

8. 复制捆绑包 myBundle-0.0.1-SNAPSHOT.jar 并将其存储在 /apps/myApp/install （例如，使用WebDAV）。 新的文本处理程序现在在中处于活动状态 Experience Manager.

9. 在浏览器中，打开 Apache Felix Web管理控制台. 选择 组件 制表符并禁用默认文本处理程序 com.day.cq.dam.core.impl.handler.TextHandler.

基于命令行的媒体处理程序

Experience Manager 允许您在工作流中运行任何命令行工具来转换资产(例如 ImageMagick)，并将新演绎版添加到资源。 您只需在托管的磁盘上安装命令行工具 Experience Manager ，向工作流添加并配置流程步骤。 调用的进程，称为 CommandLineProcess，还可以根据特定的MIME类型进行筛选，以及根据新演绎版创建多个缩略图。

以下转化可以自动运行并存储于 Assets：

• EPS和AI转换使用 ImageMagick 和 Ghostscript.
• 使用的FLV视频转码 FFmpeg.
• 使用的MP3编码 LAME.
• 音频处理，使用 SOX.

此 CommandLineProcess 进程会按列出的顺序执行以下操作：

• 根据特定的MIME类型筛选文件（如果指定）。
• 在托管的磁盘上创建临时目录 Experience Manager 服务器。
• 将原始文件流式传输到临时目录。
• 执行由步骤的参数定义的命令。 该命令正在临时目录中执行，并拥有正在运行的用户的权限 Experience Manager.
• 将结果流式传输回的节目文件夹。 Experience Manager 服务器。
• 删除临时目录。
• 如果指定，则基于这些演绎版创建缩略图。 缩略图的数量和尺寸由步骤的参数定义。

使用的示例 ImageMagick

以下示例说明如何设置命令行流程步骤，以便每次将具有miMIME e类型GIF或TIFF的资源添加到时 /content/dam 在 Experience Manager 服务器，将创建原件的翻转图像以及三个其他缩略图（140x100、48x48和10x250）。

要执行此操作，请使用 ImageMagick. ImageMagick 是一个自由命令行软件，用于创建、编辑和合成位图图像。

安装 ImageMagick 在托管的磁盘上 Experience Manager 服务器：

1. 安装 ImageMagick：请参阅 ImageMagick文档.

2. 设置该工具，以便在命令行中运行convert。

3. 要查看工具是否正确安装，请运行以下命令 convert -h 在命令行上。

   它会显示一个帮助屏幕，其中包含转换工具的所有可能选项。

   注意

   在Windows的某些版本中，转换命令可能无法运行，因为它与所属的本机转换实用程序冲突 Windows 安装。 在这种情况下，请提及 ImageMagick 用于将图像文件转换为缩略图的软件。 例如："C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png。

4. 要查看该工具是否正常运行，请将JPG映像添加到工作目录并运行命令convert <image-name>.jpg -flip <image-name>-flipped.jpg 在命令行上。 将翻转的图像添加到目录中。 然后，将命令行流程步骤添加到 DAM更新资产 工作流。

5. 转到 工作流 控制台。

6. 在 模型 选项卡，编辑 DAM更新资产 型号。

7. 更改 参数 的 启用Web的演绎版 步骤至： 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. 保存工作流。

要测试修改后的工作流，请将资源添加到 /content/dam.

1. 在文件系统中，获取您选择的TIFF映像。 将其重命名为 myImage.tiff 并将其复制到 /content/dam，例如通过使用WebDAV。
2. 转到 CQ5 DAM 控制台，例如 https://localhost:4502/libs/wcm/core/content/damadmin.html.
3. 打开资产 myImage.tiff 并验证是否创建了翻转的图像和三个缩略图。

配置CommandLineProcess进程步骤

本节介绍如何设置 CommandLineProcess 的进程参数。

分隔值 进程参数 逗号，且请勿以空格开头。

例如，如果 ImageMagick 安装在托管的磁盘上 Experience Manager 创建流程步骤时，使用 命令行进程 作为实施，以下值作为 进程参数：

mime:image/gif,mime:image/tiff,tn:140:100,tn:48:48,tn:10:250,cmd:convert ${directory}/${filename} -flip ${directory}/${basename}.flipped.jpg

然后，当工作流运行时，该步骤仅适用于具有 image/gif 或 mime:image/tiff 作为 mime-types，它会创建原始图像的翻转图像，将其转换为JPG，并创建三个尺寸为：140x100、48x48和10x250的缩略图。

使用以下内容 进程参数 要创建三个标准缩略图，请使用 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

使用以下内容 进程参数 要创建启用Web的演绎版，请使用 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

Business.Adobe.com 资源

Ecommerce Integrations Style System Targeted Content Personalized Communications Responsive Forms Dynamic Media