Tutorial de Salesforce en VS Code: guía de configuración e implementación

En este artículo, veremos cómo poner en marcha Visual Studio Code (VS Code), la interfaz de línea de comandos (CLI) de Salesforce y el paquete de extensiones de Salesforce con tus sandboxes de Salesforce. Te explicaremos paso a paso cómo instalar las herramientas necesarias, crear un proyecto de Salesforce, autorizar tu organización de Salesforce y guardar los cambios en Salesforce.

Estos son los puntos clave:

• VS Code es un IDE popular entre los desarrolladores que admite múltiples lenguajes y es compatible con Salesforce.
• La configuración inicial requiere instalar la CLI de Salesforce, VS Code y varias extensiones de Salesforce.
• Puedes crear un proyecto de Salesforce en VS Code y luego conectarlo a tu organización de Salesforce.
• Puedes descargar metadatos de tu organización de forma local con el comando "Generador de Package.xml: elegir componentes de metadatos".
• Una vez que modifiques los archivos, puedes guardarlos y los cambios se implementarán en Salesforce, pero primero debes habilitar la configuración "Implementar al guardar".

Descripción general

Visual Studio Code (VS Code) es un IDE que usan muchos desarrolladores y que admite múltiples lenguajes de programación y conjuntos de tecnologías, incluido Salesforce. VS Code reemplazó al complemento Force.com IDE para Eclipse hace unos 2 años y al principio solo admitía organizaciones temporales. Ahora también admite sandboxes, pero Trailhead y otras fuentes de documentación no explican muy bien cómo configurarlo todo. Aquí tienes instrucciones sencillas para empezar a trabajar con VS Code, el paquete de extensiones de Salesforce y tus sandboxes.

Resumen de pasos

1. Instalar CLI de Salesforce, VS Code y extensiones de Salesforce para VS Code - Requisito previo que se realiza una sola vez
2. Crear el proyecto de Salesforce con manifiesto
3. Autorizar el sandbox de Salesforce
4. Descarga los metadatos que necesitas

Instalar la CLI de Salesforce y VS Code

Antes de instalar cualquier otra herramienta, instala la interfaz de línea de comandos (CLI) de Salesforce y luego VS Code.Estas instalan los componentes necesarios de Salesforce DX que las extensiones de Salesforce usan internamente en VS Code.

Instalar extensiones de Salesforce

Después de instalar la CLI y VS Code, instala estas extensiones de Salesforce:

1. Extensiones principales de Salesforce - Salesforce publica y mantiene estas extensiones principales. Se actualizan periódicamente a medida que se lanzan nuevas versiones.
2. Extensión generadora de Package.xml para Salesforce - Esta extensión de código abierto crea y actualiza el archivo package.xml y facilita su gestión.
   

¿Ya instalaste las extensiones? ¡Excelente! Esta configuración inicial ya está completa. Sigue estos pasos para cada organización que quieras usar con VS Code.

Crear proyecto de Salesforce

Ahora puedes crear tu proyecto de Salesforce en VS Code. Para hacerlo:

1. Abrir VS Code.
2. Abre la paleta de comandos desde Ver → Paleta de comandos (Ctrl-Shift-P en Windows y Cmd-Shift-P en Mac).
3. Empieza a escribir crear y haz clic en “Crear proyecto con manifiesto”:

4. Elige Vacío para usar una plantilla vacía. Se recomienda esta opción para agilizar la configuración inicial, ya que más adelante usarás otra extensión para elegir los metadatos que descargarás.
5. Para el nombre del proyecto, sé lo más específico y conciso posible e incluye el nombre de la organización. Para los sandboxes, suele bastar con el nombre del sandbox. Si trabajas en organizaciones de varios clientes, usa como prefijo las iniciales del cliente, seguidas del nombre del sandbox. Por ejemplo, podrías usar “BC SIT” para el sandbox SIT de Blue Canvas.
6. Presiona Intro. VS Code te pedirá la carpeta donde se almacenará el proyecto. Crea nuevas carpetas según sea necesario para mantener todo organizado y encontrar tus proyectos fácilmente más adelante.
7. Haz clic en Crear proyecto. VS Code creará las carpetas y otros archivos predeterminados.

Autorizar una organización

Ahora que ya se crearon los archivos y las carpetas del proyecto, conectemos VS Code con tu organización de Salesforce mediante el comando “Authorize an Org”. Esto implica iniciar sesión en tu organización y autorizar a VS Code para que se conecte a ella:

1. Abre la paleta de comandos.
2. Empieza a escribir Auth y selecciona “SFDX: Authorize an Org”. (Nota: A veces el comando no aparece de inmediato porque las extensiones tardan un poco en cargarse).

3. Ahora se muestran las opciones de tipos de organización. Elige Sandbox para conectarte a un sandbox. Usa Producción para conectarte a tu organización de producción o a una organización de Developer Edition que no sea un sandbox.
4. A continuación, se te pedirá el nombre de la organización en VS Code. Si es posible, intenta darle el mismo nombre que a tu proyecto y usa las mismas pautas de nomenclatura. Después de hacer la selección, tu navegador abrirá la página de inicio de sesión de Salesforce correspondiente.

5. Ingresa el nombre de usuario y la contraseña y haz clic en Iniciar sesión. Si inicias sesión correctamente, es posible que se te pida “Permitir” que VS Code se conecte a tu organización. Haz clic en Permitir. Esto no aparecerá si ya lo autorizaste antes. Cuando la conexión se complete correctamente, VS Code mostrará esta notificación en la esquina inferior derecha:

Descargar los metadatos

VS Code ya está conectado a tu organización y listo para descargar los metadatos de forma local. Primero, elijamos qué metadatos descargar:

1. Abre la paleta de comandos.
2. Empieza a escribir “Package” y luego selecciona “SFDX: Package.xml Generator: Choose Metadata Components”.

1. Esto abre una nueva pestaña “Elegir componentes de metadatos” y la extensión comienza a obtener la lista de metadatos disponibles en tu organización.
2. Ahora selecciona los elementos de metadatos que quieres descargar. Se recomienda incluir, como mínimo, estos elementos, ya que son los más comunes para los desarrolladores:

1. Clase de Apex
2. ApexComponent
3. ApexPage
4. ApexTrigger
5. AuraDefinitionBundle
6. CustomLabels
7. CustomMetadata
8. CustomObject - En realidad, selecciona todos los objetos estándar y personalizados
9. Flujo
10. LightningComponentBundle
11. Perfil
12. PermissionSet
13. Recurso estático

1. Haz clic en “Actualizar Package.xml”. Esto actualiza el archivo Package.xml.
2. Haz clic derecho en el archivo “Package.xml” y selecciona “SFDX: Recuperar código fuente de la organización según el manifiesto”.

1. Ahora VS Code está descargando los metadatos seleccionados. Esto puede tardar un poco, pero suele completarse en 5-10 minutos, según la cantidad que se deba descargar.

Guardar cambios en Salesforce

Para implementar los cambios en Salesforce, basta con guardar el archivo y se implementarán en la organización. Sin embargo, la configuración Implementar al guardar debe actualizarse primero:

• Agrega "salesforcedx-vscode-core.push-or-deploy-on-save.enabled": true al archivo .vscode/settings.json

O actualiza la configuración del espacio de trabajo:

• Selecciona Archivo > Preferencias > Configuración (Windows o Linux) o Código > Preferencias > Configuración (macOS).
• En Salesforce Feature Previews, selecciona Push-or-deploy-on-save: Enabled.

Otra opción es hacer clic derecho en los archivos modificados y seleccionar SFDX: Deploy Source to Server. Esta es una alternativa; lo recomendable es guardar los cambios en la organización al guardar el archivo.

‍

Lleva más lejos tu experiencia con Salesforce Sandbox + VS Code

¡Recuerda que el valor de la tecnología que usas depende de qué tan bien la conoces! Nuestro objetivo con esta guía es ayudarte a configurar Visual Studio Code junto con tus entornos sandbox de Salesforce y, poco a poco, notar los beneficios en fluidez y productividad.

Para complementar este conjunto de herramientas y seguir mejorando tu flujo de trabajo de desarrollo, te recomendamos probar la experiencia de implementación basada en Git de Blue Canvas. Obtendrás copias de seguridad continuas de los metadatos de Salesforce, la posibilidad de comparar organizaciones en segundos e implementar cambios de metadatos entre organizaciones con revisión del equipo y verificaciones automatizadas.

Conoce más sobre nuestras soluciones y cómo pueden simplificar tu flujo de trabajo de desarrollo en Salesforce. Empieza con Blue Canvas hoy ¡y lleva tus operaciones de Salesforce al siguiente nivel! 🚀

‍

-------------

Preguntas frecuentes

¿Cómo uso Salesforce con Visual Studio Code (VS Code)?

• Para usar Salesforce con VS Code, primero necesitas instalar la interfaz de línea de comandos (CLI) de Salesforce y luego VS Code. Después, instala las extensiones de Salesforce en VS Code. A continuación, crea un proyecto de Salesforce en VS Code y autoriza tu organización de Salesforce. Así podrás descargar metadatos localmente y guardar los cambios en Salesforce.

¿Cuáles son los requisitos previos para usar Salesforce con VS Code?

• La configuración inicial requiere instalar la CLI de Salesforce, VS Code y varias extensiones de Salesforce. Una vez instaladas estas herramientas, puedes crear un proyecto de Salesforce en VS Code y autorizar tu organización de Salesforce.

¿Puedo guardar en Salesforce los cambios realizados en VS Code?

• Sí, puedes guardar los cambios realizados en los archivos de VS Code y luego implementarlos en Salesforce. Sin embargo, para hacerlo debes activar la opción "Deploy on Save" en la configuración de VS Code.

¿Cómo puedo descargar metadatos localmente desde mi organización de Salesforce con VS Code?

• Puedes descargar metadatos localmente desde tu organización de Salesforce mediante el comando "Package.xml Generator: Choose Metadata Components" en VS Code. Esto te permitirá seleccionar los elementos de metadatos que deseas descargar.

¿Qué función cumplen las extensiones de Salesforce en la configuración de Salesforce en VS Code?

• Las extensiones de Salesforce cumplen una función fundamental en la configuración de Salesforce en VS Code. Estas extensiones, que incluyen Salesforce Core Extensions y Salesforce Package.xml Generator Extension, ofrecen las funciones necesarias para administrar tu organización de Salesforce desde VS Code. Se actualizan periódicamente a medida que se lanzan nuevas versiones.

¿Puedo usar VS Code con un sandbox de Salesforce?

• Sí, VS Code es compatible con los entornos sandbox de Salesforce. Después de configurar las herramientas necesarias, puedes autorizar un sandbox de Salesforce y comenzar a trabajar con tus datos de Salesforce en VS Code.