Holarch

Requisitos

Requisitos

Escriba, compruebe, apruebe, incluya en una línea base e importe requisitos, y siga los elementos TBD/TBR abiertos y los vínculos que revisar.

Cómo usarlo →

En esta página
  1. Resumen
  2. Conceptos
    1. Requirement y Statement
    2. Atributos de requisito
    3. Etiquetas de requisito
    4. El flujo de trabajo de los requisitos
    5. Elementos abiertos: TBD, TBR y TBS
    6. Líneas base
  3. Cómo usarlo
    1. Cuándo y por qué
    2. Escribir un requisito
    3. Comprobar la redacción
    4. Escribir con plantillas EARS
    5. Aprobar requisitos
    6. Congelar un documento para una revisión
    7. Gestionar un cambio después de la línea base
    8. Cerrar elementos TBD y TBR
    9. Importar una especificación existente
    10. Ejemplo práctico: la demostración CubeSat EO-1
    11. Consejos y buenas prácticas
    12. Errores habituales
    13. Cómo se relaciona con otras funciones
  4. La página Requisitos
  5. Calidad de los requisitos
    1. Disposición de la página
    2. Filtrar la página Calidad
    3. Criterios y comprobaciones
    4. Dos requisitos en uno (R19)
    5. Requisitos en otros idiomas
    6. Anulaciones manuales
    7. Resultados desactualizados
    8. Comprobar calidad desde un documento
    9. Comprobación de requisitos con IA
    10. Exportaciones de calidad
  6. Aprobaciones
    1. El cuadro de aprobación
  7. Registro de TBD/TBR
  8. Vínculos por revisar
    1. Qué marca un vínculo para revisión
    2. Dónde se muestran los vínculos por revisar
    3. La página Vínculos por revisar
  9. Líneas base y comparación de versiones
    1. Líneas base de documentos
    2. Comparar versiones
    3. Página Líneas base y versiones
  10. Importar requisitos
    1. Paso 1: Archivo
    2. Paso 2: Asignar
    3. Paso 3: Revisar
    4. Cómo se lee cada formato
    5. Actualizar requisitos desde una hoja de cálculo
    6. Mensajes de importación
  11. Atajos de los requisitos
  12. Ajustes
  13. Mensajes
  14. Límites
  15. Relacionado

Resumen

Use las páginas de requisitos para escribir, comprobar, aprobar y fijar en líneas base los requisitos, y para seguir lo que aún está abierto. Un requisito es una entidad de la clase LML Requirement: una capacidad, característica o factor de calidad que el sistema debe tener.

Los requisitos suelen estar en un documento de requisitos (consulte Documentos). Cada uno sigue siendo una entidad del modelo. Por eso el mismo requisito aparece en la Base de datos, en los diagramas, en la Matriz de trazabilidad y en la RVTM.

El grupo Necesidades y requisitos de la barra de navegación contiene todas las páginas de requisitos:

PáginaQué muestra
DocumentosLas especificaciones y sus esquemas. Los requisitos se escriben aquí.
RequisitosTodos los requisitos en una tabla (la Base de datos filtrada por class:Requirement).
CalidadLa Calidad de los requisitos: una puntuación sobre nueve criterios por requisito.
TBD/TBREl registro de valores abiertos que aún deben determinarse o revisarse.
Vínculos por revisarVínculos cuyo requisito de origen cambió después de la última revisión del vínculo.
AprobacionesRequisitos cuyo Status es In Review.
Importación y exportaciónImportación de Word, Excel, CSV, ReqIF, texto sin formato, XMI y archivos de proyecto, a través de una sola zona de colocación, y las exportaciones del modelo.

Las líneas base son instantáneas congeladas para las revisiones. Créelas desde un documento o desde Control y revisiones → Líneas base y versiones. Los vínculos con funciones, activos y pruebas se tratan en Trazabilidad.

Conceptos

Requirement y Statement

Statement es la clase padre de Requirement.

  • Use un Statement para el texto que no es vinculante: encabezados de sección, supuestos, contexto.
  • Use un Requirement para cada enunciado vinculante con «shall».

Solo los Requirements se puntúan en la comprobación de calidad, se enumeran en el registro TBD/TBR, se marcan para revisión cuando cambian y se cuentan en la RVTM. Los Statements se omiten.

Un requisito tiene los campos comunes de entidad Número, Nombre y Descripción. La Descripción es el propio enunciado del requisito, como texto enriquecido. Los atributos siguientes añaden el resto.

Atributos de requisito

AtributoTipo y valoresSignificado
JustificaciónTexto largoEl motivo del requisito.
EstadoDraft, In Review, Approved, RejectedEn qué punto del flujo de aprobación está el requisito.
PrioridadHigh, Medium, LowQué importancia tiene el requisito para las partes interesadas.
CriticalityHigh, Medium, LowConsecuencia para la misión o la seguridad si no se cumple el requisito.
ResponsableTextoPersona o equipo responsable del requisito.
FuenteTextoParte interesada, documento o norma de la que procede el requisito.
Verification MethodSelección múltiple: Analysis, Demonstration, Inspection, TestCómo se verifica el requisito.
Nivel de verificaciónComponent, Subsystem, SystemNivel de ensamblaje en el que se verifica el requisito.
Criterios de éxitoTexto largoResultado medible que demuestra que se cumple el requisito.
TBD/TBRNone, TBD, TBRTBD = un valor aún está por determinar; TBR = un valor está por revisar. Vuelva a None al cerrarlo.
TBD OwnerTextoPersona responsable de cerrar el TBD/TBR.
TBD Due DateFecha y horaFecha en la que debe cerrarse el TBD/TBR. Fecha límite en el grupo Flujo de trabajo muestra y establece la misma fecha (consulte Registro TBD/TBR).
Puntuación de calidadPorcentaje, calculadoResultado de la última Comprobación de calidad.
Apropiado, Completo, Conforme, Correcto, Factible, Necesario, Singular, Inequívoco, VerificableSí/No, calculado o establecido a manoLos nueve criterios de calidad.

El inspector agrupa los campos de un requisito (consulte El inspector): Requirement (Número, Nombre, Descripción, Etiquetas, Justificación, Origen, Criterios de éxito), Flujo de trabajo (la franja de revisión con Estado, Prioridad, Criticality, Owner, Responsable, Fecha límite, TBD/TBR, TBD Owner, TBD Due Date), Verificación (Verification Method y Level, Verificado por, y los campos de cierre con el Programa formal), Valores (Budget Quantity, Umbral, Objetivo y Valor actual, Unidades), Cumplimiento (Programa formal) y Calidad.

La puntuación y los nueve criterios están en el grupo Calidad, plegado al principio. Su encabezado dice, por ejemplo, «89 % · 8 de 9 cumplidos» o «aún no comprobado». Holarch recuerda, por clase, si dejó el grupo abierto.

Los proyectos pueden añadir sus propios atributos y opciones de requisito; consulte Extensiones del esquema.

Etiquetas de requisito

Las etiquetas clasifican los requisitos sin cambiar su clase. Las etiquetas de requisito integradas son:

  • Functional Requirement, Performance Requirement, Requisito de interfaz.
  • Environmental Requirement, Reliability Requirement, Safety Requirement.
  • Verification Requirement.
  • Stakeholder Need: una necesidad expresada por una parte interesada, antes de convertirla en requisitos del sistema.

Verification Method también es un grupo de etiquetas, con las etiquetas Analysis, Demonstration, Inspection y Test. La etiqueta y el atributo se mantienen sincronizados, en el mismo paso de deshacer:

  • Añadir la etiqueta Test establece Verification Method en Test.
  • Elegir Test en el atributo añade la etiqueta.

Los proyectos antiguos y las importaciones que solo llevan las etiquetas se combinan en el atributo cuando se abre el proyecto.

El flujo de trabajo de los requisitos

Cada requisito pasa por cuatro estados:

  1. Borrador: en redacción.
  2. In Review: a la espera de una decisión. Se enumera en la página Aprobaciones.
  3. Approved o Rejected: decidido. Cada decisión registra quién la tomó, cuándo y un motivo opcional.

Después de la aprobación, tres mecanismos mantienen fiel el registro:

  • Nueva revisión al editar. Editar el nombre o la descripción de un requisito Approved lo devuelve a In Review, con la nota «El texto cambió después de la aprobación».
  • Calidad desactualizada. Editar el nombre o la descripción marca sus resultados de calidad como desactualizados y borra las anulaciones manuales de calidad.
  • Vínculos por revisar. Editar el nombre, la descripción o un atributo clave marca para revisión los vínculos con los elementos que dependen de él.

Los tres forman parte de la edición, de modo que un solo Deshacer (⌘Z / Ctrl+Z) los revierte juntos.

Elementos abiertos: TBD, TBR y TBS

Un elemento abierto es un valor que aún no está resuelto. Un requisito es un elemento abierto cuando se cumple cualquiera de estas condiciones:

  • Su atributo TBD/TBR es TBD o TBR.
  • Su nombre o su descripción contiene la palabra TBD, TBR o TBS.

Los elementos abiertos aparecen en el registro TBD/TBR hasta que se cierran.

Líneas base

Una línea base es una instantánea de solo lectura. Hay dos tipos:

  • Una línea base de documento contiene un documento. Incluye el artefacto del documento, sus elementos y sus atributos, las relaciones que los tocan, las entidades a un salto de distancia y los ajustes del esquema del documento.
  • Una línea base de proyecto contiene todas las entidades y relaciones del proyecto.

Las líneas base pueden llevar registros de aprobación (nombre, función, declaración, fecha). Los registros se bloquean una vez guardados.

Cómo usarlo

Cuándo y por qué

El trabajo con requisitos abarca el lado izquierdo de la V de la ingeniería de sistemas:

  1. Capturar las necesidades de las partes interesadas.
  2. Derivar los requisitos del sistema.
  3. Comprobar que cada enunciado está bien formado.
  4. Conseguir la aprobación de los requisitos.
  5. Congelarlos en una revisión (SRR, PDR, CDR).

Después de la línea base, el trabajo pasa al control de cambios. Cada cambio se vuelve a revisar y se comprueba su impacto aguas abajo. Los valores TBD/TBR abiertos se cierran antes de comprometer el diseño.

Las páginas de requisitos responden a estas preguntas:

PreguntaPágina
¿Está bien escrito cada requisito?Calidad
¿Qué valores aún se desconocen, quién es su responsable y van con retraso?TBD/TBR
¿Qué hay que volver a comprobar porque cambió un requisito?Vínculos por revisar
¿Qué está a la espera de una decisión?Aprobaciones
¿Qué cambió desde la revisión?Versión ▾ → Comparar versiones… del documento, Líneas base y versiones
¿Está asignado y verificado cada requisito?Matriz de trazabilidad y RVTM

Las páginas Calidad, Vínculos por revisar, TBD/TBR y Aprobaciones están una junto a otra en Necesidades y requisitos en la barra de navegación. Recorra desde allí las cuatro comprobaciones una tras otra.

Escribir un requisito

  1. Abra Necesidades y requisitos → Documentos.
  2. Abra el documento de requisitos.

    Para empezar uno nuevo, haga clic en + Nuevo documento (consulte Documentos).

  3. En la barra Añadido rápido bajo el documento, elija dónde va el elemento, por ejemplo Bajo 3 Electrical Power.
  4. Escriba el enunciado del requisito y pulse Enter.

    Holarch añade un elemento de la clase predeterminada del documento (Requirement en un documento de requisitos). Se numera después de sus hermanos.

  5. Con el requisito seleccionado, abra el inspector a la derecha.
  6. Rellene Justificación, Origen y Criterios de éxito en el grupo Requirement; Prioridad, Criticality y Owner en Flujo de trabajo; y Verification Method y Nivel de verificación en Verificación.
  7. Añada una etiqueta de tipo con + Etiqueta en el grupo Requirement del inspector, por ejemplo Performance Requirement. (La columna Etiquetas está en Ver ▾ → Columnas ▸).

El requisito tiene el Status Draft y aparece en Necesidades y requisitos → Requisitos.

Si aún no se conoce un valor:

  1. Escriba su mejor estimación en el enunciado.
  2. Establezca TBD/TBR en TBD.
  3. Rellene TBD Owner y establezca la fecha en Fecha límite en el grupo Flujo de trabajo.

    El requisito aparece ahora también en el registro TBD/TBR, con esa fecha límite.

Comprobar la redacción

  1. Abra Necesidades y requisitos → Calidad.

    Desde un documento, elija en su lugar Comprobar ▾ → Comprobar calidad.

  2. En la barra de ámbito, elija Todos los requisitos o Documento: <name>.
  3. Haga clic en Comprobar calidad en el encabezado de la página.

    El aviso dice «Se comprobaron 32 requisitos» (o su recuento). Cada requisito obtiene una puntuación de 0 a 100 % y un ✔ o ✘ por criterio.

    Con más de 2,000 requisitos, la comprobación se ejecuta en segundo plano: la tarjeta de progreso muestra «Comprobando requisitos», el recuento y el tiempo restante, y puede seguir trabajando. Haga clic en Cancelar en la tarjeta para detenerla; no cambia nada. Después la tarjeta dice «Guardando los resultados de calidad» con el recuento guardado; mientras guarda, las demás ediciones se rechazan con «Guardando los resultados de calidad. Inténtelo de nuevo cuando termine.» Solo se guardan los requisitos cuyos resultados cambiaron, así que volver a comprobar sin cambios no guarda nada. Toda la comprobación es un solo paso: un ⌘Z / Ctrl+Z la quita.

  4. Lea los mosaicos: Requisitos, Puntuación media, Bueno (≥ 67 %), Requiere revisión (< 67 %) y, cuando los hay, Desactualizado (el texto cambió).
  5. Para cada requisito por debajo del 67 %, lea la columna Sugerencias.

    O sitúe el puntero sobre una ✘ para ver los mensajes de ese criterio.

  6. Haga clic en el nombre del requisito para abrirlo y corrija el texto.
  7. Vuelva a ejecutar la comprobación.

Correcto y Factible siempre necesitan el juicio de una persona. La comprobación nunca los marca como cumplidos, sea cual sea el resultado de las demás comprobaciones. Por eso la comprobación automática alcanza como máximo 7 de 9 criterios (78 %). Un requisito sin prueba ni requisito que lo verifique alcanza 6 de 9 (67 %). Para cada requisito, decídalos usted:

  • Después de revisar el requisito, haga clic en la ✘ para marcar el criterio como Sí.
  • Para una primera opinión, use ✦ IA ▾ → Comprobar con IA (N requisitos)… (la Comprobación de requisitos con IA).

Nota: las puntuaciones guardadas por versiones anteriores podían contar Correcto o Factible como cumplidos cuando fallaba otra comprobación. Vuelva a ejecutar la comprobación para actualizarlas.

Escribir con plantillas EARS

EARS (Easy Approach to Requirements Syntax) escribe cada requisito como una sola oración: una condición opcional y después «the [system] shall [response]». La primera palabra de la condición determina el patrón.

PatrónPlantillaEjemplo
UbiquitousThe [system] shall [response].The pump controller shall record every start command with its time.
Event-drivenWhen [trigger], the [system] shall [response].When the tank level falls below 20 %, the pump controller shall start the backup pump.
State-drivenWhile [state], the [system] shall [response].While the vehicle is charging, the battery manager shall keep each cell below 45 °C.
Unwanted behaviorIf [unwanted condition], then the [system] shall [response].If the supply voltage drops below 10 V, then the flight computer shall switch to the reserve battery.
Optional featureWhere [feature is included], the [system] shall [response].Where a heated windshield is fitted, the climate controller shall clear frost within 5 minutes.
ComplexWhile [state], when [trigger], the [system] shall [response].While the drill is in standby, when the operator presses Start, the drill controller shall reach full speed within 3 s.
  1. Abra un requisito en el inspector o en la Vista del elemento.
  2. Haga clic en EARS ▾ junto a Descripción.

    La primera línea muestra el patrón del enunciado (✓ Event-driven) o lo que hay que corregir (Sin patrón EARS: 1 por corregir).

  3. Elija un patrón.

    Su plantilla pasa a ser la descripción. Si el requisito ya tiene una, confirme con Reemplazar; el enunciado anterior queda en el historial del elemento. Un ⌘Z / Ctrl+Z lo deshace.

  4. Sustituya las palabras entre corchetes.

Para comprobar todos los requisitos, establezca Requirement.11 en Advertencia o Error en Comprobaciones del modelo → Ajustes. Está desactivada de forma predeterminada.

En un proyecto SysML v2, EARS ▾ está bajo la Documentación de un requisito en el inspector y escribe su comentario doc.

Aprobar requisitos

  1. Cuando un requisito esté listo, establezca su Estado en En revisión.

    Hágalo en el inspector (el Estado en la franja de revisión del grupo Flujo de trabajo), en la Base de datos o en una columna del documento.

  2. El revisor abre Necesidades y requisitos → Aprobaciones.

    La página enumera cada requisito cuyo Estado es En revisión.

  3. Haga clic en una fila.

    El grupo Flujo de trabajo del inspector muestra la franja de revisión: el Estado, quién lo estableció y cuándo («por J. Rivera · 9 mar 2026 a las 9:58») y los botones.

  4. Haga clic en Aprobar.

    O haga clic en Rechazar… e introduzca un motivo opcional.

    El aviso dice «Aprobada» o «Rechazada». La decisión se registra con su nombre y la hora, y el requisito sale de la lista de Aprobaciones.

    Cuando el requisito está en una línea base y hay elementos de verificación o documentos que se trazan a él, Aprobar abre primero un diálogo que los enumera en Requiere nueva revisión (Impacto). Haga clic en una fila para examinarla y después en Aprobar para confirmar.

Para devolver a revisión un requisito ya decidido, haga clic en Reabrir. El aviso dice «Movido a En revisión».

Si el proyecto tiene un flujo de trabajo sobre el Estado de los requisitos (Esquema → Flujo de trabajo), la franja de revisión muestra las transiciones de ese flujo en lugar de Aprobar, Rechazar… y Reabrir. Una transición que requiere aprobación termina en … y abre Solicitar aprobación: consulte Solicitar la aprobación de un cambio de estado. Para un requisito en línea base, Solicitar aprobación y el diálogo Aprobar… de la solicitud de cambio muestran la misma lista Requiere nueva revisión.

Congelar un documento para una revisión

  1. En el cajetín del documento, haga clic en Versión ▾.
  2. Elija Guardar línea base….

    O elija Entregar ▾ → Versión ▸ Guardar línea base….

  3. Conserve o cambie el Nombre. El predeterminado es «<document> Baseline <n>».
  4. En Aprobaciones, rellene una fila por aprobador: Nombre, Función y Declaración (predeterminada «Approved for release.»).

    + Añadir aprobador añade una fila; × quita una.

  5. Haga clic en Crear.

    El aviso dice «Línea base guardada». Versión ▾ dice «Actual · última línea base <name>».

A partir de ahora, cada fila recibe una barra de cambio cuando difiere de la última línea base.

Gestionar un cambio después de la línea base

  1. Edite el texto del requisito en el documento.

    Un aviso resume lo ocurrido, por ejemplo «1 requisito aprobado pasó a En revisión; 6 vínculos marcados para revisión.» Como parte de su edición (un solo Deshacer lo revierte todo):

    • Un requisito Aprobado pasa a En revisión.
    • Sus resultados de calidad quedan desactualizados («Calidad: desactualizada — volver a ejecutar»).
    • Sus vínculos aguas abajo se marcan para revisión.
  2. Abra Necesidades y requisitos → Vínculos por revisar.
  3. En cada fila, haga clic en Diferencias para ver el cambio de texto y revise el elemento vinculado.
  4. Cuando un elemento vinculado sigue siendo válido, haga clic en Marcar como revisado… en su fila.

    Para marcar varios a la vez, seleccione sus filas y haga clic en Marcar seleccionados como revisados….

  5. Escriba lo que comprobó y haga clic en Marcar como revisado.
  6. Vuelva a ejecutar la Comprobación de calidad.
  7. Vuelva a pasar el requisito por la aprobación.
  8. Haga clic en Versión ▾ → Comparar versiones…, elija la línea base en De y Versión actual en A.

    El informe enumera cada cambio desde la línea base.

  9. Haga clic en Cambios (Excel) para el comité de cambios.

Cerrar elementos TBD y TBR

  1. Abra Necesidades y requisitos → TBD/TBR.
  2. Lea los mosaicos: TBD/TBR abiertos, Vencidos, Sin propietario y el recuento por documento.
  3. Atienda primero las filas vencidas. Están sombreadas, con «Vencido» bajo la fecha límite.
  4. Cuando el propietario muestra «—», asigne un TBD Owner.
  5. Cuando un valor quede resuelto, edite el texto del requisito con el valor final.
  6. Haga clic en Cerrar en la fila.

    Cerrar establece TBD/TBR en None, y la fila sale del registro.

Para enviar el registro a los propietarios, haga clic en Exportar XLSX.

Importar una especificación existente

  1. Abra Necesidades y requisitos → Importar y exportar.
  2. Suelte el archivo en la zona de colocación, o haga clic en ella para elegir el archivo: Word (.docx), Excel o CSV, ReqIF o texto sin formato.

    La línea de estado dice, por ejemplo, «Se analizó “SRS.docx”: 48 filas, 5 columnas.» Formato muestra el formato detectado.

  3. Haga clic en Continuar.
  4. Compruebe a qué se asigna cada columna y establezca Clase para filas sin clase en Requirement.
  5. Haga clic en Continuar.
  6. Deje marcado Crear un documento de requisitos con estos N requisitos, compruebe el tipo y el nombre del documento, y revise los elementos nuevos y actualizados y las advertencias.
  7. Haga clic en Importar N elementos.

    Sin advertencias, Holarch abre el documento nuevo. Con advertencias, la tarjeta Importación completada las enumera.

La tarjeta Importación completada tiene botones para abrir el documento, la Base de datos, un diagrama Spider o de árbol, o la Comprobación de calidad. Un ⌘Z / Ctrl+Z quita toda la importación.

Ejemplo práctico: la demostración CubeSat EO-1

Cree el proyecto de demostración CubeSat EO-1 — Earth Observation Demo desde Gestionar proyectos. Tiene una especificación de 32 requisitos, SRS-001 EO-1 System Requirements Specification, con una línea base SRR y cambios hechos después.

Calidad.

  1. Abra Necesidades y requisitos → Calidad y haga clic en Comprobar calidad.

    Los mosaicos muestran 32 requisitos, una media del 92 %, 29 buenos y 3 que requieren revisión.

Los tres requisitos débiles están escritos así a propósito. Cada uno obtiene un 44 %:

  • 2.5 Safe Mode Recovery: «The spacecraft should recover from safe mode quickly and resume imaging as appropriate». Las sugerencias incluyen:
    • «R34 - Término(s) de rendimiento que no se puede(n) medir: [quickly]»
    • «R8 - Las cláusulas de escape debilitan el requisito: [as appropriate]»
    • «R19 - Une dos requisitos; sepárelos en requisitos independientes: [and]»
    • «Termine el enunciado con un punto.»
    • «Vincule un Test Case o un Requirement que lo verifique.»
  • 3.5 Battery Thermal Control: «…keep the battery warm enough (TBD).» Las sugerencias son «R21 - Contiene paréntesis; mueva el texto entre paréntesis a la justificación.» y «Sustituya los marcadores TBD/TBR.»
  • 6.4 Operator Interface: «…shall be user friendly and/or easy to use.» Las sugerencias son «R34 - Término(s) de rendimiento que no se puede(n) medir: [user friendly, easy to use]» y «R19 - “y/o” es ambiguo; indique si se refiere a ambos o a uno de ellos: [and/or]».

Para corregir 2.5:

  1. Reescríbalo como «The spacecraft shall resume imaging within 6 hours of a safe mode entry.»
  2. Vincule un caso de prueba con verified by.
  3. Vuelva a ejecutar la comprobación.

    Desaparecen los mensajes de combinación, de cláusula de escape y de término vago.

TBD/TBR. Abra TBD/TBR. Muestra tres elementos abiertos:

  • 3.5 Battery Thermal Control: un TBD cuyo responsable es el Thermal Engineer. Está vencido.
  • 2.4 Target Slew (ADCS Lead) y 5.3 Downlink Link Margin (Comms Lead): TBR con fecha límite posterior.

Cambio después de la línea base. La Versión ▾ del documento enumera SRR Baseline. La aprobaron J. Rivera (Systems Lead), R. Okafor (Mission Principal Investigator) y L. Brandt (Program Manager).

Después de la SRR, el requisito 3.1 Orbit Average Power cambió de 28 W a 30 W. Como 3.1 estaba Aprobado, volvió a En revisión con la nota «El texto cambió después de la aprobación».

Vínculos por revisar enumera seis vínculos desde 3.1:

  • 1.3.1 Solar Arrays
  • F3 Generate and Store Power y F3.1 Convert Sunlight to Power
  • EQ-1.1 Solar Power Generation y EQ-1.4 Power Margin Check
  • TC-06 Solar Array Power Test

Haga clic en Diferencias en cualquier fila: «28 W» aparece tachado y «30 W» insertado. Después revise los elementos:

  • TC-06 espera una potencia máxima ≥ 72 W y midió 75.1 W. A través de EQ-1.3 Orbit-Average Array Power (máximo × 0.62 de fracción iluminada × 0.6 de eficiencia de la cadena de potencia), 75.1 W equivalen a 27.9 W de media orbital, por debajo de los nuevos 30 W. Deje ese vínculo sin revisar y añada el comentario «75.1 W de pico = 27.9 W de media orbital; volver a probar frente a unos 80.6 W de pico». La prueba necesita un nuevo resultado esperado y una nueva ejecución.
  • Compruebe que el dimensionamiento del panel solar sigue cerrando antes de marcar 1.3.1 como revisado.

Comparar con la actual. Elija SRR Baseline en Versión ▾ y haga clic en Comparar con la actual en su banda. El informe enumera:

  • Los cambios de Descripción, Justificación, Estado y Puntuación de calidad de 3.1.
  • El cambio de Estado de 2.4 Target Slew (Borrador → En revisión).
  • El requisito nuevo 4.4 Downlink Encryption, con sus dos vínculos satisfies nuevos.

Aprobaciones. Abra Aprobaciones. Hay nueve requisitos En revisión, entre ellos 3.1, 1.5 Daily Collection Volume y 5.3 Downlink Link Margin.

Consejos y buenas prácticas

  • Escriba un «shall» por requisito, en voz activa, con un número, una unidad y una condición. La comprobación de calidad premia exactamente eso.
  • Ponga el motivo en Justificación, no en el enunciado. Las expresiones de finalidad («so that», «in order to») y los paréntesis se señalan como R20 y R21.
  • Rellene Verification Method mientras escribe. Así, un requisito con método pero sin caso de prueba aparece como Solo planificado en la RVTM, en lugar de No verificado.
  • Establezca TBD/TBR con un responsable y una fecha límite, en lugar de limitarse a escribir «TBD» en el texto. El atributo da al registro un responsable y una fecha límite que seguir.
  • Cree una línea base antes de cada revisión. Las barras de cambio y Comparar con la actual solo funcionan frente a una línea base.
  • Marque los vínculos como revisados con un comentario. El comentario se añade al elemento vinculado y se registra en el vínculo, de modo que la revisión deja un rastro de auditoría.

Errores habituales

SíntomaCausaSolución
Un requisito no se puntúa, no está en el registro o no está en la RVTM.Es un Statement, no un Requirement.Cambie su clase a Requirement en el inspector.
Correcto y Factible muestran ✘ en todos los requisitos.Necesitan el juicio de una persona («Requiere el juicio de un revisor»).Revise cada uno y haga clic en la ✘ para marcarlo como Sí, o ejecute la Comprobación de requisitos con IA.
La puntuación muestra «Desactualizado: volver a ejecutar».El texto cambió después de la última comprobación.Haga clic en Comprobar calidad, o active Volver a comprobar automáticamente cuando cambie el texto.
Desaparecieron las anulaciones manuales Sí/No.Editar el texto las borra.Vuelva a establecerlas tras la revisión; Deshacer las restaura, y permanecen en el Historial.
Un requisito dejó de estar Aprobado tras corregir una errata.Cualquier edición del nombre o la descripción reabre un requisito aprobado.Vuelva a aprobarlo. Corrija las erratas antes de la aprobación.
Falta «Cerrar» en una fila TBD/TBR.El elemento abierto procede solo del texto.Edite el texto para quitar TBD, TBR o TBS.
Una importación creó copias en lugar de actualizar.Emparejar entidades existentes por no encontró coincidencias.Exporte con la columna ID, edite e importe con Emparejar entidades existentes por: ID global (consulte Actualizar requisitos desde una hoja de cálculo).

Cómo se relaciona con otras funciones

  • Se alimenta de: las aportaciones de las partes interesadas y las especificaciones existentes a través de Importar, y los documentos escritos en Documentos.
  • Alimenta a:
  • IA: el menú ✦ IA ▾ del documento y de la Vista del elemento tiene Reescribir con claridad…, Añadir criterios medibles…, Simplificar…, Dividir requisito compuesto…, Redactar justificación…, Sugerir nombre… y Comprobar con IA (la Comprobación de requisitos con IA). Los cambios de la IA se muestran en vista previa antes de aplicarse. Consulte Preguntar a la IA y herramientas de IA.

La página Requisitos

Use la página Requisitos para ver y editar todos los requisitos en una tabla. Necesidades y requisitos → Requisitos es la Base de datos filtrada por class:Requirement.

Aquí funcionan todas las funciones de la Base de datos:

  • Ordenar y filtrar columnas, y editar celdas en el sitio.
  • Seleccionar filas para la barra de acciones masivas, para establecer atributos o etiquetas en muchos requisitos a la vez.
  • Exportar y abrir la Matriz de trazabilidad para las filas seleccionadas.

Haga clic en una fila para mostrar el requisito en el inspector. Haga doble clic para abrir su Vista del elemento. Un requisito con un vínculo por revisar muestra una insignia ⚠ Revisar en su fila. Haga clic derecho en una fila para ver su menú: hasta tres acciones sugeridas con sus motivos (por ejemplo ✦ Añadir criterios medibles… cuando el requisito no cumple Inequívoco, ✦ Generar caso de prueba… cuando no está verificado), ✦ Más IA ▸, y después Abrir, Cambiar nombre…, Duplicar, Añadir hijo…, Estado ▸, Prioridad ▸, Relacionar con ▸, Añadir al documento ▸, Mostrar en diagrama ▸, Copiar enlace, Copiar número y Eliminar… (consulte Menú contextual).

Consulte El modelo y la base de datos para la tabla, las consultas y la edición masiva.

Consultas útiles:

ConsultaMuestra
class:RequirementTodos los requisitos.
Requirement:"Status=In Review"La lista de Aprobaciones.
Requirement:"Status=Draft"Requisitos que aún no se han enviado a revisión.
class:Requirement AND is:leafRequisitos hoja (sin requisitos hijos).
class:Requirement AND NOT relationship:"verified by"Requisitos sin un elemento que los verifique.

Calidad de los requisitos

Use la página Calidad (título «Calidad de los requisitos») para encontrar requisitos mal redactados. Puntúa cada requisito frente a nueve criterios.

Los nueve criterios y los números de regla de las sugerencias (R2, R19, etc.) siguen las características y reglas de la Guide to Writing Requirements de INCOSE. Las listas de palabras y los patrones de Holarch se aproximan a esas reglas; no son el texto de la guía, y algunas reglas necesitan el juicio de un revisor.

  • Puntuación = 100 × (criterios cumplidos) / 9, redondeada. Un criterio que no se comprobó (–, consulte Requisitos en otros idiomas) se omite: 100 × cumplidos / 8.
  • Un 67 % o más es Bueno. Por debajo del 67 % es Requiere revisión.
  • La barra es roja por debajo del 34 %, amarilla del 34 % al 66 % y verde a partir del 67 %.

Disposición de la página

  • Encabezado de la página:
    • Más ▾: Borrar valoraciones manuales restablece cada Sí/No manual de los requisitos mostrados y vuelve a ejecutar la comprobación. Abrir en Requisitos abre los requisitos mostrados en la tabla Requisitos. Abrir documento aparece cuando el ámbito es un documento.
    • Exportar ▾: Excel (.xlsx) y CSV, de los requisitos mostrados.
    • Comprobar calidad: comprueba todos los requisitos del ámbito, independientemente de lo que muestren los filtros (la regla de duplicados compara cada requisito con los demás del ámbito).
  • ✦ IA ▾ (en la barra superior): Comprobar con IA (N requisitos)…, la Comprobación de requisitos con IA de los requisitos mostrados.
  • Barra de ámbito: Ámbito (Todos los requisitos o Documento: <name>) y la casilla Volver a comprobar automáticamente cuando cambie el texto. Vínculos por revisar, TBD/TBR y Aprobaciones están junto a Calidad en la barra de navegación.
  • Barra de consulta: + Filtro, los chips de filtro y el texto de búsqueda, Borrar, ? (sintaxis de búsqueda) y Vistas ▾: la misma barra que en la página Requisitos (consulte Filtrar la página Calidad).
  • Mosaicos: Requisitos («12 de 40» bajo Requisitos mostrados cuando los filtros ocultan algunos), Puntuación media, Bueno (≥ 67 %), Requiere revisión (< 67 %) y Desactualizado (el texto cambió) cuando hay alguno desactualizado. Las puntuaciones desactualizadas se excluyen de la media.
  • Nota bajo los mosaicos: «Las comprobaciones automáticas alcanzan como máximo 7 de 9 atributos (78 %); Correcto y Factible requieren verificación humana: haga clic en una ✘ para marcarla como Sí. Cada clic alterna entre Sí manual, No manual y de vuelta a automático.»
  • Tabla: Número, Nombre (con la descripción debajo), Puntuación de calidad, una columna por criterio y Sugerencias. Sugerencias enumera cada mensaje, precedido de su criterio. Las filas se ordenan por número. Haga clic derecho en una fila, o pulse Shift+F10 sobre ella, para ver el menú de fila de la Base de datos: acciones sugeridas con sus motivos (primero la reescritura que corrige un criterio no cumplido), ✦ Más IA ▸, Abrir, Cambiar nombre…, Duplicar, Añadir hijo…, Estado ▸, Prioridad ▸, Relacionar con ▸, Añadir al documento ▸, Mostrar en diagrama ▸, Copiar enlace, Copiar número y Eliminar…. La fila pasa a ser la selección.
  • Varias filas: ⌘ / Ctrl-clic (Ctrl-clic en Windows y Linux) alterna una fila, ⇧ / Shift-clic selecciona el intervalo desde la última fila en la que hizo clic, ⌘ / Ctrl+⇧ / Shift-clic añade ese intervalo, y ⌘A / Ctrl+A o ⇧ / Shift+↑ / ⇧ / Shift+↓ en una fila con el foco seleccionan todas las filas o amplían la selección. La barra de herramientas muestra el recuento; Esc la borra. Haga clic derecho en una fila seleccionada para actuar sobre todas: ✦ Comprobar con IA (n requisitos)…, ✦ Reescribir (n) ▸, ✦ Generar casos de prueba (n)…, ✦ Preguntar a la IA sobre estos (n)…, ✦ Sugerir trazas (n)… (cada uno con una vista previa; consulte IA sobre varios elementos seleccionados), Duplicar n entidades, Establecer estado ▸, Establecer prioridad ▸, Añadir al documento ▸ y Eliminar n elementos…; un solo Deshacer revierte cada uno. El Registro TBD/TBR y Vínculos por revisar funcionan igual; en Vínculos por revisar, la selección también marca las filas para Marcar seleccionados como revisados….

Casos especiales:

  • Una fila sin resultado muestra «No ejecutado» en la columna de puntuación.
  • Una fila desactualizada muestra «Desactualizado: volver a ejecutar».
  • Cuando el ámbito no tiene requisitos, la página muestra «No hay requisitos» y «Solo se puntúan las entidades de la clase Requirement; los Statements se omiten.»
  • Cuando los filtros o el texto de búsqueda ocultan todos los requisitos, la página muestra «No hay requisitos coincidentes» y «Ningún requisito coincide con la búsqueda o los filtros. Bórrelos para ver todos los requisitos.»

Filtrar la página Calidad

La barra de consulta funciona como en la página Requisitos (consulte Cómo se convierten en chips los filtros escritos): los términos de filtro escritos se convierten en chips al pulsar Enter, el resto del texto coincide con el nombre, el número y la descripción, Backspace en una búsqueda vacía quita el último chip y Borrar los quita todos. Los mosaicos, la tabla, Exportar ▾ y ✦ IA ▾ → Comprobar con IA siguen los filtros.

+ Filtro enumera, con recuentos para el ámbito:

GrupoFiltrosTérmino
CalidadBueno (≥ 67 %), Requiere revisión (< 67 %), No ejecutado, Desactualizado (el texto cambió), Valoraciones manuales, Hallazgo de la IAquality:good, quality:rework, quality:notrun, quality:stale, quality:manual, quality:ai
No cumple un criterioUno por criterio: valorado como Noquality:Verifiable=no (=yes: valorado como Sí)
Hallazgo de reglaLas reglas encontradas en el ámbito, como R7 Redacción imprecisa o R30 Muy parecido (posibles duplicados)quality:R7
Estructura, Clase, Atributos de requisito, Etiqueta, Relación, DiagramaComo en la página Requisitos; los Atributos de requisito se enumeran sin chip de claseis:tbd, Requirement:"Status=Draft", label:"…"

Los filtros de un mismo grupo se combinan con o; los de grupos distintos se combinan con y. Los intervalos de puntuación usan el atributo: Requirement:"Quality Score>=50". Los términos quality: también funcionan en la página Requisitos y en la Base de datos.

Vistas ▾ aplica una vista integrada (Requiere revisión, Aún no comprobado, Resultados desactualizados, Ambiguo, No verificable, Posibles duplicados, Valoraciones manuales) o una de sus vistas guardadas. Guardar vista… guarda los filtros y el texto de búsqueda actuales en este navegador, para todos los proyectos; Eliminar «<name>» aparece mientras se usa una vista guardada. Todos los requisitos borra los filtros. La dirección quality?q=<query> abre la página filtrada.

El filtrado lee los resultados guardados y no vuelve a comprobar. Con 50,000 requisitos, un cambio de filtro o de búsqueda tarda mucho menos de una décima de segundo.

Criterios y comprobaciones

Cada criterio muestra una de tres marcas:

  • ✔ (Sí): sin mensajes.
  • ✘ (No): al menos un mensaje.
  • –: no comprobado.

Las comprobaciones buscan palabras y frases completas, sin distinguir mayúsculas y minúsculas. Solo cuentan las formas enumeradas: «effective» y «effectively» están enumeradas, «effectiveness» no. También cuentan las palabras entre comillas. Los mensajes de abajo son el texto exacto que se muestra. La lista entre corchetes al final de un mensaje nombra las palabras encontradas.

Inequívoco

ReglaMensajeSe activa con
R6R6 - Unidad(es) no reconocida(s); use unidades estándar del SI, estadounidenses o imperiales: [...]Un número seguido de una palabra que no es una unidad conocida (por ejemplo «12 sorties»). Las unidades conocidas incluyen las del SI, las estadounidenses y las imperiales y sus abreviaturas, %, grados, °C y °F.
R2R2 - Use la voz activa: [...]«shall/must/will/should be» seguido de un participio pasado («shall be measured»).
R5R5 - Use artículos definidos (“el”, “la”) en lugar de: [...]«a» o «an».
R7R7 - Redacción imprecisa: [...]some, many, several, few, little, much, various, appropriate(ly), adequate(ly), efficient(ly), effective(ly), sufficient(ly), reasonable, reasonably, suitable, suitably, significant(ly), minimal(ly), maximal(ly), approximately, almost, nearly, generally, usually, typically, normally, robust(ly), flexible, flexibly, easy, easily, etc, similar, relevant, substantial(ly), large, small, good, bad, better, best, worst, proper, properly, acceptable, acceptably, accurate(ly), extreme, high-contrast, high contrast.
R8R8 - Las cláusulas de escape debilitan el requisito: [...]if necessary, where possible, as appropriate, as practicable, as far as possible, if practical, as required, as needed, to the extent possible, if possible.
R10R10 - Locución(es) de infinitivo innecesaria(s): [...]to be designed to, to be able to, to be capable of, to enable, to allow, be able to, be capable of.
R16R16 - Evite la negación: [...]not, n't, never.
R17R17 - Evite la barra oblicua (“/”).Una barra entre dos palabras, salvo km/h, m/s, and/or y sus equivalentes en alemán, francés, español, italiano y neerlandés.
R24R24 - Pronombre(s) en lugar de sustantivos explícitos: [...]it, its, they, them, their, he, she, him, her, someone, something, anyone, anything, anybody, somebody, this, these, those.
R32R32 - Use “cada” en lugar de cuantificadores universales: [...]all, any, both, every, everything, everyone.
R34R34 - Término(s) de rendimiento que no se puede(n) medir: [...]fast, quick, quickly, user friendly, user-friendly, high speed(s), high-speed, best practice(s), state of the art, state-of-the-art, seamless(ly), intuitive(ly), easy to use, timely, rapid, rapidly, real-time, real time. «Real-time clock» no cuenta: nombra un componente.
R35R35 - Palabra(s) de tiempo poco clara(s): [...]as, eventually, before, after, until, meanwhile, simultaneous(ly), soon, later, sometimes, occasionally, often, subsequently, previously.
—Sustituya los marcadores TBD/TBR.TBD, TBR o TBS en la descripción (en mayúsculas).
—IA: ambiguo — <reason>Un hallazgo de la IA aceptado de la Comprobación de requisitos con IA.
—Indica un máximo (“hasta”); si se refiere a un mínimo, use “al menos”.«up to» seguido de un número, en cifras o en letras («up to 72 hours», «up to five tonnes»). «Up to date» no cuenta.

Completo

ReglaMensajeSe activa con
—Falta la descripción.Una descripción vacía.
—Falta el nombre.Un nombre vacío.
R9R9 - Redacción de lista abierta: [...]including but not limited to, etc, and so on, and so forth, such as, among others.

Singular

ReglaMensajeSe activa con
R18R18 - Escriba una sola oración (se encontraron N).Más de una oración (también oraciones japonesas y chinas que terminan en 。, ! o ?).
—Termine el enunciado con un punto.Una descripción que no termina en «.» (o 。).
R19R19 - Une dos requisitos; sepárelos en requisitos independientes: [...]and, or, but, however o whereas uniendo dos acciones o dos obligaciones («shall log and report each fault», «… and the operator shall …»), «nor shall», una segunda cláusula tras «;»; «and/or» antes de una segunda acción. Consulte Dos requisitos en uno (R19).
R19R19 - “y/o” es ambiguo; indique si se refiere a ambos o a uno de ellos: [and/or]«and/or» entre valores o en una condición.
R19R19 - Une dos valores; sepárelos si cada uno se verifica por separado: [...]and, or uniendo dos objetos o valores tras una sola acción («measure the temperature and the humidity»). Una nota: Singular sigue en Sí.
R20R20 - Contiene expresiones de finalidad; muévalas a la justificación: [...]purpose of, in order to, so that, for the purpose of, so as to.
R21R21 - Contiene paréntesis; mueva el texto entre paréntesis a la justificación.«(» o «[» (también corchetes de ancho completo).

Conforme

MensajeSe activa con
Use un verbo modal: [need, shall, will, should, must]No aparece ninguna de estas palabras.

Apropiado

ReglaMensajeSe activa con
R31R31 - Impone una solución: [...]using, by means of, utilizing, utilising, implemented in, implemented with, via a, via the, built with, written in.

Necesario

ReglaMensajeSe activa con
R30R30 - Muy parecido a: [3.2 Battery Capacity (81.3 % de similitud), ...]Otro requisito del ámbito cuya descripción es al menos un 75 % similar (similitud por pares de caracteres). El hallazgo nombra hasta cinco y cuenta el resto («y 3 más»). El padre directo y los hijos del requisito (decomposed by, decomposes) no se comparan: un refinamiento suele repetir la redacción de su padre. Los hermanos y los requisitos no relacionados sí.

Verificable

MensajeSe activa con
Vincule un Test Case o un Requirement que lo verifique.El requisito no tiene ningún vínculo verified by con un Requirement o un Test Case.
IA: no verificable tal como está redactado — <reason>Un hallazgo de la IA aceptado de la Comprobación de requisitos con IA.

Factible

ReglaMensajeSe activa con
R26R26 - Término(s) absoluto(s) rara vez alcanzable(s): [...]always, never, 100%, 100 percent, all the time, totally, completely, absolutely, zero defects, forever, continuous, continuously, uninterrupted.
—Requiere el juicio de un revisorNo se encontraron términos absolutos ni casi duplicados; una persona debe decidir.

Correcto

MensajeSe activa con
Requiere el juicio de un revisorTodas las comprobaciones de texto (Apropiado, Completo, Conforme, Necesario, Singular, Inequívoco) se superaron; una persona debe decidir.

Como Correcto y Factible terminan con «Requiere el juicio de un revisor» hasta que alguien decide, la puntuación automática más alta es 7 de 9 (78 %).

Dos requisitos en uno (R19)

Un requisito enuncia una sola cosa. R19 examina cada «and», «or», «nor», «but», «however», «whereas», «as well as» y «and/or» y lo clasifica en uno de estos tipos:

TipoEjemploResultado
Dos requisitos«The unit shall log and report each fault.» «The pump shall stop, and the operator shall be alerted.» «… to acknowledge alarms and to silence the horn.» «…; it shall also …»Un hallazgo. Singular es No.
«and/or» ambiguo«The log shall record the user ID and/or the badge number.»Un hallazgo: indique si se refiere a ambos o a uno de ellos. Singular es No.
Dos valores«The station shall measure the temperature and the humidity.»Una nota: divídalo si cada valor se verifica por separado. Singular sigue en Sí; la nota se muestra en gris y no baja la puntuación.
Sin hallazgo«between 5 °C and 30 °C»; «When A and B, the unit shall …»; «… when the door is open and the fan is off»; «requirements 2.1 and 2.2»; texto entre comillas; «The command and control unit shall …»; «ASME Boiler and Pressure Vessel Code»; «5 Nm at 3000 rpm and 24 V»; «including batteries and strap»; «either open or closed»Nada.

Dos valores de una misma magnitud («at -20 °C and 60 °C») reciben la nota. Un «, and» termina una condición: «… when the level falls below 10 %, and restart when …» es un hallazgo. Un sujeto que actúa como uno solo («The Owner and the Contractor shall agree …», «The power and data connector shall …») no recibe nota; dos sujetos que actúan cada uno («The pump and the valve shall close …») reciben la nota. Los comparadores («12 or more») no se señalan. Un nombre tras la acción no se puede distinguir de dos valores, así que inclúyalo en Nombres compuestos.

Nombres compuestos. En la página Calidad, Más ▾ → Nombres compuestos… abre la lista del proyecto de nombres que contienen «and» u «or» pero designan una sola cosa, uno por línea (por ejemplo «power and data connector»). R19 no los señala. También cuentan las expansiones del glosario de acrónimos del proyecto (los Statements de acrónimos; consulte Buscar acrónimos), y hay unos pocos nombres comunes integrados («command and control», «research and development», «operations and maintenance», …). La lista se guarda con el proyecto y se puede deshacer. Haga clic de nuevo en Comprobar calidad para aplicar un cambio.

Requisitos en otros idiomas

Holarch detecta el idioma de cada requisito a partir de su texto. Las reglas de palabras (R2–R10, R16, R19, R20, R24, R26, R31–R35, «up to», el verbo modal, las unidades) puntúan los requisitos en inglés.

Alemán, francés y español (beta). Estos requisitos reciben las mismas reglas en su propio idioma, por ejemplo «angemessen» o «bei Bedarf» en alemán, «approprié» o «si possible» en francés, «adecuado» o «según corresponda» en español. Mientras las reglas de un idioma están en beta:

  • cada hallazgo es una sugerencia marcada (beta). Se muestra en gris con las demás notas y nunca baja un criterio ni la puntuación;
  • se muestra la nota «Las reglas de redacción de este idioma están en beta: solo sugerencias, sin puntuación. Se aplican las comprobaciones de estructura.», e Inequívoco queda en – (no comprobado) hasta que la redacción se comprueba con IA o se valora a mano;
  • las palabras para «each» (jede, chaque, cada) son la elección correcta y no se señalan, como tampoco «alle 5 s» ni «tous les 5 s» (cada 5 s).

Una regla empieza a contar para un idioma solo después de medirse en al menos 300 enunciados escritos en ese idioma y revisados por un ingeniero de requisitos nativo (al menos el 90 % de sus hallazgos correctos), y de que el revisor la haya aprobado. Cuando eso ocurre, las puntuaciones de ese idioma pueden cambiar en la siguiente comprobación; las notas de la versión lo indican.

Otros idiomas (japonés, italiano, chino y el resto) reciben:

  • la nota «Las reglas de redacción cubren el inglés. Se aplican las comprobaciones de estructura.» y – (no comprobado) en Inequívoco: se excluye de la puntuación hasta que la redacción se comprueba o se valora a mano. Otro hallazgo de Inequívoco, como un TBD, sigue haciéndolo fallar;
  • las comprobaciones para cualquier idioma: R18 (también 。), el punto final (también 。), R17, R21, TBD/TBR, R30, el nombre, la descripción y el vínculo de verificación.

Todos los idiomas, en beta o no, reciben también esas comprobaciones. Las sugerencias se guardan en inglés con las palabras citadas tal como están escritas («R7 - Imprecise wording: [angemessen] (beta)»), de modo que el filtro quality:R7 y las exportaciones funcionan igual en todos los idiomas. La API pública las devuelve con su regla, sus palabras y su modo (findings).

Comprobar redacción con IA. ✦ IA ▾ → Comprobar redacción con IA… en la página Calidad (o ✦ Más IA ▸ en un requisito) aplica las mismas reglas a través de la IA configurada en el propio idioma de cada requisito. La vista previa enumera los hallazgos y una reescritura opcional en ese idioma (desmarcada). Aplicar seleccionados añade los hallazgos como hallazgos de la IA y quita la nota (las sugerencias beta se quedan como notas), como un paso de deshacer. Editar el texto los borra. Requiere un plan con IA.

Anulaciones manuales

Anule un criterio cuando no esté de acuerdo con el resultado automático, o para registrar la decisión de un revisor.

  • En la página Calidad: haga clic en una celda de criterio para alternarla: el primer clic establece un Sí manual (✔), el siguiente un No manual (✘), y el tercero borra el valor manual para que vuelva a decidir la comprobación automática. Una celda manual muestra un marcador manual; su información sobre herramientas dice «(establecido manualmente)» y qué hace el siguiente clic.
  • En el inspector o en la Vista del elemento: cada criterio es una lista con Sí y No. Un criterio establecido a mano también ofrece Automático (volver a comprobar), que lo devuelve al resultado automático. Los valores establecidos a mano muestran «manual».

Un valor manual se conserva cuando se vuelve a ejecutar la comprobación. Un No manual sin ningún otro mensaje muestra «Marcado como No manualmente.»

Las anulaciones se borran en dos casos:

  • Cambia el nombre o la descripción del requisito. Las anulaciones permanecen en el Historial, y Deshacer las devuelve.
  • Elige Más ▾ → Borrar valoraciones manuales. Esto también borra los hallazgos de la IA aceptados.

Resultados desactualizados

Cuando el nombre o la descripción de un requisito cambia después de una comprobación, sus resultados se marcan como desactualizados:

  • La página Calidad muestra «Desactualizado: volver a ejecutar» con la información sobre herramientas «El texto cambió después de la última comprobación. Vuelva a ejecutar la Comprobación de calidad.»
  • La columna Puntuación de calidad de un documento muestra una etiqueta Desactualizado con un icono de reloj (sitúe el puntero sobre ella para ver el motivo).
  • El inspector muestra «Calidad: desactualizada — volver a ejecutar».

Active Volver a comprobar automáticamente cuando cambie el texto para evitar resultados desactualizados. Holarch vuelve a ejecutar entonces la comprobación de reglas en el requisito editado de inmediato. El ajuste se guarda en este navegador.

Comprobar calidad desde un documento

En un documento, elija Comprobar ▾ → Comprobar calidad. Con un requisito seleccionado, el elemento dice Comprobar la calidad de este requisito y comprueba ese. Sin ningún requisito seleccionado, comprueba todos los requisitos visibles del documento.

Los resultados se abren en el diálogo Comprobar calidad — <name>, con los mosaicos y la tabla. Sus botones son Exportar CSV, Exportar XLSX, Abrir en Calidad y Cerrar.

Un documento sin requisitos muestra «Este documento no tiene Requirements que comprobar. Los Statements no se puntúan.»

Comprobación de requisitos con IA

Use la Comprobación de requisitos con IA para tener una primera opinión sobre los criterios que una regla no puede decidir: Correcto, Factible y Necesario. También busca redacción que las reglas pasan por alto en Inequívoco (por ejemplo «up to 72 hours» cuando parece referirse a un mínimo, o «accurately» sin ninguna medida) y en Verificable (ninguna prueba, análisis, inspección o demostración podría mostrar que el requisito se cumple tal como está redactado). La IA recibe los hallazgos de las reglas e informa solo de lo que estas pasan por alto.

  1. Elija ✦ IA ▾ → Comprobar con IA (N requisitos)….

    Para un solo requisito, elija Comprobar con IA (este requisito)… en su menú ✦ IA ▾, o ✦ Más IA ▸ → ✦ Comprobar con IA… en su menú contextual.

    Claude revisa los requisitos. Se envían en grupos de 20, con hasta 300 requisitos más para las comprobaciones de duplicados. Con la IA incluida, la comprobación cuenta una solicitud por cada 100 requisitos (redondeando hacia arriba); antes de ejecutar una comprobación de más de 100 requisitos, un diálogo indica cuántas usa, por ejemplo «Esta revisión usa 3 de las 52 solicitudes de IA incluidas que le quedan este mes (1 solicitud por cada 100 requisitos).» Una comprobación que necesita más solicitudes de las que quedan no se inicia.

  2. Revise cada requisito en el diálogo.

    La línea superior indica qué empieza marcado: «Se aplican los elementos marcados. Las reescrituras empiezan desmarcadas para que las lea primero. Los requisitos bloqueados, aprobados y en línea base empiezan desmarcados.»

  3. Marque los cambios y las reescrituras que acepte.

    La línea encima de los botones cuenta lo que hace Aplicar, por ejemplo «Aplica 7 valores y 2 reescrituras a 5 requisitos.» Sin nada marcado dice «Nada seleccionado.» y Aplicar seleccionados aparece atenuado.

  4. Haga clic en Aplicar seleccionados.

    Los elementos marcados se aplican, y un solo Deshacer lo revierte todo. El aviso dice «Se aplicaron N cambios de la IA».

Para cada requisito, el diálogo muestra:

  • Un veredicto Sí/No y un motivo para Correcto, Factible, Necesario, Inequívoco y Verificable.
  • Bajo cada veredicto, una casilla con una etiqueta que indica lo que cambia al aplicarlo, o «sin cambios» sin casilla cuando el valor guardado ya coincide:
    • Correcto, Factible y Necesario: «No → Sí» o «Sí → No» cuando el veredicto difiere del valor guardado, «Establecer en Sí» o «Establecer en No» cuando no hay ninguno.
    • Inequívoco y Verificable: «Añade un hallazgo» cuando la IA encontró un problema, y «Borra el hallazgo anterior» cuando un hallazgo anterior de la IA ya no se sostiene.
  • Un comentario opcional.
  • Cuando la IA propone una, una casilla Aplicar la reescritura: con las diferencias palabra por palabra.

Qué empieza marcado:

  • Todos los cambios de valor empiezan marcados.
  • Las reescrituras empiezan desmarcadas, para que las lea primero.
  • Los requisitos aprobados, en línea base y bloqueados empiezan desmarcados y se señalan.

Marcar una reescritura atenúa las casillas Inequívoco y Verificable de ese requisito y las etiqueta «Comprobado de nuevo tras la reescritura»: las comprobaciones de reglas se vuelven a ejecutar sobre el texto nuevo. Desmarcar la reescritura restaura las casillas como estaban. Correcto, Factible y Necesario se siguen aplicando.

BotónEfecto
Seleccionar todos los cambios de valorMarca todos los cambios de valor, excepto en los requisitos aprobados, en línea base y bloqueados.
Seleccionar todas las reescriturasMarca todas las reescrituras, excepto las señaladas.
No seleccionar nadaDesmarca todo.

Qué hace Aplicar:

  • Correcto, Factible y Necesario pasan a ser valores Sí/No manuales.
  • Un No en Inequívoco o Verificable pasa a ser un hallazgo de la IA: la página Calidad lo enumera con los hallazgos de las reglas, como «IA: ambiguo — <reason>» o «IA: no verificable tal como está redactado — <reason>», y el criterio muestra ✘. Un Sí quita un hallazgo anterior de la IA.
  • Los hallazgos de la IA se borran cuando cambia el nombre o la descripción del requisito (también por una reescritura aceptada) y con Más ▾ → Borrar valoraciones manuales.

Qué hace Aplicar seleccionados:

  • Los veredictos pasan a ser valores manuales, con el mensaje «IA: <reason>». Se conservan cuando se vuelve a ejecutar la comprobación.
  • Las reescrituras reemplazan la descripción y vuelven a ejecutar la comprobación.

Exportaciones de calidad

ExportaciónContenido
Exportar ▾ → CSV (quality_report.csv)Una fila por requisito y criterio: Número, Nombre, Descripción, Puntuación de calidad, Atributo, Mensaje, Resultado.
Exportar ▾ → Excel (.xlsx) (quality_report.xlsx)Número, Nombre, Descripción, Justificación, Puntuación de calidad, Atributo, Mensaje, Resultado, con las celdas del requisito combinadas en sus nueve filas, Sí en verde y No en rojo, y una Puntuación del informe (respuestas Sí sobre el total de respuestas) al final.
Entregar ▾ → Todas las exportaciones… → Hallazgos de calidad (Excel) del documentoLa misma disposición para un documento, con las columnas de visualización del documento.

Aprobaciones

Use Necesidades y requisitos → Aprobaciones para ver todo lo que espera una decisión. Abre la Base de datos con la consulta Requirement:"Status=In Review".

Tiene todas las funciones de la Base de datos:

  • Seleccione varias filas y use la barra de acciones masivas para establecer el Estado o las etiquetas a la vez.
  • Exporte la lista.
  • Haga doble clic en una fila para ver la Vista del elemento y el historial completo.

El cuadro de aprobación

El cuadro de aprobación aparece en el inspector y en la Vista del elemento de cada requisito. Muestra:

  • El estado actual como un chip de color (Borrador cuando no hay ninguno establecido).
  • La última decisión registrada: «<status> por <name> · <date and time>», seguida de «— <note>» cuando hay una (por ejemplo «— El texto cambió después de la aprobación»), o «No hay aprobación registrada».
  • Los botones que corresponden al estado actual:
BotónSe muestra cuandoEfecto
AprobarEl Estado no es Aprobado ni RechazadoEstablece Aprobado y registra quién y cuándo. Aviso: «Aprobada».
Rechazar…El Estado no es Aprobado ni RechazadoPide un Motivo (opcional) en el diálogo Rechazar requisito y después establece Rechazado. Aviso: «Rechazada».
ReabrirEl Estado es Aprobado o RechazadoEstablece En revisión. Aviso: «Movido a En revisión».

El nombre registrado es el nombre de su cuenta. Establecer el Estado a mano en una tabla o en el inspector también registra una decisión con su nombre y la hora. Los lectores ven el cuadro sin botones.

Cuando un flujo de trabajo envía el paso a Aprobado a través de una solicitud de cambio, el cuadro muestra en su lugar la solicitud abierta y su recuento, por ejemplo CR-4: 1 de 3 aprobaciones. Una vez aplicada, la decisión nombra a cada aprobador y la solicitud: «Aprobado por Ann Lead, Bob Discipline · <date and time> · CR-4».

Nota: editar el nombre o la descripción de un requisito Aprobado lo pone En revisión, con la nota «El texto cambió después de la aprobación». El aviso informa «N requisito(s) aprobado(s) pasaron a En revisión.» Cambiar otros atributos no lo reabre.

Registro de TBD/TBR

Use el registro para seguir cada elemento abierto hasta que se cierre. Abra Necesidades y requisitos → TBD/TBR. Desde un documento, elija Comprobar ▾ → Registro TBD/TBR para abrir el registro limitado a ese documento.

  • Encabezado de la página: Exportar XLSX (desactivado cuando el registro está vacío).
  • Barra de ámbito: Ámbito (Todos los requisitos o Documento: <name>).
  • Mosaicos: TBD/TBR abiertos, Vencidos, Sin propietario y los chips Por documento («<document>: <count>») que abren cada documento.
  • Elementos abiertos a lo largo del tiempo: un gráfico de avance del recuento de abiertos. Se reconstruye a partir del historial de los requisitos, con hasta 60 puntos desde el requisito más antiguo hasta ahora. Sitúe el puntero sobre un punto para ver su fecha y su recuento. Con muy poco historial muestra «Aún no hay historial suficiente para un gráfico de avance.»
  • Columnas de la Tabla:
    • Número, y Nombre con la descripción.
    • Documento.
    • Tipo: TBD, TBR o TBS, con «atributo», «en el texto» o ambos.
    • Owner: el TBD Owner; si no, el Owner del requisito; si no, «—».
    • Fecha límite: la única fecha límite del requisito, la misma que Fecha límite en el grupo Flujo de trabajo del inspector y en la Vista del elemento. Es el atributo TBD Due Date cuando contiene una fecha; si no, la fecha límite del requisito. Muestra «Vencido» bajo una fecha pasada. Las filas vencidas están sombreadas.
    • Antigüedad: días desde que se abrió el elemento.
    • Cerrar.

Haga clic derecho en una fila, o pulse Shift+F10 sobre ella, para ver el mismo menú de fila que en la Base de datos: acciones sugeridas con sus motivos, ✦ Más IA ▸, Abrir, Cambiar nombre…, Duplicar, Añadir hijo…, Estado ▸, Prioridad ▸, Relacionar con ▸, Añadir al documento ▸, Mostrar en diagrama ▸, Copiar enlace, Copiar número y Eliminar…. En otros menús contextuales, un requisito con un TBD o TBR abierto empieza con Resolver TBD…, que abre este registro con el requisito seleccionado.

El registro es de solo lectura. Para cambiar una fecha límite, seleccione la fila y establezca Fecha límite en el inspector. Holarch establece la fecha límite del requisito y, cuando el atributo TBD Due Date contiene una fecha, también ese atributo (conservando su hora del día), y un solo Deshacer lo revierte todo. Borrar Fecha límite borra ambas.

Cerrar solo aparece cuando el atributo TBD/TBR está establecido. Establece el atributo en None:

  • Si no queda nada en el texto, el aviso dice «Cerrado».
  • Si aún hay TBD, TBR o TBS en el texto, el aviso dice «Atributo cerrado; el texto aún contiene TBD.»
  • Un elemento que solo está en el texto no tiene botón Cerrar; edite el texto para cerrarlo.

Cuando no hay nada abierto, la página muestra «No hay elementos TBD/TBR abiertos. Establezca el atributo TBD/TBR de un requisito o escriba TBD, TBR o TBS en su texto para listarlo aquí.»

Exportar XLSX escribe TBD-TBR Register.xlsx con Número, Nombre, Documento, Tipo, Origen (atributo, texto o ambos), Owner, Fecha límite, Abierto, Antigüedad (días), Vencido (Sí en rojo) y Descripción.

Use Vínculos por revisar (en otras herramientas, vínculos sospechosos) para encontrar lo que hay que volver a comprobar después de que cambie un requisito. Un vínculo requiere revisión cuando el elemento de su otro extremo cambió después de la última revisión del vínculo: compruebe que el vínculo sigue siendo válido y márquelo como revisado. Necesidades y requisitos → Vínculos por revisar los enumera. Desde un documento, use Comprobar ▾ → Vínculos por revisar.

Estos cambios en un requisito marcan sus vínculos para revisión:

  • Nombre o Descripción.
  • Prioridad, Criticality, Verification Method o Nivel de verificación.
  • Cualquier atributo numérico, de porcentaje o de duración.

Holarch marca entonces cada vínculo del requisito de estos tipos: decomposed by, derived by, refined by, satisfied by, verified by y traced to.

Un cambio de Verification Method o de Nivel de verificación marca solo los vínculos verified by. Establecer el primer método o nivel de un requisito no marca nada: planifica la verificación y no cambia nada que se haya revisado.

El otro extremo de cada vínculo es el elemento por revisar: el requisito hijo, la función o el activo que lo satisface, el caso de prueba que lo verifica, etc. Los cambios posteriores en el mismo requisito se añaden a la lista de campos cambiados de la misma marca.

  • Página Vínculos por revisar: una fila por vínculo por revisar.
  • Documentos y Base de datos: una insignia ⚠ Revisar en la fila del elemento («El elemento del otro extremo cambió después de la última revisión de este enlace. Compruebe que el enlace sigue siendo válido y márquelo como revisado. Haga clic para revisar.»).
  • Inspector y Vista del elemento: una banda «⚠ Revisar: <requirement> cambió después de la última revisión de este vínculo. Compruebe que el vínculo sigue siendo válido y márquelo como revisado.» Su botón Revisar… abre el diálogo Vínculos por revisar — <item> de ese elemento, con Abrir enlaces que revisar y Cerrar.
  • La sección Traza del inspector: un ⚠ junto a cada vínculo por revisar, con los campos cambiados y la fecha en su información sobre herramientas.
  • RVTM: un ⚠ tras un requisito con un vínculo por revisar en cualquiera de sus extremos (cambió, o cambió el elemento del que depende); haga clic en él para revisar esos vínculos. Un ⚠ tras un caso de prueba en Verificado por marca ese vínculo de verificación.

La página explica la regla en la parte superior y muestra una tabla:

ColumnaContenido
(casilla)Seleccionar para Marcar seleccionados como revisados…. La casilla del encabezado selecciona todo.
CambiadoEl requisito que cambió.
CambioLos campos que cambiaron, por ejemplo «Descripción» o «Prioridad, Nivel de verificación».
Cuándo / PorLa fecha y la hora del cambio y quién lo hizo.
RelaciónEl tipo de vínculo, leído desde el requisito cambiado (por ejemplo «satisfied by»).
Elemento por revisarEl elemento del otro extremo del vínculo.
(acciones)Diferencias y Marcar como revisado….

Haga clic derecho en una fila, o pulse Shift+F10 sobre ella, para ver el menú de fila del elemento, como en la Base de datos: acciones sugeridas, ✦ Más IA ▸, Abrir, Cambiar nombre…, Duplicar, Añadir hijo…, Estado ▸, Prioridad ▸, Relacionar con ▸, Añadir al documento ▸, Mostrar en diagrama ▸, Copiar enlace, Copiar número y Eliminar…. En otros menús contextuales (Base de datos, documentos), un elemento con un vínculo por revisar empieza con Revisar vínculo…, que abre su revisión.

Diferencias abre Cambio — <requirement> con las diferencias palabra por palabra del nombre y la descripción. Cuando solo cambiaron atributos, dice «Solo cambiaron atributos: <fields>. Abra el historial del elemento para ver los detalles.» Historial… abre el historial del requisito.

Para marcar vínculos como revisados:

  1. Haga clic en Marcar como revisado… en una fila, en Marcar seleccionados como revisados… para las filas marcadas, o en Marcar todos como revisados (N)….

    Se abre Marcar N vínculo(s) como revisado(s): «Confirme que los elementos enlazados siguen siendo válidos tras el cambio. Se añade un comentario a cada elemento enlazado.»

  2. Escriba un comentario opcional, por ejemplo «El hijo sigue siendo válido; no hace falta ningún cambio.»
  3. Haga clic en Marcar como revisado.

    El aviso dice «N vínculos marcados como revisados.»

Marcar seleccionados como revisados… sin nada seleccionado muestra «Seleccione primero los enlaces que marcar como revisados.»

Marcar un vínculo como revisado registra la revisión en el vínculo: quién, cuándo, el comentario y los campos. Si escribió un comentario, Holarch también añade «Vínculo revisado (<requirement> cambió: <fields>): <comment>» a los comentarios de cada elemento. Deshacer lo revierte.

Sin vínculos por revisar, la página muestra «No hay enlaces que revisar. Un enlace requiere revisión cuando el elemento de su otro extremo cambia después de la última revisión del enlace.»

Líneas base y comparación de versiones

Líneas base de documentos

Cree y use líneas base de documento con Versión ▾ en el cajetín del documento. Enumera:

  • Versión actual: el documento en vivo.
  • Cada línea base de este documento, de la más reciente a la más antigua, con su fecha.
  • En Líneas base del proyecto, cada línea base del proyecto.
  • Guardar línea base… y Comparar versiones… (atenuado hasta que el documento tiene una línea base: «Guarde primero una línea base»).

Guardar línea base… abre Guardar línea base:

  • Nombre * (obligatorio).
  • Aprobaciones: filas de Nombre, Función y Declaración, con + Añadir aprobador. La primera fila se rellena con su nombre. «No hay aprobadores.» cuando está vacía.
  • La nota «La línea base conserva esta versión del documento (sus elementos, sus atributos y relaciones) para verla, compararla y restaurarla más adelante. Los registros de aprobación se fechan ahora y no se pueden editar después.»

Elija una línea base en Versión ▾ para verla. El documento pasa a ser de solo lectura, con la banda «Línea base “<name>”, solo lectura, guardada el <date>» y la lista de aprobaciones. Aparecen estos botones:

BotónEfecto
Volver a la versión actualVuelve al documento en vivo.
EditarEditar línea base: cambiarle el nombre y añadir registros de aprobación. Aprobaciones (bloqueadas) enumera los registros existentes, que no pueden cambiar; los registros nuevos «se fechan ahora y se añaden a la lista». Solo líneas base de documento.
Comparar con la actualAbre Comparar versiones desde esta línea base. Solo líneas base de documento.
Restaurar línea baseLínea base de documento: «¿Sobrescribir las entidades, el orden y la estructura de este documento con la línea base «<name>»? Las entidades añadidas desde entonces se quitan del documento (no se eliminan). Se puede deshacer.» Línea base de proyecto: Reemplazar el proyecto por la línea base, «¿Reemplazar todo el proyecto por la línea base de proyecto «<name>»? Se puede deshacer.»
Eliminar«¿Eliminar la línea base «<name>»?»

En el documento en vivo, cada fila lleva una barra de cambio: nueva desde la línea base, modificada desde la línea base o sin cambios. Compara con la última línea base del documento, o con la última línea base del proyecto si el documento no tiene ninguna.

Comparar versiones

Use el informe de cambios para ver exactamente qué cambió desde una revisión.

  1. Haga clic en Versión ▾ → Comparar versiones…, o en Comparar con la actual en la banda de una línea base.

    Se abre Comparar versiones.

  2. Elija De: una línea base.
  3. Elija A: una línea base posterior o Versión actual.

    La tabla enumera Número, Nombre, Cambiar tipo, Campo y Cambio (diferencias palabra por palabra en el texto modificado).

Tipos de cambio:

Tipo de cambioSignificado
Añadido / QuitadoLa entidad entró en el documento o salió de él.
ModificadoCambió un campo: Nombre, Número, Descripción, Clase, Imagen o cualquier atributo (se nombra el campo).
Etiqueta añadida / Etiqueta quitadaSe añadió o se quitó una etiqueta.
Relación añadida / Relación quitadaSe añadió o se quitó un vínculo que toca el documento.
Atributo de relaciónCambiaron los atributos de una relación.

Cambios (Excel) escribe «<document> (Changes).xlsx» con Número, Nombre, Clase, Tipo de cambio, Campo, Valor anterior y Valor nuevo. Cambios marcados (Word) escribe la misma comparación como control de cambios de Word.

Entregar ▾ → Cambios (Excel)… del documento (también en Todas las exportaciones…) exporta el mismo informe con De y A. Falla con «Este documento no tiene línea base. Guarde primero una.» cuando no hay ninguna.

Documento (Word) rellena las tablas Historial de revisiones y Aprobaciones de la salida de Word a partir de las líneas base del documento.

Página Líneas base y versiones

Use Control y revisiones → Líneas base y versiones para gestionar todas las líneas base del proyecto. Las líneas base de proyecto contienen todas las entidades; las líneas base de documento contienen un documento y se crean con Versión ▾ → Guardar línea base… del documento. El encabezado de la página tiene Restaurar una versión anterior…, que recupera un guardado automático anterior de todo el proyecto, y + Guardar línea base….

Para crear una línea base de proyecto:

  1. Haga clic en + Guardar línea base… en el encabezado de la página.

    El diálogo Guardar línea base del proyecto muestra los recuentos actuales de entidades y relaciones. El nombre predeterminado es «Baseline <n>»; el texto de ejemplo dice «Nombre, por ejemplo «SRR»».

  2. Escriba un nombre y pulse Enter o haga clic en Guardar línea base. Un nombre vacío se rechaza («Introduzca un nombre.»).

    El aviso dice «Línea base guardada».

Las tarjetas de la página:

  • Tarjeta Líneas base: los recuentos actuales («Actual: <n> elementos, <n> relaciones») y un filtro: Todas las líneas base, Líneas base de todo el proyecto o Documento: <name>. Columnas:
    • Nombre.
    • Documento: un vínculo para ver el documento en esa línea base, o «Proyecto».
    • Creado.
    • Aprobaciones: «✔» y los nombres de los aprobadores. Sitúe el puntero sobre ellos para ver la función, la fecha y la declaración. «por <name>» nombra al creador.
    • Entidades y Relaciones.
    • Comparar: establece esta línea base como De y la copia de trabajo actual como A.
    • ⋯ (Más acciones):
      • Cambiar nombre…: Cambiar nombre de la línea base.
      • Exportar (JSON): descarga «<name>.json» (formato holarch-baseline, con la instantánea y las aprobaciones).
      • Restaurar línea base… (línea base de proyecto): «¿Reemplazar todas las entidades y relaciones actuales por la línea base «<name>»? Se puede deshacer (⌘Z / Ctrl+Z).» Aviso: «Se restauró «<name>»».
      • Revertir documento… (línea base de documento): «¿Restaurar el documento «<doc>» a la línea base «<name>»? Solo cambian las entidades y la estructura de ese documento. Se puede deshacer.» Desactivado cuando el documento se eliminó.
      • Eliminar…. En el servicio alojado, solo los propietarios del proyecto cambian el nombre de una línea base o la eliminan; para los demás, estos elementos aparecen atenuados con el motivo.
  • Líneas base huérfanas (se muestra cuando hace falta): «N líneas base de documentos eliminados». Cada una tiene Restaurar documento, que vuelve a crear el artefacto del documento y sus entidades a partir de la línea base, y Eliminar.
  • Tarjeta Comparar: elija Desde (anterior) y Hasta (posterior). Hasta es Versión actual u otra línea base del mismo ámbito.
    • Mosaicos: Entidades añadidas, Entidades quitadas, Entidades modificadas, Cambios de relaciones.
    • La tabla muestra Entidad, Cambio, Campo y Diferencia (diferencias palabra por palabra). Los atributos de fecha se muestran en el formato de fecha de la aplicación.
    • Exportar CSV y Exportar XLSX escriben «Changes <from> to <to>».
    • Sin nada que mostrar: «No hay diferencias entre “<from>” y “<to>”.»

Sin líneas base: «No hay líneas base. Cree una para registrar el estado actual del proyecto.»

Nota: las líneas base se guardan en el proyecto y viajan con él en una exportación del proyecto. Una línea base de proyecto contiene entidades y relaciones. Una línea base de documento también contiene los ajustes del esquema del documento.

Importar requisitos

Use Necesidades y requisitos → Importar y exportar para traer requisitos desde archivos. Funciona en cuatro pasos: Archivo → Asignar → Revisar → Importar.

  • Atrás y Continuar se mueven entre los pasos. Importar N elementos en el paso Revisar importa, y un solo Deshacer lo revierte todo.
  • Una sola zona de colocación admite todos los formatos. El formato se detecta a partir del archivo (su nombre y, cuando no basta, su contenido) y se muestra en Formato, donde puede cambiarlo.

Los formatos son Word (.docx), archivos de proyecto de Holarch (.holarch, .json), Excel / CSV (.xlsx, .csv), Texto sin formato (.txt), UML/SysML (.xmi, .uml, .mdzip) y ReqIF (.reqif).

Esta sección trata los formatos de requisitos. Para los archivos de proyecto, XMI y cualquier otra importación y exportación, consulte Importación y exportación.

Paso 1: Archivo

Suelte un archivo en «Suelte un archivo aquí o haga clic para elegirlo», o pegue texto en el cuadro y haga clic en Analizar texto (CSV con una fila de encabezado, XML de ReqIF, XMI, JSON o texto de documento).

OpciónValoresEfecto
FormatoLos seis formatos anterioresMuestra el formato detectado. Elija otro para leer el mismo contenido de otra forma.
Codificación del texto (CSV, texto)Automático, UTF-8, ISO-8859-1 / Windows-1252, Shift_JIS, Big5, UTF-16Cómo se leen los bytes del archivo. Cambiarlo vuelve a leer el archivo.
Hoja (libros)«<name> (N filas)»La hoja que se importa. Se preselecciona la primera hoja con datos.
  • Texto sin formato: el cuadro mantiene editable el contenido importado. Edítelo y haga clic en Volver a analizar.
  • La línea de estado dice «Se analizó “<file>”: N filas, M columnas.» (más «(hoja “<name>”)» y, para Word, «, N tabla(s)»).

Paso 2: Asignar

Cada columna del archivo es una fila: Columna del archivo (título y posición), Valores de ejemplo (las tres primeras filas) y Campo de Holarch. Elija Omitir para dejar fuera una columna. Los campos emparejados a partir del título de la columna se marcan con auto.

Campo de HolarchContenido
Nombre, Número, DescripciónLos campos propios del elemento.
Clase, EtiquetasEl nombre de la clase; nombres de etiqueta separados por ; , o |.
Número del padre, ID globalEl número del padre; el ID que se usa para emparejar entidades existentes.
Un atributoCualquier atributo de la clase para filas sin clase.
Una relaciónSepare varios destinos con ;.
ID de fila, ID de la fila padre, Nuevo atributo (añadido al esquema)Estructura de los archivos ReqIF y XMI, y atributos nuevos.

✦ IA ▾ → Sugerir asignación propone un campo para cada columna. Asignación sugerida enumera los cambios, marcados, con el motivo de la IA; Aplicar marcados cambia la asignación. Todavía no se importa nada.

Holarch deduce la asignación a partir del encabezado:

EncabezadoSe asigna a
Number, No, Num, #, ID Number, Req Number, Requirement NumberNúmero
Name, Title, Short Name, Requirement NameNombre
Description, Text, Requirement, Requirement Text, Statement, DescDescripción
Class, Type, Entity ClassClase
Labels, Label, TagsEtiquetas (separe los valores con ; , o |)
Parent, Parent NumberNúmero del padre
Global ID, ID, GUID, UUIDID global
Un nombre de atributo (por ejemplo Priority, Rationale, Status)Ese atributo. «Method» y «Verification» se asignan a Verification Method.
El nombre de un grupo de etiquetas (por ejemplo Verification Method cuando no existe ese atributo)Etiquetas
El nombre de una relación (por ejemplo satisfied by)Esa relación; separe varios destinos con ;
Object Identifier, Origin IDID global
Object Number, ReqIF.ChapterName, ReqIF.ForeignIDNúmero
Object Heading, ReqIF.Name, Long NameNombre
Object Text, ReqIF.Text, ReqIF.DescriptionDescripción
ReqIF.CategoryClase
ReqIF ID, XMI ID, Row ID / Parent IDID de fila / ID de la fila padre

Nuevo atributo crea un atributo con el nombre de la columna en cada clase importada. Su tipo depende de los valores:

  • Número, cuando todos los valores son números.
  • Una lista de opciones, cuando hay pocos valores distintos y cortos.
  • Texto largo, para valores de más de 120 caracteres.
  • Texto en los demás casos.

Los criterios de calidad, los atributos calculados y los de archivo no se pueden asignar.

Debajo de las columnas:

OpciónValoresEfecto
Clase para filas sin claseCualquier clase; predeterminada RequirementLa clase de las filas sin valor en la columna Clase y sin ninguna regla de clase coincidente.
Reglas de claseLa descripción contiene una palabra o frase → una clase+ Regla añade una, × la quita. La primera regla que coincide se aplica a las filas sin valor de Clase.
Emparejar entidades existentes porID global, Nombre, NúmeroLas filas que coinciden con una entidad existente la actualizan en lugar de crear una copia. Las coincidencias por Nombre y Número también exigen la misma clase.
Emparejar entidades relacionadas porID global, Nombre, NúmeroCómo encuentran sus destinos los valores de las columnas de relación.
Formato de fecha de las columnas de fecha (CSV)Automático, yyyy-MM-dd HH:mm:ss, dd/MM/yyyy, MM/dd/yyyy, yyyyMMdd, Personalizado…Cómo se leen las celdas de fecha. Personalizado… muestra un campo para su propio patrón (por ejemplo dd.MM.yyyy HH:mm) con yyyy, MM, dd, HH, mm y ss.
Patrón de numeración (Word, texto)Vacío (automático), o marcadores como 1. a) (i), o números de ruta como 1.1 o 1.1.aCómo se convierten en el esquema los párrafos numerados. Para el texto, el patrón se detecta a partir de la numeración y se rellena. Los estilos de título de Word y la numeración de listas no necesitan patrón. Consulte Patrón de numeración.
Numerar los hijos bajo su padre (1 → 1.1) (Word, texto)Activado de forma predeterminadaLos números de hijo generados pasan a ser «3.1», «3.2» en lugar de «1», «2».

Jerarquía. Los números de esquema reconstruyen la jerarquía: «1.2.3» pasa a ser hijo de «1.2». Una columna Número del padre, o un par ID de fila e ID de la fila padre, establece el padre de forma explícita. Los elementos sin padre pasan a ser los elementos de nivel superior del documento.

Tablas de Word. Para un archivo de Word, la sección Tablas de Word enumera cada tabla. Las tablas que se repiten con el mismo encabezado en varias secciones comparten una asignación. La sección explica: «Importe una tabla de requisitos como entidades, una por fila, y asigne sus columnas. Las demás tablas se quedan como tablas en la descripción del elemento al que siguen.»

  • Establezca cada tabla en Entidades (una por fila) o Tabla en la descripción.
  • Asigne sus columnas a Número, Nombre, Descripción, Clase, Etiquetas, Atributo, Nuevo atributo u Omitir.
  • Los encabezados como ID, Req ID, Requirement ID, Ref o Paragraph se asignan a Número.
  • Shall, Shall Statement, Requirement Statement, Requirement Text, Statement o Text se asignan a Descripción.

Una tabla con una columna de número o de descripción y filas con «shall» empieza como entidades.

Las advertencias encontradas hasta el momento aparecen bajo las columnas, o «Sin advertencias.»

Paso 3: Revisar

Compruebe el resultado antes de que cambie nada. Revisar muestra los cambios igual que Líneas base y versiones compara versiones (consulte Líneas base y comparación de versiones):

  • La primera línea nombra el archivo, el formato y el número de elementos por clase.
  • Crear un documento de requisitos con estos N requisitos aparece, marcado, cuando todos los elementos son Statements o Requirements (o una subclase). Para otros archivos dice Crear un documento con estos N elementos, desmarcado. Si está marcado, elija el Tipo de documento (predeterminado Documento de requisitos), el Nombre (predeterminado: el nombre del archivo) y si se debe Renumerar todo el documento después de importar.
  • A continuación aparecen las advertencias.
  • Los mosaicos cuentan los Elementos nuevos, los Elementos actualizados, los elementos Emparejado, sin cambios y las Relaciones del archivo.
  • La tabla de cambios enumera cada elemento nuevo con su descripción, y cada campo modificado de un elemento actualizado con las diferencias palabra por palabra entre el valor antiguo y el nuevo (los 500 primeros cambios).

Haga clic en Importar N elementos. El aviso dice «Se importaron N nuevos y M actualizados».

  • Sin advertencias, Holarch abre el nuevo documento de requisitos (o la Base de datos).
  • En caso contrario, la tarjeta Importación completada enumera las advertencias («La importación no informó advertencias.» cuando no hay ninguna). Sus botones son Abrir documento, Abrir base de datos, Diagrama Spider, Diagrama de árbol, Comprobar calidad e Iniciar otra importación.

La descripción del documento nuevo enumera las advertencias de la importación.

Cómo se lee cada formato

Word (.docx):

  • Los títulos y la numeración de listas de Word se convierten en el esquema y conservan sus números.
  • Un título se convierte en un Statement. El texto que hay debajo se convierte en su descripción.
  • Un párrafo con shall, must, will o should se convierte en un Requirement hijo, con el nombre tomado de las palabras que siguen al verbo modal. Un elemento de lista numerada también; sin verbo modal se convierte en un Statement.
  • Las viñetas, las imágenes y las tablas se unen a la descripción del elemento al que siguen, conservando la negrita, la cursiva, las listas y las tablas.
  • El .docx original se adjunta al documento nuevo cuando no supera el límite de archivos adjuntos por archivo.
  • Se conservan las imágenes PNG, JPEG, GIF, WebP y SVG. Los demás formatos de imagen se omiten con una advertencia.

Excel (.xlsx, .xlsm) y CSV:

  • Una fila por entidad, con cualquier columna. La primera fila es el encabezado.
  • Las celdas de varias líneas conservan sus saltos de línea.
  • Los archivos de Excel 97-2003 (.xls) no se leen. Guárdelos antes como .xlsx o .csv.

ReqIF (.reqif, .reqifz):

  • Cada SPEC-OBJECT se convierte en una fila con ReqIF ID, Parent ID (de la jerarquía de la especificación), Type (su tipo de objeto, asignado a Clase), Long Name y una columna por definición de atributo.
  • Las columnas sin coincidencia pasan de forma predeterminada a Nuevo atributo. Los atributos XHTML se convierten en atributos de texto enriquecido, y los atributos de enumeración en listas de opciones.
  • Las SPEC-RELATION se convierten en relaciones por nombre. Cuando el nombre no coincide con una relación que permite el esquema, pasan a ser traced to.
  • Un archivo .reqifz se descomprime automáticamente.

Texto sin formato (.txt) o texto pegado:

  • Una línea numerada («3.1 Battery»), o una línea corta sin punto, se convierte en un título (Statement).
  • Cada oración con shall, must, will o should se convierte en un Requirement bajo el título actual.
  • El resto del texto se une a la descripción del elemento anterior.
  • Con un patrón de numeración (detectado a partir del texto o escrito), el patrón decide los niveles.

Actualizar requisitos desde una hoja de cálculo

Úselo para cambiar muchos requisitos a la vez en una hoja de cálculo.

  1. En la Base de datos (o en la página Requisitos), haga clic en Exportar… y elija Tabla (CSV).
  2. Marque los atributos que va a editar. En Incluir, marque ID y haga clic en Exportar.
  3. Edite los valores en la hoja de cálculo. No cambie la columna ID.
  4. Importe el archivo. En Asignar, compruebe que la columna ID se asigna a ID global y establezca Emparejar entidades existentes por en ID global.
  5. En Revisar, desmarque Crear un documento….

    Las filas emparejadas cuentan como Elementos actualizados, con cada campo modificado enumerado.

  6. Haga clic en Importar N elementos.

Un valor I_… de un archivo exportado antes de esta versión no coincide; use la columna ID. Para cada paso y opción, consulte Importación y exportación.

Qué escribe una actualización:

  • Solo las columnas asignadas. Si falta la columna Descripción, cada descripción existente se conserva.
  • Las etiquetas del archivo se añaden a las etiquetas existentes.
  • Sin columna Clase, una fila emparejada por ID global conserva la clase de su entidad.

Mensajes de importación

MensajeSignificado y solución
Ninguna columna se asigna a Nombre ni a Número. Asigne una de ellas.Asigne al menos una columna a Nombre o a Número.
Fila N: clase desconocida «X»; se usa <class>.El valor de Clase no coincide con ninguna clase. Corrija el valor o asigne la columna a Omitir.
Fila N: etiqueta desconocida «X» ignorada.Cree primero la etiqueta en el esquema o corrija el valor.
Fila N: «<attribute>» no se aplica a la clase <class>.La clase de la fila no tiene ese atributo.
Fila N: «<value>» no es un valor <type> válido para «<attribute>».El valor no se puede leer como número, fecha, opción, etc. Compruebe la opción de formato de fecha.
Fila N: el Nombre supera los 255 caracteres y se ha acortado. / Fila N: el Número supera los 255 caracteres y se ha acortado.Los nombres y los números están limitados a 255 caracteres.
Número X duplicado (filas A y B).Dos filas comparten un número; la jerarquía puede colgar los hijos de la primera.
Fila N: falta el número de padre P para X; se ha colgado de Q. / …; se ha importado en el nivel superior.El número del padre directo no está en el archivo.
Fila N: no se ha encontrado el número de padre P. / Fila N: no se ha encontrado el padre P.El Número del padre o el ID de fila del padre remite a una fila que no está en el archivo.
Fila N: no se ha encontrado el destino «X» de «<relationship>».La columna de relación nombra una entidad que no existe. Compruebe Emparejar entidades relacionadas por.
Fila N: el esquema no permite «<relationship>» de A a B (se ha creado de todos modos).El vínculo se ha creado aunque el esquema no lo incluye.
El esquema no permite la relación «X» entre A y B; se ha omitido.No se ha podido crear una relación de ReqIF o XMI, ni siquiera como traced to.
Imagen X: las imágenes .ext no son compatibles y se han omitido. Guarde la imagen como PNG o JPEG en Word para conservarla.Imagen de Word en un formato no compatible.
La imagen X (tamaño) supera el límite de adjuntos de <limit> y se ha omitido.La imagen supera el límite por archivo.
No se han encontrado filas de datos.El archivo o la hoja solo tiene encabezado o está vacío.
No se ha podido leer el archivo: los archivos de Excel 97-2003 (.xls) no son compatibles. En Excel, guarde el archivo como .xlsx o .csv y vuelva a importarloConvierta el archivo.
No se ha podido leer el archivo: no se acepta XML con una declaración DOCTYPE o ENTITY. Guarde el archivo sin ella y vuelva a importarloQuite la declaración del archivo ReqIF o XML.
No se ha podido leer el archivo: XML no válidoEl archivo ReqIF no es XML bien formado.
Error de importación: <reason>La importación se ha detenido; no se ha cambiado nada.

Atajos de los requisitos

TeclasDóndeAction
EnterEntrada rápida del documentoAñadir el requisito escrito.
⌘ / Ctrl+Enter / ⌥ / Alt+⌘ / Ctrl+EnterDocumento, con un elemento seleccionadoAñadir un hermano / un hijo.
Enter o SpaceFilas de Calidad, TBD/TBR y Vínculos por revisarMostrar en el inspector el requisito o el elemento por revisar de la fila.
↑ / ↓Las mismas filas, con una fila enfocadaIr a la fila anterior o siguiente.
⌘ / Ctrl-clic, ⇧ / Shift-clic, ⌘ / Ctrl+⇧ / Shift-clicFilas de Calidad, TBD/TBR y Vínculos por revisar; filas de la Base de datos; elementos de documentoAlternar una fila, seleccionar el rango desde la última fila en la que se hizo clic, añadir ese rango.
⌘A / Ctrl+A, ⇧ / Shift+↑ / ⇧ / Shift+↓Las mismas filas, con una fila enfocadaSeleccionar todas las filas mostradas; ampliar la selección desde la fila enfocada.
Clic derecho, Shift+F10 o la tecla MenúFilas de Requisitos, Calidad, TBD/TBR y Vínculos por revisar; elementos de documento y entradas del EsquemaAbrir el menú de la fila: primero las acciones sugeridas con sus motivos y ✦ Más IA ▸, después los comandos del elemento.
EscCalidad, TBD/TBR, Vínculos por revisar, RVTMDeseleccionar la fila.
EnterCampo de nombre de Líneas base y versionesCrear la línea base del proyecto.
⌘Z / Ctrl+ZEn cualquier lugarDeshacer el último cambio, incluida una importación completa, el marcado de vínculos como revisados o un cambio de estado.

Para todos los atajos de la aplicación, consulte Atajos de teclado.

Ajustes

AjusteDóndePredeterminadoÁmbito
Volver a comprobar automáticamente cuando cambie el textoBarra de ámbito de la página CalidadDesactivadosEste navegador
Grupos del inspector contraídos o abiertos (Calidad y los demás)Haga clic en el encabezado de un grupo en el inspector, o en Contraer todo / Expandir todo al final de sus vínculosCalidad contraído, el resto abiertosEste navegador, por clase
Su nombre en aprobaciones, decisiones y comentariosEl nombre de su cuenta—Cuenta
Estado de trazabilidad (puntos en los requisitos)Ver ▾ del documentoSobreDocumento

Mensajes

MensajeDóndeSignificado
Comprobados N requisitosCalidadLa comprobación se ha ejecutado en el ámbito.
No hay requisitos en este ámbito.CalidadEl ámbito no tiene requisitos.
Este documento no tiene Requirements que comprobar. Los Statements no se puntúan.Comprobar calidad del documentoCambie los elementos a Requirement o compruebe otro documento.
Desactualizado: volver a ejecutar / Desactualizado / Calidad: desactualizada; volver a ejecutarCalidad, documentos, inspectorEl texto cambió después de la última comprobación.
Requiere el juicio de un revisorCalidad (Correcto, Viable)Una persona debe decidir; haga clic en ✘ para marcar Sí.
Marcado como No manualmente.CalidadUn revisor ha puesto el criterio en No.
N requisito(s) aprobado(s) pasado(s) a En revisión; N vínculo(s) marcado(s) para revisión.Tras una ediciónLa edición ha reabierto las aprobaciones y ha marcado vínculos para revisión.
Aprobado / Rechazado / Pasado a En revisiónCuadro de aprobaciónLa decisión se ha registrado.
N vínculos marcados como revisados.Vínculos por revisarLas revisiones se han registrado.
Seleccione primero los vínculos que se marcarán como revisados.Vínculos por revisarMarque filas antes de Marcar seleccionados como revisados….
Cerrado / Atributo cerrado; el texto aún contiene TBD.TBD/TBREl atributo se ha puesto en None.
El texto aún contiene TBD. Edite el texto para cerrarlo.TBD/TBRSe muestra al cerrar un elemento solo de texto.
Línea base guardadaDocumentos, Líneas base y versionesLa instantánea se ha guardado.
Este documento no tiene línea base. Guarde una primero.Comparar con la actual, informes de cambiosEl documento no tiene línea base.
Revertido a «<name>» / Restaurado «<name>»Líneas baseEl documento o el proyecto se ha devuelto a un estado anterior; Deshacer está disponible.
No hay requisitos que revisar. Seleccione o abra requisitos primero.Comprobación de requisitos con IANo hay requisitos en el ámbito.

Límites

  • Comprobar calidad: cada requisito del ámbito se compara con los demás en busca de duplicados (umbral de similitud del 75 %).
  • Comprobación de requisitos con IA: 20 requisitos por solicitud a la IA, con hasta 300 requisitos más como contexto.
  • La diferencia de la revisión de vínculos conserva los primeros 500 caracteres del nombre anterior y 4000 de la descripción anterior.
  • Gráfico de evolución de TBD/TBR: hasta 60 puntos.
  • Importación:
    • Nombres y números de hasta 255 caracteres.
    • La vista previa muestra las primeras 500 filas. Se enumeran las primeras 50 advertencias («…y N más»).
    • Un patrón de numeración tiene como máximo 6 niveles («El patrón de numeración tiene más de 6 niveles. Use como máximo 6 marcadores.»).
    • Archivos ReqIF/XML de hasta 100 millones de caracteres y 3.000.000 de elementos.
    • Archivos .reqifz y .docx de hasta 10.000 entradas, 300 MB por entrada y 600 MB en total.
    • Las imágenes y el archivo Word original solo se conservan dentro del límite de adjuntos por archivo (10 MB en el plan Free, 25 MB en Individual, 100 MB en Team).