Holarch

Requisitos

Mapa do programa

Veja como seus projetos se vinculam entre si, com contagens de vínculos por par de projetos, e siga a cadeia de vínculos de um item por outros projetos.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. O que o mapa mostra
    2. Quem vê o quê
    3. Cores
  3. Como usá-lo
    1. Ver como os seus projetos se vinculam
    2. Começar por um projeto
    3. Rastrear um item pelo programa
    4. Exemplo prático: a demonstração CubeSat EO-1 e um projeto de carga útil
    5. Exemplo prático: o Hybrid Car e o seu conjunto de baterias
    6. Dicas e boas práticas
    7. Erros comuns
    8. Como se conecta a outros recursos
  4. A página Mapa do programa
    1. Barra
    2. Grafo
    3. Tabela
    4. Inspetor
  5. API e MCP
  6. Mensagens
  7. Limites
  8. Relacionado

Visão geral

Um programa que abrange vários projetos (um projeto do sistema, projetos de subsistemas, um projeto de testes, bibliotecas) é amarrado por vínculos com outros projetos. Cada vínculo fica guardado no projeto que o cria, então nenhum projeto sozinho mostra o quadro completo. O Mapa do programa mostra: ele desenha uma caixa por projeto que você pode abrir e uma seta por par de projetos, rotulada com a relação e o número de vínculos.

A página tem duas visões:

  • Projetos: todos os projetos que você pode abrir e os vínculos entre eles, como grafo ou tabela.
  • Rastreamento do item: um item no meio e os itens vinculados a ele em outros projetos, anel por anel, até seis etapas de distância.

O Mapa do programa está aberto a todos que entraram na conta. Os vínculos em si são criados no plano Team; os vínculos guardados em um projeto cujo plano do proprietário não os inclui são desenhados em cinza. Os vínculos entre os projetos de demonstração Hybrid Car e Hybrid Car Battery Pack funcionam em todos os planos.

Conceitos

O que o mapa mostra

ElementoSignificado
CaixaUm projeto que você pode abrir: o nome, o tipo de projeto e o número de itens; o nome acessível acrescenta os vínculos que ele contém e recebe
SetaVínculos guardados no projeto da cauda que apontam para itens do projeto da ponta
Rótulo da setarelação · vínculos · excluídos, por exemplo traced from · 12 · 1 excluído
Projetos que você não pode abrir (N vínculos)Uma caixa tracejada que conta todos os vínculos para um projeto que você não pode abrir
Caixa de liberação de bibliotecaUma liberação de biblioteca que você pode ler, vinculada a partir dos seus projetos

As setas geralmente apontam para cima: os projetos de subsistemas guardam vínculos traced from e satisfies com o projeto do sistema, e os projetos de testes guardam vínculos verifies. O mapa coloca os projetos que contêm vínculos abaixo dos projetos para os quais apontam.

Quem vê o quê

O mapa é montado apenas a partir dos projetos que você pode abrir: um projeto do qual você é membro com qualquer função, que não está na Lixeira e cuja regra de autenticação em duas etapas da organização você cumpre.

  • Um vínculo para um projeto que você não pode abrir é contado em Projetos que você não pode abrir (N vínculos). Essa caixa nunca nomeia o projeto nem o item, e tem a mesma aparência se o projeto existe, está na Lixeira ou nunca existiu.
  • Os vínculos guardados em um projeto que você não pode abrir não são contados em lugar nenhum, mesmo quando apontam para os seus projetos.
  • Ser administrador da organização não acrescenta nada: o mapa usa a participação nos projetos.
  • As exportações (CSV, SVG, PNG) contêm exatamente o que a página mostra.

Cores

CorSignificado
Seta azulVínculos entre projetos que você pode abrir
Seta âmbarAlguns dos destinos foram excluídos (na Lixeira ou sumidos)
Seta cinzaVínculos para projetos que você não pode abrir, para uma liberação de biblioteca, ou guardados em um projeto cujo plano do proprietário não inclui vínculos com outros projetos

Como usá-lo

  1. Clique em Gerenciar projetos e depois em Mapa do programa. A visão Projetos abre com todos os projetos que contêm ou recebem vínculos.
  2. Leia as setas. Aponte para uma caixa para esmaecer tudo o que não está conectado a ela.
  3. Clique em uma seta. O inspetor lista os vínculos dela, 100 de cada vez: o item que contém cada vínculo, a relação e o item de destino. Clique em qualquer um dos itens para abri-lo no projeto dele, ou em Mostrar mais para os próximos 100.
  4. Clique em Exportar CSV no inspetor para salvar os vínculos dessa seta, ou em Exportar ▾ na barra para salvar o mapa inteiro como CSV, SVG ou PNG.

Começar por um projeto

  1. Abra o projeto, depois Verificação → Cobertura do programa, e clique em Abrir Mapa do programa.
  2. O mapa mostra apenas esse projeto e os projetos vinculados a ele, diretamente ou por meio de outros.
  3. Clique em Mostrar todos os projetos para ver tudo o que você pode abrir.

Você também pode clicar em uma caixa e escolher Mostrar só projetos vinculados.

Rastrear um item pelo programa

  1. Selecione o item. Na seção Rastreabilidade do inspetor, abra Outros projetos ⋯ e escolha Mostrar no Mapa do programa. Na lista de vínculos de uma seta, clique em Rastrear este item.
  2. A visão Rastreamento do item mostra o item no meio e os itens vinculados a ele em anéis: o primeiro anel a uma etapa de distância, o segundo a duas. Os vínculos são seguidos nas duas direções.
  3. Escolha Etapas (1 a 6, padrão 3) para ir mais longe ou ficar mais perto.
  4. Os itens são coloridos por projeto, com uma caixa tracejada em torno dos itens de cada projeto. Desmarque Agrupar por projeto para remover as caixas.
  5. Clique em um item para ver Abrir item e Rastrear a partir daqui, que o coloca no meio.

Exemplo prático: a demonstração CubeSat EO-1 e um projeto de carga útil

  1. Crie a demonstração CubeSat EO-1 e depois um segundo projeto EO-1 Payload com o requisito PL.1 Imager resolution.
  2. Em EO-1 Payload, selecione PL.1. Em Rastreabilidade → Outros projetos, clique em +, escolha traced from, o projeto CubeSat e o requisito de imageamento dele, e clique em Adicionar vínculo.
  3. Crie um terceiro projeto EO-1 Test Campaign com o caso de teste TC.4 Resolution test, e vincule-o com verifies a PL.1 em EO-1 Payload.
  4. Abra Gerenciar projetos → Mapa do programa. O mapa mostra EO-1 Test Campaign embaixo, EO-1 Payload acima dele e o projeto CubeSat no topo, com as setas verifies · 1 e traced from · 1.
  5. Clique em PL.1 → Rastreabilidade ⋯ → Mostrar no Mapa do programa: o caso de teste e o requisito do CubeSat ficam a uma etapa de distância, um de cada lado.

Exemplo prático: o Hybrid Car e o seu conjunto de baterias

  1. Em Gerenciar projetos, clique em Arquivos do projeto ▾ → Novo projeto de demonstração → Hybrid Car (SysML v2).
  2. Depois crie Arquivos do projeto ▾ → Novo projeto de demonstração → Hybrid Car Battery Pack (SysML v2). Os requisitos do conjunto de baterias do fornecedor, PackCapacity, PackMass e ChargeAcceptance, estão vinculados com traced from aos requisitos do carro VR-3, VR-6 e VR-5 na sua demonstração Hybrid Car mais recente, independentemente de qual das duas você criar primeiro; criar a demonstração Hybrid Car de novo move os vínculos para a nova. Esses vínculos de demonstração funcionam em todos os planos. Sem um projeto Hybrid Car, a demonstração do conjunto de baterias não tem vínculos.
  3. Abra Gerenciar projetos → Mapa do programa. O mapa mostra os dois projetos SysML v2 com a seta traced from · 3.

Dicas e boas práticas

  • Combine as relações que os subprojetos usam (traced from ou satisfies para requisitos, verifies para testes) para que as setas se leiam da mesma forma em todo lugar.
  • Desative Agrupar relações para ver uma seta por relação, por exemplo para distinguir os vínculos de requisitos dos vínculos de testes entre os mesmos dois projetos.
  • Arraste as caixas para organizar o mapa. As posições ficam guardadas neste navegador para cada escopo.
  • Use a visão Tabela para ordenar os pares de projetos por número de vínculos ou de destinos excluídos.
  • Uma seta âmbar indica vínculos que precisam de reparo: abra a lista de vínculos dela e depois corrija ou remova os vínculos em Rastreabilidade → Outros projetos do item.

Erros comuns

ProblemaCausaCorreção
Um projeto está faltandoVocê não é membro dele, ele está na Lixeira ou não tem vínculosPeça acesso ao proprietário; marque Mostrar projetos sem vínculos para listar os projetos sem vínculos
Tudo vai para Projetos que você não pode abrirOs vínculos apontam para projetos dos quais você não é membroPeça acesso ao proprietário do projeto
Setas cinza no meio do mapaO projeto que contém os vínculos tem um proprietário sem o plano TeamO proprietário faz o upgrade em Ajustes da conta → Plano e cobrança
Um novo vínculo ainda não apareceO mapa ainda está lendo as alterações recentesClique em Atualizar após um minuto

Como se conecta a outros recursos

  • Vínculos com outros projetos: o mapa os lê; não adiciona nem altera nada. Crie vínculos em Rastreabilidade → Outros projetos de um item (veja Vínculos com outros projetos).
  • Cobertura do programa: a visão por item dos vínculos para um projeto, com as lacunas (veja Cobertura do programa). Abrir Mapa do programa ali inicia o mapa a partir desse projeto.
  • Bibliotecas: os vínculos com um item de uma liberação de biblioteca aparecem como setas para a caixa da liberação (veja Bibliotecas).
  • Diagrama Spider: o rastreamento dentro de um projeto, com caixas tracejadas para itens vinculados em outros lugares. O Rastreamento do item usa o mesmo layout em anéis.
  • API e MCP: o mesmo mapa e o mesmo rastreamento para ferramentas (veja API e MCP).

A página Mapa do programa

Barra

ControleO que ele faz
Projetos / Rastreamento do itemAlterna a visão
EscopoTodos os meus projetos, uma organização (quando você pertence a uma) ou uma pasta com as subpastas dela (quando você tem pastas; veja Pastas de projetos)
Mostrar todos os projetosMostrado depois de abrir o mapa a partir de um projeto; sai do conjunto vinculado desse projeto
Mostrar projetos sem vínculosMostra também os projetos sem vínculos
Agrupar relaçõesUma seta por par de projetos (os rótulos listam cada relação), ou uma seta por relação
EtapasRastreamento do item: de 1 a 6 etapas de distância
Agrupar por projetoRastreamento do item: caixas tracejadas em torno dos itens de cada projeto
Grafo / TabelaO diagrama ou uma tabela ordenável; em uma tela estreita, a tabela abre primeiro
AtualizarLê os vínculos de novo
Exportar ▾Exportar CSV, Exportar SVG, Exportar PNG

Grafo

  • Clique em uma caixa para mostrar o projeto dela no inspetor: Abrir projeto e Mostrar só projetos vinculados. Clique duas vezes em uma caixa, ou pressione Shift+Enter nela, para abrir o projeto.
  • Clique em uma seta para listar os vínculos dela no inspetor.
  • Arraste as caixas para movê-las; role ou faça o gesto de pinça para dar zoom; arraste o fundo para deslocar.
  • Pressione Tab para chegar ao mapa e depois as teclas de seta para mover entre caixas e setas; Enter vai para o inspetor. Cada caixa e cada seta têm um nome que um leitor de tela lê, como "EO-1 Payload, projeto LML, 1 vínculo de saída, 1 de entrada".

Tabela

VisãoColunas
ProjetosProjeto de origem, Relação, Projeto de destino, Vínculos, Excluído
Rastreamento do itemProjeto, Número, Nome, Classe, Etapas a partir do item, Estado

Clique no título de uma coluna para ordenar.

Inspetor

SeleçãoConteúdo
Caixa do projetoNome, tipo, número de itens, vínculos de saída e de entrada; Abrir projeto, Mostrar só projetos vinculados
SetaProjeto de origem e de destino, vínculos por relação, a lista de vínculos (100 de cada vez, Mostrar mais), Exportar CSV, Rastrear este item por linha
Item (Rastreamento do item)Número e nome, classe, projeto, etapas a partir do item rastreado, estado; Abrir item, Rastrear a partir daqui
Projetos que você não pode abrir"Vínculos para projetos que você não pode abrir. Peça acesso ao proprietário do projeto."

API e MCP

A API REST e o MCP dão as mesmas respostas com o próprio acesso e a lista de projetos do token. Os projetos de uma organização que desativou o acesso à API ficam de fora, como os projetos que você não pode abrir.

ChamadaRetorna
GET /api/v1/program-mapProjetos, liberações, setas (from, to, relation, links, deleted, plan) e a contagem oculta; from, unlinked, org como na página
GET /api/v1/projects/<project>/items/<item>/traceO Rastreamento do item: nós com projeto, número, nome, classe e etapas, os vínculos entre eles e a contagem oculta; steps 1–6 (padrão 3)
MCP program_mapO mesmo que GET /program-map
MCP trace_chainO mesmo que a chamada de rastreamento; os itens em projetos com marcações de dados regulados respondem withheld

Veja API e MCP.

Mensagens

MensagemSignificado
Nenhum vínculo entre os seus projetos. Adicione um na seção Rastreabilidade de um item.Nenhum dos seus projetos contém ou recebe um vínculo que você possa ver
Este projeto não tem vínculos com outros projetos. Adicione um na seção Rastreabilidade de um item.O mapa foi aberto a partir de um projeto sem vínculos
Este item não tem vínculos com outros projetos. Adicione um na seção Rastreabilidade dele.O item rastreado não tem vínculos
Alguns projetos ainda estão sendo lidos. Atualize em um minuto.As alterações recentes em projetos grandes ainda estão sendo lidas; o mapa mostra o que está pronto
Mostrando os primeiros 500 itens. Reduza as etapas.O Rastreamento do item atingiu o limite
N vínculos de projetos cujo plano do proprietário não inclui vínculos com outros projetos não são seguidos.O Rastreamento do item ignorou vínculos guardados sob um plano que não os inclui
Não foi possível ler o mapa do programa. Recarregue a página.A solicitação falhou

Limites

LimiteValor
Etapas do Rastreamento do item1 a 6
Itens em um Rastreamento do item500
Vínculos listados por página na lista de uma seta100
Vínculos por projeto20.000 (veja Vínculos com outros projetos)