Primeiros passos
Pastas de projetos
Agrupe projetos em pastas dentro de pastas na página Projetos, nas suas próprias pastas ou na árvore de pastas compartilhada de uma organização, e mova-os arrastando, pelo menu ou pelo teclado.
Nesta página
Visão geral
As pastas mantêm juntos os projetos de um programa: o projeto do sistema, os projetos dos subsistemas, os projetos de teste e os modelos dos fornecedores. Pastas ficam dentro de pastas, até oito níveis de profundidade. A página Projetos (Gerenciar projetos) as mostra como uma árvore ao lado da lista de projetos.
Há dois tipos de árvore de pastas:
- Minhas pastas: suas próprias pastas. Só você as vê. Elas contêm seus projetos que não estão em uma organização da qual você faz parte e os projetos que outras pessoas compartilharam com você.
- As pastas de uma organização: uma árvore por organização da qual você faz parte, a mesma para todos os membros. Os administradores a organizam; os administradores e os proprietários de um projeto arquivam projetos nela.
As pastas existem em todos os planos. As árvores de pastas de organização existem onde houver organizações.
Conceitos
Em qual árvore um projeto está
Cada projeto está em exatamente uma árvore para você, e em no máximo uma pasta dessa árvore.
| O projeto | A árvore dele para você |
|---|---|
| Pertence a uma organização da qual você é membro | A árvore dessa organização |
| Qualquer outro projeto que você pode abrir | Minhas pastas |
Um projeto no topo de uma árvore, sem pasta, é listado quando você seleciona a própria árvore.
Quem pode fazer o quê
| Ação | Minhas pastas | As pastas de uma organização |
|---|---|---|
| Ver as pastas | Você | Todos os membros |
| Criar, renomear, mover e excluir pastas | Você | Administradores da organização |
| Mover um projeto para dentro ou para fora de uma pasta | Você, para qualquer projeto que pode abrir | Administradores da organização e os proprietários do projeto |
| Registrado no log de auditoria da organização | Não | Sim: cada pasta criada, renomeada, movida ou excluída e cada projeto movido entre pastas |
Alguém de fora da organização com quem um dos projetos dela foi compartilhado nunca vê os nomes das pastas da organização. Para essa pessoa, o projeto fica em suas próprias Minhas pastas, no topo até que ela o arquive.
Um projeto passa para outra árvore apenas quando sua organização muda (Compartilhar…). Ele então começa no topo da nova árvore.
Como usá-lo
Quando e por quê
Crie pastas quando vincular projetos entre si: um programa se torna uma pasta, com uma subpasta por subsistema ou fornecedor. A pasta passa a ser também o escopo do Mapa do programa, que mostra como os projetos nela se vinculam entre si.
Criar uma pasta
- Abra Gerenciar projetos.
- Selecione a árvore ou a pasta em que a nova pasta vai ficar.
- Clique em Nova pasta acima da lista.
- Digite um nome e pressione Enter.
Você vê a nova pasta na árvore, com 0 ao lado. O menu ⋯ de uma pasta também tem Nova subpasta…, e ⌘K / Ctrl+K → Nova pasta de projetos… cria uma no topo de Minhas pastas.
Mover projetos para uma pasta
- Selecione a pasta que contém os projetos, ou Todos os projetos.
- Arraste a linha de um projeto para uma pasta na árvore ou para a linha de uma pasta na lista.
Você vê "Mars Rover movido para Avionics." com Desfazer.
Para mover vários projetos de uma vez:
- Marque a caixa no início de cada linha. Shift+clique marca todas as linhas entre a última marcada e esta; a caixa no cabeçalho marca a lista inteira.
- Arraste uma das linhas marcadas para uma pasta ou clique em Mover para pasta… na barra acima da lista.
- Em Mover para pasta, escolha a pasta e clique em Mover.
Sem arrastar, use Mover para pasta… no menu ⋯ de um projeto, ou ⌘K / Ctrl+K → Mover projeto para pasta… com o projeto aberto. Nova pasta… nessa caixa de diálogo cria uma pasta dentro da escolhida.
Organizar pastas
- Renomear: selecione a pasta na árvore e pressione F2, ou ⋯ → Renomear….
- Mover: arraste a pasta para outra pasta da mesma árvore, ou ⋯ → Mover pasta…. Uma pasta nunca é movida para dentro de si mesma nem de uma de suas subpastas.
- Excluir: ⋯ → Excluir pasta…, ou Delete na árvore. Seus projetos e subpastas sobem para a pasta-mãe; nenhum projeto é excluído. Uma subpasta movida para cima cujo nome já é usado ali recebe um número, como Power (2).
Cada mudança mostra uma mensagem com Desfazer.
Encontrar um projeto em qualquer pasta
Digite em Localizar um projeto. A pesquisa procura em todas as pastas, seja qual for a seleção, e corresponde a nomes, descrições, ids de projeto e caminhos de pastas. A coluna Pasta mostra onde está cada resultado.
Exemplo prático: um programa CubeSat
- Crie a demonstração CubeSat EO-1 (Arquivos de projeto ▾ → Novo projeto de demonstração).
- Clique em Minhas pastas, depois em Nova pasta, e dê o nome EO-1 Program.
- Com EO-1 Program selecionada, clique em Nova pasta duas vezes: Spacecraft e Ground Segment.
- Selecione Todos os projetos e arraste CubeSat EO-1 para Spacecraft.
- Abra ⋯ de EO-1 Program → Abrir no Mapa do programa. O mapa mostra todos os projetos da pasta do programa e de suas subpastas.
Dicas e boas práticas
- Dê às pastas nomes de programas, sistemas e fornecedores, não de pessoas: as árvores de pastas duram mais do que as equipes.
- Reserve as pastas compartilhadas de uma organização para os programas dela. Arquive experimentos pessoais em Minhas pastas.
- Use Abrir no Mapa do programa em uma pasta de programa antes de uma revisão para ver quais vínculos estão faltando.
Erros comuns
- "Avionics é uma pasta de Acme. Mova … para Acme com Compartilhar… antes." Você soltou um projeto de outra árvore em uma pasta de organização. Altere a organização do projeto em Compartilhar… ou arquive-o em Minhas pastas.
- "Somente os proprietários do projeto e os administradores de … podem arquivar …" Na árvore de uma organização, os membros que não são proprietários não podem mover projetos. Peça a um proprietário ou a um administrador.
- Uma pasta parece vazia depois de uma pesquisa. A lista está mostrando resultados de pesquisa de todas as pastas. Limpe Localizar um projeto.
Como se conecta
- Mapa do programa: uma pasta é um escopo (menu Escopo, ou ⋯ de uma pasta → Abrir no Mapa do programa).
- Vínculos com outros projetos: as pastas agrupam os projetos que se vinculam entre si.
- API e MCP: list_projects e
GET /api/v1/projectsfornecem o caminhofolderde cada projeto. - Importar e exportar: a exportação de um projeto registra o caminho da pasta; uma importação o recria em Minhas pastas.
A página Projetos
Árvore de pastas
| Elemento | O que ele faz |
|---|---|
| Todos os projetos | Todos os projetos que você pode abrir, em uma lista |
| O nome de uma organização | A árvore compartilhada dessa organização: seus projetos no nível superior e suas pastas |
| Minhas pastas | Sua própria árvore |
| Uma pasta | Lista suas subpastas e os projetos diretamente nela |
| Número ao lado de um nó | Projetos nela e em suas subpastas |
| ▸ / ▾ | Mostra ou oculta as subpastas (lembrado neste navegador) |
Clique com o botão direito em uma pasta, ou pressione Shift+F10, para ver o menu dela: Nova subpasta…, Renomear…, Mover pasta…, Abrir no Mapa do programa, Excluir pasta…. Na árvore de uma organização, os membros que não são administradores veem apenas Abrir no Mapa do programa.
Acima da lista
- Trilha de navegação: o caminho da pasta selecionada, como Minhas pastas › EO-1 Program › Spacecraft. Clique em uma parte para subir.
- Barra de seleção: aparece enquanto há linhas marcadas: n projetos selecionados, Mover para pasta…, Limpar seleção.
Na lista
- As linhas de pastas vêm primeiro: o nome da pasta e a contagem de projetos, e ⋯ para o menu dela. Clique no nome para abrir a pasta.
- As linhas de projetos começam com uma caixa de seleção. Arraste uma linha por qualquer parte que não seja seu link, botão ou caixa.
- Uma pasta vazia diz "Esta pasta está vazia." com Nova subpasta e, em Minhas pastas, + Novo projeto. Um novo projeto vai para a pasta selecionada de Minhas pastas; escolha outra em Pasta na caixa de diálogo Novo projeto.
Preferências do projeto
Pasta em Preferências do projeto… lista as pastas da árvore do projeto. Fica acinzentado onde você não pode arquivar o projeto.
Teclado e leitores de tela
A árvore de pastas é uma única parada de Tab.
| Tecla | Ação |
|---|---|
| ↑ / ↓ | Pasta anterior ou próxima |
| → | Mostrar as subpastas de uma pasta, ou ir para a primeira |
| ← | Ocultar as subpastas, ou ir para a pasta-mãe |
| Home / End | Primeira ou última pasta |
| Enter ou Space | Mostrar a pasta na lista |
| F2 | Renomear a pasta |
| Delete | Excluir a pasta (pergunta antes) |
| Shift+F10 | O menu da pasta |
| Uma letra | A próxima pasta cujo nome começa com ela |
Os leitores de tela anunciam o nome e a contagem de projetos de cada pasta, se ela está expandida e cada movimento, renomeação, exclusão e desfazer à medida que acontecem.
Limites
| Limite | Valor |
|---|---|
| Nome da pasta | 1 a 80 caracteres |
| Profundidade das pastas | 8 níveis |
| Pastas por árvore | 1,000 |
| Mesmo nome | Não duas vezes na mesma pasta (maiúsculas e minúsculas não contam) |
Mensagens
| Mensagem | Significado |
|---|---|
| Já existe uma pasta chamada "…". Escolha outro nome. | A pasta que você está nomeando ou para a qual está movendo já tem uma pasta com esse nome |
| As pastas se aninham em no máximo 8 níveis. Escolha uma pasta mais acima. | A pasta nova ou movida ficaria a mais de 8 níveis |
| Uma pasta não pode ser movida para dentro de si mesma nem de uma de suas subpastas. | Escolha uma pasta fora da que você está movendo |
| Somente um administrador desta organização pode alterar as pastas dela. | Peça a um administrador da organização |
| Os projetos selecionados estão em árvores de pastas diferentes (…). Selecione projetos de uma única árvore. | Mova os projetos de cada árvore separadamente |