Prepararse para crear una aplicaciĆ³n
Objetivos de aprendizaje
- 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.
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.
Empecemos a trabajar. Cree un proyecto denominado geolocation
(geolocalizaciĆ³n).
- En una ventana de terminal o comandos, navegue hacia donde desee que se localice el proyecto.
- Cree el proyecto:
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.
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.
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. - 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,
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
.
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.
- Distribuya sus metadatos y origen local en una organizaciĆ³n borrador.
- Incorpore nuevamente los cambios realizados en la organizaciĆ³n borrador a su proyecto local.
- Sincronice este proyecto con su repositorio de control de orĆgenes.
Pero antes de experimentar con el flujo de trabajo, debemos crear una organizaciĆ³n borrador. HagĆ”moslo ahora.
- En la ventana de comandos, pase al directorio del proyecto
geolocation
(geolocalizaciĆ³n). - Cree una organizaciĆ³n borrador con el 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.
- Cree la cuenta Marriott Marquis.
- Cree la cuenta Hilton Union Square.
- Cree la cuenta Hyatt.
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
.
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. - En su proyecto de geolocalizaciĆ³n de Salesforce DX, cree un directorio denominado
data
(datos). - Exporte algunos datos de muestra. 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. Hasta ahora, hemos sincronizado datos regulares. Ahora vamos a pasar a la parte realmente divertida: el cĆ³digo.