Integração com o Jira

A integração com o Jira mostra as atividades do Jira no cronograma de projeto do FlexiProject. Cada projeto pode obter atividades de um ou de vários projetos do Jira, e a lista das atividades obtidas é limitada por tipos de atividade ou por um filtro JQL. As atividades do Jira mantêm-se sincronizadas com o Jira no cronograma; os respetivos campos são apenas de leitura.

Um administrador ativa a integração e configura-a em Definições do sistema > JIRA (ver Definições do sistema). A ligação dos utilizadores do Jira aos utilizadores do FlexiProject permite que o cronograma e a carga de trabalho dos recursos mostrem os proprietários das atividades do Jira.

Ligação ao Jira

A chave de ligação no Jira

1. No Jira, clique no avatar no canto superior direito e escolha Gerir a sua conta.
2. Aceda ao separador Segurança e, na secção Token de API, clique em Criar e gerir tokens de API.
3. Clique em Criar token de API, introduza um nome (por exemplo, “FlexiProject”) e clique em Criar.
4. Copie a chave gerada. O Jira mostra-a apenas uma vez.

Ativar a integração no FlexiProject

1. Abra as Definições do sistema (menu principal) e aceda à página JIRA. Aparece o cartão Integração com o JIRA.
2. Mude a integração para Ativado.
3. Introduza o Endereço do servidor — o endereço em que abre o Jira da sua organização, por exemplo https://name.atlassian.net.
4. Introduza o E-mail do utilizador — o mesmo com que tem sessão iniciada o utilizador que gerou a chave.
5. Cole a chave copiada no campo Chave.
6. Clique em Guardar. Com dados corretos, aparece a mensagem A ligação ao servidor JIRA está correcta; com dados incorretos, Falha na ligação ao servidor JIRA ou Endereço incorreto do servidor JIRA.

O botão Verificar a ligação verifica o estado da ligação em qualquer momento.

Nota: desativar a integração com Desligado remove todas as ligações dos projetos ao Jira e todas as atividades do Jira dos cronogramas. Esta ação não pode ser anulada, e para a ativar de novo é preciso ligar outra vez os projetos.

Ligar utilizadores do Jira

Por baixo dos parâmetros de ligação encontra-se a tabela Utilizadores, com as colunas Nome do Jira, ID Jira e Utilizador (o utilizador do FlexiProject ligado). Um filtro acima da tabela limita a lista. Com uma ligação ativa, o FlexiProject tenta continuamente ligar os utilizadores do Jira aos utilizadores do FlexiProject através da correspondência dos endereços de e-mail. Quando o Jira partilha um endereço de e-mail e o mesmo endereço existe no FlexiProject, o avatar e o nome do utilizador ligado aparecem junto ao nome do Jira. Se o Jira partilha ou não os endereços depende das suas definições globais de segurança e das definições de privacidade do utilizador do Jira.

As ligações criadas automaticamente atualizam-se sozinhas. As ligações adicionadas manualmente não: depois de uma mudança de apelido ou de endereço de e-mail, tem de as corrigir à mão.

Ligar manualmente

1. Passe o cursor sobre uma linha sem utilizador ligado e clique no símbolo de três pontos.
2. Escolha Ligar. Abre-se a janela Associar utilizador.
3. Selecione o utilizador do FlexiProject e clique em Guardar.

Remover uma ligação

1. Passe o cursor sobre uma linha com um utilizador ligado e clique no símbolo de três pontos.
2. Escolha Desligar. Aparece a pergunta Tem a certeza de que pretende remover a ligação?.
3. Confirme com Guardar.

Importar a lista de utilizadores do Jira

1. Gere um ficheiro CSV de utilizadores no painel de administração da Atlassian (admin.atlassian.com), no separador de utilizadores, com o comando de exportação. O ficheiro tem de conter os campos User id, User name e email.
2. Clique em Importações de utilizadores do Jira, por baixo do cabeçalho da tabela. Abre-se a janela de importação.
3. Escolha o ficheiro ou arraste-o para a janela e clique em Guardar. A lista de utilizadores do Jira é atualizada e as ligações encontradas são preenchidas automaticamente.

As linhas com valores incorretos são ignoradas e a aplicação lista-as depois da importação; um ficheiro incorreto termina com uma mensagem sobre o formato CSV errado.

Atividades do Jira no cronograma do projeto

Ligar um projeto ao Jira

1. Abra o projeto, separador Cronograma.
2. Clique em Definições e escolha Ligação ao JIRA (o item fica visível depois de a integração estar ativada). Abre-se a janela Integração com o JIRA.
3. Introduza a Chave do projeto do Jira. Para obter atividades de vários projetos do Jira, introduza as chaves separadas por vírgulas.
4. Clique em Ligar. Abre-se a janela Importações do JIRA.
5. Na parte Descarregamento de dados, escolha como obter os dados: Tipo de Tarefas (apenas com um projeto do Jira) ou Filtro JQL (ver Filtro JQL).
6. Para os tipos de atividade: assinale os tipos de atividade nos níveis da hierarquia (pelo menos um tipo — caso contrário, aparece a mensagem Pelo menos um nível deve ser marcado) e depois clique em Guardar. Sempre que possível, as dependências entre os tipos de atividade são convertidas numa hierarquia de atividades no cronograma.

Quando o descarregamento é bem-sucedido, as atividades do Jira aparecem no projeto e surge um ícone do Jira junto ao nome do projeto; ao clicar nele, o projeto do Jira abre num novo separador. O descarregamento pode falhar, por exemplo quando o utilizador indicado na ligação não tem permissões ou o JQL tem um erro de sintaxe (Erro na consulta JQL). A aplicação mostra então uma mensagem. Uma chave que não existe ou a que não tem acesso termina com Chave de projeto incorrecta, o projeto não existe ou o utilizador não tem acesso ao mesmo.

Alterar a forma de obter as atividades

O mesmo comando Ligação ao JIRA abre a janela Importações do JIRA de um projeto já ligado, onde altera os tipos de atividade ou a consulta JQL.

Remover as atividades do Jira de um projeto

1. Abra a janela Importações do JIRA com o comando Ligação ao JIRA.
2. Clique em Eliminar e confirme na janela Remoção da ligação JIRA. A mensagem avisa que eliminar a ligação elimina todas as ligações no cronograma e que a ação é irreversível.

Depois da eliminação, as atividades do Jira desaparecem do cronograma e o projeto deixa de estar marcado como ligado ao Jira.

Filtro JQL

O JQL (Jira Query Language) permite obter para um projeto exatamente as atividades do Jira de que precisa, inclusivamente de vários projetos do Jira em simultâneo.

1. No Jira, prepare um filtro na ferramenta Filtros. O código JQL fica visível depois de mudar a vista do filtro de básica para JQL.
2. Copie o código JQL.
3. No FlexiProject, na janela Importações do JIRA, escolha Filtro JQL e cole o código no campo de texto.
4. Clique em Guardar.

Uma consulta com um erro de sintaxe é rejeitada com a mensagem Erro na consulta JQL. O filtro afeta apenas as atividades que chegam ao cronograma; em cada sincronização, as atividades que ficam fora do resultado do filtro desaparecem do cronograma.

Atividades do Jira no cronograma

As atividades do Jira ficam no fim do cronograma, com a estrutura preservada, e têm um ícone do Jira no cronograma. Atualizam-se automaticamente numa sincronização periódica; os campos que vêm do Jira — Nome, Descrição, Progresso, Proprietário e a hierarquia de atividades — são apenas de leitura. Não pode alterar o progresso nem os proprietários de uma atividade deste tipo (a aplicação indica Não é possível alterar o estado das tarefas provenientes do JIRA e Não é possível alterar os proprietários das tarefas provenientes do JIRA), e estas atividades não são copiadas quando um projeto é clonado. Uma atividade do Jira não pode ser a atividade-mãe de atividades do FlexiProject. Pode reordenar as atividades abaixo de uma atividade-mãe do Jira, e as atividades de resumo do Jira, com as respetivas subatividades, podem ser inseridas na estrutura do cronograma.

Num projeto ligado, o cronograma tem três colunas adicionais: ID do Jira (um clique abre a atividade no Jira num novo separador), Estado do Jira e Tipo de Jira. O progresso de uma atividade resulta da categoria de estado no Jira: por fazer — 0%, em curso — 50%, concluída — 100%.

O proprietário da atividade provém da ligação dos utilizadores (ver Ligar utilizadores do Jira). Quando um utilizador do Jira está ligado a um utilizador do FlexiProject, o cronograma mostra o respetivo avatar e nome, e o utilizador é adicionado ao projeto. Sem ligação, vê um ícone de avatar cinzento com o nome do Jira. O cronograma é descrito em Cronograma do projeto.