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

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.

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".

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".

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!

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
idCusto Médio
label1. LIMITE DE CRÉDITO

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"

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"

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:

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
labelExecauto Via API REST

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

Deck of Cards
startHiddenfalse
effectDuration0.5
idCards
effectTypehorizontal
loopCardstrue
idVIA API REST
Card
label1 - Fonte de exemplo

Fonte de exemplo de API REST para chamada de execauto:

#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
label2 - Ajustes no fonte

Ajustes a serem feitos no fonte do execauto:

1 - Não fazer a abertura do ambiente: PREPARE ENVIRONMENT ou RpcSetEnv.

2 - 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

Card
label3 - Compilação dos fontes

Compilar os fontes:

1 - Fonte da API: execviarest.prw

2 - Fonte do execauto "ajustado"

Card
label4 - REST

Subir um serviço de REST, para isso utilize o exemplo abaixo:

;=====================================
;==============  WEB REST  ===============
;=====================================

[HTTPV11] 
Enable=1 
AddressFamily=1 
Sockets=HTTPREST

[HTTPREST] 
Port=8086  <<-- Porta do REST
IPsBind=
MaxQueue=10
URIs=HTTPURI
SECURITY=0

[HTTPURI]
URL=/rest
PrepareIn=ALL
Instances=1,10
OnStart=REST_START
OnConnect=REST_CONNECT
OnExit=REST_EXIT

[HTTPJOB] 
MAIN=HTTP_START
ENVIRONMENT=12.1.2310  <<-- Nome do seu ambiente

[ONSTART]
jobs=HTTPJOB
RefreshRate=120

;=====================================

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
titleAlerta de Risco

"Fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização."


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

Para fazer a chamada da API iremos utilizar o Postman.


1 - Baixar e 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>
Image Added
Card
label6 - Teste

No Postman clique no botão "Send" para executar a API:

Image Added
Custo Médio

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

Realize o seguinte processo:
Card
defaulttrue
id
0607202023
label
2. Configuração do Smart View
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
Card
defaulttrue
label2. Servidor de Licença
Card
defaulttrue
label3. Armazenamento de Dados
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
Card
defaulttrue
idCusto Médio
label3. Conectores
Card
defaulttrue
idCusto Médio
label4. Configurador (SIGACFG)
Card
defaulttrue
idCusto Médio
label5. Pronto!
Expandir
title1 - Fonte de exemplo de API REST para chamada de execauto
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 

Via API WS
Execauto Via API WebService

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

Deck of Cards
idVIA API WS
Card
label1 - Fonte de exemplo

Fonte de exemplo de API WS para chamada de execauto:

#include"protheus.ch"
#include"totvs.ch"
#include"apwebsrv.ch"


// API para chamar execauto via WS

WSSERVICEwsteste01
    WSDATAcumped   ASstring
    WSDATAcRet     ASstring
    WSDATAUserCodeASString

    WSMETHODwsteste
ENDWSSERVICE

WSMETHODwstesteWSRECEIVEUserCode,cumpedWSSENDcRetWSSERVICEwsteste01
   U_MyMata410()   //função a ser chamada

RetURN.T.


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

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

     Exemplo: U_MyMata410()

Card
label2 - Ajustes no fonte

Ajustes a serem feitos no fonte do execauto:

1 - Não fazer a abertura do ambiente: PREPARE ENVIRONMENT ou RpcSetEnv.

2 - 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

Card
label3 - Compilação dos fontes

Compilar os fontes:

1 - Fonte da API: execviaws.prw

2 - Fonte do execauto "ajustado"

Card
label4 - WebService
Expandir
titleConfigurando o WEBSERVICE

Para utilizar a API é necessário que os WebServices estejam ativos.  Ambos serviços dependem do serviço HTTP do Protheus, que permite que as informações sejam publicadas na WEB. 

A configuração inicia-se habilitando o serviço HTTP e configurando a porta que todos os outros serviços dependentes deste irão utilizar para a publicação das informações.


Informações

Os serviços devem ser configurados pelo WIZARD, pois a cada módulo WEB instalado são descompactados arquivos importantes no diretório informado na configuração. Estes arquivos são de extensão exclusiva da Microsiga, os *.MZP, e que apenas com o Wizard será possível a correta instalação.

No exemplo acima, a configuração está sendo realizada para o caminho LOCALHOST. Para publicá-lo informe o nome da máquina ou o endereço IP.

Caso seu serviço HTTP esteja configurado para a porta 80, não deve informá-lo no host. Exemplo localhost/ws.




Deck of Cards
idtdrf
Card
labelSe possuir apenas uma filial
Card
defaulttrue
idCusto Médio
labelConfiguração dos Web Services

A - Acesse o Wizard de configuração dos Serviços;


B - Em Servidor Internet (HTTP/FTP), verifique se o serviço de HTTP já existe, confirme se está habilitado e para qual porta está configurada. Pois estas são informações indispensáveis para o correto funcionamento dos WebServices e Portais.


Expandir
titleC - Configurando HTTP/FTP
  • Realize o Download dos Arquivos de Portais (web_files) do Portal do Cliente;
  • Inclua uma pasta web dentro da Protheus Data do Sistema e insira os web_files;
  • Insira também os arquivo  web_files na pasta systemload
  • Selecionar a opção: <HTTP> e clicar na barra superior <Editar> conforme exemplo;
  • O sistema apresentará a tela para Configuração da Seçãoonde os principais campos são:
    • Flag para Habilitar o Protocolo;
    • Path de Arquivos = Caminho da Pasta Web;
    • Ambiente = Nome do Ambiente;
    • Porta de Conexão = Porta de configuração dos Serviços;


Dica
titleImportante

Na configuração da Seção, inserimos como exemplo a porta 92, porém ela pode ser alterada caso prefira.

Caso definida a porta padrão do serviço HTTP que é a 80, não é necessário especificá-la na configuração do WS e Portais.


Basta confirmar e gravar as configurações


D - Configure os Módulos da Web:

Expandir
titleWS TOTVS Linha Protheus Web Services
  • Realize as configurações básicas, campos importantes:
    • Módulo Web = WS - TOTVS Linha Protheus Web Services;
    • Nome da Instância = ws;
    • Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "ws";
    • Selecione o Environment = Nome do Ambiente;
    • Flag para habilitar processos na inicialização do Servidor.


  • Realize a Configuração de Host x Empresas/Filiais, campos importantes:
    • Host = Server e porta dos Web Services (Deve ser informada a porta informada na Configuração HTTP/FTP);
    • Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba).
    • Clique em "Relacionar" e em "Avançar".


Finalizar e confirmar a configuração.


E - Configure o Portal (Protheus)

Expandir
titlePP Portal Protheus
  • Realize as configurações básicas, campos importantes:
    • Módulo Web = PP - Portal Protheus;
    • Nome da Instância = pp;
    • Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "pp";
    • Selecione o Environment = Nome do Ambiente;
    • URL do Protheus Web Services = Server e Porta de configuração dos Web Services.
  • Realize a Configuração de Host x Empresas/Filiais, campos importantes:
    • Host = Server e porta do Portal (Deve ser informada a porta informada na Configuração HTTP/FTP);
    • Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba).
    • Clique em "Relacionar" e em "Avançar".
  • Realize a Configuração de Usuários, onde irá definir o número mínimo e máximo de usuários para acesso.

Finalizar e confirmar a configuração.

Inclua na pasta pp os colocar o arquivos da pasta web na systemload


F - Após as configurações acima, o sistema irá inserir as informações de acesso aos Web Services no arquivo AppServer.ini do Protheus, verifique se as informações estão de acordo com o exemplo abaixo, caso não estejam realize ajustes (Lembrando que a Porta e o Nome do Ambiente serão os que preencheu durante a configuração):

Expandir
titleAppServer.ini

[HTTP]

ENABLE=1

PORT=81


[localhost:92/ws]

ENABLE=1

PATH=c:\seuambiente\Protheus_Data\web\ws

ENVIRONMENT=12.1.025

INSTANCENAME=ws

RESPONSEJOB=JOB_WS_9901

DEFAULTPAGE=wsindex.apw

SECURITY=0


[JOB_WS_9901]

TYPE=WEBEX

ENVIRONMENT=12.1.025                                         

INSTANCES=1,1

SIGAWEB=WS

INSTANCENAME=ws

ONSTART=__WSSTART

ONCONNECT=__WSCONNECT

PREPAREIN=99,01

SECURITY=0


[localhost:92/pp]

ENABLE=1

PATH=c:\seuambiente\Protheus_Data\web\pp

ENVIRONMENT=12.1.025                                       

INSTANCENAME=pp

RESPONSEJOB=JOB_PP

SECURITY=0


[JOB_PP]

TYPE=WEBEX

ENVIRONMENT=ENVIRONMENT

INSTANCES=1,1

SIGAWEB=PP

INSTANCENAME=pp

ONSTART=STARTWEBEX

ONCONNECT=CONNECTWEBEX

ONEXIT=FINISHWEBEX

WEBSERVICELOCATION=http://localhost:92/ws

SECURITY=0


Dica
titleAlerta de Risco

"Fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização."


G - Por fim, reinicie o Server do Protheus e verifique se o serviço do WebService subiu de forma correta no Browser, basta digitar o caminho que configurou no Wizard e verificar se o sistema indica como Habilitado:

Image Added

Card
labelSe for multifilial
Card
defaulttrue
id060720201
labelConfiguração dos Web Services Multifilial

O processo de configuração para uma nova filial é basicamente o mesmo, mas é necessário ter um novo WebService e Portal.


Expandir
titleA - Configurar WS TOTVS Linha Protheus Web Services
  • Realize as configurações básicas, campos importantes:
    • Módulo Web = WS - TOTVS Linha Protheus Web Services;
    • Nome da Instância = ws;
    • Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "ws";
    • Selecione o Environment = Nome do Ambiente;
    • Flag para habilitar processos na inicialização do Servidor.


  • Realize a Configuração de Host x Empresas/Filiais, campos importantes:
    • Host = Server e porta dos Web Services (Deve ser informada a porta informada na Configuração HTTP/FTP);
    • Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba).
    • Clique em "Relacionar" e em "Avançar".


Finalizar e confirmar a configuração.

Expandir
titleB - Configurar PP Portal Protheus
  • Realize as configurações básicas, campos importantes:
    • Módulo Web = PP - Portal Protheus;
    • Nome da Instância = pp;
    • Diretório Raiz das Imagens (Web Path) = Diretório da Pasta Web onde o sistema irá criar a pasta "pp";
    • Selecione o Environment = Nome do Ambiente;
    • URL do Protheus Web Services = Server e Porta de configuração dos Web Services.


  • Realize a Configuração de Host x Empresas/Filiais, campos importantes:
    • Host = Server e porta do Portal (Deve ser informada a porta informada na Configuração HTTP/FTP);
    • Selecione a Empresa/Filial = Empresa e Filial de acesso (Para configuração Multifilial, consulte a respectiva aba).
    • Clique em "Relacionar" e em "Avançar".


Finalizar e confirmar a configuração.

Informações

Os serviços devem ser configurados pelo WIZARD, pois a cada módulo WEB instalado são descompactados arquivos importantes no diretório informado na configuração. Estes arquivos são de extensão exclusiva da Microsiga, os *.MZP, e que apenas com o Wizard será possível a correta instalação.

No exemplo acima, a configuração está sendo realizada para o caminho LOCALHOST. Para publicá-lo informe o nome da máquina ou o endereço IP.

Caso seu serviço HTTP esteja configurado para a porta 80, não deve informá-lo no host. Exemplo localhost/ws.

Pra cada filial nova é necessário configurar um novo portal.


C - Após as configurações acima, o sistema irá inserir as informações de acesso aos Web Services no arquivo AppServer.ini do Protheus, verifique se as informações estão de acordo com o exemplo abaixo, caso não estejam realize ajustes (Lembrando que a Porta e o Nome do Ambiente serão os que preencheu durante a configuração):

Expandir
titleAppServer.ini

[HTTP]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\Web
PORT=91
ENVIRONMENT=nome do ambiente

[localhost:91/ws]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\web\WS
ENVIRONMENT=nome do ambiente
INSTANCENAME=WS
RESPONSEJOB=JOB_WS_9901 → (Filial 01)
DEFAULTPAGE=wsindex.apw

[JOB_WS_9901]
TYPE=WEBEX
ENVIRONMENT=nome do ambiente
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01 → (Filial 01)

[ONSTART]
;JOBS=JOB_WS_9901,JOB_PP,JOB_WS02_9902,JOB_PP02

[localhost:91/pp]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\web\pp
ENVIRONMENT=nome do ambiente
INSTANCENAME=pp
RESPONSEJOB=JOB_PP

[JOB_PP]
TYPE=WEBEX
ENVIRONMENT=nome do ambiente
INSTANCES=1,1
SIGAWEB=PP
INSTANCENAME=PP
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBSERVICELOCATION=http://localhost:91/ws → (URL da filial 01)

[localhost:91/ws02]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\web\WS02
ENVIRONMENT=nome do ambiente
INSTANCENAME=WS02
RESPONSEJOB=JOB_WS02_9902 → (Filial 02)
DEFAULTPAGE=wsindex.apw

[JOB_WS02_9902]
TYPE=WEBEX
ENVIRONMENT=nome do ambiente
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=WS02
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,02 → (Filial 02)

[localhost:91/pp02]
ENABLE=1
PATH=C:\nome do ambiente\Protheus_Data\web\pp02
ENVIRONMENT= nome do ambiente
INSTANCENAME=pp02
RESPONSEJOB=JOB_PP02

[JOB_PP02]
TYPE=WEBEX
ENVIRONMENT=nome do ambiente
INSTANCES=1,1
SIGAWEB=PP
INSTANCENAME=pp02
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBSERVICELOCATION=http://localhost:91/ws02 → (URL da Filial 02)


D - Por fim, reinicie o Server do Protheus e verifique se o serviço do WebService subiu de forma correta no Browser, basta digitar o caminho que configurou no Wizard e verificar se o sistema indica como Habilitado:

Image Added

Card
label5 - SoapUI

Para fazer a chamada da API iremos utilizar o SoapUI:


1 - Baixar e instalar o SoapUI: https://www.soapui.org/downloads/latest-release/

Dica
iconfalse

Para fazer a configuração do SoapUI é necessário compilar o fonte da API e subir o appserver do WebService.


2 - No SoapUI clicar em: File > New SOAP Project


3 - Informar os dados de acesso ao SoapUI, campos a preencher:

  • Project Name: Nome do seu projeto
  • Initial WSDL: Coloque o endereço de seu Webservice + o texto: /WSTESTE01.apw?WSDL
  • Clicar em "OK"

Image Added


4 - No SoapUI dê um duplo clique em "Request 1" e configure da seguinte forma:

Image Added

Dica
iconfalse
  • USERCODE: Admin
  • CUMPED: Senha do usuário admin
Card
label6 - Teste

No SoapUI dê um duplo clique em "Request 1" e clique no botão "play".


Image Added

Card
defaulttrue
id0607202023
label

Pode lhe Interessar: