Exportando grades em segundo plano

Como a exportação da grade de fundo funciona no Orchestrator e como usar dados exportados para painéis e relatórios.

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 para download é .csv, o que o torna compatível com a 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

Observação:

Os logs de auditoria, transações de fila, logs e trabalhos são limitados a 100 exportações por dia por tenant. Depois que esse limite for excedido, um erro #4502 será exibido, afirmando que o limite diário por tenant foi atingido. O limite é redefinido às 00:00 UTC.

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 mais antigas que 168 horas são excluídas permanentemente. Por exemplo, uma exportação criada no 1º dia às 00:00 fica disponível até o 7º dia às 23:59.

Para ver suas exportações, selecione o botão de reticências verticais (⋮) ao lado do tenant e escolha Meus relatórios na lista.

Figura 1. Meus Relatórios

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

• Tipo de exportação - refere-se ao Object do Orchestrator
• Criado em - o carimbo de data/hora 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 será removida da lista. Os relatórios são removidos às 00:00 na data especificada. Isso só é exibido após o relatório ser exportado.
• Tamanho: o tamanho da exportação. Isso só é exibido após o relatório ser exportado.
• Status - o status da operação de exportação:
  • Novo - a exportação está em andamento.
  • Concluído - a exportação terminou.
  • Falhou: a exportação falhou. Isso pode ser causado por tempo limite de SQL ou por baixo espaço de armazenamento. Você precisa tentar exportar novamente manualmente. O tempo de computação para resolver a exportação é de no máximo 15 minutos. Após esse período, a exportação falha. Antes de tentar exportar novamente, aplique filtros adicionais aos seus dados.
    Importante:

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

    • Você deve usar os pontos de extremidade da API para o Object do 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 seu dispositivo, clique no botão Download para o relatório desejado. Essa operação usa o local de download padrão em seu dispositivo.Você baixa o relatório como um arquivo, que contém o arquivo .csv dos dados filtrados da grade.

Observação:

Para baixar exportações para seu dispositivo, você precisa adicionar os domínios de armazenamento à sua lista de permissões. Mais informações aqui.

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 (`\ / : * ? " < >
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.

Campos compatíveis com exportações de APIs de transações da fila

A tabela a seguir lista os campos que estão disponíveis no relatório gerado pela exportação das transações de fila por meio de API e indica se esses campos são permitidos para filtragem.

Campo de API	Coluna correspondente no relatório exportado	Permite filtragem
QueueDefinitionId	N/A	✅
Status	Status	✅
ReviewStatus	Revisão	✅
Reference	Referência	✅
ProcessingExceptionType	Exceção	✅
DueDate	N/A	❌
DueDateAbs	Prazo (absoluto)	❌
Priority	Prioridade	✅
RobotName	Robot	❌
DeferDate	N/A	❌
DeferDateAbs	Adiar (absoluto)	❌
StartProcessing	N/A	✅
StartProcessingAbs	Iniciado (absoluto)	❌
EndProcessing	N/A	✅
EndProcessingAbs	Encerrado (absoluto)	❌
SecondsInPreviousAttempts	Tempo de Execução da Transação	❌
AncestorId	AncestorId	❌
AncestorUniqueKey	AncestorUniqueKey	❌
RetryNumber	N° da Repetição	❌
ManualAncestorId	AncestorId manual	❌
ManualAncestorUniqueKey	AncestorUniqueKey manual	❌
ManualRetryNumber	Nova tentativa manual nº	❌
UniqueKey	UniqueKey	❌
SpecificData	Dados específicos	❌
Key	Chave	❌
ReviewerName	Nome do Revisor	❌
ProcessingExceptionReason	Motivo da Exceção	❌
Output	Saída	❌
RobotId	N/A	✅
ReviewerUserId	N/A	✅
Analytics	Dados de Análise	❌
CreationTime	N/A	✅
CreationTimeAbs	Criado (absoluto)	❌
Progress	Progresso	❌
Id	Id	✅

Campos compatíveis para exportações de API de logs de auditoria

A tabela a seguir lista os campos que estão disponíveis no relatório gerado pela exportação de logs de auditoria por meio de API e indica se esses campos são permitidos para filtragem.

Campo de API	Coluna correspondente no relatório exportado	Permite filtragem
Parameter	N/A	✅
DisplayName	N/A	✅
Action	Ação	✅
Component	Component	✅
UserId	N/A	✅
ExecutionTime	N/A	✅
OperationText	Operação	❌
ExecutionTimeAbs	Tempo (absoluto)	❌
ServiceName	N/A	❌
MethodName	N/A	❌
EntityId	N/A	❌
UserType	N/A	❌
UserIsDeleted	N/A	❌
ExternalClientId	N/A	❌
UserName	Usuário	❌

Campos compatíveis com exportações de API de logs do UiPath Robot

A tabela a seguir lista os campos disponíveis no relatório gerado pela exportação de logs do UiPath Robot por meio da API e indica se esses campos têm permissão para filtragem.

Campo de API	Coluna correspondente no relatório exportado	Permite filtragem
JobKey	N/A	✅
TimeStamp	Tempo (absoluto)	✅
Level	Nível	✅
ProcessName	Processo	✅
HostMachineName	Hostname	✅
WindowsIdentity	Identidade do host	✅
Message	Mensagem	✅
RawMessage	N/A	❌
RobotName	Nome do Robô	✅
MachineId	N/A	❌
MachineKey	N/A	✅
RuntimeType	N/A	❌

Campos compatíveis com exportações de API de trabalhos

Campo de API	Coluna correspondente no relatório exportado	Permite filtragem
CreationTime	N/A	✅
SourceType	N/A	✅
State	Estado	✅
SpecificPriorityValue	Prioridade	✅
HostMachineName	Hostname	✅
LocalSystemAccount	Identidade do host	✅
MachineName	Máquina	❌
Key	Chave	❌
JobPriority	N/A	❌
ReleaseName	Processo	❌
RobotName	Robot	❌
MachineScope	N/A	❌
EnvironmentName	Ambiente	❌
Type	Tipo de trabalho	❌
RuntimeType	Tipo/licença de runtime	❌
StartTime	N/A	✅
StartTimeAbs	Iniciado (absoluto)	❌
EndTime	N/A	✅
EndTimeAbs	Encerrado (absoluto)	❌
ProcessType	N/A	❌
Source	Origem	❌
CreationTimeAbs	Criado (absoluto)	❌
ServerlessJobType	N/A	❌
StartingScheduleId	N/A	✅
Release	N/A	❌
Machine	N/A	❌
Robot	N/A	❌