Cómo trabajar con el navegador de archivos IDE

Puedes acceder al IDE de Looker a través del menú Desarrollar de Looker. Consulta Cómo acceder a archivos de proyectos para obtener detalles y otras opciones.

El IDE de Looker admite carpetas para los archivos de tu proyecto. Las carpetas se muestran en el panel de navegación izquierdo del IDE.

IDE de Looker con el navegador de archivos que muestra carpetas en un proyecto de ejemplo.

Si tu proyecto de Looker no está organizado en carpetas, tendrá una estructura de archivos plana, con archivos ordenados alfabéticamente en el panel File Browser. Consulta Cómo organizar un proyecto existente con carpetas IDE para obtener información sobre cómo actualizar tu proyecto y usar carpetas del IDE.

El IDE de Looker conserva el archivo abierto actualmente y el estado expandido o contraído del panel del navegador de archivos. Puedes restablecer la persistencia en la configuración del IDE.

Puedes seleccionar los íconos de la barra de herramientas en la parte superior del panel Explorador de archivos para contraer todas las carpetas, mover y borrar archivos y carpetas, buscar un archivo de proyecto o crear carpetas nuevas y archivos nuevos.

Carpeta de proyectos importados

Si importas un proyecto, el IDE de Looker crea automáticamente una carpeta imported_projects. Los archivos de los proyectos locales y de los proyectos remotos se enumeran en la carpeta imported_projects. Selecciona un archivo de proyecto importado de la lista de archivos de imported_projects para ver el contenido de ese archivo.

Como no se pueden editar, los archivos de proyecto importados no estarán visibles cuando edites archivos de forma masiva en el IDE para mover o borrar esos archivos.

Cómo organizar un proyecto existente con carpetas del IDE

Si tu proyecto ya tenía la estructura de archivos plana heredada o si deseas reorganizar los archivos en una carpeta, puedes optar por mantener esta estructura. pero si eliges organizar los archivos de tu proyecto en carpetas, te recomendamos que hagas lo siguiente:

  • Planificar la estructura de archivos por adelantado con todos los desarrolladores
  • Asegúrate de que todos los desarrolladores de Looker hayan implementado todas sus actualizaciones en producción. Si un desarrollador anuló la implementación de cambios, sus ramas reflejarán la estructura de archivos que existía la última vez que se quitaron de producción. Si el proyecto tenía una estructura de archivos plana en ese momento, la versión del desarrollador del archivo se enviará a producción en su ubicación original, por lo que tendrás dos copias del archivo. Además, si un desarrollador anuló la implementación de cambios durante la migración a carpetas, este enfrentará un conflicto de combinación cuando extraiga de la producción después de la migración.
  • Suspende el código temporal con todos tus desarrolladores hasta que el proyecto se haya migrado por completo a la nueva estructura de directorios.
  • Asigna a un solo desarrollador para que mueva los archivos. En el siguiente procedimiento, se da por sentado que un solo desarrollador migrará el proyecto a carpetas del IDE. Si necesitas que varios desarrolladores muevan archivos, divide la tarea entre ellos para evitar conflictos de combinación. Si se producen conflictos de combinación, consulta la página de documentación Implementa y usa el control de versión para obtener información sobre cómo resolverlos.

Una vez que todos los desarrolladores hayan enviado y confirmado sus cambios y hayan detenido todo el trabajo del proyecto, podrás migrar el proyecto a su nueva estructura de directorios.

Asigna a un solo desarrollador que realice todos los pasos siguientes:

  1. Verifica que todas las actualizaciones de todas las ramas de desarrollo se hayan implementado en producción. Esto incluye las ramas de desarrollo del desarrollador que realiza la migración a las carpetas del IDE.
  2. Verifica que todos los demás desarrolladores hayan dejado de hacer cambios en el proyecto.
  3. Extraer de producción.
  4. Crea las carpetas del proyecto.
  5. Mueve los archivos del proyecto a las carpetas, ya sea uno a la vez o con la edición masiva.
  6. Valida el código LookML del proyecto. Se espera que tengas varios errores y advertencias de LookML, ya que las sentencias include y map_layer usan referencias a las ubicaciones de los archivos que probablemente se hayan movido durante este procedimiento.
  7. Actualiza las instrucciones include y map_layer de tu proyecto para que coincidan con la nueva ruta de acceso del archivo. Además, es posible que veas errores de validación de LookML para los objetos a los que se hace referencia y que ya no se pueden encontrar porque cambiaron sus rutas de acceso a los archivos. Para obtener más información, consulta la documentación sobre cómo usar include con carpetas IDE y sobre cómo usar map_layer con carpetas IDE.

  8. Confirma los cambios.

  9. Implementa las actualizaciones en producción.

  10. Informa a los otros desarrolladores de Looker que ahora pueden extraer las actualizaciones de producción y reanudar el desarrollo en el proyecto.