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.

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:

• Ativem os serviços HTTP e/ou HTTPS para execuções com interface WEB.
• Ativem os serviços de requisições HTTP REST para requisiçõe de APIs REST invocadas pelas aplicações WEB para busca de informações exibidas em tela ao usuário.

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

Para ativar o serviço HTTP e/ou HTTPS e o ambiente para execuções das aplicações WEB Logix, é preciso definir as seções abaixo, ficando como opcional definir apenas a seção HTTPS ou HTTP ou então definir ambas.

No exemplo abaixo apesar de definir a seção HTTP, foi configurada como ENABLE=0 para inativar o acesso HTTP (sem segurança).

[HTTP]
ENABLE=10   ;*** Pode ser desabilitadahabilitada, se optar por ativar asem segurança (HTTPS).
PORT=9193  ;*** Número da porta para viabilizar acesso HTTP ao AppServer
ENVIRONMENT=logix12_ora  ;*** Ambiente padrãode conectadoreferência para requisição HTTP
DEFAULTPAGE=wsindex.apw
DEFAULTPAGE=index.html     ;*** Recurso web inicial acessado, existenteAmbiente padrão conectado para requisição HTTPnas requisições HTTP quando não informado na URL (Exemplo: http://localhost:9193/) 
PATH=c:\totvs\http

[HTTPS]
ENABLE=1
PORT=9194  ;*** Número da porta para viabilizar acesso HTTPS ao AppServer
ENVIRONMENT=logix12_ora  ;***  Ambiente padrãode conectadoreferência para requisição HTTPS
DEFAULTPAGE=wsindex.apw  ;*** Recurso web inicial acessado, nas requisições HTTP quando não informado na URL (Exemplo: https://localhost:9194/)
PATH=c:\totvs\http

[<SERVER_IP>:9194/apps]
ENVIRONMENT=logix12_ora  ;*** Ambiente de referência para requisição HTTPS no endpoint /apps 
RESPONSEJOB=JOBWEB
DEFAULTPAGE=index.html ;*** Recurso web inicial acessado na pasta da aplicação web, quando não for informado na URL (Exemplo: https://localhost:9194/apps/gtrib/gtr10000)
PATH=c:\totvs\web\apps
UPLOADPATH=\upload
CACHE-CONTROL=no-store
PRAGMA=no-cache

Para execução das aplicações WEB Logix é obrigatório definir a seção com o endpoint /apps indicando a pasta raiz onde os artefatos WEB são disponibilizados.

No exemplo acima [<SERVER_IP>:9194/apps] indica que pode ser definida a seção do endpoint /apps usando o número do IP do servidor de aplicação e foi definido apenas para a porta 9194 (acesso via HTTPS).

Caso opte em informar o HOSTNAME do servidor ao invés do número do IP, é possível configurar no arquivo de profile do Logix a chavelogix.app.hostname com o nome do servidor.

       logix.app.hostname = "meuservidor"

[meuservidor:9194/apps]
ENVIRONMENT=logix12_ora
RESPONSEJOB=JOBWEB
DEFAULTPAGE=index.html ;*** Recurso web inicial acessado na pasta da aplicação web, quando não for informado na URL (Exemplo: https://localhost:9194/apps/gtrib/gtr10000)
PATH=c:\totvs\web\apps
UPLOADPATH=\upload
CACHE-CONTROL=no-store
PRAGMA=no-cache

Ativando o

[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=*  ;;***