Introdução ao Process Relatórios

O Relatórios de processos oferece aos usuários do AEM Forms a capacidade de query de informações sobre processos do AEM Forms que estão definidos na implementação do AEM Forms. Entretanto, o Relatórios Process não acessa dados diretamente do repositório do AEM Forms. Os dados são publicados pela primeira vez no repositório de Relatórios do Processo de forma programada (pelos serviços ProcessDataPublisher e ProcessDataStorage). Os relatórios e query em andamento são gerados a partir dos dados de Relatórios do Processo publicados no repositório. O Relatórios Process é instalado como parte do módulo de Fluxo de trabalho do Forms.

Este artigo detalha as etapas para permitir a publicação de dados do AEM Forms no repositório do Process Relatórios. Depois disso, você poderá usar o Processar Relatórios para executar relatórios e query. O artigo também aborda as opções disponíveis para configurar os serviços de Relatórios do Processo.

Pré-requisitos do Relatórios de processamento

Limpar processos não essenciais

Se você estiver usando o Fluxo de trabalho do Forms, o banco de dados do AEM Forms pode conter uma grande quantidade de dados

Os serviços de publicação de Relatórios do processo publicarão todos os dados do AEM Forms disponíveis no momento no banco de dados. Isso implica que, se o banco de dados contiver dados herdados nos quais você não deseja executar relatórios e query, todos esses dados também serão publicados no repositório, mesmo que não sejam necessários para o relatórios. É recomendável expurgar esses dados antes de executar os serviços para publicar os dados no repositório do Process Relatórios. Isso melhorará o desempenho do serviço do editor e do serviço que query os dados para o relatórios.

Para obter detalhes sobre como expurgar dados de processo do AEM Forms, consulte Expurgando dadosdo processo.

Observação

Para obter as dicas e truques do Utilitário de remoção, consulte o artigo do Adobe Developer Connection sobre Expurgação de processos e trabalhos.

Configurando serviços de Relatórios do processo

Agendar publicação de dados do processo

Os serviços de Relatórios do Processo publicam dados do banco de dados do AEM Forms para o repositório de Relatórios do Processo de forma programada.

Essa operação pode consumir muitos recursos e afetar o desempenho dos servidores do AEM Forms. É recomendável agendar isso fora dos horários ocupados do servidor do AEM Forms.

Por padrão, a publicação de dados está programada para ser executada todos os dias às 2h00.

Execute as seguintes etapas para alterar o cronograma de publicação:

Observação

Se você estiver executando sua implementação do AEM Forms em um cluster, execute as seguintes etapas em cada nó do cluster.

  1. Pare a instância do servidor do AEM Forms.

    • (Para Windows) Abra o [JBoss root]/bin/run.conf.bat arquivo em um editor.
    • (Para Linux, AIX e Solaris) [JBoss root]/bin/run.conf.sh em um editor.
  2. Adicione o argumento JVM -Dreporting.publisher.cron = <expression>.

    Exemplo: A expressão cron a seguir faz com que o Process Relatórios publique dados do AEM Forms no repositório do Process Relatórios a cada 5 horas:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  3. Salve e feche o run.conf.bat arquivo.

  4. Reinicie a instância do servidor do AEM Forms.

  5. Pare a instância do servidor do AEM Forms.

  6. Faça logon no Console administrativo do WebSphere. Na árvore de navegação, clique em Servidores > Servidores de aplicativos e, no painel direito, clique no nome do servidor.

  7. Em Infraestrutura do servidor, clique em Java e em Gerenciamento do processo > Definição do processo.

  8. Em Propriedades adicionais, clique em Java Virtual Machine.

    Na caixa Argumentos JVM genéricos, adicione o argumento -Dreporting.publisher.cron = <expression>.

    Exemplo: A expressão cron a seguir faz com que o Process Relatórios publique dados do AEM Forms no repositório do Process Relatórios a cada 5 horas:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  9. Clique em Aplicar, clique em OK e em Salvar diretamente na configuração mestre.

  10. Reinicie a instância do servidor do AEM Forms.

  11. Pare a instância do servidor do AEM Forms.

  12. Faça logon no Console de administração do WebLogic. O endereço padrão do Console de administração do WebLogic é https://[hostname]:[port]/console.

  13. Em Centro de alterações, clique em Bloquear e editar.

  14. Em Estrutura do domínio, clique em Ambiente > Servidores e, no painel direito, clique no nome do servidor gerenciado.

  15. Na tela seguinte, clique na guia Configuração > guia Start ​Servidor.

  16. Na caixa Argumentos, adicione o argumento JVM -Dreporting.publisher.cron = <expression>.

    Exemplo: A expressão cron a seguir faz com que o Process Relatórios publique dados do AEM Forms no repositório do Process Relatórios a cada 5 horas:

    -Dreporting.publisher.cron = 0_0_0/5_*_*_?

  17. Clique em Salvar e em Ativar alterações.

  18. Reinicie a instância do servidor do AEM Forms.

processamento datapubiterservice

Serviço ProcessDataStorage

O serviço ProcessDataStorageProvider recebe dados do processo do serviço ProcessDataPublisher e salva os dados no repositório do Relatórios Process.

Em cada ciclo de publicação, os dados são salvos em subpastas de uma pasta raiz predefinida.

Você pode usar o console Administração para configurar a raiz (padrão: /content/reporting/pm) local e subpasta (padrão: /yyyy/mm/dd/hh/mi/ss) formato de hierarquia em que os dados do processo seriam armazenados.

Para configurar os locais do repositório do Process Relatórios

  1. Faça logon no Console ​de administração com credenciais de administrador. O URL padrão do Console de administração é https://'[server]:[port]'/adminui

  2. Navegue até Início > Serviços > Aplicativos e serviços > Gerenciamento ​de serviços e abra o serviço ProcessDataStorageProvider .

    process-data-armazenamento-service

    PastadaRaiz

    O local CRX dentro do qual os dados do processo seriam armazenados para o relatórios.

    Default: /content/reporting/pm

    Hierarquia da pasta

    A hierarquia de pastas dentro da qual os dados do processo seriam armazenados com base no tempo de criação do processo.

    Default: /yyyy/mm/dd/hh/mi/ss

  3. Clique em Salvar.

Serviço ReportConfiguration

O serviço ReportConfiguration é usado pelo Process Relatórios para configurar o serviço de query do relatórios do processo.

To configure the ReportingConfiguration service

  1. Faça logon no Configuration Manager com credenciais de administrador do CRX. O URL padrão do Configuration Manager é https://'[server]:[port]'/lc/system/console/configMgr

  2. Abra o serviço ReportingConfiguration .

  3. Número de registros

    Ao executar um query no repositório, um resultado pode conter potencialmente um grande número de registros. Se o conjunto de resultados for grande, a execução do query poderá consumir recursos do servidor.

    Para lidar com grandes conjuntos de resultados, o serviço ReportConfiguration divide o processamento do query em lotes de registros. Isso reduz a carga do sistema.

    Default: 1000

    Caminho do Armazenamento CRX

    O local CRX dentro do qual os dados do processo devem ser armazenados para o relatórios.

    Default: /content/reporting/pm

    Observação

    Esse é o mesmo local especificado na opção de configuração ProcessDataStorage, Pasta raiz.

    Se você atualizar a opção Pasta raiz na configuração ProcessDataStorage, precisará atualizar o local do Caminho do Armazenamento CRX no serviço ReportConfiguration.

  4. Clique em Salvar e feche o CQ Configuration Manager.

Serviço ProcessDataPublisher

O serviço ProcessDataPublisher importa dados do processo do banco de dados do AEM Forms e publica os dados no serviço ProcessDataStorageProvider para o armazenamento.

Para configurar o serviço ProcessDataPublisher

  1. Faça logon no Console ​de administração com credenciais de administrador.

    O URL padrão é https://'server':port]/adminui/.

  2. Navegue até Início > Serviços > Aplicativos e serviços > Gerenciamento ​de serviços e abra o serviço ProcessDataPublisher .

processdatapubelebpublisherservice-1

Publicar dados

Ative essa opção para start de dados do processo de publicação. Por padrão, a opção está desativada.

Habilite Processar Relatórios somente quando todas as configurações relacionadas aos componentes Processar Relatórios estiverem configuradas adequadamente.

Como alternativa, use essa opção para desativar o processo de publicação de dados quando não for mais necessário.

Default: Off

Intervalo de Lote (seg)

Cada vez que o serviço ProcessDataPublisher é executado, o serviço divide primeiro o tempo desde a última execução do serviço pelo Intervalo em Lote. O serviço processa cada intervalo de dados do AEM Forms separadamente.

Isso ajuda a controlar o tamanho dos dados que os processos do editor terminam durante cada execução (lote) em um ciclo.

Por exemplo, se o editor é executado todos os dias, em vez de processar os dados inteiros por um dia em uma única execução, por padrão, divide o processamento em 24 lotes de uma hora cada.

Default: 3600

Unit: Seconds

Tempo limite de bloqueio (s)

O serviço do editor adquire um bloqueio quando start os dados de processamento para que várias instâncias do editor não start a execução e o processamento de dados simultaneamente.

Se um serviço do editor que adquiriu um bloqueio estiver inativo pelo número de segundos definido pelo valor de Tempo limite de bloqueio, seu bloqueio será liberado para que outras instâncias do serviço do editor possam continuar o processamento.

Default: 3600

Unit: Seconds

Publicar dados de

O ambiente do AEM Forms contém dados do momento em que o ambiente foi configurado.

Por padrão, o serviço ProcessDataPublisher importa todos os dados do banco de dados do AEM Forms.

Dependendo das necessidades do seu relatórios, se você planeja executar relatórios e query em dados após uma determinada data e hora, é recomendável especificar a data e a hora. O serviço de publicação publicará a data a partir desse momento.

Default: 01-01-1970 00:00:00

Format: dd-MM-yyyy HH:mm:ss

Acessar a interface do usuário do Process Relatórios

A interface do usuário para o Process Relatórios é baseada em navegador.

Depois de configurar o Process Relatórios, você pode start trabalhando com o Process Relatórios no seguinte local na instalação do AEM Forms:

https://<server>:<port>/lc/pr

Fazer logon no Relatórios Process

Quando você navega até o URL do Relatórios do processo (https://<server>:<port>/lc/pr), a tela de logon é exibida.

Especifique suas credenciais para fazer logon no módulo Processar Relatórios.

Observação

Para fazer logon na interface do usuário do Process Relatórios, você precisa da seguinte permissão de AEM Forms:

PERM_PROCESS_REPORTING_USER

Logon no Relatórios Process

Quando você faz logon no Processar Relatórios, a tela Início é exibida.

Tela inicial do Relatórios do processo

tela inicial do relatórios do processo

Processar visualização da árvore de Relatórios: A visualização em árvore no lado esquerdo da tela Início contém os itens dos módulos Processar Relatórios.

A visualização em árvore consiste nos seguintes itens de nível superior:

Relatórios: Este item contém os relatórios predefinidos que acompanham o Relatórios do processo.

Para obter detalhes sobre os relatórios predefinidos, consulte Relatórios Relatóriospredefinidos em andamento.

Query Ad-hoc: Este item contém opções para executar pesquisa baseada em filtro para processos e tarefas.

Para obter detalhes sobre query ad-hoc, consulte Query ad-hoc no RelatóriosProcess.

Personalizado: O nó Personalizado exibe relatórios personalizados que você cria.

Para obter o procedimento de criação e exibição de relatórios personalizados, consulte Relatórios Relatóriospersonalizados em andamento.

Barra de título do Relatórios do processo: A barra de título do Relatórios Process contém algumas opções genéricas que podem ser usadas ao trabalhar na interface do usuário.

Título do Relatórios do processo: O título do Relatórios Process é exibido no canto esquerdo da barra de título.

Clique no título a qualquer momento para voltar à tela inicial.

Hora da última atualização: Os dados do processo são publicados do banco de dados do AEM Forms para o repositório do Process Relatórios de forma programada.

A Hora da Última Atualização exibe a última data e hora até as quais as atualizações de dados foram enviadas para o repositório do Process Relatórios.

Para obter detalhes sobre o serviço de publicação de dados e como agendar esse serviço, consulte Agendar a publicação de dados do processo no artigo Introdução ao Relatórios de processo.

Processar usuário do Relatórios: O nome de usuário conectado é exibido à direita da hora da Última atualização.

lista suspensa da barra de título do Relatórios do processo: A lista suspensa no canto direito da barra de título Processar Relatórios contém as seguintes opções:

  • Sincronizar: Sincronize o repositório incorporado do Relatórios do Processo com o banco de dados do AEM Forms.
  • Ajuda: Visualização na documentação de Ajuda do Process Relatórios.
  • Logout: Fazer logout do Relatórios Process

Nesta página