2.1 Llevando Power Pages a Visual Studio Code

Desarrolla código Liquid y web templates desde la comodidad de VS Code.

Desarrollar portales web directamente en el navegador es útil para cambios rápidos, pero si quieres escribir CSS avanzado, JavaScript estructurado o plantillas Liquid complejas, el navegador se queda corto. Es hora de llevar Power Pages a tu entorno local.

Objetivos de aprendizaje

  • Descargar todo el código de un sitio web de Power Pages a tu máquina.
  • Entender las ventajas de editar el portal en Visual Studio Code.
  • Sincronizar tus cambios locales de vuelta a Dataverse.

 

Liberando tu código del navegador

Laura es desarrolladora web y le acaban de asignar la personalización de un portal de atención al cliente en Power Pages. Al principio, intentó usar el editor de código integrado en el navegador, pero le frustraba no tener autocompletado avanzado, no poder buscar texto en todos los archivos a la vez, y el riesgo de perder cambios si cerraba la pestaña por error.

Aquí es donde el comando pac paportal brilla con fuerza. En lugar de pelear con la web, Laura simplemente ejecuta:

pac paportal list

Este comando le muestra el ID de todos los sitios web instalados en su entorno activo. Una vez identifica el suyo, se lo descarga a su carpeta local:

pac paportal download --path "C:\Proyectos\MiPortal" --websiteId a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d

 

El flujo de trabajo profesional

Con el código en tu máquina, ahora puedes hacer cosas de desarrollador real: puedes inicializar un repositorio Git, puedes buscar y reemplazar texto globalmente (¡adiós a buscar en qué plantilla estaba ese código obsoleto!), y puedes usar extensiones para formatear tu HTML y CSS.

Cuando terminas de hacer tus modificaciones en las plantillas Liquid, JavaScript o hojas de estilo, es hora de enviarlo de vuelta:

pac paportal upload --path "C:\Proyectos\MiPortal\NombreDelPortal"

Este comando lee todos los archivos locales y actualiza los registros correspondientes en Dataverse. Luego, solo tienes que limpiar la caché del portal para ver tus cambios reflejados.

Consejo práctico: Siempre inicializa un repositorio de Git local justo después de hacer el primer download. Así, si estropeas una plantilla web mientras trabajas, puedes deshacer los cambios fácilmente sin tener que volver a descargar la versión de Dataverse.

 

Puntos clave

  • pac paportal download transforma registros de Dataverse en archivos de texto editables localmente.
  • Visual Studio Code es infinitamente superior para escribir Liquid y JavaScript que los editores web embebidos.
  • Sube tus cambios en bloque con upload para mantener el portal sincronizado.
Inicia sesión e inscríbete para guardar tu progreso.
Siguiente tema →
← Volver al curso