Como configurar a integração do Jira com o Fluid Boards
Dan Justin·
Para ajudar os gerentes de projeto e suas equipes de desenvolvimento a otimizar seus processos de fluxo de trabalho ágil, a integração do Jira com o Fluid permitirá que os gerentes estabeleçam um fluxo de trabalho ágil alinhado aos requisitos técnicos de sua equipe, promovendo assim a colaboração e impulsionando o progresso.
Este artigo abordará como integrar o Jira aos Boards do Fluid, permitindo que o Proprietário do Projeto tenha visibilidade sobre o trabalho e a entrega das equipes de TI/Tecnologia sem a complexidade do Jira e do processo técnico.
Acessar a opção de Integrações em um board
Para começar, navegue até as opções de Configuração de Integrações no seu board a partir da aba Ferramentas.
Para outras visualizações relacionadas ao board, como o Backlog ou a visualização do Espaço de Trabalho do Board, a opção Configurar Integração pode ser encontrada na navegação da coluna esquerda. Como regra geral, a navegação à esquerda é onde você deve procurar opções relacionadas à sua visualização atual. Para visualizações como a visualização Kanban acima, no entanto, não há navegação à esquerda, portanto as opções podem ser encontradas no menu de ferramentas.
Assim que a opção de Integração for selecionada e o diálogo for aberto, você poderá selecionar a integração para o Jira.
O diálogo a seguir apresentará a página de Configuração onde os detalhes da integração para o board podem ser preenchidos.
Você pode saber mais sobre como criar inicialmente um board no Fluid clicando aqui.
Preencher os detalhes da Integração
Cada uma das seções para os detalhes da integração é a seguinte:
Nome
O nome do quadro que será refletido no Jira.
Ativo
Se a integração está atualmente habilitada para este quadro.
Frequência
Com que frequência o job é executado para quaisquer atualizações/alterações feitas no quadro. - A cada hora - A cada 6 horas - A cada 12 horas - Diariamente - Semanalmente
Bloquear criação/atualização de tarefas no Jira
Habilita um bloqueio rígido para impedir que qualquer solicitação seja enviada ao Jira. Use esta opção quando quiser que o Fluid opere em modo somente leitura, extraindo informações do Jira sem fazer atualizações ou modificações nas tarefas do Jira.
Provedor de Autenticação
Qual mecanismo de autenticação você deseja usar para se conectar ao Jira. O Jira atualmente suporta apenas PAT para seu serviço RESTful.
Conta de Serviço
Se a conta do Jira sendo usada com o Fluid for uma Conta de Sistema, habilite esta opção. As Contas de Sistema do Jira são contas especializadas destinadas a tarefas de automação e integração, em vez de atividades de usuários individuais.
ID da Nuvem
Se a Conta de Serviço estiver habilitada, você deve fornecer o ID da Nuvem da sua instância do Jira. Para encontrar este valor, acesse:
Aqui, your_domain representa o nome da sua organização no Jira. Insira a URL completa, incluindo o https://
Quadro
Especifica o quadro do Jira a ser vinculado ou integrado.
Este campo é preenchido automaticamente e não pode ser alterado.
Controlar problemas confidenciais para que não sejam sincronizados
Habilita o controle sobre quais problemas são sincronizados do Jira para o Fluid, permitindo que apenas problemas aprovados sejam importados.
Existem duas opções de configuração: Lista Negra ou Lista Branca.
Lista Negra – Define rótulos usados para excluir problemas da sincronização. Se um problema contiver uma tag listada na lista negra, ele não será importado para o Fluid.
Lista Branca – Define rótulos que permitem explicitamente a sincronização. Apenas problemas que contenham uma tag listada na lista branca serão sincronizados; todos os outros serão excluídos.
Rótulos que serão usados para BLOQUEAR/PERMITIR a sincronização de problemas
Se "Controlar problemas confidenciais para que não sejam sincronizados" estiver habilitado, insira uma lista delimitada por vírgulas de valores de rótulos que serão comparados ao Rótulo de Problema do Jira.
Habilita a criação e exclusão automática de problemas no Fluid com base em ações no Jira. Problemas recém-criados são automaticamente vinculados e serão sincronizados de acordo com sua configuração.
Quando habilitado, uma URL é exibida—esta URL deve ser fornecida na configuração do Webhook do Jira para propagar eventos do Jira para o Fluid.
Atualizar status a partir do Jira
[Atualizações Bidirecionais] – Habilita a sincronização bidirecional dos status das tarefas entre o Fluid e o Jira. Qualquer alteração de status feita no Fluid será enviada ao Jira, e qualquer atualização de status no Jira será refletida no cartão correspondente do Fluid.
Isso garante que os status em ambos os sistemas permaneçam totalmente sincronizados.
Nota: Se esta opção não estiver habilitada, as alterações de status no Fluid não serão sincronizadas com o Jira, e as atualizações de status no Jira não serão refletidas no Fluid.
Permitir Exclusão no Jira
Permite que o Fluid exclua tarefas no Jira. Observe que esta é uma ação destrutiva. O item do Jira será excluído permanentemente e não poderá ser recuperado.
Excluir itens de trabalho do Backlog do Jira
Quando habilitado, mover itens para o Backlog no Fluid excluirá automaticamente os problemas vinculados no Jira.
Se esta opção não estiver habilitada, os problemas do Jira permanecem inalterados e continuam vinculados aos itens correspondentes do Backlog do Fluid.
Criar Tarefas de Backlog no Jira
Quando habilitado, criar uma tarefa de Backlog no Fluid também criará e vinculará um problema correspondente no Jira.
Se esta opção não estiver habilitada, os problemas do Jira são criados e vinculados apenas quando a tarefa do Fluid é movida para fora do Backlog.
Ignorar Criação na Primeira Coluna no Jira
Quando habilitado, qualquer tarefa criada no Fluid na primeira coluna do quadro não será criada nem vinculada a um problema correspondente no Jira.
Se habilitado, essas tarefas só serão criadas e vinculadas quando a tarefa do Fluid for movida para uma coluna subsequente no quadro.
Permitir que Anexos sejam sincronizados do Fluid para o DevOps
Quando habilitado, vinculará anexos do Item do Fluid ao Jira. Os anexos são links de retorno ao Fluid para visualização/download.
Sincronizar item após criar ou vincular
Assim que um item do Fluid é criado no quadro, ele é imediatamente sincronizado com o Jira. Não é necessário aguardar a sincronização agendada nem clicar manualmente em "Sincronização Agendada" no topo do quadro para atualizar suas propriedades.
Calculadora de % de Progresso
O progresso da tarefa pode ser calculado com base no status de seus itens filhos usando um dos seguintes métodos:
Frequência de Status
O progresso é determinado pela proporção de itens filhos concluídos em relação ao número total de itens filhos.
Fórmula:
Progresso = Número de itens filhos concluídos ÷ Número total de itens filhos
Baseado em Pontos
O progresso é determinado pela proporção de pontos associados aos itens filhos concluídos em relação ao total de pontos de todos os itens filhos.
Fórmula:
Progresso = Soma dos pontos dos itens filhos concluídos ÷ Total de pontos de todos os itens filhos
Baseado em Duração
O progresso é determinado pela proporção da duração planejada dos itens filhos concluídos em relação à duração planejada total de todos os itens filhos.
Fórmula:
Progresso = Soma das durações dos itens filhos concluídos ÷ Duração total de todos os itens filhos
Incluir item pai no cálculo de progresso em %
Decida se o item pai do Jira deve ser incluído no cálculo de progresso. Se a tarefa pai serve apenas como um contêiner para subtarefas, talvez você não queira que ela contribua para o cálculo.
Habilitado: O item pai é incluído no cálculo de progresso.
Desabilitado: Apenas os itens filhos no nível folha são considerados ao determinar o progresso.
Isso garante que as tarefas contêiner não inflem artificialmente ou distorçam as métricas de progresso.
Incluir itens "Relaciona-se a" no cálculo de progresso em %
Determina se os problemas vinculados ao Jira com "Relaciona-se a" são incluídos no cálculo do progresso das subtarefas.
Habilitado: Tanto as subtarefas filhas diretas quanto os problemas do Jira "Relacionados a" são considerados.
Desabilitado: Apenas as subtarefas filhas diretas são usadas para calcular o progresso.
Mostrar Status do Jira nos Problemas Filhos
O status real do Jira de cada problema filho é exibido inline na barra de progresso.
Log Detalhado
Usado durante a configuração inicial, ative esta opção para ver mensagens detalhadas em caso de problemas de comunicação entre o Fluid e o Jira.
Mapeamento de Status
Configure as colunas de status que serão mapeadas no Jira quando os status das tarefas estiverem sendo atualizados.
Mapeamentos de Tipos de Tarefas
Configure os tipos de tarefas que serão mapeados para o Jira. Apenas as tarefas que foram configuradas e mapeadas serão usadas para integração com o Jira.
Propriedades Comuns
Configure quais propriedades comuns serão associadas a todas as tarefas mapeadas para minimizar a duplicação. As propriedades, se definidas, serão enviadas para o Jira na criação e atualização do cartão do Fluid.
Propriedades da Tarefa
Configure propriedades específicas apenas para este tipo de tarefa. Somente as propriedades mapeadas aqui serão aplicadas à tarefa, além das que foram definidas como comuns.
Geração de Token PAT de Usuário
Uma conta de usuário é uma conta associada a uma pessoa. Todos os usuários têm permissão para criar seus próprios PATs, que corresponderão ao seu nível de permissão atual. Para criar os tokens, você pode seguir estas etapas:
Os tokens de API OAuth2 e escopos do Jira não são suportados atualmente. OAuth2 é um modelo de autenticação introduzido recentemente no Jira, e estamos trabalhando ativamente para adicionar suporte. Enquanto isso, as integrações só podem ser configuradas usando tokens de API padrão.
No seu aplicativo Atlassian:
No Jira, selecione sua foto de perfil no canto superior direito da tela e escolha Perfil. Depois de acessar seu perfil, clique em "Gerenciar sua conta"
Selecione Segurança no menu superior
Role a página para baixo e clique em Criar e gerenciar tokens de API.
Clique em Criar token de API
Dê um nome de rótulo ao seu novo token.
Mantenha este token seguro, ele será usado como parte do processo de configuração dos seus quadros Fluid.
Geração de Token PAT de Conta de Serviço
Uma conta de serviço é uma conta que não está associada a uma pessoa. Isso significa que ela não precisa de senha para fazer login na sua organização Atlassian.
Você gerencia o ciclo de vida de uma conta de serviço da mesma forma que gerencia uma conta de usuário. Você pode criar e editar a conta. Você também pode conceder permissões de aplicativo à conta, editar os detalhes do perfil da conta de serviço e criar credenciais para a conta de serviço.
Você pode criar uma conta de serviço na Administração do Atlassian. Você pode atribuir permissões de aplicativo a contas de serviço com base no aplicativo selecionado.
Para criar uma conta de serviço:
Navegue até Administraçãoadmin.atlassian.com. Selecione uma organização se você tiver mais de uma.
Selecione Diretório > Contas de serviço.
Selecione Criar umaconta de serviço.
Para o nome da conta de serviço, insira um nome alfanumérico com 6 a 30 caracteres.
Para a descrição opcional, insira o nome de um aplicativo que usa a conta. Ex.: Fluid-Jira-Integration
Selecione o aplicativo Jira, este é o aplicativo ao qual queremos ter acesso e, em Funções, selecione a função Usuário.
Selecione Criar. Anote o endereço de e-mail exibido, este é o nome de usuário desta Conta de Serviço. Ao preencher o campo de nome de usuário da configuração de integração do Fluid, este endereço de e-mail deve ser utilizado.
Clique em Criar credenciais
Escolha Token de API e clique em Próximo
Insira um Nome para o token, escolha uma data de Expiração e clique em Próximo
Na lista suspensa Aplicativo, escolha Jira e, em Tipo de escopo, escolha Clássico e clique em Próximo
Clique em Criar
Clique em Concluído
Clique em Copiar para copiar o token PAT para a área de transferência, salve-o em um local seguro, você precisará dele mais tarde ao configurar a integração do Fluid neste guia. Clique em Concluído
Sincronização de Status
Quando habilitada, esta opção controla o comportamento de sincronização de status do Jira para o Fluid e vice-versa. Se estiver habilitada, é considerada uma sincronização bidirecional.
Se o status do Fluid for alterado, ele será enviado ao Jira e o item será atualizado de acordo.
Se o status do Jira for alterado, quando o trabalho de sincronização configurado for executado, o cartão do Fluid será atualizado para corresponder ao status do item do Jira.
Uma vez sincronizados, ambos os itens são correspondidos em termos de seus respectivos status com base no Modo de Sincronização de Status (veja abaixo) e definidos conforme o mapeamento de status; consulte a seção "Mapeamento de Status" abaixo para mais informações.
Quando desabilitada, nenhuma informação de status será enviada como parte da criação do item no Jira. Por padrão, o Jira criará o item com seu status padrão, conforme definido para aquele tipo de tarefa dentro do próprio Jira. Consulte a configuração do Jira para cada tipo de tarefa dentro do próprio aplicativo Jira para saber qual status padrão é utilizado.
Modo de Sincronização de Status
Se a Sincronização de Status estiver habilitada, haverá um botão visível, conforme destacado acima, que pode ser clicado para escolher o Modo de Sincronização que você deseja aplicar.
Somente na Criação [Envio]
O status do Fluid é enviado uma única vez, apenas na criação do item no Jira. Quaisquer alterações subsequentes de status no Fluid não serão refletidas no Jira. Você pode continuar atualizando o status no Fluid, e o status aparecerá alterado no Fluid, mas o status do item vinculado no Jira não será alterado.
Unidirecional [Envio]
Qualquer alteração no status do Fluid é enviada ao Jira. No entanto, nenhum status do Jira é puxado/atualizado de volta para o Fluid. Use esta opção se você pretende que o Fluid seja a fonte principal de dados de status do item.
Unidirecional [Recebimento]
Qualquer alteração no status do item do Jira é puxada para o Fluid e substitui o status atual do item do Fluid quando a sincronização ocorre. Use esta opção se você pretende que o Jira seja a fonte principal de status do item.
Bidirecional [Sincronização]
O status do Fluid e o status do Jira são mantidos sincronizados. Quaisquer alterações no Fluid são enviadas ao Jira e, vice-versa, quaisquer alterações de status no Jira são sincronizadas de volta para o Fluid quando o processo de sincronização é executado.
Mapeamento de Status
No Fluid, as colunas de status para cada quadro podem ser configuradas para mover tarefas conforme elas avançam no fluxo de trabalho ágil. É importante mapear quais colunas de status devem ser incluídas no Jira para garantir que, quando o status de uma tarefa for atualizado no Fluid, ele seja sincronizado no Jira.
Nota: Se os status não forem mapeados, as atualizações feitas no Fluid nas tarefas não serão integradas ao Jira.
Os status podem ter um relacionamento 1 : M ( 1 para Muitos ). Por exemplo, "In Progress" e "Dev Complete" no Fluid foram mapeados para o mesmo "In Progress" no Jira. Além disso, "Not Started" e "Returned" foram ambos mapeados para "To Do" no Jira.
Nota: A primeira linha está colorida em cinza. Isso indica que este é o status inicial para itens criados. A última linha está colorida em verde para indicar que este é o status final do item. Todos os outros status estão coloridos em azul e, por definição, são considerados um status "Em Andamento".
Clique em [+ New Status Mapping ] para adicionar uma nova linha.
Selecione a partir de uma lista de opções de status possíveis à esquerda.
No lado direito, digite o nome do Status ao qual o status do Fluid deve ser aplicado.
Clique em [ X ] para remover a linha.
Propriedades Comuns
A configuração de propriedades comuns oferece a capacidade de estabelecer propriedades que aplicarão consistência em todos os dados de tarefas que são simplificados no seu fluxo de trabalho.
Essas propriedades são amplamente utilizadas e aplicadas a múltiplas tarefas, o que por sua vez reduz o esforço duplicado.
Somente as propriedades mapeadas serão enviadas ao Jira.
Modo de Sincronização de Propriedades Comuns
Somente Criação [Push]
As propriedades do Fluid são enviadas uma única vez e apenas na criação do item para o Jira. Quaisquer alterações subsequentes nas propriedades no Fluid não serão refletidas no Jira. Você pode continuar a atualizar propriedades no Fluid, e elas aparecerão alteradas no Fluid, mas as propriedades do item vinculado no Jira não serão alteradas.
Unidirecional [Push]
Quaisquer propriedades alteradas no Fluid são enviadas ao Jira. No entanto, nenhuma propriedade do Jira é puxada/atualizada de volta para o Fluid. Use isso se você pretende que o Fluid seja a fonte padrão de propriedades para o item.
Unidirecional [Pull]
Quaisquer propriedades alteradas no item do Jira são puxadas de volta para o Fluid e substituem os valores das propriedades do item no Fluid, quando a sincronização ocorre. Use isso se você pretende que o Jira seja a fonte padrão de propriedades para o item.
Bidirecional [Sync]
As propriedades do Fluid e as propriedades do Jira são mantidas sincronizadas. Quaisquer alterações no Fluid são enviadas ao Jira e vice-versa, e quaisquer alterações de propriedades no Jira são sincronizadas de volta para o Fluid quando o processo de sincronização é executado.
Tipo de Tarefa
Para cada tarefa que você deseja criar um item no Jira no seu fluxo de trabalho, o Tipo de Tarefa precisa ser definido e mapeado para o tipo equivalente no Jira.
Se um tipo de Tarefa do Fluid não estiver mapeado, então nenhum item correspondente é criado no Jira no fluxo de trabalho.
Propriedades do Tipo de Tarefa
As propriedades do tipo de tarefa fornecem relatórios adicionais sobre os diferentes tipos de atividades realizadas dentro de um fluxo de trabalho. Estas se relacionam especificamente apenas a este Tipo de Tarefa definido.
Se você tiver uma propriedade que é definida apenas para um tipo de tarefa específico, use este fluxo de trabalho. Se você tiver uma propriedade que será aplicada a todos os tipos de tarefas, use as Propriedades Comuns conforme definido acima. As propriedades comuns são incluídas como um conjunto união de propriedades para este tipo de tarefa.
Status do Tipo de Tarefa
O status do tipo de tarefa permite que você defina quaisquer status específicos adicionais que se aplicam apenas a este Tipo de tarefa. Observe que você ainda pode ter mapeamentos de Status definidos conforme mencionado anteriormente na seção de mapeamento de Status deste documento, mas qualquer status que você definir aqui no nível do Tipo de Tarefa é adicional aos mapeamentos de Status já definidos e é específico apenas para este Tipo de tarefa.
Se você já definiu o mapeamento "Not Started"->"New", então adicionar um mapeamento de status do Tipo de tarefa de "In Progress"-> "Working" significará que para o Tipo de Tarefa Fluid de New Feature, mapeamos o Fluid "Not Started" e "In Progress" adequadamente.
Isso permite que você, se preferir, tenha conjuntos de status completamente diferentes para cada Tipo de tarefa, dependendo de como você configurou seus status e regras no Jira.
Sincronizando Campos do Jira para o Fluid.
Cada vez que uma tarefa/cartão do quadro é atualizado, as alterações são sincronizadas com o cartão no Jira.
Abaixo está um exemplo de um cartão criado em um quadro do Fluid e como ele é representado no Jira.
Este é o cartão criado no Jira como uma issue.
Clicar no cartão no Fluid abre o diálogo de edição; a seção de Integrações é exibida na parte inferior do cartão do quadro, onde você pode ver a sincronização do item do Jira no Fluid.
O status "In Progress" mostra que o item do Jira está sendo trabalhado no momento. Você pode clicar na opção "Open Jira" para visualizar o item em si no Jira.
"0/1" indica que há 1 item associado a esta integração e 0 foi concluído.
Nota: Você pode iniciar manualmente um trabalho de sincronização clicando no botão "Sync Integrations"
localizado no topo do quadro. Isso executará manualmente o trabalho que busca todos os dados do Jira. É o mesmo trabalho que é executado na frequência definida conforme configurado anteriormente.
Para ilustrar melhor, a equipe de TI/Tecnologia adicionou 3 subtarefas no Jira para este item pai no exemplo abaixo. Isso demonstra como a equipe de TI/Tecnologia gerencia a issue do Jira usando sua própria metodologia ágil, fora do Proprietário do Projeto.
As 3 subtarefas são controladas pela equipe de TI/Tecnologia, todos os campos são definidos pela TI e a TI é livre para usar essas subtarefas em qualquer metodologia de desenvolvimento que escolher. À medida que essas SubTarefas são atualizadas pela TI, o item pai do Jira é atualizado para mostrar a mudança no status das subtarefas. A TI também colocou uma Data de Vencimento neste item pai "30 Mar 2023".
Nota: Não é um requisito da TI usar subtarefas; eles são livres para trabalhar a partir da issue pai do Jira e atualizá-la conforme necessário, usá-la em sprints etc. As subtarefas são o processo recomendado do Jira para dividir uma tarefa maior em componentes menores, que podem ser trabalhados separadamente e depois consolidados em um pai.
Após os dados terem sido sincronizados, a seção abaixo na ação é exibida no diálogo de edição da ação.
"In Progress" é o status do item do Jira; clicar em "Open Jira" irá direcioná-lo diretamente para o item do Jira em uma nova aba do navegador.
O "30 Mar 23" é a data de vencimento definida no próprio item do Jira. Esta NÃO é a Data de Vencimento do item do Fluid.
"33% concluído" indica a porcentagem de subtarefas concluídas / total de subtarefas. A barra mostra uma barra de progresso de quanto trabalho resta antes da conclusão. Verde é "Concluído", Azul é "Em Andamento", Cinza é "Não Iniciado"
Clicar em "mostrar detalhes" exibirá uma visão expandida e você poderá ver todas as subtarefas atribuídas, um título/descrição, status e data de vencimento para cada subtarefa
O Proprietário do Projeto tem visibilidade sobre o trabalho e a própria equipe de TI/Tecnologia, podendo ver que a equipe de TI/Tecnologia está 33% concluída neste trabalho e que as datas de vencimento atuais estão alinhadas.
A equipe de TI/Tecnologia adicionou as tarefas ao seu ciclo de sprint e realizou o desenvolvimento dentro de seus próprios processos sem precisar mudar a forma como funcionam como equipe. O Proprietário do Projeto também não precisou pressionar o líder técnico de TI por atualizações, pois o Proprietário do Projeto pode ver isso no próprio cartão/ação.
