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.
Nesta página
- Visão geral
- Conceitos
- Como usá-lo
- Quando e por quê
- Marcar um ponto de variação
- Adicionar uma regra
- Criar uma configuração
- Alterar as escolhas de uma configuração
- Mostrar o modelo como uma configuração
- Comparar configurações em um estudo de trade-off
- Exemplo prático: a demonstração Hybrid Car
- Dicas e boas práticas
- Erros comuns
- Como se conecta a outros recursos
- Navegador
- Inspetor
- Ver como configuração
- Mensagens
- Limites
- 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, comopart 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:
| Veredito | Significado |
|---|---|
| Válida | Uma variante é escolhida para cada ponto, e todas as regras são atendidas. |
| Viola a regra … | Uma regra é violada; o veredito a nomeia. |
| Incompleta | Um ponto ainda não tem variante escolhida; o veredito o nomeia. |
| Desconhecido | Uma 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
- Abra o Editor e o pacote que contém o projeto.
- Dentro da definição da linha de produtos, escolha Inserir ▾ → Variação. Preencha o nome e o tipo do ponto.
- Dentro da variação, escolha Inserir ▾ → Variante uma vez para cada escolha.
- 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
- 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 }. - 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
- 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.
- Escolha Nova configuração….
- Confira Configura: a linha de produtos a que a configuração pertence.
- Digite um Nome, como
longRangeHybrid. - 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.
- 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
- Selecione a configuração no Navegador (ou em uma visão).
- 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
- 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.
- 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
- Abra Riscos, problemas e decisões → Estudos de trade-off e um estudo (ou clique em + Novo estudo de trade-off).
- Em Alternativas, clique em + A partir da linha de produtos….
- Em De, escolha Configurações de … (uma linha de produtos) ou Variantes de … (um ponto de variação).
- 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.
- Abra Modelo → Navegador e expanda Vehicles.
BatteryPackeCarLinetêm os ícones de linha de produtos;CarLinetem um grupo Configurações comlongRangeHybrid,plugInHybrideselfChargingHybrid. - Selecione
CarLine. A seção Linha de produtos lista os pontospack(standardPack, largePack) echarger(noCharger, wallbox), a regrawallboxNeedsLargePacke 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). - Selecione
selfChargingHybride mude charger para wallbox. O veredito passa a ser Viola a regra wallboxNeedsLargePack. Pressione ⌘Z / Ctrl+Z para desfazer. - Abra a visão
carLineVariants(Diagramas). Escolha Ver como ▾ → plugInHybrid. A caixaBatteryPackmantém apenaslargePack, e a caixaCarLinemostra pack : BatteryPack = largePack e variation charger : Component = wallbox. - 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ãolargePackWallbox). - 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
| Mensagem | O 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 recusada | Ela 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.
Páginas relacionadas
- Notação textual SysML v2: variações, variantes e configurações
- Vistas SysML v2
- Análise SysML v2: estudos de trade-off
SysML® e OMG® são marcas registradas da Object Management Group, Inc. nos Estados Unidos e em outros países.