Archi - ArchiMate Modelling
1
jArchi / Re: Archi Confluence Upload Sc...
Last post by yveszoundi - December 03, 2021, 20:28:41 PMI had a bit of time today to fix some of the typos in the code and test it.
I'm reasonably "satisfied" so far and things seem to be working as expected: I replaced my old Confluence workflows today with the newer scripts.
To aggregate content from an other thread, there are similar efforts from @Xavier Mayeur
I'm reasonably "satisfied" so far and things seem to be working as expected: I replaced my old Confluence workflows today with the newer scripts.
To aggregate content from an other thread, there are similar efforts from @Xavier Mayeur
- See https://github.com/xmayeur/archiScript and look for 'Export to Markdown.ajs'
- See https://github.com/xmayeur/toConfluence for the import/export script from/to Confluence API
2
General Archi Discussion / Re: Specialization with image ...
Last post by Jean-Baptiste Sarrodie - December 03, 2021, 17:15:12 PMHi,
As Phil said, this is related to Open Group work ad not Archi itself. Simply share your wish list in this discussion and I'll share them with The Open Group myself.
JB
As Phil said, this is related to Open Group work ad not Archi itself. Simply share your wish list in this discussion and I'll share them with The Open Group myself.
JB
3
General Archi Discussion / Re: Specialization with image ...
Last post by Phil Beauvoir - December 03, 2021, 16:31:02 PMQuote from: tpedot on December 03, 2021, 16:27:16 PMYes. I will find a time for that. I propose to open a github issue for that do you agree ?
Don't open a GH Archi issue if it is a general Exchange Format issue and not Archi-specific.
4
General Archi Discussion / Re: Specialization with image ...
Last post by tpedot - December 03, 2021, 16:27:16 PMYes. I will find a time for that. I propose to open a github issue for that do you agree ?
5
General Archi Discussion / Re: Specialization with image ...
Last post by Jean-Baptiste Sarrodie - December 03, 2021, 15:44:11 PMHi,
Tree structure is supported by the Exchange file format but is named Organization (see: https://pubs.opengroup.org/architecture/archimate31-exchange-file-format-guide/#Chap07-Organizations). Archi does support it.
As The Open Group is working on the next version of the Exchange File Format, Could you list the missing features you think would be useful? I'll then see how we can address them.
Regards,
JB
Quote from: tpedot on December 03, 2021, 14:32:17 PM2/ I always prefer those format. This just lack some features today like keeping the tree structure for exemple.
Tree structure is supported by the Exchange file format but is named Organization (see: https://pubs.opengroup.org/architecture/archimate31-exchange-file-format-guide/#Chap07-Organizations). Archi does support it.
As The Open Group is working on the next version of the Exchange File Format, Could you list the missing features you think would be useful? I'll then see how we can address them.
Regards,
JB
6
General Archi Discussion / Re: List of organizations know...
Last post by Phil Beauvoir - December 03, 2021, 15:10:24 PMQuote from: tpedot on December 03, 2021, 14:52:55 PMHello the Archicommunity,
I just joined Jokosun company, startup company for deploying energy solutions in west Africa, as a CTO/CIO last September and will use with Archi to construct the first EA model.
It will be used to discuss with CEO, represent actual architecture and defining the strategy.
I am an experienced user of Python and DevOps oriented I will push for automation wherever I can.
I am also see open source as a corner stone of our strategy and for that I consider contributing to Archi.
Happy to join this community.
Hi, welcome to the Archi community, and thanks for your contribution!
Regards,
Phil
7
General Archi Discussion / Re: List of organizations know...
Last post by tpedot - December 03, 2021, 14:52:55 PMHello the Archicommunity,
I just joined Jokosun company, startup company for deploying energy solutions in west Africa, as a CTO/CIO last September and will use with Archi to construct the first EA model.
It will be used to discuss with CEO, represent actual architecture and defining the strategy.
I am an experienced user of Python and DevOps oriented I will push for automation wherever I can.
I am also see open source as a corner stone of our strategy and for that I consider contributing to Archi.
Happy to join this community.
I just joined Jokosun company, startup company for deploying energy solutions in west Africa, as a CTO/CIO last September and will use with Archi to construct the first EA model.
It will be used to discuss with CEO, represent actual architecture and defining the strategy.
I am an experienced user of Python and DevOps oriented I will push for automation wherever I can.
I am also see open source as a corner stone of our strategy and for that I consider contributing to Archi.
Happy to join this community.
8
General Archi Discussion / Re: Specialization with image ...
Last post by tpedot - December 03, 2021, 14:32:17 PMHello, thanks for your feedbacks really appreciated.
1/ I understand this. At the end, if major change is to be made and we know that 'a certain' amount of time before it's ok.
2/ I always prefer those format. This just lack some features today like keeping the tree structure for exemple.
3/ Our ecosystem is made of Python: dataschemas / diff & merging / etc... So if we can make it outside...
1/ I understand this. At the end, if major change is to be made and we know that 'a certain' amount of time before it's ok.
2/ I always prefer those format. This just lack some features today like keeping the tree structure for exemple.
3/ Our ecosystem is made of Python: dataschemas / diff & merging / etc... So if we can make it outside...
9
jArchi / Re: Archi Confluence Upload Sc...
Last post by yveszoundi - December 03, 2021, 09:10:06 AMAdditional notes on top of the TLDR version.
Concepts
An archi-Confluence page is modeled as a Group element on a Sketch diagram:
An archi-Confluence pipeline on a Sketch diagram contains one or multiple archi-Confluence pages:
The name of archi-Confluence page is used as Confluence page title (retrieve existing page information by title and Confluence space: page id, page version, etc.).
Confluence integration
Diagram documentation and images are published through the Confluence REST API.
Design decisions
It is more flexible to use Sketch diagrams than Canvas or regular Archimate views.
Concepts
An archi-Confluence page is modeled as a Group element on a Sketch diagram:
- An archi-Confluence page contains either nested sections (Groups) or references to diagrams (Canvas, Sketch or default Archimate diagrams).
- Within an archi-Confluence page, the flow between sections is specified using connections. All page contents but the last element, must point once to something (either a section or diagram reference).
An archi-Confluence pipeline on a Sketch diagram contains one or multiple archi-Confluence pages:
- If you don't select anything on a sketch diagrams, all the archi-Confluence pages will be published.
- Alternatively, you can select specific archi-Confluence pages to publish.
The name of archi-Confluence page is used as Confluence page title (retrieve existing page information by title and Confluence space: page id, page version, etc.).
Confluence integration
Diagram documentation and images are published through the Confluence REST API.
- You, create a Confluence API token and keep it in your password manager.
- You, configure Confluence publishing settings in Archi: A utility script provides a dialog that helps persisting Confluence parameters in the Archi workbench preferences. This includes the Confluence username, API token, default space key, base URL.
- The script, retrieves Confluence page information, based on the page title: Page titles are unique in Confluence within a given space (space key).
- The script, renders any documentation associated to a view or 'section' using markdown (view/section documentation is parsed as Markdown and converted to HTML)
- The script, exports any referenced view/diagram image as PNG binary data
- The script, publishes text and image contents to Confluence pages accordingly to the desired sections/sub-sections.
Design decisions
It is more flexible to use Sketch diagrams than Canvas or regular Archimate views.
- You can connect directly 'view references' to each other without additional nesting.
- There's no need to think too much about the allowed structure: there are only groups, view references and connections (minimal validation in place).
10
jArchi / Archi Confluence Upload Script...
Last post by yveszoundi - December 03, 2021, 09:02:30 AMI'm finalizing Archi scripts for Confluence publishing, via REST API integration: I originally had a working but less flexible version.
Confluence Settings screenshot
Confluence Pipeline screenshot
- A "convenient" dialog helps you store Confluence settings (URL, API token, etc.)
- After defining a publishing pipeline, you can update one or multiple pages on Confluence from Archi
Confluence Settings screenshot
Confluence Pipeline screenshot