Utiliser l'explorateur de fichiers IDE

Vous pouvez accéder à l'IDE Looker via le menu Développer de Looker. Pour plus d'informations et d'autres options, consultez la section Accéder aux fichiers du projet.

L'IDE Looker prend en charge les dossiers pour les fichiers de votre projet. Les dossiers sont affichés dans le volet de navigation de gauche de l'IDE.

Si votre projet Looker n'est pas organisé en dossiers, il présentera une structure de fichiers plate, dont les fichiers seront classé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 le fichier actuellement ouvert et l'état développé ou réduit du panneau File Browser (Navigateur 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 File Browser (Navigateur 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 des dossiers et des 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 distants sont listés dans le dossier imported_projects. Sélectionnez un fichier de projet importé dans la liste des fichiers de l'imported_projects pour afficher son contenu.

Comme ils ne peuvent pas être modifiés, les fichiers du projet importés ne sont pas visibles lorsque vous modifiez des fichiers de manière groupée dans l'IDE afin de les déplacer ou de les supprimer.

Organiser un projet existant avec des dossiers IDE

Si votre projet disposait auparavant de l'ancienne structure de fichiers plats ou si vous souhaitez réorganiser les fichiers dans un dossier, vous pouvez choisir de conserver cette structure. Toutefois, si vous choisissez d'organiser les fichiers de votre projet dans des dossiers, nous vous recommandons vivement de vous préparer comme suit:

• 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 des modifications non déployées, ses branches reflètent la structure de fichiers qui existait la dernière fois qu'il a été extrait de la production. Si le projet avait une structure de fichiers plats à ce moment-là, la version du fichier du développeur sera envoyée en production à son emplacement d'origine. Vous aurez donc deux copies du fichier. En outre, si un développeur annule le déploiement de modifications pendant la migration vers des dossiers, il sera confronté à un conflit de fusion lorsqu'il les récupérera de l'environnement de production après la migration.
• Imposez un gel temporaire du code à tous vos développeurs jusqu'à ce que le projet ait été entièrement migré vers la nouvelle structure de répertoires.
• Attribuez le déplacement des fichiers à un seul développeur. La procédure suivante suppose qu'un seul développeur migre le projet vers des dossiers IDE. Si plusieurs développeurs doivent déplacer des fichiers, répartissez-les 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 le déploiement 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 autre 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 cet emplacement.

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

Attribuez à un seul développeur toutes 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 effectuant la migration vers les dossiers de l'IDE.
2. Vérifiez que tous les autres développeurs ont cessé d'apporter des modifications au projet.
3. Extraire de la production.
4. Créez les dossiers du projet.
5. Déplacez les fichiers du projet dans les dossiers, soit un fichier à la fois, soit en utilisant la modification groupée.
6. Validez le code LookML du projet. Vous devriez rencontrer 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 rencontrer des erreurs de validation LookML pour des objets référencés qui ne sont plus disponibles, car leurs chemins d'accès aux fichiers 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 une solution temporaire aux avertissements et erreurs de validation LookML résultant d'instructions include. En utilisant les fichiers de vue comme exemple, vous pouvez spécifier include: "/**/*.view" pour inclure tous les fichiers de tous les dossiers de votre projet. Vous éviterez ainsi les problèmes de validation LookML pendant que vous poursuivez le développement. Toutefois, cette solution n'est pas recommandée sur le long terme, car inclure plus de fichiers que nécessaire peut affecter 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 du projet.