Profile picture for user thaase

You want to evaluate enterprise assets? Or you want to understand your structure of the enterprise? Do you know the risks and weak points of your enterprise? How can you compare models with each other? Do you have the complete overview which changes are made in your models?

These and other questions bother many managers. ARIS reports and macros could help by presenting the necessary data in a visual manner. Today, I want to show you how to maintain and setup ARIS reports and macros. In a later post, my colleagues and I will share with you some reports for business process analysis.

Report/ Macro download & setup

Before using a report/ macro, I have to import it. Make sure you got ARIS Business Architect installed, because you need the administration module to do the import. In case you only got ARIS Business Designer on your machine, you have to ask your ARIS administrator to install the report/ macro for you.

Before a report/ macro can be used, it must be made available in ARIS. The following screenshots show how to import a report/ macro step by step:

  • In the module “Scripts”, I navigate to “Reports” or “Macros”.


  • Then, I create a new category named “Reports&Macros” by choosing “New”-> “Category”. Categories are used to group similar reports/ macros. Categories are similar to folders on your harddisk.

 new category

  • And I import there the needed ARIS report or macro.


  • After, I choose the needed report, for example “Configurable relationship analysis. arx” or a needed macro such as “Modeling audit trail.amx”. An ARIS report file has always the file extension ARX and an ARIS macro has the file extension AMX.

 selection of report

 selection of macro

After selecting the file to import, another dialog is shown. There are the „other” script files your macro/report might depend on. The dialog allows importing those required macros/reports. If those files already exist, you can deactivate the checkbox, otherwise you can’t deactivate it.

HINT: If the checkbox can be deactivated, you should do so to avoid overwriting an already existing file.

 avoiding overwriting

 avoiding overwriting

Afterwards, the import of the report/ macro is done. Now, the report/ macro can be used. However, before all users can use a macro, it must be activated for them. The following steps show how to activate an ARIS macro. This step is not needed for ARIS reports.

Activation of an ARIS macro

Before using a macro, I have to activate it:

  • In the module “Scripts” I navigate to the category that I have created for the macro.
  • I mark the macro and open the properties.

 activation of  a macro

  • I activate the checkbox “Available to users” and I confirm my selection by clicking the “OK” button.

 activation of a macro

Now, my ARIS report/ macro is ready for usage. The exact steps involved in executing an ARIS report/ macro depend on the analysis to be performed by the report/ macro. Still, there are many steps, which are common for all reports/ macros.

The following steps show, how to start a report or a macro:

  • I open or select the model or object, which I want to evaluate. Basically, here I define the analysis context. The possible context to analyze depends on the report/ macro.
  • Then I choose in the context menu the menu item “Evaluate”-> “Start report…
  • Or “Start macro…”

 running the report or macro

  • An assistant is shown.
  • I select the needed report/ macro.

 selection of the report

 selection of the macro

  • Afterwards, I select the output settings such as language.

 definition of output settings of a report

 definition of output settings of a macro

  • I adjust the options if needed. If not, I just click “OK”. Of course the available options depend on the report/ macro executed. There are also many reports/ macros available, which do not provide any options at all.

 selection of evaluating options

  • The report /macro is executed, which may take some time.

 report creating

Finally, the results of the report/ macro are shown. Of course, this depends heavily on the ARIS report/ macro executed. Therefore, I can’t show you a screenshot now.

In the following weeks, my colleagues and I are going to share with you some ARIS reports and macros, which you can download for free. Here is already a list of the reports/ macros:

  • Enterprise Asset Evaluation
  • Configurable Network Analysis
  • Risk & Weak Point Analysis
  • Model Comparison
  • Modeling the Audit Trail

Make sure to monitor ARIS Community to get notified as soon as those reports become available!

by Ismael Shameem Etowar
Posted on Mon, 01/25/2010 - 16:59

Hi Torsten,


Many thanks for those tips. These are indeed very helpful.





by André Vitor Oliveira
Posted on Tue, 01/26/2010 - 11:14


Nice tutorial !





by Vyacheslav Strogalev
Posted on Tue, 01/26/2010 - 19:03

Thank you, Torsen. I'm going to wait your reports/macros. It's very interesting. Have a nice day! :)

by Test Test
Posted on Thu, 03/25/2010 - 11:54

Hi Torsen,

I newly started using the ARIS tool, It would be a great help if you clear my below query.

By using the Evaluation Filter we can filter the content in the reports generated based on the scripts and publish it.

We have a site which is created to publish all the business process flows created in the ARIS server so that everyone from our organisation can view the process model through that site.

Now we have decided to have a standard script which can be used to generate the report for any new database models created. But when i create the report its available in the server but we want report generated to be available in the site as well.

Could you please provide your inputs on how to achive this.

Your help is highy appriciated.



by Thierry Caro
Posted on Thu, 03/25/2010 - 15:44

Hello Torsen

Thanks for all this useful sharing !!

I've started using macros, but in some case, for event-driven macro (i.e. Event=database opened) I receive a stop sign message "This macro can only run in ARIS Business Architect" while I am using ARIS Business Designer.  Are there restrictions on the component capable of running the macro?    Thanks.


by Chunnu Mehta
Posted on Mon, 02/09/2015 - 23:08

Hello Torsten,

Is it possible to have ‘Report’ functionality to ARIS Connect user ? I know there is basic Report capability for ARIS Designer in edit mode, I am looking for Reporting capability in ARIS Connect (Read only access).



Featured achievement

Say hello to the ARIS Community! Personalize your community experience by following forums or tags, liking a post or uploading a profile picture.
Recent Unlocks


icon-arrow-down icon-arrow-cerulean-left icon-arrow-cerulean-right icon-arrow-down icon-arrow-left icon-arrow-right icon-arrow icon-back icon-close icon-comments icon-correct-answer icon-tick icon-download icon-facebook icon-flag icon-google-plus icon-hamburger icon-in icon-info icon-instagram icon-login-true icon-login icon-mail-notification icon-mail icon-mortarboard icon-newsletter icon-notification icon-pinterest icon-plus icon-rss icon-search icon-share icon-shield icon-snapchat icon-star icon-tutorials icon-twitter icon-universities icon-videos icon-views icon-whatsapp icon-xing icon-youtube icon-jobs icon-heart icon-heart2 aris-express bpm-glossary help-intro help-design Process_Mining_Icon help-publishing help-administration help-dashboarding help-archive help-risk icon-knowledge icon-question icon-events icon-message icon-more icon-pencil forum-icon