Holarch

Requisitos

Vínculos com outros projetos

Rastreie um item até um requisito, função ou teste de outro projeto; cada pessoa vê o item vinculado apenas quando pode abrir o projeto dele.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. O que um vínculo contém
    2. Quem vê o quê
    3. Estados do vínculo
    4. Destinos alterados
  3. Como usá-lo
    1. Quando e por quê
    2. Adicionar um vínculo
    3. Abrir o item vinculado
    4. Remover vínculos
    5. Exemplo prático: um subsistema de carga útil e a demonstração CubeSat EO-1
    6. Dicas e boas práticas
    7. Erros comuns
    8. Como se conecta a outros recursos
  4. Exportações e relatórios
  5. API e MCP
  6. Mensagens
  7. Limites
  8. Relacionado

Visão geral

Um vínculo com outro projeto é um relacionamento de rastreamento de um item deste projeto para um item de um projeto diferente, como um requisito de subsistema traced from um requisito da especificação do sistema, ou um procedimento de teste que verifies um requisito mantido por outra equipe.

O vínculo faz parte deste projeto. Ele guarda apenas os ids dos dois itens e a relação. O número, o nome, a classe e o status do item vinculado são lidos do próprio projeto dele cada vez que você olha, com o seu próprio acesso:

  • Quando você pode abrir o outro projeto, vê o item e pode clicar para ir até ele.
  • Quando não pode, vê Item em um projeto que você não pode abrir. O nome nunca chega até você, nem no app, nem nas exportações, nem pela API, nem pelas ferramentas de IA.

Os vínculos com outros projetos fazem parte do plano Team. Quem decide é o plano do proprietário do projeto. Nos outros planos, os vínculos existentes continuam visíveis e podem ser removidos, mas não é possível adicionar novos. Os vínculos entre os projetos de demonstração Hybrid Car e Hybrid Car Battery Pack funcionam em todos os planos.

Conceitos

ParteSignificado
OrigemUm item deste projeto
RelaçãoUma relação do esquema deste projeto, como traced from, satisfies ou verified by
MetaO id de um projeto e o id de um item nele

A relação é checada em relação à classe da origem. A classe do destino não é checada quando o vínculo é criado, porque o vínculo nunca lê o conteúdo do outro projeto. Quando a classe do destino não combina com a relação, a seção Rastreabilidade mostra ⚠ com "Esta relação normalmente não aponta para …".

Quem vê o quê

Cada pessoa vê cada item vinculado com a função que tem no projeto dele:

Seu acesso ao outro projetoO que você vê
Qualquer função (Proprietário, Editor, Revisor, Leitor)Número, nome, projeto e um link que abre o item
Nenhum, ou o projeto não existe maisItem em um projeto que você não pode abrir

Um projeto que não existe e um projeto que você não pode abrir têm a mesma aparência, então um vínculo nunca revela que um projeto existe.

MostradoSignificadoO que fazer
Número e nomeO item existe e você pode abrir o projeto deleNada
Excluído em <projeto>O item está na Lixeira do projeto delePeça a alguém que pode editar esse projeto para restaurá-lo, ou remova o vínculo
ExcluídoO item não existe maisRemover o vínculo (Remover vínculos quebrados)
Item em um projeto que você não pode abrirVocê não tem acesso ao projeto, ou ele não existe maisPeça acesso ao proprietário do projeto, se precisar
Carregando…O item está sendo lidoAguarde um momento

Os nomes são lidos quando uma página mostra o vínculo, de novo quando você volta à aba após um minuto, e a cada cinco minutos. Um item renomeado mostra o novo nome sem nenhuma alteração neste projeto.

Destinos alterados

Uma linha mostra Alterado quando o item vinculado foi editado no projeto dele depois que o vínculo foi criado ou revisado pela última vez. Aponte para ela para ver a data. Confira se o vínculo continua válido e então:

  • Clique em ✓ na linha para marcar esse vínculo como revisado.
  • Clique em ⋯ ao lado de Outros projetos e depois em Marcar todos como revisados (n), para todos os vínculos sinalizados do item.
  • Ou abra Necessidades e requisitos → Vínculos a revisar: o cartão Alterado em outros projetos lista todos os vínculos sinalizados do projeto, com ✓ por linha e Marcar todos como revisados.

Marcar como revisado aparece no histórico do item e em Atividade, e um único Desfazer reverte isso. Revisores e leitores veem os sinalizadores, mas não podem limpá-los. Os vínculos com liberações de biblioteca não são sinalizados (uma liberação não muda).

Como usá-lo

Quando e por quê

Use vínculos com outros projetos quando um único modelo ficaria grande demais ou pertence a equipes diferentes: uma especificação do sistema e as especificações dos subsistemas, os requisitos compartilhados de uma linha de produtos e cada produto, ou os requisitos de um cliente e o seu projeto. Mantenha os vínculos no projeto de nível inferior, apontando para cima: cada subsistema rastreia os seus requisitos a partir dos requisitos do sistema.

Use relacionamentos comuns dentro de um projeto. Vincular existente… na seção Rastreabilidade relaciona itens do mesmo projeto; um vínculo com outro projeto é para itens que ficam em outro lugar.

  1. Selecione o item, por exemplo um requisito de subsistema.
  2. No inspetor, abra a seção Rastreabilidade. Em Outros projetos, clique em + (Adicionar vínculo a outro projeto…).
  3. Escolha a Relação, como traced from.
  4. Escolha o Projeto. Os itens dele são listados por número.
  5. Para uma biblioteca, escolha a Versão: Atual (cópia de trabalho) ou uma liberação como Liberação 1.1. Um vínculo com uma liberação mostra o rótulo dela em vez de atual, e o nome dela não abre uma página.
  6. Digite em Pesquisar para encontrar um item por número ou nome. Escolha uma Classe para listar só essa classe.
  7. Clique no item e depois em Adicionar vínculo. O aviso diz "Vínculo adicionado." e o item aparece em Outros projetos.

Um único Desfazer remove o vínculo. Adicionar o mesmo vínculo de novo mantém o existente.

Abrir o item vinculado

Clique no nome do item vinculado. O projeto dele abre nesse item.

  • Clique em × na linha do vínculo para remover um vínculo.
  • Quando os vínculos apontam para itens excluídos, clique em ⋯ ao lado de Outros projetos e depois em Remover vínculos quebrados (n).

Remover um vínculo altera apenas este projeto. O outro projeto nunca é alterado por um vínculo.

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

  1. Crie um projeto chamado EO-1 Payload com um requisito PL.1 Detector pixel pitch shall be at most 5.5 µm.
  2. Selecione PL.1 e abra Rastreabilidade → Outros projetos → +.
  3. Escolha traced from, o projeto CubeSat EO-1, pesquise ground sample e clique em 1.2 Ground Sample Distance. Clique em Adicionar vínculo.
  4. A linha diz traced from 1.2 Ground Sample Distance CubeSat EO-1 · atual. Um colega que só pode abrir EO-1 Payload vê Item em um projeto que você não pode abrir na mesma linha.

Dicas e boas práticas

  • Vincule do nível inferior para o nível superior, para que o projeto do sistema não precise mudar quando um subsistema for adicionado.
  • Compartilhe o projeto de nível superior como Leitor com as pessoas que trabalham no de nível inferior, para que vejam os nomes.
  • Execute Remover vínculos quebrados depois que um projeto de nível superior for reorganizado.

Erros comuns

ProblemaCausaCorreção
"Este item está neste projeto. Use Vincular existente… em vez disso."O destino está no mesmo projetoUse Vincular existente… no grupo da relação
Nenhum + em Outros projetosVocê só pode visualizar o projeto, ou o item está bloqueadoPeça a função Editor, ou desbloqueie o item
"Os vínculos com itens de outros projetos fazem parte do plano Team."O proprietário do projeto não está no plano TeamFaça o upgrade em Ajustes da conta → Plano e cobrança
O seletor diz "Este projeto não pode ser lido. Escolha outro projeto."Você perdeu o acesso a esse projetoPeça acesso ao proprietário dele

Como se conecta a outros recursos

  • Matriz de rastreabilidade: os vínculos das linhas pelas relações escolhidas são listados abaixo da grade em Outros projetos; Exportar… os inclui (veja Rastreabilidade).
  • Diagrama Spider: os itens vinculados aparecem como caixas tracejadas em torno do item; desative-os com Opções → Outros projetos.
  • Mapa do programa: Gerenciar projetos → Mapa do programa mostra como todos os seus projetos se vinculam, e Outros projetos ⋯ → Mostrar no Mapa do programa rastreia este item por outros projetos (veja Mapa do programa).
  • Cobertura do programa: o projeto ao qual você se vincula lista esses vínculos em Verificação → Cobertura do programa, por item e por projeto (veja Cobertura do programa).
  • Histórico e Atividade: adicionar e remover um vínculo fica registrado no item.
  • Lixeira: excluir um item move os vínculos dele para a Lixeira junto; restaurar o item os restaura.
  • Solicitações de mudança: Adicionar mudança ▾ → Adicionar um vínculo a outro projeto… e Remover um vínculo com outro projeto… preparam vínculos; eles são adicionados ou removidos quando a solicitação é aplicada.
  • Bibliotecas: vincule a um item de uma liberação de biblioteca com a opção Versão (veja Bibliotecas).

Exportações e relatórios

As exportações nomeiam os itens vinculados com o acesso da pessoa que exporta. Tudo o que essa pessoa não pode ler é escrito como "Item em outro projeto".

ExportarO que acontece com os vínculos com outros projetos
JSON do projeto (exportação do Banco de dados)Mantidos como estão guardados: apenas ids. Importar o arquivo os mantém
ReqIF (Banco de dados e Documentos)Um atributo External links em cada item vinculado: relação, id do projeto e id do item, mais número e nome quando você pode lê-los
XMIDeixados de fora; o relatório de exportação os conta como "Vínculo com outro projeto"
Matriz de rastreabilidade (Excel)Uma planilha Outros projetos separada
Matriz de rastreabilidade (CSV)Uma coluna Outros projetos
Relatório da Matriz de rastreabilidade de requisitos (RTM)Uma coluna Outros projetos

API e MCP

A API e o MCP retornam os vínculos como ids. Para ler os nomes, chame a operação resolve; ela usa o próprio acesso e a lista de projetos do token. O Mapa do programa e o Rastreamento do item estão disponíveis como GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace e as ferramentas MCP program_map e trace_chain. Veja API e MCP.

Os recursos de IA no app recebem os vínculos apenas como ids.

Mensagens

MensagemSignificado
Vínculo adicionado.O vínculo foi salvo
Este item está neste projeto. Use Vincular existente… em vez disso.O item escolhido está no mesmo projeto
Escolha um item e depois adicione o vínculo.Adicionar vínculo foi clicado sem escolher um item
Não há outros projetos para vincular. Crie ou abra outro projeto primeiro.Você tem apenas este projeto
Os vínculos com itens de outros projetos fazem parte do plano Team.O proprietário do projeto não está no plano Team
Um projeto contém no máximo 20.000 vínculos com outros projetos. Remova alguns primeiro.O projeto atingiu o limite

Limites

LimiteValor
Vínculos por projeto20,000
Itens lidos por solicitação500
Itens listados no seletor100 por pesquisa (restrinja a pesquisa para ver outros)

Um vínculo aponta para a versão atual do outro projeto, ou para a cópia de um item em uma liberação de biblioteca (veja Bibliotecas).