Prepararse para crear una aplicaciĆ³n
Objetivos de aprendizaje
- 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.
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.
Empecemos a trabajar. Cree un proyecto con el nombre geolocation
.
- En un terminal o una ventana de comandos, navegue hasta la ubicaciĆ³n donde quiere que se ubique el proyecto.
- Cree el proyecto:
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.
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.
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. - 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,
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
.
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.
- EnvĆe el cĆ³digo fuente y los metadatos locales a una organizaciĆ³n borrador.
- Extraiga los cambios realizados en la organizaciĆ³n borrador y devuĆ©lvalos al proyecto local.
- Sincronice el proyecto con el repositorio de control del cĆ³digo fuente.
Antes de ponernos a jugar con el flujo de trabajo, es necesario crear una organizaciĆ³n borrador. Vamos a ello.
- En la ventana de comandos, cambie al directorio del proyecto
geolocation
. - Cree una organizaciĆ³n borrador con el 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.
- Cree la cuenta de Marriott Marquis.
- Cree la cuenta de Hilton Union Square.
- Cree la cuenta de Hyatt.
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
.
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. - En el proyecto "geolocation" de Salesforce DX, cree un directorio con el nombre
data
. - Exporte algunos datos de ejemplo. 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. Hasta ahora, hemos sincronizado datos habituales. Ahora vamos a ponernos con la parte divertida: el cĆ³digo.
Recursos
- 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)