Framework - Linha Logix - FRW - Comunicação REST

 Tempo aproximado para leitura: 00:01:33 min

Dúvida
Como configurar um ambiente REST - Representational State Transfer no Logix?

Ambiente
Framework - Framework (Linha Logix) - Administração Logix - Todas as versões

Solução
Para configurar um ambiente REST, execute o procedimento abaixo:

1- Acesse o Servidor do Logix, crie um novo Appserver e nomei-o como appserver_rest. O objetivo desta nomenclatura é facilitar na identificação caso haja a necessidade de realizar alguma manutenção;

2- O segundo passo é editar as configurações no arquivo totvsappserver.ini. É necessário definir algumas seções nesse arquivo e ajustar, quando necessário, os valores para o nome do ambiente em ENVIRONMENT, porta em PORT, quantidade de instâncias para execução no Appserver em INSTANCES e URL para indicar o endereço em que as requisições REST serão atendidas.

Segue abaixo exemplo de informações que precisam ser incluídas no Appserver que será configurado para utilização do REST:

[ONSTART]
REFRESHRATE=30
JOBS=HTTPJOB 

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=logix12_ora  ;*** NOME DO AMBIENTE LOGIX, pode ser modificado

[HTTPV11]
ENABLE=1
SOCKETS=HTTPREST
TIMEOUT=600 

[HTTPREST]
PORT=9070   ;*** Porta utilizada na URI, pode ser modificada
URIS=URITESTE
SECURITY=0

[URITESTE]
URL=/  ;*** Endereço base pra atender as requisições REST. Exemplo: http://localhost:9070/rest  (URL=/rest)
INSTANCES=2,2   ;*** Número de instâncias utilizadas para atender as requisições REST (quantidade inicial e máxima de instâncias)
ONSTART=LOGIXRESTSTART
ONCONNECT=LOGIXRESTCONNECT
ONEXIT=LOGIXRESTEXIT 

Com base na configuração acima, as requisições REST serão atendidas a partir da seguinte URL base: http://localhost:9070/rest

Após a inicialização do Appserver ao acessar o endereço configurado deve ser apresentada uma tela conforme exemplo abaixo: