Usar o Visual Studio Code para desenvolvimento do Salesforce

Nota

Deseja aprender em português (Brasil)? Nesse emblema, as validações dos desafios práticos do Trailhead funcionam em inglês. As traduções são fornecidas entre parênteses como referência No Trailhead Playground, (1) mude a localidade para Estados Unidos, (2) mude o idioma para inglês e (3) copie e cole apenas os valores em inglês. Siga as instruções aqui.

Consulte o emblema Trailhead no seu idioma para saber mais sobre como aproveitar a experiência de Trailhead em outros idiomas.

Acompanhar com o Trail Together

Deseja acompanhar um instrutor enquanto trabalha nesta etapa? Veja este vídeo que faz parte da série Trail Together no Trailhead Live.

(Este clipe começa na marca dos 19:41 minutos, caso você queira retroceder e ver o início da etapa novamente.)

Terminal vs. paleta de comandos

Assim como com qualquer boa ferramenta de desenvolvimento, há mais de uma maneira de fazer as coisas com o Visual Studio Code. As duas maneiras principais de interagir com a CLI do Salesforce são por meio do terminal integrado ou da janela de abertura rápida.

Para exibir a janela de abertura rápida, pressione Ctrl+P no Windows ou Cmd+P no macOS. Se você digitar ?, poderá visualizar o menu de ajuda. Neste módulo, usaremos a janela de abertura rápida no modo de paleta de comandos, o que nos permite mostrar e executar comandos.

A exibição dos comandos globais na janela de abertura rápida com? no campo.

Criar um projeto

Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
Certifique-se de que o novo prompt começa com >.
Digite SFDX:Create Project (SFDX: Criar projeto).
Selecione SFDX: Create Project.
Selecione Standard (Padrão).
Digite o nome do projeto VSCodeQuickstart e pressione Enter.
Selecione sua área de trabalho como o lugar para criar o projeto a fim de facilitar sua localização mais tarde.
Aguarde a abertura da nova janela do Visual Studio Code. Você deve ver uma indicação de que a extensão está preparando seu projeto antes de preencher o explorador de arquivos.

Pesquisar seus arquivos

Pressione Ctrl+P no Windows ou Cmd+P no macOS para abrir a paleta de comandos. Isso muda o foco para a pesquisa de arquivos.
Digite project-scratch-def.json no campo.
Clique no resultado para abrir o arquivo.
Clique no menu Search (Pesquisa) ().
Pesquise orgName.
No primeiro resultado encontrado em project-scratch-def.json.
Altere o valor de orgName (após : e entre as “”) para Learning VS Code.
Salve o arquivo pressionando Ctrl+S no Windows ou Cmd+S no macOS.

Autenticar em seu Playground

Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
Digite SFDX:Authorize an Org (SFDX: Autorizar uma organização).
Selecione SFDX: Authorize an Org.
Para aceitar a URL de login padrão, pressione Enter.
Insira o alias VSCodePlayground.
Observe que seu navegador padrão abre uma nova janela de login do Salesforce. Faça login em seu Playground usando o usuário e a senha do Playground recuperados na última etapa.
Quando o acesso ao aplicativo conectado for solicitado, clique em Allow (Permitir).
Feche a janela do navegador.
A janela do terminal da linha de comando retorna uma mensagem de sucesso quando a transação é concluída.

Criar uma classe do Apex

Clique no menu Explorer (Explorador) ().
No diretório VSCODEQUICKSTART, clique em force-app para mostrar a árvore de pastas. No diretório force-app/main/default, você encontra os metadados incluídos no projeto, como aplicativos, aura, classes e muito mais.
Clique com o botão direito do mouse na pasta classes .
Selecione SFDX: Create Apex Class.
Insira o nome AccountController.
Se o VS Code perguntar, selecione force-app/main/default/classes como o diretório ao qual você deseja adicionar AccountController.cls.

No arquivo AccountController.cls recém-aberto, substitua o código padrão pelo seguinte:

public with sharing class AccountController {
  public static List<Account> getAllActiveAccounts() {
    return [SELECT Id, Name, Active__c FROM Account WHERE Active__c = 'Yes' WITH SECURITY_ENFORCED];
  }
}

Salve o arquivo.

Consulta

Nossa nova classe do Apex tem um consulta SOQL nela, mas queremos ter certeza de que ela funciona como previsto antes de implantá-la em nossa organização. Usamos a paleta de comandos para executar a consulta em relação à nossa organização.

Na linha 3 do código, destaque a consulta SELECT Id,Name,Active__c FROM Account WHERE Active__c = 'Yes' (não destaque usando WITH SECURITY_ENFORCED)
Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
Digite SOQL.
Selecione SFDX:Execute SOQL Query with Currently Selected Text (Consulta SFDX:Execute SOQL com texto selecionado atualmente).
Selecione API REST e pressione Enter.
Na guia Output (Saída) da janela do terminal integrado, visualize os resultados de sua consulta. A janela deve conter um resumo que diz: SFDX: Execute SOQL Query ... ended with exit code 0. Isso significa que ela foi executada com êxito.

Implantar

A última etapa é implantar seu código no seu Playground usando o Visual Studio Code.

Clique com o botão direito do mouse na pasta classes .
Clique em SFDX: Deploy Source to Org.
Na guia Output (Saída) do terminal integrado, exiba os resultados de sua implantação. Você também deve ter recebido um aviso que diz: SFDX: Deploy Source to Org ... ended with exit code 0. Isso significa que ela foi executada com êxito.

Últimas colocações

Você aprendeu a usar o Visual Studio Code e as Extensões do Salesforce. Viu como os recursos de um IDE podem ajudar a maximizar a eficiência de seu desenvolvimento. Agora, você está pronto para explorar alguns tópicos mais complexos, como a depuração com o Depurador de repetição do Apex, a personalização do seu editor para atender às suas necessidades e a execução de seus pipelines de desenvolvedor com o Visual Studio Code.