Skip to main content

Utilizar Visual Studio Code para el desarrollo de Salesforce

Nota

Nota

¿Es su idioma de aprendizaje español (LATAM)? Comience el reto en un Trailhead Playground en español (LATAM) y utilice las traducciones entre paréntesis para navegar. Copie y pegue solo los valores en inglés, ya que las validaciones del reto dependen de los datos en ese idioma. Si no aprueba el reto en su organización en español (LATAM), recomendamos que (1) cambie la configuración local a Estados Unidos, (2) cambie el idioma a inglés (según estas instrucciones) y, luego, (3) haga clic en el botón “Check Challenge” (Comprobar el reto) nuevamente.

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 juntos

¿Desea seguir con un instructor a medida que trabaja en este paso? Eche un vistazo a este video, que forma parte de la serie Trail Together en Trailhead Live.

(Este clip comienza en el minuto 19:41, en caso de que desee retroceder y mirar el comienzo del paso nuevamente).

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 Ctrl + P (Windows) o Cmd + P (macOS). Ingrese ? 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

  1. Pulse Ctrl + Mayús + P (Windows) o Cmd + Mayús + P (macOS) para que aparezca la paleta de comandos.
  2. Asegúrese de que la nueva secuencia comience con el símbolo >.
  3. Ingrese SFDX:Create Project (SDFX: Crear proyecto).
  4. Seleccione SFDX: Create Project (Crear proyecto).
  5. Seleccione Standard (Estándar).
  6. Escriba el nombre del proyecto VSCodeQuickstart y pulse Enter (Intro).
  7. Seleccione su escritorio como ubicación para crear el proyecto. De este modo, le resultará más fácil encontrarlo más adelante.
  8. 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 rellenar el explorador de archivos.
    Extension notice (Aviso de la extensión): Running SFDX (Ejecutando SFDX): Create Project (Crear proyecto).

Search your Files (Buscar sus archivos)

  1. Pulse Ctrl + P (Windows) o Cmd + P (macOS) para que aparezca la paleta de búsqueda. Esta acción cambiará el foco a la búsqueda de archivos.
  2. Ingrese project-scratch-def.json en el campo.
  3. Haga clic en el resultado para abrir el archivo.
  4. Haga clic en el menú Search (Buscar) ().
  5. Busque orgName.
  6. En el primer resultado que se encuentra en project-scratch-def.json.
  7. Cambie el valor orgName (después de los dos puntos : y entre las comillas “”) a Learning VS Code (VS Code de aprendizaje).
  8. Pulse Ctrl + S (Windows) o Cmd + S (macOS) para guardar el archivo.
    Archivo project-scratch-def.json con el nuevo nombre de la organización.

Autenticarse en su Playground

  1. Pulse Ctrl + Mayús + P (Windows) o Cmd + Mayús + P (macOS) para que aparezca la paleta de comandos.
  2. Ingrese SFDX:Authorize an Org (SDFX: Autorizar una organización).
  3. Seleccione SFDX: Authorize an Org (Autorizar una organización).
  4. Para aceptar la URL de inicio de sesión predeterminada, pulse Entrar.
  5. Ingrese el alias VSCodePlayground.
  6. 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.
  7. Cuando se le pida que otorgue acceso a la aplicación conectada, haga clic en Allow (Permitir).
  8. 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

  1. Haga clic en el menú Explorer (Explorador) ().
  2. 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 y clases, entre otros. Ampliación de la estructura de carpetas que muestra la carpeta de clases.
  3. Haga clic con el botón derecho en la carpeta classes.
  4. Seleccione SFDX: Create Apex Class (Crear clase de Apex).
  5. Ingrese el nombre AccountController.
  6. Si VS Code lo solicita, seleccione force-app/main/default/classes como directorio al que desea agregar AccountController.cls.
  7. 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];
  }
}
  8. 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.

  1. En la línea 3 del código, destaque la consulta SELECT Id,Name,Active__c FROM Account WHERE Active__c = 'Yes' (no destaque WITH SECURITY_ENFORCED).
  2. Pulse Ctrl + Mayús + P (Windows) o Cmd + Mayús + P (macOS) para que aparezca la paleta de comandos.
  3. Ingrese SOQL.
  4. Seleccione SFDX:Execute SOQL Query with Currently Selected Text (SFDX: Ejecutar consulta SOQL con el texto seleccionado actualmente).
  5. Seleccione REST API (API de REST) y pulse Entrar.
  6. En la ficha Output (Resultados) de la ventana terminal integrada, revise los resultados de su consulta. La ventana debe exponer un resumen que indica: Selección de 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.
    Ficha Output (Resultado) con los 10 registros que se recibieron desde su Trailhead Playground.

Implementar

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

  1. Haga clic con el botón derecho en la carpeta classes.
    Al hacer clic con el botón derecho sobre la carpeta classes, aparecerá resaltada la opción SFDX: Deploy Source to Org (Implementar fuente en organización) en la lista de opciones.
  2. Haga clic en SFDX: Deploy Source to Org (Implementar fuente en organización).
  3. En la ficha Output (Resultados) del terminal integrado, compruebe los resultados de su implementación. También debe haber recibido el aviso siguiente: Selección de 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 vio el modo en que las funciones de un IDE pueden ayudarlo a aprovechar su implementación al máximo. Ya tiene la preparación 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.

Comparta sus comentarios de Trailhead en la Ayuda de Salesforce.

Nos encantaría saber más sobre su experiencia con Trailhead. Ahora puede acceder al nuevo formulario de comentarios en cualquier momento en el sitio de Ayuda de Salesforce.

Más información Continuar a Compartir comentarios