Como trabalhar com o navegador de arquivos do ambiente de desenvolvimento integrado

Você pode acessar o Looker IDE pelo menu Desenvolver do Looker. Consulte Como acessar arquivos de projeto para saber mais e conferir outras opções.

O ambiente de desenvolvimento integrado do Looker oferece suporte a pastas para arquivos de projeto. As pastas são mostradas no painel de navegação à esquerda do ambiente de desenvolvimento integrado.

Se o projeto do Looker não estiver organizado em pastas, ele terá uma estrutura de arquivos simples, com arquivos listados em ordem alfabética no painel File Browser. Consulte Como organizar um projeto com pastas do ambiente de desenvolvimento integrado para mais informações sobre como atualizar seu projeto para usar essas pastas.

O ambiente de desenvolvimento integrado do Looker mantém o arquivo aberto e o status aberto ou fechado do painel File Browser. Você pode redefinir a persistência nas Configurações do ambiente de desenvolvimento integrado.

Selecione os ícones na barra de ferramentas na parte de cima do painel Navegador de arquivos para recolher todas as pastas, mover e excluir arquivos e pastas, pesquisar um arquivo de projeto ou criar novas pastas e novos arquivos.

Pasta de projetos importados

Se você importar um projeto, o Looker IDE criará automaticamente uma pasta imported_projects. Os arquivos de projetos locais e projetos remotos são listados na pasta imported_projects. Selecione um arquivo de projeto importado na lista de arquivos no imported_projects para conferir o conteúdo dele.

Como eles não podem ser editados, os arquivos de projeto importados não ficam visíveis quando você edita arquivos em massa no ambiente de desenvolvimento integrado para mover ou excluir esses arquivos.

Organizar um projeto atual com pastas do ambiente de desenvolvimento integrado

Se o projeto já tinha a estrutura de arquivo simples legada ou se você quiser reorganizar os arquivos em uma pasta, é possível manter essa estrutura. No entanto, se você optar por organizar os arquivos do projeto em pastas, recomendamos fazer o seguinte:

• Planeje a estrutura do arquivo com antecedência com todos os desenvolvedores.
• Verifique se todos os desenvolvedores do Looker implantaram todas as atualizações na produção. Se um desenvolvedor tiver mudanças não implantadas, as ramificações vão refletir a estrutura de arquivos que existia na última vez que elas foram extraidas da produção. Se o projeto tiver uma estrutura de arquivo simples, a versão do desenvolvedor do arquivo será enviada para produção no local original. Assim, você terá duas cópias do arquivo. Além disso, se um desenvolvedor tiver desfeito mudanças durante a migração para pastas, ele vai enfrentar um conflito de mesclagem ao extrair da produção após a migração.
• Ative um congelamento temporário do código com todos os desenvolvedores até que o projeto seja totalmente migrado para a nova estrutura de diretórios.
• Atribua um único desenvolvedor para mover os arquivos. O procedimento a seguir pressupõe que um único desenvolvedor migrará o projeto para as pastas do ambiente de desenvolvimento integrado. Se você precisar que vários desenvolvedores movam arquivos, divida a tarefa entre os desenvolvedores para evitar conflitos de mesclagem. Se você encontrar conflitos de mesclagem, consulte a página de documentação Usar o controle de versão e a implantação para saber como resolvê-los.

Observação: ao mover um arquivo no Git, você exclui o arquivo e cria um novo com um novo caminho. Isso significa que o histórico do Git para o arquivo estará vazio, porque o Git vai considerá-lo como um novo arquivo. Para conferir o histórico do Git do arquivo antes da mudança, use a interface do Git para navegar até o arquivo no local original e conferir o histórico do Git.

Depois que todos os desenvolvedores enviarem e confirmarem as mudanças e pausarem todo o trabalho no projeto, você poderá migrar o projeto para a nova estrutura de diretórios.

Atribua a um único desenvolvedor a realização das seguintes etapas:

1. Verifique se todas as atualizações em todas as ramificações de desenvolvimento foram implantadas na produção. Isso inclui as ramificações de desenvolvimento do desenvolvedor que está realizando a migração para pastas do ambiente de desenvolvimento integrado.
2. Verifique se todos os outros desenvolvedores pararam de fazer mudanças no projeto.
3. Extrair da produção.
4. Crie as pastas do projeto.
5. Mova os arquivos do projeto para as pastas um por vez ou usando a edição em massa.
6. Valide o LookML do projeto. É esperado que você tenha vários erros e avisos do LookML, já que as instruções include e map_layer usam referências a locais de arquivos que provavelmente foram movidos durante esse procedimento.

7. Atualize as instruções include e map_layer no seu projeto para corresponder ao novo caminho do arquivo. Além disso, você pode encontrar erros de validação do LookML para objetos referenciados que não podem mais ser encontrados porque os caminhos de arquivo mudaram. Para mais informações, consulte a documentação sobre como usar include com pastas do ambiente de desenvolvimento integrado e sobre como usar map_layer com pastas do ambiente de desenvolvimento integrado.

   Dica:é possível usar caracteres curinga para criar uma correção temporária para avisos e erros de validação do LookML resultantes de instruções include. Usando arquivos de visualização como exemplo, é possível especificar include: "/**/*.view" para incluir todos os arquivos em todas as pastas do projeto. Isso evita problemas de validação do LookML enquanto você continua desenvolvendo. No entanto, essa não é uma solução recomendada para o longo prazo, já que incluir mais arquivos do que o necessário pode afetar o desempenho.

8. Confirme as alterações.

9. Implantar as atualizações na produção.

10. Informe aos outros desenvolvedores do Looker que agora eles podem extrair as atualizações da produção e retomar o desenvolvimento no projeto.