Este artigo tem como objetivo detalhar e exemplificar como é feito uma consulta SQL para obter os dados no sistema SIQ.
Conforme iremos ver a seguir, o artigo indica os passos de como é possível obter os dados através de consulta SQL e também a explicação de cada parametros/variáveis necessárias para essa requisição.
Tópicos:
- Preparando o Ambiente para simular consulta SQL
- Cenário de Exemplificação de uma consulta SQL e obtendo retorno dos dados (API Teste)
- Configurando o SQL no Power BI
Preparando Ambiente para simular consulta SQL
A seguir, vamos sugerir a instalação de um programa a qual podemos simular a consulta SQL para acesso aos dados.
A nossa sugestão é instalar uma extensão do crhome - "Talend API Tester"
Abaixo segue os passos:
- Passo 1
https://chrome.google.com/webstore/
- Passo 2
Localize a extensão "Talend API Tester"
- Passo 3
Acesse a extensão do Chrome
Cenário de Exemplificação de uma consulta SQL e obtendo retorno dos dados (API Teste)
- Passo 1 - Obtendo Autenticação
Adicionar o endereço URL da consulta:
https://sales.siq.com.br/seam/resource/rest/authenticator/login
Adicionar as informações do cabeçalho da requisição:
Content-Type: application/json
Adicionar as informações do corpo da requisição :
{
"user":"powerbi",
"password":"powerBI123"
}
Retorno da Requisição
{
"login": "powerBI",
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyTmFtZSI6InBvd2VyQkkiLCJleHAiOjE3MDU1MDE4MTEsInVzZXJJZCI6MjE0NSwidGVuYW50LWlkIjoiU0lRIn0.DB5am2iYw9Y96uqRch1iD2lZoE03KXPFebMwGbeT-0U",
"name": "powerBI",
"id": 2145
}
Exemplo da Requisição.
- Passo 2 - Invocando a consulta desejada
Adicionar o endereço URL da consulta SQL:
https://sales.siq.com.br/seam/resource/rest/query/execute
Adicionar as informações do cabeçalho da requisição:
**Deverá ser considerada o token gerado na etapa Autenticação
authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyTmFtZSI6InBvd2VyQkkiLCJleHAiOjE3MDU1MDE4MTEsInVzZXJJZCI6MjE0NSwidGVuYW50LWlkIjoiU0lRIn0.DB5am2iYw9Y96uqRch1iD2lZoE03KXPFebMwGbeT-0U
Adicionar as informações do corpo da requisição :
{
"sql" : "select * from siq_item",
"maxRows" : "8000",
"parameters":[]
}
- Passo 3
Simulando uma execução.
- Passo 4
Retorno dos dados
Configurando o SQL no Power BI
- Passo 1 - Criando uma consulta de dados
Clicar na opção "Obter dados" e selecionar "Consulta em branco"
- Passo 2 - Editando a consulta criada
Selecionar a consulta que foi criada no Passo 1 e clicar em "Editor Avançado"
- Passo 3 - Editar conteúdo da consulta criada
Deve ser apagado o conteúdo exibido na consulta.
- Passo 4 - Inserindo conteúdo da consulta SQL
Inserir o seguinte conteúdo na consulta disponibilizada e, em seguida, clicar no botão "Concluir".
let getData = (resultado) =>
let authUrl = "https://sales.siq.com.br/seam/resource/rest/authenticator/login",
body = "
{
""user"" : ""powerbi"",
""password"" : ""powerbi123""
}
",
getToken = Json.Document(
Web.Contents(
authUrl,
[
Headers=[#"Content-Type"="application/json"],
Content=Text.ToBinary(body)
]
)
),
token = getToken [token],
authToken = "Bearer " & token,
urlRequest = "https://sales.siq.com.br/seam/resource/rest/query/execute",
bodyRequest = "
{
""sql"" : ""select * from siq_item"",
""maxRows"" : ""8000"",
""parameters"":[]
}
",
results = Json.Document(
Web.Contents(
urlRequest,
[
Headers=[#"Content-Type"="application/json",Authorization=authToken],
Content=Text.ToBinary(bodyRequest)
]
)
)
in results
in getData
- Em authUrl deverá inserir a URL de autenticação da consulta.
- ""user"" - Deve ser informado o login de autenticação no siq
- ""password"" - Deve ser informado a senha de autenticação no siq
- Em urlRequest deverá inserir a ULR da consulta SQL
- O select contido em ""sql"" deve estar sem quebra de linha
- Passo 5 - Função invocada
Após concluir a consulta deverá clicar no botão "Invocar".
Caso a mensagem São necessárias informações sobre a privacidade dos
dados apareça é preciso realizar os seguintes passos:
1. Clicar em "Continuar"
2. Checar a opção "Ignorar verificações de Níveis de Privacidade para
este arquivo. Ignorar os Níveis de Privacidade pode expor dados sensíveis
ou confidenciais a uma pessoa não autorizada".
6. Após salvar a função será automaticamente invocada!
- Passo 6 - Criando uma nova tabela
Na aba "Página Inicial" clicar em "Inserir dados", inserir texto em pelo menos uma linha e acionar o botão "Ok".
- Passo 7 - Invocando a função personalizada
Na aba "Adicionar Coluna" clicar em "Invocar Função Personalizada" e no campo "Consulta de função" selecionar a consulta criada no Passo 4.
- Passo 8 - Expandindo os resultados da consulta
Clicar sob o ícone localizado do lado direto da Coluna Criada, selecionar a opção "Expandir para Novas Linhas".
- Passo 9 - Exibir valores registrados na coluna .objects
Clicar sob o ícone localizado do lado direto da coluna, selecionar todos os registros, desmarcar a opção "Use o nome da coluna original como prefixo" e clicar em "OK".
- Passo 10 - Fechar e Aplicar
Verificar sempre a aba "Detalhes de Configurações de Servidores SIQ"
na transação SERVER.
Deve ter a chave "allowWebServiceCalls" deve estar com valor true
Comentários
0 comentário
Por favor, entre para comentar.