Displaying items by tag: mdg office integration

Tuesday, 29 August 2023 09:27

BPMN Components on Excel & Enterprise Architect

In the most recent release of MDG Office Integrations (v1.4.40), an exciting enhancement known as the "BPMN Visualizer" has been introduced, offering an excellent utility for BPMN users. This feature facilitates the seamless transfer of BPMN Components between Microsoft Excel documents and Sparx Enterprise Architect Models.

The key feature of 'BPMN Visualizer' in MDG Office Integration

  • Simplified Approach that eliminates the necessity for Profile Creation during import and export for mapping items. This drastically minimizes user time and the possibility of manual errors.
  • Through a single click of "Excel to EA" menu, users can quickly synchronize BPMN Components, seamlessly updating and aligning data between Excel and the Enterprise Architect model.
  • The visual representation of diagrams from the Enterprise Architect model, as well as the related preconfigured mapping table, can be displayed within Excel.
  • The capability to incorporate multiple diagrams is supported when a package is selected. This involves displaying all diagrams in the selected packages along with their corresponding predefined mapping tables on separate sheets.

BPMN Components on Microsoft Excel

MDG Integration for Microsoft Office provides seamless integration within Microsoft Excel (Version 2007 and above). A newly introduced feature named ‘BPMN Visualizer’ now resides in the ‘Feature’ dropdown of the Enterprise Architect ribbon in Excel. This feature facilitates the seamless transfer of ‘BPMN Components' between an Excel document and Enterprise Architect, allowing for bi-directional data exchange.

Excel_Enterprise_Architect_Ribbon.png

To import BPMN Components into Enterprise Architect from Excel

Excel FeatureDropdown

The Feature dropdown offers the following selection options:

‘Export to EA’: Export the elements to Enterprise Architect using Profiles

‘SysML Requirement Manager’: Import SysML requirements from Enterprise Architect and Export SysML requirements and their connectors to Enterprise Architect.

‘BPMN Visualizer’:  Import BPMN Components from Enterprise Architect and export BPMN Components to Enterprise Architect.
Open project icon in Excel

Allows one to select a *.eap or *.eapx or *.feap or *.qea or *.qeax or *.eadb through local project, server connection, or cloud connection.

Local Project: To connect the Local Enterprise Architect model.

Server Connection: To connect to an Enterprise Architect repository through a database

Cloud Connection: To connect to an Enterprise Architect repository through the Pro Cloud Server
Excel_Diagram_Selection_option Allows users to select a Package or BPMN Diagram to Load from the Enterprise Architect Model to Excel with the respective diagram image.

Select a package

  • This window will be displayed when the Package Icon is clicked.
  • It displays all the models and packages from the selected Enterprise Architect model, with BPMN Components being imported specifically.

Excel_BPMN_PackageSelection

Select a BPMN Diagram

  • This window will be displayed when the Diagram button is clicked.
  • It provides a hierarchical overview of all diagrams within the packages of the model. Users have the ability to choose a specific BPMN diagram from this view.

Excel_BPMN_Diagramselection.png

Note: The ‘Ok’ button will only enable when the selection type is BPMN Diagram

Utilizing Excel for BPMN Components

  • The selected diagram is imported to an Excel sheet along with its predefined mapping table.
  • The Excel sheets are named in the format of Diagram Name with Diagram ID.

Excel_BPMN_Intialpage.png

Excel column definition

Action ID The Unique ID of BPMN Elements. It’s used to map the connectors and parent.
Action Name Name of the BPMN Element
Action Type Type of the BPMN Element
Next Action ID Target BPMN Element to connect based on the Action ID.
Connector Name Name of the BPMN Connector
Connector Type Type of the BPMN Connector
Parent The parent of a selected BPMN Element based on the Action ID.

Creation of element from Excel to Enterprise Architect model

  • To create a new element, enter a name in the ‘Action Name’ column (mandatory).
  • By default, the ‘Action Type’ is ‘Activity’. Users can change the type using the drop-down list.
  • Mapping the parent element for the newly created element is also achievable using the ‘Parent’ column.

Excel_BPMN_Element_Creation

Note: Supported Element types are Activity, Gateway, StartEvent, IntermediateEvent, EndEvent, DataStore, DataObject, BusinessProcess, BPELProcess, GlobalTask, Pool, and Lane.

Establishing connectors for the newly created element in Excel

‘Next Action ID’ creates a connector between two BPMN elements. Choose the appropriate ‘Action ID’ in the checklist box of ‘Next Action ID’ to connect. By default, the connector type is ‘Sequence Flow’

Excel_BPMN_Connectorcreation

Note: Supported connector types are SequenceFlow, MessageFlow, Conversation Link, DataAssociation, and Association.

Excel to EA iconTo update the changes from the mapping table in Excel to the Enterprise Architect model utilize the ‘Excel to EA’ Icon available in the Excel Ribbon; The preview form is presented to the user to ensure that the intended changes are ready for export. Once you click the ‘Export’ button, synchronization is initiated between the Enterprise Architect Model and Excel, causing the changes to be updated in Excel as well.

Excel_BPMN_Preview

As depicted in the image below, you can observe that the recently generated ‘Process goods’ element has been incorporated into the Excel diagram. This element establishes a connection with the ‘Gateway5’ element, as indicated in the mapping table. Likewise, this synchronization is also reflected in the Enterprise Architect model.

Excel_BPMN_Element_and_Connector_Update

EA to Excel iconThe ‘EA to Excel’ icon enables users to revert the produced items back to their original state as Enterprise Architect Models, providing an opportunity to undo changes made in Excel. Additionally, it facilitates the synchronization of changes made from Enterprise Architect to Excel.

 

BPMN Components from Enterprise Architect to Microsoft Excel

Through the ‘BPMN to Excel’ menu, users can export data pertaining to BPMN Components, which have been accumulated within Enterprise Architect, into the Predefined mapping tables along with diagrams in separate sheets within Excel.

Enterprise_Architect_Ribbon

After selecting the package or BPMN Diagram, the Enterprise Architect will begin exporting data to an Excel sheet and proceed with Refer "Utilizing Excel for BPMN Components"

Check out the BPMN on Excel and Enterprise Architect video here

To know more or to request a demo, please reach out to This email address is being protected from spambots. You need JavaScript enabled to view it.

Published in White Papers
Wednesday, 17 May 2023 07:05

SysML Requirements in Enterprise Architect

"SysML Requirements on Excel" is a new MDG Office Integration feature that allows users to author SysML requirements using Excel. Users can seamlessly integrate SysML requirements between MS Excel and Enterprise Architect.

Key features

  • Import and export SysML requirements data from Excel into Enterprise Architect.
  • Ability to create SysML Compliant requirements with inter-dependencies

SysML Requirements in Enterprise Architect

Using the “SysML Requirements on Excel” menu, users can connect an Enterprise Architect Model with an Excel spreadsheet.

This will create an Excel Document with required templates to let users create SysML requirements. This will also copy any existing Enterprise Architect requirements and the derived relationships to the Excel spreadsheet, to let users update or modify these contents.

EA_Ribbion.png

Working with Excel to author Requirements

The Excel template for SysML requirements authoring will have two spreadsheets,

  1. Requirements – The requirements sheet is used to create and update SysML compliant requirements, including Id and text, the sheet also displays any derived requirements (interconnected requirement)

Excel_Requirement_page.png

The Requirement Sheet has two parts: "SysML Requirements" and "Derived SysML Requirements".

SysML Requirements – It contains Name, Notes, Status, Version and Id, Text (Mandatory tags for SysML)

Derived SysML Requirements – It also contains Name, Notes, Status, Version of Derived Requirement for each SysML requirement. This part is completely non-editable.

  1. Requirement Matrix – This worksheet will present all requirements in a matrix format to let users easily create derivation inter-dependencies between them.
  • This sheet will be automatically updated when new requirements are added in the ‘Requirements’ worksheet
  • New relationships created in this spreadsheet will also be automatically updated in the ‘Requirements’ worksheet

Excel_Requirement_Matrix_image.png

Insert Elements and Connectors

Insert the element in the Name Column of the Requirement Sheet (with Notes, Status, Version, ID, and text, but the Name column is mandatory). And create a connector between the newly created element and the existing element in the ‘Requirement Matrix’ sheet.

Excel_connector_creation_page.png

Newly created connector details are updated in the ‘Requirement’ sheet.

Excel_Connector_details_are_updated.png

Excel_to_EA_icon.png To sync or update the modifications to the Enterprise Architect Model, use the Excel to EA icon. The changes reflected in the Enterprise Architect Model will be shown in the preview form. To update into an Enterprise Architect Model, select Export.

Preview_Form_Image.png

New elements are created under the chosen package.

Element_created_in_project_browser.png

EA_to_Excel_icon.png The EA to Excel icon is used to restore the produced items to their original state as in the Enterprise Architect Model.

Prior to ‘EA to Excel’

Prior_EA_to_Excel_Image.png

Post ‘EA to Excel’

Post_EA_to_Excel_Image.png

SysML Requirements on Excel (from Excel)

MDG Integration for Microsoft Office offers integration within Microsoft Excel (Office 2007 and above), and a new feature called SysML Requirement Manager is added to the feature dropdown of the Enterprise Architect ribbon. Using this, users can easily push the contents of SysML requirements from an Excel document to an Enterprise Architect or vice versa.

To import SysML requirement data into Enterprise Architect from Excel

 Feature_Icon_in_Excel.png  

Dropdown list to choose the Export to Enterprise Architect Model or the SysML Requirement Manager for the document.

‘Export to EA’: Export the elements to Enterprise Architect using Profiles

‘SysML Requirement Manager’: Import SysML Requirements from Enterprise Architect

and Export SysML Requirements and their connections to Enterprise Architect.

 Open_project_icon_in_Excel.png  

Allows one to select a *.eap or *.eapx or *.feap or *.qea or *.qeax or *.eadb through Local project, server Connection, or cloud connection.

Local Project - To Connect Local Enterprise Architect model.

Server Connection - To Connect to an Enterprise Architect repository through a database

Cloud Connection - To Connect to an Enterprise Architect repository through Pro Cloud Server

Select a package

  • This screen will be displayed when the Package button is clicked.
  • It displays all the models and packages from the selected Enterprise Architect model, with SysML Requirement items being imported specifically.

Select_a_package_image_in_Excel.png

After selecting the package and clicking ‘OK, ‘Enterprise Architect will begin exporting information to an Excel sheet and proceed with Refer "Working with Excel to author Requirements"

Check out the SysML Requirements in the Enterprise Architect video here

To know more or to request a demo, please reach out to This email address is being protected from spambots. You need JavaScript enabled to view it.

 

 

 

 

 

Published in White Papers

MDG Office Integration for excel supports the following

Import from Excel 

  • Importing artifacts from MS Excel documents
  • Synchronizing subsequent changes (additions, modifications) from the MS Excel document into EA 

Export to Excel

  • Export Enterprise Architect contents into a (pre-formatted) Excel spreadsheet

Please follow the following steps to try synchronization

  1. Import an Excel document using the profile defined for the respective worksheet
  2. Check ‘Enable Synchronization’ in the Importer dialog

  1. You will be prompted with the following dialog
    1. You can request EA to write sync data into the original file that is imported
    2. Or write the synch data to a backup file (which will then become your master copy in which subsequent changes must be done)
  2. Once you choose the backup file path and synch settings, click Apply

  1. Click Preview and Import in the Importer dialog
  2. Upon successful completion of import, the synch data will be added to the output file

  1. Make changes to the synchronization file (where the Synch information has been written)
  2. The Synchronization file, which becomes your masterfile, must be reimported using the same steps as above to ensure the contents are synchronized.
  3. You will notice that the EA artifacts are ‘Updated’ instead of ‘Added’

Published in Tutorials