Personalize a configuração do mapa de campo

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • Mapeie um campo de sua preferência para um projeto do Jira.

    Antes de Iniciar

    Por Que e Quando Desempenhar Esta Tarefa

    Se você tiver um campo personalizado para um projeto do Jira que deseja mapear com um campo em Desenvolvimento ágil 2.0, poderá criar uma configuração de mapa de campo personalizado que se aplique somente a este projeto do JIRA.

    Se você tiver um campo personalizado aplicável a todos os projetos do Jira de um tipo de projeto específico, consulte Aplicar configuração de mapa personalizado a vários projetos do JIRA.Os seguintes tipos de campo são compatíveis com a configuração do mapa de campo personalizado:
    • Número
    • Selecionar
    • Texto
    • Data
    • Identidade
    • Data e hora
    • Referência
    • Lista

    Procedimento

    1. Navegar até Tudo > Integração Agile de JIRA > Instâncias do JIRA.
    2. Abra seu registro de instância do Jira.
    3. Na lista relacionada Projetos do Jira, abra um projeto do Jira para o qual você deseja personalizar a configuração do mapa.
    4. Na lista relacionada Mapas de tabela, abra o registro de Sprint, Épico ou História para adicionar uma nova configuração de mapa de campo para esse registro.
    5. Na lista relacionada Mapas de campo, clique em Novo.
    6. No formulário, preencha os campos.
      Tabela 1. Formulário Mapa de Campo
      Campo Descrição
      Campo Interno Nome do campo em Desenvolvimento ágil 2.0.
      Mapa de Tabela Mapa de tabela em Desenvolvimento ágil 2.0, no qual este campo é criado.

      Este campo é preenchido automaticamente com base no registro de mapa de tabela selecionado.

      Tabela Interna Tabela em Desenvolvimento ágil 2.0.

      Este campo é preenchido automaticamente com base no registro de mapa de tabela selecionado.

      Campo Externo ID do campo no Jira.
      Nome do Campo Externo Nome de exibição do campo no JIRA.

      Certifique-se de que este campo seja adicionado à tela do projeto do JIRA.

    7. Clique em Atualizar.

    O que Fazer Depois

    1. Valide a configuração do mapa de campo clicando em Validar e corrigir mapeamento no formulário do projeto.
    2. Na lista relacionada Mapas de tabela do seu projeto, navegue até a nova configuração de mapa de campo. Se a coluna Válido da sua configuração mostrar:
      • verdadeiro, a validação da configuração do mapa foi bem-sucedida.
      • falso, falha na validação da configuração do mapa. Certifique-se de inserir os valores corretos para todos os campos e validar novamente.
        Importante:
        Se a configuração do mapa personalizado for inválida ou se o campo personalizado configurado não for adicionado ao esquema de tela padrão do problema, a ação de exportação não funcionará.

    Configuração de um campo de referência no Jira

    Entenda como configurar um campo de referência ao criar uma nova configuração de mapa de campo.

    Ao selecionar um campo de referência para o campo Campo interno, você deve selecionar um valor para o campo Nome da coluna de pesquisa. O valor do campo Nome da coluna de pesquisa é usado durante a importação e exportação de itens de trabalho entre o JIRA DevOps e Desenvolvimento ágil 2.0o .

    Durante a importação, a aplicação de integração pesquisa o registro na tabela de referência usando o campo Pesquisar nome da coluna. Se o registro não for encontrado, o valor no item de trabalho estará vazio em Desenvolvimento ágil 2.0.


    Campo de nome da coluna de pesquisa