Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Produto:

Microsiga Protheus®

Ambiente:Faturamento (SIGAFAT)

Ocorrência:

Exemplos de teste e informações sobre teste de Pontos de entrada e ExecAuto

Passo a passo:



Card
defaulttrue
idCusto Médio
label1. LIMITE DE CRÉDITO
Deck of Cards
startHiddenfalse
effectDuration0.5
idCards
effectTypehorizontal
loopCardstrue
Card
defaulttrue
idCusto Médio
labelPontos de Entrada


Card
defaulttrue
id0607202023
labelExecAuto

Conceito (O que é um ExecAuto?)


Expandir
titleComo saber se um fonte possui ExecAuto?

Basicamente, as funções que recebem parâmetros podem ser chamadas via ExecAuto, parâmetros são passados entre parênteses após o nome da função.


Exemplo de Função que possui parâmetros:

Exemplo de função que não possui parâmetros:


Após verificar se a função tem parâmetros, deve-se verificar se existe um Modelo de ExecAuto para esta função publicado no TDN.

Páginas de Rotinas Automáticas (ExecAuto):


Aviso
titleAtenção

Caso a rotina possua parâmetros e não possua um exemplo publicado no TDN, é necessário solicitar a documentação do ExecAuto ao time de desenvolvimento através de uma Issue de Documentação.




Card
defaulttrue
id0607202023
labelVia API REST

Para testes de chamada de execauto via API REST, siga os passos abaixo:

Deck of Cards
startHiddenfalse
effectDuration0.5
idCards
effectTypehorizontal
loopCardstrue
Card
defaulttrue
idCusto Médio
label1. Config. REST

Caso necessite, temos um vídeo do processo: Configuração do Rest


O primeiro passo é subir um serviço de REST.
Para isso, utilize o Exemplo de REST e siga os passos do vídeo Configuração do REST.


Não se esqueça de validar se o REST está no ar, feche o console do App Server e abra novamente verificando se exibe a mensagem de REST, validando também se o REST está no ar através do navegador da internet, conforme demonstrado no vídeo.


Dica
titleDica
  • Temos também uma documentação complementar sobre a configuração através do APWebWizard: Passo 3: Configurando REST
  • No arquivo appserver.ini do rest a chave SECURITY tem que estar igual a 1 (SECURITY=1)


Card
defaulttrue
idCusto Médio
label2. Configuração do Smart View

Com base na documentação: Configuração do produto Protheus integrado ao Smart View


Realize o seguinte processo:

Expandir
titleInstalação simplificada

Caso necessite, temos um vídeo do processo: Instalador

Seguindo o guia: Instalação do Sistema

Realize a instalação abaixo:

  1. Faça download do Instalador do Smart View Agent clicando neste link;
  2. Extrair todo o conteúdo do arquivo zip e execute o arquivo SMARTVIEW.AGENTINSTALLER.EXE ;
  3. Selecione o diretório de instalação e prossiga para a próxima etapa. Recomendamos que a instalação seja feita no diretório C:\TOTVS;

  4. O instalador irá realizar a instalação na pasta SMART-VIEW, criada automaticamente no diretório selecionado;
  5. Caso o diretório SMART-VIEW já exista, o instalador perguntará se deseja sobrescrever a instalação anterior, caso não queira, um novo diretório deverá ser informado; 
  6. Após conclusão, o Smart View já se encontra disponível em seu ambiente e já pode ser configurado via navegador no endereço HTTP://LOCALHOST:7019 (ver Configurações do Smart View).


Vamos configurar o SmartView, para isso acesse o link: http://localhost:7019/startup

Onde é necessário preencher:

Deck of Cards
idSmart View
Card
defaulttrue
label1. Provedor de Segurança

Caso necessite, temos um vídeo do processo: Provedor de Segurança


Aqui você poderá informar os dados de acesso ao Smart View, campos a preencher:

  • Nome do Provedor: Pode escolher qualquer nome.
  • Endereço de Descoberta: Insira o endereço de seu REST + o texto: /.well-known/treports/security
  • Recuperar Emissor: Clique nessa opção, após os preenchimentos acima, e preencha o usuário e senha de acesso. Precisa ser um usuário Administrador e a senha não pode ser em branco.

Após as confirmações basta "Avançar"

Card
defaulttrue
label2. Servidor de Licença

Caso necessite, temos um vídeo do processo: Servidor de Licença


Aqui você poderá informar os dados básicos do servidor de licença do Smart View, como ip do servidor, porta e CNPJ.

Campos a preencher:

  • Ip do servidor: Ip do License Client que possui configurado em seu AppServer.ini
  • Porta: Porta do License Client que possui configurado em seu AppServer.ini
  • CNPJ: CNPJ da empresa, como somos TOTVS, pode informar o 53113791000122

 Após as confirmações basta "Avançar"

Card
defaulttrue
label3. Armazenamento de Dados

Caso necessite, temos um vídeo do processo: Armazenamento de Dados


Aqui você poderá escolher em qual banco o Smart View utilizará para salvar seus dados, podendo escolher entre Sql Server, Postgres e SqLite.

Há duas formas de configuração:

Expandir
titleSQLite

Nessa opção não é necessário inserir a senha de Administrador do banco de Dados, pois ela é experimental, permite fazer alguns testes básicos em funcionalidades do SmartView

Expandir
titleSQL Server

Aqui é possível indicar o Banco de Dados do seu ambiente, mas terá que possuir a senha do sa ou de um usuário com permissão de administrador.

Campos a preencher:

  • Data Source: Nome do Servidor do seu Banco de Dados, pode ser obtido Acessando o Banco;
  • Initial Catalog: Esse é o nome do seu Banco de dados, pode ser obtido Acessando seu Banco;
  • User Id: Nome do Usuário administrado do seu Banco de Dados (Exemplo: sa);
  • Password: Senha do usuário administrador do Banco de Dados.

Após a configuração, basta clicar em "Concluir"

Card
defaulttrue
idCusto Médio
label4. Chaves AppServer.ini

Caso necessite, temos um vídeo do processo: Chaves AppServer.ini


Vamos realizar a configuração para a nova interface de visualização do Protheus.

Para isso:

Após esses ajustes, será necessário reiniciar o Server.

Card
defaulttrue
idCusto Médio
label3. Conectores

Caso necessite, temos um vídeo do processo: Conectores


Após as configurações, aparecerá na tela a mensagem "Fim da configuração!" e um botão "Abrir o Smart View".

Clicando em "Abrir o Smart View" você será redirecionado para a tela onde os cliente poderão criar suas visões, personalizar as já existentes, etc. 

Nessa tela, no Menu lateral esquerdo, é necessário selecionar a opção "Conectores", vamos incluir um conector:

Campos a preencher:

  • Nome: Nome do Conector Nativo, pode ser qualquer nome;
  • Endereço: Inserir o endereço do REST configurado no ambiente;
  • Testar Conexão: Clique nesta opção para que o Conector valide o acesso ao REST;
  • Clique em "Salvar".
Card
defaulttrue
idCusto Médio
label4. Configurador (SIGACFG)

Caso necessite, temos um vídeo do processo: Configurador (SIGACFG)


Agora vamos configurar o "Tipo de Autenticação" e a "URL Base Smart View" pelo Configurador (SIGACFG).

Acesse o Configurador (SIGACFG) e selecione a opção "Ambiente", depois a Opção "Cadastros" e por fim a opção "Configuração Smart View" (Caso esteja no Release 2210, provavelmente estará com o nome "Configuração TReport", mas é a mesma rotina).

Após isso, basta "Confirmar".

Card
defaulttrue
idCusto Médio
label5. Pronto!

Caso necessite, temos um vídeo do processo: Smart View no Menu


Após estas configurações, basta acessar o módulo que deseja visualizar a visão no Smart View e selecionar a opção "Consultas" e a opção "Smart View".

Caso esteja acessando o release 2210, essa opção não estará no Menu, sendo necessário inserir através do configurador.

No ambiente 2310, basta selecionar a visão que deseja acessar!

Expandir
title1 - Fonte de exemplo de API REST para chamada de execauto

Fonte de Exemplo:

#INCLUDE'PROTHEUS.CH'
#INCLUDE 'TOTVS.CH'
#INCLUDE 'RESTFUL.CH'
#INCLUDE 'RWMAKE.CH'
#INCLUDE 'TOPCONN.CH'
#INCLUDE "FWMVCDEF.CH"


// API para chamar execauto via REST

WSRESTFULEXECTST2DESCRIPTION"TESTE"
    WSMETHODGETDESCRIPTION"TESTE"WSSYNTAX"/EXECTST"
ENDWSRESTFUL

WSMETHODGETWSSERVICEEXECTST2
    U_MyMata410()   //Função a ser chamada
Return


1 - Salvar o fonte com o nome "execviarest.prw".

2 - Na "Função a ser chamada" colocar o nome da função do execauto que irá utilizar:

     Exemplo: U_MyMata410()

Expandir
title2 - Ajustes no fonte do execauto

1 - No fonte do execauto não fazer a abertura do ambiente: PREPARE ENVIRONMENT ou RpcSetEnv.

2 - No fonte do execauto fazer o tratamento para a função "MostraErro" conforme documentação abaixo:

Cross Segmento - TOTVS Backoffice Linha Protheus - ADVPL - Erro: job threads doesn't support remoto/visual components

Expandir
title3 - Compilação dos fontes e REST

1 - Compilar o fonte da API: execviarest.prw

2 - Compilar o fonte do execauto "ajustado"

3 - Subir o REST

Expandir
title4 - Postman

1 - Instalar o Postman: https://www.postman.com/downloads/

2 - Configuração do Postman:

Em GET coloque 

Card
defaulttrue
id0607202023
labelVia API WS


Pode lhe Interessar: