A integração do Movidesk com o Redmine proporciona melhor controle das demandas geradas entre as equipes de desenvolvimento e de suporte da sua empresa. Esta integração permite que quando uma solicitação for aberta por um cliente, o agente possa registrar a falha no Redmine através do ticket aberto no Movidesk e encaminhá-lo para a equipe de desenvolvimento. A mesma, por sua vez, após corrigir o bug, poderá adicionar comentários, ou mesmo, alterar o status do ticket diretamente do Redmine.
Como agente, é possível criar um novo problema do Redmine a partir de um ticket, ou vincular com link um problema existente do Redmine através de um ticket. A integração permite, então, utilizar o link para rastrear todo o progresso realizado pela equipe de desenvolvimento sobre a solução do problema. Por exemplo, no Movidesk você pode visualizar os detalhes sobre um problema registrado no Redmine para ver se a equipe de desenvolvimento o corrigiu.
Neste artigo, você vai ver:
- Integração Movidesk e Redmine [Vídeo]
- Configurando a integração com o Movidesk no Redmine
- Configurando a integração com o Redmine no Movidesk
- Gerando uma issue no Redmine atráves de um ticket do Movidesk
- Extra - Opções da central de integrações
Integração Movidesk e Redmine [Vídeo]
Configurando a integração com o Movidesk no Redmine
A configuração da integração no Redmine ocorre, basicamente, em três etapas breves. Confira abaixo.
- Copie e extraia os arquivos do movidesk.zip em #{RAILS_ROOT}/plugins
- Reinicie o seu Redmine.
- Vá até a lista de plugins no Redmine em Administração > Plugins e configure o plugin Movidesk.
Versão atual do plugin: 1.1.2. (03/10/2018)
Configurando a integração com o Redmine no Movidesk
Antes de mais nada, verifique se há um token gerado em seu sistema. Para tal procedimento, acesse a tela de parâmetros do sistema e selecione a aba "Ambiente". Utilize a barra de rolagem para descer até o final da página. Caso o campo "Chave da API" esteja em branco, clique em "Gerar nova chave".
Após verificar (ou gerar) o token do seu Movidesk, a configuração de fato, pode ser iniciada. Para isso, a partir da tela principal do sistema, basta acessar "Configurações" e no menu "integrações", acessar "Central de integrações" e selecionar a opção "+ Nova integração".
Executado o procedimento anterior, o sistema apresentará a tela para configuração da integração. Na guia "Principal", defina um nome para a integração cadastrada (no exemplo abaixo, nomeamos por Redmine). Depois, você deve selecionar a opção "Redmine" clicando na caixa de tipo de integração (por padrão, o sistema traz como primeira opção a integração ao Pipedrive) e em seguida, marque a opção "Habilitado".
Tendo realizado as configurações na guia Principal, selecione a guia "Dados para conexão". Nesta guia, informe a URL do seu Redmine e a chave de integração (token) do mesmo.
A próxima guia a ser definida, é a de configurações da integração. Nesta aba você define de que forma funcionará esta integração, se automaticamente (ou não) e ainda, informa qual será o projeto do Redmine ao qual este ticket será relacionado e que tipo de issues serão geradas por padrão, a partir dos tickets do Movidesk. É possível também, definir se as alterações de status dos tickets serão enviadas para o Redmine.
- ENVIAR ALTERAÇÕES DE STATUS DO TICKET DO MOVIDESK PARA A ISSUE DO REDMINE - Caso este parâmetro esteja habilitado, as alterações de status dos tickets serão enviadas para o Redmine, desde que estes estejam corretamente correlacionados, fazendo com que a integração de status seja bidirecional. Caso este parâmetro seja desabilitado, apenas as alterações de status das issues do Redmine serão espelhadas aos tickets do Movidesk, sem reciprocidade.
- INTEGRAÇÃO AUTOMÁTICA - Se este parâmetro estiver marcado, a integração ocorrerá de forma automática quando as condições forem atingidas. A integração automática sempre irá gerar uma nova issue no Redmine, enviando a issue sempre para o mesmo projeto definido no Movidesk (neste caso esta informação é obrigatória).
- INTEGRAÇÃO MANUAL - Caso o parâmetro estiver desmarcado, quando as condições forem atingidas, o sistema somente exibirá uma área onde o agente poderá optar por enviar o ticket para o Redmine ou não. A integração manual permite que o agente opte entre criar uma nova issue, ou associar o ticket a uma issue já existente. No caso da integração manual, a informação do projeto é opcional e o agente poderá alterar o projeto no momento da abertura da issue.
Após ajustar as configurações da integração, é possível apontar condições para definir quando a integração será executada (quando de forma automática) ou terá os campos exibidos, possibilitando o vínculo a uma issue existente ou criação de uma nova tarefa no Redmine (quando de forma manual). Essas configurações se dão na guia "Condições" e caso forem deixadas em branco, a integração não fará distinção entre os tickets.
Por fim, utilize a guia "Correlação entre campos" para definir a ligação dos campos do Movidesk com os campos do seu Redmine. Você pode correlacionar situação/status, tipo/categoria, prioridade/urgência, usuário/agente (esta correlação aponta o responsável pela issue gerada através do ticket e o agente do Movidesk não precisa necessariamente ser o mesmo usuário do Redmine) e campos adicionais/campos adicionais (caso deseje integrar estas informações). Os campos à esquerda correspondem ao Redmine, enquanto os da direita referem-se ao seu Movidesk. A correta configuração destes campos é muito importante para que a integração ocorra da maneira desejada.
As informações referentes aos campos adicionais do tipo "Arquivo" não são enviadas do Movidesk para o Redmine em momento algum. A integração deste tipo de campo ocorre apenas no sentido Redmine -> Movidesk, utilizando o mesmo padrão de funcionamento dos demais campos adicionais neste processo.
É preciso garantir que o mapeamento dos status do Redmine e status do Movidesk esteja devidamente configurado na central de integrações do Movidesk, visto que as alterações de campos adicionais só serão refletidas no Movidesk após a mudança de status da issue no Redmine.
Logo, deve ser observado os seguintes passos para que o campo adicional seja refletido no Movidesk:
- Preencher o campo adicional -> salvar alteração no Redmine;
- Mudar o status da issue -> salvar alteração no Redmine.
Ao finalizar as configurações da integração no Movidesk, clique em Salvar e a integração deverá ser gravada com sucesso. Você poderá visualizá-la na central de integrações do sistema.
Tendo efetuado este procedimento, a integração estará completa e pronta para uso.
Gerando uma issue no Redmine através de um ticket do Movidesk
Conforme visto anteriormente, existem duas maneiras de definição para abertura de issues através de tickets, sendo uma delas de forma automática e outra manualmente.
Quando de maneira automática, sempre que um ticket atingir as condições da integração, uma nova issue será instantaneamente criada no Redmine e vinculada ao ticket de origem. No exemplo abaixo, estamos criando um novo ticket (vale ressaltar que a integração automática também ocorre em tickets já abertos, desde que atinjam as condições para integração pré-configuradas). Note que a tela do ticket está com a sua exibição padrão, sem qualquer campo referente ao Redmine.
Ao clicar em "Salvar", as condições da integração do exemplo foram alcançadas e uma nova issue foi criada no Redmine. Observe que o ticket já apresenta um bloco com informações acerca da integração ao lado esquerdo da tela, inclusive com um link direto para acesso à issue, logo abaixo da numeração do ticket.
Veja que ao verificar o histórico de alterações do ticket, o sistema também informa quando foi criada uma nova issue no Redmine, bem como o número da ID de identificação dela.
Quando definido que a integração acontecerá manualmente, o bloco dedicado à integração com o Redmine será exibido sempre que as condições pré-configuradas forem atingidas (assim como funciona no modo automático), porém ao contrário da alternativa anterior, uma issue não será gerada automaticamente. Neste caso, o agente poderá optar entre associar o ticket a uma issue já existente, criar uma nova a partir do ticket, ou ainda, simplesmente não gerar integração caso não julgue necessário.
Caso você decida por criar uma nova issue e tenha definido nas configurações da integração um projeto e/ou tipo padrão, note que eles serão pré-selecionados no cadastro deste novo vínculo. Contudo, você pode alterá-los de acordo com o que lhe for mais conveniente.
Numa situação hipotética, onde um novo ticket no Movidesk é aberto para tratar de um problema que já esteja cadastrado no Redmine, a opção "Associar issue" pode ser a melhor opção. Basta informar a chave da issue a ser vinculada e você evitará a abertura de uma nova demanda para o mesmo problema.
Veja que após salvar, o vínculo foi gerado e é informado no bloco da integração, dentro da tela do ticket. Repare que é exibida a opção "Remover link" e você pode desassociar a issue do ticket se assim desejar.
No histórico de alterações do ticket, observe que a integração é informada. Atente para o detalhe da informação de que maneira se criou o elo entre ticket e issue. O sistema difere as alternativas automática e manual e as especifica dentro das alterações.
Veja o exemplo a seguir. Vamos cadastrar uma ação no ticket do Movidesk e validar a importação para a issue vinculada.
Repare que a ação foi incluída no ticket.
Agora, verificando a issue no Redmine, observamos que a ação foi corretamente importada.
Agora, validaremos o caminho oposto. Vamos adicionar um comentário na issue do Redmine e verificar a importação no ticket (esta ação por padrão será tratada como interna no Movidesk, independentemente do tipo da ação apontada na issue do Redmine, pública ou privada).
Observe que o comentário foi cadastrado corretamente no Redmine.
Também alteramos o status da issue e o status do ticket deverá ser alterado automaticamente.
Veja que o status da issue foi alterada.
Tendo realizado as alterações na issue, vamos verificar o comportamento do ticket no Movidesk. Observe que o sistema aponta que o ticket sofreu alterações. Clique sobre o alerta e verifique as ações apontadas no ticket. Note que o comentário inserido na issue foi incorporado ao ticket em forma de ação pública (visto que não marcamos o check box para gerar ação interna).
Tanto o status do ticket, quanto o da issue (exibido na caixa de integração), também foram atualizados com sucesso.
Extra - Opções da central de integrações
Acessando a central de integrações do Movidesk, além de cadastrar um nova integração, através da caixa de opções é possível realizar o procedimento de clonagem de integrações, habilitar, desabilitar e excluir integrações, bem como exportar estes dados para Microsoft Excel.
