Análise de dados da Open API do Automation Hub com Power Query

A análise dos dados da API do Automation Hub pode ser às vezes desafiante, especialmente se você estiver consolidando um relatório bastante complexo.

Nesta página, apresentamos algumas dicas e truques que podem ser usados para melhorar o processo de análise de dados geral. A página contém:

• As etapas com referências à documentação da Open API e do Power Query.
• Um arquivo de amostra no qual você pode exercitar as etapas diretamente no Power Query.

Como configurar a consulta principal (para o Pipeline de Automação GET)

Use as etapas a seguir para configurar a consulta principal:

1. Acesse o Power BI ou Excel e pressione Obter dados; em seguida, selecione Da web.
2. Na nova janela, pressione Avançado.
3. Aqui, você precisa adicionar os dados da Open API correspondentes para a conexão.
4. Comece adicionando o endpoint (por exemplo, Pipeline de Automação GET).
5. Então, os cabeçalhos
6. Nos cabeçalhos, adicione o token de autenticação.
7. Certifique-se de adicionar a palavra Bearer antes de inserir o valor do token.
8. Pressione Conectar.

Agora, você deve obter a resposta JSON da Open API no Power BI. Além disso, você precisa investigar os dados antes de salvar a tabela; faça isso seguindo as etapas a seguir:

1. Expanda o objeto de dados.
2. Em seguida, expanda o objeto do processo.
3. Agora, você pode converter os dados para uma tabela, que resultará em uma única coluna com todos os registros.
4. Expanda essa coluna para obter todos os registros disponíveis no arquivo JSON — você pode optar por obter todos os registros ou apenas parte deles.
5. Depois de fazer a expansão, certifique-se de marcar todas as colunas, porque algumas delas têm registros aninhados que você precisa expandir.
6. Passe por cada coluna até ter certeza de que os dados estejam ok. Você também pode formatar algumas das colunas como desejar.
7. Se seus dados estiverem bons, pressione Salvar e fechar e espere até que os dados sejam carregados.
8. Agora, você pode começar a criar seu painel/relatório.

Como usar a paginação para obter dinamicamente todos os itens de qualquer solicitação da Open API

Comece com uma consulta simples em que você não use nenhum parâmetro limite e, por padrão, você receberá uma resposta com o número padrão de itens (20). Depois disso, prossiga com as etapas abaixo:

1. Aprofunde-se no campo totalPages.
2. Clique no botão Função, e sua fórmula deve ser alterada para =totalPages.
3. Insira a seguinte fórmula =List.Numbers(1,totalPages,1).
4. Uma lista será gerada com todos os números de página disponíveis na resposta da API.

Essa lista é dinâmica e baseada no número de páginas obtidas da resposta. Sendo assim, se você atualizar a consulta da API e houver novos dados (uma nova página), ela será automaticamente colocada na lista. Continue seguindo as etapas a seguir:

1. Transforme a lista em uma tabela.
2. Renomeie a coluna para Página e altere o tipo de dados para Texto.
3. Crie uma coluna personalizada.
4. Na fórmula da coluna, adicione a seguinte consulta:

let Source = Json.Document(Web.Contents(" https://{yourDomain}/automationhub_/api/v1/openapi/automationpipeline?pre=all&page="&[Page], [Headers=[#"Content-Type"="application/json", #"x-ah-openapi-app-key"="test", #"x-ah-openapi-auth"="openapi-token", Authorization="Bearer xxxxxx"]])), data = Source[data], processes = data[processes] in processes

A consulta acima obtém os dados do Pipeline de automação e usa o parâmetro Página (que recebemos dinamicamente na lista) para obter o conteúdo para todas as páginas disponíveis. 5. Clique em OK e expanda a coluna. Agora, você tem todos os itens disponíveis da resposta, independentemente de quantas páginas a API retornar.

Como analisar uma consulta diferente (automações GET) para extrair os campos Descrição e Aplicativo

A análise de aplicativos (delimitada por vírgula) é feita seguindo as etapas a seguir:

1. No editor de consulta, acesse a coluna em que estão seus aplicativos e pressione para expandir para novas linhas.
2. Pressione novamente expandir e selecione os metadados do aplicativo que você deseja extrair como o nome do aplicativo.
3. Na aba/faixa de opções da Página Inicial, clique em Agrupar por.

4. Na grupo por janela, selecione:

   • Agrupamento a ser feito pela coluna ID do processo, pois o ID é exclusivo.
   • O novo nome da coluna deve ser algo como “aplicativos agregados”.
   • Operação: soma
   • Coluna: a coluna que você expandiu para os aplicativos (no exemplo acima, é Column.1applications.applications_name).
5. Depois de pressionar ok, você receberá um erro, pois a função de soma não pode funcionar com entradas de texto.
6. Acesse a barra da fórmula e substitua List.Sum por Text.Combine como funções

7. Além disso, ainda na fórmula, após o nome da coluna de aplicativos, adicione um delimitador para suas entradas de texto; por exemplo ", "

   É assim que a fórmula fica antes e depois da alteração:

   Antes da alteração	Após a alteração
   = Table.Group(#"Expanded Column1.applications1", {"Column1.process_id	= Table.Group(#"Expanded Column1.applications1", {"Column1.process_id

8. Pressione salvar e dê uma olhada nas entradas da coluna:

Análise de descrição (delimitada por parágrafo)

As mesmas etapas que para a descrição, mas, como a descrição é um campo de texto em que precisamos separar os diferentes parágrafos, usaremos um separador diferente na fórmula “#(lf)”.

Antes da alteração	Após a alteração
= Table.ExpandRecordColumn(#"Expanded Column1.process_description.blocks", "Column1.process_description.blocks", {"text	= Table.Group(#"Expanded Column1.process_description.blocks1", {"Column1.process_id

Como analisar uma consulta diferente (automações GET) para extrair Perguntas personalizadas ou Perguntas de avaliação de alto nível

Comece a partir de uma nova consulta para automações GET (você pode usar aquela com a paginação demonstrada acima) e siga as etapas abaixo:

1. Expanda as seguintes colunas:

   • ID do Processo
   • Filtro_avançado [Advanced_Information] ou High Level Assessment (ambas funcionam da mesma forma, mas para este tutorial, trabalharemos com a de filtro_avançado [advanced_information]
2. Expanda novamente para obter os campos de pergunta.

3. Expanda novamente e obtenha os seguintes campos.

   • Question_text
   • Answer_text
   • Question_response_answers
4. Expanda Question_response_answers e extraia response_choice_text.
5. Combine as colunas Answer Text e Response_choice_text em uma única coluna usando a fórmula

if [AnswerText] is null then [AnswerChoice.response_choice_text] else [AnswerText].

Isso sempre é aplicável, pois você pode ter ou uma resposta de texto, ou uma escolha de resposta (nunca ambos). Continue o processo seguindo as etapas abaixo:

1. Marque e remova qualquer entrada nula da coluna Question.
2. Use uma coluna pivô para transpor todos os dados atuais das colunas Question e Answer em linhas.
3. Selecione a coluna Question e clique na coluna Pivot do menu Transformar.
4. Selecione a coluna de resposta como sua coluna de valores
5. Selecione Não agregar como uma Função de valor agregado e clique em OK.

Agora, todas as ideias têm uma coluna correspondente que representa as perguntas personalizadas e seus valores correspondentes.

Como mesclar consultas (de automações GET) para sua consulta principal (Pipeline de Automação GET)

Para mesclar duas consultas diferentes no Power BI, veja como isso geralmente é feito no Power Query. Depois disso, você pode começar com a consulta do Pipeline da Automação e mesclá-la com a consulta de Automações GET.

• Dessa forma, você expandirá as colunas disponíveis do Pipeline de Automação GET com aquelas de Automações GET.
• Você precisa usar o ID do processo para mesclar as consultas, pois ele é o identificador exclusivo e a chave comum entre todas as consultas.

Demonstração do poder de análise de consultas da API do Automation Hub

Abaixo, você verá uma demonstração em vídeo das etapas descritas neste artigo.

Neste vídeo:

00:00 - Como configurar a consulta principal (para GET Automation Pipeline)

03:27 - Como usar a paginação para obter dinamicamente todos os itens de qualquer solicitação da Open API

07:18 - Como analisar uma consulta diferente (GET Automations) para extrair os campos Descrição e Aplicativo

14:16 - Como analisar uma consulta diferente (GET Automations) para extrair Perguntas personalizadas ou Perguntas de avaliação de alto nível

26:35 - Como mesclar consultas (de GET Automations) para sua consulta principal (GET Automation Pipeline)

O arquivo de amostra usado no vídeo pode ser baixado daqui.