Holarch

SysML v2

Requisitos y verificación en proyectos SysML v2

Escriba, compruebe, apruebe y siga los requisitos y los casos de verificación de un modelo SysML v2 con las páginas Requisitos, Calidad, TBD/TBR, Vínculos que revisar, Aprobaciones, RVTM, Casos de verificación y Matriz de trazabilidad.

Cómo usarlo →

En esta página
  1. Resumen
  2. Conceptos
    1. Requisitos en el modelo
    2. Umbral y objetivo
    3. Relaciones
    4. Casos de prueba y suites de pruebas
    5. TBD y TBR
  3. Cómo usarlo
    1. Cuándo y por qué
    2. Escribir un requisito
    3. Escribir requisitos en un documento
    4. Comprobar la calidad
    5. Aprobar requisitos
    6. Establecer un umbral y un objetivo
    7. Marcar un valor como TBD o TBR
    8. Cerrar un TBD o TBR
    9. Revisar vínculos modificados
    10. Planificar y ejecutar la verificación
    11. Ejemplo práctico: la demostración Hybrid Car
    12. Consejos y buenas prácticas
    13. Errores habituales
    14. Cómo se relaciona con otras funciones
  4. Requisitos y Calidad
    1. Página Requisitos
    2. Página Calidad
  5. Control de cambios
    1. Vínculos por revisar
    2. Aprobaciones
    3. Registro TBD/TBR
  6. Páginas de verificación
    1. Casos de verificación
    2. RVTM
    3. Matriz de trazabilidad
    4. Comprobaciones del modelo
  7. Mensajes
  8. Límites
  9. Páginas relacionadas

Resumen

Un proyecto SysML v2 tiene las mismas páginas de requisitos y de verificación que un proyecto LML. Funcionan sobre el modelo: los requisitos son los elementos requirement del modelo, y los casos de prueba son sus casos verification.

Grupo de la barra de navegaciónPáginas
Necesidades y requisitosRequisitos, Calidad, TBD/TBR, Vínculos por revisar, Aprobaciones
VerificaciónRVTM, Casos de verificación, Matriz de trazabilidad, Comprobaciones del modelo

Casos de verificación es la página que los proyectos LML llaman Centro de pruebas.

Algunos datos son texto SysML, y otros son datos de Holarch guardados junto al modelo:

  • En el texto: el número (nombre corto), el nombre, la descripción (doc), el anidamiento, las relaciones satisfy, verify, dependency y de derivación, y los valores de atributos con sus unidades.
  • Datos de Holarch: Estado, Prioridad, Método de verificación y los demás atributos del requisito, las etiquetas, el estado de las pruebas, los resultados, los pasos y los ciclos de prueba. Otras herramientas de SysML v2 no los leen.

Conceptos

Requisitos en el modelo

Un requisito es un uso requirement o un requirement def. Holarch lee sus campos del texto:

Campo de HolarchTexto SysML v2
NúmeroEl nombre corto: <'VR-1'>
NombreEl nombre: CurbMass
DescripciónEl comentario doc: doc /* … */
Requisitos hijos (decomposed by)Requisitos que posee el requisito
requirement def <'VR-1'> CurbMass {
  doc /* The car's curb mass shall not exceed the mass limit. */
  subject car : Car;
  attribute limit : MassValue;
  require constraint { car.curbMass <= limit }
}

Las páginas muestran los nombres con mayúsculas iniciales, de modo que sedanMass se lee como Sedan Mass.

Umbral y objetivo

Un requisito es cuantitativo cuando una de sus restricciones require compara una magnitud con un valor: car.curbMass <= limit o range >= 800 [km]. El valor es el umbral, el valor mínimo aceptable. <= lo convierte en un límite superior (menos es mejor) y >= en un mínimo (más es mejor).

SysML v2 no tiene palabra clave para un objetivo, el valor al que se aspira más allá del umbral. Holarch lo escribe como el metadato @Objective del paquete de biblioteca HolarchRequirements (Biblioteca estándar, carpeta Holarch):

requirement def <'VR-1'> CurbMass {
  subject car : Car;
  attribute limit : MassValue;
  require constraint { car.curbMass <= limit }
  @Objective { value = 1600 [kg]; }
}
  • Un objetivo en una definición de requisito se aplica a cada uso de ella. Un uso puede dar el suyo propio.
  • El umbral puede ser un valor escrito en la restricción (12 [kg]) o un atributo que establece el requisito o una redefinición (attribute :>> limit = maxCurbMass;).
  • Otras herramientas de SysML v2 leen @Objective como un metadato corriente.
  • Presupuestos y TPM usa el umbral como la asignación de cada parte que satisface el requisito, y enumera el requisito en la pestaña TPM con su umbral y su objetivo (Presupuestos y TPM).

Relaciones

Relación de HolarchTexto SysML v2
satisfied bysatisfy carSpec by fleet.sedan;
verified byverify carSpec.sedanMass; en el objetivo de un caso de verificación
performed byperform o allocate
traced todependency
decomposed byPropiedad: un requisito que posee otro requisito

Añadir o quitar una de ellas en cualquier página cambia el texto, y un solo Deshacer lo revierte todo.

Casos de prueba y suites de pruebas

  • Un caso de prueba es un uso verification o un verification def.
  • Los requisitos que verifica son los miembros verify de su objetivo.
  • Un paquete que posee casos de verificación es una suite de pruebas.
verification def CurbMassTest {
  doc /* Weigh the car on a scale with full fluids and no driver. */
  subject car : Car;
  objective massObjective {
    verify carSpec.sedanMass;
  }
}

TBD y TBR

Un requisito está abierto (TBD o TBR) cuando se cumple cualquiera de estas condiciones:

  • Su atributo TBD/TBR es TBD o TBR.
  • TBD, TBR o TBS aparece en su nombre o en su doc.
  • Uno de los valores de sus atributos lleva metadatos TBD o TBR.

Escribir TBD en lugar de un valor no es SysML válido. En su lugar, marque el atributo con metadatos del paquete de biblioteca de Holarch HolarchMetadata (consulte Marcar un valor como TBD o TBR).

Cómo usarlo

Cuándo y por qué

Use estas páginas una vez escritos los primeros requisitos en el modelo, y siga usándolas durante la verificación:

  • Requisitos y Calidad mientras escribe: ¿está bien formulado cada requisito?
  • Aprobaciones en las revisiones: ¿quién ha dado su aprobación?
  • TBD/TBR y Vínculos por revisar mientras cambia el diseño: ¿qué sigue abierto y qué hay que volver a mirar?
  • Matriz de trazabilidad, Casos de verificación y RVTM mientras planifica y ejecuta la verificación: ¿está cada requisito satisfecho y verificado?

Escribir un requisito

  1. Abra Necesidades y requisitos → Requisitos.
  2. Haga clic en + Nuevo. Se añade un uso de requisito con el siguiente número, en el paquete Requirements.
  3. Escriba el nombre y la descripción en el inspector o en la tabla. El texto cambia de inmediato, y un solo Deshacer revierte cada edición.
  4. Establezca los datos de Holarch en el inspector, en las mismas secciones que para un requisito LML: Estado en la franja de revisión, y Prioridad, Criticidad y Responsable en Flujo de trabajo; Método de verificación y Nivel de verificación en Verificación; Justificación y Origen en Requirement. Son datos de Holarch; el texto no cambia. Cada edición se puede deshacer con un solo Deshacer, y la tabla Requisitos, la RVTM y la VCRM muestran los mismos valores.

También puede escribir requisitos en el Editor. Aparecen en la página Requisitos en cuanto el texto se puede analizar.

Escribir requisitos en un documento

Un documento puede contener los usos de requisito de un paquete.

  1. En un documento, elija Escribir ▾ → Paquete de requisitos… y seleccione el paquete. Un documento nuevo recibe un paquete con su nombre y su primer requisito.
  2. Añada, aplique sangría, reduzca la sangría y mueva requisitos como en los documentos LML.
    • Un requisito bajo una sección pertenece al paquete.
    • Un requisito bajo otro requisito está anidado en él.
    • El número es su nombre corto. Añadir, quitar o mover otros elementos solo renumera las secciones y nunca cambia un nombre corto; un requisito nuevo recibe su número de documento como nombre corto. Subir y Bajar intercambian los nombres cortos de los dos requisitos, y Renumerar… los cambia tras una vista previa.
  3. Los requisitos escritos en el Editor en ese paquete aparecen en el documento.

Quitar elimina un requisito del paquete tras una confirmación. Para sacar un requisito del documento sin eliminarlo, muévalo a otro paquete en el Editor.

Comprobar la calidad

  1. Abra Necesidades y requisitos → Calidad.
  2. Haga clic en Comprobar calidad. La descripción de cada requisito se puntúa según nueve criterios, con las mismas reglas que en los proyectos LML.
  3. Corrija primero las puntuaciones más bajas.

Una puntuación marcada como Desactualizado corresponde a un texto anterior. Vuelva a comprobar la calidad.

Aprobar requisitos

El estado de un requisito pasa de Borrador → En revisión → Aprobado o Rechazado.

  1. Establezca el estado de un requisito en En revisión. Aparece en Aprobaciones y, para los revisores, en Mi trabajo en Pendiente de revisión. Los revisores reciben una notificación.
  2. Como revisor, seleccione el requisito. El inspector muestra su estado con Aprobar, Rechazar… y Reabrir.
  3. Haga clic en Aprobar, o en Rechazar… con un motivo opcional. El inspector registra quién estableció el estado y cuándo.

Las personas con el rol Revisor pueden aprobar y rechazar. Editar el texto de un requisito Aprobado lo devuelve a En revisión.

Establecer un umbral y un objetivo

  1. Escriba el umbral como una restricción require que compara una magnitud con un valor, por ejemplo require constraint { battery.mass <= 50 [kg] }.
  2. Seleccione el requisito. El inspector muestra Umbral y objetivo con la Magnitud y el Umbral (Como máximo o Como mínimo).
  3. Escriba el valor al que se aspira en Objetivo, por ejemplo 45 kg, y pulse Enter.

    Holarch escribe @HolarchRequirements::Objective { value = 45 [kg]; } en el requisito. Vacíe el campo para quitarlo.

  4. Vincule el requisito a la parte que lo cumple con satisfy. El Editor señala cuándo la parte cumple el umbral pero no el objetivo.

Marcar un valor como TBD o TBR

  1. Importe el paquete de metadatos en el paquete del requisito: private import HolarchMetadata::*;.
  2. Escriba #TBD delante de un atributo cuyo valor está aún por determinar. Omita el valor o dé una estimación.
  3. Escriba #TBR delante de un atributo cuyo valor está por revisar.
  4. Para registrar quién es el responsable y por qué, use la forma larga en el cuerpo del atributo.
#TBR attribute limit : TimeValue = 0.5 [h];
attribute chargerPower : PowerValue {
  @TBD { owner = "Powertrain lead"; rationale = "The fast-charging standard is not chosen yet."; due = "2026-12-01"; }
}

Insertar ▾ → Valor TBD y Valor TBR en el Editor los escriben por usted. TBD y TBR especializan ModelingMetadata::StatusInfo, por lo que otras herramientas de SysML v2 los leen como anotaciones de estado. @StatusInfo { status = StatusKind::tbd; } también cuenta. El paquete aparece en Holarch en la Biblioteca estándar.

Cerrar un TBD o TBR

  1. Abra Necesidades y requisitos → TBD/TBR. Cada elemento abierto muestra su responsable, su fecha límite y su antigüedad, con un gráfico de evolución de los elementos abiertos.
  2. Introduzca el valor final en el texto o en el inspector y haga clic en Cerrar en la fila. El atributo TBD/TBR vuelve a Ninguno, y los metadatos TBD/TBR se quitan de los valores.

Las marcas en el doc se cierran cuando edita el doc. Exportar XLSX exporta el registro.

Cuando un requisito cambia, los vínculos que dependen de él se marcan para revisión como parte de ese cambio, y un solo Deshacer revierte ambas cosas.

  1. Abra Necesidades y requisitos → Vínculos por revisar. Cada vínculo muestra qué cambió, cuándo y quién lo cambió.
  2. Haga clic en Diferencias para ver el nombre y el doc anteriores y nuevos, o en Mostrar en el texto para abrir el requisito en el Editor.
  3. Compruebe el elemento vinculado. Actualícelo si ya no encaja.
  4. Haga clic en Marcar como revisado…, añada un comentario opcional y confirme.

Un elemento con un vínculo por revisar muestra también un aviso con Revisar… en el inspector y una insignia Revisar en las tablas. La vista Vínculos por revisar de la base de datos los enumera.

Planificar y ejecutar la verificación

  1. Abra Verificación → Casos de verificación.
  2. Haga clic en + Nuevo ▾ → Suite de pruebas… para añadir un paquete y después en + Nuevo ▾ → Caso de prueba… para añadir un uso de verificación.
  3. Vincule un requisito al caso de prueba. Se añade un verify al objetivo del caso de prueba.
  4. Añada pasos, ejecute la suite con Ejecutar suite y establezca el estado de cada caso de prueba. El estado, los resultados esperados y reales, los pasos y los ciclos son datos de Holarch.
  5. Abra Verificación → RVTM para ver cada requisito con su método de verificación, los casos de prueba que lo verifican y el estado acumulado de los subrequisitos.

Ejemplo práctico: la demostración Hybrid Car

Cree primero la demostración: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car (SysML v2). Sus requisitos están en el paquete VehicleRequirements.

  1. Abra Necesidades y requisitos → Requisitos. Entre ellos están VR-1 Curb Mass a VR-6 Battery Mass Limit, y el requisito carSpec con VR-1.1 Sedan Mass, VR-2.1 Sedan Acceleration y VR-4.1 Sedan Range debajo.
  2. Seleccione VR-1.1 Sedan Mass. Lo verifica el caso de verificación CurbMassTest, mediante el verify carSpec.sedanMass; de su objetivo.
  3. Abra TBD/TBR. VR-5 Charge Time está abierto: su limit lleva #TBR, y su chargerPower lleva @TBD con el responsable Powertrain lead.
  4. En el Editor, cambie maxCurbMass de 1650 [kg] a 1600 [kg]. VR-1.1 Sedan Mass usa maxCurbMass como límite, por lo que sus vínculos se marcan para revisión.
  5. Abra Vínculos por revisar. Aparece el vínculo verified by de VR-1.1 Sedan Mass. Haga clic en Diferencias, compruebe la prueba y después haga clic en Marcar como revisado….
  6. Abra Verificación → Matriz de trazabilidad con los requisitos como filas y los Assets como columnas. La celda de carSpec y fleet.sedan muestra satisfied by, a partir de satisfy carSpec by fleet.sedan;.

Consejos y buenas prácticas

  • Dé a cada requisito un nombre corto. Es el número en todas las páginas y en los documentos.
  • Escriba los valores como atributos, no en el doc. attribute :>> limit = maxCurbMass; se puede evaluar, comprobar con la vista paramétrica y seguir mediante los vínculos por revisar.
  • Marque los valores abiertos con #TBD o #TBR, no con «TBD» en el valor. El texto sigue siendo válido y el registro los encuentra.
  • Mantenga los casos de prueba en su propio paquete. Se convierte en una suite de pruebas en la página Casos de verificación.

Errores habituales

  • Esperar el estado en el texto. Estado, Prioridad y Método de verificación son datos de Holarch. Los archivos de intercambio no los contienen.
  • Escribir limit = TBD. No es SysML válido y el texto queda como borrador. Use #TBD attribute limit : TimeValue;.
  • Quitar un requisito de un documento para moverlo. Quitar lo elimina del modelo. En su lugar, muévalo a otro paquete en el Editor.

Cómo se relaciona con otras funciones

  • Vistas: una vista de requisitos dibuja los mismos requisitos y las mismas relaciones satisfy, verify, derive y refine (Vistas de SysML v2).
  • Simulador: Comprobar frente a requisito… toma su criterio de la restricción require de un requisito y registra el resultado en un caso de verificación (Evaluación, unidades y análisis).
  • Documentos: los bloques RTM, RVTM, VCRM, de derivación descendente y de matriz de asignación enumeran los requisitos del modelo.
  • Control de cambios: las líneas base contienen el modelo; Comparar enumera los cambios de los requisitos (Funciones de Holarch en proyectos SysML v2).

Requisitos y Calidad

Página Requisitos

Requisitos es la base de datos filtrada por la clase Requirement. Tiene los filtros, las vistas, las columnas, el modo de árbol, la edición en línea, las herramientas masivas y las exportaciones de la base de datos (Requisitos).

  • + Nuevo añade un uso de requisito con el siguiente número en el paquete Requirements.
  • Editar el número, el nombre o la descripción cambia el texto del modelo, y un solo Deshacer revierte cada cambio.
  • Las exportaciones de Tabla y Definiciones incluyen Tipo, Tipo, Multiplicidad y Valor, y en un modelo con individuales Individual, Porción e Instancias.
  • Al seleccionar un requisito, se muestra en el inspector de SysML v2. Su enlace lo abre en el Navegador.

No disponible para elementos del modelo: Cambiar clase, Duplicar, Bloquear y Copiar con hijos, y las exportaciones Datos del proyecto (JSON) y Paquete de proyecto (.holarch). Exportar proyecto… hace una copia de seguridad de todo el proyecto como .holarch.

Página Calidad

Calidad puntúa la descripción de cada requisito según los nueve criterios de los proyectos LML: Apropiado, Completo, Conforme, Correcto, Factible, Necesario, Singular, Inequívoco y Verificable (Calidad de los requisitos). La puntuación son datos de Holarch. Una puntuación marcada como Desactualizado corresponde a un texto anterior.

Fíltrela como en los proyectos LML (Filtrar la página Calidad): + Filtro con los grupos Calidad, No cumple un criterio y Hallazgo de regla, los atributos y etiquetas de los requisitos, los términos quality: escritos, el texto de búsqueda y Vistas ▾.

Control de cambios

Un vínculo requiere revisión cuando el elemento de su otro extremo cambió después de la última revisión del vínculo (en otras herramientas se llaman también vínculos sospechosos): compruebe que el vínculo sigue siendo válido y márquelo como revisado. Un cambio en un requisito marca para revisión estos vínculos: satisfied by (satisfy), verified by (verify), decomposed by (requisitos que posee) y traced to (dependency).

Un cambio es una edición de cualquiera de estos:

  • El nombre o el doc del requisito.
  • Un atributo clave: Prioridad, Criticidad, Método de verificación o Nivel de verificación.
  • El valor de un atributo que posee, como attribute :>> limit = maxCurbMass;, o una de sus restricciones.
  • Un atributo de destino que nombran esos valores o restricciones, como attribute maxCurbMass : MassValue = 1650 [kg];.

Cuenta dondequiera que lo haga: el Editor, una vista, el inspector o una tabla. Un Método de verificación o un Nivel de verificación cambiado solo marca para revisión los vínculos verified by, y establecer el primero no marca ninguno.

La página Vínculos por revisar tiene Diferencias, Mostrar en el texto y Marcar como revisado… por vínculo.

Aprobaciones

Aprobaciones enumera los requisitos En revisión. El inspector muestra el estado con Aprobar, Rechazar… y Reabrir, y quién lo estableció y cuándo. El estado son datos de Holarch junto al modelo; no forma parte del texto SysML.

Registro TBD/TBR

El registro enumera cada requisito abierto con su responsable, su fecha límite y su antigüedad, un gráfico de evolución de los elementos abiertos y Exportar XLSX. Cerrar devuelve el atributo TBD/TBR a Ninguno y quita los metadatos TBD/TBR de los valores.

La fecha límite es la única fecha límite del requisito, la misma fecha que Fecha límite en el grupo Flujo de trabajo del inspector y en la vista del elemento:

  1. El due más temprano de los metadatos @TBD/@TBR de los valores del requisito, como @TBD { owner = "Powertrain lead"; due = "2027-06-30"; }.
  2. Si no, el atributo TBD Due Date.
  3. Si no, la propia fecha límite del requisito.

El registro es de solo lectura. Cambie la fecha en el texto o establezca Fecha límite en el inspector. Fecha límite escribe due = "<date>"; en cada cuerpo de metadatos @TBD/@TBR del requisito (lo añade donde el cuerpo no lo tiene) y establece la fecha límite del requisito, y un solo Deshacer lo revierte todo. La forma de prefijo #TBD/#TBR no tiene cuerpo, por lo que un valor marcado solo de esa forma usa la fecha límite del requisito.

Páginas de verificación

Casos de verificación

Las suites, los casos de prueba, el estado, los pasos, los ciclos de prueba, Ejecutar suite y los informes funcionan como en los proyectos LML (Verificación).

  • + Nuevo ▾ → Caso de prueba… añade un uso de verificación; Suite de pruebas… añade un paquete.
  • Vincular un requisito añade un verify al objetivo del caso de prueba.
  • El estado, los resultados esperados y reales, los pasos y los ciclos son datos de Holarch guardados junto al modelo.

RVTM

Cada requisito con su método de verificación, los casos de prueba que lo verifican y el estado acumulado de los subrequisitos (RVTM). Un ⚠ marca un requisito cuyos vínculos satisfy, verify o de descomposición requieren revisión, y un caso de verificación cuyo vínculo verify requiere revisión.

Matriz de trazabilidad

Las filas, las columnas y la relación funcionan como en los proyectos LML (La matriz de trazabilidad).

  • Assets son los usos de parte (las partes del sistema), y Actions son los usos de acción.
  • Para un eje de clase, Elementos → Definiciones enumera en su lugar las definiciones.
  • Entre elementos del modelo, una celda puede contener satisfied by (satisfy), verified by (verify), performed by (allocate o perform), traced to (dependency) y decomposed by (propiedad). Las demás relaciones aparecen como no permitidas.
  • Cada clic se puede deshacer con un solo Deshacer y cambia el texto del modelo.

Comprobaciones del modelo

Las reglas que se aplican a un modelo se ejecutan (Comprobaciones del modelo), en términos de SysML v2:

  • usos de requisito sin nombre, sin nombre corto (requisitos hoja), sin descripción (propia o de su definición), sin satisfy o sin verify, y requisitos hoja sin «shall»;
  • nombres cortos repetidos, palabras vagas, valores en vivo que apuntan a destinos que faltan, vistas UAF que no se pueden mostrar;
  • riesgos abiertos de nivel superior sin mitigación, casos de verificación fallidos sin un Issue, TPM que incumplen su umbral;
  • los elementos junto al modelo (riesgos, tareas, decisiones, documentos) con el mismo nombre o sin relaciones.

El comprobador del Editor cubre nombres, tipos y estructura, por lo que las reglas de análisis funcional de LML (Action, Asset, Conduit e Input/Output) no se ejecutan y Ajustes solo enumera estas reglas. No se ofrecen correcciones de fusión para los elementos del modelo.

Mensajes

MensajeSignificado y solución
No disponible en proyectos SysML v2: cambie el modelo en el Editor.La acción solo funciona con entidades LML. Haga el cambio en el Editor.
No se aplicó el cambio.La edición dejaría el texto inválido. El mensaje junto a ella nombra el problema.
Desactualizado: vuelva a ejecutarEl texto del requisito cambió después de la última comprobación de calidad. Vuelva a comprobar la calidad.
“…” cumple “…”, pero … no alcanza el objetivo ….Información: la parte cumple el umbral pero no el objetivo. Mejore el diseño o cambie el objetivo.
“…” tiene un objetivo pero ningún umbral con el que compararlo. …El requisito tiene @Objective pero ninguna restricción require que compare una magnitud con un valor. Añada una.
“…” tiene más de un umbral (…), por lo que su objetivo es ambiguo. …El requisito compara más de una magnitud. Divídalo en un requisito por magnitud.
El objetivo … de “…” no está por debajo (por encima) de su umbral ….El objetivo debe ir más allá del umbral: por debajo de un límite superior, por encima de un mínimo.
El objetivo … de “…” está en …, pero su umbral … está en ….La unidad del objetivo es de otra magnitud que la del umbral. Use una unidad de la magnitud del umbral.
@Objective se aplica a requisitos, pero “…” es ….La anotación está fuera de un requisito. Muévala dentro de uno.

Límites

  • Estado, Método de verificación, los demás atributos de los requisitos, las etiquetas y los resultados de las pruebas son datos de Holarch. Los archivos de intercambio de SysML v2 no los contienen.
  • Cambiar clase, Duplicar, Bloquear y Copiar con hijos no están disponibles para los elementos del modelo.
  • En Comprobaciones del modelo no se ofrecen correcciones de fusión para los elementos del modelo.

SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.