Holarch

SysML v2

Variantes e configurações em SysML v2

Modele uma linha de produtos em um projeto SysML v2: pontos de variação, variantes, regras e configurações no Navegador e no inspetor, Nova configuração…, vistas mostradas como uma configuração e estudos de trade-off de configurações.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. Pontos de variação e variantes
    2. Linhas de produtos
    3. Regras
    4. Configurações
  3. Como usá-lo
    1. Quando e por quê
    2. Marcar um ponto de variação
    3. Adicionar uma regra
    4. Criar uma configuração
    5. Alterar as escolhas de uma configuração
    6. Mostrar o modelo como uma configuração
    7. Comparar configurações em um estudo de trade-off
    8. Exemplo prático: a demonstração Hybrid Car
    9. Dicas e boas práticas
    10. Erros comuns
    11. Como se conecta a outros recursos
  4. Navegador
  5. Inspetor
    1. Linha de produtos
    2. Configuração
    3. Ponto de variação e variante
  6. Ver como configuração
  7. Mensagens
  8. Limites
  9. Páginas relacionadas

Visão geral

Uma linha de produtos é um projeto com alguns pontos em que seus produtos diferem, como o tamanho da bateria ou a presença de um carregador. Você modela a linha uma vez e depois examina, checa e compara qualquer produto sem copiar o modelo.

O SysML v2 traz isso embutido na linguagem. O Holarch o mostra em todo o aplicativo:

  • O Navegador marca linhas de produtos, pontos de variação, variantes e configurações, e lista as configurações de cada linha de produtos.
  • O inspetor mostra os pontos, as regras e as configurações de uma linha de produtos com um veredito para cada uma, e permite alterar as escolhas de uma configuração.
  • Nova configuração… cria uma configuração a partir de uma caixa de diálogo que checa as regras enquanto você escolhe.
  • Ver como ▾ na barra superior mostra as visões, o Banco de dados, o inspetor e a página Linha de produtos como uma configuração.
  • Os Estudos de trade-off podem comparar as configurações de uma linha de produtos ou as variantes de um ponto.

A variabilidade no texto está disponível em todos os planos. No plano Free, a página Linha de produtos, Nova configuração… e a alteração das escolhas de uma configuração no inspetor são somente leitura; editá-las faz parte dos planos Individual e Team. Consulte Linhas de produtos: Planos.

Conceitos

Pontos de variação e variantes

Um ponto de variação é um lugar do projeto em que os produtos diferem. Suas variantes são as escolhas permitidas.

  • Um uso de variação é um ponto dentro de um projeto: variation part charger : Component { variant part noCharger; variant part wallbox; }.
  • Uma definição de variação é um conjunto reutilizável de escolhas: variation part def BatteryPack { variant part standardPack; variant part largePack; }. Um uso tipado por ela, como part pack : BatteryPack;, também é um ponto.

Linhas de produtos

Uma linha de produtos é uma definição ou um uso que possui ou herda pontos de variação. Na demonstração Hybrid Car, CarLine é a linha de produtos: ela especializa Car e adiciona os pontos pack e charger. Uma definição que especializa uma linha de produtos também é uma linha de produtos.

Regras

Uma regra é um assert constraint da linha de produtos. Ela exclui combinações de variantes. Na demonstração, wallboxNeedsLargePack diz que o carregador wallbox precisa do pack grande:

assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }

Enquanto um ponto não tem escolha, uma regra sobre ele não é nem atendida nem violada: seu veredito é desconhecido.

Configurações

Uma configuração é um produto da linha. É um uso tipado pela linha de produtos que vincula uma variante a cada ponto. O Holarch a marca com @HolarchConfiguration (pacote HolarchVariability), para que o Editor aponte cada ponto que ela ainda não escolheu:

part plugInHybrid : CarLine {
  @HolarchConfiguration;
  part :>> pack = BatteryPack::largePack;
  part :>> charger = charger::wallbox;
}

Cada configuração tem um veredito:

VereditoSignificado
VálidaUma variante é escolhida para cada ponto, e todas as regras são atendidas.
Viola a regra …Uma regra é violada; o veredito a nomeia.
IncompletaUm ponto ainda não tem variante escolhida; o veredito o nomeia.
DesconhecidoUma regra não pôde ser avaliada, por exemplo porque falta um valor que ela lê.

O Holarch também conta as combinações de variantes e quantas delas as regras permitem. Para uma linha de produtos muito grande, ele checa apenas as primeiras combinações e informa quantas checou.

Como usá-lo

Quando e por quê

Use a variabilidade quando vários produtos compartilham a maior parte de um projeto: versões de acabamento de um veículo, versões de exportação, conjuntos de sensores, um produto com e sem um opcional. Modele o projeto compartilhado uma vez, marque os pontos em que os produtos diferem e adicione uma configuração por produto. Cada produto então acompanha toda alteração do projeto compartilhado.

Marcar um ponto de variação

  1. Abra o Editor e o pacote que contém o projeto.
  2. Dentro da definição da linha de produtos, escolha Inserir ▾ → Variação. Preencha o nome e o tipo do ponto.
  3. Dentro da variação, escolha Inserir ▾ → Variante uma vez para cada escolha.
  4. Para reutilizar um conjunto de escolhas, escolha Inserir ▾ → Variação no nível do pacote. Isso escreve uma definição de variação; tipe uma part por ela.

O Navegador agora mostra a linha de produtos com o ícone de caixas empilhadas, e o ponto com um losango.

Adicionar uma regra

  1. Dentro da definição da linha de produtos, escreva um assert constraint sobre seus pontos, por exemplo assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }.
  2. Selecione a linha de produtos no Navegador.

Você vê a regra em Regras, na seção Linha de produtos do inspetor, e o número de combinações que ela exclui.

Criar uma configuração

  1. No Navegador, abra o menu da linha (⋯, clique com o botão direito ou Shift+F10) da linha de produtos ou do seu grupo Configurações.
  2. Escolha Nova configuração….
  3. Confira Configura: a linha de produtos a que a configuração pertence.
  4. Digite um Nome, como longRangeHybrid.
  5. Em Escolhas de variante, escolha uma variante para cada ponto de variação. Você vê o veredito abaixo das escolhas imediatamente, por exemplo Válida: atende a todas as regras ou Viola a regra wallboxNeedsLargePack.
  6. Clique em Criar.

A configuração é escrita no texto depois da última configuração da linha de produtos, marcada com @HolarchConfiguration, e um único Desfazer reverte tudo. O Navegador a seleciona no grupo Configurações da linha de produtos.

Você também pode abrir a caixa de diálogo com Nova configuração… na seção Linha de produtos do inspetor, ou a partir de ⌘K / Ctrl+K.

Alterar as escolhas de uma configuração

  1. Selecione a configuração no Navegador (ou em uma visão).
  2. Na seção Configuração do inspetor, escolha outra variante na lista de um ponto.

A vinculação no texto é reescrita (part :>> pack = BatteryPack::standardPack;) e o veredito é atualizado; um único Desfazer reverte tudo. Escolha Não escolhido para remover a escolha. Uma escolha que adicionaria um erro ao modelo é recusada com o motivo.

Mostrar o modelo como uma configuração

  1. Na barra superior, clique em Ver como ▾ (ele mostra Todas as configurações ▾ até você escolher uma) e escolha uma configuração. Um banner abaixo da barra superior diz, por exemplo, Visualizando a configuração plugInHybrid. e quantos elementos se aplicam. Nas Visões gerais, de interconexão e de grade, as variantes que ela não escolhe e as outras configurações ficam ocultas, e cada ponto de variação mostra sua escolha, como pack : BatteryPack = largePack. O Banco de dados, o inspetor e a página Linha de produtos seguem a mesma escolha.
  2. Para voltar, escolha Ver como ▾ → Todas as configurações ou clique em Sair no banner.

Nos planos Individual e Team, você pode editar enquanto uma configuração é mostrada; cada edição é uma edição de texto SysML v2, checada antes de ser aplicada, e um único Desfazer reverte cada uma:

  • Escolher uma variante escreve a vinculação na configuração (part :>> pack = BatteryPack::largePack;).
  • Um valor de atributo alterado se torna o valor próprio da configuração; a definição mantém seu valor.
  • Novas parts e ações pertencem à configuração.
  • Excluir um elemento herdado que pode ser omitido escreve part :>> roofBox[0]; na configuração. Um elemento herdado obrigatório não pode ser excluído ali; altere-o no Editor.
  • Um risco, tarefa ou outro item do Holarch que você cria se aplica à configuração.

No plano Free, a visualização de configuração é somente leitura. No inspetor de uma configuração, Mostrar na visão ▾ abre uma visão da sua linha de produtos mostrada como essa configuração.

Comparar configurações em um estudo de trade-off

  1. Abra Riscos, problemas e decisões → Estudos de trade-off e um estudo (ou clique em + Novo estudo de trade-off).
  2. Em Alternativas, clique em + A partir da linha de produtos….
  3. Em De, escolha Configurações de … (uma linha de produtos) ou Variantes de … (um ponto de variação).
  4. Desmarque os itens que você não quer e clique em Adicionar.

Cada configuração ou variante se torna uma alternativa, vinculada ao elemento do modelo. Adicione critérios e valores como em qualquer estudo de trade-off, ou use Obter valores do modelo.

Exemplo prático: a demonstração Hybrid Car

Crie a demonstração com Arquivos de projeto ▾ → Novo projeto de demonstração → Hybrid Car (SysML v2) em Gerenciar projetos.

  1. Abra Modelo → Navegador e expanda Vehicles. BatteryPack e CarLine têm os ícones de linha de produtos; CarLine tem um grupo Configurações com longRangeHybrid, plugInHybrid e selfChargingHybrid.
  2. Selecione CarLine. A seção Linha de produtos lista os pontos pack (standardPack, largePack) e charger (noCharger, wallbox), a regra wallboxNeedsLargePack e as três configurações, todas Válida. Ela informa 4 combinações: 3 permitidas pelas regras, 1 excluída (o wallbox com o pack padrão).
  3. Selecione selfChargingHybrid e mude charger para wallbox. O veredito passa a ser Viola a regra wallboxNeedsLargePack. Pressione ⌘Z / Ctrl+Z para desfazer.
  4. Abra a visão carLineVariants (Diagramas). Escolha Ver como ▾ → plugInHybrid. A caixa BatteryPack mantém apenas largePack, e a caixa CarLine mostra pack : BatteryPack = largePack e variation charger : Component = wallbox.
  5. Abra Estudos de trade-off → Configuration Line-up (TR-2). Suas alternativas são as três configurações, pontuadas por preço, autonomia elétrica e conveniência de recarga.

Dicas e boas práticas

  • Mantenha o projeto compartilhado na linha de produtos e apenas as diferenças nas variantes. Uma variante redefine o que altera (attribute :>> capacity = 12 [kW*h];).
  • Escreva regras assim que souber que uma combinação não é permitida. Os vereditos então pegam uma configuração ruim imediatamente.
  • Dê às configurações o nome do produto, não das escolhas (plugInHybrid, não largePackWallbox).
  • Use uma visão por linha de produtos e alterne-a entre as configurações, em vez de uma visão por configuração.

Erros comuns

  • Uma configuração não aparece sob sua linha de produtos. Ela precisa ser tipada pela linha de produtos (part x : CarLine). Confira seu Tipo no inspetor.
  • Um veredito continua Desconhecido. Uma regra lê um valor que não tem valor nesta configuração. Escolha uma variante para cada ponto ou dê ao valor um padrão.
  • Uma escolha é recusada. A variante não é uma das variantes daquele ponto. Escolha na lista do inspetor ou corrija o nome no texto.

Como se conecta a outros recursos

  • Editor: Inserir ▾ escreve Variação, Variante, Configuração e Escolha de variante. Tudo aqui é texto SysML v2 comum, então importações, exportações e outras ferramentas SysML v2 o leem.
  • Estudos de trade-off: configurações e variantes como alternativas.
  • Diagramas de blocos de confiabilidade: as variantes de um ponto de variação são alternativas, então o diagrama conta apenas a variante escolhida pela configuração em Ver como ▾. Com todas as configurações mostradas, o ponto é um bloco com seus próprios valores, e o painel pede que você escolha uma configuração.
  • Checagens do modelo: Verificação → Checagens do modelo aponta cada configuração que viola uma regra ou deixa um ponto de variação sem variante (ProductLine.3, um erro). A nota é o veredito, como Viola a regra wallboxNeedsLargePack, e as regras violadas são listadas como elementos relacionados. Corrigir → Abrir item abre a configuração. A API e o MCP informam a mesma constatação (run_model_checks, GET …/model-checks).
  • Solicitações de mudança e histórico: toda alteração é uma alteração comum do modelo, e um único Desfazer reverte cada uma.

Navegador

  • Ícones: caixas empilhadas para uma linha de produtos, um losango para um ponto de variação, um losango cheio para uma variante, controles deslizantes para uma configuração. Cada ícone tem uma dica.
  • Grupo Configurações: o primeiro membro da linha de uma linha de produtos. Ele lista as configurações da linha de produtos onde quer que estejam declaradas; cada linha ali representa a própria configuração. O menu da linha dele tem Nova configuração….
  • Menu da linha: Nova configuração… em uma linha de produtos e em cada uma de suas configurações.
  • Leitores de tela: o nome de uma linha diz o que ela é, por exemplo CarLine, part def, linha de produtos ou plugInHybrid, part, configuração de CarLine.

Inspetor

Linha de produtos

  • Pontos de variação: cada ponto com as variantes entre as quais escolhe.
  • Regras: os assert constraints da linha de produtos, ou Sem regras: toda combinação de variantes é permitida.
  • Configurações: uma tabela das configurações e de seus vereditos.
  • Combinações: quantas combinações de variantes existem e quantas as regras permitem, excluem ou deixam desconhecidas.
  • Nova configuração…

Configuração

  • Configura: a linha de produtos.
  • Status: o veredito, anunciado aos leitores de tela quando muda.
  • Uma lista por ponto de variação: a variante escolhida, ou Não escolhido. Um único Desfazer reverte uma alteração.
  • Regras: cada regra como Atendida, Violada ou Desconhecida.
  • Mostrar na visão ▾: as Visões gerais, de interconexão e de grade que mostram a linha de produtos, abertas como esta configuração.

Ponto de variação e variante

  • Um ponto de variação lista suas Variantes e, em Escolhido por, o que cada configuração escolhe.
  • Uma variante mostra de que ela é Variante de e quais configurações a escolhem.

Ver como configuração

  • Onde: a barra superior, assim que o modelo tiver uma configuração. Uma escolha por aba do navegador: as Visões gerais, de interconexão e de grade, o Banco de dados, o inspetor e a página Linha de produtos a seguem.
  • Controle: Ver como ▾ (ele mostra Todas as configurações ▾ até você escolher uma). O menu lista Todas as configurações, as configurações de cada linha de produtos com seus vereditos, Efetividade ▸ (mostrar o modelo em um número de série, uma data de fabricação ou ambos: Número de série e data… é uma unidade com aquele número de série fabricada naquela data) e Gerenciar linha de produtos. O banner abaixo da barra superior tem Alterar ▾ e Sair.
  • O que muda: as variantes que a configuração não escolhe e as outras configurações da mesma linha de produtos ficam ocultas, com o que possuem. Os pontos de variação mostram sua escolha. Os layouts não são reorganizados e são compartilhados por todas as configurações.
  • Edição: planos Individual e Team. As edições seguem as regras de Mostrar o modelo como uma configuração. No plano Free, e para pessoas com acesso de visualização, a visão é somente leitura e o banner diz o motivo.
  • Grade: a Tabela deixa de fora os elementos ocultos e nomeia as escolhas acima da tabela. A Matriz mostra a linha de produtos inteira.
  • Por aba: a escolha é mantida para a aba do navegador até você alterá-la. As imagens da visão na lista Diagramas mostram a linha de produtos inteira.
  • Leitores de tela: a troca anuncia a configuração e quantos elementos se aplicam, por exemplo Visualizando a configuração plugInHybrid. … elementos se aplicam., com Somente leitura. acrescentado quando você não pode editar.

Mensagens

MensagemO que fazer
O modelo ainda não tem pontos de variação. Adicione uma variação no Editor (Inserir ▾ → Variação) e tente novamente.Marque primeiro um ponto de variação.
O modelo ainda não tem configurações nem variantes. … (+ A partir da linha de produtos…)Adicione primeiro um ponto de variação ou uma configuração.
Digite um nome para a configuração.Digite um nome em Nome.
… já está em uso em …. Escolha outro nome.Outro elemento do mesmo pacote tem esse nome.
Os nomes têm de 1 a 1.000 caracteres e nenhuma quebra de linha. Altere o nome.Encurte o nome ou remova a quebra de linha.
Uma escolha ou configuração recusadaEla adicionaria um erro ao modelo; a mensagem nomeia o erro. Corrija o texto ou escolha outra variante.
O checador SysML não está disponível, então os pontos de variação não podem ser lidos.Recarregue a página ou crie a configuração no Editor com Inserir ▾ → Configuração.

Limites

  • Para uma linha de produtos muito grande, a contagem de combinações checa apenas as primeiras combinações; as configurações são sempre checadas por completo.
  • No plano Free, uma visão mostrada como uma configuração é somente leitura.
  • Ainda não: liberar ou desativar uma configuração SysML v2. Toda configuração SysML v2 é Rascunho, então o controle de configuração não bloqueia nenhuma.
  • A variabilidade abrange o modelo SysML v2. Os itens do Holarch ao lado dele (riscos, testes, tarefas, seções de documentos) se aplicam a todas as configurações, exceto os criados enquanto uma configuração é mostrada: esses se aplicam àquela configuração. O Applies To deles ainda não pode ser editado em um projeto SysML v2.

SysML® e OMG® são marcas registradas da Object Management Group, Inc. nos Estados Unidos e em outros países.