Skip to main content

Fontes de dados de execuções de relatórios e scripts

Dentre todas as fontes de dados existentes, a ferramenta de Scripts conta com quatro delas destinadas às execuções dos artefatos, sejam eles de relatórios ou scripts. Essas fontes estão disponíveis no explorador de fonte de dados, dentro do grupo Fontes de dados da Plataforma para Dados de Execuções.

fontes-dados

Cada uma das fontes possui sua função específica, sendo:

  • execucoes.busca: busca todas as execuções passando alguns filtros;
  • execuções.movimentacoes: retorna as movimentaçẽos de uma execução dado um protocolo de execução;
  • execucoes.propriedades: retorna as propriedades de uma execução dado um protocolo de execução;
  • parametros.busca: busca as execuções a partir dos dados de seus parâmetros.

Consulta execuções

É uma fonte que consulta as execuções de scripts e relatórios, permitindo visualizar algumas propriedades, como: dados do agendamento, usuário, status, mensagens de inconsistência, endereço dos arquivos gerados e no caso de relatórios, endereços dos arquivos assinados digitalmente.

A fonte disponibiliza uma série de campos para visualização, ordenação e filtros, que estão dispostas nas abas de mesmo nome.

Exemplificando: execução de integração com outro sistema, onde seja necessário enviar os relatórios assinados digitalmente dentro de um período. Essa fonte lhe fornecerá os endereços dos relatórios e demais funcionalidades do script que lhe proverão o restante.

No exemplo abaixo é exibido um script utilizando a fonte mencionada:

fontes-dados

Consulta de propriedades de execução

Essa é uma fonte de dados que retorna as propriedades de uma execução, como o formato de exportação do arquivo gerado. Nessa consulta é obrigatório informar o código do protocolo, sendo esse o único filtro disponível.

Exemplificando: determinar o formato de exportação de um determinado arquivo ou se o mesmo foi enviado por e-mail.

No código abaixo é demonstrado um exemplo de uso:

fontes-dados

Consulta de movimentações de execução

Essa fonte é semelhante a fonte de consulta de propriedades de execução, porém exibe informações relacionadas aos passos de execução do artefato, bem como métricas de tempo de execução em cada um.

Exemplificando: determinar o tempo que uma execução levou para ocorrer, desde o momento que foi requisitado até ser finalizado.

No código abaixo é demonstrado um exemplo de uso:

fontes-dados

Consulta de execuções por parâmetros

Essa fonte é semelhante à fonte de consulta de execuções, porém o retorno das execuções se dará a partir dos parâmetros usados para execução da mesma.

A fonte disponibiliza uma série de campos para visualização, ordenação e filtros, que estão dispostas nas abas de mesmo nome.

Exemplificando: determinar as execuções onde fora fornecido um valor para um parâmetro e o valor seja igual ao desejado.

No código abaixo é demonstrado um exemplo de uso:

fontes-dados