Enterprise Architect

User Guide Series

Portals

Author: Sparx Systems

Date: 22/06/2018

Version: 1.0

CREATED WITH
Table of Contents

Portals 3
Perspective Portal 6
Workspace Portal 7
Window Portal 9
Status Portal 12
Extend Portal 14
Execute Portal 15
Revisit Portal 18
Guidebook Portal 19
Learning Portal 20
User Guide - Portals 22 June, 2018

Portals
The Portals provide a high level, logical grouping of Enterprise Architect's tools and facilities, to form an entry point into
specific features that you might need to apply. They provide access to common tools, custom searches, window layouts
and Perspectives. For example, if you want to run searches for particular information in the model, or access the
windows that are appropriate to a particular set of actions, you can select a Portal to identify and provide access to those
facilities. This makes it easier to set up a work environment within the system, and carry out your tasks in a smooth
sequence.

Access

Ribbon Show > Portals > <select Portal>

Keyboard Shortcuts Shift+Alt+P

Other Start Page : The Portal icons, to the right of the divider line

Navigator Toolbar : :

The Portals window

The Portals window displays on either the left- or right-hand side of the Enterprise Architect work area. It contains the
currently-selected Portal and, under the title bar, a Portal selection button for changing the selected Portal.
Once the Portals window is displayed, it remains visible until you specifically select to hide it, or to auto-hide it as a tab
on the side of the display, using the Portals window context menu options (see the Portals Window Context Menu table
later in this topic).

Portals

The system currently provides nine Portals, each consisting of a collapsible hierarchy of option groups and options. If a
Portal is too long to display the entire contents at once, a scroll button displays at the top and/or bottom of the Portal.
Click on these buttons to scroll the Portal contents up or down (or use the scroll wheel on your mouse, or the keyboard
arrow keys).

Portal Description

Perspective Provides a range of model Patterns from which you can generate model structures
for particular areas of work. The Patterns are organized into groups within
Perspectives, and presented for selection through the 'Model Patterns' tab of the
Model Wizard, and through the 'New Diagram' dialog. The Portal also includes a
category for Perspectives that you have created yourself, which provide the Patterns
from MDG Technologies you have specified in the Perspective.

Workspace Provides links to the system-provided workspaces and working sets that you might

(c) Sparx Systems 2018 Page 3 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

use to lay out the Enterprise Architect work area, and to any working sets and
workspaces that you have created yourself. The categories provided are:
· Customised ('My Workspaces')
· Core
· Design
· Software
· Simulation
· Construction
· BABOK

Window Provides links to the Enterprise Architect windows that you might use. The
windows are grouped under the areas of:
· Exploring the model
· Properties
· Diagrams
· Specialized Tools
· Trace
· Collaborate
· Test
· Task
· Maintenance
· Templates

Status Provides links to run searches that locate recent activities of various types across
the model. The searches are grouped to identify:
· Recently changed elements, documents and discussions
· Recent formal reviews
· Recent informal Discussions
· Recently active Tasks
· Results of recently-run tests
· Recently reported and investigated Changes
· Recently reported and investigated Defects
· Recently reported and investigated Issues

Extend Lists the MDG Technologies currently active in your model - such as ArcGIS,
NEIM and Eclipse - and for each one provides links to the facilities for working
with those technologies within Enterprise Architect.

Execute Provides a wide range of options that help you to:

· Perform Execution Analysis on your model - building and running the
Analyzer scripts
· Record, Profile, Debug and Simulate the execution of your modeled
application
· Access various windows that display specific aspects of debugging and
simulating an application
· Create and edit code for your application

Revisit Provides links to the working sets, diagrams, files, documents and system windows

(c) Sparx Systems 2018 Page 4 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

that you recently had in use, and the diagrams that you have open currently.

Guidebook Provides links to the library of Enterprise Architect User Guides in PDF format.
The Portal initially displays with ten categories of document, each of which can be
expanded to a list of the PDF documents in that category.

Learning Provides links to either the web version of the Enterprise Architect User Guide, or
the locally-installed Help if you have downloaded that. The Portal also provides
links to a number of useful web pages on the Sparx Systems website, such as the
Resources, Tutorials, Webinars and Video Demos pages.

Portals Window Context Menu

Right-click on the Portals Window title bar to display the context menu. You can select the options in this table:

Portal Description

Dock Left Docks the Portals window on the left hand side of the work area.

Dock Right Docks the Portals window on the right hand side of the work area.

Auto Hide Condenses the Portals window to a tab on the edge of the work area. Mouse-over
the tab to re-open the Portals window, move the cursor off the window to return it
to a tab.

Hide Hides - and effectively closes - the Portals window. To re-open the window, select
the appropriate option under the 'Show > Portals' ribbon icon or the appropriate
icon on the Start page.

Auto Collapse Groups Automatically collapses the currently-selected group of options when you expand
another group.

<list of portals> If you right-click anywhere in the Portals window other than the window title, the
list of Portals displays. Click on a Portal name to change to that one in the window.

(c) Sparx Systems 2018 Page 5 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Perspective Portal
The Perspective Portal provides a number of work Perspectives grouped by general work area. Each Perspective filters
the modeling windows and dialogs to present only the modeling Patterns you might use in the work defined by the
Perspective. When you select a Perspective the Model Wizard displays, showing the 'Model Patterns' tab and providing
the model templates that you might use to initially create a model supporting the type of work.
For example, if you select the 'Construction > Kanban' Perspective the Model Wizard presents three Kanban Patterns for
one-stage, two-stage and three-stage workflows. As you open or refresh other windows, such as the 'New Diagram'
dialog, the objects you can initially select are filtered to provide - in this example - only Patterns for developing Kanban
diagrams.
The Perspectives you can select from the Portal, the Patterns they provide, and the facilities for managing Perspectives
are described in the What are the Perspectives? section under 'Modeling Tools | Building Models' in the Help.

Access

Ribbon Show > Portals | Perspective

Keyboard Shortcuts
Shift+Alt+P : | Perspective

Other

Start Page:

Navigator Toolbar : : : |
Perspective

(c) Sparx Systems 2018 Page 6 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Workspace Portal
The Workspace Portal provides links to apply defined workspaces to your Enterprise Architect user interface.

Access

Ribbon Show > Portals > Workspace

Keyboard Shortcuts Shift+Alt+P : Select Portal | Workspace

Other

Start Page:

Navigator Toolbar : : : |
Workspace

Facilities

Category Options

My Workspaces This section provides the Workspaces that you have customized for your particular
use.

Core The options in this category apply some of the basic workspaces to your work area.
These include:
· Basic Diagramming
· Collaborate
· Core Modeling
· Default
· Explore
· Wide View

Design The options in this category apply some of the model design workspaces to your
work area. These include:
· Database Modeling
· Gap Analysis
· Requirements
· Schema Design
· Trace by Matrix
· Use Case Modeling

(c) Sparx Systems 2018 Page 7 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Simulation The options in this category apply some of the simulation workspaces to your work
area. These include:
· BPSim
· DMN-Sim
· Simulation
· SysML-Sim

Construction The options in this category apply some of the project construction workspaces to
your work area. These include:
· Change
· Maintenance
· Resource Management
· Support
· Task Management
· Testing
· Work Items

BABOK The BABOK Reader option applies the BABOK workspace to your work area.

Software The options in this category apply some of the software development workspaces to
your work area. These include:
· Code Editing
· Debug
· Profile
· Record
· Software Engineering

(c) Sparx Systems 2018 Page 8 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Window Portal
Provides links to the Enterprise Architect windows you use to navigate through, develop and manage your models.

Access

Ribbon Show > Portals > Window

Keyboard Shortcuts
Shift+Alt+P : | Window

Other

Start Page :

Navigator Toolbar : : : | Window

Facilities

Type Facilities

Explore Provides links to display the:

· Project Browser - if the Project Browser is not currently open, this option
opens it on the left of the workspace
· Context Browser
· Element Browser
· Navigator
· Resources window
· Model Views
· Model Search
· File Search
· System Output window

Properties Provides access to these facilities:

· Properties Window
· Notes dialog
· Tagged Values window
· Summary screen
· Document window
· Features dialog

(c) Sparx Systems 2018 Page 9 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

· Requirements window
· Construct screen

Specialized Tools Provides access to these facilities:

· Specification Manager
· Scenario Builder
· Constraints, through the Responsibilities window
· Decision Table Editor
· Database Builder
· Schema Composer

Diagram Provides access to these facilities:

· Diagram Filters
· Pan and Zoom window
· Diagram Layout tools

Trace Provides access to these facilities:

· The Traceability window
· Relationships window
· Relationship Matrix
· Gap Analysis Matrix

Collaborate Provides access to the team communication facilities of:

· Finding All Reviews
· Finding All Discussions
· Conducting Reviews
· Conduction Discussions
· Model Mail
· Calendar
· Chat
· Team Library

Test Provides the facilities to create and review Tests of all types supported by
Enterprise Architect.

Task Provides access to these facilities:

· Project Gantt Chart
· Personal Gantt Chart
· Resource List

Maintenance Provides access to the facilities for recording and managing:

· Changes
· Defects
· Issues
· Tasks
· Events
· Decisions

(c) Sparx Systems 2018 Page 10 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

· Effort
· Risks
· Metrics

Templates Provides access to the facilities for maintaining:

· Code Engineering Templates
· DDL Templates
· Document Templates

(c) Sparx Systems 2018 Page 11 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Status Portal
The Status Portal provides links to and information the current status of objects in the model.

Access

Ribbon Show > Portals > Status

Keyboard Shortcuts
Shift+Alt+P : | Status

Other

Start Page:

Navigator Toolbar : : : > Status

Facilities

Recent Changes These options execute searches for recent changes to:
· Elements
· Discussions
· Linked Documents
· Diagrams

Reviews These options help you to:

· Take part in a review
· Manage the current reviews
· Run a report to find open reviews
· Run a report to find active reviews

Discussions These options help you to

· Take part in a discussion
· Manage the current discussions
· Run a report to find recently active discussions
· Take part in a Chat
· Review previously active chats

(c) Sparx Systems 2018 Page 12 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Tasks These options help you to search for tasks that have a specific status:
· Recently Finished
· Starting Today
· Overdue
· Ending Today
· Active
· 30 Day Summary

Tests These options help you to search for tests that have a specific status:
· Recent Results
· Recent Failures
· Recent Passes
· Recent Deferrals
· Recent Modified Elements
· Not Run
· Not Checked

Changes These options help you to search for changes that have a specific status:
· New
· Verified
· Recently Reported
· Recently Resolved
· Unresolved Issues

Defects These options help you to search for defects that have a specific status:
· New
· Verified
· Recently Reported
· Recently Resolved
· Unresolved Issues

Issues These options help you to search for issues that have a specific status:
· New
· Verified
· Recently Reported
· Recently Resolved
· Unresolved Issues

(c) Sparx Systems 2018 Page 13 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Extend Portal
Access

Ribbon Show > Portals > Extend

Keyboard Shortcuts
Shift+Alt+P : | Extend

Other

Start Page:

Navigator Toolbar : : : | Extend

Facilities

The options provided in this Portal depend on what Add-Ins and MDG Technologies are loaded and active for the model,
and what operations are supported between the technologies and Enterprise Architect.

Category Options

(c) Sparx Systems 2018 Page 14 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Execute Portal
The Execute Portal provides links to the facilities of the system that help you to:
· Perform Execution Analysis on your model; that is, build the application and then debug and record its execution
· Profile the execution of your modeled application
· Access various windows that display specific aspects of the execution analysis

Access

Ribbon Show > Portals > Execute

Keyboard Shortcuts
Shift+Alt+P : > Execute

Other

Start Page:

Navigator Toolbar : : : > Execute

Facilities

Category Options

Execution Analyzer These options provide the facilities to create and execute scripts for building,
running and testing an application. Select:
· Open Source File - to display the 'Open Source File' browser from which you
select a source file to view, and then display the file content in the Code Editor
· Edit Build Scripts - to display the Execution Analyzer window, from which
you can select a Build Script to edit
· Merge - to run the Merge script associated with the selected Package
· Build - to build the selected Package according to the active Build Script
· Deploy - to run the deployment script associated with the selected Package
· Run - to run the executable script associated with the selected Package
· Test - to run the testing script associated with the selected Package

Analyzer Select from these options to open the windows from which an Analysis session
starts. Select:
· Debugger - to open the Debug window
· Profiler - to open the Profiler window
· Recorder to open the Record & Analyze window

(c) Sparx Systems 2018 Page 15 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

· Testpoints to open the Testpoints window

Simulator The options in this section open a number of windows that you might use in a
Simulation session. Select:
· Simulator to open the Simulation window
· Triggers and Events to open the Simulation Events window
· Breakpoints - to open the Breakpoints & Markers window
· Local Variables - to open the Locals window
· Call Stack - to open the Call Stack window
· BPSim to open the Configure BPSim window
· SysMLSim to open the Configure SysML Simulation window

Simulator Control The options in this section help you to quickly control a simulation process. Select:
· Start Simulation - to start debugging
· Step - to step over the next line of code after a break
· Step In - to step into a function call in the code
· Step Out - to step out of a function call
· Pause - to pause simulation
· Stop - to stop the simulation altogether

Coding The options provided in this section help you to create, edit and debug code.
· Language Grammar Editor - displays the Grammar Editor for writing and
editing a grammar for code imported in a new programming language
· Scripting - displays the Scripting window at the 'Scripts' tab, for creating
scripts within script groups
· Source Code Editor - displays the Source Code Editor, which helps you to
view, edit and maintain your source code directly inside Enterprise Architect
· XSLT Editor/Debugger - displays both the XSLT Debugger screen and the
System Output window at the XSLT Transformation tab, for converting an
input document into XML or other  document types using an XSLT Stylesheet;
the transformation is modeled in an XML Transform diagram, from which you
can debug and/or execute the stylesheet

Debugger The options in this section open a number of windows that you might use in a
debugging session. Select:
· Breakpoints - to open the Breakpoints & Markers window
· Call Stack - to open the Call Stack window
· Local Variables - to open the Locals window
· Memory - to open the Memory Viewer window
· Modules - to open the Modules window
· Watches - to open the Watches window
· Object Workbench - to display the 'Object Workbench' dialog
· Debugging Perspective - to display the set of debug windows, dialogs, toolbars
and menus that you might use in a debugging session

Debug Control The options in this section help you to quickly debug a running process or
application (through a debug script). Select:
· Debug Run - to start debugging
· Step - to step over the next line of code after a break

(c) Sparx Systems 2018 Page 16 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

· Step In - to step into a function call in the code

· Step Out - to step out of a function call
· Pause - to pause debugging
· Stop - to stop the debugging session altogether

Record The options in this section help you to set up, start, record and analyze the
execution of the application code developed from your model. Select:
· 'Apply Record Layout' - to open the windows and dialogs that you would use
in performing Execution Analysis on your model
· 'Recording Window' - to open the Record & Analyze window to record the
analysis of an application
· 'Start Recording' - to start a manual recording of the current thread during a
debug session, managing it using the 'Step... ' functions
· 'Stop Recording' - to stop the current recording session
· 'Auto Record Thread' - to begin recording and not stop until either the program
ends, you stop the debugger or you click on the 'Stop' icon
· 'Toggle Display of Execution Point' - to toggle between highlighting the
execution point and not doing so
· 'Create Sequence Diagram' - to generate a Sequence diagram from the
recording trace

Profile The two options in this section are to quickly set up a Profiling session on your
application. Select:
· Apply Profile Layout - to display all windows and dialogs that you might use
in profiling the execution of your application
· Show Profiler Window - to display the Profiler window only

(c) Sparx Systems 2018 Page 17 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Revisit Portal
The Revisit Portal provides links to the diagrams and system windows that you currently have open, and the documents,
windows, diagrams and source files that you have recently opened and then closed again.

Access

Ribbon Show > Portals > Revisit

Keyboard Shortcuts
Shift+Alt+P : > Revisit

Other

Start Page:

Navigator Toolbar : : > Revisit

Facilities

Category Options

Working Sets This category lists the working sets that you have applied recently. If you click on a
set name, the windows and dialogs defined in that set are reapplied to your work
area.

Current Diagrams This category lists the diagrams that you currently have open. When you click on a
diagram name, the focus changes to the selected diagram.

Recent Diagrams This category list the diagrams that you have opened and closed during the current
work session. You can click on a diagram name to re-open that diagram and resume
work on it.

Documents This category lists the linked documents that you have opened recently. If you click
on a document name, the document re-opens.

Recent Windows This category lists the windows that you have opened and closed during the current
work session. If you click on a window name, the window re-opens.

Recent Files This category lists the source files that you have opened and closed during the
current work session. You can click on a file name to re-open that file and resume
work on it.

(c) Sparx Systems 2018 Page 18 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Guidebook Portal
The Guidebook Portal provides access to a library of PDF documents held on the Sparx Systems website. These
documents discuss specific areas of Enterprise Architect's functionality and use. The documents are grouped according to
the area of work they support, namely:
· Basics
· Repository
· Modeling
· Domains
· Guides (for Business Analysis, Business Modeling and Enterprise Architecture)
· Project Management
· Publishing
· Simulation
· Execution
· Automation
To open a document, double-click on the document name.

Access

Ribbon Show > Portals > Guidebook

Keyboard Shortcuts
Shift+Alt+P : > Guidebook

Other

Start Page:

Navigator Toolbar : : : >

Guidebook

(c) Sparx Systems 2018 Page 19 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

Learning Portal
The Learning Portal provides links to either the web version of the Enterprise Architect User Guide, or the
locally-installed Help if you have downloaded that. The Portal also provides links to a number of useful web pages on
the Sparx Systems website, such as the Resources, Tutorials, Webinars and Video Demos pages.

Access

Ribbon Show > Portals > Learning

Keyboard Shortcuts
Shift+Alt+P : > Learning

Other

Start Page:

Navigator Toolbar : : : > Learning

Facilities

Category Options

Help The options in this group access useful explanatory information on the product,
mostly from the Sparx Systems website, and display it through the internal Web
Browser. Select:
· 'Help' - to display the first page of the product Help and an index that provides
access to the full range of Help topics
· 'Learning Center' - display the Learning Center topics, which are brief
instructions for quickly performing tasks throughout Enterprise Architect (after
downloading the files from the Sparx Systems website or another site specified
by your Technology Developers)
· 'Example Model' - to immediately open and switch to the Example Model,
which provides working examples of the models, structures and files that you
might use in your work with the system
· 'Tutorials' - to open the 'Tutorials' page of the Sparx Systems website, which
provides tutorials on general UML modeling and doing work with Enterprise
Architect
· 'Overview Guide (PDF)' - to open the Enterprise Architect Reviewers Guide
PDF document, which provides a comprehensive overview of the capabilities
of the most recent version of Enterprise Architect; each section focuses on a
particular aspect of the system; the document is very helpful to trial users who
are currently evaluating Enterprise Architect
· 'Resources Portal' - to open the 'Help, Tutorials & White papers' page and the

(c) Sparx Systems 2018 Page 20 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

'Resources' page of the Sparx Systems website, providing access to a wide

range of Enterprise Architect and UML tutorials, demonstrations, examples,
base files, Add-Ins and general information
· 'MDG Technologies' - to open the 'MDG Products' page of the Sparx Systems
website, which provides a brief description of, and the download links for, each
supported MDG Add-In product for a selected edition of Enterprise Architect -
select your installed edition from the drop-down list
Enterprise Architect editions such as Unified and Ultimate will automatically
register certain Add-In products; however these Add-Ins are not included in the
default Enterprise Architect installation and must be downloaded separately
· '3rd Party Extensions' - to open the 'Third Party Extensions' page of the Sparx
Systems website, which provides listings of additional Enterprise Architect
Add-Ins developed by partners and other members of the Enterprise Architect
community
· 'Check for Updates' - to perform a quick search for more-recent releases of the
Enterprise Architect installer
· 'Newsletter' - to open the 'Newsletters' page of the  Sparx Systems website,
which provides links to view newsletters previously released by Sparx
Systems, and to subscribe to receive future newsletters as they are released
· 'Release History' - to open the 'Recent Features' page of the Sparx Systems
website, which provides a full history of changes in the most recent builds of
Enterprise Architect
You can also open the release history and investigate the features of earlier
releases of the system, going back to version 1.1.3, the very first commercial
release
· 'Sparx Systems Home Page' - to display the home page of the Sparx Systems
website, from which point you can explore the full range of facilities and
information available on the site

Video Select the 'Video Demos' option to access the 'Enterprise Architect Product
Demonstrations' page of the website. This page provides a wide range of videos of
Enterprise Architect tools in use, to demonstrate what they do.

Webinars Select the 'Webinars' option to open the 'Webinar Registration' page of the Sparx
Systems website, which:
· Describes upcoming webinars (real-time seminars hosted via the internet)
scheduled by Sparx Systems, and
· Provides links to the registration form, for you to register your participation in
a webinar

Help Tools Lists any additional tools and documents that have been loaded to provided further
support for a domain or feature.

Preferences To Be Completed.

(c) Sparx Systems 2018 Page 21 of 22 Created with Enterprise Architect

User Guide - Portals 22 June, 2018

(c) Sparx Systems 2018 Page 22 of 22 Created with Enterprise Architect