Controle e revisões
Linhas de produtos e configurações
Modele vários produtos em um projeto com características e configurações, indique quais itens se aplicam a quais produtos com Applies To e efetividade, veja e edite o modelo como uma configuração e gere documentos, RVTMs e linhas de base por configuração.
Nesta página
- Visão geral
- Conceitos
- Como usá-lo
- Quando e por quê
- Iniciar uma linha de produtos
- Criar uma configuração
- Indicar quais itens pertencem a quais produtos
- Ver e editar uma configuração
- Dar a uma configuração um valor próprio
- Gerar uma especificação para uma configuração
- Exemplo prático: a demonstração CubeSat EO-1
- Dicas e boas práticas
- Erros comuns
- Como se conecta a outros recursos
- A página Linha de produtos
- Aplica-se a
- Ver como configuração
- Editar em uma visão de configuração
- Valores de configuração
- Efetividade
- Documentos, RVTM e verificação
- Linhas de base e solicitações de mudança
- Checagens do modelo
- Pesquisa, importação e exportação
- API REST e MCP
- Planos
- Projetos SysML v2
- Limites
- Páginas relacionadas
Visão geral
Uma linha de produtos é uma família de produtos que compartilham a maior parte de um mesmo projeto. Modele o projeto compartilhado uma vez, marque onde os produtos diferem e defina cada produto como uma configuração. Assim, todas as páginas podem mostrar o modelo como uma configuração, e toda alteração no projeto compartilhado chega a todos os produtos.
Você trabalha com linhas de produtos nestes lugares:
- Controle e revisões → Linha de produtos: as características, as regras delas e as configurações criadas a partir delas.
- O grupo Linha de produtos do inspetor: Aplica-se a e efetividade do item selecionado.
- Ver como ▾ na barra superior: mostrar e editar o modelo como uma configuração.
- Documentos, a RVTM, a Central de testes, Linhas de base e versões e Solicitações de mudança: saídas e controle por configuração.
As linhas de produtos fazem parte dos planos Individual e Team. Linhas de base por configuração, responsáveis por configurações e as configurações que uma solicitação de mudança afeta fazem parte do plano Team. Veja Planos.
Conceitos
Recursos
Uma característica é uma escolha que difere entre produtos, como "X-band Downlink" ou "Propulsion". As características formam uma árvore: uma característica pai agrupa escolhas relacionadas.
Cada característica tem:
- Tipo: Obrigatória (toda configuração que tem a característica pai também a tem) ou Opcional (escolhida por configuração). Novas características são Opcionais.
- Filhos: a regra sobre as características filhas. Qualquer número (escolha livre), Escolher uma (exatamente uma filha por configuração) ou Escolher pelo menos uma (uma ou mais). Novas características têm Qualquer número.
- Regras: uma característica requer outra característica ou a exclui. Excluir funciona nos dois sentidos.
- Restrição: uma regra opcional que deve valer em qualquer configuração que selecione a característica, escrita como Applies To.
Configurações
Uma configuração é um produto: uma seleção de características. Cada configuração tem:
- Um número e um nome, como CFG-2 EO-1 Lite.
- Status: Draft, Released ou Retired. Novas configurações são Draft, e o mesmo vale para uma cópia de uma configuração Released (Duplicar, copiar e colar, importar para um projeto aberto): ela não tem registro de liberação próprio. Uma configuração Retired pode ser vista, mas não editada. Uma configuração é liberada com Liberar configuração… (veja Liberar uma configuração).
- Etapa (opcional): a etapa do ciclo de vida em que ela está, como Projeto preliminar ou CDR. A etapa decide quais regras de completude se aplicam.
- Owner (opcional, plano Team): a pessoa ou a equipe que deve aprovar as solicitações de mudança que a alteram.
- Efetividade (opcional): os números de série ou as datas de fabricação das unidades construídas de acordo com ela.
A seleção efetiva de uma configuração vai além das características que você marca:
- as características selecionadas;
- as características pai delas, até a raiz;
- as filhas Obrigatórias de cada característica selecionada;
- as características Obrigatórias na raiz da árvore.
Veredictos
O Holarch checa cada configuração em relação às regras de características e mostra um veredicto:
- Válida: a seleção segue todas as regras.
- Viola: …: uma regra foi violada, por exemplo "Viola: Encrypted Downlink requer X-band Downlink."
- Incompleta: …: falta uma escolha, por exemplo "Incompleta: escolha um Downlink (escolher uma)."
Quando várias regras falham, o veredicto nomeia a primeira nesta ordem: uma característica Obrigatória que outra característica selecionada exclui, um grupo Escolher uma sem escolha ou com mais de uma, um grupo Escolher pelo menos uma sem escolha, um requer não atendido, um exclui violado, uma Restrição falsa.
Completude
Um veredicto Válida cobre apenas as regras de características. A Completude checa os itens que uma configuração contém:
- cada requisito folha nela é verificado por um item nela (um caso de teste que se aplica a ela);
- cada conexão (Conduit) nela tem as duas pontas nela, e cada relacionamento com Applies To próprio tem as duas pontas nas configurações às quais se aplica;
- cada item nela tem o pai nela.
Cada configuração mostra Completo ou o número de lacunas, como "3 lacunas". Configurações Retired não são checadas. A completude ignora a efetividade: um item pertence a uma configuração quando se aplica a ela.
Completude por etapa
A Etapa de uma configuração escolhe o quanto é checado. Cada etapa usa um de cinco níveis:
| Nível | Etapa padrão | Checagens |
|---|---|---|
| 1 | Conceito | O pai de cada item está na configuração. |
| 2 | Projeto preliminar | Nível 1, cada conexão tem as duas pontas nela, e cada requisito folha é satisfeito por um item nela. |
| 3 | Projeto detalhado | Nível 2, e cada requisito folha é verificado por um item nela. |
| 4 | Test | Nível 3, cada caso de teste verificador tem um procedimento (uma descrição ou passos de teste) e um resultado para esta configuração. |
| 5 | Produção | Nível 4, cada caso de teste verificador teve resultado Passed para esta configuração, e nenhum problema em aberto está vinculado aos itens dela. |
Com um Processo de SE, a lista de Etapas contém os gates de revisão dele (SRR, PDR, CDR, TRR e assim por diante), cada um com um nível: SRR é 1, PDR 2, CDR 3, TRR 4, e as revisões de produção e operacionais 5. Sem uma Etapa, a completude usa as regras acima em Completude (requisitos verificados, pontas das conexões, pais).
Para alterar o nível de uma etapa, abra ⋯ → Ajustes… da página Linha de produtos e escolha um nível em Etapas. Um único Desfazer reverte a alteração.
A linha Completude mostra a completude do modelo e a verificação separadamente, por exemplo "Completa na CDR · 12/40 verificados": a primeira parte é a checagem da etapa, a segunda os requisitos com resultado Passed nesta configuração. A verificação é mostrada a partir do nível 3 e sem uma Etapa.
Liberar uma configuração
Uma configuração é liberada com Liberar configuração…: na página Linha de produtos, abra o ⋯ da coluna da configuração, ou pressione ⌘K / Ctrl+K e digite "Liberar". Definir Status como Released no inspetor ou no Banco de dados abre a mesma caixa de diálogo.
A caixa de diálogo mostra:
- Etapa: a etapa para a qual é a liberação. A completude é checada para ela.
- Regras de características e Revisões: uma configuração que viola uma regra, ou que tem duas revisões em vigor ao mesmo tempo, não pode ser liberada: "CFG-2 não pode ser Released. Viola: Wallbox requer Large pack. Altere primeiro a seleção dela na página Linha de produtos."
- Completude na etapa, com Mostrar lacunas, e Verificação (quantos requisitos estão verificados nela).
- Riscos altos em aberto, apenas em uma etapa de nível de completude 5 (Produção): os riscos e perigos da configuração que estão em aberto em nível alto (o nível residual, onde houver um definido), por exemplo "Risk RSK-1 Battery fire: High, Open". É um aviso: não bloqueia a liberação e não precisa de motivo. Um Risk conta enquanto o Status dele for Open e ele não for uma Opportunity; um Hazard conta até ser Accepted ou Closed.
- Condição de liberação, apenas enquanto a configuração não estiver completa: um Motivo (de 10 a 2.000 caracteres) e o Aprovador. Liberação fica desativado até que ambos sejam informados.
Clique em Liberação. O Status da configuração passa a Released, e o Holarch guarda um registro de liberação: a etapa, a completude e a verificação na liberação, as lacunas aceitas, o motivo e o aprovador, e a definição liberada (veja abaixo). Um único Desfazer reverte tanto a liberação quanto o registro dela.
A completude e a verificação são registradas como o Holarch as calculou no seu navegador na liberação. O Holarch online checa se a definição liberada corresponde ao resumo SHA-256 dela e recusa uma liberação cujo arquivo não corresponda; ele ainda não checa a completude novamente.
Quem aprova:
- Aplicativo desktop: digite o nome do aprovador. Ele é registrado com o nome informado; esta cópia do Holarch não tem contas.
- Holarch online, plano Individual: você aprova a própria liberação; o servidor registra sua conta e o horário.
- Holarch online, plano Team: o Owner da configuração aprova, ou um proprietário do projeto quando ela não tem um. Uma liberação incompleta fica como Aprovação pendente até que o aprovador abra Liberar configuração… nela e clique em Aprovar liberação (o Holarch pede a senha dele). Você aprova a própria solicitação somente quando o projeto permite a autoaprovação (Solicitações de mudança → Ajustes). Uma liberação completa não precisa de aprovação.
O servidor recusa uma mudança de Status para Released que não venha com um registro de liberação, de modo que um cliente da API ou uma página mais antiga não pode pular a caixa de diálogo. Ele também recusa um salvamento do projeto que remova ou altere um registro de liberação, mesmo vindo de um proprietário do projeto.
Retirar liberação… (⋯ da coluna, ou definir o Status de volta como Draft ou Retired) pede um motivo. O registro de liberação permanece e o log dele recebe a retirada; um registro de liberação nunca é excluído. Liberar novamente cria a liberação 2.
Registrar liberação… (⋯ da coluna) é oferecido para uma configuração que foi Released antes de os registros de liberação existirem. Ele registra o estado atual da configuração como a liberação dela, marcada como "registrada depois".
- Definir o Status de várias configurações de uma vez (Banco de dados → Atributos…) nomeia as que violam uma regra, que continuam Draft, e abre Liberar configuração… para cada uma das outras, uma após a outra.
- Retire uma liberação no modelo em uso, não em uma solicitação de mudança. Para liberar uma configuração por meio de uma solicitação de mudança, prepare a liberação (veja Liberar por meio de uma solicitação de mudança). Uma solicitação de mudança que apenas define o Status de uma configuração como Released não a libera quando é aplicada; a configuração mantém o Status, e o restante da solicitação de mudança é aplicado.
- Uma proposta de IA ou MCP não pode liberar uma configuração: a revisão dela diz "Requer um registro de liberação" e oferece Liberar configuração…; aplicar a proposta aplica as outras alterações dela.
A liberação de configurações de projetos SysML v2 ainda não está disponível.
Liberar por meio de uma solicitação de mudança
Uma liberação pode fazer parte de uma solicitação de mudança, de modo que o comitê que aprova as alterações também aprova a liberação. Enquanto você trabalha em uma solicitação de mudança (ou a tem aberta), prepare a liberação:
- Na solicitação de mudança, Adicionar alteração ▾ → Liberar uma configuração… e depois escolha a configuração.
- Na página Linha de produtos, ⋯ → Liberar com CR-12… da coluna da configuração.
- No inspetor ou no Banco de dados, defina Status como Released.
A caixa de diálogo é a mesma, com o título "Liberar CFG-2 com CR-12". Ela checa a completude na etapa escolhida, e lista os riscos altos em aberto no nível 5, em relação ao modelo tal como a solicitação de mudança o deixaria, e avisa quando a etapa informa menos do que a última liberação ou deixa lacunas na etapa seguinte. Enquanto a configuração não estiver completa, informe o Motivo; os aprovadores da solicitação tomam o lugar do Aprovador. Clique em Adicionar a CR-12: a liberação é preparada como uma alteração ("Liberar CFG-2 na CDR"), a configuração permanece Draft até então (o chip de Status da coluna dela diz "Liberação preparada em CR-12"), e a configuração conta como afetada pela solicitação, de modo que a aprovação do Owner dela é necessária onde houver regras de aprovação.
Quando a solicitação aprovada é aplicada, o Holarch libera a configuração e guarda o registro de liberação dela, com a etapa, o motivo e as lacunas aceitas tal como preparados, e os aprovadores da solicitação e via CR-12. Um único Desfazer reverte tanto a solicitação aplicada quanto a liberação. O Holarch não libera uma configuração quando, na aplicação, ela foi excluída ou desativada, já está liberada ou aguarda aprovação, viola uma regra de características ou tem lacunas que a solicitação não aceitou. O restante da solicitação ainda é aplicado, e o log da solicitação e o resultado dizem o motivo. Prepare a liberação novamente depois de corrigir.
O Holarch online registra as aprovações a partir dos votos da solicitação (contas e horários do servidor), nunca a partir de nomes digitados na página. Uma liberação incompleta aprovada pela solicitação não precisa de um Aprovar liberação separado. Somente a pessoa que aplica a solicitação pode registrar as liberações dela, dentro de uma hora após a checagem de aprovação; um salvamento do projeto ou um cliente da API não pode adicionar uma liberação por meio de uma solicitação de mudança.
A definição liberada
Cada registro de liberação guarda a configuração tal como liberada: os itens e relacionamentos com os valores deles, a seleção, as características e configurações de biblioteca que ela usou, os itens vinculados em outros projetos tal como lidos na liberação e os resultados de verificação. Ele é armazenado no projeto como um arquivo compactado com um resumo SHA-256.
Em Linhas de base e versões, o cartão Liberações lista cada liberação com a configuração, a etapa, a completude, o aprovador, a data e o estado. O menu ⋯ dele oferece:
- Abrir definição liberada: os itens liberados com os valores tal como liberados (por exemplo, a Mass própria de uma configuração), somente leitura.
- Verificar: checa se o registro corresponde ao resumo dele (íntegro) e reconstrói a configuração a partir das próprias entradas do registro (reproduzida exatamente): o snapshot, as características e configurações de biblioteca que ele congelou e o esquema com que foi resolvida. Edições posteriores, novas liberações de bibliotecas, itens vinculados alterados e classes, atributos ou relacionamentos renomeados não mudam o resultado.
- Comparar com hoje: o que a configuração mostra agora em comparação com a liberação, incluindo bibliotecas que passaram para outra liberação (nomeadas com os rótulos de liberação delas) e itens vinculados que mudaram desde então.
- Exportar (JSON): o registro com a definição dele.
- Retirar…
Applies To e efetividade
Dois campos em qualquer item ou relacionamento dizem a quais produtos ele pertence:
- Aplica-se a diz quais configurações incluem o item. É uma expressão de características e configurações, como
F-4 and not F-5. Vazio significa todas as configurações. - Efetividade diz a partir de qual unidade ou data o item está em vigor: números de série como
1-20, 25, 40-, um intervalo de datas ou ambos. Vazio significa sempre.
Os dois são independentes e se combinam: um item está em uma visão quando se aplica à configuração e está em vigor no número de série ou na data da visão.
Identidade compartilhada e valores de configuração
Um item é um único item em todas as configurações. Nome, Número, Classe, Rótulos e Responsável são os mesmos em todos os lugares, assim como a posição nas hierarquias, a ordem no documento e o layout no diagrama.
A Descrição e os valores de atributos podem diferir. Um valor de configuração é o valor próprio de um item para uma configuração, como um Daily Data Volume de 1 GB na EO-1 Lite enquanto as outras configurações mantêm 3 GB. Uma configuração sem valor próprio usa o valor base do item.
A visão de 150 %
Todas as configurações (nenhuma configuração escolhida) mostra a linha de produtos inteira: todos os itens de todos os produtos, com os valores base. Os campos que diferem por configuração são marcados como Varia. Esta é a visão em que você renumera, restaura linhas de base e exclui itens em todos os lugares.
Como usá-lo
Quando e por quê
Use uma linha de produtos quando vários produtos compartilham a maior parte dos requisitos, funções e arquitetura: uma unidade de voo e uma variante mais leve, versões de exportação, opções de cliente, atualizações em blocos. Um único modelo mantém as partes compartilhadas sincronizadas. Cada configuração continua tendo a própria especificação, RVTM e linhas de base.
Uma boa ordem de trabalho:
- Modele o projeto compartilhado como de costume.
- Liste os pontos em que os produtos diferem como características, com as regras delas.
- Adicione uma configuração por produto e verifique se cada uma é válida.
- Marque os itens que apenas alguns produtos têm com Applies To, e os valores que diferem com valores de configuração.
- Gere os documentos e verifique cada configuração.
Se os seus produtos diferem apenas em datas de fabricação ou números de série, crie uma única configuração (por exemplo "Production") e use apenas a efetividade.
Iniciar uma linha de produtos
- Pressione ⌘K / Ctrl+K e escolha Iniciar uma linha de produtos…: isso abre a página e a caixa de diálogo Nova característica. Ou crie um item Característica ou Configuração com + Novo item no Banco de dados. Você vê Controle e revisões → Linha de produtos na barra de navegação, e um grupo Linha de produtos no inspetor de cada item.
- Na página Linha de produtos, clique em + Nova característica e digite o nome da característica, como "Downlink". Pressione Enter. O nome é salvo e uma nova linha irmã começa.
- Digite o nome da próxima característica. Para torná-la filha da linha acima, pressione ⌥⇧→ / Alt+Shift+→. ⌥⇧← / Alt+Shift+← a move de volta para fora.
- Defina o Tipo e os Filhos de cada característica no inspetor (pressione Enter na linha dela).
- Adicione regras pelo menu ⋯ da linha: Regras… para requer e exclui, Restrição… para uma restrição.
A página Linha de produtos, o grupo do inspetor e a coluna Aplica-se a ficam ocultos até que um projeto tenha a primeira Feature ou Configuration. Eles voltam a ficar ocultos quando a última é excluída, exceto em itens que ainda têm um valor de Aplica-se a ou de efetividade.
Criar uma configuração
- Na página Linha de produtos, clique em + Nova configuração. Digite um nome, como "EO-1 Lite". Uma nova coluna aparece em Configurações.
- Marque as características que este produto tem. Em um grupo Escolher uma, as células são botões de opção: escolher uma substitui a outra. As células marcadas como implícitas estão incluídas por causa de outra característica (uma pai ou uma filha Obrigatória); elas não podem ser alteradas.
- Leia a linha Veredicto sob a coluna. Corrija a seleção até que ela mostre Válida.
- Leia a linha Completude. Aponte para uma contagem de lacunas para ver as lacunas.
- Clique em Checar configurações para checar todas as configurações de uma vez.
Para começar a partir de um produto existente, abra o menu ⋯ do cabeçalho da coluna da configuração e escolha Duplicar. A cópia tem a mesma seleção e os mesmos valores de configuração.
Indicar quais itens pertencem a quais produtos
- Selecione um item, como um requisito, e abra o grupo Linha de produtos do inspetor.
- Em Aplica-se a, digite o número de uma característica ou configuração, como
F-4. Escolha na lista de sugestões com ↓ e Enter. A linha sob o campo mostra, por exemplo, "Aplica-se a 1 de 2 configurações: CFG-1". - Combine termos com
and,or,note parênteses:F-3 and not F-5. - Ou clique em Escolher… e escolha configurações ou características em uma lista.
Deixe Aplica-se a vazio para itens que todos os produtos têm. A maioria dos itens fica vazia.
Ver e editar uma configuração
- Clique em Ver como ▾ na barra superior e escolha uma configuração. Você vê um banner: "Visualizando a configuração CFG-2 EO-1 Lite. Novos itens se aplicam somente à CFG-2; valores alterados passam a ser da CFG-2." Todas as páginas agora mostram apenas os itens da CFG-2, com os valores da CFG-2.
- Trabalhe como de costume. Novos itens se aplicam à CFG-2. Uma descrição ou um atributo alterado passa a ser o valor próprio da CFG-2 quando outras configurações também têm o item.
- Clique em Sair no banner para ver todas as configurações novamente.
A escolha pertence à aba do navegador. Outras pessoas e outras abas mantêm a própria visão. Veja Editar em uma visão de configuração para todas as regras.
Dar a uma configuração um valor próprio
- Escolha a configuração em Ver como ▾.
- Selecione o item e altere o atributo no inspetor. Enquanto você edita, a dica sob o campo mostra, por exemplo, "Salvo somente para CFG-2. As outras configurações mantêm 3 GB." Após a alteração, o campo mostra um chip Valor de CFG-2.
- Para desfazer a diferença, abra o menu do chip e escolha Usar valor base.
Gerar uma especificação para uma configuração
- Abra o documento, clique em Entregar ▾ e escolha um modelo do Word, como Especificação (Word). Você vê a caixa de diálogo Exportar para Word.
- Defina Configuração como o produto, e Efetividade como Qualquer unidade, um Número de série ou uma Data.
- Exporte o documento. O documento omite as seções que não se aplicam, numera o restante como mostrado e nomeia a configuração na página de rosto, no rodapé e no nome do arquivo.
Exemplo prático: a demonstração CubeSat EO-1
O projeto de demonstração CubeSat EO-1 tem dois produtos: EO-1 Flight, com downlink em banda X e criptografia, e EO-1 Lite, com o downlink em banda S. Crie a demonstração com Arquivos de projeto ▾ → Novo projeto de demonstração em Gerenciar projetos.
- Abra Controle e revisões → Linha de produtos. Você vê as características Downlink (Obrigatória, Escolher uma) com S-band Downlink e X-band Downlink, Encrypted Downlink (Opcional, requer X-band Downlink) e Propulsion (Opcional, requer X-band Downlink).
- Veja as configurações CFG-1 EO-1 Flight (X-band e Encrypted Downlink, números de série 1–2) e CFG-2 EO-1 Lite (S-band, números de série 3 em diante). Os dois veredictos mostram Válida.
- Na coluna CFG-2, marque Encrypted Downlink. O veredicto muda para "Viola: Encrypted Downlink requer X-band Downlink." Pressione ⌘Z / Ctrl+Z.
- Abra o requisito 4.4 Downlink Encryption. O Aplica-se a dele é a característica Encrypted Downlink (F-4), então ele só está na EO-1 Flight. 1.5.2 S-band Transmitter, as interfaces dele IF-08 e IF-12, e 5.1 S-band Downlink Rate se aplicam a F-2; 1.5.3 X-band Payload Radio, as interfaces dele IF-08.1 e IF-12.1, 5.5 X-band Downlink Rate e o caso de teste dele TC-21 X-band Link Test se aplicam a F-3.
- Escolha Ver como ▾ → CFG-2 EO-1 Lite e abra o requisito 5.4 Daily Data Volume. A descrição dele diz "at least 1 GB" com um chip Valor de CFG-2. Na EO-1 Flight, ele mantém o texto base, "at least 3 GB".
- Abra o caso de teste TC-11 UHF Command Test. Ele contém um resultado por configuração: Passed na EO-1 Flight, In Progress na EO-1 Lite.
- Abra 1.3.2 Battery Pack e veja as características (Characteristic) dele Thermostat Heater Power (2 W, efetividade SN 1) e Software-Controlled Heater Power (3 W, SN 2 em diante): o aquecedor mudou a partir da segunda espaçonave.
- Abra Controle e revisões → Linhas de base e versões. EO-1 Flight PDR é uma linha de base da CFG-1 (plano Team).
- Abra Verificação → Checagens do modelo em Todas as configurações. As regras de Linha de produtos avisam que Propulsion não é selecionada por nenhuma configuração (ProductLine.4). A demonstração a deixa sem seleção de propósito, como exemplo dessa checagem.
Dicas e boas práticas
- Mantenha as características sobre o produto, não sobre documentos: "X-band Downlink", não "Section 5 option".
- Prefira termos de características em Aplica-se a.
F-3continua correto quando você adiciona um terceiro produto com downlink em banda X;CFG-1não. - Agrupe muitas opções relacionadas sob uma característica pai em vez de escrever expressões longas.
- Dê valores de configuração apenas aos valores que realmente diferem. Todo o resto permanece compartilhado.
- Use Released para configurações sob controle e Retired para produtos que não são mais fabricados.
- Modele uma mudança de peça a partir de um número de série como dois itens, o antigo e o novo, cada um com a própria efetividade.
Erros comuns
- Um item desaparece de uma visão após uma edição. O Aplica-se a ou a efetividade dele não inclui mais a configuração. O aviso o nomeia; clique em Desfazer ou encontre-o em Todas as configurações.
- Uma configuração continua Incompleta. Um grupo Escolher uma ou Escolher pelo menos uma não tem escolha. Marque uma filha desse grupo.
- Um item não está em nenhuma configuração. O Aplica-se a dele nomeia características que nenhuma configuração seleciona. As Checagens do modelo o informam (ProductLine.2).
- Uma movimentação altera todos os produtos. A estrutura é compartilhada: mover ou reordenar um item em uma visão de configuração o move em todas as configurações.
Como se conecta a outros recursos
- Documentos: gere por configuração e por número de série ou data.
- RVTM e Central de testes: registre resultados por configuração; "verificado" significa verificado para aquele produto.
- Checagens do modelo: o conjunto de regras Linha de produtos checa expressões, veredictos, efetividade e revisões (supersedes).
- Linhas de base e versões (Team): crie uma linha de base de uma configuração e compare configurações.
- Solicitações de mudança (Team): veja quais configurações uma solicitação altera; os responsáveis aprovam.
- Pesquisa:
appliesto:CFG-2evaries:yesencontram itens por configuração. - API REST e MCP: leia o modelo como uma configuração.
A página Linha de produtos
Controle e revisões → Linha de produtos mostra as características à esquerda e as configurações à direita. Com menos de 1.100 px de largura, as duas regiões ficam empilhadas.
Cabeçalho da página
| Controle | O que ele faz |
|---|---|
| + Nova característica | Adiciona uma característica com o próximo número (F-1, F-2, …) no final da árvore. |
| Checar configurações | Lista cada configuração com Válida ou o primeiro problema dela, e Completo ou as lacunas dela. |
| + Nova configuração | Adiciona uma coluna de configuração com o próximo número (CFG-1, CFG-2, …). |
| ⋯ | Exportar CSV (características por configurações, com Selecionada ou Implícita e os veredictos) e Ajuda. |
Recursos
Uma grade em árvore com as colunas Característica (número e nome), Tipo, Filhos e Usado por (quantos itens nomeiam a característica em Aplica-se a). As regras aparecem como pequenas etiquetas na linha, como "requer F-3".
Defina o Tipo e os Filhos de uma característica no inspetor: pressione Enter na linha para abri-la lá.
Menu ⋯ da linha:
- Adicionar característica filha…
- Renomear (F2)
- Regras…: listas de seleção Requer e Exclui
- Restrição…: uma expressão de Aplica-se a que deve valer quando a característica está selecionada
- Mostrar itens que a usam
- Excluir…
Configurações
Uma grade com uma linha por característica (na ordem da árvore) e uma coluna por configuração. Cada cabeçalho de coluna mostra o número, o nome e o Status, e o responsável no plano Team.
Células:
- Uma caixa de seleção para características que você escolhe livremente.
- Um botão de opção para as filhas de uma característica Escolher uma.
- Uma marca de implícita para características incluídas por outra. A dica de ferramenta a nomeia, por exemplo "Incluída porque F-1 está selecionada."
A linha Veredicto na parte inferior mostra Válida ou o primeiro problema (as regras de características). A linha Completude abaixo dela mostra Completo ou o número de lacunas; a dica de ferramenta dela as lista (veja Completude).
Menu ⋯ do cabeçalho da coluna:
- Ver como esta configuração
- Renomear…
- Efetividade…
- Responsável… (Team): abre a configuração no inspetor.
- Linha de base de CFG-2… (Team): salva uma linha de base desta configuração (veja Linhas de base por configuração).
- Duplicar: copia a seleção e todos os valores de configuração, e um único Desfazer reverte tudo. A cópia é Draft e se chama "<name> (cópia)".
- Desativar, ou Voltar a rascunho em uma configuração desativada. A visão de uma configuração desativada é somente leitura.
- Excluir…: move a configuração para a Lixeira. Os itens mantêm os valores dela, então Restaurar a traz de volta intacta.
Estados vazios
- Sem características: "Nenhuma característica ainda. Adicione a primeira característica: uma escolha que difere entre produtos."
- Sem configurações: "Nenhuma configuração ainda. Uma configuração é um produto: uma seleção de características."
Teclado
| Teclas | Onde | O que fazem |
|---|---|---|
| Tab | Página | Move entre as ações do cabeçalho e as duas grades. Nunca recua. |
| Home / End | Recursos | Primeira ou última linha. |
| ↑ / ↓ | Recursos | Linha anterior ou seguinte. |
| ← / → | Recursos | Recolhe ou expande. |
| Enter | Recursos | Ao nomear: salva o nome e inicia uma nova irmã abaixo. Em uma linha selecionada: abre a característica no inspetor. |
| F2 | Recursos | Renomeia a característica no lugar. Esc, ou deixar o nome vazio, não adiciona nada. |
| ⌥ / Alt+↑ / ⌥ / Alt+↓ | Recursos | Move a característica para cima ou para baixo entre as irmãs (as duas características trocam de número). |
| ⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+← | Recursos | Aumenta ou diminui o recuo da característica, como na estrutura do documento. |
| Delete | Recursos | Exclui a característica, após uma confirmação. |
| Setas | Configurações | Move de célula em célula. |
| Space | Configurações | Marca ou desmarca a célula. |
| Enter | Configurações | Em um cabeçalho de coluna: abre o menu dele. |
| Home / End | Configurações | Primeira ou última coluna. |
Leitores de tela
As características são uma grade em árvore chamada "Características". As configurações são uma grade chamada "Configurações por característica"; cada célula lê, por exemplo, "F-3 X-band Downlink em CFG-1 EO-1 Flight: selecionada". As alterações são anunciadas: "X-band Downlink selecionada para CFG-1.", "CFG-2 viola uma regra: Encrypted Downlink requer X-band Downlink.", "CFG-2 é válida."
Aplica-se a
Aplica-se a diz quais configurações incluem um item. Fica no grupo Linha de produtos do inspetor (depois dos grupos de atributos), na Visão do item e como coluna do Banco de dados. Ainda não disponível: editar o Aplica-se a de um relacionamento no painel de relacionamentos.
O campo
- Aplica-se a: a expressão. Vazio mostra "Todas as configurações".
- Escolher…: escolha configurações ou características em uma lista em vez de digitar.
- A linha de pré-visualização abaixo: "Aplica-se a 2 de 4 configurações: CFG-1, CFG-3" ou "Aplica-se a todas as configurações".
- Quando uma visão de configuração adicionou ou removeu o item, chips como Removido de CFG-2 e Adicionado a CFG-4. Clique em ✕ em um deles para limpá-lo: o item volta a seguir o Aplica-se a para aquela configuração.
- Um aviso quando a expressão nomeia uma característica ou configuração excluída (mostrada pelo número antigo).
Itens Feature e Configuration não têm Aplica-se a.
No Banco de dados, a coluna Aplica-se a aparece assim que algum item usa Aplica-se a (oculte-a pelo ▾ dela, adicione-a de volta em Colunas). Clique duas vezes em uma célula, ou pressione Enter ou F2, para editá-la com o mesmo campo.
Digitar abre uma lista de características e configurações correspondentes e depois os operadores. ↓/↑ movem, Enter ou Tab insere, Esc fecha a lista, um segundo Esc reverte o campo. Enter salva; sair do campo salva quando a expressão é válida.
A caixa de diálogo Escolher…
Aplica-se a — <item> oferece três opções:
- Todas as configurações: limpa a expressão.
- Estas configurações: marque configurações; grava
CFG-1 or CFG-3. - Características: marque características e escolha Todas (grava
F-2 and F-5) ou Qualquer (gravaF-2 or F-5).
A expressão resultante aparece abaixo. Editar como expressão a coloca no campo de texto sem salvá-la. Aplicar a salva, e um único Desfazer reverte tudo.
A expressão Applies To
| Você digita | Significa |
|---|---|
F-3 ou "X-band Downlink" | Uma característica, pelo número ou pelo nome entre aspas. Verdadeiro quando a seleção efetiva da configuração a contém. |
CFG-2 ou config "EO-1 Lite" | Uma configuração. Verdadeiro somente para essa configuração. |
and, or, not, ( ) | Combine termos. &, | e ! também funcionam e são mostrados como palavras. not tem precedência, depois and, depois or. |
all, none | Todas as configurações, ou nenhuma. |
Maiúsculas e minúsculas não importam. O Holarch armazena a expressão com os ids dos itens, de modo que renomear ou renumerar uma característica nunca a quebra. Ela mostra números, ou o nome entre aspas para um item sem número.
Uma característica excluída ou desconhecida é falsa, e as Checagens do modelo a informam como erro.
Mensagens da expressão
Uma expressão inválida nunca é salva. O campo mantém o seu texto, marca o erro, e o último valor válido continua em vigor. As posições contam caracteres a partir de 1.
| Mensagem | O que fazer |
|---|---|
| Nenhuma característica ou configuração chamada “F-9”. Escolha uma da lista ou crie a característica primeiro. | Confira o número ou crie a característica. |
| Esperava-se uma característica ou configuração depois de “and” (caractere 12). | Adicione um termo depois do operador. |
| Esperava-se uma característica ou configuração no caractere 1. | Comece com um termo, not ou (. |
| Esperava-se “and” ou “or” antes de “F-5” (caractere 9). | Junte os dois termos com um operador. |
| Falta “)” para o “(” no caractere 5. | Feche o parêntese. |
| “)” no caractere 9 não tem “(” correspondente. | Remova o parêntese extra. |
| Falta a aspa de fechamento do nome no caractere 4. | Feche o nome entre aspas. |
| “Wallbox” corresponde a 2 características (F-3, F-11). Use o número. | Duas características têm o mesmo nome; digite o número. |
| Aplica-se a é longo demais. Use no máximo 200 características e configurações; em vez disso, agrupe-as com uma característica pai. | Encurte a expressão. |
Ver como configuração
Ver como ▾ mostra o modelo inteiro como uma configuração. Fica na barra superior, à esquerda do status de salvamento, assim que o projeto tem uma configuração.
O menu
- Todas as configurações: a linha de produtos inteira.
- Uma entrada por configuração, com o Status e uma marca quando ela viola uma regra ou está incompleta.
- Efetividade ▸: Qualquer unidade, Número de série…, Data… ou Número de série e data…. Veja Ver em um número de série ou data.
- Gerenciar linha de produtos: abre a página Linha de produtos.
O menu abre com Enter, Space ou ↓; as teclas de seta movem, Enter escolhe e Esc fecha. ⌘K / Ctrl+K tem Ver como configuração…, Ver todas as configurações, Definir efetividade…, Ir para Linha de produtos, Nova característica…, Nova configuração… e, em uma visão, Adicionar existentes a CFG-2….
O banner
Enquanto uma configuração está escolhida, um banner sob a barra superior diz, por exemplo, "Visualizando a configuração CFG-2 EO-1 Lite em SN 23. Novos itens se aplicam somente à CFG-2; valores alterados passam a ser da CFG-2." Ele mostra quantos itens estão na visão ("1.204 de 1.350 itens") e tem:
- Alterar ▾: o mesmo menu de Ver como ▾.
- Sair: volta para Todas as configurações.
Quando você também trabalha em uma solicitação de mudança, o banner da solicitação de mudança vem primeiro e o da configuração em segundo.
O que cada página mostra
- Itens e relacionamentos que não se aplicam à configuração, ou que não estão em vigor no ponto da visão, ficam de fora.
- Itens com valores de configuração mostram esses valores.
- Contagens, consolidações, orçamentos, simulação, pontuações de qualidade e Checagens do modelo são calculados para a configuração.
- Estruturas de documentos, documentos gerados e a RVTM numeram os itens como mostrado. Os números armazenados não mudam; as exportações declaram "Numeração como mostrada em CFG-2."
- A pesquisa e as consultas são executadas na visão.
A escolha pertence à aba do navegador e é mantida quando você a recarrega. Trocar de visão não é uma edição, então Desfazer a ignora.
Leitores de tela
O botão diz "Ver como: CFG-2 EO-1 Lite". O banner é uma região chamada "Visão da configuração". Entrar, sair e mudar o ponto são anunciados, por exemplo "Visualizando a configuração CFG-2 EO-1 Lite. 1.204 de 1.350 itens se aplicam." e "Visualizando todas as configurações."
Editar em uma visão de configuração
Você edita em uma visão de configuração como em qualquer outro lugar. O Holarch transforma cada edição em uma alteração da linha de produtos inteira, de modo que as outras configurações mantêm o que tinham. Cada ação pode ser revertida com um único Desfazer.
Criar e alterar itens
| Você faz | O que acontece |
|---|---|
| Criar um item (de qualquer forma: + Novo, um diagrama, um documento, uma linha do Banco de dados, colar, duplicar, um modelo, uma importação, uma proposta de IA ou MCP aplicada) | O item se aplica somente a esta configuração. Com apenas uma configuração, Aplica-se a fica vazio. |
| Duplicar, ou Copiar com filhos | Cada cópia se aplica a esta configuração e recebe os valores mostrados como valores base. |
| Alterar Nome, Número, Classe ou Rótulos | Altera-os para todas as configurações. O campo mostra um ícone Compartilhado; a alteração é anunciada como, por exemplo, "Nome alterado para todas as configurações." |
| Alterar a Descrição ou um atributo de um item que outras configurações têm | Salvo como valor próprio desta configuração. Um valor igual ao valor base remove o valor próprio. Configurações desativadas contam como outras configurações, então mantêm os valores delas. |
| Alterar a Descrição ou um atributo de um item que só esta configuração tem | Salvo como valor base. |
| Alterar Aplica-se a ou a efetividade | Altera-os para todas as configurações. Os campos mostram um ícone Compartilhado e, enquanto você edita, a dica diz "Altera Aplica-se a para todas as configurações, não só para CFG-2." Quando o item não pertence mais à visão, ele sai dela: "R-4.2 não se aplica mais a CFG-2." com Desfazer. |
| Adicionar um relacionamento | Adicionado à linha de produtos. Fica limitado a esta configuração quando as duas pontas também estão juntas em outra configuração. |
| Alterar um atributo de um relacionamento | Como para um atributo de item. |
| Mover, reordenar, aumentar ou diminuir o recuo, ou mudar o pai | Altera a estrutura compartilhada para todas as configurações: "Movido para todas as configurações." |
| Alterar o layout do diagrama | Compartilhado por todas as configurações. |
| Registrar um resultado de teste | Salvo como resultado desta configuração, também quando nenhuma outra configuração tem o caso de teste. Executar suíte diz "Registrando resultados para CFG-2." |
| Editar o esquema, os ajustes do projeto, o compartilhamento ou as assinaturas de bibliotecas | Compartilhado, como em Todas as configurações. |
Remover e excluir
| Você faz | O que acontece |
|---|---|
| Excluir um item que outras configurações têm | Uma confirmação pergunta, por exemplo, "Remover R-4.2 de CFG-2? Ele continua em CFG-1 e CFG-3." Remover de CFG-2 o tira somente desta configuração; Excluir em todos os lugares… o exclui para a Lixeira. |
| Remover um item desses que tem filhos | Remover também os 3 filhos dele de CFG-2 (ativado por padrão). Desativado: os filhos permanecem na configuração e aparecem no nível imediatamente acima. |
| Excluir um item que só esta configuração tem | Excluído para a Lixeira, como de costume. |
| Remover um relacionamento que outras configurações têm | Removido somente desta configuração: "Vínculo removido de CFG-2. Ele continua em outras 2 configurações." |
| Remover um relacionamento que só esta configuração tem | Excluído, como de costume. |
| Remover do diagrama | Remove o relacionamento do item com o diagrama para esta configuração. Em diagramas que apenas listam as formas, a caixa de diálogo diz "Remove a forma deste diagrama em todas as configurações." |
| Restaurar da Lixeira | Restaura o item na linha de produtos. Se ele não se aplicar à configuração: "R-4.2 restaurado. Ele não se aplica a CFG-2." |
Quando uma edição tira o item selecionado da visão, o foco passa para o próximo item da mesma lista e o aviso diz para onde o item foi.
Adicionar um item existente
Os seletores para adicionar um item existente a um diagrama, documento ou relacionamento listam os itens da visão. Para trazer um item que não se aplica à configuração, use Adicionar existentes a CFG-2… em ⌘K / Ctrl+K ou no menu Alterar ▾ do banner: "Battery adicionado a CFG-2."
O que não está disponível em uma visão
- Renumerar…, Renumerar a partir daqui… e Renumerar filhos…: os números são compartilhados por todas as configurações. Renumere em Todas as configurações.
- Restaurar linha de base e Restaurar versão anterior: "Saia da visão de configuração para restaurar uma linha de base."
- Toda edição em uma configuração Retired: "CFG-1 está desativada. Copie-a para fazer alterações." Uma configuração Released continua editável, a menos que o controle de configuração a bloqueie.
Configurações liberadas e desativadas mantêm os valores
Uma edição em outro lugar nunca altera o que uma configuração Retired mostra, e só altera uma configuração Released por meio de uma solicitação de mudança. Quando você altera o valor base de um item (em Todas as configurações, com Tornar este o valor base, ou por uma importação ou uma proposta de IA ou MCP aplicada), cada configuração Retired, e cada Released fora de uma solicitação de mudança, que tem o item e nenhum valor próprio recebe o valor antigo como valor próprio como parte da mesma alteração. Um valor base que estava vazio não é mantido.
Itens bloqueados, montados de bibliotecas e controlados mantêm as regras habituais também para valores de configuração.
Desfazer e histórico
- Desfazer funciona entre trocas de visão. Quando a etapa foi feita em outra visão, o aviso a nomeia: "Alteração feita em CFG-2 desfeita: Mass de Battery."
- Histórico mostra "Em CFG-2" ao lado de cada alteração feita naquela visão.
Trabalhar com outras pessoas
Duas pessoas em configurações diferentes nunca sobrescrevem os valores ou as remoções uma da outra. Uma edição do valor base e um valor de configuração nunca entram em conflito. Duas pessoas alterando o mesmo campo para a mesma configuração: a alteração posterior prevalece, como em qualquer campo.
Quando alguém exclui a configuração que você está vendo, sua aba volta para Todas as configurações: "CFG-2 foi excluída. Mostrando todas as configurações."
Valores de configuração
Um valor de configuração é a Descrição ou o valor de atributo próprio de um item para uma configuração.
Quais campos podem diferir
| Campo | Pode diferir por configuração |
|---|---|
| Descrição, todos os atributos, atributos de relacionamentos | Sim |
| Nome, Número, Classe, Rótulos, Responsável | Não: eles identificam o item |
| Aplica-se a, efetividade, atributos de Feature e Configuration, selects, requires, excludes | Não: eles definem as configurações |
| Atributos com fluxo de aprovação (como o Status de Requirement sob aprovações) | Não: um registro de aprovação por item |
| Resultados de qualidade, dados de revisão e valores calculados | Não: calculados para cada visão |
| Layout do diagrama e ajustes do documento | Não |
Em uma visão de configuração
- Um campo com valor próprio desta configuração mostra o chip Valor de CFG-2. O menu dele:
- Usar valor base (3 GB): remove o valor próprio.
- Tornar este o valor base: torna este valor o valor base; os valores próprios das outras configurações permanecem.
- Valores em todas as configurações…
- Um campo que nunca difere mostra um ícone Compartilhado ("Compartilhado por todas as configurações.").
- Enquanto você edita um campo de um item que outras configurações têm, a dica diz "Salvo somente para CFG-2. As outras configurações mantêm 3 GB."
Em Todas as configurações
Um campo com valores próprios mostra Varia (2). O menu dele tem Valores em todas as configurações… e Limpar valores da configuração.
Enquanto você edita um campo que pode diferir, a dica diz quais configurações a alteração atinge, por exemplo "Altera CFG-2 e CFG-3. CFG-1 (Released) mantém 1.400. CFG-4 mantém o valor próprio."
Valores em todas as configurações… lista primeiro o Valor base e depois cada configuração com o Valor e a Origem ("valor próprio" ou "base"). Edite uma linha no lugar e pressione Enter para salvá-la.
No Banco de dados, uma célula com valor próprio tem uma marca no canto. O histórico, as listas de alterações e as comparações nomeiam um valor de configuração como, por exemplo, "Mass (CFG-2)", e uma mudança de pertencimento como "Em CFG-2".
Efetividade
A efetividade diz a partir de qual unidade ou data de fabricação um item, relacionamento ou configuração está em vigor. Os campos de efetividade aparecem assim que o projeto tem uma configuração.
Campos
No grupo Linha de produtos do inspetor, sob Aplica-se a, e na caixa de diálogo Efetividade… de uma configuração:
- Números de série: uma lista como
1-20, 25, 40-.40-significa 40 em diante. Deixe vazio para todas as unidades. - Efetivo a partir de: a primeira data de fabricação à qual se aplica (AAAA-MM-DD).
- Até (sem incluir): a primeira data de fabricação à qual não se aplica mais.
Um resumo sob os campos diz, por exemplo, "Em vigor para SN 1–20 e 25, e SN 40 em diante." As etiquetas em outros lugares dizem "SN 1–20, 25, 40– · A partir de 2027-03-01". Com números de série e datas definidos, ambos devem valer.
Os números de série são armazenados ordenados e mesclados. Até 200 intervalos, números até 1.000.000.000.000. Ainda não disponível: um prefixo de série do projeto, para digitar números como SN-0021.
A efetividade de uma configuração nomeia as unidades construídas de acordo com ela. Ela não filtra os itens dessa configuração.
Ver em um número de série ou data
- Escolha Ver como ▾ → Efetividade ▸ → Número de série… (ou Data…, ou Número de série e data…), ou ⌘K / Ctrl+K Definir efetividade….
- Digite o número de série, a data de fabricação ou ambos. O banner adiciona o ponto: "Visualizando a configuração CFG-3 Block 2 em SN 23."
Um número de série e uma data de fabricação juntos descrevem uma unidade: "SN 75 fabricada em 2027-06-15". Um item é então mostrado quando ambos valem, cada um onde o item o define. Número de série… mantém uma data já escolhida e Data… mantém um número de série; Qualquer unidade limpa ambos. Os documentos (Número de série e data na caixa de diálogo Exportar), a RVTM e a API (effectivity=sn:75,date:2027-06-15) aceitam o mesmo ponto.
| O item tem | Ver em um número de série | Ver em uma data |
|---|---|---|
| Somente números de série | Mostrado quando o número está na lista dele | Mostrado, com a etiqueta dele |
| Somente datas | Mostrado, com a etiqueta dele | Mostrado quando a data está no intervalo dele |
| Ambos | Mostrado quando o número está na lista dele | Mostrado quando a data está no intervalo dele |
| Nenhum dos dois | Mostrado | Mostrado |
Escolher um número de série com Todas as configurações seleciona a configuração cujos números de série o contêm. Quando várias o contêm, o menu as lista ("O SN 23 está em CFG-2 e CFG-3. Escolha um."). Quando o ponto está fora da efetividade própria da configuração escolhida, o banner avisa: "O SN 23 está fora da efetividade de CFG-2 (SN 1–20)."
Mensagens de efetividade
| Mensagem | O que fazer |
|---|---|
| “x” não é um número de série nem um intervalo. Use números e intervalos como 1-20, 25, 40-. | Corrija a parte indicada. |
| O intervalo “20-1” está invertido. Escreva o número menor primeiro. | Troque os números. |
| Use no máximo 200 intervalos de série. | Mescle intervalos. |
| Os números de série vão até 1000000000000. | Use um número menor. |
| “x” não é uma data. Use AAAA-MM-DD. | Corrija a data. |
| Efetivo até deve ser posterior a Efetivo a partir de. | Altere uma das datas. |
| Escreva os números de série como intervalos, por exemplo 1-20, 25, 40-. | Mostrado sob o campo; corrija os intervalos. |
| Até deve ser posterior a De. | Mostrado sob o campo; altere uma das datas. |
| SN 12–30 se sobrepõe a CFG-3 (SN 21–40). | Um aviso em configurações, sem bloqueio: dois produtos compartilham números de série. |
Revisões de um item
Quando uma peça muda a partir de um número de série ou de uma data, modele a peça antiga e a nova como dois itens, cada um com a própria efetividade, e relacione a nova à antiga com supersedes (o inverso é superseded by). Uma cadeia como rev C supersedes rev B supersedes rev A as torna revisões de uma mesma posição. O Holarch nunca escolhe entre revisões: ele informa onde a efetividade delas se sobrepõe ou deixa unidades sem revisão.
- Banner: quando duas revisões estão ambas em vigor no ponto da visão, o banner avisa: "Revisões sobrepostas: A-20 Cooling unit tem 2 em vigor em SN 75 (A-20A, A-20B)."
- Checagens do modelo: Revisões em vigor ao mesmo tempo (ProductLine.13) em cada uma das duas revisões, com os números de série e as datas que elas compartilham; Unidades sem revisão em vigor (ProductLine.14) no item que as revisões decompõem (ou na revisão mais antiga), com as unidades entre a primeira e a última revisão que não têm nenhuma, por exemplo "SN 1–49 a partir de 2027-07-01".
- Liberação e linhas de base: uma configuração não pode ser definida como Released nem ter linha de base criada enquanto duas das revisões dela se sobrepõem: CFG-1 não pode ser Released: A-20A e A-20B estão ambas em vigor para SN 50–99 de 2027-06-01 até 2027-07-01. Altere a efetividade de uma revisão e depois libere.
Sobreposições e lacunas são checadas dentro de cada configuração à qual as duas revisões se aplicam, dentro da efetividade própria dessa configuração.
Documentos, RVTM e verificação
Exportar um documento para uma configuração
Em um projeto com pelo menos uma configuração, um modelo do Word em Entregar ▾ (como Especificação (Word)) e ⌘K / Ctrl+K Exportar documento para Word abrem primeiro uma breve caixa de diálogo Exportar para Word. Projetos sem configurações exportam com um clique, como antes.
- Configuração: Todas as configurações, ou uma configuração ("CFG-2 EO-1 Lite"). As configurações Retired aparecem por último, marcadas como "(Retired)". A escolha começa com a configuração que sua aba exibe.
- Efetividade: Qualquer unidade, Número de série (como 23; "SN 23" também funciona) ou Data. Começa com o ponto da visão.
- Mostrar aplicabilidade (somente em Todas as configurações, ativado por padrão): adiciona "Aplica-se a: CFG-1, CFG-3" sob cada seção que apenas algumas configurações têm. As configurações Retired não são contadas.
Todas as exportações… → Documento (Word) tem as mesmas opções no grupo Linha de produtos (não para uma exportação de linha de base).
O documento de uma configuração contém:
- Somente as seções que se aplicam à configuração e estão em vigor na unidade ou data escolhida, com os valores próprios da configuração.
- Uma seção sob uma seção omitida sobe para a seção mais próxima que é mantida.
- Números da visão: um item depois de uma irmã omitida é renumerado no mesmo estilo (4 passa a 3, e 4.1 passa a 3.1). Os números armazenados não mudam. O arquivo diz "Numeração como mostrada em CFG-2." sob o título.
- Na página de rosto e no rodapé: "Configuração CFG-2 EO-1 Lite · Número de série 23" (ou "· Efetivo em 2027-03-01"). Um modelo do Word da empresa pode posicioná-lo com o campo
{{Configuration}}. - O nome do arquivo nomeia a configuração: "SRS – CFG-2 EO-1 Lite.docx".
- Sem unidade ou data, uma seção com efetividade mostra a etiqueta dela sob o título, como "Efetivo a partir de SN 21".
Imprimir ou salvar um PDF em uma visão de configuração também coloca a configuração e o ponto no rodapé impresso.
A estrutura do documento
- Em uma visão de configuração, a estrutura mostra os números da visão. Renumerar… e Renumerar a partir daqui… ficam desativados: "Os números são compartilhados por todas as configurações. Renumere em Todas as configurações." A renumeração automática após adições e movimentações fica desativada em uma visão.
- Visão ▾ → Colunas oferece as colunas Aplica-se a e Efetividade assim que o projeto as usa.
- A exportação ReqIF de um documento grava Applies To e efetividade como atributos de texto. A caixa de diálogo diz "Applies To e a efetividade são exportados como atributos de texto. Os valores de configuração não são exportados."
RVTM
- Em uma visão de configuração: os requisitos e resultados da configuração, de modo que "verificado" significa verificado para aquele produto. A coluna # mostra os números da visão. Exportar ▾ nomeia a configuração no nome do arquivo ("RVTM – CFG-2 EO-1 Lite.csv") e no título do Word.
- Em Todas as configurações: um grupo de colunas Configuração com um status consolidado por configuração que não esteja desativada. "—" significa que o requisito não faz parte daquela configuração (dica de ferramenta "Não se aplica a CFG-1"). As exportações para CSV e Excel adicionam uma coluna "Status em CFG-1" por configuração ("Não se aplica" quando ele não faz parte dela).
- Coluna de efetividade: uma alternância, oculta por padrão, mantida por aba.
- Só os resultados próprios de uma configuração contam. Um resultado registrado sem configuração (antes de a configuração existir, ou em Todas as configurações) não verifica nenhuma configuração. Em uma configuração, o caso de teste aparece como não executado, e o status do requisito diz "Um resultado sem configuração (TC-1) não conta para CFG-2." A mesma nota está na dica de ferramenta da coluna da configuração, nas exportações e nos documentos gerados para uma configuração. Para verificar a configuração, execute o teste novamente enquanto a visualiza.
- Em um número de série: o status vem da execução mais recente registrada para esse número de série (Test Article "23", "SN 23" ou "SN-0023") na configuração visualizada, com a nota "Resultados registrados primeiro para o SN 23". Os casos de teste sem tal execução mantêm o status. As exportações usam os mesmos status.
Central de testes
- Executar suíte em uma visão de configuração diz "Registrando resultados para CFG-2." e preenche Configuração / build com "CFG-2 EO-1 Lite". Em um número de série, também preenche Artigo de teste. Os resultados são salvos como valores dessa configuração, de modo que um caso de teste contém um resultado por configuração.
- Importar resultados… em uma visão mostra a mesma nota e preenche os mesmos campos.
- Em Todas as configurações, Executar suíte e Importar resultados… pedem Registrar resultados para: escolha a configuração em que o teste foi executado, ou Nenhuma configuração (não verifica nenhuma). No início nada está escolhido, e nenhum resultado é registrado até que você escolha. Os resultados de uma configuração são salvos como valores dela, como em uma visão dela; um caso de teste que não está na configuração escolhida não é registrado e diz o motivo. Os resultados sem configuração são salvos como valores do caso de teste para Todas as configurações; uma visão de configuração os mostra como uma nota sob o status do caso de teste, não como o resultado dele.
- Um arquivo de resultados pode ter uma coluna Configuração. O valor de uma linha (o número, o nome ou ambos de uma configuração) registra essa linha para essa configuração; um valor que não nomeia nenhuma configuração pula a linha e a lista na caixa de diálogo.
- Reutilizar resultado… (sob o status de um caso de teste): conta um resultado de outra configuração para uma configuração em que o teste não foi executado, quando você pode justificar, por exemplo porque o mesmo projeto de unidade foi testado. Escolha o resultado a reutilizar (o resultado de uma configuração ou um resultado sem configuração), a configuração para a qual ele é (em uma visão de configuração, a visualizada; em Todas as configurações, qualquer configuração em que o caso de teste esteja e que não tenha resultado próprio) e digite uma Justificativa (obrigatória). O resultado é copiado para essa configuração com seu nome, a data e a justificativa, e um único Desfazer reverte tudo (aviso "Resultado de CFG-1 reutilizado para CFG-2.", com Desfazer).
- Um resultado reutilizado nunca é silencioso. Na configuração, ele mostra Reutilizado com "de CFG-1 por Ann Lee em 2026-10-28: same motor and cooler" sob o status do caso de teste; a RVTM da configuração diz "Resultado reutilizado de CFG-1 (TC-1): …" sob o status do requisito; em Todas as configurações, a coluna da configuração diz "reutilizado" (a justificativa é a dica de ferramenta); as exportações e os documentos gerados para a configuração adicionam a mesma nota; as Checagens do modelo o listam como ProductLine.17. Deixar de reutilizar o retira (o teste volta a mostrar Não executado), e executar o teste na configuração o substitui pelo resultado próprio da configuração.
- O atributo Configuration de um caso de teste sugere as configurações do projeto enquanto você o edita (inspetor, Visão do item, Executar suíte, Importar resultados). Ele continua sendo texto livre: um build como "Build 2.4.1" ainda funciona.
Diagramas e estudos de trade-off
- Mostrar aplicabilidade (barra de ferramentas do diagrama, projetos LML, em Todas as configurações): colore as formas dos itens com Aplica-se a ou efetividade e escreve a aplicabilidade deles abaixo delas, como "Aplica-se a F-4 · Efetivo a partir de SN 30". O ajuste é mantido por aba e não é oferecido dentro de uma visão de configuração.
- Estudos de trade-off → + A partir de configurações… (em Alternativas) adiciona as configurações da linha de produtos como alternativas, e um único Desfazer reverte tudo. As configurações Retired começam desmarcadas. Aviso: "2 alternativas adicionadas."
Linhas de base e solicitações de mudança
Fazem parte do plano Team. Sem ele, os comandos ficam desativados com "Linhas de base por configuração fazem parte do plano Team. Vale o plano do proprietário do projeto."
Linhas de base por configuração
- Abra Controle e revisões → Linhas de base e versões.
- Clique em Criar linha de base de uma configuração…. Enquanto você visualiza uma configuração, o botão diz Linha de base de CFG-2… e pula a escolha.
- Escolha a Configuração e digite um Nome (começa como "CFG-2 linha de base 1"). Clique em Salvar linha de base. O aviso diz "Linha de base de CFG-2 salva." A coluna Documento da tabela diz, por exemplo, "Configuração CFG-2 EO-1 Lite".
A linha de base registra a linha de produtos inteira, identificada com a configuração, e o ponto de efetividade quando você visualiza em um. Você pode compará-la e restaurá-la como qualquer linha de base. Ainda não disponível: um registro de definição liberada do veredicto, das escolhas e das aprovações da configuração.
Cada linha de base também registra o que o projeto usou de outros projetos: a liberação de cada biblioteca em uso e cada vínculo com um item de outro projeto, com a última alteração desse item naquele momento. Quando as Features vêm de uma biblioteca exibida, Comparar → Configuração ▾ resolve uma linha de base em relação à liberação da biblioteca que ela registrou, não à liberação em uso agora, de modo que um item que saiu da configuração com uma liberação mais nova aparece como alteração. Uma linha de base salva antes de as linhas de base registrarem as liberações de bibliotecas é resolvida em relação às liberações em uso agora, e a página informa isso. Restaurar uma linha de base não altera quais liberações de bibliotecas o projeto usa.
Comparar tem duas opções para linhas de produtos:
- Configuração ▾: compara o que uma configuração mostra. Escolhe as duas linhas de base mais recentes da configuração, ou a linha de base mais recente dela e o modelo atual.
- Comparar com ▾: compara duas configurações dentro da versão De, como "O que difere entre CFG-2 e CFG-1 em EO-1 Flight PDR".
Uma linha de base do projeto criada em uma visão de configuração ainda registra a linha de produtos inteira.
Solicitações de mudança
- A página de uma solicitação de mudança tem um cartão Configurações: "Altera itens em 2 de 4 configurações: CFG-2, CFG-3", com Mostrar por configuração (os itens alterados por configuração). Uma alteração de um valor base não conta para as configurações que têm valor próprio.
- As diferenças nomeiam os valores de configuração como "Mass (CFG-2)", "Description (CFG-2)" e "Em CFG-2", e listam alterações de "Aplica-se a" e "Efetividade".
- Responsáveis como aprovadores: quando o Owner de uma configuração alterada nomeia um membro do projeto, a solicitação também precisa da aprovação dessa pessoa. A linha da regra diz "O responsável por CFG-2 (Lee) deve aprovar: esta solicitação altera CFG-2.", e os leitores de tela ouvem "Aprovação necessária de Lee para CFG-2". Um Owner que não nomeia nenhum membro do projeto não adiciona regra.
- Controle de configuração: com o controle de mudanças ativado, uma configuração que está Released e na linha de base mais recente é controlada. Os valores próprios dela nos itens só mudam por meio de uma solicitação de mudança ("… liberada, na linha de base mais recente").
- Aplicabilidade de itens controlados: o Aplica-se a e a Efetividade de um item aprovado ou com linha de base, e colocá-lo em uma configuração ou tirá-lo dela em uma visão de configuração, só mudam por meio de uma solicitação de mudança, como os outros campos dele. O mesmo vale para um relacionamento cuja origem é controlada. No serviço hospedado, o servidor também checa as alterações feitas offline.
- Bibliotecas: as características e configurações de uma liberação de biblioteca montada contam em Aplica-se a, nas configurações e nas visões. Elas são somente leitura.
Checagens do modelo
Verificação → Checagens do modelo executa o conjunto de regras nativo Linha de produtos assim que um projeto tem uma Feature ou Configuration.
| Regra | Heading | Severidade |
|---|---|---|
| ProductLine.1 | Aplica-se a nomeia uma característica ou configuração inexistente | Erro |
| ProductLine.2 | Itens em nenhuma configuração | Aviso |
| ProductLine.3 | Configurações que violam uma regra ou estão incompletas | Erro |
| ProductLine.4 | Características que nenhuma configuração seleciona | Aviso |
| ProductLine.5 | Itens em uma configuração na qual o pai deles não está | Aviso |
| ProductLine.6 | Relacionamentos cujas pontas nunca estão em uma mesma configuração | Aviso |
| ProductLine.7 | Configurações com números de série sobrepostos | Aviso |
| ProductLine.8 | Efetividade fora das configurações do item | Aviso |
| ProductLine.9 | Valores para configurações em que o item não está | Aviso |
| ProductLine.10 | Requisitos não verificados em uma configuração | Aviso |
| ProductLine.11 | Conexões com uma ponta ausente em uma configuração | Aviso |
| ProductLine.13 | Revisões em vigor ao mesmo tempo | Aviso |
| ProductLine.14 | Unidades sem revisão em vigor | Aviso |
| ProductLine.15 | Resultados de teste sem configuração | Aviso |
| ProductLine.16 | Configurações Released com requisitos não verificados nelas | Erro |
| ProductLine.17 | Resultados de teste reutilizados de outra configuração | Aviso |
As regras de completude checam todas as configurações a partir de Todas as configurações, sem trocar a visão. ProductLine.10 nomeia as configurações em que um requisito não está verificado, como "Não verificado em CFG-2, CFG-3 (Released)". ProductLine.11 nomeia as configurações e a ponta ausente, como "Em CFG-2: A-11 Coolant pump não está na configuração". ProductLine.3 diz "Configuração Released." para uma liberada, e "Ela não pode ser Released até que isto seja corrigido." para um rascunho. ProductLine.16 lista os requisitos que uma configuração Released não verifica.
ProductLine.13 e 14 checam revisões vinculadas por supersedes (veja Revisões de um item): "Sobrepõe-se a A-20B para SN 50–99 de 2027-06-01 até 2027-07-01" em cada uma de duas revisões sobrepostas, e "Nenhuma revisão em vigor para SN 1–49 a partir de 2027-07-01" no item que elas decompõem.
ProductLine.15 lista os casos de teste cujo Status foi registrado sem configuração, com as configurações para as quais ele não conta, como "Passed sem configuração; não conta para CFG-2". Execute o teste novamente enquanto visualiza cada configuração.
ProductLine.17 lista os casos de teste cujo resultado conta para uma configuração por meio de Reutilizar resultado…, com a justificativa, como "CFG-2: Reutilizado de CFG-1 por Ann Lee em 2026-10-28: same motor and cooler". Revise a justificativa, ou execute o teste enquanto visualiza a configuração para substituir o resultado reutilizado.
Para ProductLine.9, Corrigir → Remover valores lista os valores, como "Mass (CFG-2): 1.520", e os remove, e um único Desfazer reverte tudo.
Na demonstração CubeSat EO-1, a característica Propulsion fica sem seleção de propósito: é o exemplo de ProductLine.4.
Pesquisa, importação e exportação
- Pesquisa e consultas:
appliesto:CFG-2encontra os itens que se aplicam a CFG-2;varies:yesencontra itens com valores de configuração. - JSON: mantém todos os campos.
- CSV: a exportação do Banco de dados adiciona quatro colunas depois das outras, Aplica-se a (como você o digitaria), Efetividade por número de série, Vigente a partir de e Vigente até, assim que o projeto usa linhas de produtos. A importação lê os mesmos títulos de coluna (etapa Mapear: o grupo Linha de produtos). Uma característica ou configuração desconhecida, um intervalo de série inválido ou uma data inválida é informado para aquela linha, e esse campo fica de fora.
- ReqIF: Applies To e efetividade como atributos de texto; os valores de configuração não são exportados.
- Valores inválidos de Aplica-se a ou de efetividade em um arquivo importado ficam de fora.
API REST e MCP
list_configurations(MCP) eGET …/configurations(REST) listam as características, as regras e as configurações com os veredictos delas.- As rotas de leitura e as ferramentas de leitura do MCP aceitam
configuration(número, nome ou id) eeffectivity(sn:23oudate:2027-03-01). A resposta é a visão dessa configuração. Sem eles, os itens trazemappliesTo,effectivitye osvaluesde configuração deles. - Ainda não disponível: as regras de Linha de produtos (ProductLine.1–9) nas Checagens do modelo pela API (
run_model_checks,GET …/model-checks). Execute-as em Verificação → Checagens do modelo. - As gravações aceitam
appliesToeeffectivity. Comconfiguration, uma gravação é feita como na visão dessa configuração; a proposta de um cliente de IA feita assim diz "Aplicar em CFG-2: os novos itens se aplicam a CFG-2; os valores alterados se tornam de CFG-2."
Veja API REST: Linhas de produtos para todos os campos e mensagens.
Planos
| Característica | Gratuito | Individual | Team |
|---|---|---|---|
| Ler um projeto como uma configuração pela API | ✓ | ✓ | ✓ |
| Página Linha de produtos, Ver como ▾, Aplica-se a, valores de configuração e efetividade, somente leitura | ✓ | ✓ | ✓ |
| Editar a linha de produtos: características, configurações, seleções, Aplica-se a, valores de configuração, efetividade, documentos e RVTM por configuração, gravações pela API | — | ✓ | ✓ |
| Linhas de base por configuração, Comparar por configuração, as configurações que uma solicitação de mudança altera, responsáveis por configurações | — | — | ✓ |
Vale o plano do proprietário do projeto. Um endereço de e-mail acadêmico ou uma organização de turma mantém todas as linhas.
Sem o plano, a linha de produtos fica somente leitura e nada é excluído:
- A página Linha de produtos mostra as características, as configurações, a matriz e os veredictos. Checar configurações, Exportar CSV e Ver como esta configuração de uma coluna funcionam. + Nova característica, + Nova configuração, a matriz e os comandos de linha e de coluna que alteram algo ficam desativados. A página diz "Somente leitura: editar linhas de produtos faz parte dos planos Individual e Team. Vale o plano do proprietário do projeto." com Escolher plano….
- Ver como ▾ mostra uma configuração em somente leitura. O banner diz a mesma frase.
- O inspetor mostra Aplica-se a, a efetividade e os valores de configuração em somente leitura. Os itens Feature e Configuration ficam somente leitura.
- ⌘K / Ctrl+K Nova característica…, Nova configuração… e Iniciar uma linha de produtos… continuam listados e dizem por que não são executados.
- As exportações mantêm todos os campos. Um novo uso é recusado com "As linhas de produtos fazem parte dos planos Individual e Team. Vale o plano do proprietário do projeto." Um responsável por configuração sem o plano Team: "Responsáveis por configurações fazem parte do plano Team. Vale o plano do proprietário do projeto."
Projetos SysML v2
O SysML v2 tem a variabilidade embutida na linguagem: pontos de variação, variantes e configurações (usos de @HolarchConfiguration). Um projeto SysML v2 usa a mesma página Linha de produtos e o mesmo controle Ver como ▾:
- Página Linha de produtos: a árvore de pontos de variação, a matriz de configurações com uma linha Veredicto, as Regras (as restrições assert da linha de produtos, somente leitura, com Abrir no Editor), Inserir ponto de variação… (abre o Editor), Checar configurações e + Nova configuração. Escolher uma variante grava, por exemplo,
part :>> charger = charger::wallbox;na configuração. - Ver como ▾: lista as configurações de cada linha de produtos com os veredictos delas. Todas as visões, o Banco de dados, o inspetor e a página Linha de produtos o acompanham.
- No Free, a página Linha de produtos fica somente leitura como em um projeto LML: Inserir ponto de variação…, + Nova configuração e as escolhas da matriz ficam desativados, e Nova configuração… no Navegador, no inspetor e em ⌘K / Ctrl+K diz o motivo. O texto do modelo continua editável no Editor.
- Editar em uma visão de configuração (Individual e Team; somente leitura no Free): cada edição é uma edição de texto SysML v2 checada pelo checker, e um único Desfazer reverte tudo. Um atributo alterado se torna o valor próprio da configuração; novas parts pertencem à configuração; excluir um elemento opcional herdado grava
part :>> roofBox[0];. - Os dados do Holarch ao lado do modelo, como riscos e tarefas, se aplicam a todas as configurações, exceto os itens criados enquanto uma configuração é mostrada: eles se aplicam a essa configuração. Editar o Aplica-se a deles ainda não está disponível em projetos SysML v2. A efetividade é definida em elementos do modelo e em configurações (a seção Efetividade do inspetor).
- Ainda não disponível: Criar uma cópia SysML v2… de um projeto LML deixa de fora as características e configurações dele (o relatório as lista em Não convertido). Modele as variantes novamente na cópia.
Veja Variantes e configurações em SysML v2.
Limites
- Aplica-se a: no máximo 2.000 caracteres, 200 termos e 32 níveis de parênteses.
- Números de série: no máximo 200 intervalos, números até 1.000.000.000.000.
- Nome, Número, Classe, Rótulos, Responsável e estrutura não podem diferir por configuração.
- Cada estrutura (pais e ordem) é compartilhada por todas as configurações. Ainda não disponível: uma estrutura por configuração.
- As exportações ReqIF deixam de fora os valores de configuração.
- Ainda não disponível: um prefixo de série do projeto, e Aplica-se a em relacionamentos no painel de relacionamentos.
- Ainda não disponível: efetividade que distinga datas de aprovação, de vigência, conforme construído e de retrofit. A efetividade é uma lista de intervalos de números de série e um intervalo de datas de fabricação.
- Ainda não disponível: uma linha de base de configuração como definição liberada. Ela registra a linha de produtos identificada com a configuração, não o veredicto, as escolhas e as aprovações da configuração como um registro separado.
- Ainda não disponível: converter características e configurações ao criar uma cópia SysML v2 de um projeto LML.
- As expressões não contêm números de série nem datas; use a efetividade para isso.