Criar ou configurar uma pasta monitorada create-or-configure-a-watched-folder

Um administrador pode configurar uma pasta de rede, conhecida como pasta monitorada, de modo que, quando um usuário colocar um arquivo (como um arquivo de PDF) na pasta monitorada, uma operação pré-configurada seja iniciada e manipule o arquivo. Depois que a operação especificada é executada, a operação salva o arquivo modificado em uma pasta de saída especificada. Para obter informações detalhadas sobre como administrar uma pasta monitorada, consulte Ajuda Administrativa.

É possível usar a interface de usuário da pasta monitorada para:

  • Criar uma pasta monitorada
  • Modificar propriedades de uma pasta monitorada existente
  • Excluir uma pasta monitorada

Criar uma pasta monitorada create-a-watched-folder

Antes de configurar uma pasta monitorada, verifique o seguinte:

  • As pastas monitoradas são um recurso avançado dos formulários AEM. Ele requer o pacote complementar do AEM forms para funcionar. Verifique se o pacote complementar apropriado do AEM Forms está instalado e configurado.
  • Você pode criar a pasta monitorada em um armazenamento compartilhado ou em um armazenamento local. Verifique se o usuário do AEM Forms configurado para executar a pasta monitorada tem permissões de leitura e gravação nessa pasta.
  • Você pode usar um Serviço, Fluxo de trabalho ou Script para automatizar uma operação com a pasta monitorada. Verifique se o Serviço, Fluxo de trabalho ou Script correspondente foi criado e está pronto para ser executado. Para obter informações sobre como criar um Serviço, Fluxo de Trabalho e Script, consulte Vários métodos de processamento de arquivos.
  • Uma pasta monitorada tem várias propriedades, consulte Propriedades da pasta monitorada.

Execute as seguintes etapas para criar uma pasta monitorada:

  1. Selecione o ícone Adobe Experience Manager no canto superior esquerdo da tela.

  2. Selecione Ferramentas > Forms > Configurar Pasta Monitorada. Uma lista de pastas monitoradas já configuradas é exibida.

  3. Selecione Novo. Uma lista de campos necessários para criar a pasta monitorada é exibida:

    • Nome: identifica a pasta monitorada. Use somente caracteres alfanuméricos para o nome.

    • Caminho: especifica o local da pasta monitorada. Em um ambiente clusterizado, essa configuração deve apontar para uma pasta de rede compartilhada acessível a cada usuário que executa o AEM em diferentes nós de um cluster.

    • Processar Arquivos Usando: o tipo do processo a ser iniciado. Você pode especificar um fluxo de trabalho, script ou serviço.

    • Nome do Serviço/Caminho do Script/Caminho do Fluxo de Trabalho: o comportamento do campo é baseado no valor especificado para o campo Processar Arquivos Usando. Você pode especificar os seguintes valores:

      • Em Fluxo de trabalho, especifique o modelo de fluxo de trabalho que será executado. Por exemplo, /etc/workflow/models/<workflow_name>/jcr:content/model
      • Para Script, especifique o caminho JCR do script a ser executado. Por exemplo, /etc/watchfolder/test/testScript.ecma
      • Para Serviço, especifique o filtro usado para localizar um serviço OSGi. O serviço é registrado como uma implementação da interface com.adobe.aemfd.watchfolder.service.api.ContentProcessor. Por exemplo, o código a seguir é uma implementação personalizada da interface ContentProcessor com uma propriedade personalizada (foo=bar).
    note note
    NOTE
    Se você selecionou Serviço para o campo Processar Arquivos Usando, o valor do campo Nome do Serviço(inputProcessorType) deverá estar entre parênteses. Por exemplo (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 {
    
    • Padrão do Arquivo de Saída: especifique uma lista delimitada por ponto-e-vírgula (;) de padrões que uma pasta monitorada usa para determinar o nome e o local dos arquivos e pastas de saída. Para obter mais informações sobre padrões de arquivo, consulte Sobre padrões de arquivo.
  4. Selecione Avançado. A guia Advanced contém mais campos. A maioria desses campos contém um valor padrão.

    • Filtro do Mapeador de Carga: Quando você cria uma pasta monitorada, ele cria uma estrutura de pastas dentro da pasta que está sendo monitorada. A estrutura de pastas tem pastas de preparo, resultado, preservação, entrada e falha. A estrutura de pastas pode servir como carga de entrada para o fluxo de trabalho e aceitar a saída de um fluxo de trabalho. Ele também pode listar pontos de falha, se houver. A estrutura de uma carga é diferente da estrutura de uma pasta monitorada. Você pode gravar scripts personalizados para mapear a estrutura de uma pasta monitorada para a carga útil. Esse script é chamado de filtro de mapeador de carga útil. Duas implementações prontas para uso do mapeador de carga estão disponíveis. Se você não tiver uma implementação personalizada, use uma das implementações predefinidas:

      • Mapeador padrão: use o mapeador de carga padrão para manter os conteúdos de entrada e saída das pastas monitoradas em pastas de entrada e saída separadas na carga.
      • Mapeador de carga baseado em arquivo simples: use o mapeador de carga baseado em arquivo simples para manter o conteúdo de entrada e saída diretamente na pasta de carga. Ela não cria nenhuma hierarquia extra, como o mapeador padrão.
    • Modo de Execução: especifique a lista separada por vírgulas de modos de execução permitidos para execução de fluxo de trabalho.

    • Arquivos de Preparação com Tempo Limite Após: especifique o número de segundos a ser aguardado antes que um arquivo/pasta de entrada que já tenha sido selecionado para processamento seja tratado como tendo o tempo limite atingido e marcado como uma falha. O mecanismo de tempo limite só é ativado quando o valor dessa propriedade é um número positivo.

    • Excluir Arquivos do Palco com Tempo Limite Limitado: se habilitado, o mecanismo Arquivos do Palco com Tempo Limite Após será ativado somente quando a limitação estiver ativada para a pasta monitorada.

    • Verificar a Pasta de Entrada a Cada: Especifique o intervalo de tempo, em segundos, para verificar a pasta monitorada em busca de entradas. A menos que a configuração de Aceleração esteja ativada, o Intervalo de Sondagem deve ser maior que o tempo médio para processar um trabalho; caso contrário, o sistema pode ficar sobrecarregado. O valor do intervalo deve ser maior ou igual a um.

    • Excluir Padrão de Arquivo: especifique uma lista de padrões delimitada por ponto-e-vírgula (;) que uma pasta monitorada usa para determinar quais arquivos e pastas serão verificados e selecionados. Qualquer arquivo ou pasta com o padrão especificado não é examinado para processamento. Para obter mais informações sobre padrões de arquivo, consulte Sobre padrões de arquivo.

    • Incluir Padrão de Arquivo: especifique uma lista de padrões delimitada por ponto-e-vírgula (;) que a pasta monitorada usa para determinar quais pastas e arquivos serão verificados e selecionados. Por exemplo, se o Padrão do arquivo de inclusão for input*, todos os arquivos e pastas que corresponderem a input* serão selecionados. O valor padrão é * e indica todos os arquivos e pastas. Para obter mais informações sobre padrões de arquivo, consulte Sobre Padrões de Arquivo.

    • Tempo de Espera: especifique o tempo, em milissegundos, a ser aguardado antes de examinar uma pasta ou um arquivo após sua criação. Por exemplo, se o tempo de espera for de 3.600.000 milissegundos (uma hora) e o arquivo tiver sido criado há um minuto, esse arquivo será selecionado após 59 minutos ou mais. O valor padrão é 0.

      Essa configuração é útil para garantir que todo o conteúdo do arquivo ou pasta seja copiado para a pasta de entrada. Por exemplo, se você tiver um arquivo grande para processar e o download demorar dez minutos, defina o tempo de espera como 10*60 *1000 milissegundos. Esse intervalo impede que a pasta monitorada verifique o arquivo se ele não tiver dez minutos.

    • Excluir os Resultados Anteriores a: Especifique o tempo, em número de dias, a ser aguardado antes de excluir os Arquivos e as pastas anteriores ao valor especificado. Essa configuração é útil para garantir que a pasta de resultados não fique cheia. Um valor de -1 dias indica que a pasta de resultados nunca deve ser excluída. O valor padrão é -1.

    • Nome da Pasta de Resultado: Especifique o nome da pasta para armazenar os resultados. Se os resultados não aparecerem nessa pasta, verifique a pasta de falha. Arquivos somente leitura não são processados e são salvos na pasta de falha. Você pode usar um caminho absoluto ou relativo com os seguintes padrões de arquivo:

      • %F = prefixo do nome do arquivo
      • %E = extensão de nome de arquivo
      • %Y = ano (completo)
      • %y = ano (últimos dois dígitos)
      • %M = mês
      • %D = dia do mês
      • %d = dia do ano
      • %H = hora (relógio de 24 horas)
      • %h = hora (relógio de 12 horas)
      • %m = minuto
      • %s = segundo
      • %l = milissegundo
      • %R = número aleatório (entre 0-9)
      • %P = id do processo ou da tarefa
      • Por exemplo, se for 8 PM em 17 de julho de 2009 e você especificar C:/Test/WF0/failure/%Y/%M/%D/%H/, a pasta resultante será C:/Test/WF0/failure/2009/07/17/20.
      • Se o caminho não for absoluto, mas relativo, a pasta será criada dentro da pasta monitorada. O valor padrão é result/%Y/%M/%D/, que é a pasta Result dentro da pasta monitorada. Para obter mais informações sobre padrões de arquivo, consulte Sobre padrões de arquivo.
    • Nome da Pasta com Falha: Especifique a pasta onde os arquivos com falha são salvos. Este local é sempre relativo à pasta monitorada. Você pode usar padrões de arquivo, conforme descrito em Pasta de resultados.

    • Preservar Nome da Pasta: Especifique a pasta onde os arquivos são armazenados após a verificação e coleta bem-sucedidas. O caminho pode ser um diretório absoluto, relativo ou nulo. Você pode usar padrões de arquivo, conforme descrito em Pasta de resultados. O valor padrão é preserve/%Y/%M/%D/.

    • Tamanho do Lote: Especifique o número de arquivos ou pastas a serem selecionados por verificação. Isso evita uma sobrecarga no sistema; a varredura de muitos arquivos de uma vez pode causar travamento. O valor padrão é 2.

      Se o intervalo de verificação for pequeno, as threads examinam a pasta de entrada com frequência. Se os arquivos forem colocados com frequência na pasta monitorada, mantenha o intervalo de verificação pequeno. Se os arquivos forem descartados com pouca frequência, use um intervalo de verificação maior para que os outros serviços possam usar as threads.

    • Limitação ativada: Quando esta opção está habilitada, ela limita o número de trabalhos de pastas monitorados que o AEM forma a qualquer momento. O valor Tamanho do Lote determina o número máximo de trabalhos. Para obter mais informações, consulte limitação

    • Substituir Arquivos Existentes com Nome Semelhante: Quando definido como Verdadeiro, os arquivos na pasta de resultados e na pasta de preservação serão substituídos. Quando definido como False, os arquivos e as pastas com um sufixo de índice numérico são usados para o nome. O valor padrão é Falso.

    • Preservar Arquivos na Falha: Quando definido como Verdadeiro, os arquivos de entrada serão preservados em caso de falha. O valor padrão é true.

    • Incluir Arquivos com Padrão: Especifique uma lista de padrões delimitada por ponto-e-vírgula (;) que a pasta monitorada usa para determinar quais pastas e arquivos serão verificados e selecionados. Por exemplo, se Incluir padrão de arquivo for entrada, todos os arquivos e pastas que correspondem à entrada serão coletados. Para obter mais informações, consulte Ajuda Administrativa

    • Invocar Pasta Monitorada de Forma Assíncrona: Identifica o tipo de invocação como assíncrono ou síncrono. O valor padrão é assíncrono. O assíncrono é recomendado para processos de longa duração, enquanto o síncrono é recomendado para processos transitórios ou de curta duração.

    • Habilitar Pasta Monitorada: quando esta opção está habilitada, a pasta monitorada é habilitada. O valor padrão é True.

Modificar propriedades de uma pasta monitorada existente modify-properties-of-an-existing-watched-folder

Além de alterar o nome da pasta monitorada, você pode modificar todas as propriedades de uma pasta monitorada existente. Execute as seguintes etapas para modificar propriedades de uma pasta monitorada existente:

  1. Selecione o ícone Adobe Experience Manager no canto superior esquerdo da tela.
  2. Selecione Ferramentas > Forms > Configurar Pasta Monitorada. Uma lista de pastas monitoradas já configuradas é exibida.
  3. No lado esquerdo da tela Pasta monitorada, selecione a pasta monitorada e selecione Editar. Uma lista de campos necessários para criar a pasta monitorada é exibida. Os campos listados na Guia Básico são obrigatórios. A guia Advanced contém mais campos. A maioria desses campos contém um valor padrão. Você pode modificar essas propriedades de acordo com seus requisitos.
  4. Depois de modificar as propriedades, selecione Atualizar. As propriedades modificadas são salvas.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2