Jitterbit Jira Tracker App

Visão Geral

A Jitterbit fornece o aplicativo Jira Tracker através do Jitterbit Marketplace. Construído com o Jitterbit App Builder, é um aplicativo de rastreamento do ciclo de vida do produto para equipes multifuncionais. O Gerenciamento de Produto captura e define o escopo dos tickets recebidos, e UX, Engenharia e Documentação Técnica rastreiam sua parte do trabalho à medida que avança na entrega. Painéis com abas oferecem a cada disciplina uma visão do status dos tickets por produto e trimestre.

Você baixa o aplicativo como um pacote de lançamento do App Builder (um arquivo .LP) do Marketplace e o instala em sua própria instância do App Builder, onde pode configurá-lo e estendê-lo para se adequar ao seu processo.

Esta página descreve como o aplicativo funciona, suas principais características e modelo de dados, e aborda os pré-requisitos, como baixá-lo e instalá-lo, como configurá-lo para seu ambiente, como o acesso é controlado e etapas comuns de solução de problemas.

Como funciona

O Gerenciamento de Produto insere e define o escopo de um ticket, formando um Plano de Intenção (POI). As outras disciplinas então rastreiam seu trabalho em relação a esse ticket, e as mudanças de status são consolidadas nos painéis:

flowchart TD A["Product Management
creates a ticket"] --> B["Scope: product, customer,
ACV, pillar, and quarter"] B --> C["UX tracks design
requirements and readiness"] B --> D["Engineering maps to sprints
and the Plan of Record"] B --> E["Documentation tracks
content and release notes"] C --> F["Status updates
by discipline"] D --> F E --> F F --> G["Tabbed dashboards:
ticket counts by status,
filtered by quarter"]

Aqui, um Plano de Intenção (POI) é o conjunto inicial de trabalho definido, e o Plano de Registro (POR) é o que a Engenharia se compromete a entregar. O Valor Anual do Contrato (ACV) é capturado no ticket para rastrear o impacto fiscal.

Principais características

Quando você instala e configura o Jira Tracker, ele fornece as seguintes capacidades:

Recepção e definição de escopo de tickets: O Gerenciamento de Produto captura tickets com um produto, cliente, Valor Anual do Contrato (ACV), pilar e trimestre.
Rastreamento multifuncional: UX, Engenharia e Documentação Técnica rastreiam seu próprio status em um ticket. A Engenharia mapeia os tickets para sprints e para o Plano de Registro.
Painéis de análise com abas: Quatro abas (Requisitos, Design de UX, Documentação e Engenharia) mostram a contagem de tickets por status de fluxo de trabalho para cada produto. Os gráficos respondem ao filtro do trimestre ativo e suportam a exploração da lista de tickets subjacente.
Personalização do espaço de trabalho: O perfil de cada usuário armazena as configurações padrão do espaço de trabalho, como um produto e trimestre preferidos, para que novos tickets e visualizações sejam preenchidos automaticamente.
Comentários: Cada ticket mantém um registro cronológico de comentários para um histórico auditável.
Ferramentas de grade: As visualizações de tickets incluem busca global, filtragem de colunas e exportação em CSV.

Modelo de dados

O Jira Tracker armazena todos os seus dados em suas próprias tabelas. Cada tabela tem um tipo de uso de dados, definido pela sua Opção de Instalação, que controla como seus dados são tratados quando o aplicativo é instalado em um novo ambiente: dados Desenvolvedor e Compartilhados (como pesquisas) são preenchidos na instalação, e dados Usuário (como tickets) ficam a cargo de cada ambiente para serem populados.

Tabela	Tipo de uso	Propósito
`Ticket`	Usuário	Itens de trabalho principais; vincula cada ticket ao seu produto, versão, membros da equipe e status por disciplina.
`Comment`	Usuário	Comentários cronológicos em um ticket.
`User`	Usuário	Perfis de usuários internos, mapeamento de departamentos e configurações padrão do espaço de trabalho.
`Session`	Usuário	Estado de execução por usuário e filtros ativos.
`Status`	Compartilhado	Estados de fluxo de trabalho (por exemplo, `Em Progresso`, `Completo`), com configurações de cor e ordenação.
`StatusType`	Compartilhado	Agrupa status para que cada disciplina gerencie seu próprio conjunto de estados.
`Outlook`	Compartilhado	Indicadores de saúde (por exemplo, `No Caminho Certo`, `Em Risco`) com codificação de cores.
`Sprint`	Compartilhado	Iterações de engenharia com tempo definido às quais os tickets estão mapeados.
`Product`	Compartilhado	Lista mestre de produtos ou módulos usados para segmentar tickets e relatórios.
`Pillar`	Compartilhado	Temas estratégicos aos quais o trabalho está alinhado.
`Quarter`	Compartilhado	Trimestres fiscais ou calendáricos usados para planejamento de roadmap e filtragem.
`Release`	Compartilhado	Versões de lançamento programadas e marcos.
`Department`	Compartilhado	Unidades organizacionais mapeadas para usuários.
`Parameter`	Compartilhado	Configurações e padrões globais.

A tabela Ticket está vinculada ao User através de várias chaves específicas de função (ProductManagerID, UXDesignerID e EngineerID). A exclusão de um Ticket cascata para seus registros de Comment, e a exclusão de um StatusType cascata para seus registros de Status.

Lógica de negócios

Os valores de status e os caminhos de fluxo de trabalho são impulsionados pelas tabelas de consulta (Status, StatusType, Outlook) e pela configuração, em vez de texto codificado, permitindo ajustar estados sem alterar a lógica do aplicativo. Validações são aplicadas no nível da tabela para que formulários e grades as herdem. Quando um usuário cria um ticket, o formulário pré-preenche valores como o produto e o trimestre a partir das configurações padrão do espaço de trabalho desse usuário.

Pré-requisitos

Para usar o Jira Tracker, você precisa do seguinte:

Uma licença Jitterbit Harmony com acesso ao App Builder. Isso habilita o download do Marketplace; se sua organização não estiver licenciada para o App Builder, a ação Download app é substituída por uma ação de solicitação Get app (veja Download e instalação).
Uma instância do App Builder executando o App Builder 4.61, a versão para a qual o pacote atual foi construído. Cada pacote instala apenas em sua versão exata do App Builder; se sua instância estiver em uma versão diferente, entre em contato com o suporte Jitterbit para solicitar um pacote correspondente.
Um banco de dados PostgreSQL para sua instância do App Builder.

O aplicativo é autônomo e não requer uma conexão com nenhum sistema externo.

Download e instalação

Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.
Localize o aplicativo chamado Jira Tracker. Você pode usar a barra de pesquisa ou, no painel Filters sob Type, selecionar App para mostrar apenas aplicativos.
Clique no cartão do aplicativo para abrir o painel Details. Revise os Requisitos do aplicativo (a versão do App Builder e o banco de dados que ele precisa).
Clique no link Ir para a documentação do aplicativo para abrir esta documentação em uma aba separada e mantenha-a aberta para referência.
Faça uma das seguintes ações, dependendo se sua organização possui licença para o App Builder:
- Baixar aplicativo: Se sua organização possui licença para o App Builder, clique em Baixar aplicativo, tanto no cartão do aplicativo quanto no painel Detalhes. Seu navegador salva o arquivo .LP em sua localização de downloads, e uma notificação Arquivo do App Builder baixado com sucesso confirma o download.
- Obter aplicativo: Se sua organização não possui licença para o App Builder, a ação é rotulada como Obter aplicativo. O painel Detalhes mostra uma mensagem informando que uma licença do App Builder é necessária, com um botão Enviar. Clique em Enviar para enviar um pedido para que um representante entre em contato com você sobre o App Builder; uma notificação Mensagem enviada com sucesso confirma isso.

Instalar o aplicativo no App Builder

Instale o arquivo .LP baixado em sua instância do App Builder:

Faça login no App Builder e vá para o IDE.
Em Implantar, clique em Instalar Versão.
Clique em + Pacote, depois em Procurar e selecione o arquivo .LP que você baixou.
Clique em Salvar. O painel Versão exibe as informações do pacote, então feche o diálogo Pacote.
Confirme se os detalhes estão corretos e clique em Instalar.

Para visualizar o conteúdo de um pacote antes de instalá-lo, clique no botão Manifesto.

Modificando o aplicativo em um ambiente de desenvolvimento

A fonte de dados do aplicativo é instalada selada. Se você implantar o aplicativo em um ambiente de desenvolvimento e pretender modificá-lo, desele a fonte de dados para que você possa editar os objetos do aplicativo. Mantenha-a selada em QA e produção para preservar a equivalência entre os ambientes. Veja Selar ou deselar uma fonte de dados.

Configuração e instalação

Após instalar o aplicativo em um novo ambiente, complete os seguintes passos para torná-lo pronto para uso:

Configurar o reino de grupos de usuários. A versão não inclui o reino que provisiona seus grupos de usuários, então crie-o antes de atribuir usuários. No IDE, vá para Gerenciamento de Usuários > Reinos e clique em + Reino. No painel Aplicativos, clique em Selecionar para Jira Tracker; no painel Grupos, clique em Selecionar para Administrador do Jira Tracker e Usuário do Jira Tracker. Veja Reinos para o procedimento completo, incluindo a nomeação do reino e a delegação de um provedor de segurança.
Adicionar usuários e definir seus padrões de espaço de trabalho. Na página Usuários, adicione cada usuário e defina seus padrões de espaço de trabalho (como um produto preferido e trimestre) para que novos tickets e visualizações sejam pré-preenchidos. Para conceder acesso, atribua o usuário a um grupo na aba Grupo de Usuários da página Usuário, seja Administrador do Jira Tracker ou Usuário do Jira Tracker. Veja Segurança e acesso.
Preencher as tabelas de consulta. O aplicativo é fornecido com dados de consulta de exemplo. Substitua-os pelos valores da sua organização para Produto, Pilar, Trimestre, Lançamento, Sprint, Departamento e Status.

Segurança e acesso

O Jira Tracker utiliza a segurança baseada em funções do App Builder com dois grupos de acesso, Administrador do Jira Tracker e Usuário do Jira Tracker. Você atribui usuários a esses grupos na aba Grupo de Usuários da página Usuário, que provisiona a associação através de um reino que você cria durante a configuração. O acesso a cada área é o seguinte:

Área	Administrador do Jira Tracker	Usuário do Jira Tracker
Criação e edição de tickets	Acesso total	Criar e atualizar (sem deletar)
Painéis de fluxo de trabalho	Acesso total	Visualizar e alterar filtros
Perfil do usuário e configurações de filtro	Acesso total	Acesso total ao seu próprio registro
Tabelas de consulta e administrativas	Acesso total	Sem acesso (menus ocultos)

Os painéis mostram todos os tickets; os usuários restringem o que veem com os filtros de espaço de trabalho e painel, em vez de por restrições por linha. O histórico de tickets é preservado através do log de Comentário.

Solução de Problemas

Os gráficos do painel não mostram os tickets esperados

Sintoma: Uma aba do painel mostra menos tickets do que o esperado, ou nenhum.
Possível causa: Os painéis respondem aos filtros de trimestre e espaço de trabalho ativos. Um filtro pode estar excluindo os tickets que você espera.
Resolução: Ajuste ou limpe os filtros de trimestre e painel.

Um novo ticket é preenchido automaticamente com o produto ou trimestre errado

Sintoma: Quando um usuário cria um ticket, o produto ou trimestre é preenchido automaticamente com um valor que ele não escolheu.
Possível causa: Novos tickets herdam os padrões de espaço de trabalho definidos no perfil do usuário.
Resolução: Atualize os padrões de espaço de trabalho no perfil do usuário ou altere os valores diretamente no ticket.

Para mais ajuda, revise os logs do seu App Builder e entre em contato com o suporte do Jitterbit.