Ir para o conteúdo

Aplicativo Jitterbit Jira Tracker

Visão geral

O 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 conforme ele avança pela entrega. Os painéis com abas oferecem a cada disciplina uma visualizaçã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 é possível configurá-lo e estendê-lo para se adequar ao seu processo.

Esta página descreve como o aplicativo funciona, seus recursos principais e modelo de dados, e aborda os pré-requisitos, como baixar e instalar, como configurá-lo para seu ambiente, como o acesso é controlado e as etapas de resolução de problemas comuns.

Como funciona

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

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% 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 no escopo, e o Plano de Registro (POR) é o que a Engenharia se compromete a entregar. O Valor Contratual Anual (ACV) é capturado no ticket para rastrear o impacto fiscal.

Recursos principais

Ao instalar e configurar o Jira Tracker, ele oferece os seguintes recursos:

  • Recebimento e escopo de tickets: O Gerenciamento de Produto captura tickets com um produto, cliente, Valor Contratual Anual (ACV), pilar e trimestre.

  • Rastreamento multifuncional: UX, Engenharia e Documentação Técnica rastreiam seu próprio status em um ticket. A Engenharia mapeia tickets para sprints e para o Plano de Registro.

  • Painéis de análise com abas: Quatro abas (Requisito, Design UX, Documentação e Engenharia) mapeiam contagens de tickets por status do fluxo de trabalho para cada produto. Os gráficos respondem ao filtro de trimestre ativo e suportam navegação detalhada para a lista de tickets subjacente.

  • Personalização do espaço de trabalho: O perfil de cada usuário armazena padrões do espaço de trabalho, como um produto e trimestre preferidos, para que novos tickets e visualizações sejam pré-preenchidos adequadamente.

  • Comentários: Cada ticket mantém um registro de comentários cronológico para um histórico auditável.

  • Ferramentas de grade: As visualizações de tickets incluem busca global, filtragem de colunas e exportação para 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 por sua Opção de Instalação, que controla como seus dados são tratados quando o aplicativo é instalado em um novo ambiente: dados Developer e Shared (como pesquisas) são propagados na instalação, e dados User (como tickets) são deixados para cada ambiente preencher.

Tabela Tipo de uso Objetivo
Ticket User Itens de trabalho principais; vincula cada ticket ao seu produto, lançamento, membros da equipe e status por disciplina.
Comment User Comentários cronológicos em um ticket.
User User Perfis de usuário internos, mapeamento de departamento e padrões do espaço de trabalho.
Session User Estado de execução por usuário e filtros ativos.
Status Shared Estados do fluxo de trabalho (por exemplo, In Progress, Complete), com configurações de cor e classificação.
StatusType Shared Agrupa status para que cada disciplina gerencie seu próprio conjunto de estados.
Outlook Shared Indicadores de saúde (por exemplo, On Track, At Risk) com codificação de cores.
Sprint Shared Iterações de engenharia com prazo determinado que os tickets são mapeados para.
Product Shared Lista mestre de produtos ou módulos usados para segmentar tickets e relatórios.
Pillar Shared Temas estratégicos aos quais o trabalho se alinha.
Quarter Shared Trimestres fiscais ou de calendário usados para planejamento e filtragem de roadmap.
Release Shared Versões de lançamento programadas e marcos.
Department Shared Unidades organizacionais mapeadas para usuários.
Parameter Shared Configurações globais e padrões.

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

Lógica de negócios

Os valores de status e os caminhos de fluxo de trabalho são impulsionados pelas tabelas de pesquisa (Status, StatusType, Outlook) e pela configuração em vez de texto codificado, permitindo ajustar estados sem alterar a lógica do aplicativo. As 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é-popula valores como o produto e o trimestre dos padrões do workspace 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 permite o download do Marketplace; se sua organização não for licenciada para App Builder, a ação Download app será 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 compilado. 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 suporte Jitterbit para solicitar um pacote correspondente.

  • Um banco de dados PostgreSQL para sua instância do App Builder.

O aplicativo é autossuficiente e não requer conexão com nenhum sistema externo.

Download e instalação

Baixe o aplicativo do Marketplace

  1. Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.

  2. Localize o aplicativo chamado Jira Tracker. Você pode usar a barra de pesquisa ou, no painel Filters, em Type, selecione App para mostrar apenas aplicativos.

  3. Clique no card do aplicativo para abrir o painel Details. Revise os Requirements do aplicativo (a versão do App Builder e o banco de dados necessários).

  4. Clique no link Go to documentation do aplicativo para abrir esta documentação em uma aba separada e mantenha-a aberta como referência.

  5. Faça um dos seguintes, dependendo se sua organização está licenciada para App Builder:

    • Download app: Se sua organização está licenciada para App Builder, clique em Download app, no card do aplicativo ou no painel Details. Seu navegador salva o arquivo .LP no local de download e uma notificação App Builder file downloaded successfully confirma o download.

    • Get app: Se sua organização não está licenciada para App Builder, a ação é rotulada como Get app. O painel Details exibe uma mensagem informando que uma licença do App Builder é necessária, com um botão Submit. Clique em Submit para enviar uma solicitação para um representante entrar em contato com você sobre App Builder; uma notificação Message successfully sent confirma isso.

Instale o aplicativo no App Builder

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

  1. Faça login no App Builder e acesse o IDE.

  2. Em Deploy, clique em Install Release.

  3. Clique em + Package, depois em Browse e selecione o arquivo .LP que você baixou.

  4. Clique em Save. O painel Release exibe as informações do pacote e, em seguida, a caixa de diálogo Package é fechada.

  5. Confirme se os detalhes estão corretos e clique em Install.

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

Modificando o aplicativo em um ambiente de desenvolvimento

A fonte de dados do aplicativo instala selada. Se você implantar o aplicativo em um ambiente de desenvolvimento e pretender modificá-lo, desselar a fonte de dados para poder editar os objetos do aplicativo. Deixe-a selada em QA e produção para preservar a equivalência entre ambientes. Veja Selar ou desselar uma fonte de dados.

Configuração e configuração

Após instalar o aplicativo em um novo ambiente, conclua as seguintes etapas para deixá-lo pronto para uso:

  1. Configure o realm do grupo de usuários. A versão não inclui o realm que provisiona seus grupos de usuários, portanto crie-o antes de atribuir usuários. No IDE, acesse User Management > Realms e clique em + Realm. No painel Applications, clique em Select para Jira Tracker; no painel Groups, clique em Select para Jira Tracker Administrator e Jira Tracker User. Consulte Realms para o procedimento completo, incluindo nomeação do realm e delegação de um provedor de segurança.

  2. Adicione usuários e defina seus padrões de workspace. Na página Users, adicione cada usuário e defina seus padrões de workspace (como um produto e trimestre preferido) para que novos tickets e visualizações sejam pré-preenchidos. Para conceder acesso, atribua o usuário a um grupo na guia User Group da página User, como Jira Tracker Administrator ou Jira Tracker User. Consulte Security and access.

  3. Preencha as tabelas de pesquisa. O aplicativo é fornecido com dados de pesquisa de exemplo. Substitua pelos valores da sua organização para Product, Pillar, Quarter, Release, Sprint, Department e Status.

Security and access

O Jira Tracker usa segurança baseada em função do App Builder com dois grupos de acesso: Jira Tracker Administrator e Jira Tracker User. Você atribui usuários a esses grupos na guia User Group da página User, o que provisiona a associação por meio de um realm do App Builder que você cria durante a configuração. O acesso a cada área é o seguinte:

Área Jira Tracker Administrator Jira Tracker User
Criação e edição de tickets Acesso total Criar e atualizar (sem exclusão)
Dashboards de fluxo de trabalho Acesso total Visualizar e alterar filtros
Configurações de perfil de usuário e filtro Acesso total Acesso total ao seu próprio registro
Tabelas administrativas e de pesquisa Acesso total Sem acesso (menus ocultos)

Os dashboards mostram todos os tickets; os usuários restringem o que veem com os filtros de workspace e dashboard em vez de restrições por linha. O histórico de tickets é preservado por meio do log Comment.

Solução de problemas

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

  • Sintoma: Uma aba do dashboard mostra menos tickets do que o esperado, ou nenhum.

  • Possível causa: Os dashboards respondem aos filtros ativos de trimestre e workspace. Um filtro pode estar excluindo os tickets que você esperava.

  • Resolução: Ajuste ou limpe os filtros de trimestre e dashboard.

Um novo ticket é pré-preenchido com o produto ou trimestre incorreto

  • Sintoma: Quando um usuário cria um ticket, o produto ou trimestre é pré-preenchido com um valor que ele não escolheu.

  • Possível causa: Novos tickets herdam os padrões de workspace definidos no perfil do usuário.

  • Resolução: Atualize os padrões de workspace no perfil do usuário ou altere os valores diretamente no ticket.

Para mais ajuda, consulte seus logs do App Builder e entre em contato com o suporte do Jitterbit.