Configurar o Depurador de reprodução do Apex

Nota

Deseja aprender em português (Brasil)? Comece o desafio em um Trailhead Playground de português (Brasil) e use as traduções fornecidas entre parênteses para navegar. Copie e cole somente os valores em inglês porque as validações dos desafios dependem de dados em inglês. Se você não passar no desafio em sua organização de português (Brasil), recomendamos que (1) mude o local para os Estados Unidos, (2) mude o idioma para inglês, seguindo as instruções aqui, e (3) clique novamente no botão “Validar o desafio”.

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

Nesta etapa, você criará um projeto do Salesforce DX com código do Apex para testar e depurar com o Depurador de reprodução do Apex.

Criar um projeto do Salesforce DX

1. No Visual Studio Code, clique no menu View (Exibir) e selecione Command Palette...(Paleta de comandos...). Como alternativa, você pode usar o atalho de teclado Ctrl+Shift+P (Windows ou Linux) ou Cmd+Shift+P (macOS) para abrir a paleta de comandos.
   
2. Digite sfdx create project (sfdx criar projeto) na caixa de pesquisa e escolha SFDX: Create Project (Criar projeto).
   
   
3. Selecione Standard project template (default) (Modelo de projeto padrão (padrão)).
   
4. Insira debugger-project como o nome do projeto.
   
5. Escolha uma pasta onde criar o projeto. Depois de alguns segundos, o Visual Studio Code se recarrega e abre na pasta do seu novo projeto.
   
   
6. Na barra lateral do Explorador, expanda as pastas force-app/main/default/classes. Observe que a pasta está vazia. Vamos mudar isso na próxima seção.
   

Criar uma classe do Apex

1. Na barra lateral do Explorador, clique com o botão direito do mouse na pasta classes e escolha SFDX: Create Apex Class (Criar classe do Apex). Não escolha o comando New File (Novo arquivo), pois ele não vai criar o arquivo .xml de metadados necessário.
   
2. Insira AccountService como nome e aceite o diretório padrão.
   
3. Substitua o conteúdo de AccountService.cls pelo código a seguir. Os bugs 🐞 neste arquivo, se houver, são intencionais. Não os corrija ainda! 😉
   

   public with sharing class AccountService {
     public Account createAccount( String accountName, String accountNumber, String tickerSymbol ) {
       Account newAcct = new Account(
         Name = accountName,
         AccountNumber = accountNumber,
         TickerSymbol = accountNumber
       );
       return newAcct;
     }
   }

4. Salve o arquivo.
   

Destaques do código

• A classe AccountService tem um método: createAccount.
  
• O método cria e retorna uma variável de sObject da conta com os campos de nome, número de conta e símbolo de ticker do mercado de ações atribuídos aos parâmetros do método.
  

Criar um teste do Apex

1. Na barra lateral do Explorador, clique com o botão direito do mouse na pasta classes e escolha SFDX: Create Apex Class (Criar classe do Apex).
   
2. Insira AccountServiceTest como nome.
   
3. Substitua o conteúdo de AccountServiceTest.cls pelo código a seguir.
   

   @IsTest
   private class AccountServiceTest {
     @IsTest
     static void should_create_account() {
       String acctName = 'Salesforce';
       String acctNumber = 'SFDC';
       String tickerSymbol = 'CRM';
       Test.startTest();
         AccountService service = new AccountService();
         Account newAcct = service.createAccount( acctName, acctNumber, tickerSymbol );
         insert newAcct;
       Test.stopTest();
       List<Account> accts = [ SELECT Id, Name, AccountNumber, TickerSymbol FROM Account WHERE Id = :newAcct.Id ];
       Assert.areEqual( 1, accts.size(), 'should have found new account' );
       Assert.areEqual( acctName, accts[0].Name, 'incorrect name' );
       Assert.areEqual( acctNumber, accts[0].AccountNumber, 'incorrect account number' );
       Assert.areEqual( tickerSymbol, accts[0].TickerSymbol, 'incorrect ticker symbol' );
     }
   }

4. Salve o arquivo.
   

Destaques do código

• A classe AccountServiceTest tem um método de teste: should_create_account.
  
• O método de teste cria uma variável de sObject de conta com os valores de campo esperados de nome “Salesforce”, número de conta “SFDC” e símbolo de ticker de mercado de ações “CRM” usando o método AccountService.createAccount.
  
• O método de teste consulta o registro da conta inserido e confirma os valores de campo esperados.
  

Depois de criar essas classes do Apex, sua pasta classes deve conter quatro arquivos: AccountService.cls, AccountServiceTest.cls e seus arquivos de metadados. Se você não vir esses arquivos, verifique se criou os arquivos com o comando SFDX: Create Apex Class (Criar classe do Apex) e não com o comando New File (Novo arquivo).

Autorizar uma organização

Você precisa do nome de usuário e da senha da sua organização prática para autorizá-la com a CLI do Salesforce. Se você está usando um Trailhead Playground, este artigo mostra como encontrar seu nome de usuário e redefinir sua senha.

Em seguida, autorize sua organização prática com a CLI do Salesforce para poder usar a CLI e as Extensões do Salesforce para Visual Studio Code a fim de interagir com sua organização.

1. No Visual Studio Code, clique no menu View (Exibir) e selecione Command Palette...(Paleta de comandos...). Como alternativa, você pode usar o atalho de teclado Ctrl+Shift+P (Windows ou Linux) ou Cmd+Shift+P (macOS) para abrir a paleta de comandos.
   
2. Digite sfdx authorize org (sfdx autorizar organização) na caixa de pesquisa e escolha SFDX: Authorize an Org (Autorizar uma organização).
   
   
3. Escolha uma opção de URL de login. Nas organizações Trailhead Playground, você pode selecionar Project Default (Padrão do projeto) ou Production (Produção).
   
   
4. Insira debuggerOrg como alias da organização.
   
5. Seu navegador abrirá uma página de login do Salesforce. Insira suas credenciais do Trailhead Playground.
   
6. Se for pedida a permissão de acesso, clique em Allow (Permitir).
   
7. Volte para o Visual Studio Code a fim de confirmar a autorização da sua organização do Trailhead Playground. Você deve ver uma saída do tipo Successfully authorized <username> with org ID <orgid> (“Nome de usuário” autorizado com sucesso com ID da organização “orgid”).
   
   

Muito bem. Clique em Verify Step (Verificar etapa) para confirmar se a sua organização prática autorizou a CLI do Salesforce e passe para a próxima etapa a fim de depurar código com o Depurador de reprodução do Apex.

Recursos

• Site externo: Pacote de extensões do Salesforce
• Guia do desenvolvedor do Salesforce DX: Configuração do projeto Salesforce DX
• Site externo: Como depurar no Visual Studio Code