Usar Visual Studio Code para el desarrollo de Salesforce

Nota

¿Su idioma de aprendizaje es español? En esta insignia, las validaciones de los retos prácticos de Trailhead funcionan en inglés. Las traducciones se incluyen entre paréntesis a modo de referencia. En su Trailhead Playground, asegúrese de (1) cambiar la configuración regional a Estados Unidos, (2) cambiar el idioma a inglés y (3) copiar y pegar únicamente los valores en inglés. Siga las instrucciones descritas aquí.

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

Seguir la ruta marcada por Trail Together

¿Desea contar con la ayuda de un instructor a medida que trabaja en este paso? Eche un vistazo a este vídeo, que forma parte de la serie Trail Together en Trailhead Live.

(Este clip comienza en la marca del minuto 19:41, en caso de que desee volver atrás y ver el comienzo del paso de nuevo).

Terminal frente a la paleta de comandos

Como toda buena herramienta de desarrollo, Visual Studio Code permite hacer las cosas de varias maneras distintas. Para interactuar con la CLI de Salesforce, puede utilizar el terminal integrado, o bien la ventana de apertura rápida.

Para ver la ventana de apertura rápida, pulse Comando + P en macOS o Ctrl + P en Windows. Escriba ? para ver el menú de ayuda. Durante este módulo, utilizaremos la ventana de apertura rápida en modo de paleta de comandos, ya que nos permite mostrar y ejecutar comandos.

Vista de los comandos globales en la ventana de apertura rápida con el signo ? en el campo.

Crear un proyecto

Pulse Comando + Mayús + P en macOS o Ctrl + Mayús + P en Windows para que aparezca la paleta de comandos.
Asegúrese de que la nueva secuencia comience con >
Escriba SFDX:Create Project (SFDX: Crear proyecto).
Seleccione SFDX: Create Project (Crear proyecto).
Seleccione Standard (Estándar).
Escriba el nombre del proyecto VSCodeQuickstart y pulse Enter (Entrar).
Seleccione su escritorio como ubicación para crear el proyecto. De este modo, le resultará más fácil encontrarlo más adelante.
Espere a que se abra la nueva ventana de Visual Studio Code. Se mostrará un aviso para indicarle que la extensión está preparando su proyecto antes de mostrar resultados en el explorador de archivos.

Search your Files (Buscar sus archivos)

Pulse Ctrl + P en Windows o Comando + P en macOS para que aparezca la paleta de comandos. Esta acción cambiará el foco a la búsqueda de archivos.
Escriba project-scratch-def.json en el campo.
Haga clic en el resultado para abrir el archivo.
Haga clic en el menú Search (Buscar) ().
Busque orgName.
En el primer resultado que se encuentra en project-scratch-def.json.
Cambie el valor orgName (después de los dos puntos : y entre las comillas “”) a Learning VS Code.
Pulse Ctrl + S en Windows o Comando + S en macOS para guardar el archivo.

Autenticarse en su Playground

Pulse Comando + Mayús + P en macOS o Ctrl + Mayús + P en Windows para que aparezca la paleta de comandos.
Escriba SFDX:Authorize an Org (SFDX: Autorizar una organización).
Seleccione SFDX: Authorize an Org (Autorizar una organización).
Para aceptar la URL de inicio de sesión predeterminada, pulse Entrar.
Introduzca el alias VSCodePlayground.
Tenga en cuenta que el navegador predeterminado abrirá una nueva ventana de inicio de sesión en Salesforce. Inicie sesión en su Playground con el nombre de usuario y la contraseña de Playground que recuperó con el paso anterior.
Cuando se le pregunte si desea permitir el acceso a la aplicación conectada, haga clic en Permitir.
Cierre la ventana del navegador.
La ventana terminal command-line devuelve un mensaje de operación realizada con éxito cuando se completa la transacción.

Crear una clase de Apex

Haga clic en el menú Explorador (Explorador) ().
En el directorio VSCODEQUICKSTART, haga clic en force-app para mostrar la estructura de la carpeta. En el directorio force-app/main/default, se encuentran los metadatos incluidos en el proyecto, como aplicaciones, aura, clases y mucho más.
Haga clic con el botón derecho en la carpeta classes.
Seleccione SFDX: Create Apex Class (Crear una clase de Apex).
Escriba el nombre AccountController.
Si VS Code lo solicita, seleccione force-app/main/default/classes como directorio al que desea agregar AccountController.cls.

En el archivo AccountController.cls que acaba de abrir, reemplace el código predeterminado con lo siguiente:

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

Guarde el archivo.

Consulta

La nueva clase de Apex tiene una consulta SOQL, aunque hay que asegurarse de que funciona como es debido antes de implementarla en la organización. Por ello utilizaremos la paleta de comandos para ejecutar la consulta en nuestra organización.

En la línea 3 del código, resalte la consulta SELECT Id,Name,Active__c FROM Account WHERE Active__c = 'Yes' (no resalte WITH SECURITY_ENFORCED)
Pulse Comando + Mayús + P en macOS o Ctrl + Mayús + P en Windows para que aparezca la paleta de comandos.
Escriba SOQL.
Seleccione SFDX:Execute SOQL Query with Currently Selected Text (SFDX:Ejecutar consulta SOQL con el texto seleccionado en estos momentos).
Seleccione REST API (API de REST) y pulse Entrar.
En la ficha Output (Resultados) de la ventana terminal integrada, revise los resultados de su consulta. La ventana debe exponer un resumen que indica: SFDX: Execute SOQL Query ... ended with exit code 0 (Ejecutar consulta SOQL ... finalizó con código de salida 0). Esto significa que se ejecutó correctamente.

Implementar

El último paso consiste en implementar el código en su Playground desde Visual Studio Code.

Haga clic con el botón derecho en la carpeta classes.
Haga clic en SFDX: Deploy Source to Org (Implementar fuente en organización).
En la ficha Output (Resultados) de la ventana terminal integrada, revise los resultados de su implementación. También debe haber recibido el aviso siguiente: SFDX: Deploy Source to Org ... ended with exit code 0 (Implementar fuente en organización ... finalizó con código de salida 0). Esto significa que se ejecutó correctamente.

Palabras de despedida

Ahora ya sabe cómo utilizar Visual Studio Code y Salesforce Extensions. También sabe cómo pueden ayudarle las características de un IDE a sacar el máximo partido a su implementación. Ya está preparado para explorar temas más complejos, como, por ejemplo, la depuración con Apex Replay Debugger, la personalización del editor según sus necesidades o la ejecución de canalizaciones de desarrollador con Visual Studio Code.