Gerenciador de Ambientes

A partir da release 0.12.0 a extensão possui um novo recurso que dará mais acessibilidade e melhor experiência para o usuário.

Agora é possível Gerenciar de forma intuitiva todos os ambientes já configurados e até mesmo os novos que forem sendo criados:

A visão Gerenciador de Ambientes ficará disponível assim que a extensão AdvPL for iniciada, e está localizada dentro da visão principal Explorer, abaixo da listagem dos arquivos do Workspace.

Atenção! O uso dessa visão não impacta na performance do VsCode nem mesmo muda o funcionamento da Extensão. Apenas permite que as configurações sejam gerenciadas de forma intuitiva.

Funcionalidades implementadas:

Funcionalidade	Nível de Exibição	Condição
Importar todos os ambientes configurados no AppServer	Serviço	Somente quando o mesmo estiver conectado
Aplicar Patch (PTM)	Ambiente	Somente quando o mesmo estiver conectado
Desfragmentar	Ambiente	Somente quando o mesmo estiver conectado
Listar Funções compiladas	Ambiente	Somente quando o mesmo estiver conectado
Listar Objetos compilados	Ambiente	Somente quando o mesmo estiver conectado
Alterar Senha	Ambiente	-
Conectar	Ambiente	Somente quando o mesmo não estiver conectado
Deletar	Ambiente	Somente quando o mesmo não estiver conectado
Renomear	Todos	-
Adicionar ambiente via Wizzard	Barra de Título	-
Recolher tudo	Barra de Título	-

---

Informações gerais:

Importar Ambientes

• Para importar os ambientes de um serviço, é necessário que pelo menos um ambiente válido esteja configurado e conectado;

• A opção importar todos os ambientes é um dos melhores recursos do Gerenciador de Ambientes. Ao clicar nesta opção a extensão irá buscar todos os ambientes (RPO) configurados no AppServer que está conectado (por isso só funciona em serviços conectados), e irá adicionar automaticamente nas configurações do VsCode todos os ambientes que ainda não estão configurados, considerando as configurações do primeiro ambiente relacionado ao serviço base (usuário, senha, SmartClient path, Include path, ...);

• É recomendado renomear os ambientes que foram importados para evitar conflitos com outros Environments (Ambientes, RPO) com o mesmo nome.

Importante! Se você não utiliza Workspace ou suas configurações de ambientes não estão definidas nas Configurações do Workspace, a extensão irá fazer uma cópia para as configurações do Workspace e o VsCode por padrão priorizará as configurações do Workspace.

Renomear

• Caso o ambiente a renomear já esteja conectado, a extensão irá reconectar neste novo ambiente;
• Se for renomeado um Ambiente, será alterado/adicionado nas configurações do ambiente a propriedade name filha de advpl.environments;
• Se for renomeado um Serviço ou Servidor, será manipulado a configuração advpl.dictionary da seguinte forma:
  • parent: Endereço IP do Servidor relacionado ao Serviço (caso seja omitido, a legenda servirá para todos os atributos com mesmo nome);
  • name: Caso a configuração seja para Servidor: Usar o endereço IP, caso seja para serviço: Usar a Porta do Serviço;
  • label: Label a ser apresentado para o elemento name no Gerenciador de Ambientes;
• Ao renomear um item, a extensão irá apresentar como valor Default a descrição atual, faciliatando assim a renomeação;

Importante! Não é permitido mais de um ambiente com o mesmo atributo name, por mais que hajam validações no Wizzard de ambientes, se este cenário existir nas configurações poderão ocorrer conflitos e instabilidades em diversos recursos da Extensão.

Adicionar ambiente via Wizzard

Na barra de título da View de Gerenciamento de Ambientes há um ícone + Este chamará o assistente para criação de Ambientes. Para mais informações, consulte a Wiki a seguir: https://github.com/totvs/advpl-vscode/wiki/Cria%C3%A7%C3%A3o-de-ambiente-facilitada

Desabilitar o Gerenciador (View)

Se você deseja desabilitar o Gerenciador de Ambientes :( basta que na barra de título da Visão você clique com botão direito do mouse, depois esconda a View.

Atenção! O uso dessa visão não impacta na performance do VsCode nem mesmo muda o funcionamento da Extensão. Apenas permite que as configurações sejam gerenciadas de forma intuitiva