Exportando grades em segundo plano

Visão geral

Os objetos do Orchestrator são exibidos em sua página dedicada, em uma grade com várias colunas que são úteis para descrever o status desse objeto.

Você pode exportar essas grades para obter um lote de dados que pode usar posteriormente para criar painéis ou relatórios. A operação de exportação ocorre em segundo plano, o que significa que você pode continuar interagindo com o Orchestrator sem precisar esperar a exportação terminar, pois uma notificação informa quando o download está pronto.

O formato de download é .csv, o que o torna compatível com análise de dados, e você pode acessá-lo na página Meus relatórios .

Objetos do Orchestrator disponíveis para exportação

Você pode exportar as grades dos seguintes objetos do orquestrador:

• No nível do tenant
  • Logs de Auditoria
  • Logs de auditoria de automação de teste
• No nível da pasta
  • Transações em fila
  • Logs
  • Trabalhos

O relatório exportado

Clicar no botão Exportar cria uma cópia da grade na página Meus relatórios. Um pop-up informa quando a exportação começa e se ela é concluída e quando.

Após a conclusão da exportação, você recebe um alerta informando que os dados foram exportados. O relatório é baixado automaticamente em segundo plano, para o local de download padrão do seu navegador, se você tiver a permissão Exibir em Alertas. No entanto, você também pode acessar a página Meus relatórios e baixar o relatório conforme sua própria conveniência.

A página Meus relatórios exibe apenas as exportações que você criou nas últimas 168 horas (7 dias x 24 horas). As exportações com mais de 168 horas são excluídas permanentemente. Por exemplo, uma exportação criada no dia 1 às 00:00 estará disponível até o dia 7 às 23:59.

Para ver suas exportações, clique no ícone Meus relatórios na barra de navegação superior.

Você pode ver as seguintes propriedades de uma exportação:

• Tipo de exportação - refere-se ao objeto Orchestrator
• Criado em - o timestamp relativo de quando você criou a exportação
• Criado em (absoluto) - o carimbo de data/hora exato de quando você criou a exportação. Os carimbos de data/hora absolutos são renderizados no fuso horário do tenant. Para gatilhos, o próximo tempo de execução é renderizado no fuso horário do gatilho, que pode ser diferente daquele do tenant.
• Disponível até - a data em que a exportação deve ser removida da lista. Os relatórios são removidos às 00:00 da data especificada.

  Isso só é exibido quando o relatório tem sido exportado.

• Tamanho - o tamanho da exportação. Isso só é exibido quando o relatório tem sido exportado.

• Status - o status da operação de exportação:

  • Novo - a exportação está em andamento.
  • Concluído - a exportação foi concluída.

  • Falha - a exportação falhou. Isso pode ser gerado pelo tempo limite do SQL ou pelo armazenamento insuficiente. Você precisa repetir manualmente a exportação.

    O tempo de computação para resolver a exportação é de no máximo 15 minutos. Após este tempo, a exportação falha. Antes de tentar novamente a exportação, aplique filtros adicionais aos seus dados.

    Importante:

    Para evitar a falha de exportações com uma grande quantidade de dados:

    • Você deve usar os endpoints da API para o objeto Orchestrator correspondente. Por exemplo, use /odata/AuditLogs/UiPath.Server.Configuration.OData.Export para exportar logs de auditoria.

    • O volume de exportações geradas, em termos de frequência e quantidade de dados recuperados, pode afetar o desempenho de seu tenant. Se o desempenho for afetado, podemos limitar ou bloquear tais solicitações para garantir que suas automações não sejam afetadas por esse comportamento.

    • Aplique filtros para reduzir a quantidade de dados exportados.

Para baixar os dados para o seu dispositivo, clique no botão Download do relatório desejado. Esta operação usa o local de download padrão em seu dispositivo. O relatório é baixado como um arquivo, que contém o arquivo .csv dos dados filtrados da grade.

Os arquivos .zip e .csv são nomeados usando as seguintes convenções de nomenclatura:

Tipo de objeto exportado	Baixe a convenção de nomenclatura de arquivo
Transações em fila	{queue-name}-items-{export-date}-{export-timestamp}-{export-id} Se o nome da fila contiver caracteres inválidos (\ / : * ? " < > |), eles serão substituídos por _.
Logs de Auditoria	audit-logs-{export-date}-{export-timestamp}-{export-id}
Logs	robot-logs-{export-date}-{export-timestamp}-{export-id}
Trabalhos	jobs-{job_folder_key}-{export-date}-{export-timestamp}-{export-id}

Onde:

• {queue_name} - o nome da fila que contém os itens da fila exportados

• {job_folder_key} - o ID da pasta da qual a grade de trabalho foi exportada

• {export_date} - a data em que a exportação foi criada, no formato yyyy-MM-dd
• {export_timestamp} - a hora em que a exportação foi criada, no formato HH-mm-ss-fff
• {export-id} - o ID da exportação

Por exemplo, um arquivo de download de exportação para uma grade de logs de auditoria pode ser denominado audit-logs-2023-01-27-12-29-40-843-24.zip.

Importante:

As colunas de tempo nos relatórios exportados são expressas no fuso horário do tenant.

Considerações importantes sobre exportações de API

• As palavras-chave $select, $top, $skip, $orderBy, and $count, em nossa API de exportação não são compatíveis e recomendamos fortemente que você evite usá-las. Em vez disso, use filtros apropriados.
• As entradas do relatório são classificadas apenas por Id, ou seja, $orderBy=Id. Quaisquer outros parâmetros usados para a palavra-chave $orderBy são ignorados.
• A filtragem por meio de uma estrutura $filter= permite apenas os campos marcados como disponíveis na tabela.

• O uso de qualquer um dos campos não compatíveis, conforme descrito nas seguintes tabelas, retorna um erro 400.

Exportar alertas

Todas as exportações que você cria são registradas na página Alertas , desde que você tenha as permissões apropriadas. As exportações concluídas são registradas com a gravidade Info , enquanto as exportações com falha são registradas com a gravidade Error .

Por padrão, você recebe e-mails de alerta sobre exportações concluídas ou com falha. Você pode cancelar a assinatura desses alertas navegando até a página Preferências de alerta e desmarcando a opção Exportar .

Leia mais sobre Alertas.