Á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

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

2 - Informar os dados de acesso ao Postman, campos a preencher na aba "Headers":

  • GET: Coloque o endereço de seu REST + o texto: /EXECTST2
  • Key: tenantid
  • Value: 99,01 (empresa,filial)

Após compilar os fontes, subir o rest e configurar o Postman, clique no botão "Send" para executar a API.

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.




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

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()

Card
defaulttrue
id0607202023
labelVia API REST

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


Conceito (O que é um 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:

Image Removed

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

Image Removed

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):

Deck of Cards
startHiddenfalse
effectDuration0.5
idCards
effectTypehorizontal
loopCardstrue
Card
defaulttrue
idCusto Médio
labelPontos de Entrada
Card
defaulttrue
id0607202023
labelExecAuto
Expandir
titleComo saber se um fonte possui 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
Card
defaulttrue
idVia API REST
labelPontos de Entrada
Expandir
title1 - Fonte de exemplo de API REST para chamada de execauto
Informações
iconfalse
Expandir
title2 - Ajustes no fonte do execauto
Informações
iconfalse

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
Informações
iconfalse

1 - Compilar o fonte da API: execviarest.prw

2 - Compilar o fonte do execauto "ajustado"

3 - Subir o REST

Expandir
title4 - Postman
Informações
iconfalse
Image Removed
Expandir
title5 - Teste
Informações
iconfalse
Image Removed
Card
defaulttrue
id0607202023
labelVia API WS
Expandir
title1 - Fonte de exemplo de API REST para chamada de execauto
Informações
iconfalse

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
Informações
iconfalse

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
Informações
iconfalse

1 - Compilar o fonte da API: execviarest.prw

2 - Compilar o fonte do execauto "ajustado"

3 - Subir o REST

Expandir
title4 - Postman
Informações
iconfalse

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

2 - Informar os dados de acesso ao Postman, campos a preencher na aba "Headers":

  • GET: Coloque o endereço de seu REST + o texto: /EXECTST2
  • Key: tenantid
  • Value: 99,01 (empresa,filial)



Expandir
title5 - Teste
Informações
iconfalse

Após compilar os fontes, subir o rest e configurar o Postman, clique no botão "Send" para executar a API.




Card
defaulttrue
id0607202023
labelVia API WS


Pode lhe Interessar: