Capítulos del curso
Formación · Curso 2. Requisitos y verificación · Capítulo 2.4 de 6
2.4 Líneas base y vínculos por revisar 2:40
Congelar la especificación en una línea base, cambiar un requisito y revisar a qué afecta el cambio.
Muestra Holarch 2.13.
Lo que aprenderá
- Guardar una línea base de documento con un registro de aprobación
- Explicar qué provoca un cambio en un requisito aprobado sobre su estado y sus vínculos
- Revisar un vínculo señalado con Diferencias y marcarlo como revisado con una nota
- Comparar una línea base con la versión actual y exportar los cambios
Congele la especificación del Bike-Share Dock en una línea base con una aprobación, cambie un requisito aprobado, vea cómo vuelve a revisión y sus vínculos quedan marcados para revisar, revise el vínculo y márquelo como revisado con una nota, y liste todos los cambios desde la línea base.
Archivos de proyecto
- Proyecto inicial (.holarch.json; Gestionar proyectos → Archivos de proyecto ▾ → Importar proyecto (.json)…)
- Proyecto terminado (.holarch.json; Gestionar proyectos → Archivos de proyecto ▾ → Importar proyecto (.json)…)
El vídeo se reproduce desde holarch.app; consulte la Política de privacidad.
Práctica
Hágalo usted mismo en Holarch, en el proyecto de demostración CubeSat EO-1.
- Abra su proyecto de demostración EO-1 (o créelo: Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración → CubeSat (ingeniería de sistemas guiada)).
- Abra EO-1 System Requirements Specification, haga clic en Versión ▾ en el bloque de título y elija Guardar línea base…. Llámela
PDR Baseline, rellene una fila de aprobador con su nombre y su rol y haga clic en Crear. - Cambie 3.3 Depth of Discharge de 30 % a 25 % en su descripción y lea el aviso: el requisito vuelve a estar In Review y sus vínculos necesitan revisión.
- Abra Necesidades y requisitos → Vínculos por revisar. En una fila de 3.3, haga clic en Diferencias, después en Marcar como revisado…, escriba lo que comprobó y haga clic en Marcar como revisado.
- En el documento, elija Versión ▾ → Comparar versiones… con Desde PDR Baseline y Hasta Versión actual, y haga clic en Cambios (Excel).
- Abra Control y revisiones → Líneas base y versiones y busque PDR Baseline junto a SRR Baseline. Para congelar todo el modelo en lugar de un documento, usaría + Guardar línea base… en el encabezado de esta página.
Habrá terminado cuando el informe de cambios desde PDR Baseline liste la edición de 3.3 y el vínculo que revisó ya no aparezca en Vínculos por revisar.
Compruebe lo aprendido
- ¿Por qué cambiar un requisito marca los vínculos que dependen de él y no solo el requisito?
- ¿Qué diferencia hay entre una línea base de documento y una línea base de proyecto?
- Al marcar un vínculo como revisado, ¿por qué escribir una nota?
Mostrar las respuestas
¿Por qué cambiar un requisito marca los vínculos que dependen de él y no solo el requisito?
Los elementos del otro extremo, como la función que lo satisface o la prueba que lo verifica, se comprobaron frente al texto antiguo. Cada vínculo debe comprobarse de nuevo para ver si sigue siendo válido.
¿Qué diferencia hay entre una línea base de documento y una línea base de proyecto?
Una línea base de documento congela un documento y sus aprobaciones (Versión ▾ → Guardar línea base…). Una línea base de proyecto congela todos los elementos y relaciones (Líneas base y versiones → + Guardar línea base…).
Al marcar un vínculo como revisado, ¿por qué escribir una nota?
La nota registra qué se comprobó y por qué el vínculo sigue siendo válido. Se añade a los comentarios del elemento vinculado, de modo que un revisor puede seguir la decisión más adelante.
Más información
Transcripción
Mostrar la transcripción (narración y lo que aparece en pantalla)
Introduction
Chapter four: baselines and links to review. Once a specification is agreed, changes need control: everyone should know what changed, and what the change might break.
We baseline the Bike-Share Dock specification, then change one of its requirements.
Change control
A baseline is a read-only snapshot of a document, with its approvals. After it, every change is visible, and a change to a requirement marks the links that depend on it for review, until someone checks them.
On screen: Card: baselines and links to review.
First, give Show Available Bikes a link to depend on. In the Database, select it, and in its Trace section link it with satisfied by to the rental kiosk, which shows the numbers.
On screen: 4.1.1 → Trace → satisfied by + → Link existing… → Rental Kiosk.
Baseline
Open the specification, and the version menu in its title block. Choose Save Baseline, name it SRR Baseline for the requirements review, add your role, and click Create.
On screen: SRS → Current version ▾ → Save Baseline… → SRR Baseline → Create.
A change
Now a change. The team wants the kiosk to show the charge level of each e-bike too. Select Show Available Bikes, and update its statement in the inspector.
On screen: 4.1.1 → Item → new description.
The message says what happened, in the same undo step as the edit: the approved requirement went back to In Review, and its link to the rental kiosk now needs review.
On screen: The toast and the status.
Links to review
Open Needs and Requirements, then Links to Review. Each row is a link to check. Diff shows exactly how the text changed.
On screen: Links to Review → Diff.
The rental kiosk can show charge levels too, so the link still holds. Click Mark Reviewed, write what you checked, and click Mark Reviewed. The link no longer needs review.
On screen: Mark Reviewed… → note → Mark Reviewed.
Changes since the baseline
To see everything that changed since the review, open the specification's version menu again, and choose Compare Versions: from SRR Baseline to the current version.
On screen: SRS → version ▾ → Compare Versions… → SRR Baseline → Current.
The report lists each addition, removal and edit, ready to export to Excel or as a Word redline for a change board.
On screen: The change report.
Recap
Let's recap. You baselined the specification with an approval, changed an approved requirement, saw it return to review with its link flagged, marked the link reviewed with a note, and listed the changes since the baseline.
Next, you plan and run the tests that verify the requirements.