A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Acompanhamento do trabalho com problemas
Você pode planejar e acompanhar seu trabalho em um projeto usando problemas. Cada problema é um trabalho mantido em um registro distinto. Os problemas podem ser divididos em tarefas para organizar e acompanhar ainda mais o trabalho desse problema. Você também pode criar links entre problemas para acompanhar o trabalho relacionado, adicionar rótulos para organizar e classificar o trabalho, agrupar problemas, atribuir prioridades ao trabalho e indicar se o trabalho está bloqueado.
Quando estiver pronto para trabalhar em um problema ou conjunto de problemas, você poderá estimar o trabalho, atribuí-lo aos usuários e adicionar comentários para ajudar outras pessoas a entender o trabalho e o andamento. Você também pode exportar problemas para ajudar a trazer as informações que eles contêm para outros formatos.
# Criando um problema no CodeCatalyst
As equipes de desenvolvimento criam problemas para ajudar a monitorar e gerenciar o trabalho. Você pode criar problemas em um projeto com base nas suas necessidades. Por exemplo, é possível criar um problema para acompanhar a atualização de uma variável no código. Você pode atribuir problemas a outros usuários no projeto, usar rótulos para monitorar seu trabalho e muito mais.
Siga estas instruções para criar um problema no CodeCatalyst.
**Para criar um problema**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto onde você deseja criar um problema.
1. Na página inicial do projeto, escolha **Criar problema**. Como alternativa, no painel de navegação, selecione **Problemas**.
1. Selecione **Criar problema**.
**nota**
Você também pode adicionar problemas em linha ao usar uma visualização em grade.
1. Insira um título para o problema.
1. (Opcional) Insira uma **Descrição**. Você pode usar Markdown para adicionar formatação.
1. (Opcional) Escolha um **Status**, **Prioridade** e **Estimativa** para o problema.
**nota**
Se a configuração de estimativa do projeto estiver definida como **Ocultar estimativas**, não haverá um campo **Estimativa**.
1. (Opcional) Adicione tarefas ao problema. As tarefas podem ser usadas para dividir o trabalho de um problema em objetivos menores. Para adicionar uma tarefa, selecione **\$1 Adicionar tarefas**. Em seguida, insira o nome da tarefa no campo de texto e pressione enter. Depois de adicionar tarefas, você pode marcá-las como concluídas marcando a caixa de seleção ou reordená-las escolhendo e arrastando a tarefa do lado esquerdo da caixa de seleção.
1. (Opcional) Adicione um rótulo existente ou crie outro rótulo e adicione-o selecionando **\$1 Adicionar rótulo**.
1. Para adicionar um rótulo existente, escolha o rótulo na lista. Você pode inserir um termo de pesquisa no campo para pesquisar todos os rótulos que contêm esse termo no projeto.
1. Para criar um rótulo e adicioná-lo, digite o nome do rótulo que você deseja criar no campo de pesquisa e pressione enter.
1. (Opcional) Adicione um destinatário selecionando **\$1 Adicionar um destinatário**. Você pode se adicionar rapidamente como destinatário selecionando **\$1 Me adicionar**.
**dica**
Você pode optar por atribuir um problema ao **Amazon Q** para que o Amazon Q tente resolver o problema. Para obter mais informações, consulte [Tutorial: Usando recursos CodeCatalyst generativos de IA para acelerar seu trabalho de desenvolvimento](getting-started-project-assistance.md). Esse recurso está disponível somente na região do Oeste dos EUA (Oregon).
Essa funcionalidade exige que recursos de IA generativa estejam habilitados para o espaço. Para ter mais informações, consulte [Gerenciar recursos de IA generativa](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
1. (Opcional) Adicione um **campo personalizado** existente ou crie outro. Os problemas podem ter vários campos personalizados.
1. Para adicionar um campo personalizado existente, escolha o campo personalizado na lista. Você pode inserir um termo de pesquisa no campo para pesquisar todos os campos personalizados que contêm esse termo no projeto.
1. Para criar um campo personalizado e adicioná-lo, digite o nome do campo personalizado que você deseja criar no campo de pesquisa e pressione enter. Depois, escolha o tipo de campo personalizado que você deseja criar e defina um valor.
1. Selecione **Criar problema**. Uma notificação aparece no canto inferior direito: se o problema foi criado, uma mensagem de confirmação será exibida informando que o problema foi criado. Se o problema não tiver sido criado, uma mensagem com o motivo da falha será exibida. Depois, você pode selecionar **Tentar novamente** para editar e tentar criar o problema novamente ou selecionar **Descartar** para descartar o problema. As duas opções ignorarão a notificação.
**nota**
Você não pode vincular uma solicitação pull a um problema ao criá-lo. No entanto, você pode [editá-lo](issues-edit-issue.md) depois de criá-lo para adicionar links às solicitações pull.
## Práticas recomendadas ao criar e trabalhar com problemas atribuídos ao Amazon Q
Quando você cria problemas, às vezes, alguns deles persistem. As causas para isso podem ser complexas e variáveis. Às vezes, isso acontece porque não está claro quem deve trabalhar nisso. Outras vezes, o problema exige pesquisa ou experiência em uma parte específica da base de código e os melhores candidatos para o trabalho estão ocupados com outros problemas. Geralmente, há outros trabalhos urgentes que devem ser realizados primeiro. Qualquer uma ou todas essas causas podem resultar em problemas que não foram resolvidos. CodeCatalyst inclui integração com um assistente generativo de IA chamado Amazon Q, que pode analisar um problema com base no título e na descrição. Se você atribuir o problema ao Amazon Q, ele tentará criar um rascunho de solução para você avaliar. Isso pode ajudar você e sua equipe a se concentrarem e otimizarem o trabalho em questões que exigem sua atenção, enquanto o Amazon Q trabalha em uma solução para problemas que você não tem recursos para resolver imediatamente.
**nota**
**Desenvolvido pelo Amazon Bedrock**: AWS implementa a detecção [automática de abusos](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). Como os recursos **Escrever descrição para mim**, **Criar resumo do conteúdo**, **Recomendar tarefas**, **Usar o Amazon Q para criar ou adicionar recursos a um projeto** e **Atribuir problemas ao Amazon Q** com os recursos do agente do Amazon Q Developer para desenvolvimento de software são baseados no Amazon Bedrock, os usuários podem aproveitar ao máximo os controles implementados no Amazon Bedrock para reforçar a segurança, a proteção e o uso responsável de inteligência artificial.
O Amazon Q tem melhor desempenho em questões e problemas simples. Para ter melhores resultados, use uma linguagem simples para explicar claramente o que você quer que seja feito. Confira a seguir algumas práticas recomendadas para ajudar você a criar problemas otimizados para que o Amazon Q possa trabalhar.
**Importante**
Os recursos de IA generativa estão disponíveis somente na região Oeste dos EUA (Oregon).
+ **Seja simples**. O Amazon Q se sai melhor com alterações e correções simples de código que podem ser explicadas no título e na descrição do problema. Não atribua problemas com títulos vagos ou descrições muito exageradas ou contraditórias.
+ **Seja específico**. Quanto mais informações você puder fornecer sobre as alterações exatas necessárias para resolver o problema, maior a probabilidade de o Amazon Q criar uma solução que resolva o problema. Se possível, inclua detalhes específicos, como o nome APIs que você deseja alterar, os métodos que deseja atualizar, os testes que precisam de alterações e quaisquer outros detalhes que você possa imaginar.
+ **Inclua todos os detalhes no título e na descrição do problema antes de atribuí-lo ao Amazon Q**. Você não pode alterar o título ou a descrição de um problema depois de atribuí-lo ao Amazon Q, portanto, tenha todas as informações necessárias em um problema antes de atribuí-lo ao Amazon Q.
+ **Atribua somente problemas que exijam alterações de código em um único repositório de origem**. O Amazon Q só pode trabalhar com código em um único repositório de origem em CodeCatalyst. Não há suporte a repositórios vinculados. Verifique se o problema exige apenas alterações em um único repositório de origem antes de atribuí-lo ao Amazon Q.
+ **Use o padrão sugerido pelo Amazon Q para aprovar cada etapa**. Por padrão, o Amazon Q exigirá sua aprovação para cada etapa realizada. Isso permite que você interaja com o Amazon Q em comentários não apenas sobre o problema, mas também sobre qualquer solicitação pull criada por ele. Isso proporciona uma experiência mais interativa com o Amazon Q, que ajuda você a ajustar a abordagem e refinar o código criado para resolver o problema.
**nota**
O Amazon Q não responde a comentários individuais sobre problemas ou solicitações pull, mas os revisará quando solicitado a reconsiderar a abordagem ou criar uma revisão.
+ **Sempre analise cuidadosamente a abordagem sugerida pelo Amazon Q**. Depois de aprovar a abordagem, o Amazon Q começará a trabalhar na geração de código com base nessa abordagem. A abordagem deve parecer correta e incluir todos os detalhes que você espera antes de pedir ao Amazon Q que continue.
+ **Permita que o Amazon Q trabalhe em fluxos de trabalho somente se você não tiver fluxos de trabalho existentes que possam implantá-los antes de serem revisados**. Seu projeto pode ter fluxos de trabalho configurados para iniciar execuções em eventos de solicitação pull. Nesse caso, qualquer solicitação pull criada pela Amazon Q que inclua a criação ou atualização do YAML do fluxo de trabalho pode iniciar uma execução desses fluxos de trabalho incluídos na solicitação pull. Como prática recomendada, não permita que o Amazon Q trabalhe em arquivos de fluxo de trabalho, a menos que tenha certeza de que não há fluxos de trabalho em seu projeto que executem automaticamente esses fluxos de trabalho antes de você revisar e aprovar a solicitação pull criada por ele.
Para ter mais informações, consulte [Tutorial: Usando recursos CodeCatalyst generativos de IA para acelerar seu trabalho de desenvolvimento](getting-started-project-assistance.md) e [Gerenciamento de recursos de IA generativa](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
## Estimativa de um problema
No desenvolvimento Agile, a *estimativa* é conhecida como pontos históricos. Você pode usar a estimativa de um problema para representar a quantidade de trabalho necessária, além da ambiguidade e complexidade do problema. Considere o uso de estimativas mais altas para problemas com maior risco, dificuldade e incógnitas.
Antes de começar a estimar os problemas, você deve primeiro escolher o tipo de estimativa que deseja usar para seu projeto. Existem dois tipos para selecionar por padrão. Para usar **Tamanho da camiseta** ou **Sequenciamento de Fibonacci** de forma eficaz, sua equipe deve se alinhar ao que cada tamanho representa. Decidam juntos o que cada estimativa representa para você e comece a aplicar essas estimativas a cada problema. Considere revisar periodicamente
Siga estas etapas para definir a configuração das estimativas de esforço para problemas em CodeCatalyst.
**Para configurar a estimativa de esforço para problemas**
1. No painel de navegação, selecione **Problemas**.
1. Selecione **Problemas ativos** para abrir o menu suspenso do **alternador de visualização de problemas** e selecione **Configurações**.
1. Em **Estimativa**, na seção **Configurações básicas**, escolha como os valores da estimativa serão exibidos. Os tipos de estimativas disponíveis são **Tamanho de camisetas**, **Sequenciamento de Fibonacci** ou **Ocultar estimativas**. Se a configuração de estimativa do projeto estiver definida como **Ocultar estimativas**, não haverá um campo **Estimativa** nos problemas do projeto.
Quando o tipo de estimativa for atualizado, nenhum dado será perdido e o valor estimado de todos os problemas será convertido automaticamente. O mapeamento da conversão é mostrado na tabela a seguir.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/issues-tracking-work.html)
Para adicionar ou alterar uma estimativa para um problema, você pode [editar o problema](issues-edit-issue.md).
# Editando e colaborando em questões em CodeCatalyst
**Contents**
+ [Edição de um problema](issues-edit-issue.md)
+ [Trabalhar com anexos](issues-attachments.md)
+ [Visualização e gerenciamento de anexos](issues-settings-attachments.md)
+ [Gerenciamento de tarefas sobre problemas](issues-tasks.md)
+ [Vincular um problema a outro](issues-link-issue.md)
+ [Marcação de um problema como bloqueado ou desbloqueado](issues-mark-as-blocked.md)
+ [Adição, edição ou exclusão de comentários](issues-comment.md)
+ [Uso de menções em um comentário](issues-mentions-comment.md)
# Edição de um problema
Siga estas etapas para editar o título, a descrição, o status, o responsável, a prioridade, a estimativa ou os rótulos de um problema.
**Para editar um problema**
1. Escolha o problema que você deseja editar para ver os detalhes do problema. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Para editar o título do problema, selecione o título, insira um novo e pressione enter.
1. Para editar a descrição, escolha a descrição, insira uma nova descrição e pressione enter. Você pode usar Markdown para adicionar formatação.
1. Em **Tarefas**, você pode visualizar e gerenciar as tarefas do problema. Se não houver tarefas, você pode fazer com que o Amazon Q analise o problema e recomende tarefas que possam dividir o trabalho no problema em itens separados, cada um atribuído a um usuário. Para obter mais informações, consulte [Gerenciamento de tarefas sobre problemas](issues-tasks.md).
1. Para editar o **Status**, a **Estimativa** ou a **Prioridade**, escolha uma opção nos respectivos menus suspensos.
1. Em **Rótulos**, é possível adicionar um rótulo existente, criar ou remover um rótulo.
1. Para adicionar um rótulo existente, selecione **\$1 Adicionar rótulo** e escolha o rótulo na lista. Você pode inserir um termo de pesquisa no campo para pesquisar todos os rótulos que contêm esse termo no projeto.
1. Para criar um rótulo e adicioná-lo, selecione **\$1 Adicionar rótulo**, digite o nome do rótulo que você deseja criar no campo de pesquisa e pressione enter.
1. Para remover um rótulo, escolha o ícone **X** ao lado do rótulo que você deseja remover. Se você remover um rótulo de todos os problemas, o rótulo aparecerá na seção **Rótulos não usados** na seção **Rótulos** das **configurações** do problema. Os rótulos não usados aparecem no final da lista de rótulos ao usar filtros ou adicionar rótulos a um problema. Você pode encontrar uma visão geral de todos os rótulos (usados e não usados) e dos problemas que os contêm nas **configurações** do problema.
1. Para atribuir um problema, selecione **\$1 Adicionar um destinatário** na seção **Destinatário**, pesquise e escolha o destinatário na lista. Você pode selecionar **\$1 Me adicionar** para se adicionar rapidamente como destinatário.
1. Em **Anexos**, você pode adicionar, baixar ou remover anexos. Para obter mais informações, consulte [Trabalhar com anexos](issues-attachments.md).
1. Para vincular uma solicitação pull, escolha **Vincular solicitação pull** e, depois, escolha uma solicitação pull na lista ou insira o URL ou ID. Para desvincular uma solicitação pull, escolha o ícone de desvinculação.
**dica**
Depois de adicionar um link a uma solicitação pull para um problema, você pode navegar rapidamente até ele escolhendo o ID correspondente na lista de solicitações pull vinculadas. Você pode usar o URL de uma solicitação pull para vincular solicitações pull que estão em projetos diferentes do quadro de problemas, mas somente usuários que são membros desse projeto poderão visualizar ou navegar até essa solicitação pull.
1. (Opcional) Adicione e defina um campo personalizado existente, crie ou remova um campo personalizado. Os problemas podem ter vários campos personalizados.
1. Para adicionar um campo personalizado existente, escolha o campo personalizado na lista. Você pode inserir um termo de pesquisa no campo para pesquisar todos os campos personalizados que contêm esse termo no projeto.
1. Para criar um campo personalizado e adicioná-lo, digite o nome do campo personalizado que você deseja criar no campo de pesquisa e pressione enter. Depois, escolha o tipo de campo personalizado que você deseja criar e defina um valor.
1. Para remover um campo personalizado, escolha o ícone **X** ao lado do campo personalizado que você deseja remover. Se você remover um campo personalizado de todos os problemas, o campo personalizado será excluído e você não o verá mais durante a filtragem.
# Trabalhar com anexos
Você pode adicionar anexos às edições para tornar os CodeCatalyst arquivos relacionados facilmente acessíveis. Siga este procedimento para gerenciar os anexos de um problema.
O tamanho dos anexos adicionados aos problemas conta para as cotas de armazenamento do seu espaço. Para ter mais informações sobre como visualizar e gerenciar os anexos do projeto, consulte [Visualização e gerenciamento de anexos](issues-settings-attachments.md).
**Importante**
Os anexos das edições não são digitalizados nem analisados pela Amazon. CodeCatalyst Qualquer usuário pode adicionar um anexo a um problema que possa conter código ou conteúdo malicioso. Os usuários devem conhecer as práticas recomendadas quando se trata de gerenciar anexos e se proteger contra códigos, conteúdos ou vírus maliciosos.
**Para adicionar, baixar ou remover anexos**
1. Escolha o problema para o qual deseja gerenciar os anexos. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Para adicionar um anexo, selecione **Carregar arquivo**. Navegue até o arquivo no explorador de arquivos do sistema operacional e selecione-o. Selecione **Abrir** para adicioná-lo como anexo. Para ter informações sobre cotas, como tamanho máximo de anexo, consulte [Cotas para edições em CodeCatalyst](issues-quotas.md).
Observe as seguintes restrições aos nomes de arquivos anexos e tipos de conteúdo:
+ Os seguintes caracteres não são aceitos em nomes de arquivo:
+ Caracteres de controle: `0x00–0x1f` e `0x80–0x9f`
+ Caracteres reservados: `/`, `?`, `<`, `>`, `\`, `:`, `*`, `|` e `"`
+ Nomes de arquivos reservados do Unix: `.` e `..`
+ Períodos e espaços finais
+ Nomes de arquivos reservados do Windows: `CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9`
+ O tipo de conteúdo do anexo deve seguir este padrão de tipo de mídia:
```
media-type = type "/" [tree "."] subtype ["+" suffix]* [";" parameter];
```
Por exemplo, .`text/html; charset=UTF-8`
1. Para baixar um anexo, escolha o menu de reticências ao lado do anexo que você deseja baixar e escolha **Baixar**.
1. Para copiar o URL de um anexo, escolha o menu de reticências ao lado do anexo do qual você deseja copiar o URL e selecione **Copiar URL**.
1. Para remover um anexo, escolha o menu de reticências ao lado do anexo que você deseja remover e escolha **Excluir**.
# Visualização e gerenciamento de anexos
Você pode ver uma tabela com cada anexo adicionado aos problemas do projeto nas configurações do problema. Essa tabela inclui detalhes de cada anexo, incluindo informações como tipo de conteúdo, quando foi adicionado, o problema ao qual foi adicionado, o status e o tamanho do arquivo.
Essa tabela pode ser usada para identificar facilmente anexos grandes em problemas que foram concluídos ou arquivados para removê-los e liberar espaço de armazenamento.
**Importante**
Os anexos das edições não são digitalizados nem analisados pela Amazon. CodeCatalyst Qualquer usuário pode adicionar um anexo a um problema que possa conter código ou conteúdo malicioso. Os usuários devem conhecer as práticas recomendadas quando se trata de gerenciar anexos e se proteger contra códigos, conteúdos ou vírus maliciosos.
**Para visualizar e gerenciar todos os anexos de problemas em um projeto**
1. No painel de navegação, selecione **Problemas**.
1. Escolha o ícone de reticências e selecione **Configurações**.
1. Escolha a guia **Anexos**.
# Gerenciamento de tarefas sobre problemas
As *tarefas* podem ser adicionadas aos problemas para detalhar, organizar e acompanhar ainda mais o trabalho desse problema. Você mesmo pode criar tarefas ou usar o Amazon Q para recomendar tarefas com base na análise e na complexidade do problema.
O Amazon Q Developer é um assistente conversacional generativo baseado em IA que pode ajudar você a entender, criar, estender e operar aplicativos. AWS Para acelerar sua construção AWS, o modelo que impulsiona o Amazon Q é aprimorado com AWS conteúdo de alta qualidade para produzir respostas mais completas, acionáveis e referenciadas. Para obter mais informações, consulte [O que é Amazon Q Developer?](https://docs.aws.amazon.com/amazonq/latest/aws-builder-use-ug/what-is.html) no *Guia do usuário do Amazon Q Developer*.
**Para gerenciar tarefas em um problema**
1. Escolha o problema para o qual deseja gerenciar as tarefas. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Em **Tarefas**, você pode visualizar e gerenciar tarefas do problema.
1. Para adicionar uma tarefa, insira o nome da tarefa no campo de texto e pressione enter.
1. Se não houver tarefas para o problema, você pode optar por fazer com que o Amazon Q analise o problema e crie tarefas com base no título, na descrição e na análise da complexidade do problema e no código do repositório. Nesse caso, selecione **Recomendar tarefas**. Você precisará especificar o repositório de origem que contém o código do problema. Selecione **Iniciar recomendação de tarefas** para iniciar a análise da recomendação de tarefas. Essa caixa de diálogo será fechada. Quando a recomendação estiver concluída, selecione **Visualizar tarefas recomendadas** para revisar as tarefas e realizar qualquer ação necessária, como excluir ou adicionar tarefas à lista ou reordenar as tarefas recomendadas, antes de selecionar **Criar tarefas**.
Depois que as tarefas forem criadas, você poderá atribuí-las aos usuários e trabalhar com eles da mesma forma que trabalha com tarefas criadas manualmente.
1. Para marcar uma tarefa como concluída, marque a caixa de seleção da tarefa.
1. Para visualizar ou atualizar os detalhes de uma tarefa, escolha-a na lista.
1. Para reordenar as tarefas, escolha e arraste a tarefa do lado esquerdo da caixa de seleção.
1. Para remover uma tarefa, escolha o menu de reticências da tarefa e escolha **Remover**.
# Vincular um problema a outro
Se um problema estiver relacionado ao trabalho em outro problema, você poderá vinculá-lo. Esta é uma maneira rápida de ajudar você a entender e monitorar as dependências entre os itens de trabalho.
Ao vincular um problema, há quatro estados para escolher:
+ Relacionado a: use esse estado para indicar o trabalho relacionado ao problema vinculado.
+ Bloqueado por: use esse estado para indicar que o problema está bloqueado pelo problema vinculado.
+ Bloqueando para: use esse estado para indicar que o problema está bloqueando o andamento do problema vinculado.
+ Duplicado: use esse estado para indicar que o problema duplica o trabalho capturado em outro problema.
Você não pode alterar o estado de um link depois de criá-lo. Os links e o estado do link aparecem em **Problemas vinculados** tanto no problema em que você criou o link quanto no problema vinculado. Você também pode remover links depois de criados.
**Para vincular um problema a outro problema ou outra tarefa**
1. Abra o problema que você deseja vincular a outro problema. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Selecione **Vincular problemas**.
1. Em **Marcar como**, escolha o estado do link.
Em **Nº do problema**, insira o número do problema ou escolha-o na lista suspensa.
1. Para adicionar outro link, selecione **Adicionar problema vinculado**.
1. Quando terminar, selecione **Atualizar** para atualizar o problema e todos os problemas vinculados ao relacionamento vinculado.
# Marcação de um problema como bloqueado ou desbloqueado
Se algo estiver impedindo você de resolver um problema, convém marcar como *bloqueado*. Por exemplo, o problema pode ser bloqueado se depender de uma alteração em outra parte da base de código que ainda não foi mesclada.
Quando você marca um problema como bloqueado, CodeCatalyst adiciona um rótulo vermelho de **Bloqueado** ao problema, tornando-o altamente visível em sua lista de pendências, arquivo ou em seu quadro.
Você pode desbloquear o problema quando circunstâncias externas forem resolvidas.
**Para marcar um problema como bloqueado**
1. Abra o problema que você deseja marcar como bloqueado. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Selecione **Ações** e **Marcar como bloqueado**.
**Para desbloquear um problema**
1. Abra o problema que você deseja desbloquear. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Selecione **Ações** e **Marcar como desbloqueado**.
# Adição, edição ou exclusão de comentários
Você pode deixar um comentário sobre um problema. Nos comentários, você pode marcar outros membros do espaço, outros projetos no espaço, problemas relacionados e código.
**Para adicionar um comentário a um problema**
1. Navegue até o projeto.
1. Na barra de navegação, selecione **Problemas**.
1. Escolha o problema onde você deseja adicionar o comentário. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Insira o comentário no campo **Comentários**. Você pode usar Markdown para adicionar formatação.
1. Selecione **Enviar**.
**Para editar um comentário**
Você pode editar os comentários que faz sobre problemas. Você só pode editar comentários que foram de sua autoria.
1. Navegue até o projeto.
1. Na barra de navegação, selecione **Problemas**.
1. Escolha o problema onde você deseja editar um comentário. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Para editar um comentário, encontre o comentário que você deseja editar.
**dica**
Você pode classificar os comentários pelos mais antigos ou pelos mais novos primeiro. São carregados 10 comentários por vez.
1. Escolha ícone de reticências e **Editar**:
1. Edite o comentário. Você pode usar Markdown para adicionar formatação.
1. Escolha **Salvar**. O comentário agora está atualizado.
**Para excluir um comentário**
Você pode excluir os comentários que faz sobre problemas. Você só pode excluir comentários que foram de sua autoria. Quando um comentário for excluído, seu nome de usuário será exibido, mas com as palavras *Este comentário foi excluído* no lugar do texto original do comentário.
1. Navegue até o projeto.
1. Na barra de navegação, selecione **Problemas**.
1. Escolha o problema onde você deseja excluir um comentário. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Escolha o ícone de reticências, selecione **Excluir** e, depois, **Confirmar**.
# Uso de menções em um comentário
Você pode mencionar membros do espaço, outros projetos no espaço, problemas relacionados e código nos comentários. Isso cria um link rápido para o usuário ou recurso que você mencionou.
**Para mencionar em um comentário**
1. Navegue até o projeto.
1. Na barra de navegação, selecione **Problemas**.
1. Escolha o problema que você deseja editar para ver os detalhes do problema. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Selecione a caixa de texto **Adicionar um comentário**.
1. Digite `@user_name` para mencionar outro usuário.
1. Digite `@project_name` para mencionar um projeto.
1. Digite `@issue_name` ou `@issue_number` para mencionar outro problema.
1. Digite `@file_name` para mencionar arquivos ou códigos específicos em um repositório de origem.
**nota**
Uma lista dos 5 principais itens (usuários, repositórios de origem, projetos etc.) contendo os termos que correspondem à `@mention` será preenchida conforme você digita.
1. Escolha o item que deseja mencionar. O caminho que mostra onde o item está localizado será preenchido na caixa de texto do comentário.
1. Conclua seu comentário e selecione **Enviar**.
# Descoberta e visualização de problemas
As seções a seguir descrevem como pesquisar e visualizar problemas em um CodeCatalyst projeto com eficiência.
## Procura de um problema
Você pode encontrar um problema procurando parâmetros específicos. Para ter mais informações sobre como refinar sua pesquisa, consulte [Pesquisa do código, problemas, projetos e usuários no CodeCatalystPesquisa do código, problemas, projetos e usuários](search.md).
**Como procurar um problema**
1. Navegue até o projeto.
1. Use a barra de pesquisa para procurar problemas ou informações relacionadas a problemas. Você pode usar parâmetros de consulta para refinar a pesquisa. Para obter mais informações, consulte [Pesquisa do código, problemas, projetos e usuários no CodeCatalystPesquisa do código, problemas, projetos e usuários](search.md).
# Classificação de problemas
Por padrão, os problemas em CodeCatalyst são classificados por **ordem manual**. A ordem manual exibe os problemas na ordem para a qual eles são movidos pelos usuários. Você pode arrastar e soltar os problemas quando classificados em ordem manual para alterar a ordem. Essa opção de classificação é útil para organizar o backlog de problemas e priorizá-los.
A tabela a seguir mostra como os problemas podem ser classificados nas visualizações em grade e em quadro.
| Opções de classificação da visualização em grade | Opções de classificação da visualização em quadro |
| --- | --- |
| Ordem manual | Ordem manual |
| Última atualização | Última atualização |
| Prioridade | Prioridade |
| Estimativa | Estimativa |
| Título | Título |
| ID | |
| Status | |
| Bloqueado | |
| Campos personalizados | |
Use o procedimento a seguir para alterar a forma como os problemas são classificados.
**Para classificar problemas**
1. Navegue até o projeto.
1. No painel de navegação, selecione **Problemas**. A visualização padrão é o **Quadro**.
1. (Opcional) Selecione **Problemas ativos** para abrir o menu suspenso do **alternador de visualização de problemas** e navegue até uma visualização de problemas diferente.
1. Para classificar uma visualização em grade, há duas opções:
1. Escolha o **cabeçalho** do campo pelo qual você deseja classificar. A escolha do **cabeçalho** alternará entre a ordem crescente e decrescente.
1. Escolha o menu suspenso **Classificar por** e escolha um parâmetro pelo qual classificar. Os problemas serão classificados em ordem crescente.
1. Para classificar uma visualização em quadro, escolha o menu suspenso **Classificar por** e escolha um parâmetro para classificar. Os problemas serão classificados em ordem crescente.
# Agrupamento de problemas
O agrupamento é usado para organizar os problemas no quadro por meio de vários parâmetros, como destinatário, rótulos e prioridade.
**Para agrupar problemas**
1. Navegue até o projeto.
1. No painel de navegação, selecione **Problemas**. A visualização padrão é o **Quadro**.
1. (Opcional) Selecione **Problemas ativos** para abrir o menu suspenso do **alternador de visualização de problemas** e navegue até uma visualização de problemas diferente.
1. Escolha **Grupo**.
1. Em **Agrupar por**, escolha um parâmetro pelo qual agrupar:
+ Se você escolher **Destinatário** ou **Prioritário**, selecione a **Ordem de agrupamento**.
+ Se você escolher **Rótulo**, escolha os rótulos e, depois, selecione **Ordem de agrupamento**.
1. (Opcional) Escolha a opção **Mostrar grupos vazios** para mostrar ou ocultar grupos que não têm problemas atualmente atribuídos a eles.
1. A visualização é atualizada conforme você faz suas escolhas. Um problema aparece somente no grupo que corresponde aos parâmetros configurados.
# Filtragem de problemas
Use a filtragem para encontrar problemas que contenham nome, prioridade, rótulo, campos personalizados ou destinatário especificados.
**Para filtrar problemas**
1. Navegue até o projeto.
1. No painel de navegação, selecione **Problemas**.
1. (Opcional) Selecione **Problemas ativos** para abrir o menu suspenso do **alternador de visualização de problemas** e navegue até uma visualização de problemas diferente.
**nota**
Para filtrar com base em uma string no nome ou na descrição do problema, insira a string na barra de pesquisa de problemas.
1. Selecione **Filtro** e, depois, **\$1 Adicionar filtro**.
1. Escolha os parâmetros para filtrar. É possível escolher vários filtros e parâmetros. Você pode configurar filtros para mostrar problemas que correspondam a cada filtro ou a qualquer filtro individual selecionando **e** ou **ou**. A visualização será atualizada para mostrar os problemas que correspondem ao filtro.
# Progresso em um problema
Cada problema tem um ciclo de vida. Em CodeCatalyst, os problemas geralmente começam como um rascunho na lista de pendências. Quando for necessário iniciar o trabalho para resolver esse problema, ele será movido para outra categoria de status e passará por vários status até ser concluído e arquivado. Você pode mover ou progredir um problema pelo ciclo de vida das seguintes maneiras:
+ Você pode mover um problema entre o backlog e o quadro.
+ Você pode mover um problema em andamento por vários estágios de conclusão.
+ Você pode arquivar um problema que foi concluído.
# Transferência de um problema entre o backlog e o quadro
Você pode mover um problema do backlog para o quadro assim que começar a trabalhar nele. Você também pode mover um problema de volta para o backlog se o trabalho for adiado.
**Para mover um problema entre o backlog e o quadro**
1. Navegue até o projeto.
1. No painel de navegação, selecione **Problemas**. A visualização padrão é o **Quadro**.
1. Para mover um problema do quadro para o backlog:
1. Escolha o problema que você deseja mover. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Selecione **Backlog** no menu suspenso **Status**.
1. Para mover um problema do backlog para o quadro:
1. Para navegar até o backlog, selecione **Quadro** e **Backlog**.
1. Escolha o problema que você deseja mover. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Selecione **Adicionar ao quadro** ou escolha um **Status** diferente de **Backlog**.
# Avançar com um problema pelos estágios do ciclo de vida no quadro
Você pode mover um problema dentro de um quadro por diferentes status até ele ser concluído.
**Para mover um problema dentro do quadro**
1. No painel de navegação, selecione **Problemas**. A visualização padrão é o **Quadro**.
1. Execute um destes procedimentos:
+ Arraste e solte um problema em outro status.
+ Escolha um problema e, depois, escolha um status no menu suspenso **Status**.
+ Escolha um problema e, em seguida, escolha **Mover para: *next-status***.
Para ter informações sobre como arquivar um problema, consulte [Arquivamento de um problema](issues-archive-issues.md).
# Movimentar problemas entre grupos
Você pode [agrupar problemas](issues-grouping.md) nas visualizações **Todos os problemas** e **Quadro** por meio de vários parâmetros. Se os problemas estiverem agrupados, você poderá mover problemas de um grupo para outro. Mover um problema de um grupo para outro editará automaticamente o campo em que os problemas estão agrupados para corresponder ao grupo de destino.
Como exemplo de cenário, suponha CodeCatalyst que haja uma empresa usando problemas atribuídos a duas pessoas, Wang Xiulan e Saanvi Sarkar. O quadro é agrupado por `Assignee`, e há dois grupos, um para cada responsável. Mover um problema do grupo Wang Xiulan para o grupo Saanvi Sarkar atualizará o responsável pelo problema para Saanvi Sarkar.
# Arquivamento de um problema
**nota**
Os problemas não são excluídos em um projeto; eles são arquivados. Para excluir problemas, você deve excluir o projeto.
Você pode arquivar um problema quando ele não for mais necessário em seu projeto. Ao arquivar um problema, ele é CodeCatalyst removido de todas as visualizações que filtram os problemas arquivados. Os problemas arquivados podem ser vistos na visualização padrão dos **Problemas arquivados**, na qual podem ser desarquivados, se necessário.
Você vai arquivar um problema se:
+ Tiver concluído o problema e não precisar mais dele na coluna **Concluído**.
+ Não tiver planos de trabalhar nisso.
+ Tiver criado por engano.
+ Tiver atingido o número máximo de problemas ativos.
**Para arquivar um problema**
1. Abra o problema que você deseja arquivar. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Selecione **Ações** e, depois, **Mover para arquivo**.
1. (Opcional) Para arquivar rapidamente vários problemas com o status **Concluído**, escolha a elipse vertical na parte superior de qualquer status **Concluído** no quadro e selecione **Arquivar problemas**.
**Para desarquivar um problema**
1. Abra o problema que você deseja desarquivar. Você pode ver uma lista de problemas arquivados abrindo a visualização **Problemas arquivados** no menu suspenso do **alternador de visualização de problemas**. Para receber ajuda com a descoberta do problema, consulte [Descoberta e visualização de problemas](issues-view.md).
1. Selecione **Desarquivar**.
# Exportação de problemas
Você pode exportar problemas da visualização atual para um arquivo .xlsx. Para exportar problemas, realize as seguintes etapas.
**Para exportar problemas**
1. Navegue até o projeto.
1. Na barra de navegação, selecione **Problemas**.
1. Selecione **Problemas ativos** para abrir o menu suspenso do **alternador de visualização de problemas** e navegue até a visualização que contém os problemas que você deseja exportar. Somente os problemas mostrados na visualização serão exportados.
1. Escolha o menu de reticências e selecione **Exportar para o Excel**.
1. O arquivo .xlsx é baixado. Por padrão, ele tem o nome do projeto e a data em que a exportação foi concluída.