Control y revisiones
Solicitudes de cambio
Proponga cambios en elementos aprobados o incluidos en una línea base como una solicitud de cambio, haga que se revisen y aprueben y aplíquelos después en un solo paso con un registro completo.
En esta página
Una solicitud de cambio propone un conjunto de ediciones del modelo, explica el motivo y espera la aprobación antes de que cambie nada. Use las solicitudes de cambio para el control de configuración: una vez aprobados los requisitos o definida una línea base, los cambios pasan por una solicitud que revisan los aprobadores del proyecto. Las solicitudes de cambio están en Control y revisiones → Solicitudes de cambio.
Cómo usarlo
Crear una solicitud de cambio
- Abra Control y revisiones → Solicitudes de cambio y haga clic en + Nueva solicitud de cambio en el encabezado de la página, o haga clic en Proponer cambio… en el encabezado de la vista del elemento de un elemento bajo control de configuración (abre la solicitud de cambio abierta del elemento cuando existe).
- Dele un Título y un Motivo: por qué se necesita el cambio y qué debe lograr.
- Haga clic en Crear y añada los Elementos afectados con Añadir elemento…. Holarch enumera los elementos trazados a ellos (requisitos, pruebas, interfaces y otros elementos relacionados); haga clic en + en los que también cambian.
Preparar los cambios
- Haga clic en Añadir cambio ▾ y elija qué proponer: Cambiar un elemento… (número, nombre, descripción en el editor de texto enriquecido, de modo que se conserva su formato, o un atributo), Nuevo elemento…, Eliminar un elemento…, Añadir una relación…, Quitar una relación…, Añadir un vínculo a otro proyecto… o Quitar un vínculo a otro proyecto…. En un proyecto SysML v2, Editar texto SysML… propone una edición del texto de un paquete.
- Haga clic en Preparar cambio. Cada cambio preparado se enumera en Cambios propuestos, con una comparación por palabras de los cambios de descripción y de texto y su lista de Impacto (consulte Impacto). Todavía no cambia nada en el modelo.
- Quite un cambio preparado con Quitar.
Enviar, revisar y aprobar
- Haga clic en Enviar a revisión. En el servicio alojado, los aprobadores reciben un aviso y una entrada en Mi trabajo → Por decidir, donde Aprobar… y Rechazar… abren la solicitud con su diálogo de voto.
- Un aprobador abre la solicitud, comprueba los cambios propuestos y sus listas de Impacto, y hace clic en Aprobar… o Rechazar… (un rechazo necesita un motivo). Cuando un requisito modificado está en una línea base, el diálogo Aprobar… también enumera los elementos de verificación y los documentos que necesitan una nueva revisión.
- La tarjeta de revisión muestra Aprobaciones: N de M. Una solicitud cuyos cambios de estado tienen sus propios aprobadores también enumera cada regla con su recuento, por ejemplo ○ Todos los aprobadores nombrados (3): 1 de 3. Cuando la solicitud tiene las aprobaciones que necesita, su estado pasa a Aprobada. Un rechazo la rechaza; el autor puede entonces editar los cambios y volver a enviarla.
Retirar cierra una solicitud que aún no se ha aplicado sin cambiar el modelo; su registro se mantiene en el historial.
Aplicar los cambios
- Un editor o propietario abre la solicitud aprobada y hace clic en Aplicar cambios, y después confirma con Aplicar cambios.
- Todos los cambios preparados se aplican juntos, y un solo Deshacer lo revierte todo. El historial de cada elemento modificado registra el cambio «via CR-12».
- Los cambios cuyos elementos se eliminaron entretanto se omiten y se enumeran con el resultado. Una publicación de configuración preparada (Añadir cambio ▾ → Publicar una configuración…) se registra con los aprobadores de la solicitud, o se enumera con el motivo por el que no se publicó; consulte Publicar mediante una solicitud de cambio.
- La solicitud conserva la lista de Impacto de cada cambio tal como era justo antes de aplicar los cambios, como registro de lo que se tuvo en cuenta. Su Historial muestra «impact recorded» con los recuentos, por ejemplo «4 affected, 9 to check». Aplicar nunca espera a la lista de impacto: si después de unos segundos aún se están leyendo elementos de otros proyectos, la solicitud se aplica de inmediato y conserva la lista calculada hasta ese momento, marcada como «Impact not finished when applied» en la solicitud, en su Historial y en las exportaciones.
Trabajar en una solicitud de cambio
En lugar de preparar cada cambio en un diálogo, puede trabajar en una solicitud de cambio en borrador: edite el modelo como de costumbre en cualquier página, y sus ediciones van a la solicitud en lugar de al modelo activo. El modelo activo solo cambia cuando la solicitud se aprueba y se aplica.
Activarlo
El trabajo en solicitudes de cambio está desactivado en todos los proyectos hasta que un propietario del proyecto lo activa: abra Ajustes en la página Solicitudes de cambio y marque Trabajar en solicitudes de cambio: editar en un borrador y aplicar tras la aprobación. La desactivación se rechaza mientras un borrador aún contiene ediciones hechas en él; aplique o retire primero esas solicitudes. En el servicio alojado, el trabajo en solicitudes de cambio viene con el plan Team del propietario del proyecto, igual que las reglas de aprobación (consulte la nota en Control de configuración): una dirección de correo electrónico académica verificada o la pertenencia a una organización de clase activa también lo incluyen, y los proyectos que usaban las reglas de aprobación antes de la versión 2.29.0 lo conservan. En los demás planes, el ajuste se muestra desactivado. La aplicación de escritorio no tiene planes.
Empezar y salir
Empiece a trabajar en una solicitud en borrador desde cualquiera de estos lugares:
- Trabajar en ella ahora en el diálogo Nueva solicitud de cambio (marcado de forma predeterminada).
- Trabajar en esta solicitud de cambio en la página de una solicitud en borrador.
- Proponer cambio ▾ → Trabajar en una solicitud de cambio… en la vista del elemento de un elemento. La lista muestra los borradores que nombran el elemento, además de Nueva solicitud de cambio….
- Trabajar en una solicitud de cambio en el mensaje que aparece al editar un elemento bajo control de configuración.
- ⌘K / Ctrl+K → Trabajar en una solicitud de cambio….
- Continuar en Mi trabajo → Solicitudes de cambio en las que trabajo.
Mientras trabaja en una solicitud:
- Un banner bajo la barra superior indica, por ejemplo, Trabajando en CR-12 Range upgrade. Las ediciones van a esta solicitud de cambio, no al modelo activo. 3 cambios. con Revisar cambios y Salir.
- El estado de guardado indica, por ejemplo, Guardado 14:02 en CR-12.
- Los elementos que cambió la solicitud llevan una marca SC en las tablas y en los diagramas.
Para probarlo, abra el proyecto de demostración CubeSat EO-1: CR-1 Shorten the planning cycle es un borrador con ediciones hechas en él. Ábralo en Solicitudes de cambio y haga clic en Trabajar en esta solicitud de cambio. En la demo Hybrid Car, CR-2 Clarify the charge time contiene una edición de la documentación de un requisito.
Haga clic en Salir en el banner (o ⌘K / Ctrl+K → Salir de la solicitud de cambio) para volver al modelo activo. El modo pertenece a la pestaña del navegador: otra pestaña puede mostrar el modelo activo al mismo tiempo, y una recarga mantiene la pestaña en la solicitud.
Qué funciona de forma distinta
- Deshacer se detiene donde entró en la solicitud.
- Los cambios de esquema, las líneas base, el uso compartido, Solicitar aprobación y Restaurar una versión anterior se rechazan hasta que salga de la solicitud.
- Los elementos bajo control de configuración se pueden editar en la solicitud; para eso sirve.
- Enviar a revisión pausa las ediciones hasta que la solicitud se decide o se retira. Una solicitud rechazada vuelve a ser un borrador cuando la edita.
- Retirar mueve las ediciones de la solicitud a la Papelera como una entrada, por ejemplo CR-12 changes; Restaurar las devuelve a la solicitud.
Revisar los cambios
Una solicitud con ediciones hechas en ella tiene dos pestañas en su página: Detalles (la solicitud, los cambios preparados, la revisión, los comentarios y el historial) y Cambios, que compara el modelo antes de la solicitud con el modelo tal como lo dejaría la solicitud. Revisar cambios en el banner la abre.
- Los mosaicos de recuento muestran los elementos añadidos, quitados y modificados y los cambios de relaciones; debajo, cada cambio tiene su propia fila, con el texto modificado mostrado palabra por palabra.
- Los resultados de calidad, las marcas de vínculos sospechosos y otros registros de revisión se ocultan; haga clic en Mostrar datos de revisión para enumerarlos también.
- Documentos enumera cada documento que contiene un elemento modificado. Comparar versiones… muestra el documento antes de la solicitud y con ella, cada campo uno junto a otro con las palabras modificadas marcadas; una frase que se movió dentro de un campo se muestra en violeta en ambos lugares, con un vínculo entre ellos.
- Diagramas enumera cada diagrama modificado con lo que cambió, por ejemplo Asset Diagram 0 Drone Delivery System: 1 shape added (Charger), 1 moved. Mostrar antes y después dibuja ambas versiones una junto a otra.
Vista previa en el modelo en la página de la solicitud abre el modelo tal como sería después de aplicar la solicitud, en modo de solo lectura. El banner indica, por ejemplo, Vista previa de CR-12 (solo lectura). Cada página muestra el cambio en su lugar, de modo que puede comprobar una especificación generada, la RVTM o una matriz. Las ediciones se rechazan hasta que haga clic en Salir. Los revisores y lectores también pueden ver la vista previa.
Los votos cubren las ediciones hechas en la solicitud además de sus cambios preparados: una edición hecha después de un voto anula ese voto, y los aprobadores vuelven a decidir.
Aplicar una solicitud en la que ha trabajado
Aplicar cambios en una solicitud aprobada compara primero sus ediciones con el modelo activo tal como está ahora, porque otras personas pueden haber cambiado los mismos elementos entretanto.
- Sin conflictos: la confirmación indica, por ejemplo, ¿Aplicar 14 cambios al modelo activo? Un solo Deshacer lo revierte todo. Después de Aplicar cambios, el aviso indica CR-12 aplicada: 14 cambios. Los elementos nuevos conservan sus id, y el historial de cada elemento modificado indica «via CR-12» y nombra a los autores de la solicitud.
- Los cambios en campos distintos del mismo elemento se fusionan sin preguntar: si la solicitud cambió el nombre de un elemento y otra persona cambió su número en el modelo activo, se conservan ambos cambios.
- Conflictos: el mismo campo cambiado en ambos lados, un elemento eliminado en un lado y cambiado en el otro, o un vínculo de la solicitud a un elemento eliminado en el modelo activo. La página de la solicitud los cuenta, por ejemplo CR-12 tiene 2 conflictos con el modelo activo., y Aplicar cambios abre primero Resolver conflictos — CR-12.
En Resolver conflictos, cada elemento en conflicto tiene una tarjeta con la versión del Modelo activo (en el servicio alojado, con quién la cambió) y la versión de la Solicitud de cambio; Mostrar original añade la versión anterior a ambos cambios. Los diagramas se dibujan uno junto a otro. Elija una de estas opciones:
- Mantener actualizado: el elemento se queda como lo tiene el modelo activo. Para un vínculo a un elemento eliminado, el vínculo se omite.
- Usar la solicitud de cambio: el valor de la solicitud para cada campo que cambió; los campos que solo cambió el modelo activo conservan su valor activo. Para una eliminación, el resultado de la solicitud: el elemento se elimina, o se restaura con los cambios de la solicitud. Para un vínculo a un elemento eliminado, el elemento se restaura desde la papelera con el vínculo.
- Combinar: una fila por campo cambiado con En vivo y Solicitud de cambio. Los campos que solo cambió un lado empiezan en ese lado; los que cambiaron ambos empiezan en Solicitud de cambio.
Aplicar cambios permanece desactivado hasta que cada conflicto tiene una elección («Elija una versión para cada uno de los 3 conflictos.»). Solo un aprobador de la solicitud que pueda editar resuelve los conflictos; los demás ven, por ejemplo, CR-12 tiene 3 conflictos con el modelo activo. Un aprobador los resuelve al aplicar. El Historial de la solicitud registra cada elección («Kept the live version of R.4.2», «Replaced a live change by Ann to R.4.3»), y en el servicio alojado la persona cuyo cambio activo se sustituyó recibe una notificación.
Un solo Deshacer revierte toda la aplicación: restaura el modelo activo y devuelve la solicitud a Aprobada con sus ediciones, lista para aplicarse de nuevo. Tras aplicar, la pestaña Cambios de la solicitud conserva la lista de lo que se aplicó. Una solicitud editada después de su aprobación no se puede aplicar hasta que se envíe y se apruebe de nuevo. Quien esté trabajando en la solicitud o viendo su vista previa cuando se aplica vuelve al modelo activo. En un proyecto SysML v2, la confirmación enumera los errores que la solicitud añadiría al modelo, y Aplicar cambios permanece desactivado hasta que elija otra versión o se rechace la solicitud.
Impacto
Cada cambio preparado tiene una lista de Impacto: los elementos que se trazan a él, encontrados antes de que nadie apruebe o aplique el cambio. Su encabezado muestra los recuentos, por ejemplo Impacto: 3 afectados · 7 por comprobar. Haga clic en el encabezado para mostrar u ocultar la lista. Una solicitud con más de tres cambios empieza con las listas cerradas.
La lista se agrupa en Requisitos, Pruebas y verificación, Interfaces, Documentos, Diagramas, Elementos de otros proyectos y Otros elementos. Cada fila se marca:
| Marca | Significado |
|---|---|
| Afectado | El cambio lo toca: un elemento a una relación del elemento modificado, un documento o diagrama que muestra el elemento modificado, los dos extremos de una relación añadida o quitada, y los elementos de otros proyectos vinculados al elemento modificado. |
| Comprobación | Un paso más allá: los elementos trazados a un elemento afectado, los documentos y diagramas que los muestran, y los elementos de otros proyectos a dos vínculos de distancia. |
Cada fila nombra su clase y cómo se llega a ella, por ejemplo «verified by 1.1 Pump pressure». Un vínculo a otro proyecto cuyo elemento cambió desde la última revisión del vínculo muestra Cambiado. Haga clic en una fila para abrir el elemento, el documento o el diagrama. Los elementos de otros proyectos proceden de Traza del elemento, con su propio acceso: los vínculos a proyectos que no puede abrir solo se cuentan.
Una lista muestra como máximo 300 filas e indica cuántas más hay. Los vínculos a otros proyectos se leen para los 12 primeros elementos modificados.
Bajo el encabezado, una nota indica en qué se basa la lista: «El impacto se basa en las relaciones modeladas; es posible que no aparezcan dependencias sin vincular o más lejanas. Calculado sobre la revisión 1.204 a las 14:02.» La revisión es la revisión del proyecto cuando se calculó la lista (en el servicio alojado, el mismo número para todos los editores). Si el modelo cambia mientras lee, la lista se queda como se calculó; vuelva a abrir la solicitud para calcularla de nuevo. Una lista guardada conserva la revisión sobre la que se calculó.
Cuando se aplica la solicitud, las listas se guardan con ella y se muestran como eran, de modo que el registro sigue indicando lo que se tuvo en cuenta después de que se cambie el nombre de elementos o se eliminen. Exportar ▾ → Word (.docx) las incluye, y el historial de Excel tiene una columna Impacto con los recuentos.
La misma lista aparece en otros lugares donde un cambio espera una decisión:
- Vistas previas de IA y propuestas de clientes de IA: consulte IA.
- Nueva publicación… de una biblioteca: los proyectos y elementos que usan los elementos de biblioteca cambiados desde la última publicación; consulte Bibliotecas.
- Aprobación de un requisito en línea base: los elementos de verificación y los documentos que necesitarían una nueva revisión; consulte Requisitos.
Estado
| Estado | Significado |
|---|---|
| Borrador | En redacción; el autor prepara los cambios. |
| Enviada | Esperando a los aprobadores. |
| En revisión | Al menos un aprobador ha votado. |
| Aprobada | Aprobaciones suficientes; lista para aplicarse. |
| Rechazada | Un aprobador la rechazó; el autor puede revisarla y volver a enviarla. |
| Retirada | Cerrada sin cambiar el modelo. |
| Implementada | Los cambios se aplicaron. |
Control de configuración
Nota: en el servicio alojado, decide el plan del propietario del proyecto. El control de configuración (el primer ajuste) viene con los planes Individual y Team; las reglas de aprobación siguientes (aprobaciones necesarias, quién aprueba, un comité de cambios, autoaprobación) vienen con el plan Team. Una dirección de correo electrónico académica verificada o la pertenencia a una organización de clase activa conservan ambos. Los proyectos y organizaciones que los usaban antes de la versión 2.29.0 los conservan. Sin las reglas de aprobación, las solicitudes de cambio funcionan con una sola regla: decide la aprobación de un propietario del proyecto, y el autor puede aprobar su propia solicitud, de modo que puede aprobar y aplicar sus propios cambios cuando trabaja solo. Los ajustes guardados antes se conservan pero no se aplican, y Ajustes lo indica; los elementos aprobados y en línea base se pueden editar entonces directamente. Los registros de aprobación, los votos y los estados se conservan. La aplicación de escritorio no tiene planes.
Ajustes en el encabezado de la página Solicitudes de cambio abre Ajustes de las solicitudes de cambio. Agrupa los ajustes en Control de configuración (qué necesita una solicitud de cambio y si los editores trabajan en borradores) y Aprobación (cuántas aprobaciones, quién aprueba, autoaprobación); cada ajuste se aplica al cambiarlo, y Hecho cierra el diálogo. La línea sobre la lista indica lo que hacen ahora los ajustes, por ejemplo «Los elementos aprobados y en línea base se pueden editar directamente; 1 aprobación de propietarios del proyecto.», con un vínculo Cambiar en Ajustes.
En Ajustes, un propietario del proyecto puede activar Los cambios en elementos aprobados y en línea base requieren una solicitud de cambio. Entonces:
- Los requisitos aprobados (Status Approved) y los elementos de la última línea base del proyecto ya no se pueden editar, eliminar ni vincular directamente. Holarch explica el motivo y remite a las solicitudes de cambio.
- Su Aplica a, su Aplicabilidad y su pertenencia a configuraciones (líneas de productos) también forman parte de ellos: cambiar a qué configuraciones o unidades se aplica un elemento necesita una solicitud de cambio.
- Los comentarios, las revisiones, las aprobaciones de requisitos, los resultados de calidad y las marcas de revisión de vínculos siguen abiertos.
- Las solicitudes de cambio aprobadas aplican sus cambios a estos elementos.
- La API REST y MCP siguen la misma regla: un cambio directo de un script en estos elementos se rechaza (
409 change-control), y la propuesta de un cliente de IA no puede incluirlos. Proponga el cambio en una solicitud de cambio. - En el servicio alojado, el servidor comprueba cada cambio que le llega, también los cambios hechos sin conexión. Un cambio en un elemento aprobado o en línea base que se hizo antes de que el elemento quedara bajo control (sin conexión, o mientras otra persona lo aprobaba) no se guarda: Holarch indica qué elemento era, recarga el proyecto y conserva sus demás cambios. Proponga ese cambio en una solicitud de cambio.
Nota: en el servicio alojado, el servidor impone el control de configuración en todas las formas de edición (la aplicación, la API REST y MCP); un editor no puede eludirlo con otro cliente. Solo aplicar una solicitud de cambio aprobada modifica estos elementos. En la aplicación de escritorio y en los proyectos del navegador, lo impone la aplicación, como hace con los bloqueos de elementos.
Aprobaciones y aprobadores
- Aprobaciones necesarias: 1, 2 o 3.
- Quién aprueba: Propietarios del proyecto, Propietarios y editores o Un comité de cambios de miembros del proyecto con nombre (servicio alojado; en la aplicación de escritorio usted aprueba sus propias solicitudes). Un comité de cambios puede nombrar Revisores: aprueban, rechazan y comentan la solicitud sin poder editar el modelo. Todos los miembros del proyecto que pueden comentar (Revisor o superior) pueden comentar una solicitud de cambio.
- Los autores pueden aprobar sus propias solicitudes de cambio: desactivado de forma predeterminada.
Solo los propietarios del proyecto cambian estos ajustes.
Los mismos ajustes se aplican a las solicitudes que crea un flujo de trabajo: un cambio de estado marcado como Aprobación en Esquema → Flujo de trabajo abre Solicitar aprobación, que crea y envía una solicitud de cambio con ese único cambio.
Una transición de flujo de trabajo puede nombrar sus propios aprobadores, por ejemplo todos los miembros de un comité de revisión, o 2 de 4 ingenieros con nombre (Elegir los aprobadores de una transición). Una solicitud necesita entonces las aprobaciones de cada regla a la que pertenecen sus cambios de estado; los cambios que no cubre ninguna transición usan estos ajustes. En la aplicación de escritorio, los aprobadores son nombres: usted aprueba con el nombre de Preferencias → Su nombre. Una solicitud que solo contiene cambios de estado se aplica con su última aprobación cuando ese aprobador puede editar.
En el servicio alojado, Holarch solo usa los ajustes que guardó un propietario del proyecto; los ajustes cambiados por otra persona se ignoran y se aplican los valores predeterminados (aprueban los propietarios, una aprobación, no sus propias solicitudes).
Cuando Holarch no tiene constancia de quién envió una solicitud de cambio, por ejemplo en un proyecto subido o importado con sus solicitudes, solo un propietario del proyecto puede aprobarla. Los ajustes sin constancia de quién los guardó se aplican con los propietarios como aprobadores y sin autoaprobación hasta que un propietario los vuelve a guardar.
Registros de aprobación
En el servicio alojado, aprobar o rechazar pide su contraseña (una vez cada 10 minutos) y registra quién decidió, cuándo, la nota y los cambios preparados exactos a los que se aplica el voto. Si los cambios preparados se editan después de un voto, ese voto deja de contar y se vuelve a preguntar a los aprobadores. Antes de aplicar los cambios, el servidor comprueba que la solicitud está aprobada con sus cambios actuales. Cada voto se escribe también en el registro de auditoría (solicitud, decisión y longitud de la nota; no la nota en sí).
Nota: un registro de aprobación muestra quién aprobó qué y cuándo. No es una firma electrónica regulada legalmente (como una conforme a 21 CFR Part 11).
Comentarios, avisos y el historial
- Los Comentarios de una solicitud de cambio funcionan como los comentarios de los elementos.
- En el servicio alojado, los avisos llegan a los aprobadores cuando se envía una solicitud, al autor cuando se aprueba o se rechaza, y al autor y a los votantes cuando se aplica o se retira.
- Cada solicitud conserva un Historial de lo que ocurrió, quién lo hizo y cuándo.
- Exportar ▾ en la página Solicitudes de cambio (se muestra en cuanto existe una solicitud de cambio) guarda el historial de solicitudes de cambio como Excel (.xlsx) o Word (.docx), con los cambios y el historial de cada solicitud.