Prepararse para crear una aplicación

Para poder crear su primera aplicación, debe crear un proyecto y conectarlo a su repositorio de control de código fuente.

No necesita el Trailhead Playground para desarrollar esta aplicación. Lo que vamos a usar son las organizaciones borrador. En la unidad anterior, hablamos de estos potentes entornos temporales. En la última unidad, tendrá la oportunidad de implementar un paquete en su Trailhead Playground.

Un proyecto de Salesforce DX es una copia local de los metadatos de su paquete, un grupo de código y personalizaciones que se relacionan entre ellos. También contiene los recursos básicos para sincronizar el código y los metadatos del proyecto local con sus organizaciones borrador. Cree el proyecto en el mismo equipo donde instaló Salesforce CLI y sincronícelo con el repositorio de VCS.

En este módulo, vamos a crear una aplicación sencilla de geolocalización con componentes Aura.

Desde la versión Spring ‘19 (versión 45.0 de la API), puede construir componentes Lightning empleando dos modelos de programación: el modelo Componentes web Lightning y el modelo Componentes Aura original. Los componentes web Lightning y los componentes Aura pueden coexistir y funcionar conjuntamente en una página. Este contenido trata los componentes Aura. Para obtener más información sobre los componentes web Lightning, consulte Introducing Lightning Web Components (Introducción a los componentes web Lightning).

Empecemos a trabajar. Cree un proyecto con el nombre geolocation.

1. En un terminal o una ventana de comandos, navegue hasta la ubicación donde quiere que se ubique el proyecto.
2. Cree el proyecto:

   sf project generate --name geolocation

   Con este comando podrá crear una carpeta llamada "geolocation" y estructurar un nuevo proyecto con todos los recursos en la estructura de carpetas correspondiente. A continuación, encontrará un ejemplo de un proyecto local. Puede observar cómo evoluciona un proyecto cuando empieza a añadir el código fuente, los componentes Lightning y las clases, por mencionar algunos elementos.
   
   
   

    

   
   
   

   Recurso	Objetivo
   sfdx-project.json	Este archivo indica que el directorio es un proyecto de Salesforce DX. Contiene información del proyecto y facilita la autenticación de las organizaciones. Además, indica a Salesforce CLI dónde colocar los archivos cuando se realiza la sincronización entre el proyecto y la organización. Dentro de este archivo se especifica lo siguiente: Las rutas hasta el código fuente, las clases y los metadatos según se encuentran ubicados en uno o más directorios de paquetes, en este caso, force-app. El espacio de nombres, si es necesario. La versión de API del código fuente. Los comandos de Salesforce CLI usan esta información para saber qué código fuente deben rastrear entre el proyecto y la organización asociada.
   config/project-scratch-def.json	Determina la configuración de las organizaciones borrador, incluidos los ajustes y las funciones que definen su forma. Puede crear un archivo de configuración que pueda compartir todo el equipo de desarrollo.
   force-app	La carpeta que contiene el código fuente del proyecto.

Configurar un archivo de definición para organizaciones borrador

Los archivos de definición para organizaciones borrador permiten crear fácilmente organizaciones borrador con distintas funciones o preferencias para realizar pruebas. Por ejemplo, puede activar o desactivar el almacenamiento en caché en la web móvil de Salesforce. Para ello, puede definir la preferencia enables1EncryptedStoragePref2 de la organización. Durante la fase de desarrollo, si desactiva el almacenamiento en caché, podrá ahorrarse tener que actualizar la página constantemente para que se apliquen los cambios del código de un componente.

También puede actualizar el contenido del archivo config/project-scratch-def.json para que sea más personal, por ejemplo, puede cambiar la propiedad orgName.

{
  "orgName": "Account Geolocation App",
  "edition": "Developer",
  "features": ["EnableSetPasswordInApi"],
  "settings": {
    "lightningExperienceSettings": {
      "enableS1DesktopEnabled": true
    },
    "mobileSettings": {
      "enableS1EncryptedStoragePref2": false
    }
  }
}

La desactivación del almacenamiento en caché seguro y persistente del navegador tiene un impacto bastante negativo en el rendimiento. Deje activado siempre este ajuste en el entorno de producción.

Ahora que conoce el poder de las organizaciones borrador, le presentamos el flujo de trabajo básico para usarlas en el modelo de desarrollo de paquetes.

1. Envíe el código fuente y los metadatos locales a una organización borrador.
2. Extraiga los cambios realizados en la organización borrador y devuélvalos al proyecto local.
3. Sincronice el proyecto con el repositorio de control del código fuente.

La edición de la organización de Dev Hub determina la cantidad de organizaciones borrador que puede crear a diario, y cuántas pueden estar activas en un momento dado. Los Trailhead Playgrounds son organizaciones de Developer Edition. Puede eliminar las organizaciones borrador existentes para liberar una asignación con el comando org delete scratch.

Antes de ponernos a jugar con el flujo de trabajo, es necesario crear una organización borrador. Vamos a ello.

1. En la ventana de comandos, cambie al directorio del proyecto geolocation.

   cd geolocation

2. Cree una organización borrador con el alias GeoAppScratch.

   sf org create scratch --set-default --definition-file config/project-scratch-def.json --alias GeoAppScratch

A veces, este proceso tarda unos minutos. Al iniciar el comando, utilizamos estos indicadores:

• El indicador --set-default indica que quiere que esta organización borrador sea la predeterminada del proyecto cuando se ejecuten los comandos de Salesforce CLI. Para usar una organización distinta según el comando que envíe, puede usar el indicador --target-org y especificar otro alias.
• El indicador --definition-file es la ruta al archivo de configuración de la organización borrador del proyecto.
• ¿Recuerda a nuestro amigo, el indicador --alias de la unidad anterior? Permite hacer referencia a la organización con su alias, GeoAppScratch, en futuros comandos que acepten el indicador --target-org.

Las organizaciones borrador incluyen algunos datos estándar que dependen de la edición que utilice. Sin embargo, es importante agregar algunos datos de ejemplo que sean más relevantes para la aplicación o el paquete que va a desarrollar. Vamos a usar Salesforce CLI para crear algunas cuentas de ejemplo y probarlas con nuestra aplicación.

1. Cree la cuenta de Marriott Marquis.

   sf data create record --sobject Account --values "Name='Marriott Marquis' BillingStreet='780 Mission St' BillingCity='San Francisco' BillingState='CA' BillingPostalCode='94103' Phone='(415) 896-1600' Website='www.marriott.com'"

2. Cree la cuenta de Hilton Union Square.

   sf data create record --sobject Account --values "Name='Hilton Union Square' BillingStreet='333 O Farrell St' BillingCity='San Francisco' BillingState='CA' BillingPostalCode='94102' Phone='(415) 771-1400' Website='www.hilton.com'"

3. Cree la cuenta de Hyatt.

   sf data create record --sobject Account --values "Name='Hyatt' BillingStreet='5 Embarcadero Center' BillingCity='San Francisco' BillingState='CA' BillingPostalCode='94111' Phone='(415) 788-1234' Website='www.hyatt.com'"

   Para seguir petándolo en el mundo del desarrollo, ofrecemos comandos para obtener datos fácilmente de la organización borrador e integrarlos en el proyecto. Después, puede confirmar esos datos en el repositorio de control del código fuente para volver a cargarlo en caso de que usted u otro desarrollador cree una nueva organización borrador.
   
   Sea cual sea el sistema de control del código fuente que use, le recomendamos configurarlo para que la carpeta .sf no se agregue al repositorio. Esta carpeta contiene información personal sobre las organizaciones borrador, así que no es necesario guardarla de forma permanente. En Git, debe agregarla al archivo .gitignore.
   
   
4. En el proyecto "geolocation" de Salesforce DX, cree un directorio con el nombre data.

   mkdir data

5. Exporte algunos datos de ejemplo.

   sf data export tree --query "SELECT Name, BillingStreet, BillingCity, BillingState, BillingPostalCode, Phone, Website FROM Account WHERE BillingStreet != NULL AND BillingCity != NULL and BillingState != NULL" --output-dir ./data

   Ahora cuenta con datos de ejemplo que puede importar más adelante con este comando. Pero no lo haga ahora, importaremos los datos en otra organización borrador más tarde.

   sf data import tree --files data/Account.json

   Hasta ahora, hemos sincronizado datos habituales. Ahora vamos a ponernos con la parte divertida: el código.

• Documentación de Salesforce: Guía de configuración de Salesforce CLI
• Documentación de Salesforce: Referencia de comandos de Salesforce CLI
• Documentación de Salesforce: Guía del desarrollador de Salesforce DX
• Visual Studio Marketplace: Salesforce Extensions for VS Code (Visual Studio Marketplace: extensiones de Salesforce para Visual Studio Code)