Histórico da Página
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
appserver.inide configuração do AppServer
É necessário definir algumas seções no arquivo de configuração do Appserver e ajustarque viabilizem:
- Execuções com interface WEB (HTTP/HTTPS), ativando o protocolo HTTP e/ou HTTPS.
- Execuções de APIs REST que são utilizadas pelas aplicações WEB para busca de informações para exibição 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
defaultpage=wsindex.apw
PATH=c:\totvs\web
UPLOADPATH=c:\totvs\upload
;SAMLSessionName=SAMLhttp9194
[HTTPS]
ENABLE=1
PORT=9194
ENVIRONMENT=logix12_ora
instances=2,4,2,2
defaultpage=wsindex.apw
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 para o 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 ;*** NOMENome DOdo AMBIENTEAmbiente LOGIXLogix, 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: httpshttp://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
| Painel | ||||
|---|---|---|---|---|
| ||||
|
Neste caso é indicado que ative Para ativar a autenticação REST conforme orientações no itemREST acesse LGX - Comunicação REST e veja as orientações descritas no item Ativando autenticação REST em LGX - Comunicação REST.
Com base na configuração acima, as requisições REST REST serão atendidas a partir da seguinte URL URL base: http://localhost:8580/rest 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/