Escolar Documentos
Profissional Documentos
Cultura Documentos
RELATÓRIOS CUSTOMIZADOS
Aqui você poderá compartilhar este ebook através das redes sociais, utilizando os ícones
interativos no canto superior esquerdo da página.
Ao clicar na opção IR PARA O ÍNDICE, você será direcionado para a página de sua prefe-
rência, proporcionando uma navegação interativa.
Quando o texto estiver assim, significa que foi transformado em Hiperlink. Ao clicá-lo,
você será direcionado para um site, um post ou algum material que irá complementar a
informação.
Eperamos que essas funções ajudem você a aproveitar melhor o nosso conteúdo! Tenha
uma ótima leitura!
Introdução 04
Definições de alguns termos que vamos usar neste tutorial 05
O que preciso para criar os relatórios customizados deste tutorial? 07
1º Coletar ou Extrair dados 10
2º Conectar a fonte de dados no Microsoft Excel? 21
3º Criando os relatórios e gráficos dinâmicos no excel 34
Sobre o Autor 43
Sobre o Sienge 44
Para gerenciar um negócio de forma assertiva é Mas fique tranquilo! Com este tutorial você não precisará
necessário ter informações claras e em tempo hábil ter nenhum conhecimento técnico sobre APIs. Vou te
para tomar decisões. ensinar tudo o que precisa para criar os relatórios e
gráficos dinâmicos mais incríveis da sua carreira sem a
Cada gestor tem sua forma peculiar de obter e analisar necessidade de ser um expert no assunto.
as informações e indicadores, por isso resolvemos criar
este tutorial explicando passo a passo de como você
pode criar relatórios totalmente customizáveis.
API: API é uma sigla inglesa “Application Bulk API: Existem alguns tipos de API,
Programming Interface”, que traduzido é as principais são REST API, que são
“Interface de programação de Aplicativo”, transacionais, e BULK API que é própria para
basicamente é um formato padronizado de um enorme volume de dados. Neste tutorial
comunicação entre sistemas para compartilhar iremos trabalhar com o exemplo de uma
e disponibilizar suas informações para várias BULK API, mas poderá aplicar este mesmo
finalidades, principalmente para integração procedimento em REST APIs também.
com outros sistemas ou até para exportar os
dados para criar Relatórios customizados, que JSON: É um formato de arquivo que são
é o nosso caso. Uma API pode disponibilizar apresentados os dados destas APIs, termo
várias operações para interagir com um inglês JavaScript Object Notation, que tem
recurso e os seus dados que estão no seu uma representação de dados exibindo entre
sistema. chaves e colchetes os títulos de campos e
seus valores como abaixo:
Endpoint: O Endpoint de uma API é
basicamente uma URL que define qual {
recurso (Ex.: Clientes) e qual operação vai “Nome”: “Yan Soares”,
utilizar para interagir com os dados (Ex.: “Idade”: “3”
Listar, Incluir, Alterar, Deletar). }
Para criar relatórios customizados seguiremos 3 macro • Dados de Dispositivos: São dados gerados por
etapas. Vou detalhar um pouco mais sobre elas para que dispositivos como Smartphones, Relógios, TVs e qualquer
você possa entender melhor o roteiro da nossa jornada. outro conectado à internet.
Uma vez com os dados coletados, precisamos entender as Sempre quando trabalhamos com gerenciamento e
suas estruturas e organizá-los nas planilhas para iniciar a tratamentos de dados é preciso entender, em detalhes,
criação dos nossos relatórios. as possíveis exposições de informações confidenciais ou
sensíveis para pessoas não autorizadas.
O entendimento destas estruturas é importante mesmo se
você já está trabalhando com estes dados diretamente no Principalmente quando trabalhamos com Dados
excel. Corporativos, que contém segredos industriais ou Dados
Pessoais e Dados Pessoais Sensíveis protegidos pela
LGPD.
Criar tabelas e gráficos dinâmicos
Neste tutorial, vamos trabalhar alguns mecanismos de
Nesta etapa do nosso projeto vamos utilizar os dados dados que precisam de oferecer credenciais de acesso
que coletamos de uma ou mais fontes e criar tabelas e como uma das possibilidade de coleta de dados, desta
gráficos dinâmicos no Excel. Podemos tornar os nossos forma, os arquivos não devem ser compartilhados com
dados atualizáveis com recursos nativos do próprio pessoas não autorizadas. Este compartilhamento dá acesso
excel. à informações e atualizações.
Agora vamos à prática com 3 passos para criar os É importante conversar com a equipe de TI da sua empresa
relatórios customizáveis com Business Intelligence. para analisar as políticas de privacidade, disponibilidade e
acessibilidade dos dados.
Autenticação
Para utilizar as APIs é necessário obter os dados de acesso, que é o Usuário e Senha de API, pois iremos utilizar para autorizar a
conexão com os seus dados.
Sub Domínio: No contexto que vamos utilizar este termo o sub domínio é o endereço do seu sistema no data center, como por
exemplo: construtora.sienge.com.br.
https://api.sienge.com.br/{subdomain-do-cliente}/public/api/bulk-data/v1
O termo {subdomain-do-cliente} da URL acima deve ser substituído pelo seu subdomínio de acesso ao Sienge.
Se seu subdomínio de acesso ao Sienge é: construlegal.sienge.com.br sua Base URL ficará como abaixo:
https://api.sienge.com.br/construlegal/public/api/bulk-data/v1
Endpoint
O endpoint acima com o termo que indica você pode Obter a lista do Extrato Histórico Cliente, com isso adicionamos o termo
ao final da Base URL como abaixo:
https://api.sienge.com.br/construlegal/public/api/bulk-data/v1/customer-extract-history
Base URL
Para ver os filtros disponíveis no endpoint clique sobre ele. Para nosso exemplo, vamos utilizar apenas os dois filtros obrigatórios:
Quando definir o período que vai trabalhar basta concatenar esta informação na Base URL, como abaixo.
https://api.sienge.com.br/construlegal/public/api/bulk-data/v1/customer-extract-history?startDueDate=2020-
06-01&endDueDate=2020-08-31
Veja que na sequência acima utilizei o carácter ? (interrogação) para definir que os filtros ou parâmetros iniciarão à partir dali. E a cada
novo parâmetro usamos o & para concatenar a Base URL;
Temos uma lista de títulos e cada título pode ter várias unidades
e várias parcelas e cada parcela pode ter várias baixas.
Não esqueça de usar o protocolo HTTPS, como já consta nos exemplos de URL, para que os dados trafeguem
criptografados nas requisições.
Abra o Microsoft Excel em um documento em branco e renomeie uma planilha para “Dados”, como na figura abaixo:
Vá aba de menu “Dados” > “Obter Dados” > “De Outras Fontes” > “Da Web”. Aqui estamos indicando que a fonte
dos nossos dados será de um serviço da internet.
!
Não esqueça
de salvar!
Depois será apresentada uma tela como a abaixo, você deve escolher a opção ao lado, “Básico” e escolher no campo
central a URL completa como abaixo. Após isso, coloque suas credenciais de usuário e senha e clique em “Conectar”.
Na parte central da tela temos os dados obtidos da API que estão contidos no bloco “data”, como mostra na
documentação.
Para exibirmos os dados em forma de tabela vamos clicar no link “List”, depois com o clique do botão direito no
Cabeçalho “Lista” e em seguida clique em “Para a Tabela”. Isso fará que os dados em forma de lista seja convertida
para tabela.
Para concluir a transformação dos dados de lista para tabela, siga os passos abaixo. Veja que agora já são
apresentados os campos que temos na nossa API.
Um ponto importante aqui é saber que existem dois tipos de agrupamentos de dados que podemos expandir, o que
é cercado pelos [ … ] (colchetes), que é uma lista de dados e o que é um agrupamento de informações simples que
são os campos que ficam dentro de { … } (Chaves).
Clicando no ícone tanto para company (Empresa), costCenter (Empreendimento / Centro de Custo) e customer
(Cliente).
Mas desta vez marque vamos deixar marcada a opção de usar o nome da coluna original como prefixo. Desta forma
os campos ficarão com nome company.id e company.name.
Você poderá também colocar todos os nomes dos campos em português, basta clicar duas vezes sobre o nome para
alterar.
Para os últimos campos units (Unidades), installments (Parcelas) receipts (Baixas), temos que tomar uma decisão
sobre qual iremos utilizar, pois só é possível agregar uma lista por vez para que os dados não fiquem errados no
momento de utilizar as fórmulas.
Aí você poderá clicar em fechar e carregar como mostra na imagem abaixo para que o power query possa carregar
estes dados na planilha.
Você pode renomear a aba criada e vamos trabalhar com algumas tabelas dinâmicas e gráficos de exemplo.
Se você iniciou este tutorial já tendo os dados no excel, esta é a parte que vai colocar a mão na massa para criação
dos seus relatórios customizáveis.
Na planilha “Dados”, que criamos no início deste tutorial, vamos acessar a aba “Inserir” e “Tabela Dinâmica”.
Mas pra você que ficou, vou te dar algumas ideias pra
começar a montar seus relatórios.
Existem muitos outros recursos interessantes para explorarmos aqui, mas agora que você conhece a
tabela dinâmica poderá fazer muitos relatórios totalmente customizados.
Além de montar estas estruturas de dados, você Ou em propriedades da conexão, você pode definir
pode optar por mantê-las sempre atualizadas para atualizar a cada N (quantidade) minutos e/
sem a necessidade de ficar refazendo todos estes ou ao abrir a planilha, por exemplo:
passos.
Misael Soares
Com ele, você pode gerenciar e integrar todas as áreas de sua empresa. Mas não é só
isso: o Sienge também é aberto a conexões com diferentes softwares e aplicativos.