Utilizando WebAPP

O que é?

O WEBAPP é o suporte nativo do appserver para servir um smartclient HTML sem a necessidade de fazer instalações de outras coisas no ambiente. Para informação detalhadas como habilitar o WebApp no seu server visite o TDN em:

https://tdn.totvs.com/display/tec/WebApp+-+Configurando+nativamente+o+Application+Server+como+servidor+Web

Debugando ou Executando via VSCODE.

Uma vez o WebAppconfigurado com o link acima, podemos configurar a extensão para ao dar F5 debugar abrindo esse smartclient.

Para tanto, precisamos configurar 2 parâmetros no launch json: "webapp" como true, "webappUrl" com a url que responde o WebApp.

Exemplo de launch para web:

{
    "name": "Advpl WEB",
    "type": "advpl",
    "request": "launch",
    "args": [],
    "cwd": "",
    "programRun": "${command:AskForProgramName}",
    "stopOnEntry": false,
    "enviromentInfo": "${command:GetEnvInfos}",
    "workspace": "${workspaceFolder}/",
    "webapp": true,
    "webappUrl": "http://localhost:1234/webapp"
}

Também é necessário definir na configuração do ambiente a porta do serviço do WebApp:

{ 
...
"webappPort": "8486"
}

Obs.: Em ambientes com Porta Multi Protocolo e APP_ENVIRONMENT ativos, o comportamento do WebApp muda, não funcionando mais o acesso pela porta do WebApp, e sim pela porta MPP com path /webapp na URL. Defina corretamente no parâmetro webappUrl.

A partir da versão 0.17.0 a URL do debug não será mais montada com base na configuração webappPort, e sim pela webappUrl no launch, permitindo assim definir outras necessidades com debug via WebApp como: protocolo (HTTP/HTTPS), server/dns e porta (Multi protocolo ou WebApp) além do path do WebApp (a chave ainda precisa existir no ambiente).