Capítulos del curso
Formación · Curso 2. Requisitos y verificación · Capítulo 2.1 de 6
2.1 Redactar requisitos y la comprobación de calidad 3:37
Redactar requisitos con sus atributos y dejar que la comprobación de calidad encuentre la redacción débil.
Muestra Holarch 1.27.
Lo que aprenderá
- Redactar un requisito como un único enunciado verificable con «shall» y un valor medible
- Añadir un requisito bajo una sección de una especificación
- Fijar la prioridad, el método de verificación, la justificación y la etiqueta de tipo de un requisito
- Ejecutar la comprobación de calidad en un documento y corregir un requisito que señale
- Marcar Correct y Feasible después de revisar uno mismo un requisito
Redacte requisitos en la especificación del Bike-Share Dock: qué hace bueno a un requisito, cómo añadir requisitos bajo secciones, rellenar la prioridad, el método de verificación y la justificación, ponerles etiquetas, ejecutar la comprobación de calidad de requisitos, corregir un requisito débil y registrar el juicio del revisor.
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 Necesidades y requisitos → Documentos → EO-1 System Requirements Specification. Seleccione la sección 5 Communications, haga clic en + Hijo, llame al requisito
Command Link Marginy escriba un enunciado con «shall» que incluya un valor (por ejemplo, un margen de al menos 6 dB a 5 grados de elevación). - En el inspector, fije Priority en High, Verification Method en Analysis y un Rationale; después haga clic en + Etiqueta y elija Performance Requirement.
- Abra Necesidades y requisitos → Calidad, elija Documento: EO-1 System Requirements Specification en la barra de ámbito y haga clic en Comprobar calidad. Lea las Sugerencias para 2.5 Safe Mode Recovery.
- Reescriba 2.5 como un único enunciado medible (qué desencadena la recuperación, con qué rapidez y hacia qué modo) y vuelva a hacer clic en Comprobar calidad.
- Revise lo que ha reescrito y después haga clic en la ✘ bajo Correct y Feasible en su fila para marcarlos como Sí.
Habrá terminado cuando 2.5 Safe Mode Recovery obtenga una puntuación más alta que antes, sus sugerencias ya no señalen palabras imprecisas y Correct y Feasible muestren ✔.
Compruebe lo aprendido
- ¿Por qué un requisito unido por «and» puntúa más bajo aunque las dos mitades sean buenas?
- ¿Por qué la comprobación automática nunca puede marcar Correct y Feasible?
- ¿Qué hace que una palabra como «quickly» sea un problema en un requisito?
Mostrar las respuestas
¿Por qué un requisito unido por «and» puntúa más bajo aunque las dos mitades sean buenas?
Contiene dos requisitos en uno. No se pueden verificar, trazar ni cambiar por separado, de modo que la comprobación lo señala como no singular.
¿Por qué la comprobación automática nunca puede marcar Correct y Feasible?
Si un requisito expresa la necesidad correcta y si se puede construir requiere criterio de ingeniería. Una persona lo revisa y marca esos dos criterios.
¿Qué hace que una palabra como «quickly» sea un problema en un requisito?
No se puede medir, de modo que ninguna prueba puede demostrar que se cumple el requisito. Sustitúyala por un valor y una unidad.
Más información
Transcripción
Mostrar la transcripción (narración y lo que aparece en pantalla)
Introduction
Welcome to Requirements and Verification. This track follows requirements from the first draft to the proof that the system meets them, on the Bike-Share Dock from Getting Started.
This first chapter is about writing requirements well, and letting Holarch check them.
A good requirement
A good requirement states one thing the system shall do, in words that can only mean one thing, with a value someone can test. Vague words such as fast or user friendly cannot be tested, and two requirements joined by and cannot be checked separately.
On screen: Card: a good requirement.
Write requirements
Open the specification. Select section 5.1, Timing and Throughput, open the menu next to After, and choose Add Child. Name the requirement Pay at the Kiosk, and write its statement in the inspector.
On screen: SRS → 5.1 → Add Child → Pay at the Kiosk.
Add two more the same way: an environmental requirement under 7.1, and a usability requirement under 8.3. The usability one is written the way requirements often are on a first try.
On screen: 7.1 → Operate in Cold and Heat; 8.3 → Friendly Kiosk.
Attributes and labels
Each requirement also has attributes for planning. Select Pay at the Kiosk, and set its priority to High, its verification method to Test, and its rationale: why the value was chosen.
On screen: 5.1.1 → Priority, Verification Method, Rationale.
Give it a label too: click Label in the inspector, and choose Performance Requirement. Labels let you filter and report by kind.
On screen: + Label → Performance Requirement.
Quality check
Now check the wording. Open Needs and Requirements, then Quality, choose the specification, and click Check Quality. Each requirement is scored against nine qualities of a good requirement, with a tick or a cross for each.
On screen: Quality → Document: the SRS → Check Quality.
Friendly Kiosk scores low. The findings name the problems: user friendly and quick cannot be measured, and the and joins two requirements in one.
On screen: Findings for Friendly Kiosk.
Fix it. Go back to the document, select the requirement, and rewrite it as one measurable statement.
On screen: Back to the SRS → 8.3.1 → new description.
Check the quality again. The score rises. Two qualities, correct and feasible, always need a person: when you have reviewed a requirement, click their crosses to mark them yes.
On screen: Quality → Check Quality again → mark Correct and Feasible.
Recap
Let's recap. You learned what makes a requirement good, added requirements under sections, filled in their attributes and labels, ran the quality check, fixed a weak requirement, and recorded your own judgment.
Next, you trace the stakeholder needs to these requirements.