Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>Protheus for VS CodeNew to Visual Studio Code? Get it now.
Protheus for VS Code

Protheus for VS Code

Guilherme de Sordi

|
3 installs
| (0) | Free
Manage Protheus environments, artifacts, databases, RPOs and error logs directly from VS Code.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Protheus no VSCode

Extensão que permite configurar ambientes Protheus diretamente pelo VSCode com apenas um click.

Pré-requisitos

  1. VSCode 1.103.0 (julho/2025) ou superior
  2. SQL Server 2022 Developer
    1. Autenticação do Windows habilitada (padrão)
    2. Procolo Shared Memory habilitado (padrão)
  3. Conexão com a VPN

O SQL Server não pode ter um alias chamado "localhost" forçando o uso do protocolo TCP/IP

Gestão de ambientes

Releases

  1. 12.1.2310
  2. 12.1.2410
  3. 12.1.2510
  4. 12.1.2610

Tipos de ambiente

  1. Desenvolvimento
  2. Desenvolvimento + Automação
  3. Expedição contínua

Tipo de ambiente x artefatos

Artefato Desenvolvimento Desenvolvimento + Automação Expedição contínua
D-1 Automação (D-1) Published
Latest Latest Published
EXP_COM_DIC EXP_COM_DIC MNT_COM_DIC
- - Published
Sim - Sim

Pacote LIB e Pacote ADVPR → Os pacotes são aplicados automaticamente ao instalar/atualizar o ambiente

RPO Automação (D-1) → Refere-se ao RPO D-1 disponibilizado pelo time automação no Arte que já tem todas as suites do ADVPR compiladas

Processo

Ao criar um ambiente a extensão vai:

  • Criar toda a estrutura de pastas necessária
  • Baixar, instalar e configurar o DBAccess
  • Baixar e instalar driver ODBC
  • Configurar ODBC
  • Criar banco de dados e restaurar backup da base congelada
  • Baixar e instalar appserver, webapp, RPO
  • Configurar arquivo INI com porta multiprotocolo, REST etc.
    • Se o arquivo INI já existe, ele não é alterado
  • Baixar e aplicar pacote da LIB (conforme tipo de ambiente)
  • Baixar e aplicar pacote ADVPR (conforme tipo de ambiente)
  • Adicionar novo ambiente à extensão TDS
    • Replicar os includes do último ambiente criado

Observações

Na criação do primeiro ambiente Protheus:

  • Será instalado o driver "SQL Server ODBC Driver 17" para a comunicação do DBAccess com o SQL Server
  • Será instalado o módulo SqlServer do Powershell para execução de scripts no SQL Server 2022
  • Será instalada a stored procedure sp_Kill, responsável por encerrar todas as conexões abertas com determinado o banco de dados (que poderá ser usada nos comandos de restauração de backup do banco de dados, por exemplo)

Recursos

  • Gestão de ambientes

    • Adicionar e remover ambientes Protheus
    • Iniciar, reiniciar, parar o ambiente (usando o terminal integrado do VSCode)
    • Restaurar backup da base congelada
    • Abrir arquivos appserver.ini e console.log
    • Limpar o arquivo console.log de ambientes parados
    • Ativar e desativar REST
    • Listar e alterar portas de ambientes parados
    • Mudar o License Server de todos os ambientes locais
    • Atualização do DBAccess
    • Atualização do Protheus
      • Atualização de todos os artefatos
      • Atualização do RPO
      • Atualização da base congelada
      • Atualização de metadata (UPDDISTR)
    • Abrir WebApp no navegador
    • Abrir launcher/SIGAMDI usando a porta multiprotocolo do appserver.ini
  • Gestão de backups

    • Fazer backup, restaurar backup, excluir backup
    • Exportar banco de dados para arquivo .bak
    • Importar banco de dados a partir de arquivo .bak ou .mdf
  • Gestão de RPO

    • Criar, restaurar e excluir backups de RPO
    • Exportar e importar RPOs em ambientes locais e em containers
  • Aplicação de pacote

    • Download do arte e aplicação do pacote
      • Roda o UPDISTR se o pacote incluir atualização de dicionário de dados
      • Recurso útil para aplicação do pacote da expedição contínua ou Lib mais recentes com um click
  • Atualização de dicionário

    • Roda o UPDDIST com qualquer arquivo sdfbra.txt selecionado, pelo próprio VSCode
  • Monitor de Erros

    • Lê ocorrências de THREAD ERROR nos arquivos console.log
    • Agrupa erros por ambiente
    • Permite atualizar a leitura dos logs
    • Permite ocultar erros individuais ou todos os erros listados
    • Permite limpar o console.log de todos os ambientes parados
  • Integração e manutenção

    • Atualização do catálogo de artefatos sob demanda
    • Verificação de comunicação com a API
    • Envio de relatório de diagnóstico
    • Sincronização de métricas
    • Atualização automática da extensão

Recursos experimentais

Os recursos experimentais ficam ocultos por padrão e podem ser habilitados pela configuração protheusvscode.experimentalFeatures.

  • Criação de ambiente Protheus em containers com Docker ou Podman
  • Seleção do runtime de containers pela configuração protheusvscode.containerRuntime
  • Seleção de release e uso de RPO local na criação do ambiente
  • Iniciar, parar, reiniciar e remover ambientes com container
  • Ativar e desativar REST
  • Abrir console.log, appserver.ini e compose.yaml
  • Mostrar o terminal do ambiente com container
  • Preservar alterações manuais no compose.yaml ao iniciar ou reiniciar o ambiente

Esta extensão foi criada como um projeto pessoal. Não tem nenhum vínculo direto ou indireto com a TOTVS®, qualquer uma de suas franquias ou qualquer um de seus representantes.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2026 Microsoft