Describir el desarrollo basado en código fuente

Objetivos de aprendizaje

Después de completar esta unidad, podrá:

• Describir la finalidad de un proyecto de Salesforce DX.
  
• Describir cómo el modelo de desarrollo de paquetes permite gestionar el seguimiento de cambios.
  
• Describir la función de las organizaciones borrador en el proceso de desarrollo.
  

Innove con las herramientas que tiene a su disposición

Como ya vimos en la unidad anterior, usted es quien decide qué herramientas quiere usar. Puede usar su editor de texto favorito junto con Salesforce CLI o Code Builder. Seleccione el archivo VCS que quiere usar. Si va a usar Code Builder, ofrecemos varias extensiones para facilitar las tareas de desarrollo y pruebas.

A medida que la empresa crece, es posible que se enfrente a retos a la hora de coordinar y probar los cambios de los proyectos. El desarrollo de paquetes aborda directamente estos retos. El código fuente se organiza en paquetes basados en un conjunto de funciones o personalizaciones que le interesa entregar juntas. El proyecto de Salesforce DX refleja este enfoque basado en paquetes para organizar el código fuente.

¿Qué es un proyecto de Salesforce DX?

Un proyecto de Salesforce DX es una estructura de directorios local de los metadatos en formato de código fuente. Le permite desarrollar y probar con herramientas de Salesforce DX.

Contiene archivos de configuración para crear organizaciones borrador. Además, contiene datos para cargarlos en organizaciones a fin de realizar tareas de desarrollo o pruebas. También contiene pruebas para validar el paquete.

Cuando usa la CLI para crear un nuevo proyecto de Salesforce DX, se crea automáticamente la estructura de directorios del proyecto. Al crear un proyecto desde cero, se crean muchos elementos automáticamente. Se crea un archivo de configuración básico del proyecto. Se crean archivos de definición y directorios en blanco de muestra para las pruebas y conjuntos de datos de muestra. También se crea un directorio de "paquetes" predeterminado para el código del paquete.

Recuerde que un paquete es un conjunto de código y personalizaciones que guardan relación. Puede probar un paquete de forma independiente sin otros componentes en su organización. También puede publicar un paquete de forma independiente. Los componentes con metadatos de un paquete solo pueden residir en un paquete a la vez en la organización instalada.

Como mínimo, en el proyecto se gestiona el código fuente de un paquete. Dicho esto, si se crean y publican varios paquetes a la vez, puede organizarlos en un solo proyecto de DX. Cada uno de los paquetes se alinea con un directorio definido en el archivo de configuración del proyecto.

La función de las organizaciones borrador en el proceso de desarrollo

Con las organizaciones borrador, que se crean a partir del código fuente y los metadatos, es más fácil desarrollar una aplicación de forma coherente una y otra vez. Solo se trabaja con el código fuente y los metadatos de un proyecto concreto. No es necesario copiar elementos que no necesita (y, de hecho, no es algo que recomendemos). Puesto que las organizaciones borrador son entornos temporales de Salesforce, siempre puede crear rápidamente una organización borrador para cada paquete o proyecto de desarrollo.

Una vez configurado el VCS y organizado el código fuente en paquetes, ya puede empezar un nuevo proyecto de desarrollo. Abra su IDE o editor de texto favorito y agregue o modifique el código fuente. Cuando quiera ver los cambios en una organización, puede crear una organización borrador.

Después de crearla, todavía le quedan varias tareas de configuración por completar. Implemente todo el código fuente del proyecto en la organización borrador, configure los permisos y cree o cargue los datos de prueba que requiere el paquete.

Aunque puede usar el IDE o editor de texto para el desarrollo mediante programación (es decir, basado en código), también puede usar la organización borrador para tareas de desarrollo declarativo (señalar y hacer clic). Este proceso es similar a lo que se hace en un sandbox u organización de producción. Lo que cambia en el modelo basado en el código fuente es que se sincronizan los avances de la organización borrador con el proyecto local. Esta sincronización permite confirmar los cambios realizados en las páginas de configuración junto con los cambios del IDE local.

Antes de confirmar en el sistema de control de versiones, no olvide ejecutar pruebas. Puede usar la misma organización borrador para ejecutar las pruebas o crear otra específicamente para las pruebas antes de confirmar el código fuente. Este mismo patrón de creación de organizaciones borrador para pruebas es una parte fundamental de un sistema de integración continua y automatizada.

Mantener sincronizados el proyecto y la organización borrador

Una función clave de Salesforce DX es que puede mantener sincronizados fácilmente el proyecto y la organización borrador. ¡Ya puede olvidarse de las notas adhesivas! Ya no tiene que ir anotando los cambios que ha hecho en el sistema local de archivos, IDE o editor, o los cambios que ha hecho en la organización.

Salesforce DX lleva un registro de los cambios que se hacen a nivel local en el proyecto y los que se hacen en la organización borrador.

Antes de implementar los cambios en el código fuente en la organización borrador, o recuperar los cambios en el proyecto local, puede obtener una vista previa de los mismos. Ese es el poder de Salesforce CLI en acción.

$ sf project deploy preview --target-org my-scratch
No conflicts found.
No files will be deleted.
Will Deploy [2] files.
Type         Fullname        Path
──────────── ─────────────── ──────────────────────────────────────────────────────────────────────────────
ApexClass    WidgetClass     force-app/main/default/classes/WidgetClass.cls-meta.xml
CustomObject WidgetObject__c force-app/main/default/objects/WidgetObject__c/WidgetObject__c.object-meta.xml
No files were ignored. Update your .forceignore file if you want to ignore certain files.

Dentro de una organización borrador, los archivos del código fuente pueden ser enormes y dejar una huella más grande que la de Pie Grande. Piense en todos los objetos personalizados, etiquetas personalizadas y recursos estáticos que conforman una organización, por decir algunos.

El formato de un proyecto de DX desglosa los archivos grandes de código fuente para que se puedan consumir más fácilmente y sean más fáciles de gestionar con un sistema de control de versiones. Por ejemplo, Salesforce DX transforma los objetos personalizados y las conversiones de objetos personalizados en varios archivos y directorios. Esta estructura del código fuente hace que sea mucho más fácil encontrar lo que quiere cambiar o actualizar. Tener archivos más pequeños de control del código fuente implica que habrá menos conflictos de fusión durante el desarrollo. ¡Puede despedirse de las fusiones complejas!

Cuando termine las tareas de desarrollo, confirme siempre los cambios en el repositorio VCS. Ya puede probar, desarrollar y publicar con Salesforce DX.

Recursos

• Guía del desarrollador: Referencia de comandos de Salesforce CLI
• Guía del desarrollador: Guía del desarrollador de Salesforce DX
• Guía del desarrollador: Salesforce Extensions for VS Code (Visual Studio Marketplace: extensiones de Salesforce para Visual Studio Code)
• Vídeo: Salesforce Environments: Getting Started with Scratch Orgs (Entornos de Salesforce: introducción a las organizaciones borrador)