Configuração

Para utilizar a extensão é necessário a configuração de algumas chaves. Essas chaves podem estar tanto na WorkSpace Settings ou na User Settings

Atenção! A partir da versão 0.4.0, as configurações de ambientes devem ser feitas com o array advpl.environments

• advpl.serverVersion.": Versão do server - Atualmente suporta apenas o 131227A
• advpl.server: Server IP, Padrão: localhost
• advpl.port : Porta do servidor
• advpl.environment: Nome do ambiente que será feito o debug e a compilação
• advpl.user: Nome do usuário para se conectar no Protheus, se não informado utiliza "Admin"
• advpl.passwordCipher : Senha criptografada do usuário de login no Protheus, para gerá-la utilize o comando CipherPassword
• advpl.includeList: Lista de diretórios separado por ponto-e-vírugla. Exemplo: C:\\Protheus\\include\\;C:\\Protheus\\include_2\\
• advpl.language: Língua do repositório, se não informado será português, valores permitidos: PORTUGUESE, ENGLISH, SPANISH
• advpl.rpoType: Tipo do RPO, se não informado será "TOP", valores permitidos: TOP, CTREE, DBF

Atenção! Nova configuração de ambiente advpl.environments : Array com os ambientes configurados

Cada ambiente deve especificar:

• environment: Nome do ambiente que será feito o debug e a compilação
• serverVersion.": Versão do server - Atualmente suporta o 131227A e o 170117A.
• server: Server IP, Padrão: localhost
• port : Porta do servidor
• user: Nome do usuário para se conectar no Protheus, se não informado utiliza "Admin"
• passwordCipher : Senha criptografada do usuário de login no Protheus, para gerá-la utilize o comando CipherPassword
• includeList: Lista de diretórios separado por ponto-e-vírugla. Exemplo: C:\\Protheus\\include\\;C:\\Protheus\\include_2\\
• language: Língua do repositório, se não informado será português, valores permitidos: PORTUGUESE, ENGLISH, SPANISH
• rpoType: Tipo do RPO, se não informado será "TOP", valores permitidos: TOP, CTREE, DBF

• advpl.selectedEnvironment Ambiente atualmente selecionado

• advpl.startProgram: Módulo ou função que será sugerido no launch do Debug

• compileFolderRegex: Regex que ira validar se na compilação de folders, o arquivo irá ser compilado ou não.

Compilação

• advpl.compile_force_recompile : Caso esteja como true, força recompilar os fontes mesmo que não tiveram alteração.

As variáveis abaixo devem ser preenchidas caso você tenha uma senha de compilação. Caso você deseje pegar o ID utilizado pelo VSCODE para gerar uma nova chave, veja o comando getAuthorizationId

• advpl.authorization_generation: Data de geração da chave no formato yyyyMMdd
• advpl.authorization_validation: Data de validade da chave no formato yyyyMMdd
• advpl.authorization_permission: 1 - Para permitir substituir fontes TOTVS, 0 - para não pemitir
• advpl.authorization_code: Chave de Autorização

Configuração de Encode dos arquivos.

O Visual Code padrão utiliza utf8 como encode dos arquivos abertos. O TDS utiliza como padrão o windows1252, caso você utilize fontes nos dois ambientes é recomendando mudar o encode do utf8 para windows1252.

Para proceder isso vá em Files -> Preferences -> WorkSpace Será aberto na direta os valores default, e na esquerda os seus valores.

{ "files.encoding": "windows1252" }

#Comandos adicionados ao visual code

##Gerar senha de acesso ao um ambiente.

Para gerar uma chave devemos usar o VS Code Quick Open (atalho Ctrl + P) e digitar:

>cipher Será apresentado um inputbox para digitar a senha. Ao confirmar o VsCode ira apresentar a senha criptografada. que deve ser colocada no advpl.passwordCipher.

##Pegando o código de liberação autorização TOTVS Caso você utilize liberação de compilação e necessite de uma para o VS code, abra o VS Code Quick Open (atalho Ctrl + P),e digitar:

>Código Autorização para ser solicitada pela Totvs

Ao começar a digitar o comando o VS code ira já sugerir as correspondências, não sendo necessário digitar o comando inteiro.

Exemplo de arquivo de configuração:

{
 "advpl.environments":[{
 "smartClientPath": "C:\\binarios\\P12\\last_tfs\\smartclient\\",
 "environment": "fluig",
 "includeList": "D:\\LIB120\\INCLUDE\\;D:\\LIB120\\INCLUDE-LIB\\",
 "server": "localhost",
 "port": "1201",
 "user": "Admin",
 "passwordCipher": " TDBXQzYWZoTm92NTlmTFFKbi9DTzROVjY5Q0FUVmFlb1JNN28="

},{

 "smartClientPath": "C:\\binarios\\P12\\last_tfs\\smartclient\\",
 "environment": "amb1",
 "includeList": "D:\\TOTVS\\LIB110\\INCLUDE\\;D:\\TOTVS\\LIB110\\INCLUDE-LIB\\",
 "server": "localhost",
 "port": "1101",
 "user": "Admin",
  "passwordCipher": "elhlY3FxQTJKNTZDR0xiK2VWa1ZrbVRGaDhVWXFrTjYvM2JiUnc="

}],

    //Chave
    "advpl.authorization_generation": "20160831",

    // Data de validade da chave no formato yyyymmdd
    "advpl.authorization_validation": "20161129",

    // 1 - Para permitir substiuir fontes TOTVS, 0 para Não
    "advpl.authorization_permission": "1",

    // Chave de compilação
    "advpl.authorization_code": "013SPL032RFRR74F1E7671310",   
    
}

Selecionando o Ambiente em execução

Após configurar os ambientes, no canto inferior direito, do lado do esquilo é possível visualizar o ambiente corrente. Caso queira muda-lo basta clicar sobre a barra , será apresentando uma lista de ambientes configurados.