创建或配置监视的文件夹

管理员可以配置网络文件夹(称为​监视文件夹),这样,当用户将文件(如PDF文件)放置到监视文件夹时,将启动预配置的操作并处理该文件。 执行指定操作后,操作会将修改后的文件保存到指定的输出文件夹中。 有关管理监视文件夹的详细信息,请参阅管理帮助

您可以使用监视的文件夹用户界面执行以下操作:

  • 创建监视文件夹
  • 修改现有监视文件夹的属性
  • 删除监视的文件夹

创建监视文件夹

在配置监视文件夹之前,请确保:

  • 监视文件夹是AEM表单的高级功能。 它需要AEM forms add-on包才能正常工作。 确保安装并配置了适当的AEM Forms加载项包。
  • 您可以在共享或本地存储创建已监视的文件夹。 确保配置为运行监视文件夹的AEM forms用户对监视文件夹具有读写权限。
  • 您可以使用服务、工作流或脚本自动处理监视文件夹的操作。 确保创建相应的服务、工作流或脚本并准备运行。 有关创建服务、工作流和脚本的信息,请参阅各种处理文件的方法
  • 监视的文件夹具有各种属性,请参阅监视的文件夹属性

执行以下步骤以创建监视的文件夹:

  1. 点按屏幕左上角的​Adobe Experience Manager​图标。

  2. 点按​工具 > Forms > 配置监视文件夹。 将显示已配置的监视文件夹列表。

  3. 点按​新建。 将显示创建监视文件夹所需的一列表字段:

    • 名称:标识已监视的文件夹。名称仅使用字母数字字符。

    • 路径:指定监视的文件夹位置。在群集环境中,此设置必须指向共享网络文件夹,每个在群集的不同节点上运行AEM的用户都可以访问该文件夹。

    • 处理文件时使用:要开始的进程类型。您可以指定工作流、脚本或服务。

    • 服务名称/脚本路径/工作流路径:字段的行为基于为“进程文件使用”字段 指定的 值。您可以指定以下值:

      • 对于“工作流”,指定要执行的工作流模型。 例如,/etc/workflow/models/<workflow_name>/jcr:content/model
      • 对于“脚本”,指定要执行的脚本的JCR路径。 例如,/etc/watchfolder/test/testScript.ecma
      • 对于服务,指定用于查找OSGi服务的筛选器。 服务注册为com.adobe.aemfd.watchfolder.service.api.ContentProcessor Interface的实现。 例如,以下代码是具有自定义(foo=bar)属性的ContentProcessor接口的自定义实现。
    注意

    如果已为​使用​的处理文件字段选择了​服务,则服务名称(inputProcessorType)字段的值必须括在括号中。 例如,(foo=bar)。

    @Component(metatype = true, immediate = true, label = "WF Test Service", description = "WF Test Service")
    @Service(value = {OutputWriter.class, ContentProcessor.class})
    @Property(name = "foo", value = "bar")
    public class OutputWriter implements ContentProcessor {
    
    • 输出文件模式:指定分号(;)分隔的模式列表,监视的文件夹使用这些模式确定输出文件和文件夹的名称和位置。有关文件模式的详细信息,请参阅关于文件模式
  4. 点按​高级。 高级选项卡包含更多字段。 这些字段中的大多数都包含默认值。

    • 有效负荷映射 器过滤器:在创建已监视的文件夹时,它会在正在监视的文件夹中创建文件夹结构。文件夹结构具有阶段、结果、保留、输入和失败文件夹。 文件夹结构可用作工作流的输入有效负荷,并接受工作流的输出。 它还可以列表故障点(如果有)。 有效负荷的结构与监视文件夹的结构不同。 您可以编写自定义脚本,将已监视文件夹的结构映射到有效负荷。 这种脚本称为负载映射器过滤器。 提供两种现成的有效负荷映射器实现。 如果您没有自定义实现,请使用现成的实现之一:

      • 默认映射器: 使用默认的有效负荷映射器,将已监视文件夹的输入和输出内容保留在有效负荷中单独的输入和输出文件夹中。
      • 简单的基于文件的有效负荷映射 器:使用简单的基于文件的有效负荷映射器将输入和输出内容直接保留在有效负荷文件夹中。它不会创建任何额外的层次结构,如默认映射器。
    • 运行模式:为工作流执行指定允许的运行模式以逗号分隔的列表。

    • 在以下情况下超时暂存文件:指定等待的秒数,此时输入文件/文件夹已被拾取以进行处理,被视为超时并标记为失败。只有当此属性的值为正数时,停时机制才会激活。

    • 在限制时删除超时暂存文件:如果启用,则 只有在为已监 视的文件夹打开限制时,才会激活“超时暂存文件后”机制。

    • 每次扫描输入文件 夹:指定扫描监视的文件夹以查找输入的时间间隔(以秒为单位)。除非启用“限制”设置,否则轮询间隔应比处理平均作业的时间长;否则,系统可能会过载。 间隔的值必须大于或等于1。

    • 排除文件模式:指定分号(;)分隔的模式列表,监视的文件夹使用这些模式确定要扫描和拾取的文件和文件夹。不扫描具有指定模式的任何文件或文件夹进行处理。 有关文件模式的详细信息,请参阅关于文件模式

    • 包括文件模式:指定分号(;)分隔的模式列表,监视的文件夹使用这些模式确定要扫描和拾取的文件夹和文件。例如,如果“包括文件模式”为input&ast;,则所有与input&ast匹配的文件和文件夹;被捡起来。 默认值为&ast;并指示所有文件和文件夹。 有关文件模式的详细信息,请参阅关于文件模式

    • 等待时间: 指定在创建文件夹或文件后扫描文件之前等待的时间(以毫秒为单位)。例如,如果等待时间为3,600,000毫秒(1小时),且文件是在一分钟前创建的,则此文件将在59分钟或更长时间后被拾取。 默认值为 0。

      此设置有助于确保将文件或文件夹的所有内容复制到输入文件夹。 例如,如果要处理一个大文件,并且该文件需要10分钟才能下载,请将等待时间设置为10&ast;60 &ast;1000毫秒。 如果文件未保存10分钟,此时间间隔将阻止监视的文件夹扫描文件。

    • 删除早于以下时间 的结果:指定删除早于指定值的文件和文件夹之前要等待的时间(以天为单位)。此设置有助于确保结果文件夹不变为完整文件夹。 值为-1天表示从不删除结果文件夹。 默认值为-1。

    • 结果文件夹名 称:指定用于存储结果的文件夹的名称。如果结果未显示在此文件夹中,请检查失败文件夹。 只读文件不会处理,并保存在失败文件夹中。 可将绝对或相对路径与以下文件模式一起使用:

      • %F =文件名前缀
      • %E =文件扩展名
      • %Y =年(已满)
      • %y =年(最后两位)
      • %M =月
      • %D =月日
      • %d =年
      • %H =小时(24小时钟)
      • %h =小时(12小时钟)
      • %m =分钟
      • %s =秒
      • %l =毫秒
      • %R =随机数(介于0和9之间)
      • %P =进程或作业ID
      • 例如,如果2009年7月17日晚上8点,并且您指定C:/Test/WF0/failure/%Y/%M/%D/%H/,则结果文件夹为C:/Test/WF0/failure/2009/07/17/20。
      • 如果路径不是绝对的,而是相对的,则在监视的文件夹内创建该文件夹。 默认值为result/%Y/%M/%D/,它是监视文件夹内的Result文件夹。 有关文件模式的详细信息,请参阅关于文件模式
    • 失败文件夹名 称:指定保存失败文件的文件夹。此位置始终相对于监视的文件夹。 可以使用文件模式,如结果文件夹中所述。

    • 保留文件夹名 称:指定成功扫描和拾取文件后存储文件的文件夹。路径可以是绝对、相对或null目录。 可以使用文件模式,如结果文件夹中所述。 默认值为preseve/%Y/%M/%D/。

    • 批量大 小:指定每次扫描要拾取的文件或文件夹数。它防止了系统过载;一次扫描过多文件可能会导致崩溃。 默认值为 2。

      如果扫描间隔较小,线程会经常扫描输入文件夹。 如果文件经常被放入监视的文件夹,则扫描间隔应保持较小。 如果文件不常被删除,请使用更大的扫描间隔,以便其他服务可以使用线程。

    • 限制开启: 启用此选项后,它将限制AEM表单在任何给定时间处理的监视文件夹作业数。“批量大小”值确定作业的最大数量。 有关详细信息,请参阅限制

    • 用类似名称覆盖现有文件:设置为“True”时,结果文件夹和保留文件夹中的文件将被覆盖。设置为“False”时,名称将使用带有数字索引后缀的文件和文件夹。 默认值为False。

    • 失败时保留文 件:设置为True时,在失败时保留输入文件。默认值为true。

    • 包括带有模式的 文件:指定被监视文件夹用于确定扫描和拾取哪些文件夹和文件的模式的分号(;)分隔列表。例如,如果“包括文件模式”为input&ast;,则所有与input&ast匹配的文件和文件夹;被捡起来。 有关详细信息,请参阅管理帮助

    • 异步调用监视的文 件夹:将调用类型标识为异步或同步。默认值为异步。 对于长寿命进程,建议使用异步,而对于瞬态或短寿命进程,建议使用同步。

    • 启用监视文 件夹:启用此选项后,将启用监视文件夹。默认值为True。

修改现有监视文件夹的属性

除了更改已监视文件夹的名称外,您还可以修改现有已监视文件夹的所有属性。 请执行以下步骤来修改现有监视文件夹的属性:

  1. 点按屏幕左上角的​Adobe Experience Manager​图标。
  2. 点按​工具 > Forms > 配置监视文件夹。 将显示已配置的监视文件夹列表。
  3. 在“监视文件夹”屏幕的左侧,选择监视文件夹,然后点按​编辑。 将显示创建监视文件夹所需的列表字段。Basic​选项卡中列出的字段为必填字段。 高级选项卡包含更多字段。 这些字段中的大多数都包含默认值。 您可以根据自己的要求修改这些属性。
  4. 修改属性后,点按​更新。 将保存修改的属性。

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now