Erencio's Salesforce Toolkit

Uma caixa de ferramentas com diversas funcionalidades para facilitar e otimizar o dia-a-dia de desenvolvedores Salesforce.

ATENÇÃO: Esta extensão ainda não é uma ferramenta comercial. Ela está sendo desenvolvida para meu objetivo pessoal que é aprender a criar extensões no VS Code e uma forma prática de compartilhar algumas facilidades com amigos e colegas. Se o foco mudar, você será comunicado nas notas de versão.

Recursos

Retrieve completo do projeto

Baixe rapidamente todo o conteúdo de uma Org Salesforce para a sua máquina sem se preocupar com tamanho ou número de arquivos recuperados de uma só vez. Apenas autorize a Org desejada e execute o comando RetrieveAllProject.

Gere diagramas de sequência a partir de seus logs

Você já teve que analisar logs para entender as classes e métodos chamadas? Com essa funcionalidade você simplifica isso gerando diagramas de sequência a partir de arquivos de logs e até mesmo de pastas.

Remova informações dos logs para facilitar sua análise

Se você também se incomoda com a quantidade inútil de linhas nos logs, mas não quer ficar toda hora mudando o nível de detalhe da captura de logs nas configurações do Salesforce, isso vai lhe ajudar. Selecione quais informações deseja ver ou ocultar e geramos um arquivo de log limpinho para você, sem mexer no original.

Requisitos

Possuir node e npm em sua máquina é obrigatório para rodar essa extensão. Instale usando as configurações habituais que tudo dará certo.

SyncHelpers — Sincronizar/Implantar com segurança

Incluí um novo grupo de funcionalidades chamado SyncHelpers com duas ações principais:

• Sincronizar com segurança

  • Comando: Erencio SF Toolkit: Sincronizar com segurança (Command Palette)
  • O que faz: cria uma pasta .erencio na raiz do projeto (se não existir), gera/usa manifest/package.xml, faz um retrieve temporário e atualiza a base local .erencio/metadata-[orgAlias].csv com informações de último mtime local.
  • Conflitos: para cada arquivo recuperado, se a cópia local for mais recente, a extensão avisa e oferece opções para Sobrescrever (usar versão remota) ou Manter local.
  • Caso seja possível mapear o arquivo local para um tipo/metadado (ApexClass, ApexTrigger, LWC, Aura, CustomObject, StaticResource, Visualforce Page), a extensão consulta a Metadata API via CLI (comando sfdx force:mdapi:listmetadata) para obter a data exata de lastModifiedDate do servidor e usar essa data na comparação (mais precisa que timestamps de arquivo).

• Implantar com segurança

  • Ação disponível no menu de contexto do Explorer e do Editor: Erencio SF Toolkit: Implantar com segurança.
  • Ao executar sobre um arquivo, a extensão tenta identificar o tipo de metadado e consultar a Metadata API para obter a data/hora de última modificação remota; se a remota for mais recente, exibe aviso com opção de Cancelar ou Sobrescrever.
  • Quando acionado sobre um package.xml, a extensão irá verificar cada member presente e agir de forma equivalente para cada arquivo.

Observação: para que as consultas à Metadata API funcionem, a CLI sfdx (Salesforce CLI) precisa estar instalada e você deve estar autenticado na org (o comando usa o alias da org padrão detectado com sf org list --json). A extensão tem fallback para comparar por timestamps/recuperar arquivos quando a API não puder ser consultada.

Problemas conhecidos

Nosso objetivo é ir resolvendo os problemas a medida que eles forem aparecendo. Quando um problema não tiver sido resolvido a tempo ou a entendermos que a liberação de uma nova funcionalidade é mais importante que a solução de um problema, deixaremos você ciente disso comunicando aqui.

Notas de versão

1.3.0 em 2025-11-06

• Inclusão das funcionalidades SyncHelpers. Com o comando syncSafely você poderá fazer retrieve de seus metadados sem se preocupar com sobrescritas de arquivos locais. A extensão vai lhe avisar quando um arquivo que está sendo baixado possui uma data/hora menor que a que você já possui. E com o comando deploySafely você se certifica que não está sobrescrevendo o código de ninguém na Org.

1.2.0 em 2025-03-08

• Inclusão da funcionalidade QualityAnalyzer. Agora é possível analisar a qualidade de trechos de código, arquivos e até mesmo seu projeto inteiro usando sua própria conta do Github Copilot. Temos um prompt pronto com padrões de arquitetura, boas práticas, e verificações de princípios SOLID, mas você pode criar seus próprios prompts. Em breve disponibilizaremos integração com outras plataformas de IA.

1.1.0 em 2024-01-13

• Inclusão da funcionalidade RetrieveAllProject. Agora é possível baixar todo o projeto de uma Org Salesforce autenticada em sua máquina sem precisar se preocupar em identificá-los no package.xml nem com tamanho ou quantidade de arquivos.

1.0.0 em 2024-12-31

• Lançamento inicial do projeto. Nenhuma nova funcionalidade, por enquanto.