Depuração com WebApp ‐ Configurações

Para configurar uma execução em modo de depuração você pode editar o arquivo launch.json manualmente ou usar o assistente de configuração.

---

Usando o **assistente ** do VsCode:

• Abra a lista de assistentes do VsCode com Ctrl + Shift + P
• Selecione a opção: "Debug: Add Configuration"

• Na lista de opções, selecione: "TOTVS Language Debug via Web App"

---

Para adicionar manualmente, basta copiar o trecho abaixo e colar no arquivo launch.json

Não esqueça de informar corretamente o valor da chave "smartClientUrl" do seu ambiente

**ATENÇÃO**: A URL pode ser informada de 2 formas (Qualquer uma das duas funcionam, fica a seu critério qual das duas formas usar):

1. Usando a porta do próprio WebApp:
Configurar da forma: < Endereço >:< Porta Do WebApp > (Porta configurada na seção [WEBAPP] no arquivo appserver.ini).
Ex:
- Configuração da porta WebApp no appserver.ini:
     [WEBAPP]
     port=8089

- No launch.json, deve-se apontar para a mesma porta :
      "smartclientUrl":"https://localhost:8089"

2. Usando a porta Multiprotocolo:
< Endereço >:< Porta Multiprotocolo >/webapp/. (Atenção na barra (/) após o "webapp")
Ex:
- Configuração da porta Multiprotocolo no appserver.ini : 
     [TCP]
     TYPE=TCPIP
     Port=5556

- No launch.json :
     "smartclientUrl":"https://localhost:5556/webapp/"

Arquivo launch.json:

    {
        "type": "totvs_language_web_debug",
        "request": "launch",
        "name": "Totvs Language Debug",
        "program": "${command:AskForProgramName}",
        "programArguments": "${command:AskForProgramArguments}",
        "cwb": "${workspaceFolder}",
        "smartclientUrl": "https://localhost:8089"
    }

---

IMPORTANTE: Configure também, no arquivo settings.json o caminho do executável do navegador, conforme o exemplo abaixo:

Arquivo settings.json:

{
    ...
    "totvsLanguageServer.web.navigator": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
    ...
}

---

Em uma definição de um executor de depuração, você pode utilizar diretivas que agilizam o seu dia a dia. O TDS-vscode, implementa as diretivas:

• ${command:AskForProgramName}, solicitará o nome do programa a ser executado e seu uso é recomendado na propriedade program, quando o programa/função a ser executado variar a cada execução. Será mantido uma lista das execução para posterior seleção.
• ${command:AskForProgramArguments}, solicitará a lista de parâmetros a serem repassados ao programa a ser executado e seu uso é recomendado na propriedade programArguments, quando os parâmetros variar a cada execução. Será mantido uma lista das execução para posterior seleção. Formatos da lista:
  1. SmartClient, precedidos da chave -A, p.e. -a=10 -a="p1"
  2. TDS (eclipse), separados por espaços, p.e. 10 "p1"
  3. Função, separados por vírgula, p.e. (10,"p1")

A lista de parâmetros poderá ser informada junto com o programa/função a ser executada e pode ser utilizado qualquer um dos formatos descritos na diretiva ${command:AskForProgramArguments}.