Contenido principal

Realizar seguimiento de cambios en requisitos

Cuando se crean enlaces entre requisitos y diseños, pruebas u otros requisitos, Requirements Toolbox™ detecta cuándo cambian los requisitos enlazados, las líneas de código de MATLAB® enlazadas o los casos de prueba de Simulink® Test™. Cuando el software detecta un cambio, asocia un incidente de cambio al enlace. Puede evaluar el impacto del cambio, borrar incidente de cambio y dejar un comentario indicando la acción realizada.

En este paso del tutorial, puede añadir texto adicional a la ayuda para la función myAdd, ver los enlaces con incidentes de cambio, investigar qué ha cambiado, evaluar el impacto del cambio y determinar las acciones necesarias para resolver los cambios.

Editar ayuda de una función

Abra el proyecto myAdd3, que es el mismo que el proyecto myAdd2, pero con el control de versiones activado.

openProject("MyAdd3");

El comentario de la línea 2 de myAdd proporciona ayuda para la función.

help myAdd
  myAdd - Adds inputs u and v and outputs the result

Abra la función myAdd.

open myAdd

Añada la sintaxis de la función myAdd a la ayuda copiando y pegando este código en la línea 3:

% y = myAdd(u,v)

Guarde los cambios en myAdd. En la pestaña Editor, haga clic en Save.

Ver incidentes de cambio

Abra Requirements Editor. En la pestaña Apps, en Verification, Validation, and Test, haga clic en Requirements Editor. Asegúrese de que Requirements Toolbox esté analizado si los enlaces tienen incidentes de cambio y que muestre información sobre los cambios. En Requirements Editor, en la sección View, haga clic en Information > Change Information. Después, haga clic en Refresh. Vea los enlaces que tienen incidentes de cambio haciendo clic en Show Links.

The myAdd~m link set file is shown in the Requirements Editor, with links 1 and 3 highlighted in red.

El resaltado rojo en Requirements Editor indica qué enlaces del conjunto de enlaces tienen incidentes de cambio. La fila que contiene el conjunto de enlaces indica que el origen de 2 de los 4 enlaces ha cambiado.

Dado que los enlaces 1 y 3 están enlazados directamente a la línea de declaración de la función en myAdd.m, Requirements Toolbox indica que los enlaces tienen incidentes de cambio cuando cualquier línea de código de la función cambia. A la inversa, dado que los enlaces 2 y 4 están enlazados directamente a líneas de código dentro de la función, esos enlaces solo tienen incidentes de cambio cuando esas líneas de código cambian.

Investigar cambios

Investigue el impacto del cambio desplazándose al código fuente modificado desde el enlace. En Requirements Editor, seleccione el primer enlace. En el panel derecho, en Properties, vaya al origen del enlace haciendo clic en el hipervínculo que aparece junto a Source.

Link #1 is selected in the Requirements Editor. In the right-pane, under Properties, the mouse points to the link source.

Desplazarse al artefacto de origen abre myAdd.m. Puede investigar los cambios inspeccionando visualmente el archivo de origen. También puede investigar el cambio creando un informe de comparación entre las dos versiones del archivo. En la pestaña Project, en la carpeta source, haga clic con el botón secundario en myAdd.m y seleccione Compare > Compare to Ancestor.

The comparison report shows that the only change is a new comment on line 3.

El informe de comparación indica que el único cambio es el nuevo comentario de ayuda en la línea 3.

Evaluar impacto de cambio

Ahora que comprende el alcance de los cambios, puede evaluar el impacto de los cambios en el proyecto. Visualice el impacto de los cambios utilizando un diagrama de trazabilidad. En Requirements Editor, seleccione link #1. En la sección Analysis, haga clic en Traceability Diagram.

The Traceability Diagram window originates from the myAdd function declaration line and shows edges, representing links, to two requirements. Both edges are red and dashed.

La ventana Traceability Diagram muestra la trazabilidad desde la función myAdd. Los extremos discontinuos rojos representan enlaces que tienen incidentes de cambio. Las flechas de los extremos van de la función myAdd a los requisitos, lo que indica que los cambios se propagan desde la función a los requisitos.

Determinar acciones para resolver cambios

Ahora que comprende el alcance de los cambios y cómo se propagan dentro del proyecto, puede determinar las acciones necesarias para resolver los cambios.

El informe de comparación muestra que el cambio en myAdd.m era un cambio solo en comentarios. Dado que el cambio no tiene impacto en los requisitos, puede borrar los incidentes de cambio sin realizar ninguna otra acción. En Requirements Editor, haga clic con el botón secundario en el conjunto de enlaces y seleccione Clear All Change Issues.

In the Requirements Editor, the mouse points to the context menu that appears when you right-click the link set. The mouse points to the Clear All Change Issues menu option for the link set.

Se abre un cuadro de diálogo para introducir un comentario sobre el cambio. El software rellena previamente el campo Comment con %<updateInfo>, lo que genera automáticamente un comentario a partir de los detalles del cambio. Debajo de esa línea, introduzca Comment-only change.

The dialog box contains the text %<updateInfo> and Comment-only change, separated by an empty line.

Borre los incidentes de cambio haciendo clic en Clear All.

Consulte también

Apps

Clases

Temas