Skip to main content
ƚnase a nosotros en TDX, San Francisco o en Salesforce+ del 5 al 6 de marzo en la conferencia de desarrolladores para la era del agente de la IA. Regƭstrese ahora.

Prepararse para crear una aplicaciĆ³n

Objetivos de aprendizaje

DespuƩs de completar esta unidad, podrƔ:
  • Explicar la estructura del proyecto de Salesforce DX.
  • Describir cĆ³mo se usa Salesforce CLI para crear a un proyecto.
  • Describir cĆ³mo se usa Salesforce CLI para importar datos de muestra.

Crear un proyecto de Salesforce DX

Antes de desarrollar su primera aplicaciĆ³n, cree un proyecto y conĆ©ctelo a su repositorio de control de orĆ­genes.

Nota

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

    imagen del archivo sfdx-project.json

     



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

Nota

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.

Crear una organizaciĆ³n borrador

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

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.

Crear datos de muestra

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

Nos encantarƭa saber mƔs sobre su experiencia con Trailhead. Ahora puede acceder al nuevo formulario de comentarios en cualquier momento en el sitio de Ayuda de Salesforce.

MĆ”s informaciĆ³n Continuar a Compartir comentarios