Cómo trabajar con el navegador de archivos del IDE

Puedes acceder al IDE de Looker a través del menú Develop de Looker. Consulta Cómo acceder a los archivos de proyecto para obtener más 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.

Si tu proyecto de Looker no está organizado en carpetas, tendrá una estructura de archivos plana, con los archivos en orden alfabético en el panel Navegador de archivos. Consulta Organiza un proyecto existente con carpetas de IDE para obtener información sobre cómo actualizar tu proyecto para usar carpetas de IDE.

El IDE de Looker conserva el archivo que tienes abierto y el estado expandido o cerrado del panel File Browser. 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 los proyectos remotos se enumeran en la carpeta imported_projects. Selecciona un archivo de proyecto importado de la lista de archivos en imported_projects para ver su contenido.

Debido a que no se pueden editar, los archivos de proyectos importados no son visibles cuando editas varios archivos en el IDE para moverlos o borrarlos.

Cómo organizar un proyecto existente con carpetas del IDE

Si tu proyecto tenía la estructura de archivo plano heredado o si deseas reorganizar los archivos en una carpeta, puedes optar por mantener esta estructura. Sin embargo, si decides organizar los archivos de tu proyecto en carpetas, te recomendamos que realices los siguientes preparativos:

• Planifica la estructura de archivos con anticipación con todos los desarrolladores.
• Asegúrate de que todos los desarrolladores de Looker hayan implementado todas sus actualizaciones en producción. Si un desarrollador no implementó los cambios, sus ramas reflejarán la estructura de archivos que existía cuando extrajo de producción por última vez. 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 terminarás con dos copias del archivo. Además, si un desarrollador no implementó los cambios durante la migración a las carpetas, se enfrentará a un conflicto de combinación cuando extraiga de producción después de la migración.
• Aplica una inmovilización de código temporal con todos tus desarrolladores hasta que el proyecto se haya migrado por completo a la nueva estructura de directorios.
• Asigna un solo desarrollador para que mueva los archivos. En el siguiente procedimiento, se supone que un solo desarrollador migrará el proyecto a las carpetas del IDE. Si necesitas que varios desarrolladores muevan archivos, divide la tarea entre ellos para evitar conflictos de combinación. Si encuentras conflictos de combinación, consulta la página de documentación Cómo usar el control de versión y realizar implementaciones para obtener información sobre cómo resolverlos.

Nota: Ten en cuenta que, cuando mueves un archivo en Git, lo borras y creas uno nuevo con una ruta de acceso nueva. Esto significa que el historial de Git del archivo estará vacío, ya que Git lo considerará un archivo nuevo. Para ver el historial de Git del archivo antes de que se moviera, usa la interfaz de Git para navegar al archivo en su ubicación original y ver el historial de Git desde allí.

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

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

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 realizar 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 ubicaciones de archivos que probablemente se hayan movido durante este procedimiento.

7. Actualiza las sentencias include y map_layer de tu proyecto para que coincidan con la nueva ruta 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 de archivos. Para obtener más información, consulta la documentación sobre el uso de include con carpetas de IDE y sobre el uso de map_layer con carpetas de IDE.

   Sugerencia: Puedes usar comodines para crear una solución temporal para las advertencias y los errores de validación de LookML que se generan a partir de las sentencias include. Tomando como ejemplo los archivos de vista, puedes especificar include: "/**/*.view" para incluir todos los archivos de todas las carpetas de tu proyecto. Esto evitará problemas de validación de LookML mientras continúas con el desarrollo. Sin embargo, esta no es una solución recomendada a largo plazo, ya que incluir más archivos de los necesarios puede afectar el rendimiento.

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.