Upload
others
View
4
Download
0
Embed Size (px)
Citation preview
System Thinking in IT model driven solutions
How ‘Enterprise Architect’ and the ‘Pro Cloud Server’ helped staff and students
successfully complete their projects
Version 20181008, 07:00 ● final
Date: Oct-8th 2018 07:07:20
Authors: Roman Kazička
EA Repository: 014_STH_ModeligAsNewParadigma
Content
1 Introduction ................................................................................................................................................................ 3
2 Demonstrating how students at the University were able to use Enterprise Architect to solve real world problems ............................................................................................................................................. 5
3 The simple tutorial based on some of the Course Work presented ............................................................ 7
4 Some students Projects ........................................................................................................................................ 10
Description ................................................................................................................................................................. 10
Results ........................................................................................................................................................................ 10
Description ................................................................................................................................................................. 12
Results ........................................................................................................................................................................ 12
04. How did you use the Pro Cloud Server/Cloud Services within your course material? ........................ 15
5 How did student groups use the technology to collaborate and discuss models, architectures or class ................................................................................................................................................... 19
6 Summary ................................................................................................................................................................... 21
System Thinking in IT - Model driven solutions
3/21
1 Introduction PACKAGE NAME-PCG_1451_INTRODUCTION, STEREOTYPE- ''
Figure 1: PCG_1452_Mind Map overview
Common understanding among stakeholders is critical success factor in all IT solutions (CSF), This is one of the most important experiences of my practice. I worked as a solution architect in the production of consumer electronics (SAGEM, PHILIPS VIENNA), automotive components manufacturing (Wabash Technologies, Magneti Marrelli), developer of a specialized application for the International Personnel Agency (Trenkwalder Technologies ), CTO during IT outsourcing in a large car (Volkswagen Bratislava) - ITIL, TOGAF. Everywhere was the communication and common understanding the most common problem. Currently, the ‘common understanding’ is largely based on the principle that we could call 'Document driven Solutions'. Documents are of great importance, and it will be in the future as well, but they should not be primary sources of information. They contain thousand of Terms with their own lifecycle. It is impossible to keep documentation up to date in this way. Primary source of information should be the ’Trusted sources’ of truth about our solutions. Model with repositories, based on SQL and NoSQL databases. From these sources (contain necessary metadata about all term) will be generated secondary carriers of information in different formats (docx, pdf, html). This approach is called ‘Model Driven Solutions’. ‘Model Driven Documentation’. Because each document is valid only at the moment of generation, this article is obsolete in the moment of publishing as well. We have the chance to keep actual information in the model only. With Sparxsystems technology I have experience since r. 2000. I chose it because it provides the best price-performance ratio for supporting ‘Model Driven Solutions’. This article discusses how the Sparxsystems technology supports this concept in practice and how we have tried to transfer our experience to young people at the prominent Slovak University ‘Faculty of Informatics and Information Technologies, Slovak University of Technology in Bratislava’ (FIIT STU) in the subject of System Thinking in IT solutions and Digital fabrication. Model driven solutions, Basic principles of self-learning organization, individual visions, team visions, personal mastery. The course was based on cooperation many individuals, enthusiasts and institutions in the winter 2017-2018. The basic pillars of the course are: - Long term experiences of the teachers from different types of solutions, environments in IT a digital fabrication - Original methodologies and process standardization (7D-seven disciplines for successful solutions, APV-Assets-Perspectives-Views, Q12-12 quadrants for building business) - Enthusiasm of individuals, non-profit institutions and educational institutions - Support of Sparxsystems company (Licenses for Pro Cloud Server, clients ‘Enterprise Architect’, Cloud Sparx Services, Sparx Pro Cloud Server, Web EA, Joomla!EA)
mmd PCG_1452_Mind Map overview
How Enterprise Architect and the Pro Cloud Server helped staff and students successfullycomplete their projects
01.Introduction
02.Demonstrating how students at the University were ableto use Enterprise Architect to solve real world problems
03.The simple tutorial based on some of the CourseWork presented
04. How did you use the Pro Cloud Server/CloudServices within your course material?
05. How did student groups use the technology to collaborate anddiscuss models, architectures or class assignments?
06.Summary
System Thinking in IT - Model driven solutions
4/21
The topic is quite extensive, and its comprehensive description goes beyond the purpose of this article. If interested in more details, please, contact me.
Figure 2: PCG_1453_Story board
custom PCG_0361_-final-02.Story board-course STHDF-02-final
Common Understanding
Edu
cati
on
sys
tem
/ Se
lf L
ear
nin
g Te
ams
Re
al L
ife
«Solution consumer»End User
«Solution Providers»Students
«course»
System thinking and Digital Fabrication
«Solution support»Support
«Outcome»Product/Service
Solution Realisation
«Outcome»Knowledge base
Sup
po
rtin
g P
artn
ers
an
d In
div
idu
als
Sparx Cloud Service
Pro Cloud Server
Joomla!EA
WebEA
EA Client
Peter Lieber
Jozef Vaško Roman Kazička
Mária Bieliková
«University»STU FIIT Bratislava
«Public Institution»SLOVAK CENTRE OF SCIENTIFIC AND TECHNICAL INFORMATION
«University»Comenius University Science Park
«Public Institution»FABLAB CVTI
«EU Funding»EU program FablabNET in the frame of Interreg
SparxSystems technology
Driven by Sparx
Systems«Non profit org»AGNICOLI -Through Knowledge to Freedom
Július Kováč Jozef Púry
realises
take parts on
Thinks of
generates
generates
Supports
System Thinking in IT - Model driven solutions
5/21
2 Demonstrating how students at the University were able to use Enterprise Architect to solve real world problems
PACKAGE NAME-PCG_1454_02.DEMONSTRATING HOW STUDENTS AT THE UNIVERSITY WERE ABLE TO USE ENTERPRISE ARCHITECT TO SOLVE REAL WORLD PROBLEMS, STEREOTYPE- ''
Students had to find the customer with his specific problem from real life. Every student was using the ‘Enterprise Architect’ client. All students shared the common repository via Cloud Sparx Services and WebAE. Every student had own place in the repository. The structure of this place corresponded to the methodology 7D, which is implemented into ‘Enterprise Architect’ via specific MDG. It contained following packages- 01. Management, 02. Motivation, 03. Analysis, 04. Design, 05. Implementation, 06. Verification, 07. Lesson learned. All disciplines are very well supported by SparxSystems technologies (‘Enterprise Architect’ client, Sparx cloud services, Pro Cloud Server). Students generated the content into model’s repository during the whole semester from September till February. Continuously they could generate the current output documents via ‘Master Document’ feature and ‘Virtual Documents’ elements. In this way, the students were focused on the matter not the form. Output documentation was created as a side effect of their regular work on the project tasks almost automatically. The outputs are not perfect, but for technical documentation and common understanding are ‘good enough’.
Figure 2: PCG_1454_‘Enterprise Architect’ Client with Home page separated for each student, for each Project
custom PCG_1454_EA Client
Screen1-Student Workplace for any projects activities
System Thinking in IT - Model driven solutions
6/21
Figure: 3: PCG_1470_Time Planning/Scheduling
custom PCG_1470_Time Planning/Sheduling
Screen1-Internal Calendar
System Thinking in IT - Model driven solutions
7/21
3 The simple tutorial based on some of the Course Work presented PACKAGE NAME-PCG_1462_03 SIMPLE TUTORIAL, STEREOTYPE- ''
All project activities were supported by original methodologies 7D, APV which are implemented in ‘Enterprise Architect’ client via MDG extension. There is ‘Model Driven Book’ about methodology itself and about the process – how to automatically generate documentation from ‘Enterprise Architect’ repository (https://leanpub.com/7D)
Methodology 7D-Seven Disciplines for Successful Solutions PACKAGE NAME-PCG_1455_METHODOLOGY 7D-SEVEN DISCIPLINES FOR SUCCESSFUL SOLUTIONS, STEREOTYPE- ''
Here is short presentation what is 7D methodology. 7D is focused on the journey to the goal. The experiences from the journey itself, is the goal. 7D methodology covers the specific task of Project management and Knowledge management systems. It is specific chronicle of the Solution and team members.
Figure 4: PCG_1455_Methodology 7D-Seved Disciplines for Successful Solutions
custom PCG_1455_Methodology 7D-Seved Dispciplines for Successful Solutions
class PCG_00339_What is the 7Ds methodology about?
Screen1-Story of Solutions, Goals and Journeys
The goal we want to achieve.
⦁ The journey to the goal. In 7D
methodology This is our real goal.
⦁ The journey provide us the huge experience
to be better in the bext projects.
⦁ The first way is full of unforeseen
circumstances, our inexperience. If we
understand what we can do better, each
subsequent path will be faster and
easier to manage.
Initial status. We have a intention, we have a goal,
maybe we lack experience.
Screen1-What is Methodology 7D about?
System Thinking in IT - Model driven solutions
8/21
7D Structure PACKAGE NAME-PCG_1474_7D STRUCTURE, STEREOTYPE- ''
Figure 5: PCG_1474_7D Structure
mmd PCG_1474_7D Structure
mmd PCG_00186_7D - Seven Disciplines - Overview
7D - Seven Disciplines
for sucessfull Solutions
D1-management
D2-Motivation
D3-Analysis
D4-Design
D5-Implementation
D6-Verification/Testing
D7-Lesson
Learned
01.Goals/Expectations
02.Strategy
03.Plans/Roadmaps
04.Decisions
05.Work Activities Evidence
06.Reporting
07.Publishing
01.Deliverables
01.Deliverables
02.Plans/Roadmaps
00.Decisions
01.Principles
02.Rules
03.SWOT Analysis
04.Risks
05.Measures
01.Stakeholder Analysis
01.Resources
01.Project Management Reporting
02. Model Quality Reporting01. Overview of Authors of Model
01. Effort Reports
01.Best Practice
02.Bad Practice
03.Opened Questions
04.Proposals 01. New Principles
02. New Rules
08.Resources
03.Project Management
09.Intelectual Properties
01.Human Resources
02. Time Resources
03.Finanace
Screen1-7D structure
System Thinking in IT - Model driven solutions
9/21
Methodology APV-Assets-Perspectives-Views PACKAGE NAME-PCG_1473_METHODOLOGY APV-ASSETS-PERSPECTIVES-VIEWS, STEREOTYPE- ''
Methodology APV serves for describing the AS-IS and TO-BE status of current and future situation.
Figure 6: PCG_1473_Methodology APV-Assets-Perspectives-Views
custom PCG_1473_Methodology APV-Assets-Perspectives-Views
custom PCG_00344_What is the APV methodology about?
Screen1-Story of Solutions, Goals and Journeys
In the APV methodology, we focus on how to
describe the outcome.
APV describes the baseline. From it, we want
to reach the goal with the 7D methodology.
APV describes static properties of the
solution not the path to it.
Screen1-What is Methodology APV about?
System Thinking in IT - Model driven solutions
10/21
4 Some students Projects PACKAGE NAME-PCG_1387_PROJECTS SAMPLES, STEREOTYPE- ''
During the course were realized 9 small projects in the team of 1-3 team members. Here is the list of all projects. 2 of them are described in details.
06.Robotics Car
PACKAGE NAME-PCG_1459_03.ROBOTICS CAR, STEREOTYPE- ''
Description
- The goal of the project is to create a remote-controlled car that can be controlled without visual contact, thanks to real-time image transfer. To simplify control, increase user awareness and reduce the risk of collision, the user will be helped by various sensors such as distance sensor, gyroscope, accelerometer, temperature sensor.
Results
- Educational Functional prototype of the robotic car controlled via smart phone application and with many sensors.
Figure 7: PCG_1461_The robotic Car
custom PCG_1461_The robotic Car
Screen1-The Robotic Car with sensors
01.Smart sensors for Intelligent House
02.Security system for Houses - NFC Protect
03.Automated entry of vehicles into a logistics center
04.YPASS-Facility access management system
05.GSM gate for opening the gate using your phone
06.Robotic Car
07.Car driver sleep detection during driving
08.Dirty hands multimedia system control
09.Intelligent Garden
System Thinking in IT - Model driven solutions
11/21
Figure 8: PCG_1460_How Sees the word the robotic Car. The can be controlled via Web page as well
custom PCG_1460_How See the word the robotic Car
Screen1-Picture demonstating how the car sees the reality
System Thinking in IT - Model driven solutions
12/21
04.YPASS-Facility Access management system PACKAGE NAME-PCG_1463_04.YPASS-FACILITY ACCESS MANAGEMENT SYSTEM, STEREOTYPE- ''
Description
- Customer: - Ynet is civic association and its members entering the reserved area - Documentation of an existing card reader when entering the room access control system. Also documented
will be previous versions.
Results
- Relatively detailed model in ‘Enterprise Architect’ on existing HW solution. Used methodology APV-Assets-Perspectives-Views for describing existing status of the real system. This type of ‘documentation’ has the chance to be close the status ‘up to date’.
In this project was used methodology APV. It was more suitable for describing existing solution. Here are some samples from documentation.
Figure 9: PCG_1464_Assets-Perspectives-Views
custom PCG_1464_Assets-Perspectives-Views
class 02.Model of Instances
Assets Perspectives Views
PCG_0397_Configuration guide
+ Snímka01.PNG
+ Snímka02.PNG
+ Snímka03.PNG
+ Snímka04.PNG
(from 03.Views)
PCG_0311_Devices
+ PCG_0293_RFID_reader
+ PCG_0294_Controll_unit
+ PCG_0295_Server
+ PCG_0297_User_interface
+ PCG_0369_Door_lock
(from 01.Assets)
PCG_0312_People
+ 01.Stakeholder Analysis
(from 01.Assets)
PCG_0313_Location
+ PCG_0320_Buildings
+ PCG_0321_Rooms
+ PCG_0322_Layout in space
(from 01.Assets)
PCG_0314_Logicial design
(from 02.Perspectives)
PCG_0315_Physical Deployment
(from 02.Perspectives)
PCG_0317_User and configuration guide
(from 02.Perspectives)
PCG_0318_Logicial deployment
(from 02.Perspectives)
PCG_0319_Access and user rights management
(from 02.Perspectives)
PCG_0291_Logical
+ System block scheme version 01
+ PCG_0372_Sequence_diagram_Open_door
+ PCG_0373_Sequence_diagram_Add/edit/remove_permissions
+ PCG_0374_Sequence_diagram_Reservation_of_rooms
(from 03.Views)
PCG_0323_Security
(from 02.Perspectives)
PCG_0324_Networking
(from 02.Perspectives)
PCG_0356_Physical description
+ PCG_0398_Version_01_scheme
+ PCG_0400_Version_03_scheme
(from 03.Views)
PCG_0394_Physical Deployment - manual
+ PCG_0393_Zostavenie_čítačkového_modulu
+ PCG_0411_Photo_evidence
(from 03.Views)
PCG_0396_User guide
+ Bez názvu.png
+ Snímka01.PNG
+ Snímka09.PNG
+ Snímka10.PNG
+ Snímka11.PNG
+ Snímka12.PNG
+ Snímka13.PNG
(from 03.Views)
PCG_0413_Access and user management
+ Artifact1
(from 03.Views)
Screen1-Assets-Perspectives Views
System Thinking in IT - Model driven solutions
13/21
Figure 10: PCG_1495_Stakeholder Analysis
Figure 11: PCG_1496_Sequence Diagram - Open Door
custom PCG_1495_Stakeholder Analysis
Screen1-Stakeholder Analysis
custom PCG_1496_Sequence Diagram - Open Door
sd PCG_0372_Sequence_diagram_Open_door
Rfid readerRFID card Central unit ServerUser
Lock
1.8openDoor
()
1.6blinking
()
1.4reply
()
1.1CardID
()
1.7Unlock
()
1.3requestToOpenWithCardID()
1.2sendReplyWithCardID
()
1.9Lock()
1.0enclose
()
1.5blinkGREEN
()
Screen1-Sequence Diagram - Open Door
System Thinking in IT - Model driven solutions
14/21
Figure 12: PCG_1497_Design - version 03
custom PCG_1497_Design - version 03
custom PCG_0400_Version_03_design
version_03_bottom.png
«Image»
version_03_top.png
«Image»
version_03_scheme.png
«Image»
Version 03 pinout,
exported from EAGLE
Screen1-Design Version 03
System Thinking in IT - Model driven solutions
15/21
04. How did you use the Pro Cloud Server/Cloud Services within your course material?
PACKAGE NAME-PCG_1456_04. HOW DID YOU USE THE PRO CLOUD SERVER/CLOUD SERVICES WITHIN YOUR COURSE MATERIAL?, STEREOTYPE- ''
‘Sparx cloud services’ allow easy access to a shared repository without the need to install ODBC drivers and it provides another useful features, which promote synergistic effects in the whole team of the course. Within the principles of self-learning organization (Peter Senge), we try to connect individual visions, needs and expectations with the visions of the project groups and the whole course. Important is, that Visions have to be transformed during the course into real solutions and expectation of the real customer. ‘Pro Cloud Server’ (WebEA) was used for easy access to model content without installing any special software components on the end devices (nor ‘Enterprise Architect’ client nor OBDC driver). The web browser is enough. In this way the repository contents could be consumed by persons, who don’t need to work with so sophisticated tools like UML modeler (e.g. course supervisor from university site, university representatives, friends of team members, etc). All these individuals, who had access to repository could see and review the solutions. On the background were running the scripts, which provided different reports about the project’s status. The team members communicated to each other via chat, internal e-mails, and reviews.
Figure. 13: PCG_1467_Number of elements per team member in time
custom PCG_1467_Number of element per team member in time
custom 01.Elements by Author-pri priebežnej kontrole-
Name:Package:Version:Author:
01.Elements by Author-pri priebežnej kontrole-01.Elements by Author-pri priebežnej kontrole-1.0Roman Kazička
Screen1-Number of elements per time
System Thinking in IT - Model driven solutions
16/21
Figure 14: PCG_1468_Internal Communication
custom PCG_1468_Internal Communication
Screen1-Team members internal communication -internal e-mail
System Thinking in IT - Model driven solutions
17/21
Figure 15: PCG_1469_Web EA-Team member presentation
custom PCG_1469_Web EA-Team member presentation
Screen1-Students Ideas Presentations
Screen2-Details
System Thinking in IT - Model driven solutions
18/21
Joomla!EA - Model snapshot presenting
Presenting content of model via standard CMS tool like Joomla! seems to me very interesting. Full text search, browsing through the model via ‘Project Browser’ feature is very useful for sharing model with persons, who needs to consume the content of model. I can imagine to manage in this way internal directives. Maybe we will use this feature in presenting results of student’s projects on the web in the future. We have used this way just for illustration this year.
Figure 16: PCG_1494_Joomla!EA - Model snapshot presenting
System Thinking in IT - Model driven solutions
19/21
5 How did student groups use the technology to collaborate and discuss models, architectures or class
PACKAGE NAME-PCG_1457_HOW DID STUDENT GROUPS USE THE TECHNOLOGY TO COLLABORATE AND DISCUSS MODELS, ARCHITECTURES OR CLASS ASSIGNMENTS?, STEREOTYPE- ''
All team members, all students and teachers are sharing common repository. Information in the repository are available for different roles in different way: - for active content creators (project team members): - ODBC connection - Sparx cloud Services connection - for passive recipients (friends, university representatives, colleagues): - Pro Cloud Server – Web EA - Joomla!EA - Exported content in different formats (rtf, docx, pdf, html) The Students presented their work progress on weekly basis to the class. They were inspired by each other, they communicated (internal e-mail, chat, review, discussions), shared experiences and common topics (How to?) They presented the interim results of their work. They could plan their work according to the available capacity, and record the efforts of the project. If it is necessary to report time stamps for estimate the effort and evaluate spent time.
Knowledge Sharing
Figure 17: PCG_1471_Knowledge Sharing
custom PCG_1471_Knowledge Sharing
Screen1-Knowledge Sharing
System Thinking in IT - Model driven solutions
20/21
RTF Templates Sharing for automated generated Documents
Figure. 18: PCG_1472_RTF Templates Sharing for automated generated Documents
custom PCG_1472_RTF Templates Sharing for automated generated Documents
Screen1-Resources
Screen2-Cover Pages, master Template, TOC
System Thinking in IT - Model driven solutions
21/21
6 Summary PACKAGE NAME-PCG_1458_SUMMARY, STEREOTYPE- ''
Experiences from the course: This course was created on the basis of cooperation between FABLAB CVTI Bratislava, Comenius University Science Park and FIIT STU. The main objective of the course was to bring students closer to digital manufacturing. This course was focus on integration 2 approaches. Rapid prototyping in the field of 3D printing, IoT, Laser cutter, CNC cutter and system approach. Students received the basic information about technology presented in FABLAB CVTI and general overview about holistic approaches in IT (TOGAF, ITIL). During the whole course we have used the client UML modeler ‘Enterprise Architect’ (SparxSystems) and server background Sparx Cloud Services, Pro Cloud Server with WebEA access. Licenses for ‘Enterprise Architect’ clients were provided by FIIT, licenses for Pro Cloud Server (WebEA) were provided by SparxSystems company with close cooperation with SparxSystems central Europe. Teachers experience
• From digital fabrication point of view. Many of students were excited by the ‘maker space’ with 3D printers and Laser cutter. As students of informatics, they had no opportunity to touch such devices yet. Some of them had experiences with Arduino, or Raspberry yet.
• From System Thinking point of view. - There are almost no habits among IT specialists to spent time with preparation before starting the work. The methodology ‘7D- Seven disciplines for successful solutions’ was presented to students. There is simple implementation in ‘Enterprise Architect’ client – so called MDG. In spite of that, this methodology can be used independent of the technology. It saves time for users and provide place in model structure for any piece of information which comes to ‘makers’ during realization of their project. It supports the awareness of team cooperation, knowledge sharing, and systematic approach. - Many students knew ‘Enterprise Architect’ client just as schema builder. They were pleasantly surprised by many interesting features for keeping all information about their daily work on one place.
• 2 different approaches ‘System Thinking’ and ‘Rapid prototyping’. Is it possible to use both approaches on the same course? Yes. We can combine the strengths of both approaches – Focus on results and keep track on the journey to the goal
Students experience:
• Positive reactions o Approximately 30-40 % appreciate the ‘Enterprise architect’ tool as a collaboration and knowledge
management tool for managing processes in lifecycle of the solution. They can imagine to use it in the future. But they are aware of complexity of the tool.
• Negative reaction o Non-traditional approach to the making documentation and totally new approach - ‘Model Driven
Project’ from the beginning of the course
• Very complex tool for daily work, more visual ‘how to?’ tutorial would be appreciated.
• Almost all students prepared the initial documentation in ‘Enterprise Architect’ client. Approximately 50% finished their documentation in established tools (google drive, google docs) due to different reasons (problem with Mac, Linux, Licenses, complexity)
Improvements for the next Year
• inspiration from the previous course o more practical examples how to use SparxSystems technology for routine work o stable and runnable infrastructure with higher availability is crucial for operating such a course
Conclusion at the end SparxSystem technology is very suitable platform for the building ‘trusted sources of truth’ about our solution in the whole lifecycle of Solutions. Based on this we can try to approach the vision: Right Information – to Right Role – In the Right Time And in this way to increase the common understanding among key stakeholders