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.

The download format is .csv, which makes it data-analysis compliant, and you can access it from the My Reports page.

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

• Export type - refers to the Orchestrator object
• Created on - the relative timestamp of when you created the export
• 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 - the status of the export operation:
  • New - the export is in progress.
  • Completed - the export finished.
  • 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:

    • You must use the API endpoints for the corresponding Orchestrator object. For example, use /odata/AuditLogs/UiPath.Server.Configuration.OData.Export to export Audit logs.
    • 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.

To download the data to your device, click the Download button for the desired report. This operation uses the default download location on your device. The report is downloaded as an archive, which contains the .csv file of the grid filtered data.

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	❌

Exportar alertas

All exports you create are logged on the Alerts page, provided you have the proper permissions. Completed exports are logged with the Info severity, while failed exports are logged with the Error severity.

By default, you receive alert emails about completed or failed exports. You can unsubscribe from these alerts by navigating to the Alert Preferences page and unselecting the Export option.