Pré-requisitos / Configuração PO-UI

O acesso as rotinas que utilizam a tecnologia PO-UI podem ser configuradas em dois formatos distintos: utilizando a porta multiprotocolo ou configurando o servidor HTTP manualmente. Segue detalhamento sobre cada uma das formas. Para que as rotinas executem corretamente, é necessário configurar apenas uma das duas opções.

1 - Porta Multiprotocolo (Recomendado)

Essa é a maneira mais simplificada e prática de se executar as rotinas, porém só está disponível a partir LIB 20200214, e do Appserver versão 7.00.191205P. Se possível, priorizar esse método. 

Para realizar a configuração da porta multiprotocolo, basta adicionar no arquivo de configuração do APPSERVER (appserver.ini), na seção GENERAL a chave App_Environment cujo o valor deve ser o nome do ambiente no qual os serviços rodarão. 

Apenas com esta configuração a rotina já deve ser executada corretamente, pois com a porta multiprotocolo todos os serviços necessários já são iniciados utilizando a mesma porta do servidor de aplicação.

Podem ser realizadas configurações adicionais relacionadas a porta multiprotocolo. Para maiores informações acesse a página Application Server - Porta Multiprotocolo.

2 - Parâmetros MV_BACKEND e MV_GCTPURL

A segunda opção de configuração para utilização das rotinas, é através dos parâmetros MV_BACKEND e MV_GCTPURL. Para utilizar estes parâmetros, é necessário configurar um serviço REST e um serviço HTTP para utilização da rotina.

O parâmetro MV_BACKEND deve ser cadastrado, e o seu conteúdo deve ser a URL de comunicação com o serviço REST configurado.

O parâmetro MV_GCTPURL deve ser cadastrado, e o seu conteúdo deve ser a URL de comunicação HTTP configurado.

2.1 - Configuração do APPSERVER.INI para habilitar o serviço HTTP

[HTTP]
enable=1
port=8020
ENVIRONMENT=PRODUCAO
PATH=C:\TOTVS_12\protheus\protheus_data\http-root

Onde:

• Enable = 1. Indica que o serviço HTTP está habilitado.
• Port=8020. Indica a porta onde o serviço será iniciado. Pode ser utilizada qualquer porta disponível.
• Environment=PRODUCAO. Nome do ambiente que será utilizado.
• Path=<diretório>; O diretório deve ser uma pasta com o nome "http-root", que deve estar dentro do ROOT_PATH (protheus_data) do sistema.

Seguindo o exemplo acima, o valor que deve ser configurado no parâmetro MV_GCTPURL é: http://<ip-do-servidor>:8020/

Para mais informações sobre as configurações do HTTP no appserver.ini, acesse a página Seção [HTTP].

2.2 - Configuração do APPSERVER.INI para habilitar o serviço REST.

[ONSTART]
JOBS=HTTPJOB
REFRESHRATE=10

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=PRODUCAO

[HTTPV11]
Enable=1
Sockets=HTTPREST

[HTTPREST]
Port=5050
IPsBind=
URIs=HTTPURI

[HTTPURI]
URL=/rest
PrepareIn=T1,D MG 01 
Instances=1,1,1,1
CORSEnable=1
AllowOrigin=*

O exemplo acima irá iniciar o serviço REST na porta 5050, e com a URL /rest. Estas configurações podem ser alteradas nas respectivas chaves "Port" e "URL".

Com a configuração do serviço REST conforme o exemplo, o valor que deve ser configurado no parâmetro MV_BACKEND é: http://<ip-do-servidor>:5050/rest/

Para mais informações sobre a realização da configuração do serviço REST, consulte a documentação de configuração do Web Service REST.