Especificación del producto

En esta parte del tutorial, repasaremos uno de los flujos de usuario principales que pueden ayudarle a comenzar a usar Requirements Portal:

• Recopilar y redactar requisitos

• Desglosar requisitos

• Revisar y mejorar requisitos

• Aprobar y publicar especificaciones

Creación de un nuevo proyecto

1. En la página Home de Requirements Portal (a la que se accede al abrir Requirements Portal desde el menú de nueve puntos en la parte superior derecha de la interfaz basada en navegador del Workspace – ), haga clic en el botón , situado encima de la lista de proyectos de requisitos.

   

2. Se abrirá la ventana Create Requirements Project, donde puede especificar los detalles del proyecto:

   • Project Name – introduzca un nombre de proyecto adecuado (y único) (p. ej., Valifan).

   • Description – introduzca una descripción opcional para el proyecto (p. ej., Amazing Valifan project).

   • Electronics Project – deje este campo en blanco. 

   Una vez especificados los detalles del proyecto, haga clic en el botón .

   

3. El proyecto de requisitos aparecerá en la lista de la página Home. Haga clic en su nombre para abrirlo en una nueva pestaña del navegador.

   

Definición de requisitos de las partes interesadas

La mayoría de los procesos de diseño y desarrollo de sistemas siguen el ciclo V. El primer proceso de un ciclo V consiste en comprender las necesidades del negocio e identificar las necesidades de las partes interesadas. Estas necesidades se convierten después en requisitos de las partes interesadas que pueden crearse directamente, importarse mediante CSV/XLSX o incluso crearse mediante ValiAssistant, impulsado por IA. En esta parte del tutorial, nos centraremos en el método de importación.

1. Descargue el siguiente archivo CSV que contiene los requisitos de las partes interesadas:

   Valifan_stakeholder_Requirements.csv

2. Si aún no lo ha hecho, vaya al Módulo de requisitos haciendo clic en la entrada Requirements en el árbol del proyecto de la izquierda.

3. Haga clic en el botón en la página que se abre y seleccione Import Requirements en el menú que aparece.

   

4. En la ventana Document Importer que se abre, arrastre y suelte el archivo CSV descargado en la zona Drop your file here o haga clic en el enlace upload from your computer para cargar el CSV, de modo que el asistente de importación pueda leer e importar el archivo.

   

5. La entrada del archivo cargado aparecerá en la ventana. Active la opción Classic Import (Non-AI) en la parte inferior izquierda de la ventana y, a continuación, haga clic en el botón para continuar.

   

6. En la siguiente etapa, seleccione + Add specification en la lista desplegable de la parte superior izquierda e introduzca el nombre de una nueva especificación (p. ej.,Stakeholder_requirements) en la que se importarán los requisitos.

   

7. Asegúrese de que las columnas de datos del archivo CSV estén correctamente asignadas a las columnas de Requirements Portal. Si es necesario, utilice las listas desplegables en los encabezados de las columnas.

   

8. Asegúrese de que la opción Parametrize values esté activada y de que todos los requisitos estén seleccionados para la importación (todas las casillas de verificación de la columna situada más a la izquierda de la tabla están activadas) y, a continuación, haga clic en  para continuar.

   

9. La siguiente página del asistente le notificará que la importación se ha realizado correctamente. Cierre la ventana para continuar.

   

10. Se ha creado una nueva especificación y se han importado en ella todos los requisitos. Los valores y las unidades detectados se han transformado de texto sin formato en valis (parámetros), que aparecen resaltados en los requisitos.

    

Adición de requisitos del sistema

En un flujo típico de ingeniería de sistemas, los requisitos del sistema se crean a partir de los requisitos de las partes interesadas. La mayoría de los diseños técnicos deben cumplir requisitos estrictos, como los relativos a masa, consumo de energía y coste. Requirements Portal ofrece una visión integral de en qué medida un diseño cumple todos estos requisitos.

Ahora crearemos manualmente algunos requisitos del sistema.

1. Haga clic con el botón derecho en la entrada Requirements del árbol del proyecto a la izquierda y seleccione Create Specification en el menú que aparece. En la ventana Create new specification, introduzca Fan_Specs en el campo Name  y haga clic en .

   

2. Haga clic en la entrada de la especificación recién creada en el árbol del proyecto. Una vez en esta especificación, haga clic en  el botón y seleccione Create Requirement en el menú que aparece.

   

3. Se abrirá la ventana Create Requirement. En esta ventana:

   1. En el campo Identifier, introduzca un identificador único, p. ej., R-Fan-001.

   2. En el campo Text, introduzca The Mass of the fan shall not exceed 300g.

   3. Haga clic en el botón y asegúrese de que la especificación correcta esté seleccionada (Fan_Specs) en el campo Specification.

   4. Asegúrese de que la opción Parametrize values esté activada.

      Cuando esta opción está activada, los valores numéricos del requisito se comprueban y se convierten directamente en valis mediante la función de parametrización.

   5. Haga clic en el botón .

   

4. De forma similar, añada otro requisito con el identificador R-Fan-002 y el texto de requisito The Mass of the propeller shall not exceed 50g, pero esta vez desactive la opción Parametrize values (más adelante se creará manualmente un vali a partir de un valor dentro de este requisito).

   

5. Los requisitos añadidos se mostrarán en la lista cuando se seleccione la especificación Fan_Specs. Tenga en cuenta que, mientras que R-Fan-001 tiene un vali, R-Fan-002 todavía no tiene un vali.

   

Creación de valis de requisito dentro de un requisito

Ahora crearemos manualmente un nuevo vali dentro del campo de texto del requisito.

1. Haga doble clic en la celda de la columna Text del requisito R-Fan-002 y elimine el texto 50g .

   

2. Escriba $ para mostrar una ventana emergente con una lista de valis/objetos dentro del proyecto. En la parte superior derecha de la ventana emergente, haga clic en el botón para crear un vali.

   

3. En la ventana Create new que se abre. En la pestaña Vali de la ventana, introduzca los siguientes datos para el nuevo vali:

   1. Name: Req_Mass_Propeller

   2. Formula and unit: 50g

   3. Display unit: g

      El campo Display unit es opcional. Si se deja vacío, tomará la unidad del campo Formula and unit.

   

4. Haga clic en el botón para crear un nuevo vali e insertarlo en el campo Text del requisito y, a continuación, pulse Enter o haga clic en cualquier lugar de la tabla fuera de la celda para finalizar la edición.

5. Ahora, el texto 50g aparece de forma diferente al texto normal, lo que indica que se trata de un vali. Este vali ya puede utilizarse en distintas partes del proyecto (p. ej., informes, Módulo de bloques, verificación, etc.).

   

Desglose de requisitos con relaciones padre-hijo

1. Haga clic en el control Columns situado a la derecha de la tabla y asegúrese de que las entradas de las columnas Parents y Children estén marcadas para que se muestren en la tabla.

   

   Vuelva a hacer clic en el control Columns para ocultar la lista.

2. Haga doble clic en la celda de la columna Parent del requisito R-Fan-002 y seleccione el requisito R-Fan-001 en la ventana emergente para vincular ambos requisitos. Tenga en cuenta que R-Fan-002 se añadirá automáticamente a la columna Children de R-Fan-001.

   

   

    

3. Haga clic en la pestaña Connections situada en la parte superior de la tabla de requisitos para abrir un gráfico de conexiones que muestra la relación padre-hijo de la especificación seleccionada.

   Los recuadros azules alrededor de los requisitos indican la especificación en la que se encuentran.

   

Generación de requisitos mediante el Asistente de ingeniería

Para acelerar el proceso de gestión de requisitos, puede generar requisitos/desglosar requisitos mediante Engineering Assistant. Lo utilizaremos para crear dos requisitos de seguridad para el proyecto del tutorial.

1. Haga clic en el botón  en la parte superior derecha para abrir el panel Engineering Assistant.

   

    

2. En el panel Engineering Assistant, puede describir su producto, sistema o subsistema y proporcionar tanta información como sea posible para que la IA pueda generar los mejores requisitos según su descripción. Dado que nos interesan los requisitos de seguridad, solicite dos requisitos de seguridad para nuestro ventilador introduciendo una indicación en el campo Ask anything de la parte inferior del panel:

   Create 2 safety requirements for designing a fan. Apply the INCOSE guide to writing requirements.

   Haga clic en  o pulse Enter para continuar.

   

3. Los requisitos sugeridos se presentarán en la región de cuadrícula de la tabla de la especificación. Haga clic en el botón del panel Engineering Assistant para crear nuevos requisitos según lo sugerido.

   

   

    

4. Los requisitos generados pueden modificarse en cualquier momento después de su creación. Si es necesario, cambie los identificadores de los requisitos generados a R-Fan-003 y R-Fan-004 haciendo doble clic en sus celdas de la columna Identifier, introduciendo el texto y, a continuación, pulsando Enter o haciendo clic en cualquier lugar de la tabla fuera de la celda para finalizar la edición.

Actualización, gestión y revisión de requisitos

A lo largo del proceso de desarrollo, es habitual que los requisitos evolucionen y se actualicen en función de diversos factores, como los comentarios de las partes interesadas y las restricciones de diseño. En Requirements Portal, puede actualizar los requisitos directamente haciendo doble clic en los campos de columna o dentro de la sección de detalles del requisito, y todos los cambios se registran en el historial para facilitar la consulta.

1. Entre en modo de edición para el texto del requisito R-Fan-003 o R-Fan-004 haciendo doble clic en su celda de la columna Text. Cambie el texto a The fan shall include a protective guard with openings no larger than inches to prevent accidental contact with moving parts. y pulse Enter o haga clic en cualquier lugar de la tabla fuera de la celda para finalizar la edición.

   

   

   

    

2. Haga clic en el identificador del requisito modificado para abrir su vista detallada, desde donde puede ajustar campos adicionales, suscribirse, definir responsables, añadir una justificación, crear relaciones padre/hijo, etc.

   

3. La trazabilidad es un concepto clave de Requirements Portal y todos los cambios se registran en el historial de los requisitos y otros objetos. Haga clic en History para abrir una vista que le proporciona información sobre versiones, quién realizó un cambio y cuándo, así como campos y acciones.

   

Validación de requisitos

En las primeras etapas del ciclo de vida del producto, es crucial validar los requisitos antes de avanzar con el proceso de diseño. Requirements Portal proporciona una forma práctica de gestionar los estados de los requisitos mediante la columna State. De forma predeterminada, se incluyen estados como Draft, In Review y Final, pero puede añadir estados adicionales según sus necesidades específicas.

En esta parte del tutorial, asignará el estado Draft a los requisitos recién añadidos, garantizando un flujo de trabajo estructurado y organizado.

1. Cuando esté en la especificación Fan_Spec, haga clic en el control Columns situado a la derecha de la tabla y asegúrese de que la entrada de la columna State esté marcada para que se muestre en la tabla.

   

2. Marque la casilla situada a la izquierda del encabezado de la columna Identifier para seleccionar todos los requisitos de la especificación.

   

3. Haga doble clic en una celda de cualquier requisito en la columna State (si es necesario, desplácese hacia la derecha en la tabla para ver la columna) para abrir una lista desplegable con las opciones disponibles para el estado. Seleccione Draft en la lista desplegable y confirme la actualización. Todos los requisitos tendrán el estado Draft.