Skip to main content
ƚnase a nosotros en TDX, en San Francisco, o en Salesforce+ los dƭas 5 y 6 de marzo en la conferencia para desarrolladores sobre la era de agentes de IA. Registrarse ahora.

Prepararse para crear una aplicaciĆ³n

Objetivos de aprendizaje

DespuƩs de completar esta unidad, podrƔ:
  • Describir la estructura de un proyecto de Salesforce DX.
  • Describir cĆ³mo usar Salesforce CLI para crear un proyecto.
  • Describir cĆ³mo usar Salesforce CLI para importar datos de ejemplo.

Crear un proyecto de Salesforce DX

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

Nota

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.
Nota

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.

    imagen del archivo sfdx-project.json

     



    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
    }
  }
}

Nota

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.

Crear organizaciones borrador

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.
Nota

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.

Crear datos de ejemplo

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.
Comparta sus comentarios sobre Trailhead en la Ayuda de Salesforce.

Nos encantarĆ­a conocer su experiencia con Trailhead. Ahora puede acceder al nuevo formulario de comentarios cuando quiera desde el sitio de la Ayuda de Salesforce.

MĆ”s informaciĆ³n Continuar para compartir comentarios