Prepararse para crear una aplicación

Antes de desarrollar su primera aplicación, cree un proyecto y conéctelo a su repositorio de control de orígenes.

No necesitará la organización de Trailhead Playground para crear esta aplicación. En cambio, usará organizaciones borrador. Presentamos estos entornos poderosos y temporales en la unidad anterior. En la última unidad, tendrá la oportunidad de implementar un paquete en Trailhead Playground.

Un proyecto de Salesforce DX es una copia local de los metadatos de su paquete, un grupo de código y personalizaciones relacionados. También contiene los principales activos para sincronizar los metadatos y el origen del proyecto local con sus organizaciones borrador. Cree el proyecto en la misma máquina en la que instaló Salesforce CLI y, a continuación, sincronice este proyecto con su repositorio del VCS.

En este módulo, creamos una aplicación de geolocalización simple con componentes de 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 Presentación de los componentes web Lightning.

Empecemos a trabajar. Cree un proyecto denominado geolocation (geolocalización).

1. En una ventana de terminal o comandos, navegue hacia donde desee que se localice el proyecto.
2. Cree el proyecto:

   sf project generate --name geolocation

   Este comando crea una carpeta denominada geolocation (geolocalización) y genera un proyecto nuevo con todos los activos en la estructura de carpetas adecuada. Este es un ejemplo de un proyecto local. Puede ver cómo evoluciona un proyecto una vez que se empiezan a agregar el código fuente, los componentes Lightning y las clases, por mencionar algunos.
   
   
   

    

   
   
   

   Activo	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 debe colocar los archivos cuando realice la sincronización entre el proyecto y la organización. Dentro de este archivo se especifica lo siguiente: Las rutas hacia el código fuente, las clases y los metadatos, como ubicados en uno o más directorios de paquete, en este caso, force-app. El espacio de nombres, de ser necesario. La versión de API de su origen. Los comandos de Salesforce CLI usan esta información para saber de qué origen deben hacer un seguimiento entre el proyecto y la organización asociada.
   config/project-scratch-def.json	Determina la configuración de una organización borrador, incluidas las funciones y la configuración que definen la forma de su organización. Puede crear un archivo de configuración para compartir con todo el equipo de desarrollo.
   force-app	La carpeta que contiene el origen de su proyecto.

Configurar un archivo de definición de organización borrador

Los archivos de definición de organización borrador permiten crear organizaciones borrador fácilmente con distintas funciones o preferencias para realizar pruebas. Por ejemplo, puede configurar la preferencia de la organización enables1EncryptedStoragePref2 para activar o desactivar la función de almacenamiento en caché web de Salesforce para dispositivos móviles. Durante la implementación, desactivar la función de almacenamiento en caché evita que tenga que actualizar la página una y otra vez mientras espera que se apliquen los cambios del código de componente.

Como opción, puede actualizar el contenido de config/project-scratch-def.json para que sea más personal, por ejemplo, cambiar la propiedad orgName.

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

Desactivar el almacenamiento en caché del navegador seguro y persistente tiene un impacto negativo significativo en el desempeño. Siempre active la configuración en producción.

Ahora que comprende la potencia de las organizaciones borrador, este es el flujo de trabajo básico de cuando las usa en el Modelo de desarrollo de paquetes.

1. Distribuya sus metadatos y origen local en una organización borrador.
2. Incorpore nuevamente los cambios realizados en la organización borrador a su proyecto local.
3. Sincronice este proyecto con su repositorio de control de orígenes.

Su edición de organización de Dev Hub determina cuántas organizaciones borrador puede crear por día y cuántas pueden estar activas en un momento determinado. Trailhead Playgrounds son organizaciones de Developer Edition. Puede eliminar una organización borrador existente para liberar una asignación con el comando org delete scratch.

Pero antes de experimentar con el flujo de trabajo, debemos crear una organización borrador. Hagámoslo ahora.

1. En la ventana de comandos, pase al directorio del proyecto geolocation (geolocalización).

   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 puede demorar unos minutos. Usamos estos indicadores cuando iniciamos el comando:

• El indicador --set-default determina que desea que esta organización borrador sea la organización predeterminada para este proyecto cuando se ejecutan los comandos de Salesforce CLI. Para usar una organización diferente según el comando, puede especificar el indicador --target-org y otro alias.
• El indicador --definition-file es la ruta hacia el archivo de configuración de la organización borrador del proyecto.
• ¿Recuerda nuestro amigo, el indicador --alias, de la unidad anterior? Le permite referirse a la organización usando su alias, GeoAppScratch, en comandos futuros que acepten el indicador --target-org.

Las organizaciones borrador vienen con datos estándar en función de la edición que elija. Sin embargo, es importante agregar algunos datos de muestra que sean más relevantes para la aplicación o el paquete que esté creando. Usemos Salesforce CLI para crear algunas cuentas de muestra para probar con nuestra aplicación de geolocalización.

1. Cree la cuenta 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 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 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 que pueda seguir brillando en el mundo de los desarrolladores, le proporcionamos comandos que permiten tomar datos de la organización borrador e incorporarlos en su proyecto con facilidad. Luego, puede comprometer los datos a su repositorio de control de orígenes para poder cargarlos nuevamente si usted u otro desarrollador crean una nueva organización borrador.
   
   Sea cual sea el sistema de control de orígenes que use, le recomendamos que lo configure de manera que la carpeta .sf no se agregue al repositorio. Esta carpeta contiene información temporal de las organizaciones borrador por lo que no es necesario que la guarde para la posteridad. En Git, debería agregarlo al archivo .gitignore.
   
   
4. En su proyecto de geolocalización de Salesforce DX, cree un directorio denominado data (datos).

   mkdir data

5. Exporte algunos datos de muestra.

   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 tiene algunos datos de muestra que podrá importar con este comando en el futuro. Sin embargo, no lo haga ahora, importaremos los datos en una organización borrador diferente más adelante.

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

   Hasta ahora, hemos sincronizado datos regulares. Ahora vamos a pasar a la parte realmente divertida: el código.

• Documentación de Salesforce: Guía de configuración de Salesforce CLI
• Documentación de Salesforce: Salesforce CLI Command Reference
• Documentación de Salesforce: Guía del desarrollador de Salesforce DX
• Mercado de Visual Studio: Extensiones de Salesforce para VS Code