17 June 2014
Document Control
Document History
Date
Version
Authors
Comments/Description of Change
10-Jun-2014
0.1
Luke Audie
13-Jun-2014
0.2
Luke Audie
17-Jun-2014
0.3
Luke Audie
23-Jun-2014
0.4
Luke Audie
23-Jun-2014
1.0
Bruce Crawford
Reviewers
Organization
Role
Name
Review Date
Software AG
Project Manager
Raviprasad S Cadambi
06-Jun-2014
CSU IT Team
Bruce Crawford
19/06/2014
CSU Business
Business Analyst
Sophie Dewar
19/06/2014
CSU IT Team
Business Analyst
Marian Wolmarans
19/06/2014
CSU IT Team
System Administrator
Scott Barlow
19/06/2014
Organization
Role
Name
Date
CSU IT Team
Director, Enterprise
Architecture
Diane Ireland
25/06/2014
CSU Steering
Committee
Project Sponsor
Geoff Honey
(Executive Director, Division of
Student Administration)
N/A
Approvers
Page 2 of 57
17 June 2014
Table of Contents
1.0 Introduction
1.1
Purpose
1.2
Intended Audience
1.3
Background
1.4
Conventions Definition
1.5
ARIS Overview
1.6
ARIS Methodology
1.7
10
1.8
10
1.9
11
1.10
Artefact Libraries
12
1.11
12
1.12
13
16
2.1
Filter
16
2.2
Template
17
2.3
18
ARIS Governance
19
3.1
19
3.2
20
3.2.1
20
3.2.2
Model Design
21
3.2.3
Audit Trail
21
Model-to-Execute
22
23
5.1
23
5.1.1
23
5.1.2
24
5.2
Organisational Modelling
25
5.3
Process Modelling
26
5.3.1
27
Page 3 of 57
17 June 2014
5.3.2
28
5.3.3
30
5.4
Information Modelling
33
5.4.1
33
5.4.2
34
5.4.3
34
5.5
Application Modelling
36
5.5.1
36
5.5.2
37
5.5.3
Application Screens
39
5.5.4
Report Catalogue
42
5.6
43
5.7
43
5.7.1
43
5.7.2
44
5.8
Common Attributes
48
5.8.1
48
5.8.2
49
Modelling Standards
50
5.9
50
5.10
51
5.11
51
5.12
Model Naming
51
54
5.13
54
5.14
55
5.15
56
Glossary
57
Page 4 of 57
17 June 2014
Table of Figures
Figure 1: CSU Process Hierarchy
11
12
13
13
14
15
16
16
17
17
17
19
19
20
20
21
21
21
22
23
25
26
27
27
28
28
30
31
31
Page 5 of 57
17 June 2014
31
32
33
34
35
36
37
38
38
39
40
41
42
43
44
44
45
46
47
54
56
Page 6 of 57
17 June 2014
1.0 Introduction
1.1 Purpose
This manual is designed to provide guidance in the use of conventions for creating and describing CSUs
Enterprise Model including; process, application, technology, information, service, organisational and
requirement models using the ARIS toolset and assumes the audience has had prior training before reading this
manual. The reader will note that process design is emphasised in this manual, but the solution also provides
an approach and methodology for enterprise architecture management, work flow, and application processing.
Business Analysts
Process Owners
Process Developers
Enterprise Architects
1.3 Background
The ARIS Enterprise Repository will provide an abstract view of the complex structures of the organisational
processes and enterprise architectures. The diagrams within the repository are used to document, analyse,
and communicate the state of how the organisation operates and the associated consumed resources. This
requires a standard way of capturing the state of information in a manner that will enable different viewers of
the diagrams to interpret it in the same way with minimal variations.
For this reason, ARIS mapping conventions define the allowed elements and their meaning. Following
prescribed modelling conventions will allow for efficient, collaborative business process and enterprise
architect management across CSUs boundaries and disciplines.
Page 7 of 57
17 June 2014
As CSU organisational users become more familiar with how their organisational information and processes are
modelled using a standard modelling notation (conventions), they will become better at articulating their
knowledge. Not only will well described enterprise documentation greatly assist in identifying opportunities to
business improvement, they also develop a shared understanding of processes and their performance.
CSU organisation units applying conventions to enterprise documentation will be provided with consistent,
logical models and will be able to distinguish similar documents and process diagrams from one another at a
glance. In addition, applying conventions will also facilitate the storage and retrieval of documents, which will
enable users to browse files more effectively and efficiently. Documents created according to agreed
conventions should also make file naming easier for users because they will not have to reinvent the process
each time, as reusable process content may already exist.
The effective use of conventions ensures and promotes the flow of information across Divisional boundaries
within CSU. Additionally, common use of conventions can improve the following:
Enterprise Architecture
Process Improvement
Increased productivity
Process Simulation
Page 8 of 57
17 June 2014
1 ARIS Overview
1.6 ARIS Methodology
The ARchitecture of Integrated Information Systems (ARIS) is a framework not only as a business process
modelling tool but as a concept to support the:
Enterprise Map
L1 Model
L2 Object
Main Process
L2 Model
L3 Object
Student Administration
Business Process
L3 Model
L4 Object
Admissions Processing
Sub-Process
L4 Model
L5 Object
Task Diagram
L5 Model
L6 Object
Reducing time and cost to create documents manually by generating pre-developed documents
from ARIS content, generating new Business and/or Enterprise opportunity Blueprints, Role
based authorisation, etc.
The advantage of setting up views in ARIS is its great clarity in presenting complex facts, but it also allows a
systematic approach to analysis. Depending on the information of interest, different modelling methods are
used which serve to describe the views presented.
Page 9 of 57
17 June 2014
Currently, one central ARIS Database for CSU Standards is created to design, test and store all CSU Standards
Business Processes. For each release, a copy of this database will be released based on agreed Release Cycle
Management standards (see chapter on Release Cycle Management for further details).
The following database naming convention has been defined for the primary CSU enterprise database:
[Company] [Purpose] [Version No.] [WIP / REL / Prod]
Examples: CSU Enterprise Repository V1.0 WIP
CSU Standards and Conventions V1.0 REL
Item
Description
Company
Self-explanatory
Purpose
Release Status
The CSU Enterprise Repository database will be a multi-project Work in Progress (WIP) environment. Each CSU
project will have a separate folder to store their enterprise content. The folder naming should be brief yet
specific, generally understandable and should reflect the content stored within. This rule applies especially for
business process folder names which have to have the same name as the process model it contains. Therefore
only one business process model can be stored in a folder.
Page 10 of 57
17 June 2014
Purpose
A. Library
Stores all the artefact library objects, e.g. data, roles, systems. The ARIS
support team is responsible for managing these libraries in conjunction with
the respective library owner (HR roles and positions)
B. Enterprise Model
C. Projects
Contains all project framework models (during the project phase and then
these models may be migrated to the Enterprise Model.
D. Governance
Stores all governance processes (e.g. RCM and CRM) and ITIL support processes
for the EA Competency Centre
E. Testing
Holds all the process-driven business scenarios and test cases created for
projects
F. Training and
Documentation
Store all the help guides and training collateral for the ARIS solution as well as
to support the CM activities within projects
X. Technical Content
Artifact Libraries
Governance
framework models
Enterprise level
framework folders
and models
Training, CM and
general
documentation
folder
Folder to store
temporary testing
related models
Stores
configuration as
well as
Technical area for
performing onceoff tasks
Figure 3: CSU Enterprise Repository Folder Structure
Page 11 of 57
17 June 2014
One model per folder where possible (especially for process models)
Modellers should create content within the correct Architecture (e.g. processes should be placed under
01. Process)
Information Assets/Data
Requirements
It is important to note that if new library objects are identified in a specific architecture, for example roles in
Function Allocation Diagrams, occurrences will also need to be manually modelled in various other architecture
model types (e.g. organisation chart) and library models. ARIS does not automatically create occurrences or
maintain artefact libraries.
Page 12 of 57
17 June 2014
Assign Identifier ID
Identifiers are assigned to users/user groups so that the models/objects created can be identified by the user
group. This can be maintained in the Administration view on the respective database by right-clicking and
selecting properties.
Example:
Multiple Identifiers can also be created for various groups associated in the database. In current environment
at CSU we have used Standard Identifier denoted as STD.
Page 13 of 57
17 June 2014
In addition, the direct assignment of the identifier (activate checkbox) is set during user and user group
maintenance.
For example BPM project members will have read/write access to their modelling folders in the project
workspace and read access to the global object libraries. Only framework content owners will have
permissions to change content in the global object libraries.
Access Attributes
Certain folders are specified with read, write and delete privileges for every user/ user group. Those privileges
can be maintained as followed:
No access (----): Users can see the group structure of the database. Group contents are not displayed.
Read (r---): The group content is displayed. Users can open models but cannot change models and
objects, nor add or delete new items.
Read + write (rw--): The group content is displayed. Users can change models and objects, add new
items, delete object occurrences from models, but not object definitions.
Read + write + delete (rwd-): The user can modify models and objects and add and delete items.
Read + write + delete + version (rwdv-): The user can modify models and objects and add and delete
and version items.
The privileges can be inherited from a parent folder to its subfolders via the user access properties by passing
them on to related folders.
Page 14 of 57
17 June 2014
Description
Arisservice
Required for Model-to-Execute. Requires rwdv to all folders and needs the
Entire method and wM integration filters assigned.
Process developer
All webMethods Process developers need their ARIS user account assigned to
this group.
Process engineer
CSU Admin
All ARIS support team members are assigned to this group, which has rwdv
access to all folders. This group has both the Entire method and CSU Filter
assigned.
A group will be defined for each project. This group will only have the CSU
Filter assigned and rwdv access to models in their respective folders and the
sandpit area and read access to other allowed folders (e.g. Library and
Enterprise Model). Example permissions below:
CSU Publisher
This user group is specially used for anonymous access in ARIS Business
Publisher. It has read access to all general areas and allowed project models.
Page 15 of 57
17 June 2014
The CSU Filter should never be directly updated, but rather maintained through the CSU ARIS Standards and
Conventions V1.0 WIP database. For example, if an additional model attribute it required it should firstly be
maintained in the CSU ARIS Standards and Conventions V1.0 WIP database and then the filter updated using
the Create automatically (which analyses what was maintained in the standards DB) option.
In Administration
3. Right-click
CSU Filter
and Edit
4. Select Filter
1. Select Create
Automatically
2. Select CSU
Standards DB.
And select
Overwrite
filter
contents
Important: The Entire method must be used when updating the Standards and Conventions Database and
when synchronising processes with webMethods.
Page 16 of 57
17 June 2014
2.2 Template
In order to ensure a uniform appearance of the models the template CSU Modelling Template must be
applied to all models. This Design Template maintains the look and feel conventions defined for CSU e.g. font
sizes, object appearances, etc.
Another aspect the CSUs modelling styling is the model header which needs to be applied to every ARIS model.
A modeller can copy the header from any current model or from the master model which is located in the
following folder:
The model header shows a set of basic information which is relevant to identify, understand and analyse the
model itself.
The header shows the following attributes depending on the model type:
Model Name
Model Status
Company Logo
Page 17 of 57
17 June 2014
Connections
Page 18 of 57
17 June 2014
3 ARIS Governance
3.1 Content Release Cycle Management
The Design Governance Process utilises a five-phase approach for managing the release cycle of ARIS content
and processes. The release cycle helps coordinate the modelling and QA teams with the business and
technologies owners. For example, process owners can search through the ARIS database looking for all content
flagged as Ready for sign-off and either approve or reject the proposed designs.
Below are the five phases of classification for ARIS models and objects. The phases are sequential and
mandatory (excl. Archived).
Seq.
Description
Design
QA
Items that are currently undergoing ARIS Technical QA (For models only)
Sign-off
Approved
Items have been formally signed-off by the owner and may be included in the
next build / implementation cycle.
Released
Approved items that have been built, tested, deployed and released into the
organisation and are now classified as BAU.
Archived
The release information for all ARIS content will be recorded in the Model Status and Object Status
attributes refer to examples below:
Page 19 of 57
17 June 2014
The diagram below illustrates the proposed process, including phases and high-level activities:
Work prioritisation
Requirements management
Page 20 of 57
17 June 2014
To ensure all design changes have prior approval and align to pre-set requirements
Provide accountability
Performed by email
Status (e.g. QA)
Page 21 of 57
17 June 2014
4 Model-to-Execute
An important use-case for the ARIS solution is to be able to support CSU enterprise workflows developed by the
webMethods platform. The business-driven requirements including processes, KPIs and service information
defined in ARIS can be shared with webMethods and the changes identified in webMethods can be inversely
feed back into ARIS. This approach between the two platforms is commonly known as Model-to-Execute.
Below is the proposed Model-to-Execute lifecycle (additional information can be found in the ARIS Technical
RCM Process presentation):
Page 22 of 57
17 June 2014
The following sections describe the ARIS models, objects, connections and attributes that comprise within the
CSU Enterprise Framework. Including:
Organisation Modelling
Process Modelling
Information Modelling
Application Modelling
Requirement Modelling
General information (ARIS and end-user training, communications and change management
information, news and updates, etc.)
Governance processes: E.g. Change Request Management and Release Cycle Management
Support processes: E.g. ARIS Help Desk requests (e.g. user access)
Page 23 of 57
17 June 2014
Specific Attributes
Structural model
Page 24 of 57
17 June 2014
Specific Attributes
Organizational chart
Page 25 of 57
17 June 2014
The CSU Business Process Architecture in ARIS is a hierarchical structure of at least four model levels (level 14). It allows an optional model level (5) to capture detailed work instructions. It starts from a high level
process map (level 1) representing a conceptual business view down to the detailed process flows describing
specific tasks and their relation to roles, data, IT-systems, etc. Model levels 1 and 2 are represented in ValueAdded Chain diagrams using level 2 and 3 value-added chain objects (see figure CSU Process Hierarchy).
From model level 3 onwards BPMN Collaboration Diagrams are used to model process, sub-process, task and
instruction information.
IMPORTANT: All webMethods synchronisation relevant process information is modelled in relation to model
levels 3 - 5.
Enterprise Map
Main Process
Student Administration
Business Process
Admissions Processing
Sub-Process
Assess Admission
Eligibility and Credit
Task Diagram
Page 26 of 57
17 June 2014
The Level 2 VACD shows the different main processes for each of the functions within the enterprise map.
Similar to the structure of the level 1 model, the Business Process objects will be categorised into
Management, Core and Enablement.
Specific Attributes
Page 27 of 57
17 June 2014
Level 3 BPMN diagrams consist of a series referenced sub-processes. The underlying level 4 BPMN diagrams are
referenced using the Call Activity as illustrated in the graphic below and shows the flow between these
processes.
Page 28 of 57
17 June 2014
Specific Attributes
by an IT system only.
Read-only - Called
element
Participant / Pool
Lane
Pool
An Intermediate Event
(Message) is an
Intermediate Event that
is triggered when a
Page 29 of 57
17 June 2014
Specific Attributes
Text annotation
IMPORTANT: Connections resulting from decision gateways may have the following attributes maintained:
Page 30 of 57
17 June 2014
Page 31 of 57
17 June 2014
User Task
Specific Attributes
Function / task
Page 32 of 57
17 June 2014
Specific Attributes
This object is the generic
representation of an
application
Page 33 of 57
17 June 2014
Specific Attributes
IE Data model
Specific Attributes
IE Data model
Page 34 of 57
17 June 2014
Specific Attributes
Describe a L2 Cluster/Data
Model object in greater
granularity. The
entity objects represent what
makes up the L2 data object.
Data type
[Text, Floating point
number, Integer,
Boolean, Enumeration
type, Point in time,
Duration, Date, Time]
Data type
[Text, Floating point
number, Integer,
Boolean, Enumeration
type, Point in time,
Duration, Date, Time]
Data type
[Text, Floating point
number, Integer,
Boolean, Enumeration
type, Point in time,
Duration, Date, Time]
Enumeration describes a
list value of an attribute
(descriptive attribute))
Page 35 of 57
17 June 2014
Application Screens
Report Catalogue
Specific Attributes
Page 36 of 57
17 June 2014
Specific Attributes
Page 37 of 57
17 June 2014
Specific Attributes
Application collaboration diagram
Page 38 of 57
17 June 2014
Specific Attributes
are used.
Specific Attributes
Page 39 of 57
17 June 2014
Specific Attributes
Screen design
ERM attributes are
characteristics which
describe entity types.
(e.g., Your height
Data type
[Text, Floating point
number, Integer,
Boolean, Enumeration
type, Point in time,
Duration, Date, Time]
(descriptive attribute))
Page 40 of 57
17 June 2014
Specific Attributes
For items where multiple
selection is available, it
is important to mention
in its description what
section options are
allowed.
Page 41 of 57
17 June 2014
Specific Attributes
Screen navigation
This object is the generic
representation of a
screen.
This object is the generic representation
of an exclusive or rule.
This object is the generic
representation of an event
(condition)
Specific Attributes
Page 42 of 57
17 June 2014
Specific Attributes
Requirements tree
This object is the generic
representation of an
objective
Requirement type
[Functional (General),
Non-Functional
(General), Functional
(Assignment), Functional
(Escalation), Functional
(Conditions)]
Page 43 of 57
17 June 2014
Specific Attributes
Specific Attributes
Page 44 of 57
17 June 2014
Specific Attributes
This object is the generic
representation of a
business service.
Specific Attributes
Page 45 of 57
17 June 2014
Specific Attributes
are used.
This object is the generic
representation of a process
KPI
Specific Attributes
Page 46 of 57
17 June 2014
Specific Attributes
Page 47 of 57
17 June 2014
Information
Name*
Model name
Full name
Long name
Description/Definition
Remark/Example
Release
Person responsible*
Type
Creator*
Identifier*
Maintained by ARIS
Last change*
Last user*
Time of generation*
Link 1
Title 1
Model Status
Design History
QA History
Approval History
Release History
Page 48 of 57
17 June 2014
Information
Name*
Object name
Full name
Long name
Description/Definition
Remark/Example
Type
Creator*
Identifier*
Maintained by ARIS
Last change*
Last user*
Time of generation*
Link 1
Title 1
Object Status
Design History
Approval History
Release History
Page 49 of 57
17 June 2014
3 Modelling Standards
5.9 General Modelling Guidelines
General modelling guidelines include:
Keep consistency between the level of detail and the types of objects being included at each level
within a model and between referenced models.
Use the zoom out view test. If you zoom out of the model:
o
Is it clear where the core process flow is and where the exceptions are?
Note details and complexity in the flows using free-text comments. Simplify and populate attribute
details later.
Different levels have different uses (each level conveys different information)
Establish a target level of detail before beginning to model, but dont ignore or throw away
information at the wrong level that is raised. This information can be cleaned up later, and may
indicate that there are other higher, same, or lower level models to be considered.
Use model assignments to break down complex functions from high-level models to more detail while
maintaining a consistent level of detail at each level.
Break up complex branching flows using process interfaces (BPMN Signal Events) at logical points to
help simplify individual models.
Put supporting details into the attributes fields of models and objects rather than into separate
documents. Reports can be generated on models and attribute information to create textual reference
documents.
Page 50 of 57
17 June 2014
Keep models to less than 3 pages or about 15 functions/tasks, when possible, to improve readability.
Define your models scope. (For example, when does the process start and end.)
It is good process modelling practice to include an exit path to a loop for the end user to understand
that all loops have a final conclusion. When modelling a loop set the conditions for the loop exit to
avoid an endless loop.
Model tasks, events and decisions first and add other objects later.
Model the essentials of the flow as a draft, and then return later to elaborate detail and map exception
processes.
They should be generally understandable and common - try to fit in space without resizing
Names should reflect the organisations terminology (valid for the whole organisation, not only parts of
it)
Avoid overuse or inconsistent use of capitalisation (Only first letter of a sentence should be capitalised)
Model names should have business meanings and should not describe the model type. (Example:
Organisational Chart).
Subordinate models should have the same name as the originating object when linking models.
Avoid using special characters, numbers or letters that depict relationships as it is redundant to the
capabilities inherent to ARIS and can cause future rework as you refine models and structures.
Page 51 of 57
17 June 2014
Objects Naming
An object name should be unambiguous and concise. For example, use completely spelled words wherever
possible to avoid different interpretations and to facilitate keyword searches.
As a best practice, object names should not contain more than 7 words for readability of objects. Any further
explanation or details are to be stored in the description attribute.
Avoid using:
Generic names (Use Fix Customer Payment Errors instead of Fix Errors)
Prepositions
Overuse of capitalisation
The Function/Activity name, Perform customer identification, does not correspond to the naming
convention. The information object that the Function/Activity processes is the customer and not the customer
identification.
Hint: The verb perform is an indication that the information object is not suitable.
Perform calculation
Identify customer
Page 52 of 57
17 June 2014
Describes the state transition of the information object processes in the Activity/Function
Matches the information object of the Activity/Function that precedes it by not using auxiliary verbs
(is, are, was, were).
Page 53 of 57
17 June 2014
Start Context
Description
Right-click any
model
Right-click any
model
Right-click any
object
Path: Reports\Standard
Create Process Manual
(Word/PDF)
Path: Reports\Standard
Output object information
(Excel/Word)
Path: Reports\Standard
Export attribute values for
translation (Excel)
Right-click database
Path: Reports\Standard
Import translated attributes
Path: Reports\Standard
2014 Software AG. All rights reserved.
Page 54 of 57
17 June 2014
Start Context
Description
Right-click any
model or group
Right-click any
object, model or
group
Right-click object or
model
Path: Reports\CSU
ADMIN - Reference Model
Generation Wizard VX
Path: Reports\CSU
ADMIN - Replace Text in
selected attribute in selected
Objects or Models or Groups VX
Path: Reports\CSU
ADMIN - Transfer Common
Attributes to Selected MetaModel Items VX
Path: Reports\CSU
CSU - Generate Business Process
Design Document VX
Right-click object
Path: Reports\CSU
Audit Trail VX
Path: Macros\CSU
Automatically
configured to
execute after an
updated model is
closed
Page 55 of 57
17 June 2014
ARIS Infrastructure
QA & Integration
ARIS Technical QA
ARIS Governance
Page 56 of 57
17 June 2014
5 Glossary
Term
Definition
ARIS
BAU
Business As Usual
BPMN
CC
E2E
End-to-End
GUID
KPI
SME
VACD
Rwdv
Page 57 of 57