Category Archives: Archimate

My 2 jArchi scripts

Last year I wrote 2 jArchi scrips. Those scripts allow to add functionality to the Archimate toolkit. (The Archimate toolkit is a a tool which allow Business and IT Architects to model the Business/Enterprise/IT architectutes using the Archimate notation.)

The scripts are tagged #jarchi on Github. (See also github/jfdeclercq)

I always need to search for my own scripts so I post them here also.

Script to add a note to a diagram:

/*
 * New Archi Script
 */
console.log("AddNote Started !");
//var date = new Date();
//console.log(date.toString());
//var note = archimateView.createObject("note", 10, 200, -1, -1);
//note.setText("This is a note.\n\nHello World!");
//var note = visualObject.createObject("note", 10, 200, -1, -1);


// Get the first view in the current selection
var view = selection.filter("archimate-diagram-model").first();
// Get current date
var currentDate = new Date();
// Create a new note and set its text
var note = view.createObject("note", 10, 10, 300, -1);
note.text = view.name + "\n" + currentDate.toString() +"\n" + "Jean-Francois Declercq";
note.fillColor = "#e2e2be";
console.log("Note added to " + view.name);

Script to export a diagram as picture with the name of the view as proposed image name:

//Export View as image (PNG)  with date and diagram name in filename.

// Get the first view in the model
//var view = $("view").first();
var view = selection.filter("archimate-diagram-model").first();
// Get the Base64 bytes of the view in PNG format. Can use "PNG", "BMP", "JPG" or "GIF"
// Options are scale (1 - 4) and margin (pixel value)
var bytes = $.model.renderViewAsBase64(view, "JPG", {scale: 1, margin: 20});

var date = new Date();


// Ask for a file name
var fileName = window.promptSaveFile( { title: "Save View", filterExtensions: [ "*.jpg" ], fileName: ""+ date.toISOString().replace(":","").replace("T","-").slice(0,15)+ "-" + view.name + ".jpg" } );
if(fileName) {
    // Write to file
    $.fs.writeFile(fileName, bytes, "BASE64");
}

Strategies for your enterprise architecture: people or documentation ?

Here is an interesting thought of a colleague yesterday (Thomas Vermassen – Lead Architect ORES) on documenting IT systems:

You have basically two strategies for keeping your Enterprise Architecture knowledge under control.

The first one is to capitalize on people. If your organization is stable enough you can assign clear responsibilities and you should be able to find the right information by finding the right person.

The second one is to capitalize on documentation. Through deliverables you make sure everything is described as it should be. This is most suitable if you have a high collaborators turnover like when you work with a lot of sub-contractors.

The ideal world is probably to have both.

I’m a deliverable minded person and I so I tend to prefer the second one. I value information sharing as it often avoids job protection and silo thinking. The notion of deliverable is also linked to another value that I like : personal contribution.

Also when the architecture is complex I don’t see how you can just book a meeting with someone in oder for him to explain you the 100 business processes in scope. That must be why clever people write books……

How to search for objects with name containing ‘?’ in SPARX Enterprise Architect ?

I had to search more than 2 minutes for this, so I post it.

The question is how to escape special characters in the SPARX EA search.

Answer : You need to escape the ? using square braquets: [?]

Since the wildcard is ‘*’, the SQL is

SELECT Name FROM t_object where NAME like ‘*[?]*’

Useful links:

Requirements matrix in archimate

Structuring and graphically representing requirements can be challenging for large projects.  Today I figured out how to draw the equivalent of several pages in excel into one single archimate diagram.

The requirements are structured in 3 columns : requirement family, description and concerned stakeholders.

Using archimate I drew actors corresponding to stakeholders vertically, as a kind of first column. Then I drew all requirements families at the top as a kind of first line by using xxx of the archimate motivation extension.

Requirements can then be represented as a kind of cell in the actors/ family table.

In order to simplify the drawing and trace the requirements dependencies I used a simple association between actor and requirement and an aggregation relationship between requirement family and requirement. Actors can link to any requirement.

The result looks like this :

ReqMatrix

 

This needs to be done in several phases: after some modeling, clusters of requirements can be identified and the drawing can be reorganized by reordering actors and requirements to improve readability.

The next step will be to map requirements to the solution processes,  functions and components.…

The Design Thinking Process

Design Thinking is a process based on the collaboration between the users and a product designers to determine how to solve problems that the users have.

5 Steps to Build Perfect Web Sites Using the Design Thinking Process:

1. Empathy and Immersion

2. Define the Problems You want To Solve

3. Come Up with Ideas to Solve User Problems

4. Create Prototypes of Products to Solve the Users’ Problems

5. Test the Products with your Users

 

Source: read the integral article on the PHP Classes blog:

5 Steps to Build Perfect Web Sites using the Design Thinking Process – PHP Classes blog

Archimate model of the DIGITAL LIBRARY SYSTEM ARCHITECTURE (DIGB-SA)

Here is the DIGB-SA study Archimate model that has been built with Archi 2.6:

2014-03-26-DIGB-SA.archimate.zip

If you don’t want to install Archi, you can have a look at the model here:

http://www.jfdeclercq.biz/files/DIGB-SA-Archi-Model/archi-report.html

I have received the authorization from my clients to publish it in order to:

  • Encourage the modeling practice and reuse among public libraries
  • Share with the Archimate community as an example

The model reuse is subject to the following  restriction:

YOU SHALL NOT MARKET, SELL OR RESELL THE DIGB-SA ARCHIMATE MODEL

This model is published for reuse by public libraries. It can’t be marketed, sold or resold.

This model has been developed by Jean-François Declercq in the context of the DIGITAL LIBRARY SYSTEM ARCHITECTURE study by ordered by:
– Bibnet vzw
– Vereniging van de Vlaamse Provincies
– Vlaamse Gemeenschapscommissie van het Brussels Hoofdstedelijk Gewest

Cfr http://jfdeclercq.biz/tag/digb-sa/

PS: A Dutch version of this model is available at Bibnet (http://www.bibnet.be).…

Study Published: the system architecture of the digital public library

26 march 2014

The reports of  the study on the current and future system architecture of the  digital library have been recently published.

The term “digital library” is here used as a collective name for all of a library’s products, processes and services that are digital and/or automated.

The study summary lists the future work zones for the  Flemish Public libraries:

  1. Business intelligence (BI)
  2. IT maturity
  3. Web presentation
  4. Identity and Access Management (IAM)
  5. Digital Collections
  6. Collection Management and cataloguing
  7. Architecture consolidation (SOA)

The summary is available in French, Dutch and English:

The complete study has three main chapters :

  • Current system architecture of Flemish public libraries (AS-IS)
  • Evolution of the Flemish public libraries’ System architecture (change requirements)
  • The Future system architecture of Flemish public libraries (TO-BE)

The future system architecture is in fact a generic future-proof ICT blueprint for a public library. The blueprint is a set of business services, business processes, Applications, SOA Services and technological elements documented in the Archimate notation.

Business Services Overview

The complete study is available

I would like to thank the colleagues who worked with me on this study:

  • François Vermaut (IT Strategy, BPM, SOA, ITIL…)
  • Rosemie Callewaert (Public Library field expertise, User Experience, BIBFRAME, FRBR…)
  • Simon Kroeger (Proof reading english text)
  • Veerle Vanlooy (Vertalingen Vanlooy)

I also would like to thank the steering commitee (Bart Beuten, Jan BraekmanPatrick Vanhoucke ,Stefaan Froyman), all the workshop and participants. Their input has been key. I would like also to thank Alexandre Lemaire who helped me to compare the Flemish situation with the situation of the Fédération Wallonie-Bruxelles.…

Php to UML with bouml

For our startup, we have coded many classes in php. As the code grows, it becomes difficult to have a good overview of all the attributes and methods.

I tested yesterday bouml (that I had for long time on all my machines) to reverse enginner the code. The result is fast and efficient. I now have a nice uml diagram with all my classes.…