Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Composition Setup
import.css=/download/attachments/6062824/tecnologia.css
Portuguese


Configurando o Application Server

...

para

...

uso do SmartClient

...

WebApp

Utilizando o WebApp, o Application Server

...

passa a responder nativamente como um

...

A seguir demonstraremos a configuração, de fato muito simples, deste ambiente.

Requisitos

Servidor Web, permitindo uso dos ERP TOTVS (Protheus/Logix) a partir dos navegadores homologados, em um ambiente seguro e escalável, sendo uma excelente opção para instalações em ambiente Cloud.


Nota
titleBalanceamento de carga 

📢  O Broker é o responsável pelo balanceamento de carga para o WebApp, mais informações acesse aqui:
📢  Entenda também sobre o Limite de conexões por browser, uma proteção dos navegadores que limita o numero de conexões abertas com o AppServer.

Requisitos

  • Ambiente

...

  • ERP TOTVS previamente configurado;

...

  • Copie o arquivo webapp.dll (

...

  • para AppServer Windows) ou webapp.so (

...

  • Linux) para a raiz da pasta onde esta instalado seu AppServer;
  • Para baixar os arquivos webapp.dll ou webapp.so acesse a seção Downloads no Portal de Clientes, e pesquise por webapp.

Image Added

Clique na imagem para visualização full.

Editando o arquivo de configuração do Application Server

...

O Administrador do ambiente

...

deve editar o arquivo de configuração appserver.ini.


Importante:

Cross-origin resource sharing (CORS) (ou compartilhamento de recursos de origem cruzada), é a especificação de segurança implementada pelos browsers e que define meios pelo qual um navegador e um servidor web podem interagir para determinar se permiti ou não que seus recursos sejam acessados por uma página web de um domínio diferente.

Portuguese

Após a A configuração do arquivo será necessário reiniciar o Application Server para que a camada Web seja devidamente inicializada.

1 - Porta para o acesso HTTP

Indica a porta da onde o servidor ira disponibilizar o acesso ao SmartClient HTML.

Bloco de código
[WEBAPP]
port=8080

2 - Configuração do ambiente HTTPS (camada de segurança)

Caso o cliente opte por utilizar conexões HTTP seguras, é necessário a configuração dos certificados.

Para isso indique o método que será usado e o caminho para o arquivo de certificado e chave.

básica do WebApp exige apenas definir a porta de acesso, como no exemplo abaixo:
Para conhecer todas as configurações, consulte seção [Webapp]

code
Bloco de código
themeRDark
titleExemplo
[WEBAPP]
portPort=8080
ssl_method=SSL/TLS
ssl_certificate=C:\TOTVS\certificate.pem
ssl_key=C:\TOTVS\certificate.key

3 - Configuração para descriptografar o protocolo

Caso o cliente opte por descriptografar o protocolo (necessário para emulação de carga do sistema), é necessário desabilitar a chave obfuscate_protocol.

Bloco de código
[webapp]
obfuscate_protocol = 0

(aviso) Ao efetuar essa configuração, os dados trafegados são passíveis de leitura (sniffing)

4 - Configuração para controle de acesso HTTP (CORS)

Caso o cliente opte por permitir que o Smartclient HTML seja acessado por um domínio diferente, é necessário informar a chave httpheaders_options.

Essa chave deve ser informada em formato JSON.

Quando não for definida esta chave, o Smartclient HTML só será acessado por páginas web do mesmo domínio (default).

Para especificar um domínio diferente, a chave httpheaders_options deve conter a informação "Access-Control-Allow-Origin".

  • httpheaders_options = {"Access-Control-Allow-Origin": "*"}, o Smartclient HTML será acessado por páginas web de qualquer domínio.
  • httpheaders_options = {"Access-Control-Allow-Origin": "http://exemplo.com"}, o Smartclient HTML será acessado por páginas web do mesmo domínio e por páginas do domínio http://exemplo.com.
Bloco de código
[webapp]
httpheaders_options = {"Access-Control-Allow-Origin": "http://exemplo.com"}
Nota
8089


🚨 Importante:
Após a configuração deve-se reiniciar o/s AppServer/s.

SmartClient WebApp em uso

Tela de Parâmetros do Smartclient WebApp

Ao exibir a Tela de Parâmetros, o ambiente estará devidamente configurado.

Nota
titleImportante
|📢  Caso esteja utilizando a porta Multiprotocolo o acesso ao webapp deve ser feito por ela e para identificar o serviço, adicionar /webapp ao final da URL. Por exemplo https://localhost:1234/webapp

Image Added

Tela de login do Smartclient HTML (tradicional)

Image Added

Tela de login do Smartclient HTML (PO-UI)

Image Added


Nota
titleBalanceamento de carga 
Para mais opções de cabeçalho HTTP, consultar https://www.w3.org/TR/cors/

5 - Configuração para listar os últimos parâmetros iniciais executados em TOTVS|SmartClient HTML

Caso o cliente opte em listar os últimos parâmetros iniciais executados em TOTVS|SmartClient HTML, é necessário habilitar as chaves "LASTMAINPROG" e "ENVSERVER".
Quando não for atribuido valores as chaves, serão carregados os valores (default) dos parâmentros.

Bloco de código
[webapp]
LASTMAINPROG = SIGAADV,SIGAFIN,SIGAEST
ENVSERVER	 = MSSQLP11,MSSQLP12,MSSQLTST

6 - Configuração para carregar os parâmetros de linha em modo implícito

Caso o cliente opte em listar os parâmetros de linha de modo oculto( implícito ), é necessário habilitar a chave "HideParamsForm", se executado simultaneamente com modo "explícito" a prioridade sera ele, ou seja, a aplicação ignora o modo implícito.

O programa e ambiente a ser executado será sempre o primeiro da lista dos parâmetros "LASTMAINPROG" e "ENVSERVER".

Segue exemplo dos programas a ser executado de acordo com o bloco de código a baixo:

  • SIGAADV - Programa Inicial
  • MSSQLP11 - Ambiente no Servidor
Bloco de código
[webapp]
HideParamsForm 	= 1
LASTMAINPROG 	= SIGAADV,SIGAFIN,SIGAEST
ENVSERVER	 	= MSSQLP11,MSSQLP12,MSSQLTST

Tela de parâmetros do Smartclient HTML

Ao exibir corretamente a página de parâmetros, o ambiente já estará devidamente configurado.

Image Removed

Tela de login do Smartclient HTML

Image Removed📢  O Broker é o responsável pelo balanceamento de carga para o WebApp, mais informações acesse aqui:
📢  Entenda também sobre o Limite de conexões por browser, uma proteção dos navegadores que limita o numero de conexões abertas com o AppServer.