SysML v2
Intercambio de modelos SysML v2
Importe archivos .sysml, archivos zip y JSON de SysML v2 en un proyecto SysML v2 con una vista previa, y exporte el modelo o un paquete como texto .sysml o JSON de SysML v2.
En esta página
- Resumen
- Conceptos
- Cómo usarlo
- Cuándo y por qué
- Importar archivos a este proyecto
- Importar archivos a un proyecto nuevo
- Actualizar un paquete a partir de una nueva versión
- Cambiar el nombre de elementos y moverlos en el texto conservando sus ids
- Importaciones grandes en el servicio alojado
- Exportar el modelo o un paquete
- Importar y exportar requisitos ReqIF
- Traer de un repositorio y enviar a él
- Ejemplo práctico: la demostración Hybrid Car
- Consejos y buenas prácticas
- Errores habituales
- Cómo se relaciona con otras funciones
- La página Importar y exportar
- Repositorio
- Cómo se leen los archivos
- Mensajes
- Límites
- Páginas relacionadas
Resumen
Los proyectos SysML v2 intercambian modelos con otras herramientas de SysML v2 como archivos. La página Importar y exportar (Modelo → Importar y exportar) hace ambas cosas:
- Importar lee archivos
.sysml, un.zipde archivos.sysmlo un archivo JSON de SysML v2. Muestra una vista previa de lo que cambia y después lo aplica a este proyecto (un solo Deshacer lo revierte todo) o crea un nuevo proyecto SysML v2. - Exportar escribe todo el modelo o un paquete como texto SysML v2 (
.sysml) o como JSON de SysML v2 (.json). - Los archivos ReqIF (
.reqif,.reqifz) de herramientas de requisitos se importan como requisitos SysML v2, y los requisitos se exportan como ReqIF: consulte Importar y exportar requisitos ReqIF.
También puede crear un proyecto directamente a partir de archivos: en Gestionar proyectos, haga clic en Archivos de proyecto ▾ → Importar archivos SysML v2….
Consejo: para mantener el modelo al día con un repositorio de modelos SysML v2 que ofrezca la Systems Modeling API, use la sección Repositorio de la misma página: consulte Traer de un repositorio y enviar a él.
Conceptos
Formatos de archivo
| Formato | Qué contiene | Importación | Exportación |
|---|---|---|---|
Texto SysML v2 (.sysml) | La notación textual, un archivo por cada paquete de nivel superior. | Sí | Sí |
Archivo zip (.zip) | Varios archivos .sysml. Las carpetas se convierten en paquetes. | Sí | Sí, cuando se exportan varios archivos |
JSON de SysML v2 (.json) | Una lista plana de elementos, cada uno con @id y @type, como la que usa la Systems Modeling API. | Sí | Sí |
ReqIF (.reqif, .reqifz) | Requisitos con sus atributos, su jerarquía y sus relaciones, de DOORS, Polarion, Jama, codebeamer y otras herramientas de requisitos. | Sí, convertidos en requisitos | Sí, los requisitos |
Los archivos KerML (.kerml) aún no se importan.
Ids y correspondencia
Cada elemento de un proyecto SysML v2 tiene un id. Los dos formatos lo conservan de forma distinta:
- JSON conserva los ids. Un elemento importado de nuevo desde JSON corresponde al elemento con el mismo id.
- Se entienden las referencias a la biblioteca estándar. El JSON de la Systems Modeling API, de la SysML v2 Pilot Implementation o de otro repositorio nombra los elementos de la biblioteca estándar (unidades como
ISQ::mass,ScalarValues::Real,Parts::Part) por los ids estándar. La importación los lee como los mismos elementos de la biblioteca, de modo que las unidades y los tipos siguen resueltos. - El texto conserva los ids cuando se pide. Marque Incluir ids de elementos al exportar texto
.sysml. Cada definición, uso y paquete con nombre lleva entonces su id como primera línea de su cuerpo,@HolarchMetadata::ElementId { id = "…"; }. Cuando ese texto se vuelve a importar, cada elemento con un id corresponde al elemento con el mismo id, aunque se le haya cambiado el nombre, se haya movido a otro propietario o a otro paquete de nivel superior, o se haya reordenado. Se conservan sus posiciones en los diagramas, sus comentarios, sus trazas y sus vínculos. - El texto sin ids se hace corresponder por nombre. Holarch hace corresponder los paquetes de nivel superior por nombre, y los elementos de su interior por sus nombres y posiciones. Los ids se conservan donde los elementos coinciden. Un elemento al que se cambió el nombre sigue coincidiendo cuando conserva su lugar; un elemento al que se cambió el nombre y que se movió a la vez se convierte en un elemento nuevo.
La exportación lo indica bajo los controles de exportación: «Los ids de los elementos se conservan en JSON. En el texto .sysml, marque Incluir ids de elementos para conservarlos: así los elementos conservan sus posiciones en los diagramas, sus comentarios y sus trazas cuando se vuelve a importar el texto editado, incluso tras un cambio de nombre o un movimiento. Sin ids, los elementos se hacen corresponder por nombre.»
Ids de elementos en el texto
@HolarchMetadata::ElementId { id = "…"; } son metadatos SysML v2 corrientes: ElementId es una definición de metadatos del propio paquete de biblioteca de Holarch HolarchMetadata (en la Biblioteca estándar, en Holarch), junto a TBD y TBR. Otras herramientas de SysML v2 leen la línea como una anotación de metadatos; para resolver su nombre necesitan HolarchMetadata.sysml de esa biblioteca.
- El id pertenece al elemento en cuyo cuerpo está la línea. Los elementos sin nombre (conexiones, sucesiones, comentarios) no llevan id y se hacen corresponder por su contenido, como antes.
- Holarch no conserva la línea como elemento. El Editor muestra el modelo sin estas líneas, y un elemento cuyo cuerpo solo contenía la línea se muestra como
part engine : Engine;. - Los ids deben ser únicos. Cuando el mismo id aparece dos veces (por ejemplo, tras copiar un bloque en el texto), el primer elemento lo conserva y la copia se convierte en un elemento nuevo.
- Un id que no es un UUID (por ejemplo
"R-17") se convierte en un UUID fijo, de modo que la misma cadena da siempre el mismo elemento, como en una importación de JSON. - Un id que el proyecto no tiene se conserva para el nuevo elemento. Eliminar un elemento en Holarch y volver a importar el texto lo recupera con su id anterior.
- En el Editor, una línea pegada funciona dentro del paquete que está editando: allí se ignora un id que pertenece a un elemento de otro paquete, y el elemento se hace corresponder por nombre. Para mover elementos entre paquetes conservando sus ids, exporte con ids e importe los archivos editados.
La definición de parte Car de la demostración Hybrid Car lleva una línea así en su archivo de origen, por lo que su id es el mismo en cada copia de la demostración.
Las carpetas se convierten en paquetes
En un archivo zip, cada carpeta se convierte en un paquete que contiene sus archivos y subcarpetas. Un archivo powertrain/engine.sysml dentro del archivo se lee como si estuviera escrito dentro de package powertrain { … }. Los archivos del nivel superior del archivo zip se leen tal cual. Las carpetas y los archivos se leen por orden alfabético.
Qué compara la vista previa
La vista previa tiene una fila por cada paquete de nivel superior (o, para un proyecto nuevo, por cada elemento de nivel superior). Cada fila tiene un resultado:
| Resultado | Significado | Se importa de forma predeterminada |
|---|---|---|
| Nuevo | El proyecto no tiene ningún paquete con ese nombre (o id). Se añade. | Sí |
| Cambiado | El proyecto tiene el paquete; la importación añade, cambia o quita elementos en él. El detalle indica cuántos, por ejemplo «3 añadidos, 1 cambiado (ids conservados donde los elementos coinciden)». | Sí |
| Sin cambios | El paquete es igual que en este proyecto. | No (no hay nada que hacer) |
| Conflicto | El paquete no se puede fusionar. El detalle indica por qué y qué hacer. | No |
Cómo usarlo
Cuándo y por qué
Use Importar y exportar cuando un modelo pase entre Holarch y otra herramienta de SysML v2, o entre proyectos de Holarch:
- Iniciar un proyecto de Holarch a partir de un modelo escrito en otro lugar.
- Incorporar un paquete que mantiene otro equipo, como una biblioteca de componentes, y actualizarlo cuando envíen una nueva versión.
- Entregar un paquete a un proveedor o a una herramienta que lea texto o JSON de SysML v2.
- Mantener archivos
.sysmlen su propio control de versiones junto al proyecto de Holarch.
Importar archivos a este proyecto
- Abra Modelo → Importar y exportar.
- En Importar, elija En este proyecto.
- Suelte los archivos en la zona de colocación, o haga clic en ella y elíjalos.
Verá «Leyendo los archivos…» y después la vista previa: el número de paquetes de nivel superior y de archivos, los problemas que haya y una tabla con Importar, Paquete, Elementos y Resultado.
- Lea la lista de problemas, si la hay. Nombra cada archivo y línea que no se analiza sin errores y cada archivo que se omitió.
- Desmarque cualquier paquete que no desee importar. Para sustituir un paquete que entra en conflicto por nombre, márquelo.
En un plan con límite de elementos, la vista previa cuenta los elementos que tendría el proyecto después de la importación (las relaciones no cuentan). Si se supera el límite, lo indica, por ejemplo «Esta importación llevaría el proyecto a 1,804 elementos; el plan Free permite 1,000.», y Importar N packages sigue desactivado hasta que desmarque suficientes paquetes. No se aplica ni se envía nada al servidor. Las importaciones a un proyecto nuevo se comprueban de la misma forma frente al límite por proyecto de su plan.
- Haga clic en Importar N packages.
El aviso dice «Se importaron N paquetes.». La página dice «Se importaron N paquetes (M elementos). Deshacer revierte la importación en un solo paso.». Haga clic en Abrir texto para verlos.
Importar archivos a un proyecto nuevo
- Abra Modelo → Importación y exportación y elija En un proyecto SysML v2 nuevo.
- Suelte o elija los archivos.
La vista previa enumera los elementos de nivel superior, todos marcados.
- Desmarque los que no desee y edite el Nombre del proyecto. De forma predeterminada es el nombre del único archivo o del primer paquete.
- Haga clic en Crear proyecto.
El nuevo proyecto se abre en el Editor.
Desde Gestionar proyectos, Archivos de proyecto ▾ → Importar archivos SysML v2… hace lo mismo en un solo paso. Si no se pueden leer partes de los archivos, pregunta primero: «Se encontraron N problemas: se omiten partes de los archivos. ¿Crear el proyecto con el resto? Para ver primero los problemas, abra un proyecto SysML v2 y use Importación y exportación.». Haga clic en Crear proyecto para continuar.
Actualizar un paquete a partir de una nueva versión
- Exporte o reciba la nueva versión como archivos
.sysmlo JSON. - Impórtela En este proyecto.
El paquete muestra Cambiado, con el número de elementos añadidos, cambiados y quitados.
- Haga clic en Importar 1 package.
Los elementos que coinciden conservan sus ids, de modo que los vínculos a ellos (vínculos de requisitos, riesgos, diseños de vistas, comentarios) se mantienen. Los elementos que ya no están en el archivo pasan a la Papelera.
Cambiar el nombre de elementos y moverlos en el texto conservando sus ids
- Exporte los paquetes como texto SysML v2 con Incluir ids de elementos marcado.
- Edite los archivos: cambie el nombre de elementos, muévalos a otros propietarios o a otro archivo de paquete, reordénelos. Mantenga cada línea
@HolarchMetadata::ElementIddentro del cuerpo de su elemento. - Importe los archivos editados En este proyecto.
Los paquetes muestran Cambiado. Los elementos con nombre cambiado y los movidos cuentan como cambiados, no como añadidos y quitados.
- Haga clic en Importar N packages.
Los elementos conservan sus ids: se mantienen sus posiciones en los diagramas, comentarios, trazas y vínculos. Los elementos movidos a otro paquete salen del paquete en el que estaban.
Importaciones grandes en el servicio alojado
En el servicio alojado, una importación de 5,000 elementos o más la aplica el servidor, no su navegador. Cuando cada paquete marcado es Nuevo o sustituye un Conflicto, el servidor lee él mismo los archivos (los pasos siguientes). Cuando un paquete marcado es Cambiado, su navegador calcula la fusión como de costumbre y sube los cambios una vez; el servidor los escribe entonces en un solo paso, con la misma tarjeta de progreso, Cancelar importación y Deshacer importación.
- Elija los archivos y compruebe la vista previa como en cualquier importación.
- Haga clic en Importar N packages (o Crear proyecto).
Los archivos se suben una vez. El servidor los lee con las mismas comprobaciones y los mismos ids de elemento que la vista previa, y escribe el resultado en un solo paso.
- Siga la tarjeta de progreso en la parte inferior de la ventana: muestra la fase (subida, lectura, comprobación, aplicación, actualización del índice del proyecto) y el tiempo restante.
Puede salir de la página o cerrar la pestaña. La importación continúa en el servidor, y cuando vuelva a abrir el proyecto su resultado estará ahí. Cada copia abierta del proyecto se recarga cuando se aplica la importación; las ediciones no enviadas se vuelven a enviar después de la recarga.
- Los demás miembros ven «Nombre está importando archivo…» en la misma tarjeta y en la página Importación y exportación.
- Una importación a la vez: una segunda importación grande al mismo proyecto espera hasta que termine la primera.
- Cancelar importación (quien la inició o un propietario) detiene la importación antes de que se aplique. No se cambia nada.
- Deshacer importación: ⌘Z / Ctrl+Z en el navegador no revierte una importación en el servidor. Haga clic en Deshacer importación en la página Importación y exportación para devolver el proyecto a su estado anterior a la última importación. El estado anterior al deshacer se conserva en Historial, de modo que las ediciones hechas después de la importación se pueden recuperar desde allí.
- Actividad del proyecto e Historial muestran la importación como una sola entrada de la persona que la inició.
Exportar el modelo o un paquete
- Abra Modelo → Importar y exportar.
- En Exportar, elija qué exportar: Todo el modelo o un paquete por su nombre calificado.
- Elija el formato: Texto SysML v2 (.sysml; un .zip para varios packages) o JSON de SysML v2 (.json).
- Para texto que vaya a editar e importar de nuevo, marque Incluir ids de elementos.
- Haga clic en Exportar.
Se descarga un archivo, o un zip cuando la exportación contiene varios archivos. El aviso dice «Se exportó <file>.» o «Se exportaron N archivos como zip.»
Para exportar rápidamente un paquete, use el Navegador: el menú de fila de un paquete tiene Exportar como .sysml y Exportar como JSON.
Importar y exportar requisitos ReqIF
ReqIF es el formato de intercambio de las herramientas de requisitos. Un archivo ReqIF se importa como un paquete de requisitos SysML v2, y los requisitos se exportan de vuelta como ReqIF, de modo que una herramienta de requisitos y un proyecto SysML v2 pueden intercambiar los mismos requisitos en ambas direcciones.
Importar un archivo ReqIF:
- Abra Modelo → Importación y exportación (o haga clic en Importar… en la página Requisitos, o elija Importar ReqIF… en ⌘K / Ctrl+K).
- Suelte el archivo
.reqifo.reqifzen el recuadro, o haga clic en el recuadro para elegirlo. Un archivo ReqIF por importación. - El panel ReqIF muestra el número de requisitos, capítulos y relaciones, cuántos se convirtieron, se aproximaron o se excluyeron, y si el texto SysML v2 se comprueba sin problemas.
- En Nombres cortos de, elija ID externo (el número que se ve en la herramienta de origen, como
SRS-12) o Identificador ReqIF (el id interno de la herramienta). Los requisitos sin ID externo toman el identificador. - En Tipos de relación, elija en qué se convierte cada tipo de relación: Derivar, Refinar, Dependencia o Excluir. La vista previa se vuelve a calcular, y la elección se conserva para la próxima importación del mismo archivo.
- Haga clic en Importar 1 package. Un solo Deshacer revierte toda la importación. El aviso dice «Se importaron N requisitos de <title>.»
Qué crea la importación:
| ReqIF | SysML v2 |
|---|---|
| Requisito (spec object) | requirement, con el ID externo o el identificador como nombre corto, el nombre y el texto como doc |
| Tipo de requisito | requirement def, con un atributo por cada atributo ReqIF |
| Tipo de datos de enumeración | enum def |
| Atributo de estado (Draft, Proposed, Approved, etc.) | El estado del requisito en Holarch |
| Título de capítulo | package con el número de capítulo como nombre corto |
| Requisito anidado | requirement anidado |
| Relación derived from | Conexión de derivación |
| Relación refines | Dependencia con la anotación Refinement |
| satisfies, verified by y otras relaciones | Dependencia (el informe indica por qué) |
| Especificación | package dentro del paquete del archivo |
Las tablas se convierten en líneas de texto con | entre celdas, las listas en líneas que empiezan con un guion, y el formato y los enlaces conservan solo su texto; estos requisitos quedan como Aproximado. Las imágenes y los objetos incrustados no se importan; el requisito que contenía uno se muestra con el motivo, para que pueda adjuntarle el archivo. Descargar informe guarda cada requisito y relación con su resultado como CSV; Descargar texto SysML v2 guarda el texto.
Importar una copia más reciente del archivo: impórtela en el mismo proyecto. Holarch encuentra el paquete de la importación anterior y compara requisito por requisito:
- Los requisitos conservan sus ids de elemento, de modo que los diagramas, los vínculos satisfy y verify, las revisiones y el Historial siguen asociados. Los requisitos con nombre cambiado y los movidos se actualizan en su sitio.
- Los requisitos que faltan en el nuevo archivo se conservan. Marque Quitar los N requisitos que faltan en este archivo para moverlos a la Papelera.
- Las partes, los casos de verificación y los vínculos que añadió en Holarch se conservan.
- Un requisito cambiado solo en Holarch conserva su cambio. Un requisito cambiado tanto aquí como en el archivo toma el texto del archivo; el texto anterior queda en el Historial. La vista previa los muestra en Cambiado aquí y en el archivo.
Exportar como ReqIF:
- En Exportar, elija un paquete o Todo el modelo, y ReqIF (.reqif) o Archivo comprimido ReqIF (.reqifz).
- Haga clic en Exportar. El aviso dice «Se exportaron N requisitos como <file>.»
Exportar… → Requisitos (ReqIF) en la Base de datos o en la página Requisitos exporta de la misma forma los requisitos de la lista (o los seleccionados).
El archivo contiene el nombre corto de cada requisito (como ReqIF.ForeignID), el nombre, la documentación (como XHTML), el estado y los valores de atributo, la jerarquía de paquetes como especificación, y las relaciones derive, refine y de dependencia. Los requisitos importados de ReqIF conservan sus identificadores, tipos y tipos de relación originales, de modo que la herramienta de origen actualiza sus requisitos en lugar de añadir copias; exportar e importar de nuevo el archivo muestra cada paquete como Sin cambios. Los valores de atributo calculados se escriben como texto. Los vínculos satisfy y verify se quedan en Holarch: ReqIF no tiene partes ni casos de verificación.
Traer de un repositorio y enviar a él
Conecte el proyecto a una rama de un repositorio de modelos SysML v2 para leer su último commit y enviar de vuelta sus cambios.
- Abra Modelo → Importación y exportación y busque la sección Repositorio.
- Introduzca la Dirección del repositorio (la dirección https de su Systems Modeling API) y, si el repositorio lo requiere, el Token de acceso.
- Haga clic en Cargar proyectos y elija el Proyecto y la Rama. Para iniciar un nuevo proyecto de repositorio a partir de este modelo, haga clic en Nuevo proyecto de repositorio.
- Haga clic en Pull…. Holarch lee el último commit de la rama y enumera cada diferencia: Nuevo, Cambiado, Quitado o Conflicto. Verá «Al día: no hay cambios en el repositorio.» cuando no haya nada que traer.
- Desmarque las diferencias que no desee y haga clic en Aplicar pull. Un solo Deshacer revierte todo el pull.
- Después de cambiar el modelo, haga clic en Push. Sus cambios desde el último commit sincronizado van a la rama como un nuevo commit. Verá, por ejemplo, «Se enviaron 3 cambiados como commit 1a2b3c4d.»
Un Conflicto es un elemento cambiado tanto aquí como en el repositorio desde la última sincronización. Un conflicto desmarcado conserva la versión de este proyecto.
Nota: un push se rechaza cuando la rama tiene commits que este proyecto no ha traído: «La rama del repositorio tiene commits que este proyecto no ha traído. Haga pull primero y luego push de nuevo.»
Ejemplo práctico: la demostración Hybrid Car
Cree primero la demostración: en Gestionar proyectos, haga clic en Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car (SysML v2).
- Abra Modelo → Importación y exportación. En Exportar, elija Todo el modelo y texto SysML v2, y haga clic en Exportar.
Se descarga un zip con un archivo por paquete de nivel superior, como
Vehicles.sysml,VehicleRequirements.sysml,VehicleBehavior.sysmlyVehicleViews.sysml. - Abra
VehicleRequirements.sysmlen un editor de texto. Cambieattribute maxCurbMass : MassValue = 1650 [kg];por1600 [kg]y guarde. - De vuelta en Importación y exportación, elija En este proyecto y suelte
VehicleRequirements.sysml.La vista previa muestra VehicleRequirements como Cambiado, con el número de elementos cambiados. Los demás paquetes no están en el archivo, por lo que no aparecen.
- Haga clic en Importar 1 package.
El valor cambia en el modelo. El requisito Sedan Mass (VR-1.1) nombra
maxCurbMass, por lo que sus vínculos se marcan para revisión (consulte Requisitos y verificación en proyectos SysML v2). Pulse ⌘Z / Ctrl+Z para deshacer la importación. - Para iniciar un segundo proyecto a partir de los mismos archivos, elija En un proyecto SysML v2 nuevo, suelte el zip y haga clic en Crear proyecto.
Consejos y buenas prácticas
- Use JSON para mover un modelo entre herramientas SysML v2 cuando los ids importan, por ejemplo cuando la otra herramienta mantiene los vínculos por id. Use texto cuando las personas lean o revisen los archivos; marque Incluir ids de elementos cuando el texto vuelva a Holarch después de editarlo.
- Omita los ids en el texto que entregue a personas que solo lo leen: las líneas añaden una por elemento.
- Mantenga un paquete de nivel superior por archivo. La exportación escribe los archivos así, y una importación posterior coincide entonces paquete por paquete.
- Importe un paquete de otro equipo en su propio paquete de nivel superior. Las actualizaciones solo afectan entonces a ese paquete.
- Compruebe la lista de problemas antes de importar. Los miembros que no se analizan sin errores se excluyen.
Errores habituales
- Un paquete muestra Conflicto: «Ya existe un paquete llamado X con otros ids.» El proyecto tiene un paquete con ese nombre que no se importó de este JSON. Marque la fila para sustituirlo (el paquete antiguo pasa a la Papelera) o importe en un proyecto nuevo.
- «La importación contiene dos paquetes de nivel superior llamados X; solo se importa el primero.» Dos archivos declaran el mismo paquete de nivel superior. Fusiónelos en un archivo o cambie el nombre de uno.
- Un elemento con nombre cambiado se importó como nuevo. El texto no tenía ids de elemento, y el elemento se renombró y se movió a la vez (o cambiaron a la vez su tipo y su nombre). Exporte con Incluir ids de elementos, haga el cambio e importe de nuevo.
- Faltan elementos después de la importación. Un miembro que no se analiza sin errores se excluye: «Este miembro no se analiza y se excluye.» Corrija la línea que indica la lista de problemas e importe de nuevo.
- Se rechaza una importación JSON. Importe un archivo JSON de SysML v2 cada vez, sin archivos
.sysml.
Cómo se relaciona con otras funciones
- Editor: los paquetes importados se abren allí; los archivos exportados son el texto que se ve allí.
- Deshacer y Papelera: un solo Deshacer revierte toda una importación en este proyecto; los elementos que quita o sustituye van a la Papelera.
- Control de cambios: los valores y la documentación que cambian mediante una importación marcan los vínculos de requisitos para revisión, como cualquier otra edición.
- Archivos de proyecto de Holarch: Exportar este proyecto… en Gestionar proyectos guarda el proyecto de Holarch completo, con riesgos, documentos y otros datos de Holarch.
.sysmly JSON solo contienen el modelo. - Conversión: para mover un modelo entre LML y SysML v2, cree una copia convertida (consulte Conversión entre LML y SysML v2).
La página Importar y exportar
Importación
| Control | Uso |
|---|---|
| En este proyecto | Fusionar los archivos en el proyecto abierto. No disponible para quienes solo pueden ver el proyecto; para ellos, las importaciones crean un proyecto nuevo. |
| En un proyecto SysML v2 nuevo | Crear un proyecto nuevo a partir de los archivos. |
| Zona para soltar | «Suelte los archivos aquí o haga clic para elegirlos». Acepta archivos .sysml, un .zip de archivos .sysml o un archivo JSON de SysML v2. |
| Tabla de vista previa | Importar (casilla), Package (nombre y tipo), Elementos (recuento), Resultado (Nuevo, Cambiado, Sin cambios o Conflicto, con un detalle). |
| Nombre del proyecto | (Solo proyecto nuevo) El nombre del nuevo proyecto, hasta 200 caracteres. |
| Importar N packages / Crear proyecto | Aplicar la importación. |
| Cancelar | Cerrar la vista previa sin importar. |
Los elementos que están fuera de cualquier paquete en el texto .sysml se muestran juntos en una fila, Fuera de packages.
Cuando el modelo cambia mientras hay una vista previa abierta (otra pestaña, un colaborador o Deshacer), la vista previa se vuelve a calcular.
Exportación
| Control | Uso |
|---|---|
| Exportar (alcance) | Todo el modelo o cualquier paquete por su nombre calificado. |
| como (formato) | Texto SysML v2 (.sysml; un .zip para varios packages) o JSON de SysML v2 (.json). |
| Incluir ids de elementos | (Solo texto; desactivado de forma predeterminada) Escribe el id de cada elemento con nombre en el texto como @HolarchMetadata::ElementId { id = "…"; }, de modo que una copia editada que se importe de nuevo conserve los ids a través de cambios de nombre y movimientos. |
| Exportación | Descargar el archivo. |
La exportación de texto escribe un archivo por paquete de nivel superior, con su nombre (Vehicles.sysml). Los elementos fuera de paquetes van a Outside packages.sysml. La exportación JSON escribe un archivo con el nombre del proyecto o del paquete.
Repositorio
La sección Repositorio vincula el proyecto a una rama de un repositorio que ofrece la Systems Modeling API.
- Dirección del repositorio: la dirección https de la API del repositorio. Holarch solo se conecta a direcciones https en hosts públicos; los administradores del sitio pueden limitar los hosts y puertos.
- Token de acceso: se guarda cifrado para su cuenta y este proyecto, y solo se envía a esa dirección. No se vuelve a mostrar; deje el campo vacío para conservar el token guardado.
- Cargar proyectos, Proyecto y Rama: elija dónde sincronizar. Nuevo proyecto de repositorio crea un proyecto en el repositorio para este modelo.
- Pull…, Aplicar pull: leer el último commit, revisar las diferencias y aplicarlas, y un solo Deshacer lo revierte todo. Holarch compara con el commit que sincronizó por última vez, de modo que puede distinguir sus cambios de los del repositorio.
- Push: enviar los cambios desde el último commit sincronizado como un solo commit. «Nada que enviar: el modelo coincide con el último commit sincronizado.» significa que no hay nada nuevo.
- Ajustes… cambia la conexión. Desconectar quita el token guardado y el estado de sincronización; el modelo se conserva.
- Las operaciones de repositorio requieren el rol de editor. Los lectores no pueden hacer pull ni push.
- Los push se rechazan en proyectos con marcas de datos regulados.
Cómo se leen los archivos
- Los archivos se comprueban antes de leer nada: sus tamaños, recuentos, anidamiento y longitudes de texto.
- En un zip, se ignoran los archivos ocultos y las carpetas
__MACOSX. Los enlaces, los archivos que no son.sysmly una segunda copia de la misma ruta se omiten, y la lista de problemas indica por qué. - El texto debe estar en UTF-8. Se admite una marca de orden de bytes.
- Cada elemento importado se comprueba antes de escribirlo. Un elemento rechazado arrastra consigo a sus miembros propios; la lista de problemas los cuenta.
- En JSON, los elementos de tipos que Holarch no interpreta se conservan tal como se importaron: consulte Elementos que Holarch no interpreta.
Elementos que Holarch no interpreta
El JSON de SysML v2 puede contener tipos de elementos que Holarch no modela, como comportamientos, pasos o interacciones de KerML. Holarch los conserva en lugar de excluirlos:
- Cada uno permanece en el modelo con su id, su nombre, su propietario y su JSON original, incluidas sus relaciones (tipificaciones, especializaciones y otras) y lo que poseen. Sus miembros lo mantienen como propietario.
- El Navegador muestra su tipo original con una etiqueta Sin interpretar; señale la etiqueta para ver la explicación. El inspector muestra su tipo, su id en el archivo y a qué apuntan sus relaciones.
- No se puede renombrar ni editar en Holarch. Cámbielo en la herramienta de la que procede e impórtelo de nuevo. Puede moverlo o eliminarlo.
- No tiene texto SysML. El Editor lo deja fuera del texto, junto con todo lo que posee, y una nota sobre el texto indica cuántos elementos no se muestran. Editar el texto nunca los quita. Una exportación
.sysmltambién los deja fuera. - Una exportación JSON lo vuelve a escribir sin cambios. Solo se ajusta lo que cambió en el modelo: un miembro que eliminó o añadió, un miembro al que cambió el nombre o un nuevo propietario.
- La vista previa de importación muestra cada tipo conservado una vez, como nota, por ejemplo 2 elementos Behavior se conservan tal como se importaron. Las notas no son problemas.
No se conservan: el espacio de nombres raíz sin nombre con el que algunas herramientas envuelven toda una exportación (sus miembros pasan a ser elementos de nivel superior) y los elementos no admitidos dentro de un valor, que se muestran como problemas. Un elemento cuyo JSON supera los 256 KB conserva solo su tipo y su id.
Mensajes
| Mensaje | Significado y solución |
|---|---|
| Elija archivos .sysml, un .zip de archivos .sysml o un archivo JSON de SysML v2. | No se eligió ningún archivo. |
| No se encontraron archivos .sysml. Elija archivos .sysml, un .zip de archivos .sysml o un archivo JSON de SysML v2. | El archivo comprimido o la selección no contiene archivos .sysml. |
| Importe un archivo JSON de SysML v2 cada vez, sin archivos .sysml. | Se eligieron varios archivos JSON, o JSON mezclado con texto. |
| <file> no es un archivo ReqIF (…). Expórtelo desde la herramienta de origen como ReqIF 1.0 o posterior e impórtelo de nuevo. | El archivo no es XML de ReqIF, o contiene un DOCTYPE, que Holarch no lee. |
| <file> no contiene requisitos (no hay elementos SPEC-OBJECT). Exporte las especificaciones con sus objetos e importe de nuevo el archivo. | El archivo ReqIF tiene tipos pero no requisitos. |
| <title> tiene N requisitos, más de los que admite una importación (unos M). Exporte las especificaciones como archivos ReqIF separados. | El texto SysML v2 superaría el límite de 8 MB. Importe las especificaciones en archivos separados, uno cada vez. |
| <file> no es texto UTF-8. Guárdelo como UTF-8 e impórtelo de nuevo. | Convierta la codificación del archivo. |
| <file> no es un archivo ZIP válido. Cree de nuevo el archivo comprimido. | El archivo comprimido está dañado. |
| <file> contiene archivos cifrados. Cree el archivo comprimido sin contraseña. | Los archivos comprimidos protegidos con contraseña no se leen. |
| <path> está comprimido a más de 200:1, lo que es típico de una bomba zip. Cree de nuevo el archivo comprimido. | El archivo comprimido se rechazó por seguridad. |
| El archivo comprimido usa un método de compresión no admitido. Créelo con la compresión ZIP estándar. | Use la compresión estándar (deflate). |
| Los archivos KerML todavía no se importan. | Los archivos .kerml se omiten. |
| De un archivo comprimido solo se importan los archivos .sysml. | Los demás archivos de un zip se omiten. |
| Los enlaces no se importan. | Los enlaces simbólicos de un zip se omiten. |
| El archivo comprimido contiene este archivo dos veces; se importa la primera copia. | Dos entradas tienen la misma ruta. |
| <file> no es JSON válido. Exporte de nuevo el modelo. | El archivo JSON está dañado. |
| <file> no es JSON de SysML v2 (una lista de elementos con @id y @type). Elija una exportación JSON de SysML v2. | El JSON tiene otro formato. |
| La línea N de <file> supera los 64 KB. Divida la línea e importe de nuevo el archivo. | Las líneas muy largas se rechazan. |
| Este miembro no se analiza y se excluye. | Corrija la línea que indica la lista de problemas. |
| Un elemento con este id está dentro de <element> en este proyecto. Muévalo primero al nivel superior o importe en un proyecto nuevo. | (Conflicto) El paquete de nivel superior del JSON ya existe a mayor profundidad en el modelo. |
| N ids de elementos suyos se usan en otra parte de este proyecto. Importe en un proyecto nuevo. | (Conflicto) El JSON reutiliza ids de otros elementos. |
| El texto del paquete no se analiza después de imprimirlo. Impórtelo en un proyecto nuevo. | (Conflicto) No se pudo fusionar el paquete. |
| N elementos <kind> se conservan tal como se importaron (sin interpretar): … | (Nota) Los elementos de un tipo que Holarch no interpreta se conservan sin cambios. Consulte Elementos que Holarch no interpreta. |
| Un elemento de tipo <kind> dentro de un valor no se admite y se excluye. | Un valor (una expresión) contiene un elemento que Holarch no puede leer. El resto del valor se conserva como texto. |
| Un elemento de tipo <kind> es demasiado grande para conservarlo completo; solo se conservan su tipo y su id. | Su JSON supera los 256 KB. |
| La importación no se aplicó: … No se cambió nada. | La importación falló; el proyecto no ha cambiado. |
| El modelo está vacío. Añada un paquete y exporte de nuevo. | No hay nada que exportar. |
| El paquete que se iba a exportar ya no existe. Elija otro. | El paquete se eliminó mientras la página estaba abierta. |
Límites
| Límite | Valor |
|---|---|
| Archivos por importación | 2,000 |
Texto .sysml por importación (descomprimido) | 8 MB |
| Archivo zip | 16 MB, 10,000 entradas |
| Anidamiento de carpetas en un zip | 32 carpetas |
| Elementos por importación (texto o JSON) | 100,000 |
| Archivo JSON | 24 MB, anidamiento de 64 niveles |
| JSON de un elemento que Holarch no interpreta | 256 KB, anidamiento de 12 niveles |
| Longitud de línea | 64 KB |
Archivo ReqIF (.reqif, o .reqif dentro de un .reqifz) | 64 MB; el texto SysML v2 que genera debe caber en el límite de texto de 8 MB (entre unos 8,000 y 20,000 requisitos) |
- Las respuestas del repositorio se limitan a 64 MB para un pull completo, y cada operación de repositorio se detiene a los 120 segundos.
- Cada cuenta puede ejecutar como máximo 300 operaciones de repositorio por hora.
- Los archivos KerML (
.kerml) todavía no se importan. - En la aplicación alojada, el servidor lee las importaciones de hasta 1.5 MB de texto
.sysml. Las importaciones más grandes se leen en su navegador, con el mismo resultado. - Los datos de Holarch junto al modelo (estado de los requisitos, riesgos, presupuestos, ajustes del simulador, diseños de vistas) no forman parte de los archivos
.sysmlni JSON. Use Exportar este proyecto… en Gestionar proyectos para conservarlos.
Páginas relacionadas
- El editor de texto y el explorador
- Conversión entre LML y SysML v2
- Primeros pasos con proyectos SysML v2
- Importación de modelos SysML v1: XMI de herramientas SysML 1.x, convertido a SysML v2.
- Importación y exportación para proyectos LML (incluido ReqIF en LML) y archivos de proyecto de Holarch.
SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.