Modelo
Esquema y extensiones
Adapte el esquema LML de un proyecto con clases, atributos, opciones, relaciones, etiquetas y flujos de estado personalizados, y vea cómo afecta cada cambio a los datos existentes.
En esta página
- Resumen
- Conceptos
- Cómo usarlo
- Cuándo y por qué
- Añadir un atributo a una clase
- Añadir opciones a un atributo existente
- Crear una subclase
- Añadir una etiqueta
- Permitir una relación nueva
- Definir un flujo de trabajo de estado
- Añadir o cambiar los estados de un flujo de trabajo
- Elegir los aprobadores de una transición
- Solicitar la aprobación de un cambio de estado
- Compartir un esquema entre proyectos
- Ejemplo práctico: CubeSat EO-1
- Consejos y buenas prácticas
- Errores habituales
- Cómo se relaciona con otras funciones
- El Editor de esquema
- Cómo afectan los cambios del esquema a los datos existentes
- Extensiones integradas
- Atajos de teclado
- Opciones y ajustes
- Mensajes
- Límites
- Relacionado
Resumen
El esquema define lo que puede contener el modelo de un proyecto:
- las clases de entidades,
- los atributos que tiene cada clase,
- las relaciones que pueden conectar clases,
- las etiquetas que marcan entidades,
- flujos de trabajo opcionales: los estados de un atributo de estado por clase, cómo pueden cambiar y qué cambios necesitan aprobación.
Todos los proyectos parten del esquema predeterminado de Lifecycle Modeling Language (LML). El Editor de esquema lo cambia solo para un proyecto. La primera edición crea la copia propia del proyecto, de modo que los demás proyectos no se ven afectados. Cada edición del esquema se puede deshacer con un solo Deshacer.
Holarch también añade extensiones integradas a todos los proyectos, como Prioridad y Owner en los requisitos y Handling Strategy en los riesgos. Consulte Extensiones integradas.
Para trabajar a diario con entidades, atributos y relaciones, consulte Modelo y base de datos.
Conceptos
El esquema del proyecto
- Esquema predeterminado: las clases, relaciones, atributos y etiquetas de LML que incluye Holarch. Los temas de la Ayuda de la aplicación Clases de LML (esquema), Relaciones de LML (esquema) y Etiquetas (esquema) los enumeran en directo para el proyecto abierto.
- Esquema del proyecto: una copia guardada dentro del proyecto. Se crea con la primera edición. Viaja con el proyecto en las exportaciones y llega a cada miembro que lo abre.
- Extensiones integradas: adiciones que necesitan las funciones de Holarch. Se aplican por nombre cada vez que se abre un proyecto. Por eso la mayoría de los proyectos ya tienen su propia copia, y la página Uso dice «Este proyecto usa su propio esquema editado.»
Clases
Una clase es un tipo de entidad, como Requirement o Asset. Tiene Nombre, Descripción, Padre y Color, y dos indicadores (Abstracta y Oculta).
- Padre: una subclase hereda los atributos y los destinos de relación de su padre. Aparece en cada consulta, filtro y diagrama que abarca al padre. Por ejemplo, una subclase personalizada de Action obtiene diagramas de acciones. Una subclase personalizada de Requirement obtiene las comprobaciones de calidad y los controles de aprobación.
- Abstracta: la clase agrupa subclases y no se puede crear directamente.
- Oculta: la clase no se ofrece al crear entidades ni al cambiar su clase. Ella y sus subclases quedan fuera del filtro de clases de la Base de datos. Las entidades existentes se conservan.
- Color: el color de la insignia y la muestra de la clase. Sin él, una clase personalizada toma el color de su antecesor integrado más cercano. La insignia muestra las dos primeras letras del nombre.
Atributos
Un atributo es un campo que tiene cada entidad de una clase, como Prioridad en los requisitos. Un atributo también puede pertenecer a una relación.
Un atributo tiene Nombre, Tipo y un lugar en el orden de la clase. Puede tener Valores permitidos, un Valor predeterminado y una Descripción. La descripción se muestra al situar el puntero sobre la etiqueta del atributo.
Tipos, agrupados como los enumera el diálogo de atributo (el id del tipo guardado va entre corchetes; lo usan las exportaciones, las importaciones y la API):
| Grupo | Tipo | Contiene |
|---|---|---|
| Texto | Texto corto (TEXT), Texto largo (BIG_TEXT), Texto enriquecido (HTML) | Una línea; varias líneas; texto con formato |
| Cifras | Número (NUMBER), Porcentaje (PERCENT), Duración (DURATION) | Un número o una distribución; de 0 a 100; un número o una distribución con una unidad de tiempo |
| Fecha y hora | Fecha y hora (DATETIME) | Fecha y hora |
| Opciones | Uno de una lista (ENUMERATION), Varios de una lista (MULTISELECT), Sí o no (BOOLEAN) | Un valor; varios valores; Sí o No |
| Vínculos | Dirección web (URI), Archivo (FILE) | Un enlace; un archivo subido |
| Especial | Ubicación (GEOPOINT), Ecuación (EQUATION), Calculado (COMPUTABLE), Persona o equipo (USER_TEAM), Multiplicidad (MULTIPLICITY), Comprobación de calidad (QUALITY) | Latitud y longitud; texto LaTeX; un valor calculado a partir de atributos de otras entidades; el nombre de una persona o un equipo; n, n..m, n..* o *; un criterio Sí/No fijado por la comprobación de calidad |
Los editores de cada tipo se describen en Tipos de atributo y editores.
Los atributos heredados de las clases padre se enumeran primero y después los atributos propios de la clase, en el orden establecido en la página de cada clase (arrastre una fila o use ↑ / ↓). Un atributo nuevo va al final.
Un atributo oculto conserva sus valores. Desaparece de los editores, filtros, columnas, búsquedas e informes hasta que se vuelve a mostrar.
Relaciones y destinos
- Una relación es siempre un par: un nombre y un nombre inverso, como satisfies / satisfied by. Al crear una se crean ambos.
- Un destino permite una relación de una clase a otra, por ejemplo Requirement verified by Test Case. Un destino a una clase también permite sus subclases. Las subclases heredan los destinos de su padre.
- Las relaciones pueden llevar atributos, por ejemplo Multiplicity en decomposed by. Un atributo añadido a una relación también se aplica a su inversa.
- Una relación oculta se muestra atenuada en el Editor de esquema y queda fuera de la lista de referencia de la Ayuda. Sigue pudiendo usarse.
Etiquetas
Una etiqueta es una marca que se pone en las entidades, como Stakeholder Need. No añade campos ni cambia nada estructural.
Una etiqueta tiene Nombre, Descripción y las Clases a las que se aplica. Puede tener una etiqueta Padre, de modo que las etiquetas pueden anidarse.
- Sin ninguna clase seleccionada, la etiqueta se aplica a todas las clases.
- Una etiqueta para una clase también se aplica a sus subclases.
- Una etiqueta oculta permanece en las entidades que la tienen, pero ya no se ofrece.
Flujos de trabajo
Un flujo de trabajo controla cómo puede cambiar un atributo ENUMERATION de una clase, normalmente Estado. Tiene:
- Estados: los valores que usa la clase, en orden. Se pueden añadir, cambiar de nombre, reordenar y quitar estados personalizados. Los estados integrados, como Approved de un requisito, solo se pueden retirar. Una subclase cuyo atributo es heredado (por ejemplo una Software Requirement bajo Requirement) conserva sus propios estados.
- Transiciones (De → A): los cambios permitidos. Sin transiciones, cualquier estado puede seguir a cualquier otro.
- Aprobación en una transición: el cambio necesita una solicitud de cambio aprobada. De forma predeterminada deciden los aprobadores establecidos en Solicitudes de cambio → Ajustes. Una transición puede nombrar en su lugar sus propios aprobadores: propietarios, editores o personas concretas, y cuántos de ellos deben aprobar (hasta 5, o todas las personas nombradas).
- Bloquear el elemento después de esta transición (en el menú ⋯ de la transición): el elemento se bloquea después del cambio.
Los editores del atributo ofrecen entonces solo el valor actual y los siguientes estados permitidos. Un estado que necesita aprobación dice (requiere aprobación).
Cómo usarlo
Cuándo y por qué
Adapte el esquema al inicio de un proyecto: cuando establezca el método de modelado y antes de importar datos. Motivos habituales:
- Adoptar un método o una norma: añada los atributos que exige su proceso, por ejemplo un TRL en los activos o un Safety Integrity Level en los requisitos. Añada las etiquetas que esperan sus plantillas de documento.
- Especializar clases: añada subclases como Hazard bajo Risk o Payload Instrument bajo Asset. Así las consultas, los filtros y los informes pueden distinguirlas, y conservan todas las relaciones de LML.
- Permitir una relación que necesita el método: añada un destino o un nuevo par de relaciones.
- Imponer un proceso de revisión: añada un flujo de trabajo para que el Status de un requisito pase de Draft → In Review → Approved. El editor nunca deja entonces que se salte un paso. Marque In Review → Approved como Aprobación para que el cambio pase por los aprobadores del proyecto.
- Reutilizar entre proyectos: exporte el esquema de un proyecto e impórtelo en el siguiente.
El esquema responde a la pregunta «¿Qué puede decir este modelo?». Cámbielo de forma deliberada. Las consultas, las columnas guardadas, los informes y las importaciones se refieren a las clases, los atributos y las relaciones por su nombre.
Añadir un atributo a una clase
- En la barra de navegación, haga clic en Ajustes → Esquema (con las herramientas de la parte inferior).
- En la barra lateral, en Clases, haga clic en la clase, por ejemplo Asset.
- En la tarjeta Atributos, haga clic en + Atributo.
- Introduzca el Nombre.
- Elija el Tipo, por ejemplo Uno de una lista en Opciones.
- Para Uno de una lista o Varios de una lista: escriba las opciones en Valores permitidos, una por línea.
- Opcional: establezca un Valor predeterminado. Las nuevas entidades de la clase empiezan con él.
- Opcional: introduzca una Descripción.
- Haga clic en Añadir atributo.
Verá el aviso «Atributo guardado». El atributo queda el último en la lista de la clase y aparece para esa clase y sus subclases: en el inspector, la Vista del elemento, las columnas y filtros de la Base de datos, las búsquedas, los informes y las asignaciones de importación.
- Para moverlo, arrastre su fila en la tabla Atributos o use ↑ y ↓ en la fila. Cada movimiento se puede deshacer con un solo Deshacer.
Añadir opciones a un atributo existente
- Abra la clase que define el atributo. La columna Definido en la muestra. Un atributo heredado se edita en la clase que lo define.
- Haga clic en ✎ (Editar atributo) en la fila.
- Añada la nueva opción en su propia línea en Valores permitidos.
- Haga clic en Guardar.
En Uno de una lista, el cuadrado que precede a cada opción (bajo la lista) define el color del valor. Los tableros Kanban cuyas columnas son los valores de ese atributo lo usan como color de la columna.
Para quitar una opción, borre su línea en el mismo diálogo. Las entidades que ya tienen ese valor lo conservan, pero el editor deja de ofrecerlo. Antes de quitar una opción, busque esas entidades con una consulta de atributo (por ejemplo Requirement:"Priority=Urgent") y asígneles una opción vigente.
Crear una subclase
- Abra la clase padre.
- Haga clic en + Subclase.
(O haga clic en + Clase en la barra lateral y elija el Padre).
- Introduzca el Nombre y la Descripción.
- Establezca Abstracta, Oculta y Color si es necesario.
- Haga clic en Crear clase.
Verá la nueva clase. Ya tiene todos los atributos y destinos heredados.
Para mover entidades existentes a la nueva clase, selecciónelas en la Base de datos y use Cambiar clase…. Consulte Cambiar clase.
Añadir una etiqueta
- Haga clic en + Etiqueta en la barra lateral, o en + Nueva etiqueta en la página Etiquetas.
- Introduzca el Nombre y la Descripción.
- Si la etiqueta va bajo otra etiqueta, elija ese Padre.
- Seleccione las Clases a las que se aplica. ⌘ / Ctrl/Ctrl+clic selecciona varias. Sin ninguna seleccionada, la etiqueta se aplica a todas las clases.
- Haga clic en Crear etiqueta.
Para aplicar la etiqueta, use + Etiqueta en el inspector o en la Vista del elemento, o Etiqueta ▾ en la barra de acciones masivas de la Base de datos.
Permitir una relación nueva
Una relación entre dos clases solo se permite cuando un destino lo autoriza. Añada un destino para permitirla.
- Abra la clase de origen.
- En Relaciones, haga clic en + Relación.
- Elija la Relación.
- Elija la Otra clase.
- Deje marcado Añadir también la relación inversa a la otra clase. Así el vínculo se puede crear desde cualquiera de los extremos.
- Haga clic en Añadir relación.
Si a la otra clase le falta la inversa, la columna Volver a esta clase muestra + en <class>: haga clic para añadir allí la inversa.
Si la relación que necesita no existe, créela primero:
- Haga clic en Nuevo tipo de relación… en el diálogo (o en + Relación en la barra lateral).
- Introduzca el Nombre y el Nombre inverso, y sus descripciones.
- Haga clic en Crear relación.
- Elija la nueva relación en el paso 3 anterior.
Definir un flujo de trabajo de estado
- Haga clic en Flujo de trabajo en la barra lateral.
- En Añadir una clase…, elija la clase.
Verá una tarjeta para la clase. El flujo de trabajo vigila el primer atributo de enumeración de la clase.
- Si es necesario, elija otro atributo en la lista vigila. Cambiarlo borra las transiciones.
- Haga clic en + Añadir transición.
- Establezca el Nombre, De y A de la transición. De es (Inicial — sin valor) o un estado.
- Marque Aprobación si el cambio necesita una solicitud de cambio aprobada. Para bloquear el elemento después del cambio, abra el menú ⋯ de la fila (o haga clic derecho en la fila) y elija Bloquear el elemento después de esta transición; la fila dice entonces Bloquea el elemento.
- Repita los pasos 4 a 6 para cada paso permitido.
Para elegir quién aprueba una transición, consulte Elegir los aprobadores de una transición.
Los editores del atributo ofrecen ahora solo los siguientes estados permitidos, marcados con ⇢ flujo de trabajo.
Añadir o cambiar los estados de un flujo de trabajo
- En la página Flujo de trabajo, busque la tarjeta de la clase. La columna Elementos cuenta los elementos en cada estado; un elemento sin valor cuenta en el valor predeterminado del atributo (un caso de prueba sin estado cuenta como No ejecutado, tal como lo muestra el Centro de pruebas).
- Para añadir un estado, escriba su nombre en Nuevo estado y haga clic en + Añadir estado.
El estado se añade a la clase y a las opciones del atributo.
- Para ordenar los estados, haga clic en ↑ o ↓. Los selectores y las columnas de los tableros siguen este orden.
- Para cambiar el nombre de un estado personalizado, haga clic en Cambiar nombre… e introduzca el nombre nuevo.
Los elementos en ese estado, las transiciones y el color del valor reciben el nombre nuevo. Un solo Deshacer lo revierte todo.
- Para quitar un estado, haga clic en Quitar… (personalizado) o Retirar… (integrado).
- Un estado que no tiene ningún elemento se quita.
- Cuando hay elementos en él, elija Mover y quitar con el estado al que moverlos, o Conservar como Retirado. Un estado retirado permanece en sus elementos, muestra (retirado) y deja de ofrecerse. Sus transiciones salientes se conservan, de modo que los elementos pueden salir de él. Restaurar lo vuelve a ofrecer.
Ningún cambio en esta página borra un valor.
Elegir los aprobadores de una transición
- En la página Flujo de trabajo, marque Aprobación en la transición.
Aparece un botón a su lado: Ajustes de solicitudes de cambio ▾.
- Haga clic en el botón.
Se abre Aprobadores de la transición.
- En Quién aprueba, elija una opción:
- Según Solicitudes de cambio → Ajustes: deciden los aprobadores del proyecto (el valor predeterminado).
- Propietarios o Propietarios y editores.
- Personas designadas: marque los miembros del proyecto que aprueban. En la aplicación de escritorio, escriba sus nombres separados por comas, tal como cada persona lo introduce en Preferencias → Su nombre.
- En Aprobaciones necesarias, elija cuántas personas deben aprobar: de 1 a 5, o Todas las personas designadas.
- Haga clic en Guardar.
El botón muestra la regla, por ejemplo Las 3 designadas ▾. Un solo Deshacer revierte el cambio.
Una solicitud que contiene varios cambios de estado necesita cumplir todas las reglas que se apliquen. Un solo rechazo de alguien que puede aprobar la rechaza. En el servicio alojado, los aprobadores designados solo cuentan cuando fue un propietario del proyecto quien estableció el flujo de trabajo por última vez; de lo contrario, la transición necesita el mismo número de aprobaciones de propietarios.
Solicitar la aprobación de un cambio de estado
- En el inspector o en la Vista del elemento, elija un estado marcado (requiere aprobación). En un requisito, también puede hacer clic en su transición en la franja de revisión (termina en …).
Se abre Solicitar aprobación.
- Opcionalmente, introduzca un Motivo y haga clic en Enviar solicitud.
Se crea y se envía una solicitud de cambio con el cambio de estado. El diálogo nombra a sus aprobadores: los propios de la transición o los establecidos en Solicitudes de cambio → Ajustes. El elemento conserva su estado.
Mientras la solicitud está abierta, la franja de revisión del requisito la muestra con su recuento, por ejemplo CR-4: 1 de 3 aprobaciones.
- Los aprobadores la aprueban.
Con la última aprobación, el elemento pasa al nuevo estado, si ese aprobador puede editar el proyecto. Si no, un editor abre la solicitud y hace clic en Aplicar cambios. El historial del elemento muestra mediante CR-n, y el registro de aprobación de un requisito nombra a cada aprobador y la solicitud.
Los cambios directos a ese estado se rechazan con «… requiere aprobación. Elija «X» en el elemento para solicitarla.»: Atributos… masivo, celdas de cuadrícula, movimientos en tableros y cambios de la IA. Elegir de nuevo el estado mientras hay una solicitud abierta abre esa solicitud.
Compartir un esquema entre proyectos
- En el proyecto de origen, abra Ajustes → Esquema en la barra de navegación.
- Haga clic en Exportar esquema.
Se descarga un archivo JSON.
- En el proyecto de destino, abra Ajustes → Esquema en la barra de navegación.
- Haga clic en Más ▾ → Importar esquema… y elija el archivo.
- Elija el Modo:
- Combinar (añadir las clases, atributos, relaciones y etiquetas que le faltan a este proyecto, emparejados por nombre), o
- Reemplazar el esquema de este proyecto.
- Haga clic en Importar.
Ejemplo práctico: CubeSat EO-1
Este ejemplo añade un nivel de madurez tecnológica (TRL) a los activos, especializa una clase y añade un flujo de trabajo de revisión. Cree la demostración con Gestionar proyectos → Archivos de proyecto ▾ → Nuevo proyecto de demostración y abra Ajustes → Esquema en la barra de navegación.
Observe el modelo.
- Lea la página Uso.
La tabla Clases enumera primero las clases más usadas, con sus elementos, atributos y relaciones. Sin usar aún enumera las clases, etiquetas y relaciones que la demostración no usa.
Añada un TRL a los activos.
- Haga clic en Asset y después en + Atributo.
- Introduzca el nombre
TRLy elija el tipo Uno de una lista. - Escriba las opciones de
1a9en Valores permitidos, una por línea. - Introduzca la descripción
Technology readiness level. - Haga clic en Añadir atributo.
Rellénelo.
- Abra Arquitectura → Assets.
- Seleccione 1.2.1 Reaction Wheel Assembly y establezca TRL en
7en el inspector. - Establezca del mismo modo 1.2.2 Star Tracker en
6y 1.1 Payload Camera en5.Consúltelo.
- En el cuadro de búsqueda, escriba
Asset:"TRL>=6"y pulse Enter.La consulta se convierte en un chip de filtro en la barra de consulta. La tabla enumera las ruedas de reacción y el sensor estelar. Los valores de opción que son números se comparan como números.
Especialice una clase.
- De vuelta en el Editor de esquema, abra Asset y haga clic en + Subclase.
- Llámela
Payload Instrumenty haga clic en Crear clase. - En la Base de datos, marque 1.1 Payload Camera y haga clic en Cambiar clase….
- Elija Payload Instrument como Clase nueva.
El diálogo dice «1 elemento pasará a ser Payload Instrument.» y no enumera nada que quitar: la subclase hereda todos los atributos y destinos de Asset.
- Haga clic en Cambiar clase.
La cámara conserva su TRL, sus vínculos performs y su lugar en la descomposición.
Añada un flujo de trabajo de revisión.
- Abra Flujo de trabajo y elija Requirement en Añadir una clase….
- Compruebe que vigila Estado.
- Añada estas transiciones: Initial → Draft, Draft → In Review, In Review → Approved, In Review → Rejected, Rejected → Draft.
- Abra 2.4 Target Slew. Su Status es Draft.
Su lista Estado ofrece ahora solo Borrador e In Review.
Deshaga o conserve.
- Pulse ⌘Z / Ctrl+Z una vez por cambio para deshacer el experimento. O conserve los cambios y haga clic en Exportar esquema para reutilizarlos en el siguiente proyecto CubeSat.
Consejos y buenas prácticas
- Prefiera subclases y etiquetas a nuevas clases de nivel superior. Una subclase conserva todas las relaciones, diagramas y comprobaciones de LML de su padre. Una etiqueta no cambia nada estructural.
- Oculte en lugar de eliminar. Ocultar una clase, un atributo o una etiqueta mantiene intactos los datos existentes y se puede revertir.
- Configure el esquema antes de importar. La asignación de importación ofrece los atributos que existen. Las columnas asignadas a Nuevo atributo se crean automáticamente, con un tipo deducido. Consulte Importación y exportación.
- Conserve las adiciones integradas. Oculte una extensión integrada que no necesite. No le cambie el nombre ni la elimine: si falta, se vuelve a añadir, con un valor vacío, la próxima vez que se abra el proyecto.
- Documente cada elemento personalizado en su Descripción. Aparece como información sobre herramientas en los editores y en las tablas de esquema de la Ayuda.
- Las pruebas de atributo con «menor que» también coinciden con entidades sin valor. Por ejemplo,
Asset:"TRL<6"incluye los activos sin TRL. Combine esa prueba con una prueba positiva o use>=sobre el complemento.
Errores habituales
- Cambiar el tipo de un atributo borra sus valores. Holarch advierte «N entidades tienen un valor de «X». Cambiar el tipo de A a B borra esos valores.» Si necesita los valores antiguos, exporte antes un informe CSV. Un solo Deshacer revierte tanto el cambio de tipo como los valores borrados; en proyectos con más de 5,000 valores de este tipo, se muestra la tarjeta de progreso mientras se borran.
- Eliminar una relación elimina sus vínculos. La confirmación los cuenta. Deshacer los restaura.
- Quitar un destino deja relaciones que el esquema ya no permite. Los vínculos existentes se conservan; Comprobaciones del modelo los enumera en la regla Global.9 (Relaciones que el esquema no permite). Quítelos o cambie su relación antes o después de quitar el destino; la confirmación los cuenta.
- Una clase no se puede eliminar mientras tenga entidades. Cambie antes su clase o elimínelas, u oculte la clase.
- Las transiciones simples solo guían a los editores. Atributos… masivo, las importaciones y los cambios de la IA pueden seguir estableciendo cualquier estado que no requiera aprobación. Marque una transición con Aprobación cuando un cambio no deba saltarse la revisión.
- No es posible cambiar el nombre de un estado integrado. Las aprobaciones, el control de configuración y la verificación dependen de ellos. Añada un estado nuevo en su lugar o retire el integrado.
Cómo se relaciona con otras funciones
- La Base de datos, el inspector y la Vista del elemento muestran y editan los atributos. Ofrecen las relaciones que permite el esquema. Las consultas se refieren a las clases, los atributos, las etiquetas y las relaciones por su nombre. Consulte Modelo y base de datos.
- Diagramas: los tipos de diagrama que puede tener una entidad dependen de su clase y de las clases que están por encima. Las subclases personalizadas los heredan.
- Las funciones de Requisitos (calidad, aprobaciones, TBD/TBR, vínculos por revisar) dependen de atributos integrados como Estado, TBD/TBR y los criterios de calidad. Consulte Requisitos.
- La Matriz de trazabilidad y las Comprobaciones del modelo usan los destinos de relación para decidir qué está permitido y qué falta. Consulte Trazabilidad.
- La importación y exportación se asignan a los atributos por nombre y llevan el esquema en los archivos JSON de proyecto,
.holarchy ReqIF. Consulte Importación y exportación.
El Editor de esquema
El Editor de esquema es donde se hace cada cambio del esquema. Ábralo desde Ajustes → Esquema en la barra de navegación (con las herramientas de la parte inferior). La dirección schema?class=<id> abre una clase directamente (un número de clase integrada anterior sigue funcionando).
El editor tiene un encabezado de página, una barra lateral y un área principal. El área principal muestra la página Uso, una clase o la página Relaciones, Etiquetas o Flujo de trabajo.
Encabezado de página
| Control | Qué hace |
|---|---|
| Exportar esquema | Descarga el esquema del proyecto como JSON (<Project_name>_schema.json). |
| Más ▾ → Importar esquema… | Importa un archivo JSON de esquema (también un JSON de proyecto que contenga un esquema) con Combinar o Reemplazar. |
| Añadir nuevos elementos integrados… | Se muestra cuando el proyecto tiene su propio esquema. Enumera las clases, relaciones, atributos y etiquetas que tiene el esquema predeterminado y le faltan a esta copia (emparejados por nombre), como las adiciones de LML 2.0, y los valores y relaciones permitidas de LML 2.0 de los existentes (Decision Status Open y Closed; Logical decomposed by Logical; Connection transfers Input/Output), y los añade, y un solo Deshacer lo revierte todo. Las clases, atributos, opciones y datos existentes no cambian; los valores nuevos van después de los existentes. |
| Más ▾ → Restablecer al predeterminado… | Se ofrece cuando el proyecto tiene su propio esquema. Lo reemplaza por el esquema LML predeterminado tras una confirmación. |
Barra lateral
- Buscar clases, atributos, relaciones, etiquetas… filtra el árbol de clases. El área principal muestra las Clases, Atributos, Relaciones encontradas y Etiquetas encontradas que coinciden, o «Ninguna clase, atributo, relación ni etiqueta coincide. Pruebe con otro término de búsqueda.»
- Uso.
- + Clase, + Etiqueta, + Relación.
- Clases: el árbol de clases con muestras de color, las marcas «(abstracta)» y «(oculto)», y el número de entidades (incluidas las subclases).
- Otros: Relaciones (con el recuento), Etiquetas (con el recuento) y Flujo de trabajo.
Uso
Uso se abre primero. Su línea de estado dice «El esquema LML predeterminado. La primera edición crea una copia para este proyecto.» o «Este proyecto usa su propio esquema editado.»
- Clases: una tabla de las clases que no están ocultas, las más usadas primero: Clase (haga clic para abrirla), Elementos (con sus subclases), Atributos (los propios), Relaciones (permitidas, incluidas las heredadas) y Último cambio (la última vez que cambió uno de sus elementos).
- Sin usar aún: tres listas desplegables, Clases, Etiquetas y Relaciones que nada del proyecto usa, cada una con un recuento. Ocultar en una fila oculta esa clase, etiqueta o par de relaciones (un solo Deshacer lo revierte todo); los elementos ocultos permanecen en el esquema y se vuelven a mostrar desde su página o diálogo.
Página de la clase
Haga clic en una clase de la barra lateral para abrir su página. De arriba abajo:
- Ruta de navegación de las clases padre. Haga clic en una para abrirla.
- Encabezado: icono y nombre de la clase, chips Abstracta y Oculta, ✎ Editar clase, + Subclase y Eliminar. N entidades en el proyecto › abre la Base de datos filtrada por la clase.
- Tarjeta Descripción: la descripción, los chips Id N, Atributos N (con «(k heredados)» cuando algunos vienen de los padres), Relaciones N y Entidades N, y las Subclases.
- Tarjeta Atributos: + Atributo y una tabla con estas columnas:
- Los controles de orden de los atributos propios de la clase: arrastre la fila o use ↑ / ↓ (un solo Deshacer revierte cada movimiento).
- Nombre, Tipo (el nombre del tipo; sitúe el puntero sobre él para ver el id guardado).
- Detalles: opciones y valor predeterminado.
- Definido en: «esta clase» o la clase antecesora.
- Descripción.
- Acciones, para los atributos definidos en esta clase: ✎ (Editar atributo), ⊘ / 👁 (Ocultar atributo / Mostrar atributo) y × (Quitar atributo).
- Tarjeta Relaciones: + Relación y una tabla con ambas direcciones: Relación, Otras clases, Volver a esta clase (el nombre inverso, y + en <class> para otra clase a la que le falta la inversa) y Descripción. En Otras clases, × quita una relación definida en esta clase. Las heredadas muestran «(heredada de X)».
- Tarjeta Etiquetas: las etiquetas disponibles en la clase.
*marca las etiquetas disponibles en todas las clases.
Diálogo Editar clase
Con el título Crear nueva clase o Editar clase — X. Campos: Nombre, Descripción, Padre ((ninguno — nivel superior) o una clase), Oculta, Abstracta y Color. Haga clic en Crear clase o Guardar clase.
Una clase integrada que tiene entidades no puede cambiar de padre: «Hay entidades que usan esta clase integrada, así que su padre es fijo.»
Diálogo de atributo
Con el título Nuevo atributo o Editar atributo — X. Para un atributo de relación, el título añade «(relación «…»)». Haga clic en Añadir atributo o Guardar.
- Nombre y Tipo (agrupados: Texto, Números, Fecha y hora, Opciones, Vínculos, Especial). No hay campo de orden: un atributo nuevo va al final.
- Valores permitidos (uno por línea): solo para Uno de una lista y Varios de una lista. Las líneas vacías y los valores repetidos se descartan. Una lista necesita al menos dos valores: «Una enumeración necesita al menos dos opciones. Añada otra opción.» («Una selección múltiple…» para Varios de una lista). Un atributo que ya tiene un único valor se sigue guardando mientras su lista no cambie. Para Uno de una lista, tras la lista hay un cuadrado de color por valor.
- Valor predeterminado: no para FILE, COMPUTABLE, QUALITY, HTML ni USER_TEAM.
- Descripción.
Página Relaciones
Haga clic en Relaciones en la barra lateral para ver todos los pares de relaciones. La página tiene + Relación y una tabla con estas columnas:
- Relación e Inversa.
- Origen → Destino: cada par de clases permitido.
- Atributos: ✎ por atributo, y + Atributo.
- En uso: el número de relaciones.
- Descripción.
- ✎ (Editar relación) y × (Eliminar relación).
El diálogo de relación tiene el título Nueva relación o Editar relación — X. Tiene Nombre, Nombre inverso, Descripción, Descripción inversa, Oculta y Color (o Color predeterminado). Los diagramas de araña dibujan la relación en este color; un diagrama puede elegir su propio color por relación. La columna Relación muestra el color como una muestra. Al editar, también enumera los atributos de la relación, con + Añadir atributo. Haga clic en Crear relación o Guardar.
Página Etiquetas
Haga clic en Etiquetas en la barra lateral para ver todas las etiquetas. La página tiene Añadir etiquetas DoDAF y Añadir etiquetas UAF (las etiquetas del marco que le faltan a este proyecto; también se añaden con el primer producto DoDAF o la primera vista UAF), + Nueva etiqueta y una tabla en orden de árbol con estas columnas:
- Etiqueta.
- Se aplica a: chips de clase o «Todas las clases».
- Entidades: el recuento.
- Descripción.
- Acciones: ✎ (Editar etiqueta), ⊖ (Quitar esta etiqueta de todas las entidades, mostrado cuando está en uso) y × (Eliminar etiqueta). Un solo Deshacer vuelve a poner una etiqueta en todas las entidades de las que se quitó; con más de 5,000 entidades se muestra la tarjeta de progreso.
El diálogo de etiqueta tiene el título Crear nueva etiqueta o Editar etiqueta — X. Tiene Nombre, Descripción, Padre ((ninguno) o una etiqueta), Clases (ninguna seleccionada: todas las clases) y Oculta. Haga clic en Crear etiqueta o Guardar etiqueta.
Página del flujo de trabajo
Haga clic en Flujo de trabajo en la barra lateral. La página dice «Defina qué cambios de valor permite un atributo de enumeración (como Status).»
La página dice «Defina los estados de una clase y qué cambios entre ellos se permiten o requieren aprobación.»
Añadir una clase… enumera las clases que tienen un atributo de enumeración y aún no tienen flujo de trabajo. Vigila Estado cuando la clase lo tiene. Cada clase con flujo de trabajo tiene una tarjeta con:
- El chip de la clase, vigila y el atributo vigilado. Cambiarlo pregunta antes cuando el flujo de trabajo tiene transiciones.
- Quitar: quita el flujo de trabajo de la clase. Los valores de los elementos se conservan.
- Estados: una tabla de Estado (marcado integrado o (retirado)), Elementos (el recuento) y ↑, ↓, Cambiar nombre…, Quitar… o Retirar…, o Restaurar. Debajo, Nuevo estado y + Añadir estado. Una subclase con un atributo heredado dice «Estados propios de X; Y es heredado.»
- Transiciones: + Añadir transición añade «Nueva transición» de (Inicial — sin valor) al primer estado. Una tabla: Nombre, De, A, Aprobación y un menú ⋯ con Bloquear el elemento después de esta transición y Eliminar transición (también con clic derecho en la fila, o ⇧F10 / Shift+F10 sobre ella). Nombre, De y A se muestran como texto; haga clic en uno (o pulse Enter o F2 sobre él) para cambiarlo. Sin transiciones, la tarjeta dice «Sin transiciones: cualquier estado puede seguir a cualquier otro.»
En el servicio alojado, solo los propietarios del proyecto cambian los flujos de trabajo; los demás ven la página en modo de solo lectura con «Solo los propietarios del proyecto cambian los flujos de trabajo.»
Cómo afectan los cambios del esquema a los datos existentes
Consulte esta tabla antes de cambiar un elemento del esquema que ya tiene datos.
| Cambio | Efecto en las entidades y las relaciones |
|---|---|
| Cambiar el nombre de una clase, un atributo, una relación o una etiqueta | Los datos se conservan, porque todo se guarda por id. Las consultas guardadas, el texto de búsqueda y los títulos de columna que usan el nombre antiguo dejan de coincidir. Actualícelos. |
| Cambiar el padre de una clase | En los editores, la clase gana los atributos y destinos del nuevo padre y pierde los del antiguo. Los valores guardados se conservan. No se permite para una clase integrada que tiene entidades. |
| Marcar una clase como abstracta u oculta | Las entidades existentes se conservan. La clase deja de ofrecerse para entidades nuevas o en Cambiar clase. |
| Eliminar una clase | Solo se permite cuando la clase no tiene subclases ni entidades. Se quitan sus propios atributos y destinos. Las etiquetas la quitan de su lista de clases. |
| Añadir un atributo | Las entidades existentes no tienen valor. Las entidades nuevas reciben el Valor predeterminado. |
| Cambiar el tipo de un atributo | Todos los valores de ese atributo se borran, tras una confirmación. |
| Quitar una opción | Las entidades conservan el valor antiguo. El editor deja de ofrecerlo. |
| Ocultar un atributo | Los valores se conservan, pero no se muestran, no se buscan ni se exportan hasta que se vuelve a mostrar. |
| Quitar un atributo | Su valor se borra en todas las entidades y relaciones, tras una confirmación. |
| Añadir un destino | La relación pasa a estar disponible entre esas clases (y sus subclases). |
| Quitar un destino | Las relaciones existentes se conservan, aunque el esquema ya no las permita. La regla Global.9 de Comprobaciones del modelo las enumera. |
| Eliminar una relación | Se quitan el par de relaciones, sus destinos y todos los vínculos que la usan. |
| Eliminar una etiqueta | Se quita de todas las entidades. Sus etiquetas hijas suben a su padre. |
| Importar esquema (Combinar) | Añade las clases, relaciones, destinos, atributos y etiquetas que faltan por nombre. No se cambia ni se quita nada existente. |
| Añadir nuevos elementos integrados | Añade las clases, relaciones, atributos y etiquetas del esquema predeterminado que faltan por nombre, con sus ids predeterminados. Se añaden destinos para las clases y relaciones añadidas, además de los destinos de LML 2.0 entre clases existentes; se agregan al final los valores de Decision Status de LML 2.0. No se cambia ni se quita nada existente. |
| Importar esquema (Reemplazar) o Restablecer al predeterminado | Se reemplaza el esquema. Los datos de las entidades se conservan, pero no se muestran los valores de los atributos que ya no existen. Las extensiones integradas se vuelven a añadir la próxima vez que se abre el proyecto. |
Cada cambio se puede deshacer con un solo Deshacer, y ⌘Z / Ctrl+Z restaura el esquema junto con los datos que quitó.
Extensiones integradas
Holarch añade estos elementos a todos los proyectos al abrirlos, porque sus funciones los necesitan.
- Se emparejan por nombre, sin distinguir mayúsculas y minúsculas.
- Solo se añaden cuando faltan, y nunca se les cambia el nombre ni se quitan.
- Sus ediciones en ellos se conservan.
| Clase | Atributos añadidos |
|---|---|
| Requisito | Prioridad y Criticality (High, Medium, Low), Owner, Origen, TBD/TBR (None, TBD, TBR), TBD Owner, TBD Due Date, Verification Method (selección múltiple: Analysis, Demonstration, Inspection, Test), Nivel de verificación (Component, Subsystem, System), Criterios de éxito |
| Risk | Owner, Handling Strategy (Accept, Avoid, Transfer, Mitigate, Watch), Residual Probability, Residual Consequence, Need-by Date, Trigger, Justificación del cierre; Estado gana las opciones Mitigating y Watch |
| Test Case | Probado por, Fecha de prueba, Configuración, Artículo de prueba, Test Evidence (archivo) |
| Enunciado | Board Column (enumeración), añadido cuando se crea o convierte un tablero Kanban con sus propios nombres de columna. Sus valores son los nombres de las columnas. |
| Input/Output | Data Rate, Data Rate Units, Protocol/Format, Message/Data Definition |
| Conduit | Connector/Pins, Medium, Owner, Interface Status (Draft, Proposed, Agreed, Baselined), TBD/TBR (None, TBD, TBR) |
| Port | Conjugated |
| Medida | Weight, Improvement Direction (N/A, Positive, Negative), Scoring Method (Direct 1-10, Direct 1-5, Linear, Thresholds), Score Thresholds, Estimación actual |
| Decisión | Estado (Open, In Analysis, Decided, Deferred, Superseded), Decision Date, Decided By |
| Característica | Units |
| Asset | Quantity |
Etiquetas añadidas: Stakeholder Need y Requisito de interfaz (Requirement), Interface Block (Asset, bajo Block), Trade Study y Pizarra (Artifact), Criterios y TPM (Measure).
Destinos de relación añadidos: Decision alternative Asset, Action, Artifact, Resource, Statement y Requirement, con la inversa alternative of.
Las páginas de marcos (DoDAF y UAF) crean las etiquetas que usan sus productos la primera vez que se añade uno de esos productos.
Atajos de teclado
| Tecla | Dónde | Action |
|---|---|---|
| Enter | Campo Valores permitidos del diálogo de atributo | Empezar la siguiente opción (una por línea) |
| ⌘ / Ctrl/Ctrl+clic | Lista Clases del diálogo de etiqueta | Seleccionar varias clases |
| ⌘ / Ctrl+Z / ⌘ / Ctrl+Shift+Z | En cualquier lugar | Deshacer / rehacer un cambio del esquema |
Opciones y ajustes
- El esquema del proyecto se guarda en el proyecto y se comparte con cada miembro que puede abrirlo.
- Los miembros con el rol de lector no pueden cambiarlo («Solo lectura: pida a un propietario acceso de edición.»).
- Los archivos de Exportar esquema usan el formato
holarch-schemay contienen las clases, relaciones, atributos, etiquetas y el flujo de trabajo.
Mensajes
| Mensaje | Significado y solución |
|---|---|
| «Introduzca un nombre de clase.» | El nombre de la clase está vacío. |
| «Ese nombre de clase es demasiado largo; acórtelo.» | Los nombres de clase y de etiqueta están limitados a 100 caracteres. |
| «Los nombres de clase no pueden contener : " ( ) < ni >. Las búsquedas dan un significado a estos caracteres.» | Quite esos caracteres. Se permiten otras letras, dígitos, espacios y signos de puntuación. Los nombres de clase existentes siguen siendo válidos. |
| «Otra clase ya usa este nombre. Elija otro.» | Los nombres de clase son únicos (sin distinguir mayúsculas y minúsculas). |
| ««X» es una palabra clave de búsqueda (como en x:…). Elija otro nombre de clase.» | Las claves de búsqueda (class, label, name, number, description, is, relationship, in, under, diagram, id, order) y AND, OR, NOT no pueden nombrar una clase, porque una búsqueda leería la clase como esa clave. |
| «Ese padre convertiría a esta clase en su propio antecesor.» | Elija un padre fuera del subárbol de la clase. |
| «Esta clase tiene subclases. Elimínelas o muévalas primero a otro padre.» | Una clase con subclases no se puede eliminar. |
| ««X» (o una subclase) tiene N entidades. Cambie antes su clase o elimínelas, u oculte la clase.» | Una clase con entidades no se puede eliminar. |
| «Introduzca un nombre de atributo.» | El nombre del atributo está vacío. |
| «El nombre del atributo contiene caracteres no permitidos.» | Use letras, dígitos, espacios y _ - $ ( ) . , /. |
| «Nombre, Número y Descripción son integrados; elija otro nombre de atributo.» | Son campos de la entidad, no atributos. |
| «Ya existe aquí un atributo con este nombre.» | La clase, un padre o una subclase ya lo tiene. |
| «Añada al menos una opción.» | ENUMERATION y MULTISELECT necesitan opciones. |
| «Introduzca un nombre de etiqueta.» / «El nombre de la etiqueta contiene caracteres no permitidos.» / «Otra etiqueta ya usa este nombre.» / «Una etiqueta no puede estar dentro de sí misma. Elija otro padre.» | Comprobaciones del diálogo de etiqueta. Las etiquetas también pueden usar & y '. |
| «Introduzca un nombre de relación y un nombre inverso.» / «El nombre de la relación y el nombre inverso deben ser distintos.» / «Ya existe una relación llamada «X».» | Comprobaciones del diálogo de relación. |
| «No es un archivo JSON.» / «Este archivo no es un esquema: necesita clases, relaciones, atributos y etiquetas.» | Importar esquema… necesita un archivo JSON de esquema o de proyecto. |
| «Esquema combinado: N elemento(s) añadido(s)» / «Esquema reemplazado» | Importación terminada. |
| «No hay clases con flujo de trabajo. Elija una clase con Añadir una clase… para definir sus transiciones de estado.» | Aún no hay ningún flujo de trabajo definido. |
Antes de un cambio destructivo, una confirmación indica la consecuencia:
| Confirmación | Texto |
|---|---|
| Quitar atributo | «N entidades tienen un valor que se borrará.» |
| Cambiar tipo y borrar valores | «N entidades tienen un valor de «X». Cambiar el tipo de A a B borra esos valores.» |
| Eliminar clase | «¿Eliminar la clase «X» con sus atributos y destinos?» |
| Quitar destino (× en Otras clases) | «N relación(es) existente(s) se conservan, aunque el esquema ya no las permita.» |
| Eliminar relación | «También se quitan N relación(es) que la usan.» |
| Eliminar etiqueta | «Se quita de N entidades.» |
| Quitar etiqueta de los elementos | «¿Quitar «X» de N entidades?» |
| Restablecer esquema | «Las clases, atributos, relaciones y etiquetas personalizados se quitan del esquema (los datos de las entidades se conservan; se puede deshacer).» |
Límites
- Nombres de clase y de etiqueta: 100 caracteres.
- Nombres de los atributos creados por importaciones: 80 caracteres.
- Un atributo vigilado por clase.
- Las transiciones simples las aplican los editores de atributos, las celdas de cuadrícula y el tablero Kanban. Las transiciones con aprobación también rechazan los cambios directos y masivos. Los elementos nuevos se pueden crear en cualquier estado.
- Bloquear se aplica a los elementos LML. Los elementos SysML v2 no se bloquean.
- Nombres de estado: 100 caracteres.
- Combinar no añade opciones nuevas a un atributo que ya existe; añádalas en el diálogo de atributo.
- Añadir nuevos elementos integrados… solo aparece después de volver a abrir la página, una vez que el esquema se ha vuelto personalizado.
Relacionado
- Modelo y base de datos: entidades, editores de atributos, consultas y ediciones masivas.
- Requisitos: los atributos de los requisitos, las comprobaciones de calidad y las aprobaciones.
- Trazabilidad: cómo alimentan las relaciones la matriz y las comprobaciones de cobertura.
- Importación y exportación: asignación de atributos y esquema en los archivos de intercambio.
- Ayuda: Esquema, Conceptos básicos de LML.