- OpenAPI
- Introdução à API do Automation Hub
- Referências de API
- Gerar seu token do Automation Hub
- Autenticação para o seu tenant do Automation Hub
- Recuperar ideia de automação na fase Ideia com status Esperando Revisão
- Recuperar a análise de custo-benefício para uma ideia específica
- Atualizar a fase e o status da ideia de automação
- Recuperar uma conta de usuário
- Atualizar detalhes de conta para funcionários a partir do Automation Hub
- Desativar contas de usuários que não fazem parte da empresa
- Entrada para o pipeline de automação
- Entrada para o tipo de envio
- Entrada para a fase
- Entrada para o status
- Entrada para a atualização de fase e status
- Entrada para a unidade de negócios
- Entrada para aplicativos
- Entrada para a categoria
- Entrada para a análise de custo-benefício
- Entrada para a Avaliação Geral
- Entrada para a Avaliação Detalhada
- Entrada para o data de criação da ideia de automação
- Entrada para usuários
- Entrada para o status do usuário
- Tabela de status do usuário
- Entrada para colaboradores
- Dicionário de saída
- Análise de dados da Open API do Automation Hub com Power Query
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.
Use as etapas a seguir para configurar a consulta principal:
- Acesse o Power BI ou Excel e pressione Obter dados; em seguida, selecione Da web.
- Na nova janela, pressione Avançado.
- Aqui, você precisa adicionar os dados da Open API correspondentes para a conexão.
- Comece adicionando o endpoint (por exemplo, Pipeline de Automação GET).
- Então, os cabeçalhos
- Nos cabeçalhos, adicione o token de autenticação.
- Certifique-se de adicionar a palavra Bearer antes de inserir o valor do token.
- 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:
- Expanda o objeto de dados.
- Em seguida, expanda o objeto do processo.
- Agora, você pode converter os dados para uma tabela, que resultará em uma única coluna com todos os registros.
- 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.
- Depois de fazer a expansão, certifique-se de marcar todas as colunas, porque algumas delas têm registros aninhados que você precisa expandir.
- Passe por cada coluna até ter certeza de que os dados estejam ok. Você também pode formatar algumas das colunas como desejar.
- Se seus dados estiverem bons, pressione Salvar e fechar e espere até que os dados sejam carregados.
- Agora, você pode começar a criar seu painel/relatório.
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:
- Aprofunde-se no campo totalPages.
- Clique no botão Função, e sua fórmula deve ser alterada para =totalPages.
- Insira a seguinte fórmula
=List.Numbers(1,totalPages,1)
. - 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:
- Transforme a lista em uma tabela.
- Renomeie a coluna para Página e altere o tipo de dados para Texto.
- Crie uma coluna personalizada.
- 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
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.
A análise de aplicativos (delimitada por vírgula) é feita seguindo as etapas a seguir:
- No editor de consulta, acesse a coluna em que estão seus aplicativos e pressione para expandir para novas linhas.
- Pressione novamente expandir e selecione os metadados do aplicativo que você deseja extrair como o nome do aplicativo.
- Na aba/faixa de opções da Página Inicial, clique em Agrupar por.
-
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).
- Depois de pressionar ok, você receberá um erro, pois a função de soma não pode funcionar com entradas de texto.
- Acesse a barra da fórmula e substitua List.Sum por Text.Combine como funções
-
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
- Pressione salvar e dê uma olhada nas entradas da coluna:
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 |
---|---|
|
|
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:
-
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]
- Expanda novamente para obter os campos de pergunta.
-
Expanda novamente e obtenha os seguintes campos.
- Question_text
- Answer_text
- Question_response_answers
- Expanda Question_response_answers e extraia response_choice_text.
- 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:
- Marque e remova qualquer entrada nula da coluna Question.
- Use uma coluna pivô para transpor todos os dados atuais das colunas Question e Answer em linhas.
- Selecione a coluna Question e clique na coluna Pivot do menu Transformar.
- Selecione a coluna de resposta como sua coluna de valores
- 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.
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.
Abaixo, você verá uma demonstração em vídeo das etapas descritas neste artigo.
Neste vídeo:
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
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.
- Como configurar a consulta principal (para o Pipeline de Automação GET)
- Como usar a paginação para obter dinamicamente todos os itens de qualquer solicitação da Open API
- Como analisar uma consulta diferente (automações GET) para extrair os campos Descrição e Aplicativo
- Análise de descrição (delimitada por parágrafo)
- Como analisar uma consulta diferente (automações GET) para extrair Perguntas personalizadas ou Perguntas de avaliação de alto nível
- Como mesclar consultas (de automações GET) para sua consulta principal (Pipeline de Automação GET)
- Demonstração do poder de análise de consultas da API do Automation Hub