# Planejar uma versão do Jira com um mapa mental

Consulte as versões não lançadas do projeto atual do Jira, leve os itens atribuídos para o mapa e coordene a implantação usando um roteiro compartilhado.

## Antes de começar

Você precisa de:

- Permissão para visualizar o projeto do Jira e seus itens.
- Um mapa mental que possa editar caso queira adicionar itens da versão.
- Itens do Jira que já tenham **Versões de correção** atribuídas no Jira para que apareçam em uma versão.

O painel de versões usa o projeto atual do Jira. Crie as versões e atribua as **Versões de correção** no Jira antes de planejá-las no Mind Map Studio.

## Abrir versões do Jira

1. Selecione **Versões do Jira** no cabeçalho do mapa.
2. Aguarde o carregamento das versões não lançadas do Jira.
3. Encontre a versão que deseja planejar.

Cada cartão de versão mostra os **Itens vinculados**, ou seja, os itens do Jira que já estão atribuídos a essa versão no Jira. Ele também oferece um **Roteiro de implantação e notas** para o trabalho de planejamento que o Mind Map Studio armazena separadamente.

O cartão a seguir mostra uma versão não lançada depois que um item do Jira foi atribuído a ela por meio do campo **Versões de correção** do Jira.

![Versão 3.0.0 não lançada com um item do Jira atribuído.](/api/media/mindmap-media/pt-br/jira/release-planning/release-overview-populated-dark.webp)

## Entender uma versão vazia

Uma versão não lançada pode ser útil antes que qualquer item do Jira seja atribuído a ela. Nesse caso, a versão mostra **Nenhum item do Jira atribuído a esta versão**. Ainda assim, você pode adicionar tags e iniciar o roteiro de implantação.

As capturas de tela a seguir mostram intencionalmente esse estado vazio. Não houve falha de carregamento: a versão 3.0.0 simplesmente ainda não possui itens do Jira atribuídos, tags do Mind Map Studio ou etapas de implantação.

![Cartão de versão do Jira não lançada mostrando que a versão 3.0.0 não tem itens atribuídos.](/api/media/mindmap-media/pt-br/jira/release-planning/release-overview-empty-dark.webp)

![Roteiro de versão vazio sem itens do Jira, tags ou etapas de implantação atribuídos.](/api/media/mindmap-media/pt-br/jira/release-planning/release-runbook-empty-dark.webp)

## Adicionar um item atribuído ao mapa

1. Selecione a ideia que deverá ser o elemento pai do item no mapa.
2. Encontre a versão do Jira em **Versões do Jira**.
3. Encontre o item em **Itens vinculados**.
4. Passe o ponteiro sobre o item e selecione o botão com o sinal de adição.

O Mind Map Studio adiciona um cartão secundário com a chave e o resumo do Jira. Você também pode arrastar um item do painel de versões para a tela e soltá-lo perto da ideia que deverá ser seu elemento pai.

Adicionar o cartão altera somente o mapa. A ação não atribui nem modifica as **Versões de correção**, não edita o item e não cria um vínculo entre itens do Jira.

## Atualizar a lista de versões

Selecione **Atualizar versões do Jira** na parte superior do painel quando uma versão ou a atribuição de um item tiver mudado no Jira.

A atualização solicita ao Jira Cloud as versões não lançadas atuais e seus itens atribuídos. Abrir **Roteiro de implantação e notas** carrega o roteiro do Mind Map Studio salvo para esse projeto e essa versão. A atualização não modifica nada no Jira.

Se um item ainda não aparecer, abra-o no Jira e confirme se o campo **Versões de correção** contém a versão esperada no projeto atual.

## Criar um roteiro de implantação

1. Encontre a versão do Jira em **Versões do Jira**.
2. Selecione **Roteiro de implantação e notas**.
3. Digite uma etapa de implantação e pressione **Enter** ou selecione o botão para adicioná-la.
4. Adicione as etapas restantes na ordem em que a equipe deve concluí-las.

Use etapas curtas e orientadas a ações, como “Confirmar o backup de produção”, “Implantar o aplicativo” e “Executar o teste de fumaça”. O roteiro pertence a este projeto e a esta versão do Jira, portanto todas as pessoas que trabalham com a mesma versão podem seguir a mesma sequência.

## Organizar e concluir o roteiro

- Marque uma etapa como concluída usando sua caixa de seleção.
- Use **Mover etapa para cima** ou **Mover etapa para baixo** para alterar a ordem da implantação.
- Use **Excluir etapa** para remover uma etapa que não é mais necessária.
- Acompanhe a quantidade de etapas concluídas e a barra de progresso para saber quanto falta para terminar o roteiro.

O progresso descreve as etapas do roteiro do Mind Map Studio. Ele não altera o status da versão do Jira nem o status de nenhum item do Jira.

## Adicionar tags ao roteiro

Use **Adicionar tag** para criar um marcador curto, como `backend`, `mobile` ou `approval`. Você também pode digitar `/` enquanto escreve uma etapa de implantação para criar ou inserir uma tag.

Essas tags do Mind Map Studio servem para organizar o roteiro da versão. Elas não são rótulos do Jira e não são gravadas nos itens vinculados.

## Verificar o resultado

Seu plano de versão está pronto quando:

- A versão não lançada esperada do Jira aparece em **Versões do Jira**.
- Os **Itens vinculados** correspondem aos itens já atribuídos a essa versão no Jira.
- Os itens adicionados aparecem no mapa como cartões vinculados ao Jira.
- As etapas do roteiro estão na ordem desejada.
- A quantidade de etapas concluídas muda quando você marca uma etapa como concluída.

## Saber o que permanece no Jira e no Mind Map Studio

- **Versões do Jira** não cria nem edita versões do Jira.
- Não atribui, remove nem modifica as **Versões de correção** de um item.
- Não mostra as datas das versões do Jira.
- O roteiro de implantação é armazenado pelo Mind Map Studio. Ele não é copiado para a descrição da versão do Jira.
- As tags do roteiro não são rótulos do Jira.
- Adicionar um item vinculado ao mapa não edita o item do Jira.

Use o Jira quando precisar criar uma versão, definir sua data de lançamento, alterar seu status ou sua descrição ou atribuir itens a ela. Depois, volte ao Mind Map Studio e atualize a lista quando estiver pronto para planejar visualmente essas mudanças do Jira.

## Corrigir um problema

### Uma versão não aparece

O painel mostra as versões não lançadas do projeto atual do Jira. Confirme se você está no projeto esperado, verifique se a versão ainda não foi lançada e selecione **Atualizar versões do Jira**.

### Um item atribuído não aparece

Abra o item no Jira e verifique o campo **Versões de correção**. Depois que o Jira salvar a atribuição, volte ao Mind Map Studio e atualize a lista de versões.

### O botão para adicionar não está disponível

Primeiro, selecione uma ideia editável no mapa. A ideia selecionada se torna o elemento pai do novo cartão.

## Guias relacionados

- [Adicionar itens existentes do Jira a um mapa](./add-existing-issues.md)
- [Saber o que muda no Jira](./what-changes-in-jira.md)
- [Criar e editar um mapa mental](../building-and-editing.md)