Verificación
Comprobaciones del modelo
Ejecute 75 comprobaciones basadas en reglas y sus propios conjuntos de reglas sobre todo el modelo, acote los hallazgos por gravedad, clase, regla y etiqueta, corríjalos en el sitio, ignore los que son intencionados y defina el rigor de cada regla.
En esta página
Resumen
Verificación → Comprobaciones del modelo ejecuta un catálogo de reglas sobre cada elemento del proyecto y enumera lo que encuentra cada regla. Las reglas buscan carencias que hacen que un modelo sea difícil de confiar o de revisar: nombres y números que faltan, elementos aislados, acciones que nadie realiza, interfaces que no transportan nada, requisitos sin asignar o sin verificar, riesgos sin plan de tratamiento y medidas que no alcanzan su umbral.
Las comprobaciones se vuelven a ejecutar cada vez que cambia el modelo, así que la página, la tarjeta Comprobaciones del modelo de Inicio y el distintivo de Verificación siempre coinciden.
Conceptos
- Regla: una comprobación con un número (por ejemplo Requirement.10), un encabezado que nombra lo que encuentra, una descripción de cómo es un buen modelo y una corrección. Las reglas se agrupan por la clase que comprueban: Global (cada elemento), Action, Asset, Conduit, Input/Output, Requirement, Risk, Test Case y Measure.
- Hallazgo: un elemento que incumple una regla. Un hallazgo puede nombrar elementos relacionados, por ejemplo los duplicados de un nombre o los hijos de un padre.
- Gravedad: cada regla informa como Error o Advertencia, o se pone en Ignorar y no se ejecuta. El valor predeterminado es Advertencia, salvo para las reglas de LML 2.0 Global.10 y Global.11 en un proyecto cuya copia del esquema es anterior a LML 2.0 (consulte Reglas).
- Hallazgo ignorado: un hallazgo que ha aceptado para un elemento. Ya no cuenta, y Mostrar ignorados lo enumera con Restaurar.
- Comprobación aplicable: una regla que se ejecutó sobre al menos un elemento de su clase. La línea de encabezado cuenta cuántas comprobaciones aplicables no tienen ningún hallazgo.
- Conjunto de reglas: un grupo con nombre de sus propias reglas, guardado en el proyecto y que se activa o desactiva en bloque. Sus reglas se ejecutan con las comprobaciones integradas, y sus hallazgos usan la misma lista, Corregir e Ignorar. Consulte Conjuntos de reglas.
Cómo usarlo
Ejecute las comprobaciones antes de cada revisión, tras una importación grande y siempre que Inicio muestre errores de las comprobaciones del modelo. Responden a una pregunta: ¿qué hay en el modelo que requiera atención antes de que lo lea otra persona?
Trabajar los hallazgos
- Abra Verificación → Comprobaciones del modelo. La línea de encabezado muestra, por ejemplo, «84 % de las comprobaciones aplicables se superan», seguido del número de errores y advertencias y del cambio desde la última ejecución.
- La lista está agrupada por regla, con los errores primero. Haga clic en el encabezado de una regla para abrirla; su descripción explica por qué importa la regla.
- Para cada hallazgo, haga clic en Corregir. El diálogo de corrección muestra el elemento, la regla y la corrección sugerida: un campo que rellenar, relaciones que añadir, duplicados que fusionar o un botón que abre el elemento o su diagrama.
- Guarde la corrección. El hallazgo desaparece y los recuentos se actualizan.
- Cuando un hallazgo es intencionado (por ejemplo, una acción reutilizada bajo dos padres), haga clic en Ignorar.
Centrarse en un área
- En las facetas de la izquierda, marque Errores en Gravedad para ver solo los errores.
- Marque una clase en Clase (la clase del elemento con el hallazgo), una regla en Regla o una etiqueta en Etiqueta. Las marcas de una misma faceta se combinan con OR; las facetas se combinan con AND. Cada valor muestra cuántos hallazgos tiene.
- Escriba en Filtrar hallazgos para buscar un nombre de elemento o un encabezado de regla.
- Haga clic en Borrar facetas para volver a mostrarlo todo.
Revisar juntos los hallazgos de un elemento
- Elija Agrupar por entidad junto al filtro.
- Cada elemento aparece una vez con todos sus hallazgos, por orden de número. Un elemento con un error muestra un distintivo Error en su encabezado.
Ejemplo práctico: la demostración CubeSat EO-1
- Abra el proyecto de demostración CubeSat EO-1 y vaya a Verificación → Comprobaciones del modelo.
- Marque Requirement en Clase. Las reglas que quedan muestran qué requisitos no tienen padre, no tienen asignación (Requirement.8) o no tienen un caso de prueba que los verifique (Requirement.10).
- Abra Requirement.10, haga clic en Corregir en un hallazgo y vincule el caso de prueba que lo verifica. El hallazgo sale de la lista y la línea de encabezado sube.
- Elija Agrupar por entidad para ver a la vez todos los hallazgos restantes de un requisito.
Escribir su propia regla
- Haga clic en Conjuntos de reglas… en el encabezado de la página y después en + Nuevo conjunto de reglas. Ponga nombre al conjunto, por ejemplo «Program Rules», y haga clic en Aceptar.
- Bajo el conjunto, haga clic en + Añadir regla. El editor de reglas se abre con el ID R1.
- Escriba un Nombre que diga lo que encuentra la regla, por ejemplo «Requisitos sin caso de prueba que los verifique».
- En Se aplica a, elija Requirement.
- En Informar de un elemento cuando, elija Falta una relación y después elija verified by en Relación.
- Ponga Gravedad en Error y escriba el Mensaje, por ejemplo «Vincule el caso de prueba que verifica el requisito.»
- Lea la vista previa bajo los campos, por ejemplo «Informa ahora de 3 elementos: SYS-2 Top Speed, …». Haga clic en Guardar.
- Haga clic en Cerrar. Los hallazgos de la regla aparecen en la lista bajo R1, con los errores primero. Haga clic en Corregir para vincular un caso de prueba; el hallazgo sale de la lista.
Comprobar un presupuesto de masa con unidades
- En la demostración CubeSat EO-1, abra Conjuntos de reglas…, haga clic en + Nuevo conjunto de reglas y llámelo «Mass Budget».
- Haga clic en + Añadir regla. Llámela «Conjuntos que superan su asignación de masa» y elija Asset en Se aplica a.
- En Informar de un elemento cuando, elija Un total de valores relacionados se compara con un valor. Ponga Función en Total, Relación en decomposed by, Valor de cada elemento relacionado en Mass, Comparación en es mayor que y Comparar con en Mass Allocation.
- Ponga Gravedad en Error y haga clic en Guardar y después en Cerrar.
- Se enumera cada conjunto cuyas partes pesan más que su asignación, por ejemplo «Total Mass of “decomposed by” 2.34 kg is more than Mass Allocation 1.35 kg». Las masas en gramos y kilogramos se suman; una masa introducida en metros aparece como «Cannot add mass and length: the dimensions differ (kg vs m).» (no se pueden sumar masa y longitud: las dimensiones difieren).
Compartir reglas con otro proyecto
- En Conjuntos de reglas…, haga clic en Exportar junto al conjunto. Se descarga un archivo con un nombre como
program-rules.holarch-rules.json. - En el otro proyecto, abra Conjuntos de reglas…, haga clic en Importar…, después en Elegir archivo… (o pegue el texto del archivo) y haga clic en Importar.
- Para compartir a través de una biblioteca, mantenga los conjuntos de reglas en el proyecto de biblioteca y publique una versión. En un proyecto que usa la biblioteca, haga clic en Desde biblioteca…, marque los conjuntos y haga clic en Copiar.
- Cuando la biblioteca publica una versión más reciente con el conjunto, Conjuntos de reglas… muestra «Hay una versión más reciente disponible» junto a la copia. Haga clic en Actualizar…, revise los cambios, elija Conservar la mía o Tomar la de la biblioteca para cada regla cambiada en ambos lados y haga clic en Actualizar. Sus demás ediciones de la copia se conservan.
Consejos
- Ponga en Error en Ajustes las reglas que su equipo considera bloqueantes, para que Inicio las enumere como problemas.
- Ignore un hallazgo solo cuando sea intencionado, y explique el motivo en la descripción del elemento o en un comentario. Mostrar ignorados permite a los revisores ver lo que se aceptó.
- Una lista larga de hallazgos de nombres tras una importación suele corregirse más rápido editando los nombres en la base de datos.
- Ejecute las comprobaciones antes de guardar una línea base, para que la línea base no arrastre carencias conocidas.
La página
Encabezado de página
| Control | Qué hace |
|---|---|
| Exportar… | Abre el diálogo Exportar con Hallazgos (CSV): cada hallazgo no ignorado, con regla, gravedad, encabezado, id del elemento, número, nombre, clase, nota y elementos relacionados. |
| Ajustes | Define la gravedad de cada regla y los hijos por nivel (consulte Ajustes). |
| ↻ Ejecutar comprobaciones | Vuelve a ejecutar todas las comprobaciones y registra los recuentos como la última ejecución. |
Línea de encabezado
- «N % de las comprobaciones aplicables se superan»: en rojo cuando algún hallazgo es un error, en ámbar cuando solo hay advertencias y en verde cuando no hay nada que corregir.
- El número de hallazgos, errores y advertencias.
- El cambio desde la última ejecución en este dispositivo, por ejemplo «3 hallazgos menos que en la última ejecución.» La última ejecución se registra al abrir o salir de la página y al hacer clic en ↻ Ejecutar comprobaciones. La primera visita indica «Primera ejecución en este dispositivo.»
En un proyecto grande, las comprobaciones se ejecutan en segundo plano, así que la página sigue siendo utilizable: la primera visita muestra «Ejecutando las comprobaciones del modelo…», las visitas posteriores muestran los hallazgos anteriores hasta que los nuevos están listos, y una tarjeta de progreso muestra una ejecución que tarda más de un segundo.
Barra de herramientas
- Agrupar por regla (predeterminado) o Agrupar por entidad. La elección se recuerda en este dispositivo.
- Filtrar hallazgos: coincide con nombres de elementos, números de reglas y encabezados de reglas.
- Expandir todo y Contraer todo abren o cierran todos los grupos.
Facetas
| Faceta | Valores |
|---|---|
| Gravedad | Errores, Advertencias |
| Clase | La clase de cada elemento con un hallazgo |
| Regla | Cada regla con un hallazgo, por número y encabezado |
| Etiqueta | Cada etiqueta de un elemento con un hallazgo |
| Ignorados | Mostrar ignorados añade a la lista los hallazgos ignorados, marcados como Ignorado, con Restaurar |
Los recuentos siguen las demás facetas y el filtro, así que muestran lo que quedaría al marcar un valor.
Hallazgos
Cada hallazgo muestra el elemento (o, agrupado por entidad, la regla), la nota (por ejemplo «Palabras vagas: adequate, TBD» o «14 hijos»), los elementos relacionados y los botones Corregir e Ignorar, o Restaurar para un hallazgo ignorado. Un solo Deshacer revierte un Ignorar o un Restaurar.
Correcciones
| Solución | Usada por | Qué hace |
|---|---|---|
| Editar un campo | Nombre, número o descripción que faltan; comprobaciones de verbo y sustantivo | Abre el campo con el valor actual. |
| Poner mayúscula | Nombres en minúsculas | Ofrece el nombre con la primera letra en mayúscula. |
| Añadir relaciones | Padre, ejecutor, entradas, salidas, conduits, normas o trazas que faltan | Enumera los elementos que el esquema permite para la relación; márquelos y haga clic en Añadir relaciones. |
| Fusionar | Nombres similares, hijos únicos | Conserva un elemento, mueve a él todas las relaciones de los demás, combina las descripciones y elimina los demás (un solo Deshacer lo revierte todo). |
| Eliminar relacionados | Actions con una entrada producida después de usarse | Elimina las input/outputs que se consumen antes de existir. |
| Añadir traced to | Requisitos que nombran entidades no relacionadas | Añade traced to desde el requisito a cada elemento que nombra su texto. |
| Crear Issue | Casos de prueba fallidos sin incidencia vinculada | Crea una Issue vinculada al caso de prueba y a los requisitos que verifica. |
| Apertura | Listas largas de hijos, intercambios, normas, umbrales, relaciones que el esquema no permite | Abre el elemento o su diagrama. |
| Abrir vista UAF | Vistas UAF que no se pueden mostrar | Enumera las vistas de la raíz con sus problemas y abre la primera. |
Ajustes
- Hijos por nivel: Action.9 y Asset.9 informan de un padre con más hijos que este número. El valor predeterminado es 9, según la pauta de que las personas manejan unos 7 ± 2 elementos en un mismo nivel. Los valores permitidos son de 2 a 99; otro valor muestra «Los hijos por nivel deben ser un número entero de 2 a 99.»
- Gravedad por regla: Error, Advertencia o Ignorar. Una regla ignorada no se ejecuta.
- Restaurar valores predeterminados devuelve cada regla a su valor predeterminado (Advertencia; Requirement.11 Ignorar; Global.10 y Global.11 Ignorar en un proyecto cuya copia del esquema es anterior a LML 2.0) y los hijos por nivel a 9.
Los ajustes se guardan en el proyecto, se comparten con todos los que trabajan en él y se pueden deshacer.
Conjuntos de reglas
Conjuntos de reglas… en el encabezado de la página abre el diálogo Conjuntos de reglas. Sus propias reglas se ejecutan en Comprobaciones del modelo con las comprobaciones integradas: sus hallazgos muestran el ID de la regla (por ejemplo R1) y su nombre, cuentan en la línea de encabezado, aparecen en Regla en las facetas y usan Corregir, Ignorar y Exportar… como cualquier hallazgo. Los conjuntos de reglas se guardan en el proyecto, se comparten con todos los que trabajan en él, y cada cambio es un paso de deshacer.
El diálogo Conjuntos de reglas
| Control | Qué hace |
|---|---|
| + Nuevo conjunto de reglas | Pide un nombre y añade un conjunto vacío, activado. |
| Importar… | Añade los conjuntos de reglas de un archivo de conjuntos de reglas: Elegir archivo… o pegue su texto, y después Importar. Primero se comprueba cada regla; un archivo con algún problema se rechaza y se enumeran los problemas. Un nombre ya usado recibe « (2)». |
| Desde biblioteca… | Enumera los conjuntos de reglas de las versiones de las bibliotecas que usa este proyecto; márquelos y haga clic en Copiar. La copia recuerda su biblioteca y su versión. |
| Actualizar… | Junto a un conjunto copiado cuando su biblioteca ha publicado una versión más reciente que contiene el conjunto («Hay una versión más reciente disponible»). Muestra una vista previa de las reglas añadidas, cambiadas y quitadas en la biblioteca, las ediciones suyas que se conservan y las reglas cambiadas tanto aquí como en la biblioteca; elija Conservar la mía o Tomar la de la biblioteca para cada una de ellas y haga clic en Actualizar. Un solo Deshacer lo revierte todo. |
| Casilla junto a un conjunto | Activa o desactiva el conjunto. Un conjunto desactivado no se ejecuta. |
| Cambiar nombre… | Cambia el nombre del conjunto. |
| Exportación | Descarga el conjunto como archivo JSON de conjunto de reglas. |
| Eliminar | Elimina el conjunto y sus reglas tras una confirmación. Deshacer los restaura. |
| + Añadir regla, Editar, Eliminar | Añadir una regla al conjunto, cambiarla o eliminarla. |
Una regla que no puede ejecutarse en este proyecto, por ejemplo una que nombra una clase o una relación que el esquema no tiene, muestra el problema en rojo bajo su nombre y no informa de nada.
El editor de reglas
| Campo | Qué define |
|---|---|
| Nombre | El encabezado de los hallazgos de la regla: lo que encuentra la regla. |
| ID | Corto y único en el conjunto, por ejemplo R1 o SYS-NUM; hasta 40 letras, dígitos, puntos, guiones y guiones bajos. |
| Se aplica a | Cualquier elemento, una clase (incluidas las subclases: un Test Case también es una Action) o, en un proyecto SysML v2, un tipo de modelo como Part o Requirement. |
| Solo elementos que coinciden con | Opcional: un filtro en el lenguaje de filtros de la base de datos que acota antes los elementos, por ejemplo is:leaf. |
| Informar de un elemento cuando | La condición, más abajo. |
| Gravedad | Error o Advertencia. |
| Mensaje | La corrección que hay que hacer, mostrada en el diálogo Corregir. |
La línea bajo los campos indica de cuántos elementos informa la regla ahora y nombra los cinco primeros.
| Condición | Campos | Informa de un elemento cuando |
|---|---|---|
| Un atributo está vacío | Atributo | El atributo no tiene valor. |
| Un atributo coincide con un patrón | Atributo, Patrón, Ignorar mayúsculas y minúsculas | El texto del atributo contiene una coincidencia del patrón, una expresión regular. |
| Un atributo no coincide con un patrón | Atributo, Patrón, Ignorar mayúsculas y minúsculas | El texto del atributo no tiene ninguna coincidencia, por ejemplo ^SYS-\d+$ para números que deben empezar por SYS-. |
| Falta una relación | Relación, De elementos de | El elemento no tiene ningún vínculo de esa relación (con elementos de esa clase). |
| Hay una relación | Relación, De elementos de | El elemento tiene un vínculo así. |
| Los elementos relacionados son al menos N | Relación, De elementos de, N | El elemento tiene N o más elementos relacionados, por ejemplo más de 9 hijos. |
| Los elementos relacionados son como máximo N | Relación, De elementos de, N | El elemento tiene N o menos elementos relacionados. |
| Un valor está fuera de un rango | Atributo, Mínimo, Máximo, Unidad | El número del atributo está por debajo del mínimo o por encima del máximo. Deje un límite vacío para un rango abierto. |
| Un valor está dentro de un rango | Atributo, Mínimo, Máximo, Unidad | El número del atributo está dentro del rango, límites incluidos. |
| Un total de valores relacionados se compara con un valor | Función, Relación, De elementos de, Valor de cada elemento relacionado, Comparación, Comparar con | El Total, el Menor o el Mayor de un valor sobre los elementos relacionados (o el Número de elementos) es mayor que, al menos, menor que, como máximo, igual a o distinto de un atributo del elemento (por ejemplo Mass Allocation) o un valor con su unidad (12 kg). Los elementos relacionados sin el valor se omiten. |
| Una expresión coincide | Expresión | El elemento coincide con la expresión. |
Los atributos se nombran como en el elemento: Nombre, Número y Descripción (en un proyecto SysML v2, Short Name y Documentación) o cualquier atributo de la clase. En un proyecto SysML v2 también se puede nombrar un uso de atributo del elemento, como mass. Un elemento cuya clase no tiene ese atributo se omite. Los valores de un elemento LML incluyen también las características por las que está specified by (una característica Mass con Value 2.4 y Units kg se lee como 2.4 kg) y sus asignaciones de presupuesto (Mass Allocation, de Presupuestos). Sin una Unidad, un rango lee el número inicial del valor (1,500 kg y 1500 [kg] se leen como 1500) y omite los valores que no son números. Con una Unidad como kg, los valores se convierten primero (25000 g se lee como 25 kg), y un valor de otra magnitud, como 3 m, es un hallazgo en sí mismo: «Cannot compare length and mass: the dimensions differ (m vs kg).» (no se pueden comparar longitud y masa: las dimensiones difieren). Los totales y las expresiones convierten las unidades de la misma forma e informan de una incompatibilidad de la misma forma, nunca como una comparación silenciosa.
Reglas de expresión
Una expresión se escribe en el lenguaje de filtros de la barra de filtros de la base de datos, así que un filtro que encuentra allí los elementos problemáticos funciona como regla: se informa de cada elemento que coincide. Ejemplos:
| Expresión | Informes |
|---|---|
class:Requirement is:leaf NOT relationship:"verified by" | Requisitos hoja que ningún caso de prueba verifica. |
class:Requirement Requirement:"Status=Draft" | Requisitos que siguen en Borrador. |
class:Action is:root NOT relationship:"performed by" | Actions de primer nivel que nada realiza. |
class:Asset (name:%TBD% OR description:TBD) | Assets con TBD en el nombre o la descripción. |
class:Asset value:"sum(decomposed by → Mass) > Mass Allocation" | Conjuntos cuyas partes pesan más que su asignación, con cualquier mezcla de unidades. |
Aritmética con unidades: value:"Mass * 1.1 <= 12 kg" o value:"sum(decomposed by → Mass) > Mass Allocation" compara valores del elemento y totales sobre sus elementos relacionados (sum, min, max, count), con +, -, *, /, paréntesis y unidades tras los números (12 kg, 9.81 [m/s^2]). Las comparaciones de atributos con una unidad, como Asset:"Mass>2 kg", también se convierten.
Términos: texto libre, name: (% coincide con cualquier texto), number: (* coincide con cualquier texto), description:, class:, label:, relationship:"…", status:, id:, under:"<number>", is:root, is:leaf, is:orphan, is:top, is:locked, is:diagram, comparaciones de atributos como Requirement:"Priority>=3" (=, ~ contiene, <, <=, >, >=; = sin valor significa vacío), AND, OR, NOT y paréntesis. Un término que no nombra nada del proyecto, como una clase desconocida, se muestra como problema.
Archivos de conjuntos de reglas
Un archivo de conjunto de reglas es JSON con "format": "holarch-rule-set", "version": 1, un name, una description opcional y una lista de rules, cada una con id, name, severity, message, un target opcional ({"class": "Requirement"}), un filtro where opcional y un check. Exporte un conjunto para ver la forma exacta. Los mismos archivos se ejecutan en las comprobaciones del modelo de la API pública y del MCP. También se ejecutan en proyectos SysML v2: allí la API y el MCP solo ejecutan los conjuntos de reglas del proyecto (las reglas integradas se ejecutan en la aplicación), y una regla sobre las relaciones que Holarch lee de las conexiones y los flujos (connected by, transfers, generates, receives) solo se ejecuta en la aplicación.
Reglas
| Regla | Heading | Un buen modelo |
|---|---|---|
| Global.1 | Nombres iguales o casi iguales | Dentro de una clase, no hay dos entidades con el mismo nombre. Los nombres se comparan en cualquier idioma, sin tener en cuenta mayúsculas, espacios, puntuación ni anchura de caracteres («ABS制御» equivale a «ABS制御»); las letras acentuadas cuentan («Größe» y «Grüße» son distintas). |
| Global.2 | Nombres en minúsculas | El nombre de cada entidad empieza por mayúscula. |
| Global.4 | Números repetidos en una clase | Dentro de una clase, cada número es único. |
| Global.5 | Palabras vagas en nombres o descripciones | Los nombres y las descripciones usan palabras precisas. |
| Global.6 | Entidades sin relaciones | Cada entidad tiene una relación. |
| Global.7 | Valores dinámicos que apuntan a destinos inexistentes | Los valores dinámicos, los bloques de matriz, las tablas dinámicas (tablas, recuentos y totales) y las referencias cruzadas de las descripciones apuntan a entidades, documentos, clases, etiquetas, relaciones, figuras y tablas que existen. |
| Global.8 | Vistas UAF que no se pueden mostrar | Cada vista UAF usa una raíz, una clase y una relación que su tipo de vista acepta. |
| Global.9 | Relaciones que el esquema no permite | Cada relación une clases que el esquema permite para su relación. |
| Global.10 | Entidades sin nombre ni número | Cada entidad tiene un nombre o un número. |
| Global.11 | Valores fuera de las opciones de su atributo | Cada valor de enumeración y de selección múltiple es una de las opciones de su atributo, elegida una sola vez. |
| Action.1 | Nombres de Action que no empiezan por un verbo | El nombre de cada Action empieza por un verbo. |
| Action.2 | Nombres de Action en minúsculas | El nombre de cada Action empieza por mayúscula. |
| Action.3 | Acciones sin nombre | Cada acción tiene un nombre. |
| Action.4 | Acciones sin número | Cada acción tiene un número. |
| Action.5 | Acciones sin descripción | Cada acción tiene una descripción. |
| Action.6 | Acciones sin padre ni hijo | Cada acción tiene un padre o un hijo. |
| Action.7 | Acciones con un solo hijo | Ninguna acción tiene un solo hijo. |
| Action.9 | Acciones con más de 9 hijos | Ninguna acción tiene más de 9 hijos. |
| Action.10 | Acciones con varios padres | Ninguna acción tiene varios padres. |
| Action.11 | Acciones que ningún activo realiza | Algún activo realiza cada acción. |
| Action.12 | Acciones que no producen nada | Cada acción produce una input/output. |
| Action.13 | Acciones que no consumen nada | Cada acción consume una input/output. |
| Action.14 | Acciones sin entradas ni salidas | Cada acción consume o produce una input/output. |
| Action.15 | Acciones que producen pero no consumen nada | Cada acción que produce salidas también consume una entrada. |
| Action.16 | Acciones que consumen pero no producen nada | Cada acción que consume entradas también produce una salida. |
| Action.17 | Actions con una entrada producida después de usarse | Ninguna acción recibe una input/output que genera una acción posterior. |
| Action.18 | Acciones no trazadas con un requisito | Cada acción se traza con un requisito. |
| Action.19 | Bucles que nunca pueden terminar | Cada bucle puede terminar. Nombra el bucle y la rama OR al 0 % que bloquea su EXIT. |
| Asset.1 | Nombres de Asset sin sustantivo | El nombre de cada activo es un sustantivo o un sintagma nominal. |
| Asset.2 | Nombres de Asset en minúsculas | El nombre de cada activo empieza por mayúscula. |
| Asset.3 | Activos sin nombre | Cada activo tiene un nombre. |
| Asset.4 | Activos sin número | Cada activo tiene un número. |
| Asset.5 | Activos sin descripción | Cada activo tiene una descripción. |
| Asset.6 | Activos sin padre ni hijo | Cada activo tiene un padre o un hijo. |
| Asset.7 | Activos con un solo hijo | Ningún activo tiene un solo hijo. |
| Asset.9 | Activos con más de 9 hijos | Ningún activo tiene más de 9 hijos. |
| Asset.10 | Activos con varios padres | Ningún activo tiene varios padres. |
| Asset.11 | Activos que no realizan ninguna acción | Cada activo realiza alguna acción. |
| Asset.12 | Activos no conectados por un conduit | Cada activo está conectado por un conduit. |
| Asset.13 | Activos que intercambian sin ningún conduit en común | Los activos que intercambian una input/output están conectados por un conduit. |
| Asset.14 | Activos que interactúan sin ninguna norma en común | Los activos que interactúan hacen referencia a la misma norma. |
| Asset.15 | Activos que no intercambian nada | Cada activo intercambia una input/output con otro activo. |
| Conduit.1 | Nombres de Conduit que no empiezan por un sustantivo | El nombre de cada conduit empieza por un sustantivo. |
| Conduit.2 | Conduits sin nombre | Cada conduit tiene un nombre. |
| Conduit.3 | Conduits sin número | Cada conduit tiene un número. |
| Conduit.4 | Conduits sin descripción | Cada conduit tiene una descripción. |
| Conduit.5 | Conduits con más de dos activos | Ningún conduit conecta más de dos activos. |
| Conduit.6 | Conduits con menos de dos activos | Cada conduit conecta dos activos. |
| Conduit.7 | Conduits sin ninguna norma en común con sus activos | Un conduit y los activos que conecta hacen referencia a la misma norma. |
| Conduit.8 | Conduits que no transfieren nada | Cada conduit transfiere alguna input/output. |
| Conduit.9 | Conduits no trazados con un requisito | Cada conduit se traza con un requisito. |
| IO.1 | Input/outputs sin nombre | Cada input/output tiene un nombre. |
| IO.2 | Input/outputs sin número | Cada input/output tiene un número. |
| IO.3 | Input/outputs sin descripción | Cada input/output tiene una descripción. |
| IO.4 | Input/outputs con varios padres | Ninguna input/output tiene más de un padre. |
| IO.5 | Input/outputs que ninguna acción produce | Alguna acción produce cada input/output. |
| IO.6 | Input/outputs que ninguna acción consume | Alguna acción consume cada input/output. |
| IO.7 | Input/outputs que ninguna acción usa | Cada input/output la produce o la consume una acción. |
| IO.8 | Input/outputs que una acción produce y consume a la vez | Ninguna acción consume una input/output que ella misma produce. |
| IO.9 | Input/outputs sin ninguna norma en común con sus activos | Una input/output y los activos que la intercambian hacen referencia a la misma norma. |
| IO.10 | Input/outputs no trazadas con un requisito | Cada input/output se traza con un requisito. |
| Requirement.1 | Requisitos que nombran entidades no relacionadas | Un requisito está relacionado con cada entidad que nombra. |
| Requirement.2 | Requisitos hoja sin «shall» | Cada requisito hoja usa la palabra «shall». |
| Requirement.3 | Requisitos sin nombre | Cada requisito tiene un nombre. |
| Requirement.4 | Requisitos sin número | Cada requisito tiene un número. |
| Requirement.5 | Requisitos sin descripción | Cada requisito tiene una descripción. |
| Requirement.6 | Requisitos sin padre ni hijo | Cada requisito tiene un padre o un hijo. |
| Requirement.7 | Requisitos con varios padres | Ningún requisito tiene varios padres. |
| Requirement.8 | Requisitos hoja que ninguna entidad de diseño cumple | Cada requisito hoja está relacionado con una Action, un Asset, una Input/Output o un Conduit. |
| Requirement.9 | Requisitos satisfechos por varios Input/Outputs | Ningún requisito está satisfecho por más de una input/output. |
| Requirement.10 | Requisitos hoja sin caso de prueba que los verifique | Cada requisito hoja está verificado por un Test Case. |
| Requirement.11 | Requisitos fuera de los patrones EARS | Cada requisito hoja con «shall» sigue uno de los patrones EARS. Desactivada (Ignorar) hasta que defina su gravedad. |
| Risk.1 | Riesgos del nivel más alto sin mitigación | Cada riesgo abierto del nivel más alto de la matriz de riesgos está mitigado por algo. |
| Risk.2 | Aceptaciones de peligros anteriores a un cambio de controles | La aceptación del riesgo residual de ningún peligro es anterior a un cambio de sus controles o de su verificación. |
| TestCase.1 | Casos de prueba fallidos sin incidencia vinculada | Cada Test Case fallido está vinculado a una Issue. |
| Measure.1 | Measures que incumplen su umbral | El valor proyectado (o actual) de cada Measure cumple su umbral. |
Notas sobre las reglas:
- Las reglas de redacción de requisitos citan la INCOSE Guide to Writing Requirements: palabras vagas (R7, términos vagos; R8, cláusulas de escape), «shall» (R1, enunciados estructurados) y mayúsculas (R39, guía de estilo). La comprobación de redacción completa es Calidad de los requisitos.
- Las reglas de Action y Asset omiten las tareas, los casos de prueba, las transiciones de estado, los puertos y los recursos; las reglas Global siguen aplicándose a ellos.
- Un elemento descompuesto cuenta como realizado, alimentado, productivo o trazado cuando lo es alguno de sus descendientes. Los elementos que se descomponen entre sí en un bucle cuentan juntos.
- Global.9 informa de cada elemento una vez, con los otros extremos de sus relaciones que el esquema no permite, y la relación y la clase en la nota, por ejemplo «Not allowed: decomposed by → Risk». Una relación cuenta como permitida cuando el esquema la permite en cualquiera de los dos sentidos. Estas relaciones permanecen después de quitar un destino en el Editor de esquema y pueden llegar con las importaciones.
- Global.10 y Global.11 proceden de LML 2.0: una entidad se identifica por un nombre o un número (§2.1), y un valor de enumeración o de selección múltiple se escoge de la lista de su atributo (§2.5.6, §2.5.12). Global.11 pone en su nota todos los problemas de un elemento, por ejemplo
Status: "Pending" is not a choiceoVerification Method: "Test" chosen twice. Ambas se ejecutan de forma predeterminada donde el esquema tiene los elementos integrados de LML 2.0: el esquema predeterminado, o la copia propia de un proyecto después de Esquema → Añadir nuevos elementos integrados…. En un proyecto cuya copia del esquema es más antigua, empiezan en Ignorar, para que un modelo hecho con LML 1.x muestre los mismos hallazgos que antes; póngalas en Advertencia o Error en Ajustes para ejecutarlas. El Editor de esquema pide al menos dos valores al crear o cambiar una lista. - Los puertos son puntos de interfaz, no partes: no cuentan como hijos, y un conduit en un puerto cuenta para el activo que lo posee.
- Los casos de uso (Actions con la etiqueta Use Case) están exentos de la regla del verbo y de las reglas de input/output.
- Requirement.11 comprueba la oración que contiene «shall» frente a los seis patrones EARS (Escribir con plantillas EARS) y nombra lo primero que hay que corregir, por ejemplo «Event-driven: Put a comma after the “When” condition, before the system name.» (ponga una coma tras la condición When, antes del nombre del sistema). La justificación y las notas de otras oraciones no se comprueban.
- Los proyectos SysML v2 ejecutan 17 de las reglas, con la terminología de SysML v2: Global.1, .2, .4 a .8, Requirement.2 a .5, .8, .10 y .11, Risk.1, TestCase.1 y Measure.1. Las reglas de Action, Asset, Conduit e Input/Output no se aplican; los diagnósticos del editor comprueban los nombres, tipos y estructura del modelo. Las reglas de requisitos comprueban los usos de requisito: por ejemplo, Requirement.8 dice «Requisitos hoja que nada satisface» (una parte o acción que lo satisface) y Requirement.10 «Requisitos hoja sin caso de verificación». Global.1, .2 y .6 comprueban los elementos que acompañan al modelo, como riesgos, tareas y documentos.
Reglas de líneas de productos
En cuanto un proyecto tiene una Feature o una Configuration, Comprobaciones del modelo ejecuta también el conjunto de reglas integrado Línea de productos (reglas ProductLine.1 a ProductLine.11 y 13 a 17, clase Línea de productos). Las features o configuraciones que faltan en Applies To (ProductLine.1), las configuraciones que incumplen una regla o están incompletas (ProductLine.3) y las configuraciones Released con requisitos no verificados en ellas (ProductLine.16) son errores; las demás reglas son advertencias. ProductLine.10 y 11 comprueban la completitud de cada configuración desde Todas las configuraciones. ProductLine.13 y 14 comprueban las revisiones de un elemento (supersedes): dos vigentes para la misma unidad, y unidades sin ninguna. En una vista de configuración, cada regla comprueba esa configuración. Consulte Líneas de productos y configuraciones.
Mensajes
| Mensaje | Significado |
|---|---|
| «No hay hallazgos. Se superan todas las comprobaciones aplicables.» | No hay nada que corregir. |
| «No hay hallazgos. N hallazgos ignorados; Mostrar ignorados los enumera.» | Todos los hallazgos restantes se ignoraron. |
| «Ningún hallazgo coincide con el filtro. Borre el filtro o las facetas.» | Las facetas o el filtro ocultan todos los hallazgos. |
| «El esquema no permite ninguna de estas relaciones para la clase …» | La corrección necesita una relación que el esquema del proyecto no permite para esa clase. Añádala en el Editor de esquema, o corrija el hallazgo de otra forma. |
| «El patrón no es una expresión regular válida (…). Corríjalo.» | El editor de reglas o un archivo importado tiene un patrón que no se puede leer. |
| «El id “…” ya se usa en este conjunto de reglas. Elija otro.» | Dos reglas de un mismo conjunto necesitan ID distintos. |
| «La relación “…” no está en el esquema de este proyecto.» | Una regla nombra una relación que este proyecto no tiene; no informa de nada hasta que la cambie. |
| «La expresión no nombra nada para la clase “…”.» | Una expresión o un filtro nombra una clase, etiqueta, relación o elemento que el proyecto no tiene. |
| «La versión N no es compatible. Esta versión de Holarch lee la versión 1.» | El archivo de conjunto de reglas lo escribió una versión más reciente de Holarch. |
Límites
- La lista muestra hasta 200 hallazgos por grupo; filtre la lista para ver el resto.
- Un conjunto de reglas contiene hasta 500 reglas; un archivo contiene hasta 50 conjuntos de reglas y 2 MB. Los patrones tienen hasta 300 caracteres y comprueban los primeros 20.000 caracteres de un valor.
- El cambio desde la última ejecución se guarda por dispositivo y navegador, no en el proyecto.
- Las herramientas de la API pública y del MCP devuelven los mismos hallazgos con los ajustes del proyecto; no guardan resultados.