Configurar Apex Replay Debugger

Nota

¿Su idioma de aprendizaje es español? Comience el reto en un Trailhead Playground en español y utilice las traducciones proporcionadas entre paréntesis para navegar. Copie y pegue solo los valores en inglés, ya que las validaciones del reto se basan en los datos en inglés. Si no aprueba el reto en su organización en español, le recomendamos que (1) cambie la configuración regional a Estados Unidos, (2) cambie el idioma a inglés, siga las instrucciones descritas aquí y, a continuación, (3) vuelva a hacer clic en el botón Check Challenge (Comprobar el reto).

Consulte la insignia Trailhead en su idioma para obtener más información sobre cómo aprovechar la experiencia de Trailhead en otros idiomas.

En este paso, va a crear un proyecto de Salesforce DX con código Apex para realizar pruebas y depurar con Apex Replay Debugger.

Crear un proyecto de Salesforce DX

1. En Visual Studio Code, haga clic en el menú View (Ver) y luego seleccione Command Palette (Paleta de comandos). También puede usar el acceso directo del teclado Ctrl+Mayús+P (en Windows o Linux) o Comando+Mayús+P (en macOS) para abrir la paleta de comandos.
   
2. Escriba sfdx create project en el cuadro de búsqueda y luego seleccione SFDX: Create Project (SFDX: Crear proyecto).
   
   
3. Seleccione Standard project template (default) [Plantilla de proyecto estándar (predeterminada)].
   
4. Escriba debugger-project como nombre de proyecto.
   
5. Elija una carpeta para crear el proyecto. Después de unos segundos, Visual Studio Code se vuelve a cargar y se abre en la carpeta del nuevo proyecto.
   
   
6. En la barra lateral Explorer (Explorador), expanda las carpetas force-app/main/default/classes. Observe que la carpeta está vacía. Lo cambiaremos en la próxima sección.
   

Crear una clase de Apex

1. En la barra lateral Explorer (Explorador), haga clic con el botón derecho en la carpeta classes y seleccione SFDX: Create Apex Class (SFDX: Crear una clase de Apex). No elija el comando New File (Nuevo archivo), ya que así no se creará el archivo .xml de metadatos necesario.
   
2. Introduzca AccountService como nombre y acepte el directorio predeterminado.
   
3. Sustituya el contenido de AccountService.cls por el siguiente código. Los errores 🐞 de este archivo son intencionales, así que no los arregle todavía. 😉
   

   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;
     }
   }

   Copy
4. Guarde el archivo.
   

Aspectos destacados del código

• La clase AccountService tiene un método: createAccount.
  
• Este método permite crear y devolver una variable sObject de cuenta con sus campos de nombre, número de la cuenta y símbolo de teletipo bursátil asignados a los parámetros del método.
  

Crear una prueba de Apex

1. En la barra lateral Explorer (Explorador), haga clic con el botón derecho en la carpeta classes y seleccione SFDX: Create Apex Class (SFDX: Crear una clase de Apex).
   
2. Escriba AccountServiceTest como nombre.
   
3. Sustituya el contenido de AccountServiceTest.cls por el siguiente código.
   

   @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' );
     }
   }

   Copy
4. Guarde el archivo.
   

Aspectos destacados del código

• La clase AccountServiceTest tiene un método de pruebas: should_create_account.
  
• Este método de pruebas crea una variable sObject de cuenta con los valores de campo esperados de un nombre de "Salesforce", un número de cuenta de "SFDC" y un símbolo de teletipo de bolsa de "CRM", todo ello con el método AccountService.createAccount.
  
• Este método de prueba consulta el registro de cuenta insertado y confirma los valores de campos esperados.
  

Después de crear estas clases de Apex, la carpeta classes debería contener cuatro archivos: AccountService.cls, AccountServiceTest.cls y sus archivos de metadatos. Si no ve estos archivos, asegúrese de que los ha creado con el comando SFDX: Create Apex Class (SFDX: Crear una clase de Apex) y no el comando New File (Nuevo archivo).

Autorizar una organización

Necesita el nombre de usuario y la contraseña de la organización de prácticas para autorizarla con Salesforce CLI. Si utiliza un Trailhead Playground, este artículo le enseña a buscar su nombre de usuario y a restablecer la contraseña.

A continuación, autorice la organización de prácticas con Salesforce CLI para poder usar la CLI y Salesforce Extensions for Visual Studio Code e interactuar con la organización.

1. En Visual Studio Code, haga clic en el menú View (Ver) y luego seleccione Command Palette (Paleta de comandos). También puede usar el acceso directo del teclado Ctrl+Mayús+P (en Windows o Linux) o Comando+Mayús+P (en macOS) para abrir la paleta de comandos.
   
2. Escriba sfdx authorize org en el cuadro de búsqueda y luego seleccione SFDX: Authorize an Org (SFDX: Autorizar una organización).
   
   
3. Seleccione una opción de URL de inicio de sesión. En las organizaciones de Trailhead Playground, puede seleccionar Project Default (Predeterminada del proyecto) o Production (Producción).
   
   
4. Escriba debuggerOrg como alias de la organización.
   
5. El navegador abre una página de inicio de sesión de Salesforce. Introduzca sus credenciales de Trailhead Playground.
   
6. Si se le solicita que permita el acceso, haga clic en Allow (Permitir).
   
7. Vuelva a Visual Studio Code para confirmar que su Trailhead Playground se ha autorizado. El resultado será algo similar a esto: Successfully authorized <username> with org ID <orgid> (Se ha autorizado a "nombre de usuario" con el Id. de organización "orgid").
   
   

Bien hecho. Haga clic en Verify Step (Verificar paso) para confirmar que su organización de prácticas ha autorizado a Salesforce CLI y continuar con el siguiente paso, donde depuraremos código con Apex Replay Debugger.

Recursos

• Sitio externo: Salesforce Extension Pack
• Guía del desarrollador de Salesforce DX: Salesforce DX Project Setup (Configuración de un proyecto de Salesforce DX)
• Sitio externo: Debugging in Visual Studio Code