Crear la visualizaciĆ³n de mapa de cuentas y reunir todos los elementos
Objetivos de aprendizaje
- Describir los comandos de Salesforce CLI que se usan para sincronizar el proyecto con las organizaciones borrador.
- Describir el comando de Salesforce CLI que se usa para crear un conjunto de permisos.
- Comprender cĆ³mo desarrollar una aplicaciĆ³n con componentes Aura.
ĀæQuĆ© vamos a desarrollar?
En este paso, vamos a desarrollar los componentes finales de nuestra aplicaciĆ³n de geolocalizaciĆ³n, donde se reunirĆ”n todas las funciones. Vamos a crear un componente Aura que permita visualizar direcciones de cuentas en forma de marcadores en un mapa, ademĆ”s de una ficha personalizada para poder navegar por la aplicaciĆ³n. TambiĆ©n vamos a usar un conjunto de permisos para conceder acceso a los usuarios a nuestra aplicaciĆ³n.
Crear el componente Aura de mapa de cuentas
Este componente utiliza el componente <lightning:map>
para mostrar cuentas en un mapa.
- Cree el componente AccountMap en la carpeta
aura
. - Abra el archivo
force-app/main/default/aura/AccountMap/AccountMap.cmp
y sustituya el contenido por el siguiente cĆ³digo. Luego guarde el archivo. Este componente escucha el evento AccountsLoaded y muestra sus datos en forma de marcadores en un mapa.
- Abra el archivo
force-app/main/default/aura/AccountMap/AccountMapController.js
y sustituya el contenido por el siguiente cĆ³digo. Luego guarde el archivo. La funciĆ³nonAccountsLoaded
del controlador del cliente transforma los datos del evento en el formato que espera el componente<lightning: map>
.
- Implemente el nuevo cĆ³digo en la organizaciĆ³n borrador.
Crear el componente Aura de localizador de cuentas
Este es el componente principal, el que usaremos para mostrar la aplicaciĆ³n a los usuarios finales en pĆ”ginas Lightning, plataformas mĆ³viles de Salesforce y fichas personalizadas. TambiĆ©n es el Ćŗltimo componente que creamos para este proyecto.
- Cree el componente AccountLocator en la carpeta
aura
. - Abra el archivo
force-app/main/default/aura/AccountLocator/AccountLocator.cmp
y sustituya el contenido por el siguiente cĆ³digo. Luego guarde el archivo. Este componente estĆ” formado por los otros componentes que creĆ³ durante el proyecto. Dos funciones muy potentes del marco de trabajo de componentes Lightning son la encapsulaciĆ³n de componentes y la reutilizaciĆ³n de componentes. Construir componentes detallados dentro de un componente mĆ”s grande permite desarrollar componentes y aplicaciones mĆ”s interesantes.
- Implemente el nuevo cĆ³digo en la organizaciĆ³n borrador.
Crear la ficha personalizada de localizador de cuentas
Una manera sencilla de mostrar componentes Aura tanto la experiencia de escritorio de Lightning como en la experiencia mĆ³vil de Salesforce es con una ficha personalizada. DespuĆ©s de este paso, podrĆ” acceder a la aplicaciĆ³n yendo a esta ficha personalizada.
- Abra la organizaciĆ³n borrador.
- En Setup (ConfiguraciĆ³n), escriba
Tabs
(Fichas) en el cuadro Quick Find (BĆŗsqueda rĆ”pida) y, a continuaciĆ³n, seleccione Tabs (Fichas). - En la secciĆ³n Lightning Component Tabs (Fichas de componentes Lightning), haga clic en New (Nueva) e introduzca la siguiente informaciĆ³n:
- Lightning Component (Componente Lightning): c:AccountLocator
- Tab Label (Etiqueta de ficha):
Account Locator
- Tab Name (Nombre de ficha):
Account_Locator
- Tab Style (Estilo de ficha): haga clic en el icono de lupa y seleccione Map (Mapa) como icono de la ficha.
- Description (DescripciĆ³n):
Custom tab for Account Locator
(Ficha personalizada para el localizador de cuentas).
- Haga clic en Next (Siguiente).
- Si quiere aplicar un tipo de visibilidad de la ficha a todos los perfiles, elija la opciĆ³n Tab Hidden (Tabla oculta).
- Haga clic en Save (Guardar).
Crear el conjunto de permisos de geolocalizaciĆ³n
Para controlar quiĆ©n tiene acceso a su aplicaciĆ³n de geolocalizaciĆ³n, es necesario crear un conjunto de permisos y conceder visibilidad para la ficha Account Locator (Localizador de cuentas).
- En Setup (ConfiguraciĆ³n), introduzca
Permission Sets
(Conjuntos de permisos) en el cuadro Quick Find (BĆŗsqueda rĆ”pida) y, a continuaciĆ³n, haga clic en Permission Sets (Conjuntos de permisos). - Haga clic en New (Nuevo) e introduzca estos detalles:
- Label (Etiqueta):
Geolocation
(GeolocalizaciĆ³n) - API Name (Nombre de la API):
Geolocation
(GeolocalizaciĆ³n) - Description (DescripciĆ³n):
Grants access to the Account Geolocation app
(Concede acceso a la aplicaciĆ³n Account Geolocation (GeolocalizaciĆ³n de cuentas))
- Label (Etiqueta):
- Haga clic en Save (Guardar).
- En Apps (Aplicaciones), haga clic en Object Settings (ConfiguraciĆ³n del objeto).
- Haga clic en Account Locator (Localizador de cuentas).
- Haga clic en Edit (Modificar).
- En Tab Settings (ConfiguraciĆ³n de ficha), seleccione Available (Disponible) y Visible (Visible) y luego haga clic en Save (Guardar).
A continuaciĆ³n, asĆgnese el conjunto de permisos. MĆ”s adelante veremos cĆ³mo automatizar la asignaciĆ³n de conjuntos de permisos desde Salesforce CLI.
- En Setup (ConfiguraciĆ³n), escriba
Users
(Usuarios) en el cuadro Quick Find (BĆŗsqueda rĆ”pida) y, a continuaciĆ³n, haga clic en Users (Usuarios). - Haga clic en el usuario con el nombre completo
User, User
(Usuario, Usuario) en la tabla. - Haga clic en Permission Set Assignments (Asignaciones de conjuntos de permisos).
- En la secciĆ³n Permission Set Assignments (Asignaciones de conjuntos de permisos), haga clic en Edit Assignments (Modificar asignaciones).
- Agregue el conjunto de permisos
Geolocation
(GeolocalizaciĆ³n) al cuadro Enabled Permission Sets (Conjuntos de permisos activados). - Haga clic en Save (Guardar).
Por si tiene dudas, User, User (Usuario, Usuario) es el nombre completo predeterminado que se asigna al administrador del sistema en una organizaciĆ³n borrador. Si quiere usar otro nombre mĆ”s divertido, puede cambiarlo en Setup (ConfiguraciĆ³n).
La magia de los metadatos: recuperar los cambios en el proyecto
Hasta ahora en este mĆ³dulo, ha trabajado en su proyecto local y ha enviado los metadatos a la organizaciĆ³n borrador. En este paso, ha hecho algunos cambios directamente en la organizaciĆ³n borrador. Ahora es cuando se produce la magia. Con un Ćŗnico comando, puede recuperar en el proyecto local todos los metadatos que ha modificado en la organizaciĆ³n borrador.
Pero antes de hacerlo, hay que configurar el archivo .forceignore
para ignorar la sincronizaciĆ³n de algunos datos. Al crear la ficha Account Locator (Localizador de cuentas) y asignar su visibilidad a todos los perfiles, el control de cambios automĆ”tico de la organizaciĆ³n borrador detectĆ³ que los perfiles habĆan cambiado. Por supuesto, la prĆ³xima vez que extraiga metadatos de la organizaciĆ³n borrador para sincronizarlos con el proyecto local, la CLI querrĆ” extraer metadatos de los perfiles. Como los perfiles no se corresponden con la aplicaciĆ³n de geolocalizaciĆ³n y no son algo que haya que rastrear en el repositorio de control del cĆ³digo fuente de este proyecto, tenemos que indicarle a Salesforce CLI que debe ignorar los cambios en los perfiles.
En el directorio raĆz del proyecto de geolocalizaciĆ³n, abra el archivo .forceignore
y agregue **/profiles
en una nueva lĆnea. Luego, guarde el archivo. El archivo .forceignore
debe tener un aspecto similar a este:
Ya puede recuperar los metadatos. En la ventana de comandos, recupere los cambios que ha realizado en la organizaciĆ³n borrador en el proyecto local.
El resultado del comando project retrieve start
deberĆa ser algo parecido a esto:
Tenga en cuenta que no se han recuperado los cambios en los perfiles porque se ignoran con el comando .forceignore
.
Validar la aplicaciĆ³n
Aunque puede usar sin problemas la misma organizaciĆ³n borrador que ha usado durante las tareas de desarrollo para realizar las pruebas, le recomendamos empezar siempre con una nueva. Al usar una nueva, se asegura de haber externalizado correctamente todo el cĆ³digo fuente de la organizaciĆ³n.
- Cree una nueva organizaciĆ³n borrador.
- Implemente el cĆ³digo fuente y los metadatos locales en la organizaciĆ³n borrador.
- Asigne el conjunto de permisos.
- Cargue los datos de ejemplo en la organizaciĆ³n. Son los datos que ha exportado de una organizaciĆ³n borrador distinta en una unidad anterior.
- Abra la organizaciĆ³n.
- Pruebe la ficha Account Locator (Localizador de cuentas) y compruebe que todo funciona segĆŗn lo previsto. Desde App Launcher (Iniciador de aplicaciĆ³n), busque y seleccione Account Locator (Localizador de cuentas).

Enhorabuena. Ha creado y probado una nueva aplicaciĆ³n con la ayuda de organizaciones borrador y Salesforce CLI. No olvide agregarlo todo al repositorio de control del cĆ³digo fuente.
Recursos
- DocumentaciĆ³n de Salesforce: Referencia de comandos de Salesforce CLI
- DocumentaciĆ³n de Salesforce: GuĆa del desarrollador de Salesforce DX
- Video de Salesforce: Salesforce CLI: Harnessing the Power of Salesforce Through the Command Line (Salesforce CLI: aprovechando la potencia de Salesforce con la lĆnea de comandos)