Objetivo: Fornecer informações claras e bem definidas sobre o processo de criação dos diferentes tipos de Issues na ferramenta Jira, através do Zendesk, fornecendo os detalhes sobre cada um de seus processos de criação.
Introdução. 1.1 - Tipos de Issue. No fluxo atual previsto para as equipes de suporte do SFA, existem 4 principais tipos de Issues que podem ser criadas, Manutenção, Associação (sub tarefa), Apoio e Epic. Cada tipo de issue será utilizado para um tipo de situação diferente, conforme abaixo: Manutenção: Utilizado em caso de tickets de onde há algum tipo de erro/inconsistência, onde a equipe do Jira terá de atuar em algum tipo de manutenção. Poderá ser encaminhado para diferentes projetos no Jira. Associado (Sub-tarefa): Utilizado em casos onde devemos associar o Issue a ser criado à um issue já existente no Jira. Poderá ser encaminhado para diferentes projetos no Jira. Epic: Utilizado para tickets do tipo tarefa, atualmente dentro do fluxo do SFA, temos previsto apenas enviar este tipo de Issue para a fila TOTVS CRM SFA - Evolução. Apoio: Utilizado quando uma determinada equipe precisa de algum tipo de ajuda ou informação de alguma equipe que utiliza o Jira. O ticket do Zendesk continuará sob responsabilidade da equipe que solicita o apoio, inclusive para efeitos de SLA. Apoio - Cliente: Utilizado pela área de Desenvolvimento para demandas de Clientes onde não haverá commit de fonte e não serão executadas as demais etapas do processo padrão. Rejeição Manutenção: Utilizado nos casos onde foi gerada uma issue de "Manutenção" no qual a equipe do Jira corrigiu e expediu para o Cliente, porém o problema permanece. Nesse caso, deve ser criada uma nova issue do tipo "Rejeição Manutenção".
Observação: Os Issues do tipo Apoio e Apoio - Cliente só devem ser criados em casos específicos e após ter sido solicitado apoio do Maestro. Em caso de dúvidas, contate o seu Líder.
1.2 - Tipos de macros de processo. São macros criadas pela equipe da engenharia corporativa da TOTVS, de uso obrigatório, com diversas finalidades e funções. Interferem em prazos de SLA, status dos tickets, tags, comunicações com Jira, dente outras funcionalidades. Os tipos de macro de processo a serem utilizadas está associado ao tipo de Issue a ser criado. Abaixo poderão ver os diferentes tipos de macros de processo existentes dentro do fluxo do suporte do SFA:
O3 | Transferência Manutenção: Utilizada para criação de Issues do tipo Manutenção, Rejeição Manutenção e Apoio - Cliente. O3 | Transferência Manutenção - Associação: Utilizada para criação de Issues do tipo Associação (sub tarefa). Apoio Manutenção: Utilizada para criação de Issues do tipo Apoio. Proposta Aprovada: Utilizada para criação de Issues do tipo Epic.
Observação: Existem outros tipos de Issues e macros disponíveis na ferramenta, apenas não foram mencionados neste artigo. Cada exceção deverá ser analisada e tratada individualmente.
1.3 - Macros de texto. Para além das macros de processo existem macros que foram criadas, a pedido dos gestores das equipes do SFA, para mapear o fluxo de tickets entre as equipes e aplicar um texto padrão com informações essenciais para as respectivas equipes. Estas macros sempre terão em seu título o nome da equipe que irá utilizá-la e informações sobre a equipe no Zendesk ou o projeto no Jira para onde se destinam. Estas também são de uso obrigatório em seus respectivos casos, mas apenas adicionam "tags" de identificação, não tendo efeito ou interferem nos demais recursos do Zendesk. Cada equipe possui suas respectivas macros e sempre deverá haver uma macro para cada equipe para onde o ticket irá se destinar, de acordo com o fluxo de tickets de cada equipe. Abaixo verão os exemplos de macros de texto existentes: TCRM SFA - Atendimento | Geral::Trâmite para Integração TCRM SFA - Atendimento | Geral::Trâmite para BI TCRM SFA - Atendimento | Geral::Trâmite para Infra TCRM SFA - Atendimento | Geral::Trâmite para B2B TCRM SFA - Atendimento | Geral::Trâmite para Aplicação Standard TCRM SFA - Atendimento | Geral::Trâmite para Aplicação Customizada TCRM SFA - Atendimento | JBS::Trâmite para Integração TCRM SFA - Atendimento | JBS::Trâmite para BI TCRM SFA - Atendimento | JBS::Trâmite para Infra TCRM SFA - Atendimento | JBS::Trâmite para B2B TCRM SFA - Atendimento | JBS::Trâmite para Aplicação Standard TCRM SFA - Atendimento | JBS::Trâmite para Aplicação Customizada TCRM SFA - Aplicação Customizada::Script de serviços - Customização TCRM SFA - Aplicação Customizada::Trâmite pra Dev TCRM SFA - Aplicação Customizada::Trâmite para Integração TCRM SFA - Aplicação Customizada::Trâmite para Infra TCRM SFA - Aplicação Customizada::Trâmite para BI TCRM SFA - Aplicação Customizada::Trâmite para a equipe de versão TCRM SFA - Aplicação Customizada::Trâmite para Atendimento TCRM SFA - Aplicação Customizada::Trâmite para B2B TCRM SFA - Aplicação Standard::Script de serviços - Customização TCRM SFA - Aplicação Standard::Trâmite pra Dev TCRM SFA - Aplicação Standard::Trâmite para Integração TCRM SFA - Aplicação Standard::Trâmite para Infra TCRM SFA - Aplicação Standard::Trâmite para BI TCRM SFA - Aplicação Standard::Trâmite para a equipe de versão TCRM SFA - Aplicação Standard::Trâmite para B2B TCRM SFA - B2B::Trâmite pra Dev TCRM SFA - B2B::Trâmite para Integração TCRM SFA - B2B::Trâmite para Infra TCRM SFA - Infra | BD | Sync::Trâmite para Aplicação Customizada TCRM SFA - Infra | BD | Sync::Trâmite para Aplicação Standard TCRM SFA - Infra | BD | Sync::Trâmite para Atendimento TCRM SFA - Infra | BD | Sync::Trâmite para BI TCRM SFA - Infra | BD | Sync::Trâmite para Integração TCRM SFA - Infra | BD | Sync::Trâmite para Dev TCRM SFA - Qi.on Coletor::Trâmite para Dev TCRM SFA - Qi.on Coletor::Trâmite para Aplicação Customizada TCRM SFA - Qi.on Coletor::Trâmite para Aplicação Standard;
1.4 - Projetos Jira. Ao iniciar a criação de uma Issue na ferramenta Jira existente no Zendesk, a primeira informação solicitada é o projeto para o qual esta Issue se destina. Veja abaixo a lista de projetos no Jira por equipes: Time de Desenvolvimento (problema na aplicação com fonte customizada): TOTVS CRM SFA - Sustentação Aplicação Time P&D (problema no produto/integração padrão): TOTVS CRM SFA - P&D Time de Versão: TOTVS CRM SFA - Sustentação Aplicação Time de Integração: TOTVS CRM SFA - Sustentação Integração Time de BI: TOTVS CRM SFA - Sustentação Integração Time de Produto (serviços de customização): TOTVS CRM SFA - Evolução
1.5 - Tabela de relação entre macro de processo x tipo de Issue. 
Observação: As macros de texto listadas no item 1.3 deste artigo, que não estão listadas nesta tabela, ainda são de uso obrigatório. Sua aplicação está relacionada à equipe para onde o Ticket/Issue se destina e não necessariamente ao tipo de Issue a ser criado.
Processo de criação. 1.5 - Etapas do processo de criação de Issue. O fluxo do suporte do SFA foi mapeado para que todas as situações de envio de tickets e criação de Issues estejam previstas. Cada equipe possui seu fluxo e macros de texto próprias de acordo com sua necessidade. Situações de exceção devem ser tratadas individualmente. Uma vez identificada a necessidade de criação de uma issue, seu processo de criação se dá na seguinte ordem: - Aplicação de macro de processo (uma vez aplicada, podemos apagar seu texto no corpo da observação privada gerada no ticket, para que possamos prosseguir com o passo 2).
- Aplicação da macro de texto.
- Preenchimento dos campos da macro de texto.
- Salvar o ticket em espera.
- Clicar no botão "Criar Issue", na ferramenta do Jira existente no Zendesk.
- Selecionar o projeto para onde o Issue se destina.
- Nos campos de preenchimento, colocar no campo Issue type o tipo de Issue a ser criado; no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Clicar no botão "Copiar campos do ticket"; o campo "Assignee" deverá sempre estar em branco.
- Clicar no botão "Criar Issue".
Obvervações: Para Issues do tipo Epic, será exibido um campo chamado "Epic Name", neste campo, poderá ser adicionado no número do ticket no Zendesk. Caso a demanda se trate de um Issue de Manutenção enviado a uma das filas do time de Produto (P&D, Sustentação Aplicação e Sustentação Integração), o cliente deverá ser notifcado, utilizando a macro: Notificação cliente - Envio para o time de produto.
1.6 - Criação de Issues por equipes. Descrito abaixo, poderão ver as etapas do processo de criação de Issue, de acordo com a equipe no Jira para onde se destina:
Time P&D (problema no produto/integração padrão): Aplicar macro "Notificação cliente - Envio para o time de produto" e salvar o ticket em aberto. Aplicar macro "O3 | Transferência Manutenção" (apague o texto inserido pela macro para aplicar a próxima macro); Aplicar macro "Trâmite pra P&D"; Preencher os campos da macro de texto aplicada; Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto TOTVS CRM SFA - P&D; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo "Assignee" deve ficar em branco; Campo "Issue type", deverá ser Manutenção; Clicar no botão "Copiar campos do ticket" e criar o Issue.
Time de Desenvolvimento (Dev, sustentação, problema): Aplicar macro "Notificação cliente - Envio para o time de produto" e salvar o ticket em aberto. Aplicar macro "O3 | Transferência Manutenção" (apague o texto inserido pela macro para aplicar a próxima macro); Aplicar macro "Trâmite pra Dev"; Preencher os campos da macro de texto aplicada; Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto TOTVS CRM SFA - Sustentação Aplicação; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Manutenção; Clicar no botão "Copiar campos do ticket" e criar o Issue.
Time de Versão: Aplicar macro "Notificação cliente - Envio para o time de produto" e salvar o ticket em aberto. Aplicar macro "O3 | Transferência Manutenção" (apague o texto inserido pela macro para aplicar a próxima macro); Aplicar macro "Trâmite para a equipe de versão"; Preencher os campos da macro de texto aplicada; Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto TOTVS CRM SFA - Sustentação Aplicação; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Manutenção; Clicar no botão "Copiar campos do ticket" e criar o Issue.
Time de Integração: Aplicar macro "Notificação cliente - Envio para o time de produto e salvar o ticket em aberto". Aplicar macro "O3 | Transferência Manutenção" (apague o texto inserido pela macro para aplicar a próxima macro); Aplicar macro "Trâmite para Integração"; Preencher os campos da macro de texto aplicada; Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto TOTVS CRM SFA - Sustentação Integração; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Manutenção; Clicar no botão "Copiar campos do ticket" e criar o Issue.
Time de BI: Aplicar macro "Notificação cliente - Envio para o time de produto" e salvar o ticket em aberto. Aplicar macro "O3 | Transferência Manutenção" (apague o texto inserido pela macro para aplicar a próxima macro); Aplicar macro "Trâmite para BI"; Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto TOTVS CRM SFA - Sustentação Integração; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Manutenção; Clicar no botão "Copiar campos do ticket" e criar o Issue.
Time de Serviços (serviços de customização): Aplicar macro "Proposta Aprovada" (apague o texto inserido pela macro para aplicar a próxima macro); Aplicar macro "Script de serviços - Customização"; Preencher os campos da macro de texto aplicada; Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto TOTVS CRM SFA - Evolução; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Epic; Será exibido o campo Epic Name, de preenchimento obrigatório, adicione o número do ticket Zendesk; Clicar no botão "Copiar campos do ticket" e criar o Issue.
Importante: Antes de criar Issue para o time de Evolução, é necessário se assegurar de que este é o processo correto a ser seguido.
1.7 - Tipos de Issue adicionais. Existem ainda 3 tipos adicionais de Issues (conforme descrito no item 1.1), a lógica de criação segue o mesmo padrão, segue abaixo o processo de aplicação de cada uma delas:
Apoio: Aplicar macro "Apoio Manutenção" (preencha as informações corretamente para que, a equipe que irá receber o caso, possa identificar com facilidade de que se trata de um pedido de apoio); Aplicar macro de texto para a equipe de destino; Preencher os campos da macro de texto aplicada (a equipe ainda precisará ter detalhes sobre o caso para entender a situação e fornecer a ajuda necessária); Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto de destino no Jira; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Apoio; Clicar no botão "Copiar campos do ticket" e criar o Issue. Para mais detalhes, leia o artigo EC - ZEN - Aplicação de Macro Apoio Manutenção. Observação: O Issue do tipo Apoio só deve ser criado em casos específicos e após ter sido solicitado apoio do Maestro, em caso de dúvidas, contate o seu Líder.
Apoio - Cliente: Aplicar macro "O3 |Transferência Manutenção" (preencha as informações corretamente para que, a equipe que irá receber o caso, possa identificar com facilidade de que se trata de um pedido de apoio); Aplicar macro de texto para a equipe de destino; Preencher os campos da macro de texto aplicada (a equipe ainda precisará ter detalhes sobre o caso para entender a situação e fornecer a ajuda necessária); Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto de destino no Jira; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Apoio - Cliente; Clicar no botão "Copiar campos do ticket" e criar o Issue. Observação: O Issue do tipo Apoio - Cliente só deve ser criado em casos específicos e após ter sido solicitado apoio do Maestro, em caso de dúvidas, contate o seu Líder.
Rejeição Manutenção: Aplicar macro "O3 | Transferência Manutenção" (preencha as informações corretamente para que, a equipe que irá receber o caso, possa identificar a razão da reabertura do ticket); Aplicar macro de texto para a equipe de destino; Preencher os campos da macro de texto aplicada (a equipe ainda precisará ter detalhes sobre o caso para entender a razão da reabertura); Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto de destino no Jira; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Manutenção; Clicar no botão "Copiar campos do ticket" e criar o Issue. Para mais detalhes, leia o artigo EC - ZEN - Como gerar uma issue de Rejeição Manutenção.
Issue Associado (Sub-tarefa): Aplicar macro "O3 | Transferência Manutenção" - Associação (apague o texto inserido pela macro para aplicar a próxima macro); Associar o número do ticket de problema à ente novo incidente; Aplicar macro de texto para a equipe de destino; Preencher os campos da macro de texto aplicada; Salvar o ticket em espera; Clicar no botão "Criar Issue" e selecionar o projeto de destino no Jira; Adicionar no campo "Reporter", o nome do respectivo líder de equipe (ou do Maestro, caso o mesmo tenha validado o envio do Issue); Campo Assignee deve ficar em branco; Campo Issue type, deverá ser Associado (sub tarefa); Campo Parent, deve ser adicionado o número do Issue de Manutenção já existente no Jira ao qual o caso está relacionado; Clicar no botão "Copiar campos do ticket" e criar o Issue. Para mais detalhes, leia o artigo EC - ZEN - Aplicação de Macro para Manutenção Associação.
Boas práticas - Protheus |