INTRODUÇÃO

A partir do pacote Logix 12.1.2507 ou Fix Framework Logix 12.1.2503.FIX01 é possível executar programas com interface WEB, desenvolvidos com base em PO-UI (biblioteca de componentes basedos em Angular), mas para isso existem pré-requisitos envolvendo:

• Versões de build SmartClient e AppServer
• Configurações de ambiente WEB no arquivo de configuração do AppServer

Veja abaixo mais detalhes a respeito de cada um destes dois itens acima, para viablizar a execução de aplicações WEB a partir do Menu Logix.

Versões de build SmartClient e AppServer

A versão Smartclient que é 100% compatível para executar telas com interface WEB desenvolvidas com base em PO-UI é referente ao build HARPIA (7.210324P).

A versão Smartclient do build 7.00.131227A, NÃO É COMPATÍVEL e o sistema irá bloquear qualquer tentativa de execução de uma tela WEB Logix para o componente LWebDialog.

Já a versão Smartclient do build 7.00.170117A (LOBO GUARÁ) compatível com o build AppServer 7.00.131227A (32 bits), permite executar as telas WEB Logix, no entanto com uma restrição:

• Devido a incompatibilidade da atual da versão Angular com a versão da biblioteca Chromium embutida no build Smartclient LOBO GUARÁ, a interface da tela WEB Logix não é apresentada como conteúdo da aba do menu Logix, mas é disponibilizado ao usuário um LINK na lateral direita da tela que permite a abertura da respectiva tela WEB Logix em uma nova janela utilizando um navegador WEB externo que será de escolha do usuário.

Independente desta exceção de incompatibilidade com a versão do Chromium embutido no SmartClient Desktop, este link de acesso em navegador externo para as telas WEB Logix sempre estará disponível para o usuário utilizar caso surja qualquer tipo de incompatibilidade com a tela WEB que impeça a visualização da sua interface com sucesso no conteúdo da aba do menu Logix.

Configurações de ambiente WEB no arquivo de configuração do AppServer.

No LOGIX, existem configurações a serem definidas no arquivo de configuração do TotvsAppserver (Arquivo Totvsappserver.ini) para executar e desenvolver métodos utilizando a arquitetura REST na tecnologia TotvsTec.

A seguir será apresentado um exemplo de configuração do TotvsAppserver e algumas referências para outras documentações também disponíveis a respeito do mesmo assunto.

Para mais detalhes a respeito de conceitos, configurações e testes utilizando arquitetura REST com TotvsTec clique AQUI (necessário solicitar permissão para equipe TotvsTec).

Configurações de ambiente WEB no arquivo de configuração do AppServer

É necessário definir algumas seções no arquivo de configuração do Appserverque viabilizem:

• Execuções com interface WEB (HTTP/HTTPS), ativando o protocolo Ativem os serviços HTTP e/ou HTTPS para execuções com interface WEB.
• Execuções Ativem os serviços de requisições HTTP REST para requisiçõe de APIs REST que são utilizadas invocadas pelas aplicações WEB para busca de informações para exibição exibidas em tela ao usuário.

[HTTP]
ENABLE=1   ;*** Pode ser desabilitada, se optar por ativar a segurança (HTTPS).
PORT=9193  ;*** Número da porta para viabilizar acesso HTTP ao AppServer
ENVIRONMENT=logix12_ora ;*** Ambiente padrão conectado para requisição HTTP
defaultpage=wsindex.apwindex.html  ;*** Recurso web inicial acessado, existenteAmbiente padrão conectado para requisição HTTP
PATH=c:\totvs\web ;***
UPLOADPATH=c:\totvs\upload
;SAMLSessionName=SAMLhttp9194

[HTTPS]
ENABLE=1
PORT=9194
ENVIRONMENT=logix12_ora
instances=2,4,2,2
defaultpage=wsindexindex.apwhtml
PATH=c:\totvs\web
UPLOADPATH=c:\totvs\upload
;SAMLSessionName=SAMLhttps9194

[localhost:9194/apps]
ENVIRONMENT=logix12_ora
RESPONSEJOB=JOBWEB
DEFAULTPAGE=index.html
PATH=c:\totvs\web\apps
UPLOADPATH=C:\TOTVS\web\upload_files
CACHE-CONTROL=no-store
PRAGMA=no-cache

Ativando o protocolo HTTP/HTTPS para execução da interface das aplicações WEB

justar, quando necessário, os valores na seção HTTPREST, ou conforme o nome definido na chave SOCKETS da seção [HTTPV11] para:

• O nome do ambiente (Chave ENVIRONMENT)
• Número da porta (Chave PORT), quantidade de instâncias para execução no AppServer (Chave INSTANCES) e Chave URL para indicar o endereço em que as requisições REST serão atendidas.

[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=8580   ;*** Porta utilizada na URI, pode ser modificada
URIS=URIAPPS
SECURITY=0 

[URIAPPS]
URL=/   ;*** Endereço base pra atender as requisições REST. Exemplo: http://localhost:8580/api/vdp/v1/clientes
INSTANCES=2,10   ;*** 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 
CORSENABLE=1
ALLOWSORIGIN=*  ;;*** 

É importante sempre avaliar o conceito de uso para avaliar o uso ou não das chaves CORSENABLE e ALLOWSORIGIN

Para ativar a autenticação REST acesse LGX - Comunicação REST e veja as orientações descritas no item Ativando autenticação REST.

Com base na configuração acima, as requisições REST serão atendidas a partir da seguinte URL base:  http://localhost:8580/ e caso seja ativada a segurança com autenticação (SECURITY=1), após configurar todas as chaves necessárias, as requisições serão atendidas a partir da URL https://localhost:8580/