orchestrator
latest
false
UiPath logo, featuring letters U and I in white
Guia do usuário do Orchestrator
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 20 de nov de 2024

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.



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

available

Status

Status

available

ReviewStatus

Revisão

available

Reference

Referência

available

ProcessingExceptionType

Exceção

available

DueDate

N/A

Não disponível

DueDateAbs

Prazo (absoluto)

Não disponível

Priority

Prioridade

available

RobotName

Robô

Não disponível

DeferDate

N/A

Não disponível

DeferDateAbs

Adiar (absoluto)

Não disponível

StartProcessing

N/A

available

StartProcessingAbs

Iniciado (absoluto)

Não disponível

EndProcessing

N/A

available

EndProcessingAbs

Encerrado (absoluto)

Não disponível

SecondsInPreviousAttempts

Tempo de Execução da Transação

Não disponível

AncestorId

AncestorId

Não disponível

AncestorUniqueKey

AncestorUniqueKey

Não disponível

RetryNumber

N° da Repetição

Não disponível

ManualAncestorId

AncestorId manual

Não disponível

ManualAncestorUniqueKey

AncestorUniqueKey manual

Não disponível

ManualRetryNumber

Nova tentativa manual nº

Não disponível

UniqueKey

UniqueKey

Não disponível

SpecificData

Dados específicos

Não disponível

Key

Chave

Não disponível

ReviewerName

Nome do Revisor

Não disponível

ProcessingExceptionReason

Motivo da Exceção

Não disponível

Output

Saída

Não disponível

RobotId

N/A

available

ReviewerUserId

N/A

available

Analytics

Dados de Análise

Não disponível

CreationTime

N/A

available

CreationTimeAbs

Criado (absoluto)

Não disponível

ProgressProgresso

Não disponível

Id

Id

available

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

available

DisplayName

N/A

available

Action

Ação

available

Component

Component

available

UserId

N/A

available

ExecutionTime

N/A

available

OperationText

Operação

Não disponível

ExecutionTimeAbs

Tempo (absoluto)

Não disponível

ServiceName

N/A

Não disponível

MethodName

N/A

Não disponível

EntityId

N/A

Não disponível

UserType

N/A

Não disponível

UserIsDeleted

N/A

Não disponível

ExternalClientId

N/A

Não disponível

UserName

Usuário

Não disponível

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

available

TimeStamp

Tempo (absoluto)

available

Level

Nível

available

ProcessName

Processo

available

HostMachineName

Hostname

available

WindowsIdentity

Identidade do host

available

Message

Mensagem

available

RawMessage

N/A

Não disponível

RobotName

Nome do Robô

available

MachineId

N/A

Não disponível

MachineKey

N/A

available

RuntimeType

N/A

Não disponível

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

Campo de API

Coluna correspondente no relatório exportado

Permite filtragem

CreationTime

N/A

available

SourceType

N/A

available

State

Estado

available

SpecificPriorityValue

Prioridade

available

HostMachineName

Hostname

available

LocalSystemAccount

Identidade do host

available

MachineName

Máquina

Não disponível

Key

Chave

Não disponível

JobPriority

N/A

Não disponível

ReleaseName

Processo

Não disponível

RobotName

Robô

Não disponível

MachineScope

N/A

Não disponível

EnvironmentName

Ambiente

Não disponível

Type

Tipo de trabalho

Não disponível

RuntimeType

Tipo/licença de runtime

Não disponível

StartTime

N/A

available

StartTimeAbs

Iniciado (absoluto)

Não disponível

EndTime

N/A

available

EndTimeAbs

Encerrado (absoluto)

Não disponível

ProcessType

N/A

Não disponível

Source

Origem

Não disponível

CreationTimeAbs

Criado (absoluto)

Não disponível

ServerlessJobType

N/A

Não disponível

StartingScheduleId

N/A

available

Release

N/A

Não disponível

Machine

N/A

Não disponível

Robot

N/A

Não disponível

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 .

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.