创建或配置观察文件夹 create-or-configure-a-watched-folder

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

可以使用watched文件夹用户界面执行以下操作:

  • 创建观察文件夹
  • 修改现有观察文件夹的属性
  • 删除观察文件夹

创建观察文件夹 create-a-watched-folder

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

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

执行以下步骤可创建watched文件夹:

  1. 选择屏幕左上角的​ Adobe Experience Manager ​图标。

  2. 选择​ 工具 > Forms > 配置Watched文件夹。 ​将显示已配置的Watched文件夹的列表。

  3. 选择​ 新建。 此时将显示创建watched文件夹所需的字段列表:

    • 名称:标识监视文件夹。 名称只能使用字母数字字符。

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

    • 进程文件使用:要启动的进程类型。 您可以指定工作流、脚本或服务。

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

      • 对于工作流,请指定要执行的工作流模型。 例如,/etc/workflow/models/<工作流名称>/jcr:content/model
      • 对于脚本,指定要执行的脚本的JCR路径。 例如, /etc/watchfolder/test/testScript.ecma
      • 对于服务,指定用于查找OSGi服务的过滤器。 该服务已注册为com.adobe.aemfd.watchfolder.service.api.ContentProcessor Interface的实现。 例如,以下代码是具有custom (foo=bar)属性的ContentProcessor界面的自定义实施。
    note note
    NOTE
    如果已为​ 使用 ​字段的进程文件选择​ 服务,则必须将Service Name(inputProcessorType)字段的值括在括号中。 例如(foo=bar)。
    code language-java
    @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. 选择​ 高级。 高级选项卡包含更多字段。 这些字段中的大多数都包含默认值。

    • 有效负荷映射器筛选器: ​当您创建观察文件夹时,它会在被观察的文件夹内创建一个文件夹结构。 文件夹结构具有阶段、结果、保留、输入和失败文件夹。 文件夹结构可用作工作流的输入有效负荷并接受工作流的输出。 它还可以列出故障点(如果有)。 有效负荷的结构不同于观察文件夹的结构。 您可以编写自定义脚本以将观察文件夹的结构映射到有效负载。 此类脚本称为有效负荷映射器过滤器。 提供了两种现成的有效负载映射器实施。 如果您没有自定义实施,请使用以下现成实施之一:

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

    • ​之后暂存文件超时:指定已选取进行处理的输入文件/文件夹被视为已超时并标记为失败之前等待的秒数。 仅当此属性的值为正数时,超时机制才会激活。

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

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

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

    • 包含文件模式:指定以分号(;)分隔的模式列表,观察文件夹将使用该模式来确定要扫描和选取的文件夹和文件。 例如,如果“包含文件模式”是input&amp;ast;,则选取与input&amp;ast;匹配的所有文件和文件夹。 默认值为&amp;ast;,表示所有文件和文件夹。 有关文件模式的详细信息,请参阅关于文件模式

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

      此设置对于确保文件或文件夹的所有内容都复制到输入文件夹非常有用。 例如,如果处理的文件很大,且下载文件需要10分钟,则将等待时间设置为10&amp;ast;60&amp;ast;1000毫秒。 此间隔可防止观察文件夹在文件未满十分钟时扫描文件。

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

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

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

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

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

      如果扫描间隔很小,则线程会经常扫描输入文件夹。 如果文件经常被放入观察文件夹,则应该保持较小的扫描间隔。 如果文件不经常被丢弃,请使用较大的扫描间隔,以便其他服务可以使用线程。

    • 限制时间: ​启用此选项后,它会限制AEM Forms在任何给定时间处理的观察文件夹作业数。 “批次大小”值确定最大作业数。 有关详细信息,请参阅限制

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

    • 失败时保留文件: ​当设置为True时,如果失败,则保留输入文件。 默认值为true。

    • 包含具有模式的文件: ​指定以分号(;)分隔的模式列表,观察文件夹使用该模式来确定要扫描和选取的文件夹和文件。 例如,如果输入“包括文件模式”,则会选取与输入匹配的所有文件和文件夹。 有关详细信息,请参阅管理帮助

    • 异步调用Watched文件夹: ​将该调用类型标识为异步或同步。 默认值为asynchronous。 建议对长生命周期进程使用异步,对瞬态或短生命周期进程使用同步。

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

修改现有观察文件夹的属性 modify-properties-of-an-existing-watched-folder

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

  1. 选择屏幕左上角的​ Adobe Experience Manager ​图标。
  2. 选择​ 工具 > Forms > 配置Watched文件夹。 ​将显示已配置的Watched文件夹的列表。
  3. 在Watched Folder屏幕的左侧,选择watchfolder并选择​ 编辑。 ​将显示创建watched文件夹所需的字段列表。 基本 ​选项卡中列出的字段是必填字段。 高级选项卡包含更多字段。 这些字段中的大多数都包含默认值。 您可以根据需要修改这些属性。
  4. 修改属性后,选择​ 更新。 将保存修改后的属性。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2