Base de Conhecimento
Novo por aqui? O Preplanning Gantt permite que você esboce um projeto em uma linha do tempo dentro do Jira antes de criar itens reais do Jira. Mova coisas, teste ideias, acerte o plano — e só então transforme em trabalho de verdade. Pense nisso como um quadro branco para seu cronograma que fica ao lado do seu projeto.
Primeira instalação (admins)
Depois de instalar o Preplanning Gantt no Marketplace, um administrador do Jira deve fazer isto uma vez para o app aparecer nos projetos e sincronizar campos com o Jira. App settings está disponível apenas para admins.
- Abra Apps → Preplanning Gantt (página global do app).
- Clique em App settings.
- Abra a aba Access & mapping.
- Em Per-project settings, encontre o projeto onde o app deve aparecer e ative Show in project. Enquanto estiver desligado, a aba Preplanning Gantt permanece oculta nesse projeto.
- Clique em Edit template… desse projeto e mapeie os campos do Preplanning Gantt para os campos do Jira (datas de início/fim, summary, assignee e quaisquer outros campos necessários para Send to Jira / Sync / Import). Novos planos nesse projeto usam esse mapeamento.
- Opcional: permitir que um líder de projeto (ou outros não admins) editem mapeamentos — clique em Mapping access… do projeto (ou defina o padrão do site em Per-plan field mapping access) e conceda usuários ou grupos específicos. Por padrão, só administradores do Jira podem alterar mapeamentos.
Você também pode definir um mapeamento padrão do site com Edit site default mapping… na mesma aba; um template de projeto o substitui para novos planos nesse projeto.
Configuração de admin concluída? Continue em Primeiros passos para criar o primeiro plano.
Primeiros passos
Você pode abrir o Preplanning Gantt em dois lugares:
- Dentro de um projeto — procure a aba Preplanning Gantt no seu projeto Jira. Ela mostra os planos daquele projeto.
- Pelo menu Apps — a página global do Preplanning Gantt mostra todos os seus planos, agrupados por projeto.
Crie seu primeiro plano:
- Abra a aba Preplanning Gantt e clique em + New plan.
- Dê um nome (e uma descrição curta, se quiser).
- O plano abre. Adicione sua primeira tarefa e comece a arrastar coisas na linha do tempo.
Não se preocupe em acertar de primeira — um plano é um rascunho que você pode alterar a qualquer momento, e cria zero itens do Jira até você decidir.
Não vê a aba Preplanning Gantt no projeto? Um admin precisa ativar Show in project — veja Primeira instalação (admins).
Trabalhando com planos
Um plano é uma linha do tempo — geralmente um projeto, release ou iniciativa. Você pode ter quantos quiser.
- Abrir um plano — clique no cartão dele. O último plano que você abriu volta automaticamente na próxima vez.
- Renomear ou editar descrição — clique no menu ⋯ do cartão do plano → Rename (somente o proprietário).
- Excluir um plano — ⋯ → Delete. Você verá um aviso mostrando quantas tarefas ele contém.
- Favoritar — clique na estrela (☆) em um cartão para fixá-lo na aba Starred.
- Planos recentes — a página global mantém uma linha de planos que você abriu recentemente.
- Voltar à lista — clique em ← All plans no canto superior esquerdo enquanto edita.
Adicionar e organizar tarefas
Tarefas são as linhas do seu plano. Cada linha vira uma barra na linha do tempo.
- Adicionar uma tarefa — clique em + Add task abaixo da lista, ou passe o mouse sobre uma linha e clique em + para adicionar uma tarefa abaixo dela (filha).
- Adicionar na linha do tempo — clique em uma área vazia na faixa de datas de uma linha e uma nova tarefa aparece com essas datas.
- Criar uma checklist / hierarquia — tarefas podem ter subtarefas. Uma tarefa com filhos vira uma linha resumo que as agrupa.
- Recuar / remover recuo — selecione uma tarefa e pressione Tab para colocá-la sob a linha acima, ou Shift+Tab para tirá-la.
- Reordenar — mude a ordenação para Manual, depois arraste linhas para cima e para baixo.
- Marcos — marque uma tarefa como marco (uma data importante única, exibida como um losango ◆) no painel de detalhes.
- Recolher / expandir — clique no ▼ ao lado de uma linha resumo, ou use o botão ▲/▼ para recolher tudo de uma vez.
A linha do tempo
O lado direito é a visualização de calendário. As barras mostram quando cada tarefa acontece.
- Mover uma tarefa — arraste o meio da barra para a esquerda ou direita.
- Alterar a duração — arraste a borda esquerda ou direita da barra.
- Aproximar ou afastar — use Zoom para Day, Week, Month e Quarter. Hour aparece somente quando o modo por hora está ativo.
- Ir para hoje — clique em Today. Uma linha vertical marca o dia atual.
- Cancelar um arraste — pressione Esc enquanto arrasta para desfazer instantaneamente.
- Fins de semana e feriados — dias não úteis aparecem sombreados em cinza, e você pode ocultá-los completamente (veja Calendários abaixo).
Cometeu um erro? Use Undo (↶) e Redo (↷) no topo, ou pressione Ctrl/⌘+Z.
Modo por hora (precisão horária)
Por padrão, as tarefas usam somente datas — “começa segunda, termina sexta.” Ative Time precision / Hours mode em Settings → Display quando precisar de mais detalhe: “começa segunda às 9:00, termina quarta às 17:30.”
- Ativar — Settings → Display → marque Time precision / Hours mode.
- Zoom por hora — uma vez ativado, a opção Hour aparece em Zoom. Arrastar barras encaixa em horas.
- Zoom por dia ainda funciona — na visualização Day você ainda vê e mantém horários específicos ao mover tarefas.
- Detalhes da tarefa — os campos de início e fim mostram seletores de data e hora em vez de somente data.
O modo por hora é ótimo para entregas no mesmo dia, turnos ou qualquer coisa mais curta que um dia inteiro. Se você planeja somente em dias inteiros, deixe desativado — é mais simples.
O modo por hora só funciona de ponta a ponta se seu site Jira tiver os campos personalizados corretos. Os campos integrados do Jira (como Due date) armazenam somente datas — não conseguem manter um horário como 14:30.
Para que horários de início e fim sobrevivam ao Send to Jira, Sync e Import from Jira, seu administrador Jira precisa:
- Criar campos personalizados do tipo Date and time (não apenas Date) para início e fim planejados — um campo para início, outro para fim.
- Adicionar esses campos aos tipos de item que você usa (Story, Task, Epic, etc.).
- No Preplanning Gantt, abra Settings → Jira → Configure Jira fields… e mapeie Start date e End date para esses campos personalizados datetime.
Isso não é algo que você consiga corrigir somente dentro do Preplanning Gantt. Peça ao administrador Jira local para configurar antes de confiar no agendamento por hora com sincronização Jira. Sem campos datetime, horários podem ser descartados ou arredondados para meia-noite quando os dados se movem entre o plano e o Jira.
Vincular tarefas (dependências)
Uma dependência é uma regra que diz “esta tarefa depende daquela.” Por exemplo: você não pode pintar a parede até ela ser construída.
Para criar um vínculo: mude o modo para Dependencies, passe o mouse sobre uma barra até aparecerem pontos de ancoragem, depois arraste de uma barra para outra.
Existem quatro tipos de vínculos. Em palavras simples:
- Finish → Start (FS) — o mais comum. B começa depois que A termina. (“Construir, depois pintar.”)
- Start → Start (SS) — B começa quando A começa. (“Ambos começam juntos.”)
- Finish → Finish (FF) — B termina quando A termina. (“Ambos terminam juntos.”)
- Start → Finish (SF) — raro. B não pode terminar até A começar.
Você também pode adicionar lag — um intervalo em dias, como “começar 2 dias depois que a outra termina.” Para alterar ou remover um vínculo, clique na seta e pressione Delete, ou abra o painel de detalhes da tarefa e edite seus Predecessors / Successors.
Agendamento automático
O Preplanning Gantt pode mover tarefas vinculadas para você quando arrasta coisas, para que seu plano permaneça consistente. Você escolhe o quão agressivo isso é em Settings → Planning:
- Off — vínculos são apenas desenhados como setas; nada se move automaticamente.
- Forward — se você empurrar uma tarefa para depois e ela se sobrepuser a algo que depende dela, essa dependente também se move para depois. (Nunca puxa coisas para antes.)
- Strict — tarefas vinculadas permanecem firmemente conectadas sem lacunas.
- Group — mova uma tarefa e tudo vinculado a ela se desloca na mesma quantidade, como mover um trem de vagões.
Mais duas opções úteis:
- Parent dates — deixe uma linha resumo se esticar automaticamente para cobrir seus filhos.
- Move children with parent — arraste uma linha resumo e todas as subtarefas vêm junto.
Calendários e dias úteis
O Preplanning Gantt entende que as pessoas não trabalham nos fins de semana e feriados, então as durações correspondem à vida real.
- Dias úteis da semana — em Settings → Planning, ative ou desative seg–dom.
- Plan holidays — adicione folgas somente para este plano.
- Project holidays — defina folgas para todos os planos de um projeto, em Project holidays… na lista de planos.
- Show only working days — oculta colunas de fim de semana e feriados para uma linha do tempo mais compacta.
Linhas de base (antes e depois)
Uma baseline é um instantâneo salvo do seu plano — como tirar uma foto do cronograma hoje para ver depois o quanto as coisas mudaram.
- Salvar uma — abra o menu Baseline ▾ → Set baseline from current schedule. Você pode manter até três.
- Comparar — ative Baseline para ver barras fracas de “como era” atrás das atuais.
- Ver o desvio — os detalhes de uma tarefa mostram quantos dias ela se moveu (por exemplo “+3d” significa três dias de atraso).
- Renomear ou excluir — use os ícones de lápis e lixeira no menu de baseline.
Trabalhando com o Jira
É aqui que um plano se conecta ao trabalho real. Três coisas que você pode fazer:
Trazer itens existentes (Import)
Já tem itens no Jira? Traga-os para seu plano para agendá-los na linha do tempo. Vá em Settings → Data → Import from Jira, busque com um filtro, visualize e adicione-os.
Transformar seu plano em itens reais (Send to Jira)
Quando o plano estiver bom, clique em Send to Jira. Escolha o projeto e os tipos de item, selecione quais linhas criar, e o Preplanning Gantt cria itens reais do Jira — mantendo-os vinculados ao seu plano. Você pode enviar tudo, ou apenas algumas linhas selecionadas.
Se uma tarefa ainda usa uma virtual person ou virtual status, esses valores existem somente no plano. O Jira não tem entidades equivalentes, então não são enviados como estão.
Na transferência, o Preplanning Gantt os substitui pelos padrões do Jira — geralmente Unassigned para assignee e o initial workflow status do tipo de item para status. Após Send to Jira, defina responsáveis e status reais no Jira ou atualize as linhas vinculadas no plano.
Veja Pessoas virtuais e status para o panorama completo.
Mantê-los sincronizados
Uma vez que uma tarefa está vinculada a um item do Jira, elas podem permanecer atualizadas entre si:
- Sync on save — suas edições no plano podem fluir para o Jira quando você salva.
- Pull from Jira — obtenha o mais recente do Jira se alguém alterou o item lá.
- Needs attention — se algumas tarefas se desincronizaram, um botão ↻ Sync aparece para atualizá-las.
- Conflito? — se a mesma coisa mudou nos dois lugares, o Preplanning Gantt pergunta qual versão manter.
- Disconnect — desvincule uma linha do item Jira; a linha permanece no plano como rascunho.
Usando o modo por hora? Veja a seção de modo por hora — horários de início/fim só sincronizam de forma confiável quando seu administrador Jira configurou datetime custom fields e eles estão mapeados em Settings → Jira → Configure Jira fields….
Você também pode decidir o que acontece quando alguém exclui o item do Jira: desvincular a linha, mostrar um aviso ou remover a linha também.
Detalhes da tarefa e colunas
Clique em uma tarefa para abrir seu details panel à direita. Lá você pode definir:
- Nome, descrição, datas de início e fim
- Assignee, labels, components, priority, status
- Estimate (quanto trabalho representa)
- Progress — um controle deslizante de 0–100% que preenche a barra
- Marco ativado/desativado e uma cor de barra personalizada
- Suas dependências (predecessors e successors)
Salve com o botão Save ou Ctrl/⌘+Enter; feche com Esc.
Na lista de tarefas você também pode mostrar columns extras (assignee, dates, status, priority e mais). Clique no + no cabeçalho da coluna para escolher quais aparecem, e arraste a borda da coluna para redimensionar.
Pessoas virtuais e status
Enquanto elabora um plano, você pode inventar virtual people (papéis, departamentos, placeholders) e virtual statuses (rótulos de fluxo locais do plano) que ainda não existem no Jira. São úteis para workshops e agendamento inicial — atribua trabalho e colore o quadro antes da equipe ou do fluxo de trabalho estar definido.
- Virtual people — adicione nomes em Settings → People → Virtual people…. Aparecem no painel People e no seletor de assignee com o rótulo (virtual).
- Virtual statuses — adicione rótulos em Settings → Display → Virtual statuses…. Use-os na coluna Status enquanto o plano ainda é rascunho.
Virtual people e virtual statuses permanecem somente dentro do Preplanning Gantt. São exibidos na linha do tempo, em colunas e no painel People — mas o Jira não tem equivalente para eles.
Não há problema em usá-los enquanto planeja. Só lembre: no momento em que você Send to Jira ou transforma linhas do plano em itens reais, esses valores virtuais não podem ser importados para o Jira como estão.
Quando tarefas saem do plano para o Jira, assignees e statuses virtuais são substituídos por valores padrão do Jira — tipicamente:
- Virtual person → Unassigned (ou assignee vazio no novo item)
- Virtual status → o initial workflow status do tipo de item naquele projeto
Após a transferência, escolha usuários e status reais do Jira para esses itens, ou atualize as linhas vinculadas no seu plano quando a sincronização estiver ativa. Não confie que rótulos virtuais sobrevivam ao Send to Jira inalterados.
Quem está ocupado (painel People)
A faixa abaixo da linha do tempo é um workload heatmap. Mostra, dia a dia, quanto cada pessoa tem no prato — para identificar quem está sobrecarregado. Pessoas virtuais também aparecem aqui (marcadas (virtual)) enquanto você planeja; veja Pessoas virtuais e status para o que acontece ao enviar trabalho ao Jira.
- Alterne entre number of tasks e hours per day.
- Células mais escuras significam mais trabalho.
- Clique em uma célula para filtrar rapidamente as tarefas daquela pessoa naquele dia.
Encontrar tarefas (busca e filtros)
- Search by name — abra Filter e digite parte do nome de uma tarefa.
- Filter by field — refine por assignee, status, priority, type, labels, dates e mais.
- Filter with JQL — se você conhece a linguagem de consulta do Jira, também pode usá-la aqui.
- Sort — ordene linhas manualmente, ou por data de início ou fim.
Cores e aparência
Em Settings → Display você pode tornar o gráfico mais fácil de ler:
- Color bars by assignee, issue type, status, hierarchy level ou suas próprias cores personalizadas.
- Critical path — destaque as tarefas que determinam sua data final; todo o resto escurece.
- O Preplanning Gantt segue automaticamente o light or dark theme do Jira.
Compartilhamento e quem pode ver
Planos novos são private por padrão — somente você e as pessoas que convidar podem vê-los.
- Owner — a pessoa que criou o plano; controle total, incluindo compartilhamento e exclusão.
- Editor — pode alterar as tarefas e configurações do plano.
- Viewer — pode ver, mas não alterar (verá um distintivo View only).
Para compartilhar, abra ⋯ → Share do cartão do plano e adicione pessoas, grupos ou papéis de projeto como View only ou Can edit.
Nota: para Send to Jira, uma pessoa precisa de permissão para create issues naquele projeto Jira. Planejar em si não exige essa permissão.
Fazer muitas coisas de uma vez
Precisa alterar muitas tarefas juntas? Clique em Bulk para ativar caixas de seleção.
- Selecione linhas (Shift+clique para um intervalo, Ctrl/⌘+clique uma por vez).
- Edit — altere dates, assignee, status, priority, labels de todas de uma vez.
- Delete — remova várias tarefas juntas.
- Disconnect from Jira — desvincule muitas linhas sem excluí-las.
Importar, exportar e modelos
- Import / export files — traga tarefas de uma planilha (CSV/XLSX) ou exporte seu plano em Settings → Data.
- Templates — salve configurações comuns de tarefas para que novas tarefas comecem pré-preenchidas. Modelos podem ser compartilhados com a equipe ou mantidos pessoais.
- Pessoas virtuais e status — placeholders somente para planejamento; ficam no Gantt até você enviar tarefas ao Jira, depois viram valores padrão do Jira. Veja Pessoas virtuais e status.
- Audit log — veja quem alterou o quê e quando.
Atalhos de teclado
- Undo / Redo — Ctrl/⌘+Z, Ctrl/⌘+Shift+Z
- Indent / Outdent — Tab / Shift+Tab
- Delete a dependency — selecione a seta, pressione Delete
- Cancel a drag or link — Esc
- Save the details panel — Ctrl/⌘+Enter
- See all shortcuts — clique no botão ?
(Atalhos pausam enquanto você digita em uma caixa de texto.)
Perguntas frequentes
Preciso criar itens do Jira?
Não. Você pode planejar para sempre e nunca enviar nada ao Jira. Criar itens é sempre sua escolha.
O planejamento vai bagunçar meu backlog do Jira?
Não. Nada aparece no Jira até você usar Send to Jira. Planos rascunho permanecem separados.
Preciso de algo especial no Jira para o modo por hora?
Sim, se você quer que horários sincronizem com o Jira. Seu administrador deve criar campos personalizados Date and time (não somente data) e mapeá-los em Configure Jira fields…. Veja modo por hora para a lista completa.
Quem pode ver meu plano?
Somente você, a menos que compartilhe. Planos novos são privados por padrão.
Funciona no Jira Data Center / Server?
Não — o Preplanning Gantt é somente para Jira Cloud.
Onde meus dados são armazenados?
Dentro do seu próprio site Atlassian Cloud, usando o armazenamento seguro de apps da Atlassian. Veja a Política de Privacidade.
Se algo der errado
- Tente atualizar a página ou abri-la em uma janela privada/anônima para descartar extensões do navegador.
- Verifique se o plano está realmente conectado ao Jira (procure o distintivo do Jira na tarefa).
- Se uma tarefa mostrar um aviso de sincronização, use Pull from Jira ou o botão ↻ Sync.
- Ainda travado ou encontrou um bug de verdade? Vá para a página de Suporte.
