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.

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)

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

Fields supported for robot logs API exports

The following table lists the fields that are available in the report generated by exporting robot logs via API, and indicates whether these fields are allowed for filtering.

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	Host Identity
Message	Mensagem
RawMessage	N/A
RobotName	Nome do Robô
MachineId	N/A
MachineKey	N/A
RuntimeType	N/A

Fields supported for jobs API exports

Campo de API	Coluna correspondente no relatório exportado	Permite filtragem
CreationTime	N/A
SourceType	N/A
State	Estado
SpecificPriorityValue	Prioridade
HostMachineName	Hostname
LocalSystemAccount	Host Identity
MachineName	Máquina
Key	Chave
JobPriority	N/A
ReleaseName	Processo
RobotName	Robô
MachineScope	N/A
EnvironmentName	Ambiente
Type	Tipo de trabalho
RuntimeType	Runtime type/license
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

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.