4. Migrando do SmartClient Desktop para o WebApp

O SmartClient Desktop é uma aplicação C++ monolítica (independente) e apresenta caracteristicas diferentes em relação ao WebApp, que é executado a partir de um navegador.

Os navegadores acabam impondo algumas mudanças de comportamento ao WebApp, por consequencia, ao uso do ERP, que descrevemos neste documento para apoiar durante sua migração.

Ao utilizar o TWebEngine (iframe), não é possivel executar o método navigate para a página https://www.google.com/

A maioria dos site, incluido do google, impede seu uso através de um iframe por questões de segurança, não existe contorno para essa questão, porem pode ser utilizada a função ShellExecute para exibir a página em um navegador apartado do WebApp, mais informações no link: TWebEngine:Navigate

Ao utilizar o TWebEngine (iframe), não é possivel executar o método navigate para um arquivo local, exemplo: file:///dir/arquivo

Esta também é uma medida de segurança dos navegadores, como contorno, recomendamos copiar o arquivo em questão para uma pasta temporária no Servidor através da função CpyF2Web, acessando este arquivo na sequencia, mais informações no link: TWebEngine:Navigate

A importância do WebAgent para a integração com a estação de trabalho

O navegador não permite que você acesse arquivos locais, mais uma vez, por questões de segurança.

Isso implica no bloqueio de funções importantes ao ERP, como por exemplo, a FCREATE(), para criar um arquivo, ou mesmo a integração com o Excel.

O WebAgent é um serviço seguro, que permite esses acessos bloqueados pelos navegadores, mais informações no link: 2. WebApp - WebAgent

Passagem de parâmetros na abertura do ERP através do navegador

O SmartClient desktop permite a passagem de parâmetros na abertura do ERP, o WebApp também, utilizando, por exemplo, na URL de seu navegador o link:

http://10.173.9.215:5011?E=ambiente&P=SIGAFAT&A=param1&A=param2&A=param3

Passagem de parâmetros na abertura do ERP através do WebAgent (parâmetro launch)

É possivel também executar o WebAgent passando parâmetros de abertura, uma caracteristica importante caso queira automatizar algum processo customizado, sem precisar utilizar seu navegador para isso.

Exemplo:

C:\Users\Administrator\AppData\Local\Programs\web-agent\web-agent.exe launch "http://10.173.9.215:5011?E=ambiente&P=SIGAFAT&A=param1&A=param2&A=param3" --browser="C:\Program Files\Google\Chrome\Application\chrome.exe"

Mais informações no link: 2. WebApp - WebAgent#2.WebAppWebAgent-Launch

Execução de rotina sem interface através do WebAgent (parâmetro launch com --headless)

Existem algumas rotinas de processamento que não necessitam de interface (tela), é possivel executar essas rotinas utilizando em conjunto os parâmetros launch e --headless.