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

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 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.

Figura 1. Meus Relatórios

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.

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

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	Robô
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	Robô
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