La forma más fácil de acceder al IDE de Looker es a través del menú Desarrollo de Looker. Consulta Accede a archivos del proyecto 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. Si los desarrolladores de Looker no organizaron los archivos de tu proyecto en carpetas, el proyecto tendrá una estructura de archivos plana, con archivos ordenados alfabéticamente en el panel Navegador de archivos.
Este es un proyecto de ejemplo en el que un desarrollador agregó carpetas para diferentes tipos de archivos de proyecto, como Exploraciones, modelos y vistas:
Puedes seleccionar los íconos de la barra de herramientas en la parte superior del panel Navegador 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.
Contraer la barra lateral del IDE
Puedes ocultar o mostrar el navegador de archivos del IDE con la combinación de teclas Command-B (Mac) o Ctrl+B (Windows), o bien selecciona el ícono del navegador de archivos:
Cómo administrar archivos y carpetas
Cada archivo o carpeta del panel lateral izquierdo tiene un menú que muestra las acciones disponibles para ese elemento. Selecciona el menú de tres puntos Acciones de carpetas (para las carpetas) o el menú Acciones de archivo (File Actions) (para los archivos) a la derecha del nombre del archivo para abrir el menú. En el caso de un elemento que tiene un nombre largo o que está anidado en varias carpetas, puedes acceder al menú desplazándote por el panel izquierdo.
Puedes crear carpetas y archivos, subir archivos, y borrarlos y moverlos con el navegador de archivos. Para obtener más información, consulta la página de documentación Cómo administrar archivos y carpetas de LookML.
Cuando organizas tus archivos de LookML con carpetas, debes confirmar los cambios y implementarlos en producción para que otros desarrolladores de Looker puedan verlos. Este es como cualquier cambio que realices en tu proyecto de LookML.
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 en imported_projects para ver su contenido.
Debido a que no se pueden editar, los archivos de proyecto importados no son visibles cuando se editan de forma masiva los archivos en el IDE para mover o borrar esos archivos.
Organizar un proyecto existente con carpetas del IDE
Si tu proyecto antes tenía la estructura de archivos planos heredada o si deseas reorganizar los archivos en una carpeta, puedes optar por conservar esta estructura; pero si eliges organizar los archivos del proyecto en carpetas, te recomendamos que realices las siguientes preparaciones:
- Planifica la estructura de archivos con anticipación con todos los desarrolladores.
- Asegúrate de que todos tus desarrolladores de Looker hayan implementado todas sus actualizaciones en la producción. Si un desarrollador anuló la implementación de cambios, sus ramas reflejarán la estructura de archivos que existía cuando se extrajeron de producción por última vez. Si el proyecto tenía una estructura de archivos plana en ese momento, la versión del archivo del desarrollador se enviará a producción en su ubicación original, por lo que obtendrás dos copias del archivo. Además, si un desarrollador anuló la implementación de cambios durante la migración a las carpetas, se enfrentará a un conflicto de combinación cuando extraiga datos de la producción después de la migración.
- Inhabilita temporalmente el código 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 procedimiento que aparece a continuación, 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 e implementar para obtener información sobre cómo resolverlos.
Una vez que todos los desarrolladores hayan enviado y confirmado sus cambios, y 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 pasos siguientes:
- 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 realizan la migración a carpetas del IDE.
- Verifica que todos los demás desarrolladores hayan dejado de realizar cambios en el proyecto.
- Extrae de producción.
- Crea las carpetas del proyecto.
- Mueve los archivos del proyecto a las carpetas, ya sea un archivo a la vez o con la edición masiva.
- Valida el LookML del proyecto. Se espera que tengas varios errores y advertencias de LookML, ya que las sentencias
includeymap_layerusan referencias a las ubicaciones de los archivos que probablemente se trasladaron durante este procedimiento. Actualiza las sentencias
includeymap_layerde tu proyecto para que coincidan con la ruta nueva del archivo. Además, es posible que veas errores de validación de LookML para los objetos a los que se hace referencia que ya no se pueden encontrar debido a que cambiaron las rutas de acceso a los archivos. Para obtener más información, consulta la documentación sobre cómo usarincludecon carpetas IDE y cómo usarmap_layercon carpetas IDE.Informa a los otros desarrolladores de Looker que ahora pueden extraer las actualizaciones de producción y reanudar el desarrollo en el proyecto.