Complemento EA Diagram Editor para Prolaborate

Te contamos cómo puedes editar diagramas en Enterprise Architect desde Prolaborate.

Considera este escenario:

  1. Un usuario del negocio realiza un comentario en un diagrama en Prolaborate que estás modelando con Enterprise Architect (EA)
  2. Ves el comentario en Prolaborate
  3. Abres Enterprise Architect 
  4. Navegas hasta ese diagrama específico si conoces la ruta, o lo buscas
  5. Lo abres
  6. Editas el diagrama y lo guardas
  7. Regresas a Prolaborate para responder 

¿Qué pasa si podemos hacer que este viaje sea extremadamente simple como el que se muestra a continuación?

pre requisitos

  1. Sistema operativo de 64-bit
  2. Enterprise Architect (cualquier versión)

instalación y configuración

Sigue estos pasos: 

  1. Descarga el instalador aquí.
  2. Ejecuta el archivo setup.exe como Administrador.
  3. Sigue las instrucciones del instalador para completar la instalación.
La carpeta de instalación de EA tendrá un aspecto parecido a C:\Archivos de programa (x86)\Sparx Systems\EA\
  1. Inicia sesión en Prolaborate y abre un repositorio.
  2. Abre Menu > Repository Settings y habilita el Editor de Diagramas

editar diagrama

Cuando estás colaborando con tus compañeros en los diagramas de arquitectura o vistas y hay comentarios que fluyen para agregar un requisito, conectar requisitos, editar un proceso, introducir una nueva actividad, etc., todo lo que tienes que hacer es simplemente hacer clic en el ícono que se muestra en la captura de pantalla.
Editar diagrama

Aparecerá la siguiente página. Haz clic en Open Diagram Editor.

Se abrirá Enterprise Architect y se cargará el diagrama. (Si la seguridad está habilitada, solicitará las credenciales)

Diagrama EA

Puedes realizar los cambios, guardarlos y volver a Prolaborate para responder al comentario.

¡Tan simple como eso!

Vista previa de Prolaborate 3.4

Te presentamos las novedades de la versión 3.4 de Prolaborate, lanzada a mediados de febrero con nuevas funciones y mejoras, que incluyen propiedades personalizadas, edición de diagramas (EA), administración de registros y discusiones.

Prolaborate 3.4 se lanzó a mediados de febrero con nuevas funciones y mejoras.

Usando el diseñador de formularios Prolaborate Modeling Language, los campos de Enterprise Architect como el nombre, alias, notas, etc., se pueden seleccionar para definir los detalles disponibles para los usuarios web (por ejemplo, en las clases de UML). Esta nueva función admite propiedades basadas en consultas personalizadas para mostrar detalles sobre un elemento seleccionado que no están disponibles a través de otras pestañas. Los subelementos, como las interfaces de lista y los puertos de un componente, son un ejemplo de lo que se puede representar con esta nueva función. 

Prolaborate y Enterprise Architect son parte de la solución de modelado completa de Sparx Systems. Con este último necesario para actualizar los diagramas, se puede habilitar un enlace opcional en los diagramas de Prolaborate para que se abra en Enterprise Architect con fines de edición. 

Este nuevo widget es conveniente para crear discusiones dentro de un tablero para un grupo de usuarios dedicado. 

propiedades basadas en consultas personalizadas
(diseñador de formularios de lenguaje de modelado)

Disponible en el menú Prolaborate Lenguajes de modelado, el Diseñador de formularios es una función útil para definir una vista adecuada para los tipos de elementos relevantes.

Es posible que desees mostrar solo el nombre y las notas de una clase UML con etiquetas personalizadas “Entidad” y “Descripción”, según la configuración a continuación:

uml-attributes

La vista resultante para la clase se ilustra a continuación (nota: la entidad es de solo lectura tal como está configurada)

Diagrama de clase UML

Introducidos en Prolaborate 3.4, los atributos personalizados de EA se pueden crear y usar en el Diseñador de formularios para recuperar y mostrar información específica para un elemento determinado.

ejemplo de bloque SysML: mostrar subelementos (puertos)

Empecemos por un bloque SysML con el objetivo de mostrar la lista de puertos, gestionados en EA como subelementos. Se crea un atributo personalizado de EA con su consulta que se ha definido y probado en Enterprise Architect (usando la búsqueda de modelo > Bloc de notas de SQL)

La consulta es específica del modelo y la sintaxis SQL se define según el DBMS elegido (Postgres, MySQL, SQL Server, etc) Como se documenta en el sitio de Prolaborate, se espera que la consulta devuelva campos específicos para que Prolaborate procese:
  • Los resultados representados en una sola columna que muestra el valor del “nombre”. En mi humilde opinión, sería útil admitir columnas adicionales, especialmente cuando los atributos se muestran en pantalla completa con fines de visibilidad.
  • El GUID y el tipo de base, respectivamente, permiten navegar hasta un elemento de la lista y mostrar el icono.
Agregar atributo

El Diseñador de formularios se abre para personalizar los bloques SysML:

Configurar estereotipo

El atributo personalizado Puertos se ha agregado a la lista de campos disponibles para bloques SysML.

Atributo Puertos

Resultado: Los detalles del bloque SysML Coffee Machine a continuación incluyen la lista de puertos (nombre + tipo de puerto si está configurado). Nota: este proceso podría repetirse para mostrar las partes del bloque.

Diagrama máquina de café

ejemplo de proceso empresarial de ArchiMate
(muestra N + 2 o más elementos vinculados)

Considera el siguiente ejemplo de ArchiMate con un proceso de negocio servido por un servicio, a su vez servido por un componente de aplicación.

Diagrama ArchiMate

La vista Prolaborate Trazabilidad muestra los elementos relacionados con N + 1, por ejemplo, el servicio comercial de venta de productos.

Trazabilidad

El objetivo del atributo personalizado es mostrar las aplicaciones de los servicios que sirven a un proceso empresarial determinado. El resultado se ilustra a continuación (consulte Clientes CRM).

ejemplo de modelo de datos y clase UML (usa información de conectores de mapeo avanzado)

En el siguiente ejemplo se ha utilizado la característica “Enlace a elemento” de Enterprise Architect para mapear atributos entre un modelo de datos lógico y uno físico. 

Al hacer clic en la clase de clientes, la lista de asignación de atributos muestra para cada atributo de clase la columna de la tabla de base de datos correspondiente, por ejemplo, comentarios = comentarios de clientes (línea 1).

Mapeo de atributos

Más detalles están disponibles en el sitio de Prolaborate.

editor de diagramas: abrir diagramas en Enterprise Architect desde Prolaborate

Prolaborate es una herramienta conveniente para colaborar con las partes interesadas y los miembros de un equipo de proyecto. Todos, incluidos los usuarios de Enterprise Architect, tienen acceso en tiempo real a los modelos compartidos. 

Los comentarios recopilados sobre un diagrama pueden afectar su contenido. En esta etapa, alguien debe editar este diagrama en Enterprise Architect. En lugar de tener que abrir el modelo y buscar el diagrama relevante, Prolaborate proporciona un nuevo enlace desde el diagrama: 

Abrir en EA

Una vez que se hace clic, una página muestra 2 opciones. 

  • Primero, se debe descargar e instalar la aplicación Diagram Editor. 
Esta aplicación requiere permisos de administrador. Podría resultar útil una versión del archivo de instalación que funcione con derechos que no sean de administrador.
  • Una vez instalado, al hacer clic en Open Enterprise Architect se le pide al usuario que abra la aplicación Diagram Editor (ver más abajo). 
  • Esta aplicación lanza Enterprise Architect con una conexión en la nube al repositorio activo a través del servidor Pro Cloud y abre el diagrama.
Para utilizar esta función, se debe instalar la aplicación de escritorio Enterprise Architect y el repositorio Pro Cloud Server + debe estar disponible.
Abrir editor

Personalmente, creo que también conduce a una invitación simple y eficiente para que los usuarios de Prolaborate pasen a la herramienta de modelado Enterprise Architect cuando sea necesario. 

Sería útil tener un campo personalizable en esta página para agregar un mensaje específico, por ejemplo, para indicar dónde solicitar la instalación de Enterprise Architect si se administra al soporte de TI de la empresa.

personalizar rutas de registro de Prolaborate

Los archivos de registro de Prolaborate se generan en diferentes carpetas del servidor. Hasta entonces, la ruta de algunas de estas carpetas no se podía modificar. Esto puede ser un problema para varias organizaciones con estrictas reglas de seguridad de TI, por ejemplo, para almacenar archivos de registro en una ubicación dedicada. 

Este fue realmente el caso de uno de mis clientes. Gracias al equipo de Prolaborate por implementar esta solicitud de función 🙂 

A través de la herramienta Prolaborate Service Management disponible en el servidor, el valor de Ubicación que se ilustra a continuación se puede modificar en consecuencia. 

La ruta de registro de Sparx Systems Pro Cloud Server se puede configurar a través de la configuración de LOGGING_DIRECTORY en el archivo de configuración.

widget de colaboración del panel

Las discusiones pueden crearse dentro del modelo y asociarse con un elemento o diagrama. 

Si bien las discusiones sobre diagramas y elementos son relevantes para partes específicas del modelo, ahora se pueden crear discusiones dentro de un tablero. Esto puede ser útil para que cualquier miembro de un equipo de proyecto colabore, o debata sobre informes, gráficos publicados en el mismo tablero.

mejoras en la integración de JIRA

Prolaborate puede establecer el vínculo entre los modelos de EA y el software de gestión de proyectos y emisión de tickets como JIRA o Ms Azure DevOps. 

La integración con JIRA implica asociar un tipo de solicitud de proyecto JIRA con un tipo de elemento, por ejemplo, una clase, caso de uso, requisito, componente … Los tickets JIRA se pueden asociar en Prolaborate, lo que da como resultado nuevos valores etiquetados creados contra el elemento en EA (valor = URL de JIRA). 

Las funciones y la interfaz de usuario se han mejorado con la versión 3.4. 

  • Asocia un ticket JIRA con una clase UML:
Agregar nuevo
  • Selecciona y asocia un ticket JIRA existente con la clase:
Agregar enlaces
  • Crea nuevos tickets de JIRA desde Prolaborate y asócialos con la clase:
Crear items
Si posees una licencia Prolaborate activa, puedes iniciar sesión en la sección de usuarios registrados de Sparx Systems para descargar la última versión.

Configurando prolaborate

En esta nota te mostramos algunas de las configuraciones más útiles para comenzar a trabajar con Prolaborate rápidamente.

Prolaborate, es una plataforma de colaboración web para Enterprise Architect que hace que el intercambio de modelos sea simple, eficiente y colaborativo, usando la tecnología de Sparx Systems Pro Cloud Server OSLC y RESTful API.

Prolaborate permite a los usuarios finales trabajar en los diagramas de EA y acceder a la información de los modelos en vivo a través de un portal de colaboración ágil. 

En este video te mostramos rápidamente la interfaz de la aplicación y cómo acceder a algunas de sus principales funcionalidades:

 

Cómo se vio en el video anterior, Prolaborate nos permite diseñar tableros de información personalizados, para que una vez que un usuario inicia sesión, aterriza directamente en los tableros dinámicos y en vivo diseñados específicamente para ellos.

Toda la información del modelo que necesitan consumir se les presenta en una sola página, que pueden consumir y revisar, y en base a esto tomar sus decisiones o participar en discusiones y colaborar con el equipo.

Observe en el siguiente video, cómo configurar los tableros de control de acuerdo a los roles involucrados en su proyecto:

Además Prolaborate nos ayuda a obtener el feedback de la audiencia correcta, a la vez que favorece la comunicación y la gestión rápida del proyecto al involucrar a las distintas audiencias en las discusiones y revisiones necesarias del modelo.

Con las discusiones, podemos realmente involucrar a nuestros stakeholder para agilizar el desarrollo de nuestros modelos, ya que al iniciar una discusión sobre un diagrama o un elemento, podemos hacer referencia y vincular a paquetes, diagramas y elementos. También podemos etiquetar a usuarios del modelo a los que queremos llamar la atención acerca de la discusión.

Las revisiones, nos permiten formalizar las discusiones y organizarlas en flujos de trabajo donde podemos indicar quienes estarán cumpliendo el rol de revisor, o el rol de aprobador, y también nos permiten establecer en qué fechas se espera que se pueda discutir sobre algún diagrama o elemento, y en qué fechas vamos a esperar la aprobación.

En el siguiente video, te mostramos cómo configurar las discusiones y revisiones en Prolaborate para sacar el máximo provecho de las opiniones de los Stakeholders:

 

Crea con Enterprise Architect, colabora activamente con WebEA (Pro Cloud Server), comunica abiertamente con Prolaborate e integra con otras herramientas

Modos de implementar Prolaborate

En esta nota, te contamos un poco acerca de algunos de los diferentes modelos de despliegue para implementar Prolaborate, y los beneficios de cada modelo.

Dos modelos posibles para implementar Prolaborate son el despliegue On Premises y el despliegue On Cloud SaaS. Te contamos a continuación algunos detalles y los beneficios de cada modelo.

Despliegues On Premises: Con este modelo, es posible configurar Prolaborate en sus instalaciones y tener el control completo de todos los datos involucrados. Todas las configuraciones son administradas dentro de su organización. En esta opción, se proporcionan todos los archivos y licencias de instalación (incluido Pro Cloud Server) y se puede configurar Prolaborate, y las fuentes de datos en sus propias instalaciones.

Te mostramos en una imagen la descripción de este despliegue:

 

Prolaborate On Premises

Despliegues On Cloud SaaS: Los servicios Cloud SaaS son más rápidos, estables, seguros y fáciles de usar. Nos encargamos de alojar todo lo necesario para usar Enterprise Architect en sus máquinas y acceder a Prolaborate usando sus navegadores, es decir, Sparx Systems Prolaborate, repositorios de Enterprise Architect (EA), Pro Cloud Server y Floating License Server usando Amazon Web Services o Azure, líderes mundiales en servicios de computación en la nube. Por lo tanto, no es necesario preocuparse por la seguridad, el tiempo de actividad y la confiabilidad.

En la siguiente imagen te mostramos un despliegue sobre la nube Amazon Web Services:

ea-y-prolaborate-oncloud

A continuación te mostramos una tabla comparativa de los esfuerzos involucrados según cada modelo de implementación.

¿Que hace su organización?

 

 

On Premises

On Cloud SaaS

Item

Que hace su organización

Que hace su organización

Prolaborate

Configuración, mantenimiento y actualizaciones

Disfruta del servicio!

Prolaborate Data Source

Configuración, copias de seguridad y mantenimiento

Disfruta del servicio!

Pro Cloud Server

Instalación, configuración, mantenimiento y actualizaciones

Disfruta del servicio!

Floating License Server

Instalación, configuración y mantenimiento

Disfruta del servicio!

SSL Certificates – Secured Access to Repositories, License Server, and Prolaborate

Configuración y mantenimiento

Disfruta del servicio!

Enterprise Architect Repositories

Instalación, configuración, copias de seguridad y mantenimiento

Disfruta del servicio!

 

¿Que hace proagile?

 

 

On Premises

On Cloud SaaS

Item

Que hace proagile?

Que hace proagile?

Prolaborate

Compartimos las credenciales para las descargas y las instrucciones requeridas.

Configuración, mantenimiento y actualizaciones

Prolaborate Data Source

Compartimos instrucciones

Configuración, copias de seguridad y mantenimiento

Pro Cloud Server

Compartimos las credenciales para las descargas y las instrucciones requeridas.

Instalación, configuración, mantenimiento y actualizaciones

Floating License Server

Instalación, configuración y mantenimiento

SSL Certificates – Secured Access to Repositories, License Server, and Prolaborate

Configuración y mantenimiento

Enterprise Architect Repositories

Instalación, configuración, copias de seguridad y mantenimiento

Una vez elegido el modelo más apropiado para su organización, observa en este video cómo beneficiarte con estos 4 sencillos pasos para simplificar y compartir tus modelos con Prolaborate

Involucra a tus Stakeholders y Gerencias con Prolaborate!

Te contamos un poco acerca de algunas de las necesidades que dieron origen a Prolaborate, la herramienta por excelencia para colaborar y compartir los modelos de Enterprise Architect de forma online con el resto de los participantes del proyecto y las gerencias, que no son modeladores, y pueden tampoco ser de áreas de Tecnologías de la información.

Una encuesta indica que más del 40% de los Arquitectos Empresariales dicen que los líderes de negocio en la organización en donde se desempeñan no son conscientes de lo que hace el grupo de Arquitectos. (–McKinsey Survey Report)

Un estudio revela que las herramientas de Arquitectura Empresarial entregan un verdadero valor SOLO cuando el resto de la organización también puede usar la información que los arquitectos ingresan al modelo, para el análisis y el soporte de decisiones. (–Gartner’s report on Critical Capabilities for Enterprise Architecture Tools)

El open group nos dice que la gestión de Stakeholders es una disciplina importante que los profesionales de arquitectura exitosos pueden usar para obtener el apoyo de otras partes, ya que les ayuda a garantizar que sus proyectos tengan éxito donde otros fracasan. (–The Open Group)

Esta información nos transmite perfectamente por qué es fundamental ser transparente a nivel de organización cuando se trata de Arquitectura Empresarial. Una práctica de arquitectura transparente puede conducir a la organización:

  • a alinear a los líderes de otras áreas de la empresa y los líderes de áreas de Tecnologías de Información
  • a tomar decisiones más informadas y más rápido
  • a ser proactivo en la mitigación de riesgos
  • a ser ágil en momentos de disrupción
  • y finalmente conduce a lograr la visión de arquitectura empresarial

Seguramente habrán utilizado algunas o todas de las siguientes formas para compartir sus modelos de EA con la oficina de experiencia de usuario, jefes de negocios, gerentes, administradores, analistas, ingenieros y en general, cualquier otro rol involucrado en el proyecto o en el área, que no son usuarios de Enterprise Architect, por ejemplo:

  • Publicar en sistemas de gestión de conocimiento en línea como Confluence, SharePoint y otros similares
  • Crear documentos de Microsoft Word o presentaciones de PowerPoint a partir de los elementos y diagramas en el modelo
  • Generar documentación RTF / PDF / DOCX
  • Crear reportes HTML para ser accedidos en la red de la organización
  • Tomar capturas de pantalla de diagramas y enviarlos por correo electrónico o alguna aplicación de mensajería como skype o hangouts

Pero al realizar estas tareas nos damos cuenta que nos topamos con ciertos inconvenientes. Estos métodos implican una cantidad significativa de esfuerzo manual y deben repetirse cada vez que hay un cambio en el modelo, lo cual resulta un tanto incómodo, e inconveniente.

Después de todo, la información que estamos compartiendo ni siquiera es en vivo, son reportes que se desactualizan rápido. Por lo tanto, estos métodos para compartir realmente no crean mucho valor.

Esto es algo que sucede muy frecuentemente, más del 80% de los usuarios de Enterprise Architect se enfrentan a este problema y buscan activamente una plataforma de colaboración y uso compartido en línea que les permita compartir los modelos de EA con las partes interesadas sin mucho esfuerzo manual.

Observa la grabación de nuestro webinar: Colaboración a otro nivel con Prolaborate, donde te presentamos las 4 formas más exitosas para colaborar y compartir los modelos de EA en línea con tus stakeholders y lograr el éxito de tus proyectos de Enterprise Architect.