Cache generation

Introdução

Observação:

Neste guia, assume-se que haja apenas um ambiente.

Antes de um usuário final poder acessar um ambiente e a versão que está ativa nele, os dados precisam ser adquiridos (por exemplo, consultas em um banco de dados externo) e cálculos precisam ser armazenados em cache. O resultado de uma única geração de cache como essa é chamado de 'instância'.

Os caches podem ser gerados manualmente ou automatizados. O resultado dessas gerações de cache pode ser visto na aba Dados Liberados de Superadmin.

Gerando caches manualmente

Para criar instâncias de dados, você deve gerar caches que são necessários para permitir que os usuários finais acessem o aplicativo.

Siga estes passos para criar um cache para sua versão.

Etapa	Ação
1	Vá para a aba de dados Liberados do Superadmin.
2	Clique em Gerar cache agora.
3	Clique em GERAR CACHE.
4	Quando a caixa de diálogo mostrar Concluído, clique em FECHAR.

Uma nova linha foi adicionada com seu nome de módulo e uma coluna para o datarun nomeado com base na data atual, 1/1 é exibido nesta coluna indicando que a instância foi gerada com sucesso.

Se você clicar na seta para expandir a linha, você verá seu nome de organização e alguns ícones na linha, indicando que a geração de dados foi bem-sucedida e que essa instância de dados agora está ativa. Veja a ilustração abaixo.

Gerando caches automaticamente

A geração de cache também pode ser feita periodicamente (por exemplo, diariamente), ao invés de manualmente. Isso é útil quando os dados são consultados de um banco de dados externo, pois isso disponibilizará os dados atualizados para os usuários finais automaticamente.

Para configurar isso, o acesso de administrador para o servidor é necessário.

É possível gerar caches para módulos específicos na versão ativa. Use app=MODULECODE ao invés de app=* no arquivo em lotes (veja abaixo). Se app=* for usado, os caches são gerados para todos os módulos na versão ativa.

Também é possível gerar caches para organizações específicas. Use o=[org] para gerar um cache para a organização especificada. Se o=* for usado, os caches são gerados para toda a organização em ordem sequencial.

Observação:

Isso é aplicável apenas para aplicativos que não usam um conector para gerar dados de entrada.

Siga estes passos para agendar uma tarefa para gerar caches.

Etapa	Ação
1	Abra o diretório PLATFORMDIR.
2	Crie um arquivo em lotes vazio, por exemplo: generatecaches.bat.
3	Edite esse arquivo em lote, e use a linha a seguir como conteúdo: call builds/processgold.bat -DataServer -ccdb app=* o=org refreshmvncaches=both Esse arquivo gerará caches para todos os aplicativos.
4	Agende uma tarefa no Windows para chamar esse arquivo em lotes.

Uma tarefa agendada será executada periodicamente para gerar caches para todos os projetos para essa instalação do UiPath Process Mining.

Importante:

Recomendamos executar essa tarefa fora do horário de trabalho para que tenha o mínimo impacto possível em seus usuários.

Interpretando resultados

A exibição de dados liberados contém as instâncias de dados geradas para cada módulo.

Abaixo está uma descrição dos ícones indicando o estado de uma instância.

Ícone	Description
A	A instância de dados ativa atualmente.
B	Uma instância de dados válida.
C	Uma instância de dados válida, mas com avisos.
D	Uma instância de dados com falha.
E	Uma instância de dados válida, mas bloqueada.
F	Uma instância de dados com falha, mas marcada como corrigida.

Quando uma nova instância de dados for criada, ela será automaticamente definida como ativa se for válida. No entanto, se ela falhar, a última instância válida permanecerá ativa em seu lugar.

Visualizando o log detalhado da geração de instâncias de dados

Às vezes, é necessário analisar um log mais detalhado da geração de instâncias de dados. Por exemplo, quando um erro ou aviso ocorrer e você quiser ver mais detalhes.

Siga estes passos para visualizar o log de uma geração de instância de dados.

Etapa	Ação
1	Vá para a aba de dados Liberados do Superadmin.
2	Clique com o botão direito do mouse na instância de dados cujo log você deseja visualizar e selecione Exibir log. (opcional: Selecione os módulos para usar, veja 'a caixa de diálogo Selecionar Instâncias')
3	Clique em OK.

O log da geração de instâncias de dados é exibido.

Abrindo uma instância

Siga estes passos para visualizar uma instância de dados específica.

Etapa	Ação
1	Vá para a aba de dados Liberados do Superadmin.
2	Clique com o botão direito do mouse na instância de dados que você deseja abrir e selecione Abrir....
3	Clique em ABRIR.

O projeto é aberto usando a instância de dados que você selecionou.

Substituindo o status da instância

Bloqueando uma instância de dados

Às vezes, uma instância que é considerada válida ainda pode conter um problema. Neste caso, é possível bloqueá-la para garantir que ela será desativada e que os usuários finais não poderão mais acessá-la.

Siga estes passos para reverter um cache ativo.

Etapa	Ação
1	Vá para a aba de dados Liberados do Superadmin.
2	Clique com o botão direito do mouse na instância de dados na qual o problema foi detectado e selecione Marcar como bloqueada. (opcional: selecione os módulos a serem usados, consulte 'a caixa de diálogo Selecionar Instâncias')
3	Clique em OK. (2x)

A instância de dados ativa foi marcada como bloqueada. A instância de dados ativa atualmente é a última instância de dados que foi válida.

Marcando uma instância de dados como corrigida.

Quando um problema com uma instância de dados bloqueada ou com falha não for realmente um problema, é possível marcá-la como corrigida e reativá-la.

Siga estes passos para marcar uma instância de dados como corrigida.

Etapa	Ação
1	Vá para a aba de dados Liberados do Superadmin.
2	Clique com o botão direito do mouse na instância de dados que foi corrigida e selecione Marcar como corrigida. (opcional: Selecione os módulos para usar, veja 'a caixa de diálogo Selecionar Instâncias')
3	Clique em OK. (2x)

A instância de dados ativa foi marcada como válida e a instância de dados ativa atualmente será definida como a instância de dados válida mais recente.

A caixa de diálogo para Selecionar Instâncias

Ao usar o menu de contexto (clicando com o botão direito do mouse em uma instância) na aba Dados liberados, cada uma das opções abre uma caixa de diálogo chamada Selecionar Instâncias. Veja a ilustração abaixo.

Nesta caixa de diálogo, você tem a opção de selecionar os módulos em que a operação selecionada é aplicada. Algumas ações, como Abrir, exigem que uma única instância seja selecionada, enquanto outras podem ser realizadas com várias selecionadas, como Mostrar Logs. Dependendo de onde você clica com o botão direito do mouse na grade, módulos diferentes serão inicialmente selecionados na caixa de diálogo Selecionar Instâncias.

Siga estes passos para selecionar módulos específicos para a ação atual que você está executando.

Etapa	Ação
1	Vá para a aba de dados Liberados do Superadmin.
2	Clique com o botão direito do mouse na instância de dados e selecione qualquer uma das opções.
3	Clique em SELECIONAR MÓDULOS.
4	Selecione os módulos que você deseja usar.
5	Clique em OK.

Os módulos que você selecionou são indicados na caixa de diálogo Selecionar Instâncias.

Reverter configurações

As instâncias mais antigas serão excluídas automaticamente quando novas forem criadas. Por padrão, apenas a última instância de dados com um erro e as duas últimas instâncias de dados válidas serão mantidas disponíveis.

É possível aumentar esses números para o que melhor se adequar às suas necessidades. Além disso, quando uma instância válida for criada, todas as instâncias inválidas com idade maior que uma semana serão excluídas.

Siga estes passos para adaptar as configurações de reversão.

Etapa	Ação
1	Vá para a aba Configurações de Superadmin.
2	No campo Configurações do Servidor, defina KeepInstancesError como o número de instâncias de erro que você deseja manter (por exemplo, “KeepInstancesError”: 2).
3	No campo Configurações do Servidor , defina KeepInstancesOk como o número de instâncias válidas que você deseja manter (por exemplo “KeepInstancesOk”: 6)
4	Clique em SALVAR.

A quantidade mantida de instâncias de dados válidas e instâncias com erro é atualizada para as configurações que foram escolhidas. A próxima vez que uma instância for gerada, essas novas configurações serão usadas para excluir instâncias antigas.

E-mails de falha automatizados

É possível receber e-mails quando sua geração de cache falhar.

Siga estes passos para configurar e-mails de falha automatizados.

Etapa	Ação
1	Vá para a aba Configurações de Superadmin.
2	No campo Configurações do Servidor , defina SendMailReportTo como o e-mail no qual você deseja receber e-mails sobre falhas. (por exemplo "SendMailReportTo": "[email]"). (Opcional) No campo de configurações do servidor, defina SendMailReportId como uma string que identifica seu servidor. Isso será adicionado na linha de assunto do e-mail. (por exemplo "SendMailReportId": "[id]").
3	Clique em SALVAR.

Em caso de falha, um e-mail será enviado para o e-mail que foi definido em SendMailReportTo, com SendMailReportId na linha de assunto.

Exportando conjuntos de dados para desenvolvedores

Você pode exportar os dados contidos em uma instância como um conjunto de dados de desenvolvimento. Os desenvolvedores podem usar esses conjuntos de dados para não precisar adquirir dados (por exemplo, executando consultas) eles próprios.

Siga estes passos para exportar um conjunto de dados para desenvolvimento.

Etapa	Ação
1	Vá para a aba de dados Liberados do Superadmin.
2	Clique com o botão direito do mouse na instância de dados que você deseja exportar e selecione Exportar dados para desenvolvimento.... (opcional: selecione os módulos a serem usados, consulte 'a caixa de diálogo Selecionar Instâncias')
3	Clique em OK.
4	Insira um nome para o conjunto de dados exportado e clique em OK.

O conjunto de dados exportado é adicionado para os conjuntos de dados na aba Dados de desenvolvimento.

Informações relacionadas

Para uma melhor explicação sobre vários ambientes, consulte: Ambientes.