Guia Integração da Elven Platform ITSM Jira  

Acessando a Configuração de Integração do ITSM Jira

• • No canto superior direito da tela, clique no ícone de perfil. O ícone pode ser representado por um avatar ou a inicial do seu nome.
  • No menu que será exibido, selecione a opção Organization Settings. Essa opção te levará às configurações da sua organização.
  • Clique na aba Integrations. É aqui que você pode visualizar e gerenciar todas as integrações disponíveis.
  • Na opção, Jira Integration podemos criar a integração com Jira. Para isso basta abrir o formulário de configuração (Install new integration), disponível no corpo dessa opção. 

Criando a Integração com ITSM Jira 

Conectar o Jira à Elven Platform é mais simples do que parece, e foi pensado justamente para tornar a rotina da sua equipe mais eficiente e integrada. Antes de tudo, é importante que você já tenha um projeto do tipo Jira Service Management criado em seu ambiente Jira. Esse projeto será o responsável por receber automaticamente os tickets gerados pela Elven Platform. Com o projeto pronto, acesse o formulário de configuração da integração e siga estas orientações:

• No campo Integration name, escolha um nome que ajude a identificar essa integração facilmente no futuro. Algo que faça sentido para a sua equipe.

• Em Default Jira Language, selecione o idioma padrão utilizado no seu projeto do Jira, garantindo que os dados sejam interpretados corretamente.

• No campo Subdomain, insira apenas o subdomínio do seu Jira (a parte que vem antes de .atlassian.net). Esse detalhe é essencial para estabelecer a conexão com a plataforma certa.

• Por fim, em Project Key, digite o código do projeto Jira onde os tickets devem ser criados. Você encontra essa informação dentro das configurações do seu projeto, no próprio Jira.

Com tudo isso preenchido, a integração estará pronta para funcionar, permitindo que os incidentes da Elven Platform se transformem automaticamente em tickets dentro do Jira, de forma fluida e centralizada

 

 

A autenticação para a integração entre o Jira e a Elven Platform é realizada por meio de nome de usuário e token. Para configurar, preencha os campos Username e Api Token, utilizando o token gerado na página de segurança da sua conta Jira. Após preencher todos os campos obrigatórios, clique em Save integration para concluir a configuração. Com isso, a integração estará pronta, permitindo abrir tickets diretamente da tela de incidentes na Elven Platform e centralizar a gestão de informações de forma eficiente. 

Para verificar o idioma configurado no Jira, localize o seu projeto e clique no ícone de três pontinhos (•••). Em seguida, selecione a opção para acessar as Configurações do projeto. Dentro dessa área, procure por Suporte a idiomas, ali você verá o idioma padrão configurado. Isso garante que a integração com a Elven Platform esteja de acordo com as suas preferências de idioma.

Para obter seu API Token de forma simples, clique no seu avatar (ou nas suas iniciais) e acesse a opção Configurações da conta. Em seguida, vá até a aba Security e clique em Create and manage API tokens. Depois, selecione o botão Create an API token. Dê um nome para o token, algo que ajude a identificá-lo no futuro, e finalize clicando em Create. Pronto! Seu token foi gerado com sucesso e já está pronto para ser usado na integração com a Elven Platform.

 

Se preferir, você pode garantir maior segurança armazenando o token como uma secret. Para isso, basta clicar no ícone de chave no campo Api Token ao configurar a integração. Assim, você protege suas credenciais e mantém o foco na eficiência e segurança do seu ambiente de trabalho. 

Além disso, após a conclusão do processo de integração entre Elven Platform e o Jira, deverá aparecer sua integração na lista da opção Integration Jira. 

Abrindo um Ticket no Jira

Para criar um ticket no Jira partir da Elven Platform, basta localizar o incidente desejado e clicar no botão Open Ticket disponível na tela do incidente. Com isso, o ticket será aberto no Jira, mantendo ambas as plataformas alinhadas para uma gestão eficiente.

 

Resolução de Incidente

Após a resolução do incidente, você pode atualizar o status do ticket no Jira diretamente pela Elven Platform. Basta localizar o incidente e clicar no botão Update Ticket disponível na tela do incidente. Essa ação sincronizará as informações e moverá automaticamente o ticket para a coluna ITENS CONCLUÍDOS, garantindo que o fluxo de trabalho esteja sempre atualizado e alinhado entre as duas plataformas. 

Essa funcionalidade facilita o acompanhamento do ciclo de vida dos tickets, reduzindo a necessidade de ajustes manuais e proporcionando maior eficiência na gestão de incidentes. Assim, sua equipe pode focar na resolução de problemas, enquanto a Elven Platform cuida da organização e da comunicação entre os sistemas integrados. 

 

Glossário de Termos Técnicos

ITSM (IT Service Management): Gestão de serviços de TI que organiza e padroniza processos relacionados a incidentes, problemas e solicitações de serviço. 

Jira: Ferramenta de gerenciamento de projetos amplamente utilizada para rastreamento de tarefas, bugs e incidentes. 

Integration Name: Nome da integração configurada na Elven Platform, usado para identificá-la facilmente no menu de integrações. 

Default Jira Language: Idioma padrão configurado na instância Jira, que deve ser informado para alinhar a integração com as preferências do usuário. 

Subdomain: Parte do endereço da URL da sua instância Jira, usada para conectar corretamente a Elven Platform ao seu ambiente Jira. Exemplo: subdomínio.atlassian.net. 

Project Key: Código único do projeto no Jira, necessário para associar os tickets da Elven Platform ao projeto correto. Exemplo: “PROJ1”. 

Username: Nome de usuário utilizado para autenticação na integração com o Jira. 

API Token: Token gerado na conta Atlassian do Jira para autenticação segura entre a Elven Platform e o Jira. 

Security: Aba nas configurações da conta Atlassian onde você pode criar e gerenciar tokens de API para autenticação. 

Open Ticket: Botão disponível na tela de incidentes da Elven Platform para criar um novo ticket no Jira a partir de um incidente identificado. 

Update Ticket: Botão na tela de incidentes da Elven Platform que permite atualizar o status de um ticket já criado no Jira, sincronizando as informações e movendo-o para a coluna “ITENS CONCLUÍDOS”. 

ITENS CONCLUÍDOS: Coluna no Jira onde os tickets resolvidos são movidos automaticamente após a atualização do status pela Elven Platform. 

Secret: Opção de armazenamento seguro para o API Token durante a configuração da integração, disponível na Elven Platform.