Utiliser le navigateur de fichiers de l'IDE

Organisez plus efficacement les fichiers de votre projet Looker à l'aide de dossiers dans l'IDE Looker. Les dossiers empêchent une structure de fichiers plate et triée par ordre alphabétique, ce qui facilite la gestion et la navigation dans les projets complexes. Accédez à l'IDE Looker via le menu Développer de Looker. Les dossiers s'affichent dans le volet de navigation de gauche de l'IDE. Pour en savoir plus et découvrir d'autres options d'accès aux fichiers de projet, consultez Accéder aux fichiers de projet.

Si votre projet Looker n'est pas organisé en dossiers, il aura une structure de fichiers plate, avec des fichiers listés par ordre alphabétique dans le panneau Explorateur de fichiers. Pour savoir comment mettre à jour votre projet afin d'utiliser des dossiers IDE, consultez Organiser un projet existant avec des dossiers IDE.

L'IDE Looker conserve votre fichier ouvert et l'état développé ou réduit du panneau Explorateur de fichiers. Vous pouvez réinitialiser la persistance dans les paramètres de l'IDE.

Vous pouvez sélectionner les icônes de la barre d'outils en haut du panneau Explorateur de fichiers pour réduire tous les dossiers, déplacer et supprimer des fichiers et des dossiers, rechercher un fichier de projet ou créer de nouveaux dossiers et de nouveaux fichiers.

Dossier des projets importés

Si vous importez un projet, l'IDE Looker crée automatiquement un dossier imported_projects. Les fichiers des projets locaux et des projets à distance sont listés dans le dossier imported_projects. Sélectionnez un fichier de projet importé dans la liste des fichiers de imported_projects pour afficher son contenu.

Comme ils ne peuvent pas être modifiés, les fichiers de projet importés ne sont pas visibles lorsque vous modifiez des fichiers en bloc dans l'IDE pour les déplacer ou les supprimer.

Organiser un projet existant avec des dossiers IDE

Si votre projet avait auparavant une structure de fichiers plate héritée ou si vous souhaitez réorganiser les fichiers d'un dossier, vous pouvez choisir de conserver cette structure. Toutefois, si vous choisissez d'organiser les fichiers de votre projet en dossiers, nous vous recommandons vivement de prendre les mesures préparatoires suivantes :

• Planifiez la structure des fichiers à l'avance avec tous les développeurs.
• Assurez-vous que tous vos développeurs Looker ont déployé toutes leurs mises à jour en production. Si un développeur a annulé le déploiement de modifications, ses branches refléteront la structure de fichiers qui existait lors de sa dernière extraction de la production. Si le projet avait une structure de fichiers plate à ce moment-là, la version du fichier du développeur sera transférée en production à son emplacement d'origine. Vous vous retrouverez donc avec deux copies du fichier. De plus, si un développeur a annulé le déploiement de modifications lors de la migration vers des dossiers, il sera confronté à un conflit de fusion lorsqu'il extraira des données de production après la migration.
• Mettez en place un gel de code temporaire avec tous vos développeurs jusqu'à ce que le projet ait été entièrement migré vers la nouvelle structure de répertoire.
• Attribuez à un seul développeur le déplacement des fichiers. La procédure suivante suppose qu'un seul développeur migre le projet vers des dossiers IDE. Si vous avez besoin que plusieurs développeurs déplacent des fichiers, répartissez la tâche entre eux pour éviter les conflits de fusion. Si vous rencontrez des conflits de fusion, consultez la page de documentation Utiliser le contrôle des versions et déployer pour savoir comment les résoudre.

Remarque : Sachez que lorsque vous déplacez un fichier dans Git, vous le supprimez et en créez un avec un nouveau chemin d'accès. Cela signifie que l'historique Git du fichier sera vide, car Git le considérera comme un nouveau fichier. Pour afficher l'historique Git du fichier avant son déplacement, utilisez votre interface Git pour accéder au fichier à son emplacement d'origine et afficher l'historique Git à partir de là.

Une fois que tous vos développeurs ont transféré et validé leurs modifications et mis en pause tout travail sur le projet, vous pouvez migrer le projet vers sa nouvelle structure de répertoire.

Attribuez à un seul développeur les étapes suivantes :

1. Vérifiez que toutes les mises à jour de toutes les branches de développement ont été déployées en production. Cela inclut les branches de développement du développeur qui effectue la migration vers des dossiers IDE.
2. Vérifiez que tous les autres développeurs ont cessé d'apporter des modifications au projet.
3. Extrayez des données de production.
4. Créez les dossiers du projet.
5. Déplacez les fichiers du projet dans les dossiers, un par un ou en bloc.
6. Validez le code LookML du projet. Il est prévu que vous ayez plusieurs erreurs et avertissements LookML, car les instructions include et map_layer utilisent des références à des emplacements de fichiers qui ont probablement été déplacés au cours de cette procédure.

7. Mettez à jour toutes les instructions include et map_layer de votre projet pour qu'elles correspondent au nouveau chemin d'accès du fichier. De plus, vous pouvez voir des erreurs de validation LookML pour les objets référencés qui ne sont plus trouvés, car leurs chemins d'accès ont changé. Pour en savoir plus, consultez la documentation sur l'utilisation de include avec des dossiers IDE et sur l'utilisation de map_layer avec des dossiers IDE.

   Conseil : Vous pouvez utiliser des caractères génériques pour créer un correctif temporaire pour les avertissements et les erreurs de validation LookML résultant d'instructions include. En utilisant des fichiers de vue comme exemple, vous pouvez spécifier include: "/**/*.view" pour inclure tous les fichiers de tous les dossiers de votre projet. Cela empêchera les problèmes de validation LookML pendant que vous continuez à développer. Toutefois, il ne s'agit pas d'une solution recommandée à long terme, car l'inclusion de plus de fichiers que nécessaire peut avoir un impact sur les performances.

8. Validez les modifications.

9. Déployez les mises à jour en production.

10. Informez les autres développeurs Looker qu'ils peuvent désormais extraire les mises à jour de la production et reprendre le développement dans le projet.