ARIS MashZone

Contents
1 2 Welcome to ARIS MashZone help ............................................................................ 1 Introduction to ARIS MashZone............................................................................... 2 2.1 2.2 3 3.1 3.2 4 4.1 MashApps ................................................................................................... 3 Data feeds .................................................................................................. 4 Start server ................................................................................................ 6 Start user interface ...................................................................................... 6 Getting started .......................................................................................... 10 Use search ..................................................................................... Set favorite .................................................................................... Display MashApps ........................................................................... Use MashApps ................................................................................ Insert display component ................................................................. Assign data .................................................................................... Set filter ........................................................................................ Set title ......................................................................................... Set size ......................................................................................... Place display component .................................................................. Display preview .............................................................................. Select data source ........................................................................... Calculate feed data.......................................................................... Change data type ............................................................................ Define calculation rule ..................................................................... Combine data feeds ......................................................................... Finish feed definition ....................................................................... 10 11 12 13 16 17 22 23 24 25 25 27 28 29 32 33 36

Start ARIS MashZone ............................................................................................ 6

ARIS MashZone Quick Start Guide ......................................................................... 10 4.1.1 4.1.2 4.1.3 4.1.4 4.2 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6 4.2.7 4.3 4.3.1 4.3.2 4.3.3 4.3.4 4.3.5 4.3.6

Edit MashApps........................................................................................... 14

Create data feeds ...................................................................................... 26

5

Procedure .......................................................................................................... 38 5.1 Use MashApps ........................................................................................... 38 Share MashApp ............................................................................... Delete MashApp .............................................................................. Display MashApp view ..................................................................... Print MashApp view ......................................................................... Save MashApp view as image ........................................................... Publish a MashApp with guest access ................................................. Copy MashApp address to clipboard ................................................... Call MashApps via URL ..................................................................... Set display size ............................................................................... Refresh data ................................................................................... Display MashApp properties .............................................................. Display history of a MashApp ............................................................ Save display component as image ..................................................... Display data of a display component as a table ................................... Save data of a display component as a CSV file .................................. 38 40 40 41 41 41 42 43 44 44 44 45 45 46 46 5.1.1 5.1.2 5.1.3 5.1.4 5.1.5 5.1.6 5.1.7 5.1.8 5.1.9 5.1.10 5.1.11 5.1.12 5.1.13 5.1.14 5.1.15 5.2 5.2.1

Create and edit MashApps .......................................................................... 48 Use composer ................................................................................. 48

I

ARIS MashZone

5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13 5.2.14 5.2.15 5.2.16 5.2.17 5.2.18 5.2.19 5.2.20 5.2.21 5.3 5.3.1 5.3.2 5.3.3 5.3.4 5.3.5 5.3.6 5.3.7 5.3.8 5.3.9 5.3.10 5.3.11 5.3.12 5.3.13 5.3.14 5.3.15 5.3.16 5.3.17 5.4 5.4.1 5.4.1.1 5.4.1.2 5.4.1.3 5.4.1.4 5.4.1.5 5.4.1.6 5.4.1.7 5.4.1.8 5.4.1.9 5.4.1.10 5.4.2 5.4.2.1 5.4.2.2

Create MashApp .............................................................................. Copy MashApp ................................................................................ Add MashApp view .......................................................................... Delete MashApp view ....................................................................... Format MashApp view ...................................................................... Duplicate MashApp view................................................................... Format display component ............................................................... Specify link .................................................................................... Move to front or back ...................................................................... Delete display component ................................................................ Duplicate display components ........................................................... Apply style ..................................................................................... Automatically refresh data ............................................................... Set display size ............................................................................... Set gridlines ................................................................................... Use master view ............................................................................. Change style template ..................................................................... Change MashApp name .................................................................... Change MashApp description ............................................................ Assign keywords to a MashApp ......................................................... Use user input ................................................................................ Change data feed description............................................................ Share data feed .............................................................................. Delete data feed ............................................................................. Edit data feeds ............................................................................... Copy data feeds .............................................................................. Use data sources............................................................................. Refresh data cache .......................................................................... Zoom editor view ............................................................................ Use feed editor ............................................................................... Change data feed name ................................................................... Use operators ................................................................................. Set source data .............................................................................. Display raw data ............................................................................. Assign keywords to a data feed ......................................................... Display change history of a data feed ................................................ Display data feed properties .............................................................

49 50 51 51 51 52 52 54 55 56 56 57 58 59 59 60 60 60 61 61 62 63 63 65 65 66 66 67 68 68 70 70 71 72 73 73 73

Use data feeds .......................................................................................... 62

Manage ARIS MashZone ............................................................................. 74 Manage users ................................................................................. 74 Create user ............................................................................... Manage users ............................................................................ Delete users .............................................................................. Assign users to particular user groups .......................................... Create user groups ..................................................................... Edit user groups ........................................................................ Delete user groups ..................................................................... Import LDAP users and user groups ............................................. Delete LDAP users and user groups .............................................. Set function privileges ................................................................ 74 75 75 76 77 78 78 79 80 81

Set server ...................................................................................... 83 Create resource directory ............................................................ 83 Change resource directory .......................................................... 84

II

ARIS MashZone

5.4.2.3 5.4.2.4 5.4.2.5 5.4.2.6 5.4.2.7 5.4.2.8 5.4.3 5.4.3.1 5.4.3.2 5.4.3.3 5.4.4 5.4.4.1 5.4.4.2 5.4.4.3 5.4.4.4 5.4.5 5.4.5.1 5.4.5.2 5.4.5.2.1 5.4.5.3 5.4.5.4 5.4.5.4.1 5.4.5.5 5.4.5.6 5.5 5.5.1 5.5.2 5.5.3 5.5.4 5.5.5 5.5.6 5.5.7 5.5.8 6 6.1

Delete resource directory ............................................................ Share resource directory ............................................................. Change proxy server settings ...................................................... Add license key .......................................................................... Enter Google Maps key ............................................................... Edit e-mail templates .................................................................

85 85 86 87 87 88

Manage MashApps/data feeds ........................................................... 89 Delete data feeds/MashApps ....................................................... 89 Export data feeds/MashApps ....................................................... 90 Import data feeds/MashApps ....................................................... 91 Set database connections ................................................................. 93 Install database drivers .............................................................. Create database connection ........................................................ Change database connection ....................................................... Delete database connection ......................................................... 93 94 95 96

Configure webMethods Broker connection .......................................... 96 Configure real-time buffer server ................................................. 97 Configure EDA connection ........................................................... 98 EDA connection options ............................................................ 99 Delete configuration of an EDA connection ................................... 100 Configure real-time buffer .......................................................... 100 Buffer options ........................................................................ 101 Start real-time buffer instance .................................................... 104 Delete real-time buffer configurations .......................................... 105 Submit ratings ............................................................................... 105 Use extended search ...................................................................... 106 Display help .................................................................................. 107 Display information on ARIS MashZone ............................................. 107 Use carousel view .......................................................................... 108 Change password ........................................................................... 108 Change language ........................................................................... 109 Log out ......................................................................................... 109

Miscellaneous ........................................................................................... 105

Use cases .......................................................................................................... 110 Use Google Maps ...................................................................................... 110 Display coordinates in Google Maps .................................................. 110 Display routes in Google Maps ......................................................... 119 6.1.1 6.1.2 6.2

Use vector maps ....................................................................................... 126 Display components .................................................................................. 132 Table ............................................................................................ 133 Line chart ...................................................................................... 136 Column chart ................................................................................. 139 Bar chart....................................................................................... 143 Bubble chart .................................................................................. 146 Pie chart ....................................................................................... 149 Vector map ................................................................................... 153 Google Maps .................................................................................. 156 Speedometer chart ......................................................................... 162

7

Appendix........................................................................................................... 132 7.1 7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 7.1.8 7.1.9

III

ARIS MashZone

7.1.10 7.1.11 7.1.12 7.1.13 7.1.14 7.1.15 7.1.16 7.1.17 7.1.18 7.1.19 7.1.20 7.2 7.2.1 7.2.2 7.2.3 7.2.4 7.2.5 7.2.6 7.2.7 7.2.8 7.2.9 7.3 7.3.1 7.3.1.1 7.3.1.2 7.3.1.3 7.3.2 7.3.2.1 7.3.2.2 7.3.2.3 7.3.2.4 7.3.2.5 7.3.3 7.3.3.1 7.3.3.2 7.3.3.3 7.3.3.4 7.3.3.5 7.3.3.6 7.3.4 7.3.4.1 7.3.4.2 7.3.4.3 7.3.4.4 7.3.4.5 7.3.4.6 7.3.4.7 7.3.4.8 7.3.5 7.3.5.1 7.3.5.2 7.3.5.3

Bar speedometer ........................................................................... 165 Single traffic light ........................................................................... 169 Multiple traffic light ........................................................................ 172 Text ............................................................................................. 175 LCD text ....................................................................................... 178 Image .......................................................................................... 180 Selection box ................................................................................. 183 Spin control ................................................................................... 185 Slider ........................................................................................... 189 Time filter ..................................................................................... 191 Input box ...................................................................................... 195 CSV file......................................................................................... 197 XLS file ......................................................................................... 201 XML file ........................................................................................ 206 Data feed ...................................................................................... 210 Manual data .................................................................................. 211 ARIS PPM ...................................................................................... 212 Database ...................................................................................... 215 wM Optimize ................................................................................. 217 wM Business Events ....................................................................... 219 Data feeds .................................................................................... 223 Combine data feeds................................................................... 223 Concatenate data feeds ............................................................. 225 Copy data feeds ........................................................................ 226 Columns ....................................................................................... 226 Change data type ...................................................................... 226 Insert columns ......................................................................... 232 Delete columns ......................................................................... 233 Duplicate columns ..................................................................... 234 Rename columns ...................................................................... 234 Calculation .................................................................................... 235 Aggregation ............................................................................. 235 Geo aggregation ....................................................................... 238 Arithmetic ................................................................................ 243 Average ................................................................................... 246 Rounding ................................................................................. 247 Goal accomplishment ................................................................ 248 Column values ............................................................................... 250 Geocoding ................................................................................ 250 Filter values ............................................................................. 252 Replace values.......................................................................... 255 Link texts ................................................................................. 257 Find text .................................................................................. 258 Extract text .............................................................................. 259 Replace text ............................................................................. 260 Convert text ............................................................................. 262 Individual values ............................................................................ 263 Copy single value ...................................................................... 263 Data feed to value..................................................................... 263 Values to data feed ................................................................... 266

Data sources ............................................................................................ 197

Operators ................................................................................................ 220

IV

ARIS MashZone

7.3.5.4 7.3.5.5 7.3.5.6 7.3.5.7 7.3.6 7.3.6.1 7.3.6.2 7.3.6.3 7.3.6.4 7.3.7 7.3.7.1 7.4 7.4.1 7.4.2 7.4.3 7.5 7.5.1 7.5.2 7.5.3 7.5.4 7.5.5 7.5.6 7.5.7 7.5.8 7.5.9 7.5.10 7.5.11 7.5.12 7.5.13 7.5.13.1 7.5.13.2 7.5.13.3 7.5.13.4 7.6 7.7 7.8 7.9 7.10 7.11

Link text .................................................................................. 267 Create URL ............................................................................... 267 Retrieve info............................................................................. 269 Change data type ...................................................................... 271 Date ............................................................................................. 277 Round up/down date ................................................................. 277 Move date ................................................................................ 280 Replace date field ..................................................................... 282 Determine earliest/latest date .................................................... 284 Other............................................................................................ 286 Output ..................................................................................... 286 Date ............................................................................................. 286 Text ............................................................................................. 287 Figure ........................................................................................... 288 Start installation ............................................................................ 290 Accept license terms ....................................................................... 290 Update ARIS MashZone .................................................................. 290 Select installation type .................................................................... 290 Select installation directory ............................................................. 291 Install demo content....................................................................... 291 Configure ARIS MashZone server ..................................................... 292 Select system profile ...................................................................... 293 Install webMethods Broker add-on ................................................... 293 Configure proxy server ................................................................... 293 Create program shortcut ................................................................. 294 Finish installation ........................................................................... 295 Installation under Linux .................................................................. 295 Installation requirements ........................................................... 296 Install ARIS MashZone ............................................................... 296 Start ARIS MashZone ................................................................ 297 Uninstall ARIS MashZone ........................................................... 297

User input................................................................................................ 286

ARIS MashZone installation ........................................................................ 289

ARIS MashZone database connection .......................................................... 298 MashApp URL parameters .......................................................................... 299 User-defined vector graphics ...................................................................... 301 User-defined color schemes ....................................................................... 303 Safe mode ............................................................................................... 305 System administration .............................................................................. 305 LDAP connection ............................................................................ 305 Set the file umc.properties ......................................................... 306 7.11.1.1

7.11.1

7.11.1.1.1 Set caching ............................................................................ 310 7.11.1.1.2 Encrypt LDAP password ........................................................... 310 7.11.2 7.11.2.1 7.11.2.2 SAML connection ............................................................................ 311 Configure the file mashzone.properties ........................................ 312 SSO integration in My webMethods ............................................. 313

7.11.2.2.1 Configure mashzone.saml parameters ....................................... 313 7.11.2.2.2 Integrate ARIS MashZone in My webMethods server ................... 313 7.11.2.2.2.1 Install MashZone portlet .................................................. 314 7.11.2.2.2.2 Use MashZone portlet ...................................................... 314 7.11.2.2.2.3 Use wm_xt_ssolink portlet ............................................... 316

V

....................11........... 323 7.............2 Install trustworthy certificate ....11.......................... 321 7....................... 321 7...........11..........1.....3 Import signed certificate ................................... 320 7............ 322 7..............11.3...................................3 Real-time buffer service via SSL .....12 System architecture ....... 322 7............1 Adapt Tomcat configuration ......1.....2 Import chain certificate or root certificate ..................11...........................2............1 VI .........................11...1.............................3.... 318 Create keystore with self-signed certificate ..........3...2.....................1 Create certificate signing request ...ARIS MashZone 7.......2.. 324 7.1 Tomcat SSL configuration.......12..................3...................11....11.............2 Address Google Maps via SSL .............11.................... 318 7.........3.....................................3......... 323 7...........3.................3........3 7.......... 323 Network communication ........

External links are provided solely for your convenience and do not imply endorsement of the content of linked sites by Software AG. setting up. pat. pat. D561. This manual describes the settings and functions as they were at the time of print. pat. Walldorf. All other trademarks are property of their respective owners.778. and using the product. Any changes. D547.324 .777. SAP NetWeaver is a trademark of SAP AG. D561. pat.323. modifications. and the symbol are trademarks or registered trademarks of Software AG in Germany and in many countries all over the world. Information about discrepancies is provided in the Readme file that accompanies the product. D547. pat. or amendments require prior written consent from Software AG.S. U. additions. Reproduction in any form is only permitted on the condition that the copyright notice remains on the reproduced document. Since manual and software are subject to different production cycles. Publication or translation in any form requires prior written consent from Software AG. Software AG is not responsible for the content of such Web sites or further links provided on them.322. "PPM". The content of this document is subject to copyright law. D547. "IDS". "ARIS". Software AG does not control the external Web sites to which links are provided.Copyright (C) Software AG All rights reserved. Please read this file and take the information into account when installing. "ProcessWorld". the description of settings and functions may differ from actual settings and functions.

mashzone. Selected comprehensive use cases are described in the chapter Use cases (Page 110). Tip The following pages provide valuable tips and tricks.com/de/support) ARIS MashZone Community (http://www. e.    The chapter Procedure (Page 38) provides general and basic information on how to proceed.   ARIS MashZone Frequently asked questions (http://www.  The ARIS MashZone Quick Start Guide (Page 10) takes two use cases to explain how to handle ARIS MashZone and provides you with an overview of basic functions. The Appendix (Page 132) supplies further descriptions and technical references. Frequently asked questions are answered and numerous practical use cases described.ariscommunity.com/group/aris-mashzone) 1 .g. on display components and operators.ARIS MashZone 1 Welcome to ARIS MashZone help This is where you find information on working with ARIS MashZone (Page 2).

Schematic relationship between MashApps. data feeds. ARIS MashZone has a dedicated composer (Page 48) for creating and configuring your MashApps and a dedicated feed editor (Page 68) for defining your data feeds. independently distributed data sources. The data sources combined using data feeds (Page 4) are represented graphically and analyzed in MashApps (Page 3) (ARIS MashZone applications).ARIS MashZone 2 Introduction to ARIS MashZone ARIS MashZone is a browser-based application enabling you to analyze and visualize any data from various. You can use ARIS MashZone to view. and data sources 2 . and edit MashApps in a Web browser. create. A MashApp is an interactive visualization of data relevant to your business.

Possible data sources include Excel or CSV files. You can combine the individual display components to filter the displayed results interactively and thus analyze them intuitively. 3 . you can use the composer to create (Page 49) and edit (Page 14) your MashApps. which acquire their data from data feeds (Page 4) and display it.ARIS MashZone 2. tables. combines it. MashApps are composed of individual graphical components (e.). machine-readable data from the Internet. The data can come from different sources and is combined.g. and visualizes it.. maps. business graphics. Example: Green Car Roadshow MashApp overview Tip In ARIS MashZone. queries from data warehouses. reports from ERP or CRM systems. or freely available.1 MashApps A MashApp is an interactive Dashboard application that collects data from different data sources. etc.

A data feed consists of several columns that contain numerical values (e. which are linked together using connections. All individual processing steps in the feed definition are based on this data structure. Feed definitions aggregate. figures). which is accessed by the individual display components of a MashApp. extend. In addition to the external data sources. or date values.. Only one data feed can be assigned to each display component. The source data is not held redundantly in the data feed. text. A feed definition delivers a data structure in the form of a list table as its result.ARIS MashZone 2.g. or XML files) using feed definitions. with the same data feed being able to supply the data for several display components.2 Data feeds A data feed is a table containing prepared data. A feed definition can consist of any number of operators (Page 70) and data sources. Data is calculated for each data source and each operator and then passed on to the operators linked to them for further processing. CSV. but remains in its original sources. 4 . Each row in the calculated result of a data feed corresponds to one data record The data in a data feed is calculated based on various data sources (Page 66) (e. direct user entries (Page 62) in the data feeds can also be processed. transform. or calculate data from one or more data sources.g. ensuring that it is constantly up to date.. data from MS Excel.

ARIS MashZone Example: Feed definition with feed table Tip In ARIS MashZone you can use the feed editor (Page 68) to define your data feeds (Page 26). 5 .

Prerequisite You have started the ARIS MashZone server (Page 6). you need to set up ARIS MashZone server as a Windows service during installation (Software AG MashZone) (see chapter Configure ARIS MashZone server (Page 292)). you can log into ARIS MashZone using the user name system and the password manager. 2. Procedure 1. Click on Start ARIS MashZone server (as application) to start the ARIS MashZone server server as a separate application. using installed batch files. or as a Windows service.1 Start server You can start the ARIS MashZone server as a separate application. Tip Click on Stop ARIS MashZone server (as service) or on Stop ARIS MashZone server (as application) to stop the ARIS MashZone server. Note Depending on your settings (see Create program shortcut (Page 294) chapter). 3. The ARIS MashZone server is started. the shortcuts are located in the ARIS MashZone program group in the Windows Start menu. Note By default. different program shortcuts are available. By default. Note Before you can start the ARIS MashZone server as a Windows service. you must first start your ARIS MashZone server and then the ARIS MashZone user interface in your Web browser.ARIS MashZone 3 Start ARIS MashZone In order to use ARIS MashZone.2 Start user interface You can now start the ARIS MashZone user interface in your Web browser. which you can use to start the server and the user interface. Enter both in lower-case characters. 3. 6 . User name and password must not contain special characters. Click on Start ARIS MashZone server (as service) to start the ARIS MashZone server server as a Windows service.

Click on Login. The ARIS MashZone login dialog is displayed. Click on Start ARIS MashZone on the overview page. The overview page of your ARIS MashZone installation is displayed in your Web browser. 7 . The ARIS MashZone Home page is displayed. Enter your user name and password in the login dialog. Note You can also start ARIS MashZone by entering the URL of your ARIS MashZone server in the address bar of your Web browser in the following form. http://<computer name>. Click on the Start ARIS MashZone button in the Start menu.ARIS MashZone Procedure 1. 2. 4.<dnsdomain>:<port number>/mashzone e. 3. http://mypc.g.company:16360/mashzone Tip You can change your password later (Page 108).

edit. in order to gain a better overview. or create MashApps and data feeds. Depending on your view or edit privileges (Page 81). 8 . you can open. You can choose between display in list view ( carousel view ( ). Use the buttons in the program title bar to go to Administration (Page 74). and obtain general information about your ARIS MashZone version (Page 107). call up the online help (Page 107). evaluate. delete. ) and You can use the Search (Page 10) function and a list of the most frequently occurring keywords to limit the number of MashApps and data feeds displayed.ARIS MashZone Example: ARIS MashZone start page in list view ARIS MashZone Home The ARIS MashZone Home page is the central page on which you can access all MashApps (Page 3) and data feeds (Page 4) available to you. share. The MashApps and data feeds of all ARIS MashZone users are available on the corresponding tabs.

ARIS MashZone Example: Gallery view of all MashApps and data feeds 9 .

Tip To enable your ARIS MashZone version add the required license key to your version (Page 87).ariscommunity. The descriptions in the chapters Getting started (Page 10) and Edit MashApp (Page 14) are based on the demo MashApp Green Car Roadshow. which you can use to follow the descriptions in the subsequent chapters. You will also find out how to display MashApps (Page 12) and use MashApps (Page 13).1 Use search You can use the Search function to limit the number of MashApps or data feeds displayed by entering search terms of your choice or selecting a keyword.com/). 4. You can search for entire words or fragments of words.ariscommunity. The descriptions in the chapter Create feed (Page 26) are based on the demo data feed Green Car Roadshow participant.com/) user account yet. Prerequisite To be able to edit the demo MashApps and data feeds. For example. 4.ARIS MashZone 4 ARIS MashZone Quick Start Guide The ARIS MashZone Quick Start Guide includes two use cases to explain how to handle ARIS MashZone and provides you with an overview of basic functions.1. You receive a free license key via your user account in the ARIS Community (http://www. you can register for free. the demo MashApp Green Car Roadshow and the demo data feed Green Car Roadshow participant are available. you need to activate your ARIS MashZone version (Page 87). Note You can also install demo content during the ARIS MashZone installation (Page 289).1 Getting started The following chapters use examples to describe how to search for particular MashApps and data feeds (Page 10) and prioritize them for further access (Page 11). If you do not have an ARIS Community (http://www. 10 .

You can assign keywords (Page 61) to your MashApps and data feeds. 2. 3. Procedure 1. Tip You can set the search criteria using the advanced search options (Page 106). green roadshow. The MashApps or data feeds are filtered based on the search term. authors. 2. Example You want to mark the Demo Green Car Roadshow MashApp as important. separated by spaces. Procedure 1.2 Set favorite You can bookmark selected MashApps and data feeds by setting favorites. In the Search input box. The keywords are linked to the individual MashApps and data feeds and can be used as search terms. descriptions. keywords.ARIS MashZone The search function browses the names. The font size of the keywords indicates their relative frequency. Activate the MashApps tab on the Home page. 4. The search is performed automatically based on your settings. Note  The Popular keywords box (tag cloud) provides you with up to 50 of the most commonly used terms. and keywords assigned to the MashApps and data feeds. The key term is transferred to the input box and the search is performed automatically. Select the List ( ) or Gallery ( ) view. or description will be displayed. Tip   Click on the Reset search button ( ) in the Search input box to display all MashApps or data feeds again.1. Select the MashApp Demo Green Car Roadshow.g. Only those MashApps or data feeds that contain the corresponding terms in name. click on one of the key terms displayed in the Popular keywords box. e. enter one or more search terms.. 11 . so that you can access it more quickly in the future. Alternatively.

Example Select the MashApp Demo Green Car Roadshow. ) or double-click on the Demo 12 . 2. This view briefly describes the content and functions of the individual display components. which was held in numerous cities in North America. and the corresponding participation rate. The Intro screen of the Green Car Roadshow MashApp view is displayed. The individual display components analyze the number of registrations and the actual participants for each country and location. Activate the MashApps tab on the Home page. Europe.1. 5. The interactive view Green Car Roadshow of the MashApp is displayed. Click on the button again to disable the option. ). Procedure 1.ARIS MashZone 4.3 Display MashApps The MashApps tab on the ARIS MashZone Home page lists all available MashApps for which you have view or edit privileges. For example. click on the Limit view to favorites button ( title bar. and the feedback and interest of those participants is evaluated. To do this. and Australia. Click on the Open MashApp button ( Green Car Roadshow MashApp. Select list view ( ). 4. 3. Asia. 4. the Overview display component shows the total number of registrations and participants. Example The Demo Green Car Roadshow MashApp shows you an analysis of the number of participants in a roadshow. The Demo Green Car Roadshow MashApp is marked with a pin ( Tip You can limit the lists of MashApps and data feeds to favorites so that only the MashApps and data feeds with pins ( ) are displayed at the top of the ) in the lists. Click on the Green Car Roadshow tab to display the relevant view. Click on the Set favorite ( ) button below the MashApp preview. Select the MashApp Demo Green Car Roadshow.

You can interactively filter data in MashApps. to filter existing data or initiate actions. Tooltips provide you with detailed information on individual data elements. for example. You can use input boxes to enter data. provided corresponding filters have been configured (Page 22) for the display components.     Assigned links take you to relevant pages or other display components. See also Display MashApp view Display tooltip Use interactive filters 13 .ARIS MashZone Example: Green Car Roadshow MashApp intro 4.4 Use MashApps The MashApps provide you with various options that you can use to interactively evaluate the data displayed.1.

The number of participants (Value) who showed the corresponding level of interest is plotted on the Y-axis as a KPI. and set a filter. 14 . Example The following chapters describe how to create the Leads display component in the Demo Green Car Roadshow MashApp.ARIS MashZone Tip To close the open MashApp and return to the home page. click on the Home button in the program bar. from Not interested to Will buy. assign data. Example: Green Car Roadshow MashApp 4. The display component evaluates the sales potential or purchasing interest of the roadshow participants using a column chart. The sales potential (Potential) is displayed as a dimension (feature) on the X-axis of the chart.2 Edit MashApps You can use the composer (Page 48) to edit available MashApps and tailor them to your requirements.

Example Demo Green Car Roadshow in the composer 15 . a. Open the Demo Green Car Roadshow MashApp for editing in the composer.ARIS MashZone Prerequisite You added the license key (Page 87) required for your ARIS MashZone version. 2. click on Edit in the title bar. Procedure 1. On the MashApps tab on the Home page. You can now make your changes. b. If you have already opened the MashApp. select the MashApp Demo Green Car Roadshow and click on Edit below the preview. The composer opens and displays the MashApp Demo Green Car Roadshow for editing in the design view. Click on the tab of the Green Car Roadshow tab to display the desired MashApp view.

16 .1 Insert display component You can use the Display components (Page 132) of the design view to insert items such as diagrams and tables into your MashApp. Moving the mouse pointer over some of the icons in the bar displays submenus containing additional display components. you can delete the existing Leads display component (Page 56) before you follow the subsequent steps. The column chart is displayed only after you assign data (Page 17) to the display component. In the Display components bar. Procedure 1. move the mouse pointer over the Insert line chart button ( ). 4. Click on the Insert column chart button ( ).2. you can open a MashApp by clicking on the Open button in the toolbar. Click on Display in the program bar to return to the display of the MashApp Demo Green Car Roadshow. Other chart types are then displayed. a column chart is to be inserted into the MashApp Demo Green Car Roadshow as a display component. Tip  If you want to perform the example described yourself. The display component Column chart is inserted into the MashApp. Example For the planned analysis. 2.  The appendix provides a list of available display components (Page 132).ARIS MashZone Tip   In the design view.

in this example the Value feed column. Data feeds (Page 4) provide data for the individual display components.2 Assign data In the composer's data mode.. e. Example The X-axis of the column chart is to display the values of the Potential dimension (feature) and the Y-axis is to display the values of the Value KPI.2. Note Display components to which data has already been assigned are displayed schematically using demo data in the design view and are labeled Demo data.g.ARIS MashZone Example: Column chart display component without data 4. 17 .g. to the individual axes of a chart. e. Note Only feed columns with numerical values can be assigned to KPIs. you can use data feeds to assign calculated data to a display component. The display component displays the data in the MashApp in line with your settings. The various columns of a data feed are assigned to the individual elements of a display component. for evaluating KPIs or any aggregated data.

In the Data bar. The composer's data mode is displayed. 5. in this case Column chart. Click on the new Column chart display component you have inserted. Select the data feed Demo GreenCar potential buyers. set how the data is to be displayed. In the component bar. 2. Click on the Assign data button ( ) in the pop-up menu. Click on OK. A pop-up menu is displayed at the top edge of the display component.ARIS MashZone Select data Procedure 1. The Data bar displays a list of all column names from the selected data feed. The Select data feed window is displayed and shows all available data feeds. click on Select data feed. 4. The window displays two bars. 3. select the data to be displayed by selecting a data feed that provides the required data. 18 . In the Data bar.

19 . Hold down the mouse button and drag the mouse pointer to the ) of the Y-axis row in the Column chart bar. b.ARIS MashZone Example: Select data feed Assign feed columns Procedure 1. a. click on the anchor point ( row. ) of the Potential b. Assign the Potential feed column to the X-axis. The selected feed columns are now assigned to the axes in the column chart as a KPI or dimension. a. In the Data bar. 2. The axes in the column chart are labeled with the names of the assigned feed columns. The connection anchor points of the selected feed columns and chart axes are linked by a connection. The Value data element specifies the number of participants. Hold down the mouse button and drag the mouse pointer to the anchor point ( ) of the X-axis row in the Column chart bar. click on the anchor point ( anchor point ( ) of the Value row. Assign the Value feed column to the Y-axis. In the Data bar.

For example. the minimum or maximum value (Min/Max). etc. 20 .g. you define how multiple KPI values are combined into the result for an x-coordinate. you can use a pop-up menu to set the aggregation behavior of KPI values and the sorting of dimension values. Thus. Note It is necessary to define the aggregation because a data feed normally supplies more result lines than can be displayed in a chart.. etc. e. the sum of the values in the column (Sum). define thresholds or embed images. chart axes or segments. or the number of values in the column (Cnt). You can determine the mean value (Mw). tooltips. Use the aggregation to specify how the required data is determined from a feed column.ARIS MashZone Example: Assign feed columns Set chart data Procedure You can set the individual elements of a component.

The average value of the Value feed column is displayed on the Y-axis. 21 . Click on Y-axis in the column chart bar. 5. 3. Enable the Average (Mw) option for the Aggregation. 4. Tip You can check whether your settings are correct with actual data in the MashApp preview (Page 25). Procedure Y-axis 1. The format omits the decimal places in the display. Click on Save and Close.ARIS MashZone Example The Y-axis is to be labeled with Value and will display the values as mean values with no decimal places. select 1234 as the display format. 2. The required data is now assigned to the X-axis and Y-axis and set. In the Format selection box. A pop-up menu is displayed. The column chart is displayed schematically in the design view with demo data. Enter the text Value as the Name.

Procedure 1.ARIS MashZone 4.2. Click on the Assign data button ( ) in the pop-up menu. The Filter data window is displayed. Different filter options are available. Selecting a City in the Participants and registrations display component filters the values of the Potential dimension in the column chart accordingly. A pop-up menu is displayed at the top edge of the display component. Click on Save and Close. 7. 8. Under Set condition. 5. select is equal to (==) as the operator and City as the value to set the filter criterion. Click on Apply filter. Click on the Column chart display component in the design view. Click on the Filter data button ( window. select a display component containing the required filter criterion in the Filter data window and assign the filter criterion to the feed column to be filtered. The Set condition option is enabled. Click on the Participants and registrations display component to select the display component that supplies the filter criterion. Click on the selection box under Select data feed column and select City to select the feed column to be filtered.     Filter based on component Filter based on static value Filter based on user input Filter by clicking in a text box To set a filter criterion. The design view is displayed. The Assign data window is displayed. 6. 3. The Select data feed column option is enabled. 4. The Assign data window is displayed with the set filter. ) in the Data bar in the Assign data 22 .3 Set filter You can set one or more filters for the columns of a data feed. Example The sales potential for the individual cities in which the roadshow was held is to be displayed in the new column chart. 2.

23 . which is displayed in the title bar. Note To display the title. The Potential dimension in the new column chart is filtered accordingly. the frame of the display component must be displayed. Example: City filter set in the Participants and registrations display component 4.2. Tip You can test the set filter interactively in the MashApp preview (Page 25).4 Set title You can give the display component a title.ARIS MashZone You can filter the values of the Potential dimension using all filter values of the City filter criterion in the Registrations and participants display component. Procedure 1. See also chapter Use MashApp (Page 13). Click on the display component. click in the preview on a column for a City in the Participants and registrations display component. To do this.

Example: Display component with title bar 4. 2. hold down the mouse button. In the pop-up menu. The display component is displayed with a colored frame with corresponding handles. Click on the Leads display component. Example Set the size of the Leads display component. click on the Frame button ( The dialog for setting the frame is displayed. Procedure 1. Click on a handle. which you can use to set the display. The Leads display component is set to the specified size. and drag the frame to the required size.2. 24 .ARIS MashZone A pop-up menu is displayed at the top edge of the display component. The title bar of the display component is displayed with the title entered. In the Name input box. ). 2.5 Set size You can set the size of a display component. enter the text Leads and enable the Display option after Title. 3.

click on any of the columns. The Leads column chart displays the filtered values for the corresponding city. 4. Tip You can specify settings for displaying the gridlines (Page 59). 2. 25 . Click on Back to composer.7 Display preview You can display the MashApp in a preview with actual data. Tip Click on Display in the program title bar to return to the display of the MashApp Demo Green Car Roadshow. Note Before displaying the MashApp preview. 4. The design view of the MashApp is displayed again. Click on Save ( ) in the title bar. you must save your changes.2. Procedure 1. 3. In the Participants and registrations column chart. Click on Preview in the program bar. The display component is automatically aligned with the gridlines (Page 59) displayed. The display component is placed in the MashApp.2. hold down the mouse button and drag the display component to the relevant position in the MashApp. Example Place the Leads display component at a free position in the MashApp.6 Place display component You can place a display component freely in a MashApp. Procedure Click on the Leads display component.ARIS MashZone 4.

e..ARIS MashZone Example: Green Car Roadshow MashApp preview 4. which combines data from various data sources. and calculates the average participation rate relative to the number of registrations. 26 . A data feed (Page 4) is a table that contains processed data. which was recorded during the Green Car Roadshow.g. the following chapters describe how to create and edit data feeds. The data feed combines the data from two MS Excel files. MS Excel. CSV.3 Create data feeds You can use the feed editor (Page 68) to create new data feeds (Page 4). The data in the feed table is calculated using a feed definition. Prerequisite You added the license key (Page 87) required for your ARIS MashZone version. Tip To follow the description of the procedure more easily. you can open and edit the available data feed Demo Green Car Roadshow participants in the feed editor (Page 65). Example Using the demo data feed Green Car Roadshow participants. or XML files.

which can be selected by specifying the path. The table contains the number of registrations and participants per city and acts as a basis for calculating the participation rate.3. The element is mandatory and cannot be deleted. Specify the source file. Note When creating a data feed.1 Select data source You can set one or more filters for the data feed (Page 4). Enable the option The data is located in a directory on the ARIS MashZone server. must be stored in a defined resource directory on the ARIS MashZone server (by default. Tip Copy your source files to the resources directory of your ARIS MashZone installation. The feed editor opens and you can specify your settings. Possible data sources (Page 66) include MS Excel. ) data source from the Data sources bar 27 . or on the Internet. 2. The data sources for a data feed can be located locally. The Select source dialog is displayed. or XML files. Note Different options are available for setting the data source depending on the data source type. Click on the Select source button after the Source input box.xls as the first data source. 3. click on the Create new data feed button ( ). 4. a. is already created. the Output element that completes the feed definition (Page 36). The source files. Example Insert the Excel sheet Roadshow_Stops. the resources directory in the ARIS MashZone installation directory). in the LAN. The Source: MS Excel file element is placed at the selected point. or any subdirectory resources\<directory>. Procedure 1.ARIS MashZone Procedure On the ARIS MashZone Home page. Drag the MS Excel file ( into the workspace. CSV.

xls in the folder resources/demo/GreenCar. Procedure In the header of the Source: MS Excel file element. You can modify the default resource directory and define your own directories (Page 83). Note Only the first 100 rows of the results table are displayed. c. Example: Select data source 4. the MS Excel table is imported into the data feed and the column title of the feed table is adapted automatically.. Click on the Select file button (. Click on OK..) after the Path input box.3. Tip You can set the source data (Page 71) and specify the data to be extracted. Select the file Roadshow_Stops. click on the Display calculation result button ( ). Click on OK. 4. Example In the example described. The source file is inserted and data can be extracted from it. d. The data feed is calculated up to the selected element of the feed definition and the result is displayed in the Calculation result bar at the lower edge of the workspace.ARIS MashZone b. 28 .2 Calculate feed data You can calculate the data for almost all elements (data sources or operators) of the feed definition (Page 4) and display the corresponding content in the feed table.

g.3. Click on the Change data type operator.g. Example The Date column is to be assigned the Date ( assigned the Number ( ) data type. b.3 Change data type You can change the data structure of your data feed.g. an operator) using a link. ). Click on the Column selection box in the first row of the Change data type bar and select Date. Click on the Date ( ) button in the Date row.. For a selected outgoing anchor point. hold down the mouse button and drag it to the required position in the workspace. 4. Registrations. Assign the Date column of the data feed the Date data type. 3. Click on the anchor point ( ) of the Source: MS Excel element. ) of the individual b. b. a. Insert the Change data type operator into the feed definition. Connect the Source: MS Excel element to the Change data type element. The link is created as a connection between outgoing and incoming anchor points (e. a data source) is forwarded to another element (e. 2. the permitted incoming anchor points are each marked with a green arrowhead ( Procedure 1. arithmetic calculations. The City column is of the Text ( Note The data of an element (e. Click on Columns in the Operators bar.. e.ARIS MashZone The data is extracted and displayed with the adapted title bar in the Calculation result bar. The Invitations. a. and Leads columns are ) data type so that they can be used in ) data type. by changing the data type of columns. Participants. Tip You can display the raw data of the source file (Page 72) and set the source data (Page 71) to be extracted accordingly. a. 29 .g. Hold down the mouse button and drag the mouse pointer to the upper anchor point ( ) of the Change data type element.. The operator is inserted into the feed definition. elements.

Click on the Set format button ( separator. Add more rows for the Registrations. 30 . 7. ) to select a decimal c.ARIS MashZone c. The data from the feed is displayed in the results table with the corresponding data types. Click on the Add row ( column. ) to select a decimal separator. Assign the columns the Number ( 8. Click on the Display calculation result button ( the Change data type element to check your settings. Click on the Number ( ) button in the Invitations row. select Invitations. a. 4. b. and Leads columns. In the Column selection box in the new row. Participants. ) in the header of 9. The required data types are assigned to the selected columns. Assign the Invitations column of the data feed the Number data type. 6. Click on the Set format button ( ) data type. ) to select the format and the ) button to set the data type for another 5. Click on the Set format button ( language for displaying the date.

04.08. Example 08.ARIS MashZone Example: Select data source and change data type Date formats Date formats are specified using combinations of certain letters.70 -> yyyy-MM-dd Name Year Month Day Hour Minute Second am/pm Abbreviatio n y or Y only M d or D h or H only m s or S a or A 31 .1970 -> MM-dd-yyyy 04.

In the editable selection box in the first row. In this case. select the Registrations column as the divisor. Connect the Change data type element to the Arithmetic element. Define the calculation rule for the quotient.. For a year format such as 2009. Procedure 1.4 Define calculation rule You can use various operators to create calculation rules for calculating the data of your feeds. hold down the mouse button and drag it to the required position in the workspace. the number of characters must be >= 3 (MMM or MMMM) if the month is specified in text format (JAN. ) of the Change data type 3. with two exceptions. 2. 32 . For a year format such as 09. b. i. The ParticipationQuota is calculated as a quotient of Participants/Registrations*100. 1. etc. The calculation rule for the quotient can be defined using the Arithmetic operator. In the editable selection box in the second row. For a month. yyyy returns the year 9 and yy the year 2009. See also in the appendix Change data type (Page 226) 4. FEB. select the Participants column as the dividend.ARIS MashZone Note The characters can be combined in any order. Example For your data feed. Insert the Arithmetic operator into the feed definition. Click on the lower anchor point ( element. yy and yyyy return 2009. b. y can be specified any number of times. the language must also be set so that the name of the month will be displayed correctly.3. a. Click on Calculation in the Operators bar. however. Click on the Arithmetic operator. b.e. Hold down the mouse button and drag the mouse pointer to the upper anchor point ( ) of the Arithmetic element. a. The operator is inserted into the feed definition. 2.) and <3 if it is specified as a figure. a. the participation rate relative to the number of registrations is to be calculated.

3. 33 . The calculation rule for calculating the participation rate ParticipationQuota is defined. f. g. the additional column ParticipationQuota is displayed with the corresponding values. Click on the Display calculation result button ( the Arithmetic element to check your settings. enter ParticipationQuota. to which the columns (except the key column) from the second table are added. As soon as individual key values in both columns match. Click on the Operator selection box before Registrations and select divided by (/) as the operator. ) in the header of Example: Calculation of the ParticipationQuota quotient 4. and its values are individually compared with one another. the associated rows are assigned to one another and merged. Click on the Add row ( ) button. and the second table is linked to the upper right anchor point. One of the two tables is defined as the main table. d. In the results table of the data feed.5 Combine data feeds You can combine different data feeds with one another. In the new editable selection box. e. In the editable Target column selection box. The ParticipationQuota column with the corresponding values is added to the data feed.ARIS MashZone c. enter the value 100 as the factor. 4. The upper left anchor point of the Combine data feeds element is reserved for the main table. Click on the Operator selection box before 100 and select times (*) as the operator. A key column is defined for each table. The Combine data feeds operator can be used to link two data feeds (or tables) with one another.

b. For example. Click on Data feeds in the Operators bar. which contains the same values in both tables. 4. The operator is inserted into the data feed definition. Click on the lower anchor point ( ) of the Arithmetic element. Continent. In order for the values in the columns of the two tables to be correctly assigned to one another. Click on the Combine data feeds operator. The Excel table contains the columns Region. The City column. which matches in the two City key columns. 6. a key column must be defined for both tables. Connect the Source: MS Excel file element to the Combine data 34 . hold down the mouse button and drag it to the required position in the workspace. ) of the Combine data feeds ) of the Source: MS Excel file ) of the Combine data feeds element. In the editable Left column and Right column selection boxes in the Combine data feeds element. a. the EMEA and Europe values are added to the Region and Continent columns of the data feed. insert the MS Excel table City_Regions. The values of the two key columns are compared with one another and tables are merged accordingly. b. 5. Procedure 1. If the individual values of both City columns match. Hold down the mouse button and drag the mouse pointer to the upper right anchor point ( element. As described in the Select data source (Page 27) chapter. and City. 3. b.xls. the associated values from the Region and Continent columns are added in the relevant rows of the data feed. a. is used as the key column. select the City column.ARIS MashZone Example The current data feed is to be merged with the Excel table City_Regions. 2. Hold down the mouse button and drag the mouse pointer to the upper left anchor point ( feeds element. Connect the Arithmetic element to the Combine data feeds element. a. for the value Vienna.xls as a data source. Click on the lower anchor point ( element. Insert the Combine data feeds operator into the feed definition.

ARIS MashZone Example: Combine data feeds Note In the Options for the Combine data feeds operator.  Allow multiple values Includes key values that occur multiple times and have different assigned values. 35 .  Include key values of both data feeds Includes the key values of both data feeds. the city Vienna is assigned to the continent Europe in one data feed and to the continent Middle Europe in the other. Both entries are included in the City column.  Include identical key values of both data feeds Includes only the key values that match in both data feeds. you can specify which key values from the two key columns are to be included. even if these are only contained in one of the two key columns. Example For example.  Include key values of left data feed Includes only the key values of the left data feed (main data feed). regardless of the key values of the right data feed.

Procedure Connect the Combine data feeds element to the Output element. Hold down the mouse button and drag the mouse pointer to the upper anchor point ( ) of the Output element. Example The Combine data feeds operator completes the required feed definition and it can be finished. 36 . Tip You can check the results of your feed definition for correctness by calculating the result and displaying it in a table (Page 28).ARIS MashZone Note Since the individual table columns are identified by name when being imported you need to ensure that the columns of the table area to be imported have unique names. It is the final element of a feed definition. Note The Output element is automatically inserted by default when creating a new data feed and cannot be deleted. ) of the Combine data feeds Your feed definition is finished.3. 4.6 Finish feed definition You must finish the feed definition for the result of the data feed calculation to be output. Click on the lower anchor point ( element. 1. The mandatory Output operator is available for finishing the feed definition. 2.

ARIS MashZone Example: GreenCar Roadshow participants data feed 37 .

click on More and select Share. Procedure 1.1. and share it with other users. On the MashApps tab. Display the Share tab. The user has the same privileges as the creator of the MashApp. Note Users automatically receive the same privileges as the group to which they are assigned. 5. Please select a subentry. 3. click on Share in the program bar of the design view. Display the Home page.1 Use MashApps The following chapters describe general use cases relating to the use of MashApps. Below the preview. edit. 5.  Edit The user can open. 5.1 Share MashApp You can share MashApps so that they can be viewed and edited by particular users and user groups. Tip Use e-mail templates to predefine the notification text (Page 88). and delete a MashApp. Prerequisite You have the Edit user privilege. 2. If you have already opened the MashApp in the composer. You can automatically notify the relevant users by e-mail about the MashApps being shared. 4. but cannot edit or delete it. select the MashApp you want to share. 38 .ARIS MashZone 5 Procedure The following chapters describe some basic general procedures in ARIS MashZone. User privilege  Display The user can open a MashApp and filter it interactively.

Click on Save shares and send e-mail to inform the relevant users about the shares. Only e-mail addresses of users whose e-mail addresses are stored in ARIS MashZone (Page 74) will be entered in the address line. 8.  Publish Users can publish a MashApp with guest access (Page 41). enable further options under Privileges for users with view privilege. 7.  Pass on view privilege Users with the view privilege can share the view privilege for this MashApp with other users. If you clicked on Save and send e-mail your standard e-mail program opens and you can edit and send the notification.ARIS MashZone 6. if required. 10. 39 . 9. Click on Save to apply your settings.   No e-mail application is installed. The privileges you have assigned are applied to the selected groups or users. and operating system you are using). Tip Under Privileges for users with view privilege you can assign more privileges to users with view privilege. display the Group or User tab to assign privileges to particular groups or users. The number of e-mail addresses and/or the e-mail text is too large (depending on the Web browser. e-mail program. The users are informed about the share by e-mail. which means that all users can display a MashApp without logging in to ARIS MashZone. Under certain circumstances. We recommend that you reduce the number of e-mail addresses and/or the amount of e-mail text in the e-mail template. The e-mail text is displayed in the language that you used for logging in to ARIS MashZone. no e-mail program is displayed.  Create copy A user can create copies of a MashApp for editing. Enable the required options in the Display or Edit columns for a group or a user. If required. On the Share tab. Note The notifications are sent via your standard e-mail program.

5. Open a MashApp (Page 12). the data from the data feeds assigned to the MashApp is displayed. Tip You can delete multiple MashApps simultaneously (Page 89) in Administration. if required. Administration privileges are a prerequisite. Below the preview. Display the Home page. On the MashApps tab. Prerequisite You have the appropriate edit privileges. 5. A MashApp can consist of several views.1.3 Display MashApp view You can display the individual views of a MashApp. The selected MashApp is deleted from the list of available MashApps. The user implicitly receives the privilege to view the data from these data feeds in the context of the shared MashApp.1. Tip Export the MashApp to create a backup copy. the View privilege for data feeds linked to the MashApp is not explicitly required. 40 . 3. click on More and select Delete. Procedure 1.ARIS MashZone  Access to data from assigned data feeds When you open a MashApp. you can assign particular users to individual groups. Warning Deleted MashApps cannot be restored. Procedure 1.  In the User management module of the Administration component. select the MashApp you want to delete. Note  To open a MashApp. 2. The individual views are displayed independently on separate tabs.2 Delete MashApp You can delete available MashApps.

Note Not all functions are available if you are displaying a MashApp with guest access. 5. Prerequisite Your ARIS MashZone license includes at least the Professional edition. Display the MashApp view (Page 40) you want to save as an image. 2. 7. 3. Open a MashApp (Page 12).5 Save MashApp view as image You can save MashApp views as images in png and jpg format. Display the MashApp view (Page 40) you want to print. Procedure 1.1. Click on More in the program bar and select Print. The selected MashApp view is displayed. 3. Select a folder in which you want to save the file. Click on the title of the tab of the view you want to display. 4. 5. 4.6 Publish a MashApp with guest access You can share MashApps with any user via guest access. The displayed MashApp view is saved in the format you selected. The displayed MashApp view is printed. No login is required to display the MashApp. Procedure 1. Click on Save. Click on OK. 5. 6. 2. 41 . Users with guest access can display such a MashApp without logging in to ARIS MashZone in their Web browser. Open a MashApp (Page 12).4 Print MashApp view You can print displayed MashApp views. 5.1. Click on More in the program bar and select Save as image. you provide an anonymized MashApp URL that users can enter directly in their browser. Specify the required settings.ARIS MashZone 2. Specify the required settings. To do this.1.

Click on Copy to clipboard.ARIS MashZone Prerequisite You have installed the ARIS MashZone Enterprise or Event edition. Below the preview. Below the preview. 2. 5. 3. Prerequisite You have installed the ARIS MashZone Enterprise or Event edition. 10. click on Share in the program bar of the design view. 2. Enable the option No frame if you want to display the MashApp without the application frame. you can embed the MashApp in a Web page. click on Share in the program bar of the design view. click on More and select Share. Enable the option No login so that the user can display the MashApp without logging in with user name and password. you can provide other users with the URL address so that they can display the MashApp directly in their browser without logging in to ARIS MashZone. select the MashApp you want to share. If you have already opened the MashApp in the composer. for example. Display the Link to MashApp tab. Enable the option Direct link to MashApp to obtain the MashApp address in the form of a URL. Display the Home page. Display the Home page. On the MashApps tab.1. Procedure 1. 9. 3. 7. Procedure 1. You have the Publish user privilege (Page 38). Display the Link to MashApp tab. If you have already opened the MashApp in the composer. 42 . 8. 5. 4. 4. The created MashApp address is copied to the clipboard and can be made available to any user. select the MashApp you want to share. click on More and select Share. On the MashApps tab. For example. Select the language in which you want to display the MashApp.7 Copy MashApp address to clipboard You can generate the address of a MashApp as a URL or iframe and copy it to the clipboard. 5. With the iframe addresses. 6.

Base URL http://[servername]:[port]/mashzone/app/Viewer.html Example http://localhost:16360/mashzone/app/Viewer. 7. Enable the option No frame if you want to display the MashApp without the application frame. Prerequisite The ARIS MashZone server of the client that provides the MashApp must be started. Use the character = to add the parameter values. Note To use this option. 11.1. Procedure 1. Enable the option Direct link to MashApp to obtain the MashApp address in the form of a URL. Launch your Web browser. Enable the option No login so that the user can display the MashApp without logging in with user name and password. Select the language in which you want to display the MashApp. 10. 43 . To obtain the MashApp address as iframe enable the option Embed in Website (iFrame). you need the Publish privilege (Page 38). 5. 2.ARIS MashZone 6.html?<Parameter 1>=<Value1>&<Parameter2>=<Value2>&. Enter the relevant MashApp URL in the address bar of the Web browser in this form: http://[servername]:[port]/mashzone/app/Viewer. To do so you need to specify the required parameters of the MashApp in addition to the base URL. Click on Copy to clipboard. 8. 9. The created MashApp address is copied to the clipboard. You can add the parameters with the character ? to the base URL and link the individual parameters with the & character.8 Call MashApps via URL You can call a MashApp by entering the relevant URL in the Web browser..html?guid=9c303861-60 10-40ea-9e70-0916bae4fab3&tabidx=2&language=en&plainmode=tr ue&user=system&password=manager Tip A list of parameters (Page 299) is available in the appendix..

5. click on the Zoom out ( ) buttons.9 Set display size You can adjust a MashApp to meet your requirements. Click on the Fit to window ( ) buttons to adapt the MashApp view to the size of the current browser window. Various buttons in the footer are available for this. This extracts the data from the cache and refreshes the individual display components.1. ) ) or Zoom in ( 5. Note If the user data is incorrect or if the ARIS MashZone session is inactive the ARIS MashZone login page is displayed. 5. 4.11 Display MashApp properties You can display and edit the properties of a MashApp. Click on Refresh all data in the footer of the MashApp. 2. Alternatively. hold down the mouse button and drag the slider ( toward Zoom out ( ) or Zoom in ( ). All data is imported again and the display components are refreshed accordingly.ARIS MashZone The MashApp you specified is displayed in your Web browser.10 Refresh data You can refresh the data evaluated in the MashApp currently displayed. Procedure 1. 44 . 3. Click on 100% to restore the default display size. Display a MashApp (Page 12). The display size is adapted to the size of the current browser window. Tip In ARIS MashZone. 2. Procedure 1.1. The display size of the MashApp is modified in line with your settings. you can display the URL of a MashApp and copy it to the clipboard (Page 42).1. In the footer of a MashApp.

Procedure 1. Procedure 1. Specify the required settings. The change history is displayed. 4. Prerequisite Your ARIS MashZone license includes at least the Professional edition.1. Prerequisite You have the appropriate edit privileges. Open a MashApp (Page 12). and history are displayed. author. and keywords of the MashApp.12 Display history of a MashApp You can monitor the change history of a MashApp. Procedure 1. Display a MashApp (Page 12). 3. you can edit the names. click on More and select Properties. description. Your changes are applied. Display the Home page. Select a MashApp on the MashApps tab. the internal ID.ARIS MashZone Under Properties. Below the preview. action. 2. Click on Display history in the footer. 5. and comments for all changes to the MashApp. In addition.1. 45 . You can also configure whether a prompt for entering a comment is displayed when saving a change. The change history shows you the time. the installed ARIS MashZone edition. the last change. 2. Note This option is only available for particular display components. Tip The change history is also available in the composer (Page 48).13 Save display component as image You can save individual display components of a MashApp as images in png and jpg format. 5.

If multiple data feeds are assigned to the display component you can select a data feed from a selection box.1. 2. Multiple parameters can be configured for the CSV file to be created. The button Display menu ( 3. The display component is saved in the image format you selected. The data of the display component is shown in the form of a table. Click on the Display menu ( 4. 5. The data is shown in form of a table whose contents you can sort and format.14 Display data of a display component as a table You can display the currently calculated feed data for individual display components. Prerequisite Your ARIS MashZone license includes at least the Professional edition.ARIS MashZone 2. ) button and select Save as image. 6. 5. ) is displayed in the top right corner.15 Save data of a display component as a CSV file You can save the currently calculated feed data for individual display components in CSV format. The button Display menu ( 3. 7. 5. Click on Save.1. Click on OK. Click on the Display menu ( ) is displayed in the top right corner. ) button and select Display data. Note This option is only available for particular display components. Open a MashApp (Page 12). Procedure 1. Specify the required settings.  Separator Separates individual column values  Masking character 46 . Move the mouse pointer over the display component whose data you want to view. Select a folder in which you want to save the file. Move the mouse pointer over the display component that you want to save as an image.

ARIS MashZone Protects the enclosed characters against being split at the separator.. Click on the Display menu ( ) is displayed in the top right corner. Prerequisite Your ARIS MashZone license includes at least the Professional edition. Procedure 1. semicolon" If the text contains a selected masking character. The button Display menu ( 3. ) button and select Save as CSV. Exceptions: If the text contains the selected separator the entire text is enclosed by the selected masking character. semicolon -> "The text contains a . If column values contain the specified separator. e. 2. Format data types in the CSV file Data type Text Formatting Same formatting as in the data feed. they can be enclosed in a pair of masking characters. Example The text contains a .23". Note   This option is only available for particular display components.  Character set Character set to be used for encoding the CSV file If multiple data feeds are assigned to the display component you can select a data feed from a submenu. "1. Example The text contains a " quotation mark -> "The text contains a "" 47 . Open a MashApp (Page 12). Move the mouse pointer over the display component that you want to save as an image. This option is available only if the assigned data feed is complete and without errors.g. the entire text is enclosed by the selected masking character and the inner masking characters are doubled. The data of the display component is saved in a CSV file.

You can freely place.ARIS MashZone Data type Formatting quotation mark" Figure No decimal separator Thousand separator ". inserting various display components (Page 16). which you can use to configure a MashApp.  In the design view.78 Date ISO 8601 Example 2009-06-30T18:30:00 5. various diagram types.2.2 5. You can insert the individual display components into a MashApp using the Display components bar at the left edge of the design view. A MashApp can consist of any number of views." Example 123456. (Page 22)  In the preview (Page 25) you can display the MashApp with real data. you can design the layout of a MashApp by creating several MashApp views (Page 51).  In data mode (Page 17) you assign individual display components the data that will be displayed in the MashApp and set filter criteria for this data. and setting the display (Page 52). Design view The design view provides you with a large number of components for visualizing (Page 16) data to enable you to design a MashApp. e. The MashApp composer provides you with various functional modes.. You can insert any number of display components in each MashApp view. and input boxes. traffic lights.g. tables.1 Create and edit MashApps Use composer You can use the MashApp composer to create your own MashApps (Page 49) and to edit existing MashApps (Page 14). each of which is displayed as a tab. and adjust the layout of the different display 48 . scale.

ARIS MashZone components.2.2 Create MashApp You can create new MashApps and design them to meet your requirements. color saturation. various style templates are available. 49 . A corresponding pop-up menu is available for each display component. font. which you can use to set that display component. The style templates essentially differ in terms of color. Note New components inserted to which you have not yet assigned any data are indicated by an empty frame or a schematic display as a placeholder. shadow or reflection effects.. When creating a new MashApp. Display components to which data has been assigned are displayed schematically using corresponding demo data in the design view and are labeled Demo data.g. and effects. which you can use to to assign a particular uniform appearance for all display components to your new MashApp. e. Example: Design view of Green Car Roadshow MashApp 5.

ARIS MashZone Tip You can assign a different style template (Page 60) to the MashApp later. 3.3 Copy MashApp You can create a copy of a MashApp with a different name. 7. 3. Select a style template and click on OK. Click on OK. Open a MashApp in the composer design view (Page 14).2. 5. The composer opens and a window for selecting a style template is The Properties dialog is displayed. Give the new MashApp a name of your choice. You can assign your own style templates to display components (Page 52) regardless of the style template of the MashApp. If necessary. 5. Tip You can adapt the MashApp to meet your requirements (Page 14). The MashApp is saved under the name you specified and opens in the composer. click on the New button ( ) in the title bar of the design view to create a MashApp. 4. The composer is displayed with a blank MashApp. Click on OK. If you have already opened the composer. 50 . Click on Save ( ) in the title bar. Procedure 1. Give the new MashApp a name of your choice. 4. The new MashApp is created with the specified name and is available on the Home page. click on the Create new MashApp button ( displayed. enter a description and keywords. ). If necessary. enter a description and keywords. Click on the Save as ( ) button in the title bar. Prerequisite You have the appropriate privileges for editing or copying (Page 38) the MashApp. 5. On the Home page. Procedure 1. 6. 2. 2.

ARIS MashZone 5. click on the Properties button ( ). Click on the Delete tab button ( ) in the pop-up menu. 5. In addition to the view displayed. move the mouse over the title of a tab. 2. The selected tab is deleted from the current MashApp. Specify a name for the MashApp view. This MashApp is no longer available for viewing to the user but can be displayed via a link (Page 54). The pop-up menu of the tab title is displayed.2.2. Procedure 1. move the mouse over the title of the relevant tab. A MashApp view is displayed as a separate tab.2. In the design view (Page 48). Tip Disable the Display tab option to hide the tab in the MashApp. and specify whether you want the view to be available in the MashApp through a tab. The individual views are displayed independently on separate tabs. In the pop-up menu of the tab title. 2.6 Format MashApp view You can configure a MashApp view. The pop-up menu of the tab title is displayed. Procedure 1. 2. Procedure 1. set the background and tab title color. 51 . ) in this pop-up menu.5 Delete MashApp view You can delete any views from a MashApp.4 Add MashApp view You can add additional views in a MashApp. In the design view (Page 48). A MashApp can consist of several views. In the design view (Page 48). move the mouse over the title of the relevant tab. a new view is created and displayed as a 5. Click on the New tab button ( tab.

Set the Tab color for the view. move the mouse over the title of the relevant tab. When you duplicate a view. The pop-up menu of the tab title is displayed. 2. This MashApp is no longer available for viewing to the user but can be displayed via a link (Page 54). 6.2. a column chart or a table.ARIS MashZone The Properties dialog is displayed. and the color. and a frame that surrounds the component. dynamic links. 52 . colors or labels. Set the Background color for the view.g. e. A display component consists of the component itself. and selections are retained. 4. 5. 5. Move the slider with the mouse to set a gradient.. In the design view (Page 48). the text.g. Enter a text of your choice as the name of the view in the Name box. settings. and dependencies. b. 3. all content. Click on the color selection field next to Marker and select the relevant color. The duplicate is inserted next to the selected view.8 Format display component You can specify settings for the display of the individual display components.. e. in which you can set the view display. Your settings are applied and displayed immediately. such as filters.2. Click on the color selection field to set the background color of the view. Procedure 1.7 Duplicate MashApp view You can duplicate individual MashApp views. the component. a. Disable the Display tab option if you do not want the tab to be displayed in the MashApp. 5. Use the pop-up menu of a display component to set the properties of the frame. Click on the Duplicate tab button ( ) in the pop-up menu.

Procedure 1. 2. Click on the Frame button ( ) to set the frame properties. Example The setting options are described here using the example of a column chart.. 4. a column chart. or click on the Set button (. Click on the button for the displayed component.g.) to adapt the style. Enter a Name for the component (column chart). Select the scope of the elements to be displayed in the Visibility selection box. a.. the frame of the Input box display component is not displayed by default. Some options are preset for certain display components. Legend.. to display it in the component.g.. b. c. e. Enable the Display title option to display the name as the title. Enable an option.) to select the individual elements. Tip For certain elements.ARIS MashZone Note Different setting options are available depending on the type of display component selected. and specify your settings. Prerequisite You have opened a MashApp in the composer (Page 14).. Shadow. or Zoom. e. e. c. Enable the Display frame option and specify your settings. which can then be displayed as the title in the title bar of the display component.g. Column chart ( ) to set the component properties.g. Assign a style template to the component here and specify the elements of the component to be displayed. Select a style template in the Style selection box. Click on the Formatting button ( the component ) to set the font and the colors of 53 . b... e. 3. Click on an inserted display component in the design view. or click on the Set button (. A corresponding pop-up menu is displayed.. a. the pop-up menu provides you with style templates or color palettes. which you can assign to those elements. Set the title and the frame of the display component.

Select a color palette you want to assign to the data points of the component in the Data points selection box. Click on an inserted display component in the design view. You can also open a particular MashApp view (Page 40) and select predefined data for a certain display component. Click on Colors and set the colors individually..g.. 5. b. data in a table or an area on a map. This means that if necessary you can use an action to set an indirect filter for a display component. Procedure Display page Note You can enter _blank as the target window to display a linked page in a new window. each page will be opened in a new window. the column sequence in tables. you receive information on the individual data points of the component. Select a color palette you want to assign to the elements of the component in the Colors selection box. the columns in the chart are selected. traffic lights. this component is filtered accordingly. d. For example.9 Specify link You can assign links to certain display components (e. You have the option of displaying any page using a URL. Your settings are applied. For subsequent actions. e. 1.ARIS MashZone a. In this case. the elements include the chart axes or gridlines. each new page will be opened in the same window. which are run by clicking on the display component. c. and text).g. e. Tip If you double-click on a display component you can change certain components. Select the elements of the component for which you want to set a label in the Label selection box and specify your settings.2. Tip If the defined data also represents filter values for another component. You can enter the name of your choice for the target window to open a linked page in a new window.g. Prerequisite You have opened a MashApp in the composer (Page 14). For subsequent actions. images. In addition. 54 .

ARIS MashZone

A corresponding pop-up menu is displayed. 2. Click on the Specify link button ( ).

The Specify link window is displayed. 3. In the Links bar, enable the Call external URL option to display a page linked by the URL as an action. 4. Enter the URL of the relevant page in the URL input box. 5. In the Window name input box, specify the window of your Web browser in which the page is to be displayed. Open MashApp view 1. Click on an inserted display component in the design view. A corresponding pop-up menu is displayed. 2. Click on the Specify link button ( ).

The Specify link window is displayed. 3. In the Links bar, enable the Change to tab option to display a particular tab in the MashApp as an action. If you do not enable the option and define a selection, the selection relates to the current tab. 4. Select the tab you want to be displayed in the selection box. 5. Click on Define selection in the Links bar to display a particular selection on the tab to be displayed. The Define selection window is displayed. 6. In the left pane, select a display component whose data you want to display as a selection. 7. In the right pane, select a Coordinate in the component. The choice of coordinates depends on the component type. A coordinate can be a column or table, an axis in a chart, or an area on a map. 8. In the Selection input box, specify the data to be selected in the display component. 9. Click on the Add button ( ) if you want to define another selection. 10. Click on Apply filter. Your settings are saved. The Define action window is displayed.

5.2.10

Move to front or back
You can move a display component to the front or back of a MashApp. For example, you can display an image in the background of the MashApp and place several components on top of it, i.e., in the foreground.

55

ARIS MashZone

Prerequisite You have opened a MashApp in the composer (Page 14). Procedure 1. Click on an inserted display component in the design view. A corresponding pop-up menu is displayed. 2. Click on the Send to back button ( 3. Click on the Bring to front button ( components. The display component is displayed at the front or the back in the MashApp. ) in the pop-up menu to show the ) in the pop-up menu to display display component behind one or more other display components. the display component in front of one or more other display

5.2.11

Delete display component
You can delete a display component from a MashApp. Prerequisite You have opened a MashApp in the composer (Page 14). Procedure 1. Click on an inserted display component in the design view. A corresponding pop-up menu is displayed. 2. Click on the Delete display component button ( menu. The selected display component is deleted from the current MashApp. ) in the pop-up

5.2.12

Duplicate display components
You can copy any display components of a MashApp including its settings and links. The copied display components can be pasted in any view of the same or any other MashApp. When copying multiple display components any dependencies between the display components copied are retained. Any dependencies between display components that were copied and those that were not copied are also retained if the components not copied are already available at the location where you copy the components to (either on the same tab or in the same MashApp, in case it is a master component). Dependencies between components that you do not copy into another MashApp are lost.

56

ARIS MashZone

Note The display components are copied using the clipboard. If you exit the composer, the display components you have copied are deleted from the clipboard and can no longer be pasted. Prerequisite You have opened a MashApp in the composer (Page 14). Procedure 1. In the design view, select the display components that you want to copy. a. Click on a display component. b. To select multiple display components press the Ctrl key and click on the individual display components. You can also draw a selection frame around the relevant display components. 2. Copy the selected display components to the clipboard by simultaneously pressing the Ctrl and C keys. 3. Paste the display components copied into the MashApp view. a. Paste display component in a view of the MashApp currently open. 1. Display an existing tab or add a new tab (Page 51). 2. Simultaneously press the Ctrl and V keys to paste the display components you copied to the clipboard. If you add a new tab the display components copied are automatically pasted. b. Paste display component in a new or existing MashApp. 1. To create a new MashApp (Page 49) click on the New ( button in the toolbar. 2. Open an existing MashApp by clicking on the Open ( in the toolbar. 3. Display an existing tab or add a new tab (Page 51). 4. If you add a new tab the display components copied are automatically pasted. The copied display components are pasted in the MashApp view selected. ) button )

5.2.13

Apply style
You can apply a display component's style to another display component.

57

ARIS MashZone

Note   If target and source component are of the same type all styles of the source component are applied to the target component. If the types differ, only the border styles are transferred. In addition to styles, the settings of the options Visible border and Display title of the source component are applied. Exceptions   Styles are not transferred for individual columns for the Table components. Only border styles are transferred for the Google Maps component.

Procedure 1. Open a MashApp in the composer design view (Page 14). 2. Click on an inserted display component. A corresponding pop-up menu is displayed. 3. Click on Apply style in the pop-up menu. 4. Click on a display component to which you want to apply the style. 5. Click on OK. The display component is displayed with the style assigned.

5.2.14

Automatically refresh data
For the individual display components, you can set if and in which time interval data is to be extracted from the associated data feed. The data is refreshed and displayed in the display component. Note Use the cache time of the relevant data source to set (Page 67) the time interval for reimporting data from the data source into the data feed cache. Prerequisite You have opened a MashApp in the composer (Page 14). Procedure 1. Click on an inserted display component in the design view, e.g., a column chart. A corresponding pop-up menu is displayed. 2. Click on the button for the displayed component, e.g., Column chart ( ) to set the component properties.

58

ARIS MashZone

3. Click on Date retrieval. 4. Enable the Refresh option. 5. Select the refresh interval from the selection box. You can choose either 1, 5, 15, 30, or 60 seconds for the time interval. 6. If required, select a Load activity icon. Your changes are applied. Tip In data mode, you can assign data to a display component (Page 17).

5.2.15

Set display size
You can set the display size for the current MashApp in the design view. Set the zoom factor to improve the clarity of a MashApp in the design view. Procedure 1. Open a MashApp in the composer design view (Page 14). 2. Set the zoom factor of the display in the footer of the composer. a. Click on the Zoom out ( ) or Zoom in ( ) buttons.

b. Alternatively, hold down the mouse button and drag the slider ( ) toward Zoom out ( ) or Zoom in ( ). c. Click on 100% to restore the default display size. The display size of the MashApp is adjusted accordingly.

5.2.16

Set gridlines
You can set the gridlines in the background of the design view. The gridlines help you to arrange the individual display components more easily. You can deactivate the grid, hide the gridlines, and set their spacing. Note By default, the gridlines are displayed with a spacing of 10 pixels and the display components are automatically aligned to them. Procedure 1. Open a MashApp in the composer design view (Page 14). 2. Click on Grid settings in the composer footer. 3. Disable the Use grid option to deactivate the grid. 4. Set the Spacing of the gridlines in pixels. 5. Disable the Display grid option to hide the gridlines.

59

ARIS MashZone

Your changes are applied.

5.2.17

Use master view
In the master view of a MashApp, you can insert display components (Page 16) and edit them to be displayed in every existing and new view (Page 51) of the current MashApp. Use the master view to insert background images and logos in a MashApp or define global filters valid for all MashApp views, for example. Note You can only edit and delete the display components in the master view. Procedure 1. Open a MashApp in the composer design view (Page 14). 2. Click on Master view in the composer footer. 3. The master view of the current MashApp is displayed. 4. Specify the required settings. 5. Click on Close master view in the composer footer. The inserted display components are displayed in the existing and new views of the MashApp.

5.2.18

Change style template
You can assign a different style template to an available MashApp. When you create a MashApp (Page 49), the MashApp is assigned a style template that you can change later. Warning If you assign a new style template, formatting settings that have already been specified will be lost. Procedure 1. Open a MashApp in the composer design view (Page 14). 2. Click on Change style template in the composer footer. 3. Select a style template. 4. Click on OK. The MashApp is assigned the selected style template.

5.2.19

Change MashApp name
You can change the name of a MashApp later.

60

3. 5.21 Assign keywords to a MashApp You can assign a list of keywords of your choice to a MashApp. Open a MashApp in the composer design view (Page 14). 4. Select a term from the selection box or enter a MashApp context-relevant term. Your changes are applied. Enter additional terms. Click on Properties in the composer footer. 6. 3. Procedure 1. Use keywords to find MashApps and data feeds easily in the search and the list of most frequently occurring keywords. 5. 61 . Click on OK. Open a MashApp in the composer design view (Page 14). Click on OK. 4. Enter a text of your choice as a description of the MashApp in the Description box. Your changes are applied. 4. Move the mouse pointer over the Keywords box. 5. Open a MashApp in the composer design view (Page 14). 2.ARIS MashZone Procedure 1. Your changes are applied. Click on Properties in the composer footer. Tip Use the same keywords for your MashApps and the associated data feeds in order to make finding them easier. Click on Properties in the composer footer. Enter a text of your choice as the name of the MashApp in the Name box.20 Change MashApp description You can enter a description for a MashApp. if required. 2.2. Click on OK. 2. 3. Procedure 1. 7. An editable selection box is displayed.2. Press Enter to confirm your entry.

enter a value in the Debug value input box. Procedure 1. If required. Note Any amount of user input can be inserted in a feed definition. The default value is used if the user does not provide any input. 5. Please select the required chapter. If required. The debug value is used if a test calculation is performed within the feed editor. b. The debug and default values are optional. Open a data feed (Page 65) or create a new data feed (Page 26). enabling a user to manually enter data in a MashApp. 3.3 Use data feeds The following chapters describe general use cases relating to data feeds.1 Use user input You can use user input to insert interfaces into a data feed. Link the inserted user input to an operator. Enter the name of your choice in the Name input box of the User input element. The user input is inserted into the feed definition. 62 . Click on a user input in the User input bar. You can also specify a Debug value and a Default value. ) of an operator. Click on an outgoing anchor point ( ) of the User input element. 4. 2. Click on a user input in the User input bar. Insert a user input into the feed definition. a. 6. a. The names of the individual user input must be unique within the feed definition. hold down the mouse button and drag the user input to the desired position in the feed definition. enter a value in the Default value input box. which can then be processed directly in the data feed. Hold down the mouse button and drag the mouse pointer to an incoming anchor point ( Note Permitted anchor points for the selected element are indicated by a green arrow head.ARIS MashZone 5.3. b. 5.

ARIS MashZone Links between user input and operators are indicated by blue connections. 63 .3 Share data feed You can share data feeds so that they can be viewed and edited by particular users and user groups. User privilege  Display The user is allowed to use a data feed in a MashApp.3. 7. Click on Properties in the feed editor footer. The appendix provides a list of available user input (Page 286). The user has the full range of privileges enjoyed by the original creator of the data feed. 5. The data of the user input is forwarded to the linked operator. 4. Enter a text of your choice as a description of the data feed in the Description box. You can inform the relevant users by e-mail about the data feeds being shared.  Edit The user can open. edit. and share it with other users. Tip Use e-mail templates to predefine the notification text (Page 88). and delete a data feed. 5. Procedure 1. If required. Open a data feed in the feed editor (Page 65).2 Change data feed description You can enter a description for a data feed. Tip You can enter data in a MashApp by inserting an input box and defining the input box as a filter criterion for a data feed (Page 22). 2. 3.3. click on an anchor point to remove an existing link. Click on OK. Your changes are applied. Note Users automatically receive the same privileges as the group to which they are assigned.

The users are informed about the share by e-mail. click on More and select Share. and operating system you are using). Only e-mail addresses of users whose e-mail addresses are stored in ARIS MashZone (Page 74) will be entered in the address line. Click on Save to apply your settings. The number of e-mail addresses and/or the e-mail text is too large (depending on the Web browser. 3. If required. e-mail program. We recommend that you reduce the number of e-mail addresses and/or the amount of e-mail text in the e-mail template. Click on Save and send e-mail to inform the relevant users about the shares. The e-mail text is displayed in the language that you used for logging in to ARIS MashZone. Procedure 1. if required. 64 .ARIS MashZone Prerequisite You have the Edit user privilege. 9. Tip Under Privileges for users with view privilege you can assign more privileges to users with view privilege. 5. 8. 6. 2. Below the preview. 7. 4. Note The notifications are sent via your standard e-mail program. select the data feed you want to share. Under certain circumstances. click on Share in the program bar. The selected groups or users are assigned the privileges you have selected. Display the Home page. If you have already opened the data feed in the feed editor.   No e-mail application is installed. On the Data feeds tab. no e-mail program is displayed. Enable the required options in the Display or Edit columns for a group or a user. The Share dialog is displayed. enable further options under Privileges for users with view privilege. If you clicked on Save and send e-mail your standard e-mail program opens and you can edit and send the notification. Display the Group or User tab to assign privileges to particular groups or users.

3. 65 . 3. 5.5 Edit data feeds You can use the feed editor to edit available data feeds and tailor them to your requirements. Tip Export the data feed (Page 90) to create a backup copy. Tip You can delete multiple data feeds simultaneously (Page 89) in Administration. Prerequisite You have the Edit user privilege. 5.ARIS MashZone  Pass on view privilege Users who only have the view privilege can share the data feed with other users. Prerequisite You have the appropriate edit privileges. Procedure 1. activate the Data feeds tab. On the ARIS MashZone Home page. Click on Delete below the preview.3. if required. Warning Deleted data feeds cannot be restored.4 Delete data feed You can delete available data feeds. On the Data feeds tab. The selected data feed is deleted from the list of available data feeds. Procedure 1. 2. Note In the User management module of the Administration component.  Create copy A user can create copies of a data feed for editing. you can assign particular users to individual groups. Display the Home page. select the data feed you want to delete. Administration privileges are a prerequisite.

or freely available data from the Internet. 2. Click on the Save ( ) button. The data can come from different sources and is combined and calculated using operators (Page 70).6 Copy data feeds You can create a copy of an available data feed with a different name.ARIS MashZone 2. 5. Note Different setting options and anchor points ( ) for connections are available depending on the type of data source.3. feed definitions are used to calculate the data of a data feed (Page 4). Procedure 1. Your changes are applied. queries from data warehouses. If necessary. but remains in its original sources. Enter your changes. The feed editor opens with the corresponding feed definition. 4. CSV. The data feed is saved under the name entered and opens in the feed editor. or XML files. Give the new data feed a name of your choice. 66 . The source data is not held redundantly in the data feed. analysis results from ERP or CRM systems. Open a data feed in the feed editor (Page 65). Based on the data sources. 3. 5.7 Use data sources You can insert one or more data sources into your feed definitions (Page 4). 5. Open a data feed (Page 65) or create a new data feed (Page 26). Click on the Save as ( ) button in the title bar. Click on OK.3. Possible data sources include Excel. 4. ensuring that it is constantly up to date. 3. Procedure 1. enter a description and keywords. Prerequisite You have privileges for editing or copying (Page 63) the data feed. Select a data feed and click on Edit ( ) below the data feed preview.

the data from the data source is re-imported into the cache and the data feed is recalculated. 67 . Link the inserted data source to an operator. insert more data sources into the feed definition and link the elements to one another. The cache time indicates the time interval during which the data in the cache is to remain valid. Note To be able to select source files by specifying the path. you can use user input (Page 62) to enter data in the data feed. a.g. The data of the data source is forwarded to the linked operator. 5. The appendix provides a list of available data sources (Page 197). Specify your settings for the data source (Page 71). or any subdirectory resources\<directory>. you must store them in a defined resource directory on the ARIS MashZone server (by default the resources directory in the ARIS MashZone installation directory). b. 5. ) of an operator. Insert a data source into the feed definition. Permitted anchor points for the selected element are indicated by a Tip In a feed definition. Alternatively. click on an anchor point to remove an existing link. If the cache time is exceeded. a. b. hold down the mouse button. Click on an outgoing anchor point ( ) of the data source. The data source is inserted into the feed definition. 6. CSV file. Click on a data source. e. and drag the data source to the desired position in the feed definition. 3. in the Data sources bar. click on a data source in the Data sources bar. If required.. Hold down the mouse button and drag the mouse pointer to the incoming anchor point ( green arrow head.3. Tip Copy your source files to the resources directory of your ARIS MashZone installation. 4.ARIS MashZone 2. If you wish.8 Refresh data cache You can set the cache time for various data sources. in addition to the data sources.

c.3. hold down the mouse button and drag the slider ( ) toward Zoom out ( ) or Zoom in ( ). Set the zoom factor of the display in the footer of the feed editor. Click on OK. Click on the Zoom out ( ) or Zoom in ( ) buttons. Select a time interval from the selection box under Cache time. Open a data feed in the feed editor (Page 65). 5. 3. Set the zoom factor to improve the clarity of a feed definition in the editor view.3. 2. Click on 100% to restore the default display size.9 Zoom editor view You can set the display size of the currently displayed feed definition in the editor view. 2. Insert a data source into the feed definition (Page 27). Procedure 1. which you can use to create and edit feed definitions without any programming knowledge.        MS Excel (xls) CSV files XML files ARIS PPM webMethods Optimize webMethods Broker JDBC Procedure 1. 68 . The Select source dialog is displayed. 4.ARIS MashZone You can set the cache time for the following data sources.10 Use feed editor ARIS MashZone provides a feed editor as a graphical user interface. Alternatively. b. Click on the Select source button after the Source input box. The display size of the feed definition is adjusted accordingly. a. 5. Your changes are applied.

open an existing data ). and User input (Page 62) bars. ). you will find the Data sources (Page 66). In the footer. save changes to the currently open data feed ( currently open data feed under a different name ( On the left-hand side of the editor. you can create a new data feed ( feed ( ). set the properties. Example: Feed editor with Green Car Roadshow participants feed definition. and you can use the elements in these to define the data feeds in the workspace. you can use the frame to display any section of the feed definition by moving the frame using the mouse.ARIS MashZone In the title bar. you can zoom the feed definition (Page 68) display. or save the ). and display the results table and the change history (Page 73). 69 . In the Overview bar. Operators (Page 70).

The corresponding operators are displayed in the bar. 3.g. 3. Calculation.ARIS MashZone 5. each operator returns a data structure in the form of a list table and forwards this to the operators linked by the connections. extend.11 Change data feed name You can change the name of a data feed later.g. into the feed definition. As the result. A feed definition can consist of any number of operators. which are linked together using connections.3. another operator or a data source. Note Different setting options and anchor points (e.g. Click on an operator in the bar. 5. Click on OK. Open a data feed in the feed editor (Page 65). The operator is inserted into the feed definition. Procedure 1.3. Procedure 1. a. 4. b. Insert an operator. b.. hold down the mouse button and drag the operator to the desired position in the feed definition. ) of an element. Your changes are applied... Hold down the mouse button and drag the mouse pointer to the incoming anchor point ( ) of the inserted operator.g. Click on Properties in the feed editor footer. Click on an operator in the bar.12 Use operators You can use operators to aggregate. an aggregation. Link the inserted operator to existing elements. or calculate data in feed definitions (Page 4). 2..g. Open a data feed in the feed editor (Page 65). Click on one of the operator groups in the Operators bar. Enter a text of your choice as the name of the data feed in the Name box. e. available depending on the type of operator. transform. e. a. 2. e. Click on an outgoing anchor point ( operator. an ) for connections are 70 . 4. e.

Procedure 1. Specify your settings for the inserted operator. The data of the linked element is forwarded to the inserted operator. Insert an MS Excel file in your feed definition as the data source (Page 27). b. 5. Open a data feed in the feed editor (Page 65). Example Setting the source data is described here for an Excel data source as an example.3. c. Tip You can view the raw data of the source file (Page 72). insert more operators or data sources into the feed definition and link the elements to one another. Click on the Configure columns button next to Options in the MS Excel file element to select the columns to be extracted. Click on a row in the New name column and enter a name to be used in the data feed instead of the original name of the column. Click on an anchor point to remove an existing link. 6. which you can then use as a basis for specifying settings for the source data. Note Different options are available for setting the source data depending on the data source type. Select the columns of the source file to be extracted. 8. 71 . 5. 3. 7. The Configure columns dialog is displayed. Enable the Type as text option if the corresponding column content is to be used as text.13 Set source data For each data source. which you can adapt according to your requirements. If you wish. Link an operator to the Output element to finish the feed definition (see Finish data feed (Page 36) chapter). a.ARIS MashZone Permitted anchor points for the selected element are indicated by a green arrow head. 2. you can specify the data to be extracted. Tip The appendix provides a list of available operators (Page 220). The feed editor provides predefined default values for each data source.

6. Click on the Sheet selection box and select the worksheet of the Excel file that you want to extract. 7. 5. ) button in the header of the 72 . 4. e. The default value is 2.g. C5 and H8. 5. The rows and columns between the specified coordinates are extracted. 2. Open a data feed in the feed editor (Page 65). The data to be evaluated is extracted starting from the specified row of the Excel table.14 Display raw data You can display the raw data of the data source to view its content and original structure. Enable the Column name from row option and enter a value. Procedure 1. Click on Options to display or hide the options that can be set in the bar as required. For example.. Example The following example shows the raw data of the Excel file Roadshow_Stops. The default value is 1..3. The first worksheet of the Excel file is set by default.. Click on the Display raw source data ( Calculation result bar. The column titles of the data feed are taken from the data in the corresponding row of the Excel table. Enable the Extract data from row option and enter a value. Click on OK. 8. Enable the Use data range from. in this case from column C to column H and row 5 to row 8.. option and enter the coordinates of table cells. Display the calculation result of an inserted data source (Page 28).ARIS MashZone d. The original data of the data source is displayed. The first row contains the column title and the data that can be evaluated starts from the second column..to.xls. The source data is set and is extracted according to your settings. 3.

3.3. author. Open a data feed in the feed editor (Page 65). Open a data feed in the feed editor (Page 65). action. 5.15 Assign keywords to a data feed You can assign a list of keywords of your choice to a data feed. Enter additional terms. Select a term from the selection box or enter a MashApp context-relevant term. 6. Click on OK. Move the mouse pointer over the Keywords box. Procedure 1. The change history shows you the time. 4.ARIS MashZone Example: Raw data of extracted Excel file 5.17 Display data feed properties You can display and edit the properties of a data feed. The change history is displayed. if required. 5. and keywords of the data feed. the installed ARIS 73 . Your changes are applied. In addition. 2.3. the internal ID. Press Enter to confirm your entry. 5. description. 3. Procedure 1. Click on Display history in the feed editor footer. 2. An editable selection box is displayed. you can edit the names.16 Display change history of a data feed You can monitor the change history of a data feed. Click on Properties in the feed editor footer. Under Properties. and comments for all changes to the data feed. 7.

Click on Administration in the program bar. 4. Display the Home page. 6. 2. 5. Special characters are not allowed for user name and password.ARIS MashZone MashZone edition. e-mail addresses and function privileges to them.4 5. The page for managing users is displayed. Specify the required settings. Specify the required settings. 3. 4. Click on User management. 2. Procedure 1. Display the Home page. passwords. Your changes are applied. 3.1 Manage ARIS MashZone Manage users Create user You can create new users and assign user names.1 5. Prerequisite You have administration privileges (Page 76). Activate the User tab. Below the preview. and history are displayed. 5. Click on the Create ( ) button. 74 . the last change. ARIS MashZone Administration opens.4. You can also configure whether a prompt for entering a comment is displayed when saving a change. Prerequisite You have the appropriate edit privileges.4.1. Note The number of users you can create depends on your license key (Page 87). click on More and select Properties. Procedure 1. Select a data feed on the Data feeds tab.

Note Special characters are not allowed for user name and password. In the Password input box. Procedure 1. 3. 5. In the Login input box.ARIS MashZone a.g. enter a password. In the E-mail input box. assign function privileges and assign users to certain groups. enter a user name. Prerequisite You have administration privileges (Page 76). Display the Home page.1. 5. 4. 75 . 7. The page for managing users is displayed. Specify the user's first name and last name. c. which the user can use to log in to ARIS MashZone. Select a user in the list and click on the Edit button ( 6. 5. Enter your changes. Click on User management. ). or Admin to assign the user the relevant function privilege.2 Manage users You can change settings for existing users at a later time. b.4. e.3 Delete users You can delete users from ARIS MashZone user management. Click on Save. Activate the User tab. 2. specify an e-mail address for the user.4. The user is created and is displayed in the list. Click on Save. e. Note You need to share the resource directories (Page 85) that the new users may access. Editor. Your changes are applied.1. d. ARIS MashZone Administration opens. 7. Click on Administration in the program bar. which the user can use to log in to ARIS MashZone. Enable the options Active.

5.ARIS MashZone Note If you delete a user who is the last processor of a MashApp or data feed. 76 . Activate the User tab.4. The page for managing users is displayed. ARIS MashZone Administration opens. Note If you assign new members to a group they do not automatically receive the group's function privileges.4 Assign users to particular user groups You can assign individual users to one or more user groups (Page 78). Warning Deleted users cannot be restored. Select a user in the list and click on the Delete button ( 6. Display the Home page.1. 2. Click on User management. Click on User management. Click on Administration in the program bar. The page for managing users is displayed. 3. You need to assign the function privileges to all members (Page 81) again. Procedure 1. 3. the executing administrator is automatically entered as the last processor. Prerequisite You have administration privileges (Page 76). ). Activate the User tab.e. The user has been deleted from the user list. 5.. Click on Administration in the program bar. 4. 4. Prerequisite You have administration privileges. ARIS MashZone Administration opens. 2. Display the Home page. Procedure 1. the administrator inherits the privileges for displaying and editing the MashApps or data feeds of the deleted user. Click on Yes to confirm. I.

2. The group is created and is displayed in the list with its name. Display the Home page. 7. The page for managing user groups is displayed. ARIS MashZone Administration opens.ARIS MashZone 5. Click on User management. Under Assigned groups. 77 . Click on the Create ( ) button. Note If you assign new members to a group they do not automatically receive the group's function privileges. 5. click on the Remove group button ( remove an assigned group. Click on Assign groups. you can assign certain function privileges to all group members or withdraw these privileges from them. click on the Assign group button ( assign the user to a particular group. 8.5 Create user groups You can create multiple user groups. 9. You can specify settings for the user here. Click on Save.4. Select one or more groups you want to assign to the user. 7. Prerequisite You have administration privileges (Page 76). ) to ) to 5.1. 6. Select a user in the list. 10. 11. Specify the required settings. You need to assign the function privileges to all members (Page 81) again. 6. In user groups. Procedure 1. Under Assigned groups. Activate the Groups tab. Click on the Edit user button ( ). The user is assigned to the specified group or removed from this group. 4. 3. Click on Save. Click on Administration in the program bar.

3. Click on Administration in the program bar.6 Edit user groups You can change user group settings.4.ARIS MashZone Note You need to share the resource directories (Page 85) that the new user groups may access. Activate the Groups tab. Click on User management. Display the Home page.4.1. Enter your changes. 5. Click on User management.7 Delete user groups You can delete existing user groups from ARIS MashZone user management. Warning Deleted groups cannot be restored. Click on Administration in the program bar. Select a group in the list and click on the Edit button ( 6. ARIS MashZone Administration opens. Procedure 1. 4. 3. 2. 7. 5. ). 78 . The page for managing user groups is displayed. Change the name of a group or assign all members of a group particular function privileges or withdraw these privileges from them. Your changes are applied. Click on Save. Prerequisite You have administration privileges (Page 76). Activate the Groups tab. Prerequisite You have administration privileges (Page 76). Display the Home page.1. ARIS MashZone Administration opens. 4. Procedure 1. 5. 2.

3. their groups are not automatically imported. The page for managing LDAP users and user groups is displayed. 79 . Based on the current LDAP configuration (Page 305) (umc. Newly imported users and groups are added to the existing ones. all users and groups are imported (filter = *). Click on Yes to confirm. Click on Administration in the program bar. as well. a. Activate the LDAP tab. During user import. Click on User management. Procedure 1. 4. You can perform the import multiple times with different filters. ARIS MashZone imports new users and user groups and updates those already imported. If required. Select a group in the list and click on the Delete button ( 6.ARIS MashZone The page for managing user groups is displayed. For the import. User management lists ARIS MashZone users and imported LDAP users. Users and user groups no longer existing in the LDAP system must be deleted manually (Page 80) from the ARIS MashZone user database. you can specify one filter each for the user name and the group name. Prerequisites You have administration privileges (Page 76).4.1. ARIS MashZone Administration opens.8 Import LDAP users and user groups You can import users and user groups from your LDAP system to ARIS MashZone and update the data of already imported LDAP users. The group has been deleted from the list. To import all users or groups. ). 5.properties (Page 306)) and the specified name filters. LDAP users and LDAP groups are identified with a blue L in the symbol. 5. their users are imported. If you do not want to import users or user groups the corresponding field must not contain any characters. 2. In contrast. specify a Filter for user name and Filter for group name. The LDAP connection is activated (see Configure LDAP connection (Page 305)). when importing user groups. 5. Display the Home page. enter *. By default.

6. Prerequisite You have administration privileges (Page 76). Click on Import.1.4. ARIS MashZone Administration opens.9 Delete LDAP users and user groups You can delete all users and user groups imported from the LDAP system or only those that no longer exist in the LDAP system from the ARIS MashZone user database.. To assign these users access privileges for ARIS MashZone you need to activate them. LDAP users and user groups are imported into the ARIS MashZone user database in line with the LDAP configuration (Page 305). You can activate each user individually or all users of a user group at the same time (Page 81). i. 5. Procedure 1. Note  Users who were imported from the LDAP system to ARIS MashZone for the first time are deactivated by default. Note All LDAP users and LDAP user groups are deleted only if the LDAP connection has been disabled. 3. Click on User management. Click on Delete. Leave the box empty if you do not want to import any users or groups. they cannot log in to ARIS MashZone. 2.e. Display the Home page. 80 . Click on Administration in the program bar.ARIS MashZone b. Activate the LDAP tab. 4.  You need to share the resource directories (Page 85) that the new users and user groups may access. Tip Detailed information on the LDAP connection is provided in the chapter Configure LDAP connection (Page 305). 5. If the LDAP connection is activated only those users and groups are deleted that no longer exist in the LDAP system (see chapter Configure LDAP connection (Page 305)).

too.1. 3. Note MashApps and data feeds with a deleted user being the only user with the edit privilege automatically become the charge of the administrator who triggered the deletion. Tip Detailed information on the LDAP connection is provided in the chapter Configure LDAP connection (Page 305). Click on Administration in the program bar. 5. too. 81 . ARIS MashZone Administration opens. 2. Notes The function privileges Active and Editor are only available in the Enterprise and Event editions. you assign function privileges to or withdraw them from all members of a group at the same time. Admin: The user receives the privileges of Active and Editor.10 Set function privileges You can assign certain function privileges to individual users and user groups and withdraw them again. For user groups. Procedure 1. Editor: The user also receives the privileges Create and edit (prerequisite for Admin). Display the Home page.ARIS MashZone Depending on the configuration of the LDAP connection.    Active: The user is activated and receives display privileges for ARIS MashZone (prerequisite for editor). and is Administrator. Click on User management. Prerequisite You have administration privileges (Page 76).4. The following function privileges are available. Set function privileges of individual users You can assign function privileges to individual users and withdraw them again. the relevant LDAP users and user groups are deleted from the ARIS MashZone user database.

The page for managing users is displayed. Select a user in the list and click on the Edit button ( 6. Activate the Groups tab. 5. 6. The page for managing user groups is displayed. You need to assign the function privileges to all members again. Display the Home page. 5. Activate/deactivate all users   Activates/deactivates all current members of the group Withdraws the privileges Editor and Admin from the current members of the group Assign all users the privilege Editor or withdraw it from them  Assigns all current and active members of the group the privilege Editor 82 . Procedure 1. you assign the group the relevant function privileges or withdraw them from it. Click on Save. ). Set function privileges of a user group You can assign certain function privileges to all group members or withdraw these privileges from them. Enable the relevant function privileges. By clicking on the relevant buttons. Activate the User tab. Click on User management. 7. All group members have the selected function privileges or the function privileges have been withdrawn from them. 3. Your changes are applied. Click on Administration in the program bar.ARIS MashZone 4. Note If you assign new users to a group (Page 76) they do not automatically receive the group's function privileges. Select a group in the list. ARIS MashZone Administration opens. 4. 2. You can assign user groups the following function privileges.

The specified network drives must be connected with the computer on which you are running ARIS MashZone.4. Procedure 1. \\computer name\ARIS MashZone resources).g. C:\My ARIS MashZone resources) or as UNC paths for network drives (e.1 Set server Create resource directory You can create new resource directories and share them with particular users and groups.2 5. Note The default resource directory is the resources directory in your ARIS MashZone installation directory. 4.g. ARIS MashZone Administration opens. which can be extracted by data feeds. 2.2. 3. Tip Copy your source files to a resource directory or a corresponding subdirectory. Display the Home page.ARIS MashZone  Withdraws the privileges Editor and Admin from all current members of the group Assign all users the privilege Admin or withdraw it from them   Assigns all current and active members of the group the privilege Admin Withdraws the privilege Admin from all current and active members of the group 5. You also need the read privilege for accessing the network. The resource directories contain data source files.4. Prerequisite You have administration privileges. 83 . You can specify the paths to resource directories as local paths (e. Click on Server settings. Click on Administration in the program bar. Display the Resource directories tab.

ARIS MashZone Administration opens. Display the Home page. 84 . 10. You can specify the paths to resource directories as local paths (e. The new resource directory is created and is displayed in the list with the specified alias. 11. Enter your changes. Click on Save shares. 2. Note The default resource directory is the resources directory in your ARIS MashZone installation directory.g. Display the User or Group tab. 8. Click on Administration in the program bar. Enter the Path of the new resource directory. 3. Click on the Create button ( ) to create a new resource directory. 7. 6.4.2. Tip Copy your source files to a resource directory or a corresponding subdirectory. The specified network drives must be connected with the computer on which you are running ARIS MashZone. The resource directory is shared with the selected users and groups. Procedure 1. \\computer name\ARIS MashZone resources). Prerequisite You have administration privileges. 4.ARIS MashZone 5. Give the directory a name of your choice in the Alias input box. 9.g. Click on Save. Note You cannot modify the alias name later. Enable the option Share for the relevant users or groups. 5.2 Change resource directory You can adapt the alias and path of already existing resource directories. The Share resource directory dialog is displayed. Click on Server settings. You also need the read privilege for accessing the network. C:\My ARIS MashZone resources) or as UNC paths for network drives (e.

Enter the Path of the resource directory. Click on Administration in the program bar. Tip You can share existing resource directories with particular users (Page 85). 6.4 Share resource directory You can share resource directories with particular users and user groups so that these have access to the directory content. Display the Home page. You have administration privileges. Click on Administration in the program bar.4. Display the Resource directories tab.3 Delete resource directory You can delete existing resource directories. 5. 85 . Display the Home page. Procedure 1. Procedure 1.4. Display the Resource directories tab. 5. 5. Prerequisite You have the Enterprise edition. Select a resource directory in the list. ARIS MashZone Administration opens. Prerequisite You have administration privileges. 6. 2. Select a resource directory and click on the Edit button ( 7. Click on Save.ARIS MashZone 5. 2. Click on the Delete button ( Your changes are applied. 4. ) to remove a directory from the list. Your changes are applied.2. ).2. users with administration privilege can access all resource directories. Note Regardless of the share. 3. Click on Server settings. 8.

5.2.ARIS MashZone ARIS MashZone Administration opens. Note Depending on your proxy server.4. Click on Administration in the program bar. 6. ARIS MashZone Administration opens. Click on the Share button. 8. If required. 2. 10. The resource directory is shared with the selected users and groups. 7. 3. 4. 3. Click on Server settings. 5. Display the Resource directories tab. Enter the port number of your proxy server in the Port input box. enter the user name you use to log in to your proxy server in the User input box. Select a resource directory. Enter the name of your proxy server in the Proxy server input box. 6. 4. Procedure 1. Display the Home page. 9. specify the computer names or domain names to be excluded from proxy server access separated by a semicolon.5 Change proxy server settings You can change the settings for your proxy server. The Share resource directory dialog is displayed. To obtain the required user name and password contact your system administrator. 7. Click on Server settings. 86 . Enable the option Share for the relevant users or groups. 5. you might have to log in. Display the Proxy server tab. 8. Enable the Use proxy option. Prerequisite You have administration privileges (Page 76). Click on Save shares. If required. enter the password you use to log in to your proxy server in the Password input box. In the No proxy for input box. 9. Display the User or Group tab.

3. If you use license keys of different editions the later version is applied only when the number of users of that version is higher than or the same as the number of users of the older version. 2. Note Entering multiple identical license keys adds to the maximum number of uses permitted for each license key. and only license keys pertaining to earlier editions are specified. Click on the Add new license key button ( 5.4. ARIS MashZone Administration opens. and data feeds or MashApps exist that were created or edited with the newer edition. Enter a valid license key. ARIS MashZone automatically switches to safe mode. Display the Home page. Click on Add. ). Click on Administration in the program bar. 5.7 Enter Google Maps key If you want to use the Google Maps display component you need to enter an API key registered with Google Maps in ARIS MashZone. Tip You can delete an existing license key by selecting a license key in the list and clicking on the Delete license key button ( ).2.6 Add license key You can add new license keys to your ARIS MashZone license and delete existing license keys. Your new license key is saved and added to the list. Your settings are applied. 5. 6. If a license key has been deleted or has expired. Warning You cannot use data feeds and MashApps from newer editions in older editions. Procedure 1. Click on Licensing.4.2. Click on the Save ( ) button. only user management and licensing pages are available. In safe mode. 4. 87 .ARIS MashZone 11.

6. you can notify the relevant users by e-mail. specify your personal Google URL signing key here.2. 3. The e-mail text is displayed in the language that you used for logging in to ARIS MashZone. 7. Client IDs are provided to all Google Maps API Premier customers and developers applying for using Places Web services.500 queries/day) for feed calculation. Display the Google Maps API key tab.4. Enter a valid Google Maps API key in the Google Maps API key input box.  You receive your personal Google URL signing key together with your client ID. Display the Home page. Tip  In server settings. 2. The notification is sent via your standard e-mail program and contains the text defined in the e-mail template. When sharing a MashApp or data feed. 5. ARIS MashZone Administration opens. Prerequisite You have administration privileges (Page 76). which will be automatically replaced by the corresponding data. Enter a valid Google URL signing key in the Google URL signing key input box. You can also add placeholders in the text.ARIS MashZone If you want to use the Geocoding operator without restrictions (more than 2. Click on the Save ( ) button. click on Register for Google Maps API on the Google Maps tab to register with Google Maps and receive a valid API key.8 Edit e-mail templates You can customize the templates of the e-mail notifications for shared MashApps (Page 38) and shared data feeds (Page 63). 4. The keys you enter are saved and you can use the Google Maps display component and the Geocoding operator without restrictions. Placeholders available 88 . Click on Administration in the program bar. Click on Server settings. 5. Procedure 1.

You have administration privileges (Page 76). 6.1 Manage MashApps/data feeds Delete data feeds/MashApps In the ARIS MashZone Administration. 10.ARIS MashZone      [mashapp. 3. Click on Administration in the program bar.Name of the shared data feed [feed.Description of the shared MashApp [feed. 7. Click on Server settings.name] . If you want to insert a placeholder click on the corresponding position in the text. 4.4.3.Description of the shared data feed Prerequisite You have installed at least the ARIS MashZone Professional edition. you can delete individual or multiple MashApps and data feeds.name] . Tip To display the default text in the e-mail again. ARIS MashZone Administration opens.description] . The e-mail text is displayed in the language selected. Display the Home page. 9. In the Language selection box.link] . 5. 5.Name of the shared MashApp [mashapp. 8. Display the E-mail templates tab. 2. Click on the Save ( ) button.Link to the shared MashApp [mashapp. Enter any text in the Subject and Body input boxes. Procedure 1. 89 . Your changes are applied. In the Templates selection box select the MashApp or data feed template you want to configure. select the language for the e-mail notification.3 5.4.description] . Click on the button of the relevant placeholder. click on Restore default text.

2.3. The selected data feeds and MashApps have been deleted. A message on the deletion procedure is displayed. Prerequisite You have the appropriate edit privileges. 10. 3. 90 . Click on OK. Tip Export the MashApps and data feeds (Page 90) to create a backup copy.ARIS MashZone Warning Deleted MashApps and data feeds cannot be restored. Note The option List only MashApps or data feeds that do not match the ARIS MashZone license is available only in safe mode (Page 305). Click on Delete below the Existing data feeds column. Display the Delete tab. Click on the Delete all button to delete from the database all MashApps and data feeds shown in the list. Display the Home page. 11. Click on Import/Export/Delete. if required. Click on OK.2 Export data feeds/MashApps You can export your data feeds and MashApps and provide them to other users. A message on the deletion procedure is displayed. Procedure 1. Click on Delete below the Existing MashApps column. 9. Select the MashApps to be deleted in the Existing MashApps column. Use this option to list MashApps and data feeds that cannot be used with the current ARIS MashZone license. 4. Click on Administration in the program bar. 6. Select the data feeds to be deleted in the Existing data feeds column. ARIS MashZone Administration opens. 5.4. Tip You can also delete individual MashApps (Page 40) and data feeds (Page 65) on the start page Home. 8. 7. 5.

A separate archive file (F_*. Click on OK.3 Import data feeds/MashApps You can import individual or all available data feeds and MashApps into ARIS MashZone. 2. 9. 10. Tip Click on Export all to export all MashApps and all data feeds.mzp Procedure 1.4. 7.mzp) is created for each exported data feed. Use this option to list MashApps and data feeds that cannot be used with the current ARIS MashZone license. Select the data feeds to be exported in the Existing data feeds column. You will see a message about the export procedure. Click on Import/Export/Delete. 5. 5. Click on Export below the Existing data feeds column. 8. Click on OK.mzp Note The option List only MashApps/data feeds that do not match the ARIS MashZone license is available only in safe mode (Page 305). The selected data feeds and MashApps have been exported. Click on Export below the Existing MashApps column. Display the Export tab. Example F_Demo GreenCar Roadshow Participants_22_20091104-09-57-37. Click on Administration in the program bar. 4. 3.3.ARIS MashZone Note The default import/export directory importexport is located in your ARIS MashZone installation directory. You will see a message about the export procedure. 6. 91 . Exported data feeds are saved using the following name convention: F_<Data feed name>_<Revision>_<Date>-<Time>. Select the MashApps to be exported in the Existing MashApps column. ARIS MashZone Administration opens. Display the Home page.

8. Select the relevant file format in the selection box. Warning If you overwrite existing data feeds during the import. 92 . 5. Click on Administration in the program bar.mzp) and MashApp archive files (M_*. Click on OK. 11. 10. 2. Procedure 1. Click on OK.mzp Example F_Demo GreenCar Roadshow Participants_22_20091104-09-57-37. The Notes dialog informs you on possible import conflicts. Display the Import tab. A separate archive file (F_*. The list displays the content of the importexport directory depending on the selected file format.mzp) is created for each exported data feed. ARIS MashZone Administration opens.ARIS MashZone Note The default import/export directory importexport is located in your ARIS MashZone installation directory. Select the data feeds or MashApps that you want to import. Display the Home page. 4. The selected import process is performed. they are irreversibly lost. 7. Exported data feeds are saved using the following name convention: F_<Data feed name>_<Revision>_<Date>-<Time>. 6.mzp) that you want to import into ARIS MashZone to the importexport directory of your ARIS MashZone installation. The Select file dialog is displayed. Click on Import/Export/Delete. 9.mzp Tip Copy all data feed archive files (F_*. Click on Import all again to confirm the action. 3. The Notes dialog informs you on possible import conflicts. Click on Import to import individual data feeds and MashApps. Click on Import all to import all data feeds and MashApps in the importexport directory.

 At the connection level AutoCommit = true readOnly = true transactionIsolationLevel  At the statement level QueryTimeout = variable MaxRows = variable = TRANSACTION_READ_COMMITTED. ARIS MashZone does not come with database drivers.4. Please contact your system administrator for more information. Copy the relevant JDBC driver file to the directory jdbcdrivers of your ARIS MashZone installation. two versions of a database driver). Procedure 1.1 Set database connections Install database drivers Before you can use a database connection in ARIS MashZone you need to provide the required database drivers in ARIS MashZone. Stop the ARIS MashZone server and restart it if it has already been started.4 5.  You cannot simultaneously use multiple different database drivers using the same URL syntax in ARIS MashZone (e.4.g.  For license reasons. Note To ensure proper functioning of the ARIS MashZone database interface (Page 215) with the JDBC driver the installed driver must support the following configurations and interfaces.4. To connect MS Access databases we recommend that you use commercial drivers. The database drivers are now available in ARIS MashZone.ARIS MashZone 5. %MASHZONE_HOME%\jdbcdrivers 2. Note  ARIS MashZone currently supports JDBC database connections that require system-specific JDBC drivers. TRANSACTION_READ_UNCOMMITTED or driver default setting 93 .

3. Prerequisites Your ARIS MashZone license includes at least the Professional edition. specify the number of allowed simultaneous database connections. d. Click on Database connections. two versions of a database driver). a. Note You cannot simultaneously use multiple different database drivers using the same URL syntax in ARIS MashZone (e. Enter the address of the database in the Database URL box. b. 94 . Click on the Create ( ) button. Using database connections.2 Create database connection You can create connections to one or multiple databases in Administration. Suitable database drivers are available in ARIS MashZone (Page 93). e. Select an installed database driver (Page 93) in the Driver selection box.4. select the time after which connection establishment is canceled if no connection is established. Please contact your system administrator for more information. Specify the required settings. c. 4. data feeds access the corresponding databases as a data source. In the Connection timeout box. Click on Administration in the program bar.g. You have administration privileges (Page 76). Procedure 1. 5.ARIS MashZone FetchSize = 2000 or MaxRows-1(if MaxRows < FetchSize)  MetaData of Resultset returns TableName ColumnCount ColumnName ColumnType 5.4. Give the connection a name of your choice in the Alias input box. In the Pool size box. 2. You cannot modify the alias later. Display the Home page.

Using database connections. Procedure 1.4. data feeds access the corresponding databases as a data source. Click on Database connections. activate.4. 2. 6. You have administration privileges (Page 76). Specify the required settings. Click on Save. Display the Home page.3 Change database connection You can change. Click on the Edit ( ) button. 7. 95 . Click on Test database connection. Click on Administration in the program bar. 5. or deactivate existing database connections in Administration. Tip You can test the created database connections for proper functioning. 6. Your changes are applied. Tip You can test the created database connection for proper functioning. Prerequisite Your ARIS MashZone license includes the Enterprise edition. g. 3. Warning Changes in database connection properties can immediately affect data feed calculations so that they may not execute properly. The database connection is created and is displayed with its alias in the list. Click on Test database connection. Enable the Active option if the database connection is to be available in ARIS MashZone. 4.ARIS MashZone f. Select a database connection. Click on Save. Note You cannot modify the alias later. select the time after which the database query is canceled if the database does not respond. In the Query timeout box. 5.

4. The instance caches the events published there in an internal memory. Select one or more database connections. 6. A so-called real-time buffer server acts as an interface. In ARIS MashZone administration you can configure the interface in line with your requirements. 96 . Each real-time buffer server is connected to an ARIS MashZone server.4 Delete database connection You can delete existing database connections in Administration. Click on the Delete ( ) button. The real-time buffer server receives data from webMethods Broker and provides it to ARIS MashZone. Click on Administration in the program bar. You cannot undo the deletion process. Click on Database connections. Confirm the deletion process by clicking on Yes. A real-time buffer server can have a limited number of real-time buffer instances. 4. Warning Deleting database connections can lead to data feed calculations accessing the database in question not being executed any longer. The method how events are saved in the real-time buffer follows specific strategies that can be selected. Each buffer instance is assigned a single topic of a particular webMethods Broker instance or a JMS provider instance. Procedure 1.4. 5. 3. 2. Prerequisite Your ARIS MashZone license includes the Enterprise edition. You have administration privileges (Page 76). To use the webMethods Broker interface you need to perform the following steps. Display the Home page.5 Configure webMethods Broker connection ARIS MashZone provides an independent interface that you can use to process data published by webMethods Broker and other JMS providers. 5. The selected database connections are deleted from the list.ARIS MashZone 5.4. The cached content of the real-time buffer is transferred upon request via HTTP to ARIS MashZone.

3. Configure EDA connection (Page 98) 3. Procedure 1. Start real-time buffer instance (Page 104) 5. you need to specify the basic settings of the real-time buffer server to configure an EDA connection and create a real-time buffer.5. enter any path to a local directory in which the configurations of the EDA connections are to be saved. Click on Save. Enter the path to the local Event Type Store in the Event Type Store base path input box. In the Path of EDA connections input box. ARIS MashZone Administration opens. Click on WebMethods Broker/JMS. Note Each configuration of an EDA connection is automatically saved in a separate file in the directory specified. To configure a real-time buffer server you must specify the Event Type Store and a directory for the configuration of the EDA connection. Your ARIS MashZone license includes the Event edition. You can configure your EDA connections (Page 98). 97 . 2. The real-time buffer server is configured.4. You have administration privileges (Page 76). Display the Home page. 5.1 Configure real-time buffer server First. Configure real-time buffer (Page 100) 4. 7. 4. Click on Administration in the program bar. Configure real-time buffer server (Page 97) 2. 6.ARIS MashZone Prerequisite You have installed the webMethods Broker interface (Page 293). Procedure 1. Activate the Basic settings tab.

5. The libraries must be saved in a path accessible for ARIS MashZone. The configuration of the EDA connection is created. See also Chapter EDA connections (Page 99) Create configuration of an EDA connection Procedure 1. Click on Administration in the program bar.  If you use webMethods Broker as a JMS provider the required configuration is preset. 7. 5. you can you alternative JMS providers. Edit configuration of an EDA connection You can modify existing configurations of EDA connections. a particular class of the provider-specific library. Alternative JMS providers In addition to webMethods Broker.2 Configure EDA connection Via an EDA connection. Activate the EDA connections tab. You also need to specify the InitialContextFactory. Click on webMethods Broker/JMS. Click on the Save ( ) button. 5. Display the Home page. Specify the required settings. a real-time buffer instance can receive the events (messages) published on a certain topic of a webMethods Broker instance. You specify the path in the Event bus library path input box. ARIS MashZone Administration opens. 3.4. To do so.ARIS MashZone Tip Click on Reload Event Type Store to reimport the contents of the Event Type Store. 6. Please refer to the provider's product documentation for further information. 98 . Note  The library and class required depends on the JMS provider you use. Click on the Create ( ) button. 4. 2. you need the provider's libraries.

4.1 EDA connection options You can set the following options for the configuration of EDA connections (Page 98). Connection Factory Name of the Connection Factory to be used for connecting to the JNDI provider. 2. Your changes are applied. e. ) button.4. EventFactory Specification: Mandatory Topic context Specifies the context for the topics that are addressed via this EDA connection. Enter your changes. webMethods Broker example wmjmsnaming://<broker>@<host>:<port> Specification: Mandatory JNDI provider user Name of the technical user for authenticating at the JNDI provider JNDI provider password Password of the technical user for authenticating at the JNDI provider Event bus library path Path to the libraries of the JMS provider used. Click on the Edit ( 3.ARIS MashZone Procedure 1. 5. any selection Specification: Mandatory InitialContextFactory Particular class of the library of the JMS provider used. Click on the Save ( ) button. Select a configuration of an EDA connection.g. Specification depends on the provider Specification: Mandatory JNDI provider URL URL to the JNDI Provider.2.5. Specification depends on the provider Specification: Mandatory Note You do not need to specify libraries for webMethods Broker. 99 . Specification depends on the JMS provider used. Configurable options Parameter Alias Description Unique name of the EDA configuration.

5.3 Delete configuration of an EDA connection You can delete existing configurations of EDA connections. Click on Administration in the program bar. 3. You have configured the real-time buffer server. 6. Display the Home page. Click on the Delete ( ) button.ARIS MashZone 5. Warning Deleted configurations of EDA connections cannot be restored.4. Procedure 1. Prerequisite You have administration privileges. 100 . Create and configure a real-time buffer instance Procedure 1. 2. ARIS MashZone Administration opens. Activate the EDA connections tab.5. You have administration privileges (Page 76).4 Configure real-time buffer You can create and configure multiple buffer instances for the real-time buffer server. Click on WebMethods Broker. Select an existing EDA connection. 5. 5. The selected configuration of the EDA connection is deleted. Display the Home page. Each buffer instance receives events published on a certain topic of a Broker instance and saves the published events in an internal memory. 4.4. See also Chapter Buffer options (Page 101) Prerequisite Your ARIS MashZone license includes the Event edition. You have configured (Page 98) at least one EDA connection. A real-time buffer server can have a limited number of buffer instances.

3. Copy real-time buffer instance You can copy existing configurations of real-time buffer instances and. 4. Select a buffer instance. Enter your changes. ARIS MashZone Administration opens. 7. 4. 2. Click on Administration in the program bar. 5. Note You need to save the buffer instance copied under a new name. if required. 2. Enter your changes. Click on the Edit ( 3.4.ARIS MashZone 2. Click on the Save ( ) button. 6.5. ) button. Click on the Create ( ) button. Your changes are applied. The real-time buffer configuration is created. Select a buffer instance. Your changes are applied. Click on webMethods Broker. Click on the Copy button. Specify the required settings.1 Buffer options You can set the following options for the buffer configuration (Page 100). Configurable options 101 . Click on the Save ( ) button. Activate the Buffer settings tab. Click on the Save ( ) button. 4. Procedure 1. Warning Changes in buffer instance properties can immediately affect data feed calculations so that they may not execute properly. Edit real-time buffer instance You can modify existing configurations of real-time buffer instances. Procedure 1. change the configuration.4. 5. 3.

Strategy Strategy that the real-time buffer uses for saving the events imported by webMethods Broker Specification: Mandatory Buffer FIFO strategy (first in-first out): The last events published on a topic are cached. any selection Specification: Mandatory Password Password to be used for authenticating the webMethods Events data source at the real-time buffer instance Specification: Mandatory Note You must specify the password when setting the data source in feed editor. Event type Indicates the type of the events published on the topic Specification: Mandatory Note The corresponding event schemas must exist as XSD files in the Event Type Store directory. 102 . Start buffer automatically Automatically starts the buffer instance when the ARIS MashZone server starts optional EDA connection Configuration of the EDA connection that the buffer instance uses to access webMethods Broker Specification: Mandatory Topic Name of the topic whose data the real-time buffer is to receive Specification: Mandatory Filter predicates Filters the events to be imported by webMethods Broker Specification: Optional Note Detailed information on this topic is available in the webMethods Broker documentation.ARIS MashZone Parameter Alias Description Unique name of the buffer instance.

number of dimension values Indicates the maximum number of different dimension values allowed Available only for the Buffer strategy and if the Consider dimension option is enabled Default value: 10 Specification: Mandatory 103 . with ts being an element of I. An event is valid if the current time of application is within the interval.e.ARIS MashZone Parameter  Capacity Description Maximum number of cached events Specification: Mandatory  Check validity Checks whether the saved events are valid in terms of current time of application (ta) and removes invalid events from the buffer. i. [ts <= ta < te). and te not being an element of I. Saves a separate event series for each dimension value Available only for the Buffer strategy Specification: Optional  Dimension attribute Indicates the event attribute whose value is used as a dimension value Available only for the Buffer strategy and if the Consider dimension option is enabled Specification: Mandatory  Max. Available only for the Buffer strategy Specification: Optional  Consider dimension Considers a particular dimension when saving events. The buffer contains only data events then.te). Available only for the Buffer strategy Specification: Optional  Preprocess heartbeats Empty events without data are filtered out.End time [ts .  An event has a time stamp in the form of a time interval (I) = Start time .   The current time of application is determined by the start time of the event received last.

An event with the command Insert is saved in the buffer. 104 .ARIS MashZone Parameter  Capacity per dimension value Description Indicates the maximum number of events allowed per dimension value Available only for the Buffer strategy and if the Consider dimension option is enabled Default value: 100 Specification: Mandatory Delta The real-time buffer is added to or deleted from the buffer based on the event ID and the event command. The connection to webMethods is interrupted and re-established. you can restart all buffers that had already been activated. Saved events of the buffer instance will be deleted. and the events saved in the buffer are deleted.5 Start real-time buffer instance For a real-time buffer instance to receive the relevant events from webMethods Broker you need to start the instance.5. Click on Administration in the program bar. Procedure 1. any existing event with the same ID is overwritten. ARIS MashZone Administration opens.  Event ID attribute Indicates the attribute that determines the event identification Available only for the Delta strategy Specification: Mandatory  Command attribute Specifies the attribute that determines the Insert or Remove command Available only for the Delta strategy Specification: Mandatory 5. An existing event is deleted from the buffer through a new event with the same ID and the command Remove. You can stop an activated buffer instance if it is supposed to stop receiving events. Display the Home page.4. Prerequisite You have administration privileges. If required. 2.

Activate the MashApps. 4. The buffer instance configuration selected is deleted. 5. 3. Procedure 1. 4. Click on webMethods Broker. ARIS MashZone Administration opens. Activate the Buffer settings tab.1 Submit ratings You can submit your own ratings for your available MashApps and data feeds. 5. The selected buffer instances are activated or deactivated. Select a buffer instance and click on the Stop button to deactivate the instance. ). Warning Deleted configurations of buffer instances cannot be restored. Select a buffer instance.5 Miscellaneous Please select a subentry. 5. It goes from poor 105 . Data feeds. 6. The rating is displayed by the number of stars ( (one star) to excellent (five stars).6 Delete real-time buffer configurations You can delete existing configurations of real-time buffer instances. 5. Prerequisite You have administration privileges. Select a buffer instance and click on the Start button to activate the instance. Click on Administration in the program bar. Click on the Delete ( ) button. 7.4.ARIS MashZone 3. Activate the Buffer settings tab. Click on the Restart button to reactivate all buffer instances.5. Click on webMethods Broker. 5. or All tab on the Home page. Display the Home page. 6.5. 2. Procedure 1.

) to remove the set d. Tip You can use ratings as an advanced search option (Page 106). enter one or more search terms. Note When importing MashApps and data feeds.5. Procedure 1. The MashApps and data feeds displayed are filtered immediately. Only those MashApps and data feeds rated with at least the selected number of stars will be displayed. 3. Click on a star ( rating. name or description.2 Use extended search You can further restrict the search (Page 10) for MashApps and data feeds by specifying search options. Click on the Clear rating filters button ( 106 . and five stars will be displayed.. 5. 2. e. separated by spaces. they automatically receive the date of the import as the last change time. Display the Home page. In the Search input box. only those MashApps and data feeds with three. Click on Search options to further restrict the search and set the search options. Select a MashApp or a data feed that you want to rate.   The Look in selection box lists particular parameters that can further filter the search results. Select a parameter in the Look in selection box. 3. click on a star ( ) after Rating below the preview.ARIS MashZone 2. For example. ) to set a rating. c. if you select three stars as the rating. Your rating is applied and displayed as the corresponding number of stars.  The Rating (Page 105) option restricts the search to the ratings submitted. To submit a rating. The Last change slider takes into account the date on which the MashApp or a data feed was last changed. four.g. The MashApps and data feeds are immediately filtered and displayed. Use the mouse to drag the Last change slider to the required period of time. b. a.

e. The About ARIS MashZone page provides you with information about the version and build number and the licensed ARIS MashZone edition. Display info area 1. Display the ARIS MashZone Home page. Tip You can use the Next (>) and Back (<) buttons to scroll between the individual news pages.5. 107 .3 Display help You can display the online help for ARIS MashZone. 2. The help is available on the ARIS MashZone Web pages. Procedure Display information about the ARIS MashZone version 1. 5.4 Display information on ARIS MashZone You can display general information about your current ARIS MashZone version and keep up to date with the latest news about ARIS MashZone. You can also call up the ARIS MashZone homepage from here. Click on About ARIS MashZone. The online help for ARIS MashZone is displayed in a separate browser window. The info area displays current news on ARIS MashZone. Display the ARIS MashZone Home page. news about ARIS MashZone in the ARIS Community or on currently available ARIS MashZone updates.g.ARIS MashZone The search is performed automatically based on your settings. Procedure Click on Help in the program bar. Only those MashApps or data feeds that match the set search criteria will be displayed. Click on Show ( ) in the News bar to show the bar. The info area is displayed. General information about your current ARIS MashZone version is displayed. Click on Logged in as in the program title bar. 2.5. 3. 5.

Procedure 1. Click on the Display carousel button ( The carousel view is displayed. 5. 2. or All tab on the Home page. you can scroll between the individual thumbnails of the MashApps and data feeds. 5. 3. 108 . The same functions are available to you in the carousel view as in the list view. Data feeds. Procedure 1.6 Change password You can change the password you use to log in to ARIS MashZone. The next time you start ARIS MashZone (Page 6) you can log in with your new password. 5. Click on Logged in as in the program title bar and then on Change password. 4. Click on OK. In addition.5. Enter your new password in the New password and Confirm new password input boxes.5 Use carousel view In addition to the list view. Double-click on a thumbnail to display the corresponding MashApp or data feed. 3. Activate the MashApps. The Change password dialog is displayed. Click on a thumbnail in the carousel view to center it.5. Enter your current password in the Old password input box. you can also display your available MashApps and data feeds in the carousel view. 2. Move the slider below the carousel to quickly scroll between the thumbnails. Tip Click on the Display list view button ( ) to return to the list view. ). 4. Your password has been changed.ARIS MashZone Click on Hide ( ) to hide the info area.

Click on Login. 3. You are logged off your current ARIS MashZone session and the login dialog is displayed. Note ARIS MashZone is currently available in German and English. An ARIS MashZone session automatically expires after one minute once the ARIS MashZone window is closed.ARIS MashZone 5.8 Log out You can log out of your current ARIS MashZone session. You are logged out of your ARIS MashZone session and can log in again. To change the interface language.7 Change language You can change the language of the ARIS MashZone user interface.5. 2. Note ARIS MashZone only allows one login per user per session. Procedure 1. 5. ARIS MashZone starts in the selected language. you need to log out of ARIS MashZone first and then log in again with the desired language.5. Click on the Language selection box and select the language in which you want the user interface to be displayed. before you close ARIS MashZone. Tip Log out of ARIS MashZone first. you will have to wait at least a minute before you can log in to ARIS MashZone again using the same user name. 109 . Procedure Click on Logged in as in the program title bar and then on Logout. Otherwise. Click on Logged in as in the program title bar and then on Logout.

With a slider. Please select a subentry.ARIS MashZone 6 Use cases The following chapters describe selected comprehensive use cases. For example. You integrate the source data in a data feed and link the data with the corresponding elements of the Google Maps display component. you can interactively display custom coordinates or any coordinates available on the Internet as points of interest (POIs). Create a data source (e. 6. the so-called points of interest (POIs) at particular coordinates.com. or routes in the maps provided by Google. User-defined POIs can be linked to any data and displayed interactively in MashApps.g. specify the following elements:    The geographical coordinates (longitudes and latitudes) of some capitals The names of the capitals The country and continent names where the capitals are located In the design view of the composer you configure the Google Maps display. Example The following simple example shows how to integrate Google Maps in a MashApp and how to select POIs from a list that will automatically be focused in Google Maps.1. Tip Numerous additional use cases are available in the Gallery at http://www. you select the control elements to be displayed and set the POI color scheme.1 Use Google Maps With the Google Maps display component (Page 156) you can integrate Google Maps in your MashApps and link any GPS data with the component. For example.. For example. a CSV file) with individual columns for the required elements of the POIs.1 Display coordinates in Google Maps This use case describes how you embed Google Maps in a MashApp and display placemarks. 110 . you zoom the displayed map and show pop-ups on each POI.mashzone. areas. 6.

In the feed editor. Save the data feed under a name.g. you can display other data on the POIs. e. You have installed the Google Maps API key in Administration (Page 87). The data feed is created and can be used for configuring a Google Map in a MashApp. select and display certain coordinates or configure the zoom factor. Note The coordinates must be entered in the data source as decimal values (decimal degrees). 2.g. 3. and configure the data source.g. Link the data source with the Output operator. a CSV file. Create a data feed (Page 26). Define data feed If you want to display POIs in Google Maps you need a data feed containing at least the longitude and latitude of the POI and also the name.google. 4.com/).ARIS MashZone In the composer's data mode. In addition. Google Maps POI. 111 . e. you can link more display components using special link points that you can use to control Google Maps. if required. you assign coordinates to the component and select the data to be displayed pertaining to the individual POIs. insert a data source with the required POI coordinates. Prerequisite You have installed at least the ARIS MashZone Professional edition. Procedure 1. In addition. e. Tip Detailed information on how to obtain GPS coordinates for POIs in Google Maps is available in the Google Maps user documentation (http://maps.

The component has a separate layer for each display mode. Display the Layers tab in the component's pop-up menu. 3. Insert the Selection box display component in the MashApp. (Page 49) 2. Note Depending on the layer you selected. b. areas (closed routes). The Google Maps display component can represent sections of routes (legs). i.     The base layer shows the map and is a default feature. for example. Procedure 1. 112 . The area layer shows areas. The placemark layer displays individual coordinates (POIs). c. Click on the Add placemark layer button. Add a placemark layer to the display component. Create a MashApp. entire routes. different display options for the component are available and as many elements in data mode.e. which will later be used for selecting the POIs. The route layer displays legs and entire routes. closed routes.ARIS MashZone Example: CSV file as a data source Create MashApp with Google Maps You can add Google Maps to a MashApp using the corresponding display component. 4. Double-click on the placemark layer and name it POIs. and selected coordinates (POIs). a. Add the Google Maps display component (Page 16).

The MashApp is created and contains Google Maps. 113 . 6. a selection box. and Slider Selection box: Assign data Use the selection box to select a city to be automatically displayed in the center of the Google Map in the MashApp. The corresponding coordinates are transferred to the Google Map when a city is selected. Set the slider. you assign the cities and their coordinates to the selection box. Example: Display components Google Maps with two layers. For this. Insert the Slider display component in the MashApp. and a slider. with only the cities being displayed in the selection box. b. a. Specify 0 as the minimum value and 17 as the maximum value. which will later be used for setting the Google Maps zoom factor. Enter 5 as the default value to display the map with this zoom factor initially. Selection box. Click on the slider and enable the option Numerical values on the Slider tab. c.ARIS MashZone 5. Note The zoom values 0 to 17 are default values in Google Maps.

Example: Selection box with assigned data Google Maps base layer: Assign data The base layer displays the map and is a default feature of the Google Maps display component. 4. Click on Save and close. 5. Link the Longitude column to the More columns (invisible) element. Click on the Assign data button in the pop-up menu. Your POIs are assigned to the selection box. select the data feed you created with your GPS data. Link the City column to the Visible column element of the selection box. Link the Latitude column to the More columns (invisible) element. 114 .ARIS MashZone Procedure 1. Click on the selection box. 2. 7. 6. 3. You can assign the base layer the components to be used for setting the coordinates and zoom level. From Data.

3. click on the Use selection ( button. The map will be centered on a selected POI's latitude and longitude. b. The components for selecting POIs and setting the zoom factor of the map have been configured. Click on the Google Maps display component.ARIS MashZone Procedure 1. Click on Use selection. g. Select the Base layer from the selection box in the pop-up menu. Select the Selection box as a component. 4. click on the Use selection ( next to Longitude. d. Click on the Assign data button. select the latitudes column. Click on Use selection. h. 2. Select the Slider as a component. Under Select coordinate. ) ) button ) button 115 . 6. Specify the component for setting the zoom factor. Under Select coordinate. click on the Use selection ( next to Latitude. 5. Select the Selection box as a component. In the Map position box. f. In the Zoom level of map box. In the Map position box. b. a. c. c. a. select the longitudes column. Specify the component for setting the map position. e. Click on Save and close. Click on Use selection.

Assign the feed columns with longitude and latitude.ARIS MashZone Example: Base layer with assigned data Google Maps placemark layer: Assign data In the display component's data mode you can assign your POIs to the selected placemark layer and define pop-ups. Link the longitudes column with the Google Maps element Longitude. From Data. Click on the Assign data button. Select the POIs placemark layer from the selection box in the pop-up menu. b. 3. 4. a. 116 . 5. Specify the contents of the pop-ups. 6. 1. 2. Click on the Google Maps display component. select the data feed you created with your GPS data. Link the latitudes column with the Google Maps element Latitude.

ARIS MashZone

a. Link the column of city names with the first row in the Pop-ups box. b. Create another row in the Pop-ups box and insert a slash /. c. Similarly, create further pop-up rows for countries and continents. 7. Click on Save and close. Te desired POI data is configured and assigned to the placemark layer.

Example: Set Google Maps POI data

Set Google Maps display You can configure the display of the component using the pop-up menu. For example, select the map section or additional control elements to be displayed by default. You can also set the display (e.g., the color scheme) of the placemarks (POIs) and of the pop-ups. You set these options for each of the layers of the display components.

117

ARIS MashZone

See also Appendix/Display components/Google Maps (Page 156) Edit mode For the Google Maps display component, the edit mode is available for setting the initial display of the component. For example, you can drag the map section or use the mouse wheel to set the zoom factor. If you display the buttons for selecting the map type you can also select the initial map type. To get to edit mode, double-click on the display component or on the Edit component interactively button in the pop-up menu. Procedure 1. Click on the Google Maps display component. 2. In the pop-up menu, select a layer whose display you want to set. 3. Display the Google Maps tab to configure controls and layer display. 4. Specify the required settings. 5. Display the Border tab to set the border of the display component. 6. Specify the required settings. The Google Maps component display is set. Tip You can view the result of your settings in the preview (Page 25).

118

ARIS MashZone

Example: Google Maps with selection box and slider

6.1.2

Display routes in Google Maps
This use case describes how you use the Google Maps display component to import any GPS data and display them as waypoints and routes in an individual MashApp. Example You can use an XML file in GPS Exchange format (GPX) as a data basis. For example, you can record the coordinates with a GPS device or obtain already existing data from the Internet. The coordinates used here show the route of the Berlin marathon (http://www.runmap.net/route/79781).

Extract from the GPX file Runmap.net-Berlin-Marathon.gpx <?xml version="1.0" encoding="UTF-8"?> <gpx version = "1.0" creator = "GPSBabel - http://www.gpsbabel.org" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" xmlns = "http://www.topografix.com/GPX/1/0"

119

ARIS MashZone

xsi:schemaLocation = "http://www.topografix.com/GPX/1/0 http://www.topografix.com/GPX/1/0/gpx.xsd"> <time>2009-03-22T12:54:41Z</time> <bounds minlat = "52.467530000" minlon = "13.281110000" maxlat = "52.529720000" maxlon = "13.429610000"/> <trk> <trkseg> <trkpt lat = "52.51518" lon = "13.35938"> <ele>0.000000</ele> </trkpt> <trkpt lat = "52.51471" lon = "13.35155"> <ele>0.000000</ele> </trkpt> <trkpt lat = "52.51474" lon = "13.35114"> <ele>0.000000</ele> </trkpt> ... </trkseg> </trk> </gpx> Use the XML file data source to import the GPS data, i.e., longitude (long) and latitude (lat) from the relevant GPX file. By specifying the repeat element /gpx/trk/trkseg/trkpt, the XML attributes lat and lon describing the coordinates of the individual waypoints are imported in the columns trkpt-lat and trkpt-lng of the data feed. The Geo aggregation operator handles the conversion of the individual waypoints to routes. Depending on the mode selected, i.e. Entire route or Leg mode it combines the waypoints into an entire route or creates legs for two consecutive waypoints. Consecutive waypoints are identified using an index column that specifies the order of coordinate. Since the GPX file loaded does not have an index column you need to add one to the data feed. To do this, insert the Insert columns operator, create a numerical column called Index, and fill it with ascending values. You can now configure the Geo aggregation operator with the required data Latitude (lat), Longitude (long), and Index. Prerequisite   You have installed at least the ARIS MashZone Professional edition. You have installed the Google Maps API key in Administration (Page 87).

120

ARIS MashZone

Create data feed Procedure 1. Create a data feed (Page 26). 2. Insert the XML file data source and select the desired source file, e.g. Runmap.net-Berlin-Marathon.gpx. 3. As a repeat element, specify /gpx/trk/trkseg/trkpt. 4. Insert the Insert columns operator and link it to the XML file data source. 5. Enter Index as the column name, select Number as the type, and enable the option Fill column with ascending values. 6. Insert the Geo aggregation operator and link it to the Insert column operator. 7. Select Leg for mode, trkpt-lat for latitude (lat), trkpt-lon for longitude (lon), and name the target column Routes. 8. Link the operator Geo aggregation operator with the Output operator. 9. Save the data feed and name it, e.g. Demo_Google_Maps_Route. The data feed is created and contains the new columns Index and Routes including the individual coordinates of the leg.

121

ARIS MashZone

Example: Data feed for importing GPS data on the Berlin marathon

Create MashApp with Google Maps Use the Google Maps display component to visualize your GPS data in a MashApp.

122

3. The area layer shows areas. b. The display component is created and has a base layer and a route layer to which you can assign your GPS data. areas (closed routes). Click on the Add route layer button. Double-click on the route layer and name it Berlin Marathon. The route layer displays legs and entire routes. Procedure 1.ARIS MashZone The display component can represent sections of routes (legs). 4. (Page 49) 2. Example: Google Maps display component with two layers 123 .     The base layer shows the map and is a default feature. entire routes. Note Depending on the layer you selected. The component has a separate layer for each display mode. i. c. Display the Layers tab in the component's pop-up menu. Add a route layer to the display component. a. different display options for the component are available and as many elements in data mode. and selected coordinates (POIs). closed routes. Add the Google Maps display component (Page 16).e. The placemark layer displays individual coordinates (POIs). Create a MashApp. Click on Save.

5. From Data. The data is now assigned to the display component. you can specify the coloring. Click on Save and close. 6. 4. Insert a new row below Tooltip. Select the Berlin Marathon layer from the pop-up menu of the display component. In addition. 2. Procedure 1. line weight. Enter the text Leg in an input box under Tooltip. and a tooltip for each leg. 7. Assign the Index column to the new row. select the Demo_Google_Maps_Route data feed you created. Assign the Routes column of the data feed to the Lines component element.ARIS MashZone Assign GPS data In the display component's data mode you can assign your GPS data to the selected route layer. Click on the Assign data button. 124 . 3. 8.

The Google Maps component display is set. Select the Berlin Marathon layer from the pop-up menu of the display component. Procedure 1. 2. Display the Google Maps tab. you can configure the color and weight of the routes. Click on Save. 3. 4. 125 . Specify the required settings.ARIS MashZone Example: Assign GPS data to a route layer Set display You can set the display of the individual layers in line with your requirements. Notes The values configured in composer are overwritten by settings in data mode. for example.

Example: Google Map with marathon route in Berlin 6. If you specified tooltips for routes. Based on the IDs.g. Identify map segments Maps are divided into individual segments (e.ARIS MashZone The route and legs are displayed according to your settings. With the help of thresholds. an MS Excel file). In the composer's data mode.2 Use vector maps With vector maps (vector graphics). the segments are dynamically assigned 126 .g. you assign the element ID of the vector map the corresponding feed column with the ID values (e. the individual segments are assigned any values and labels saved in a data source (e. Tip You can view the result of your settings in the preview (Page 25). Color map segments Map segments can be displayed in various colors depending on particular KPIs. Each vector map with its segments (polygons) is saved in an individual definition file. they will be shown when you move the mouse pointer over them. you can display KPIs or other values pertaining to individual segments of a map. countries or states) that are identified via individual IDs (such as names or country codes).g. country names).

ARIS MashZone different colors. 3. 2.xlsx on the ARIS MashZone server as a data source. 5. The worksheet data is displayed in the results table. a world map divided into continents or a map of Europe zoned into countries.. Select the file . Select dynamic coloring and specify a start and end color. 4. Tip With the installation of ARIS MashZone multiple vector maps become available. Area (million km2) indicates the area of the continents in million square kilometers. Insert an MS Excel file data source.. e. Example The supplied world map is used for demonstrating how to use vector maps. too. Create data feed First. you can select absolute coloring. To display the file contents. In addition to the supplied maps you can use your own vector graphics in your MashApps. Under Options. The colors for the remaining KPIs are automatically created and displayed in the MashApp. Alternatively. Open feed editor (Page 26). Population (million) indicates the population in million. For each continent. you create a data feed in which you set the required source data (ID and name of the map segments and KPI values)./resources/demo/feature_overview/Maps. The Maps view in the MashApp Demo feature overview provides you with an overview of available vector maps and how to use them. Procedure 1. 127 . The start color is automatically assigned to the minimum KPI value and the end color to the maximum KPI value. You can add intermediate colors. See also chapter User-defined vector graphics (Page 301) in the appendix. Continents ID indicates the continent names. click on the Display calculation result ( ) button. the area and the population is displayed as a tooltip. The continents are colored based on the population. select the worksheet Continents. Segments will be colored based on their threshold definition and no intermediate colors will be created.g.

ARIS MashZone 6. b. 8.Continent map. The data feed has been created and you can assign data to the relevant map. 7. a. In the Column selection box. 128 . Add another row and rename the column Population (million) to Population. e. d. c. Save the data feed as Demo feature overview . Insert the Rename columns operator. You can assign the columns other names that will be used in the map as a tooltip. select the column Continents ID and name it Continent. Add another row and rename the column Area (million km2) to Area. Link the operator Rename columns operator with the Output operator. Link the data source with the operator.

In the selection box Type of coloring select the value Dynamic. 5. a. 4. Set the Tooltip for the map segments indicating Area and Population. Open the design view of composer (Page 49). e. 8. f. continents are identified by name. link the Continent column to the ID element of the component.Continents from the selection box Map definition.Continent map in the Data column. Link the Population column to the Coloring element of the component. c. 6. Set the Start color and End color and add intermediate colors. c. Insert a vector map into the MashApp view. a. 3. if required. In the Vector map column. b. To do so. Add another row and link it with the Population column. Color the map segments in line with the population. Open data mode for the map (Page 17). Enter the text Area: in the first row of the Tooltip element. b. select the map World . 2. Display the Thresholds tab in the pop-up menu of the Coloring tab. Add a row and link it with the Area column. 7. Procedure 1. Assign the correct data feed elements to the individual map segments (continents).ARIS MashZone Select map and assign data In the composer's data mode. Note The selection box displays all map definitions saved in the maps folder of the ARIS MashZone installation. Add another row and enter the text m km2. you can select one of the available map definitions and assign the individual elements data. In an additional row. Note In the example. enter the text Population. Select the required data feed Demo feature overview . 129 . d. d. Insert a line break in still another row by clicking in the box of the new row and selecting Line break.

Click on Save and close to get back to the design view. click on the Frame button ( The dialog for setting the frame is displayed. 2. All required data is assigned to the component and segment coloring has been set. 9. Click on the display component. In a last row. Procedure 1. Example: Data mode of the vector map Set display element In the pop-up menu of the vector map. labels and coloring). ). In the pop-up menu. A pop-up menu is displayed at the top edge of the display component.ARIS MashZone g. you can configure the display (e. which you can use to set the display. 130 . enter the text m.g.

Click on Preview to display the world map.ARIS MashZone 3. If you move the mouse over a continent. Inactive fill indicates the coloring of segments for which no data exists. Display the Vector map tab in the pop-up menu to display a border or shadow for each segment. Mouseover indicates the segment coloring that applies when the user moves the mouse over a segment or clicks on a segment in the MashApp. 6. 5. enter the text World population and enable the Display option after Title. or if the KPI value of the segment does not match any threshold (with absolute coloring). Note The Default fill indicates the segment coloring that is displayed if no dynamic or absolute coloring was set. Display the Formatting tab in the pop-up menu to configure the coloring of the individual elements. In the Name input box. a tooltip with the corresponding data is shown. A preview of the configured vector map is displayed. if so desired. Example: Vector map as a world map with North America selected 131 . 4.

Two dimensions or one dimension and multiple KPIs can be used. The value ranges are arranged as bars. 132 . Bar speedometer (Page 165) (vertical and horizontal) Single traffic light (Page Displays a set of aggregated KPI values Value ranges can be defined and indicated by different colors. Thresholds can be displayed for all non-stacked column charts. The value ranges are arranged in a semicircle. The dimension is represented by different colors of the individual bubble areas. Column chart (Page 139) Can display values for two iterations. Bubble chart (Page 146) One dimension and two KPIs can be used. routes.ARIS MashZone 7 Appendix Please select a subentry. Thresholds can be displayed for all non-stacked bar charts. Names Table (Page 133) Line chart (Page 136) Description Displays any number of KPIs and dimensions as a list table. The two KPIs are plotted on the X and Y-axis. or one dimension and multiple KPIs. 7. Speedometer chart (Page Displays a set of aggregated KPI values Value ranges can be defined 162) and indicated by different colors. its values determine the radii of the bubble areas. Multiple dimensions or KPIs can be displayed grouped or stacked. Multiple dimensions or KPIs can be displayed grouped or stacked. Bar chart (Page 143) Can display values for two iterations. Displays in color the range of values in which a KPI value is located. Pie chart (Page 149) Displays one or more KPIs iterated via a dimension (text or date dimension) Vector map (Page 153) Google Maps (Page 156) Displays KPIs for different elements of a vector map Displays GPS data in Google Maps as placemarks (POIs). Multiple KPIs are then displayed using lines of different colors. Two dimensions and one KPI can be used. and areas. a third KPI can be incorporated.1 Display components The following display components are available in the composer (Page 14). Optionally. Two dimensions or one dimension and multiple KPIs can be used. Can display values for two iterations. The second iteration is displayed with several stacked lines.

Image (Page 180) Displays images of your choice in the MashApp. Slider (Page 189) Time filter (Page 191) Input box (Page 195) Provides the user with a selection of values in the form of a slider.1. 7. An autoplay function is also available. 133 . Selection box (Page 183) A drop-down menu provides the user with a selection of values. e. Option Header Horizontal grid lines Vertical grid lines Shadow Data determination Description Displays the header with the column titles in the table Displays the grid lines between the rows Displays the grid lines between the columns Emphasizes the table by displaying a shadow Sets the automatic data determination for the component. Spin control (Page 185) Provides the user with a selection of values in the form of a spin control.g. Displays an interactive calendar for configuring a time filter Enables you to enter values that can be used dynamically in other components. or a text that is maintained dynamically in another component. a selection box.1 Table Behavior Displays any number of KPIs and dimensions as a list table. a selection box. The text is output in LCD format.ARIS MashZone Names 169) Description Multiple traffic light (Page Displays in a multi-color traffic light in which threshold range a KPI 172) (vertical and horizontal) Text (Page 175) Displays a fixed text you have entered. Component: Table The following options are available for configuring the component.g. or a text that is maintained dynamically in another component. e. LCD text (Page 178) Displays a fixed text you have entered.. value is located..

You can set two colors for a color change.  Elements Selects an element for which labels are set Sets the font display:     Colors Color Alignment Font Font size  Font Sets the colors of individual component elements. Can be disabled with None.  Header Sets the color of the header.  Elements Assigns a color scheme to particular component elements.  Rows 134 .  Grid lines Sets the color of the horizontal and vertical grid lines.ARIS MashZone Option  Refresh Description Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. You can set two colors for a gradient. Sets the color of the rows. Option Labeling Description Sets the labeling of individual component elements. Formatting The following options are available for formatting the component. Note You can customize the color of individual elements.

 Form Displays the border with or without header or transparent with title bar. Shadow Displays the border without. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. The mouseover effect emphasizes the element that the mouse pointer is currently positioned over.ARIS MashZone Option  Mouseover Description Specifies the color of the mouseover effect.  Selection Sets the color of selected table cells. In addition. Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component. or with a strong shadow or shadow within the border 135 . Border The following options are available for displaying the border.  Indent Sets the indent of the title in the bar. the border can be customized (Set button). with a weak.

 Saturation 7. Note You can customize individual elements of the style template. Two dimensions and one KPI can be used.2 Line chart Behavior Can display values for two iterations. Multiple KPIs are then displayed using lines of different colors.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). or one dimension and multiple KPIs. Option Style Description Assigns a style template to the component. Component: Line chart The following options are available for configuring the component. The second iteration is displayed with several stacked lines.1. 136 .ARIS MashZone Option Colors Description Sets the colors of the display component Note Is available if the option Display border is enabled.

Note You can customize the selection of elements.ARIS MashZone Option Visibility Description Defines the number of component elements to be displayed.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time.  Animation Displays an animation when the chart display changes. Data determination Sets the automatic data determination for the component. Can be disabled with None. Option Labeling Elements Font Description Sets the labeling of individual chart elements. Element for which labels are set Sets the font display:     Color Alignment Font Font size 137 . Highlights the data points and connection lines with a shadow. Zoom Displays a slider to scale the display size. Legend Shadow Displays the legend. Formatting The following options are available for formatting the component.

 Data points Assigns a particular color scheme to the data points of the component. Sets the color of the gridlines.ARIS MashZone Option Colors Description Sets the colors of individual component elements.  Indent Sets the indent of the title in the bar.   Gridlines Saturation Border The following options are available for displaying the border.  Elements   Axes Selection Sets the color of the chart axes. Assigns a color scheme to particular component elements. Sets the color saturation of certain elements and the data points in percent (%). Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. Note You can customize the color of individual elements. Sets the font display:     Color Alignment Font Font size  Font 138 . Sets the color of selected data areas.

ARIS MashZone Option Display borders Description Displays a border around the component.  Saturation 7. 139 .  Form Displays the border with or without header or transparent with title bar. Component: Column chart The following options are available for configuring the component.1. with a weak. In addition. Two dimensions or one dimension and multiple KPIs can be used.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). Thresholds can be displayed for all non-stacked column charts. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.3 Column chart Behavior Can display values for two iterations as columns. Multiple dimensions or KPIs can be displayed grouped or stacked. the border can be customized (Set button). Shadow Displays the border without.

Note You can customize the selection of elements. 140 . Highlights the data points with a shadow. Note You can customize individual elements of the style template. Zoom Displays a slider to scale the display size. Option Labeling Description Sets the labeling of individual chart elements. Formatting The following options are available for formatting the component. Legend Shadow Displays the legend. Data determination Sets the automatic data determination for the component. Visibility Defines the number of component elements to be displayed.ARIS MashZone Option Style Description Assigns a style template to the component. Values Can display KPI values within the data points.  Animation Displays an animation when the chart display changes.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Can be disabled with the option None.

Sets the color of selected data areas. Option Name Description Name of the display component 141 . Assigns a color scheme to particular component elements.ARIS MashZone Option   Elements Font Description Element for which labels are set Sets the font display:     Color Alignment Font Font size Colors Sets the colors of individual component elements. Sets the reflection effect of certain elements and the data points in percent (%).  Elements   Axes Selection Sets the color of the chart axes. Border The following options are available for displaying the border.   Gridlines Reflection  Saturation Sets the color saturation of certain elements and the data points in percent (%). Note You can customize the color of individual elements.  Data points Assigns a particular color scheme to the data points of the component. Sets the color of the gridlines.

     Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) 142 . Sets the font display:     Color Alignment Font Font size  Font Display borders Displays a border around the component. the border can be customized (Set button).  Indent Sets the indent of the title in the bar.ARIS MashZone Option Display title Description Displays the name of the display component as a title in the header. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. In addition. with a weak.  Form Displays the border with or without header or transparent with title bar. Shadow Displays the border without.

Two dimensions or one dimension and multiple KPIs can be used. Values Can display KPI values within the data points. Data determination Sets the automatic data determination for the component.1. Visibility Defines the number of component elements to be displayed. Component: Bar chart The following options are available for configuring the component.ARIS MashZone Option  Saturation Description Sets the color saturation of the background in percent (%). Zoom Displays a slider to scale the display size. 7. Multiple dimensions or KPIs can be displayed grouped or stacked. Highlights the data points with a shadow. Legend Shadow Displays the legend.4 Bar chart Behavior Can display values for two iterations as bars. Note You can customize the selection of elements. 143 . Option Style Description Assigns a style template to the component. Note You can customize individual elements of the style template. Thresholds can be displayed for all non-stacked bar charts.

Element for which labels are set Sets the font display:     Colors Color Alignment Font Font size Sets the colors of individual component elements. Assigns a color scheme to particular component elements. 144 . Option Labeling Elements Font Description Sets the labeling of individual chart elements.  Elements   Axes Selection Sets the color of the chart axes.ARIS MashZone Option  Refresh Description Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Can be disabled with the option None.  Data points Assigns a particular color scheme to the data points of the component. Sets the color of selected data areas. Note You can customize the color of individual elements. Formatting The following options are available for formatting the component.  Animation Displays an animation when the chart display changes.

Border The following options are available for displaying the border.  Form Displays the border with or without header or transparent with title bar. In addition. the border can be customized (Set button). Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component.  Saturation Sets the color saturation of certain elements and the data points in percent (%). Shadow Displays the border without.ARIS MashZone Option   Gridlines Reflection Description Sets the color of the gridlines. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. or with a strong shadow or shadow within the border 145 . Sets the reflection effect of certain elements and the data points in percent (%). with a weak.  Indent Sets the indent of the title in the bar.

Optionally. Note You can customize individual elements of the style template.5 Bubble chart Behavior One dimension and two KPIs can be used. The two KPIs are plotted on the X and Y-axis. Option Style Description Assigns a style template to the component. its values determine the radii of the bubble areas.  Saturation 7.ARIS MashZone Option Colors Description Sets the colors of the display component Note Is available if the option Display border is enabled.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). a third KPI can be incorporated. 146 .1. The dimension is represented by different colors of the individual bubble areas. Component: Bubble chart The following options are available for configuring the component.

147 . Element for which labels are set Sets the font display:     Colors Color Alignment Font Font size Sets the colors of individual component elements. Can be disabled with None.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time.ARIS MashZone Option Visibility Description Defines the number of component elements to be displayed. Highlights the data points with a shadow.  Animation Displays an animation when the chart display changes. Legend Shadow Displays the legend. Formatting The following options are available for formatting the component. Note You can customize the selection of elements. Option Labeling Elements Font Description Sets the labeling of individual chart elements. Data determination Sets the automatic data determination for the component.

Sets the reflection effect of certain elements and the data points in percent (%). Sets the color of selected data areas. Sets the font display:     Color Alignment Font Font size  Font 148 .  Indent Sets the indent of the title in the bar. Sets the color of the gridlines.  Elements   Axes Selection Sets the color of the chart axes. Assigns a color scheme to particular component elements. Border The following options are available for displaying the border.   Gridlines Reflection  Saturation Sets the color saturation of certain elements and the data points in percent (%). Note You can customize the color of individual elements. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header.ARIS MashZone Option  Data points Description Assigns a particular color scheme to the data points of the component.

with a weak. In addition. Shadow Displays the border without. the border can be customized (Set button). 149 .  Saturation 7.  Form Displays the border with or without header or transparent with title bar.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%).1.6 Pie chart Behavior Displays one or more KPIs iterated via a dimension (text or date dimension) Component: Pie chart The following options are available for configuring the component.ARIS MashZone Option Display borders Description Displays a border around the component. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.

Zoom Displays a slider to scale the display size.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Option Labeling Description Sets the labeling of individual chart elements. Shadow Highlights the pie segments with a shadow. Legend Displays the legend. Note You can customize individual elements of the style template. Formatting The following options are available for formatting the component.ARIS MashZone Option Style Description Assigns a style template to the component. Can be disabled with the option None.  Animation Displays an animation when the chart display changes.  Elements Element for which labels are set 150 . Data determination Sets the automatic data determination for the component.

Sets the reflection effect of certain elements and the data points in percent (%).  Indent Sets the indent of the title in the bar. Assigns a color scheme to particular component elements. Note You can customize the color of individual elements. 151 .  Elements    Radial line Label line Reflection Sets the color of the radial lines.ARIS MashZone Option  Font Description Sets the font display:     Color Alignment Font Font size Colors Sets the colors of individual component elements.  Saturation Sets the color saturation of certain elements and the data points in percent (%). Sets the color of the label lines. Border The following options are available for displaying the border.  Data points Assigns a particular color scheme to the data points of the component. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header.

 Saturation 152 . with a weak.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). Shadow Displays the border without. the border can be customized (Set button).  Form Displays the border with or without header or transparent with title bar.ARIS MashZone Option  Font Description Sets the font display:     Color Alignment Font Font size Display borders Displays a border around the component. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. In addition.

Can be disabled with the option None. %MASHZONE_HOME%\maps Component: Map The following options are available for configuring the component. Note Is available only if a label was specified.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Sets the automatic data determination for the component. Option Border Shadow Data determination Description Displays the individual segments of the map with a border. Highlights the map with a shadow.ARIS MashZone 7. Formatting The following options are available for formatting the component. Element Element for which labels are set 153 . Option Labeling Description Sets the labeling of individual chart elements.7 Vector map Behavior Displays KPIs for different elements on a vector map Note The maps are available as XML files in the maps folder of your ARIS MashZone installation.1.

 Elements Assigns a color scheme to particular component elements. The mouseover effect emphasizes the element that the mouse pointer is currently positioned over. Note You can customize the color of individual elements.  Default fill Sets the color of the various elements of the map. Specifies the color of the mouseover effect. e.g.  Inactive fill Sets the color of the inactive elements.  Reflection Sets the reflection effect of particular elements.e.ARIS MashZone Option Font Description Sets the font display:     Color Alignment Font Font size Colors Sets the colors of individual component elements.   Border Mouseover Sets the color of the border lines. elements without assigned data. Option Name Description Name of the display component 154 . the countries or continents. Sets the color saturation of particular elements in percent (%). i.  Saturation Border The following options are available for displaying the border.

Sets the font display:     Color Alignment Font Font size  Font Display borders Displays a border around the component. the border can be customized (Set button).ARIS MashZone Option Display title Description Displays the name of the display component as a title in the header. with a weak. Shadow Displays the border without. In addition.  Indent Sets the indent of the title in the bar.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) 155 .  Form Displays the border with or without header or transparent with title bar. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.

Displays buttons for setting the zoom factor in the map. 7. placemark layer. and areas.  Overview Displays an additional small overview in the map. Note First select a layer to configure its properties.ARIS MashZone Option  Saturation Description Sets the color saturation of the background in percent (%). i. route layer.  Zoom 156 . Option Base layer Properties  Map type Sets the base layer properties. Prerequisite You have installed at least the ARIS MashZone Professional edition. Displays the buttons for selecting the map types and sets the initial map type:      Position Map Satellite Hybrid Terrain Description Displays the buttons for setting the position in the map and moves the map section.e.1. You have installed the Google Maps API key in Administration (Page 87).8 Google Maps Behavior Displays GPS data in Google Maps as placemarks (POIs). base layer. and area layer. The different views are assigned to the corresponding layers. Component: Google Maps The following options to configure the various layers are available. routes.

 Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time.  Scaling Map section  Interaction options Offers options to interact with the map. The maximum number is 200.  Display placemarks Displays all placemarks. Can be disabled with the option None. Displays a scale (metric or imperial) in the map. This happens automatically if the map contains new data. 157 . points of interest (POIs) on a map. Mouse wheel zoom: Drag  Automatic zoom on data The map selects the zoom factor so that all POIs are visible on the map. Placemark layer Properties Sets the placemark layer properties. This happens automatically if the map contains new data.  Automatic focus on data The map zooms to the center of the POIs.ARIS MashZone Option  Zoom slider Description Displays a slider for setting the zoom factor in the map.e. Offers options for setting the map section.    Double-click to zoom: Zooms the map to the mouse position. i. Data determination Sets the automatic data determination for the component.

Sets the color of the placemarks' fills.ARIS MashZone Option  Display all pop-ups Description Displays all pop-ups set in data mode on the map. Sets the colors of the layer elements. Sets the transparency effect of a selected placemark. Sets the transparency effect of the placemarks. Pop-ups cannot be closed. Sets the weight of the placemarks' border.  Top-align pop-ups Opens pop-ups to the top.  Border (selected)  Fill  Fill (selected)  Border weight  Opacity  Opacity (selected)    Size Pop-up Border 158 . Sets the display of the pop-ups. Sets the color of a selected placemark's border. Sets the color of the fill of a selected placemark. Sets the color of the pop-ups' border. Colors  Elements Assigns a color scheme to particular layer elements.  Border Sets the color of the placemarks' border. Note You can customize the color of individual elements. Placemarks Sets the display of the placemarks (POIs). Sets the size of the placemarks.

Sets the color of the fill of the pop-up of a selected placemark. Sets the color of the area's fills.ARIS MashZone Option   Fill Fill (selected) Description Sets the color of the pop-ups' fills. Sets the weight of a selected route. Sets the color of a selected area's border.   Border Border (selected) Sets the color of the area's border. Sets the transparency effect of the route.  Line opacity (selected) Area layer Colors Sets the colors of the layer elements. Note You can customize the color of individual elements. Sets the weight of the route.  Border weight Route layer Colors Sets the colors of the layer elements. Sets the transparency effect of a selected route. Sets the weight of the pop-ups' border.      Line Line (selected) Line weight Line weight (selected) Line opacity Sets the color of the route.  Elements Assigns a color scheme to particular layer elements. Sets the color of a selected route.  Fill 159 .

160 . Displays coordinates as a leg (sections of routes) or entire route. Add placemark layer Adds a placemark layer to the component. Displays coordinates as an area (closed route) Add route layer Adds a route layer to the component. You can configure any number of layers. Base layer Displays the Google Maps map. Displays coordinates as individual placemarks (points of interest. Rename selected layer Enables you to rename a selected layer. Sets the transparency effect of the area.  Border weight  Opacity Layers The following options are available for creating layers. POIs). Add area layer Adds an area layer to the component. Note The layers created here are also available in the selection box of the pop-up menu. which is a default feature. Sets the weight of the area's border. Move up selected layer Move down selected layer Moves a selected layer up in the list Moves a selected layer down in the list Remove selected layer Removes a selected layer from the list.ARIS MashZone Option  Fill (selected) Description Sets the color of the fill of a selected area.

Shadow Displays the border without. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.ARIS MashZone Border The following options are available for displaying the border.  Form Displays the border with or without header or transparent with title bar. with a weak.  Indent Sets the indent of the title in the bar.    Border Header Background Sets the color of the border Sets the color of the header Sets the color of the background 161 . In addition. the border can be customized (Set button). Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component.

KPI name Displays the KPI name in the component. Thresholds Displays the thresholds in the component.9 Speedometer chart Behavior Displays a set of aggregated KPI values Value ranges can be defined and indicated by different colors. Displays the scale values in the component. KPI value Displays the KPI value in the component.ARIS MashZone Option   Shadow Reflection Description Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). Component: Speedometer chart The following options are available for configuring the component. The value ranges are arranged in a semicircle. Option Scale Scale values Description Displays the dial markings in the component. 162 .  Saturation 7.1. Shadow Highlights the component with a shadow. Short dial markings Indicates the number of short dial markings between the long dial markings. Long dial markings Indicates the number of long dial markings.

163 .  Speedometer Sets the color of the speedometer background. Element for which labels are set Sets the font display:     Colors Color Alignment Font Font size Sets the colors of individual component elements. Formatting The following options are available for formatting the component.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time.  Elements Assigns a color scheme to particular component elements.ARIS MashZone Option Data determination Description Sets the automatic data determination for the component. Can be disabled with the option None.  Animation Displays an animation when the chart display changes. Option Labeling Elements Font Description Sets the labeling of individual chart elements. Note You can customize the color of individual elements.

Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header.   Scale Border  Reflection  Saturation Sets the color saturation of certain elements and the data points in percent (%). Sets the color of the dial markings. Border The following options are available for displaying the border. Sets the color of the speedometer border. Sets the reflection effect of certain elements and the data points in percent (%). In addition.  Indent Sets the indent of the title in the bar.  Form Displays the border with or without header or transparent with title bar.ARIS MashZone Option  Needle Description Sets the color of the speedometer needle. 164 . the border can be customized (Set button). Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component.

     Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%).1. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.  Saturation 7.ARIS MashZone Option Shadow Description Displays the border without. Displays the scale values in the component.10 Bar speedometer Behavior Displays a set of aggregated KPI values Value ranges can be defined and indicated by different colors. Component: Bar speedometer (vertical and horizontal) The following options are available for configuring the component. 165 . Option Scale Scale values Description Displays the dial markings in the component. The value ranges are arranged as vertical and horizontal bars. with a weak.

 Animation Displays an animation when the chart display changes.  Elements Element for which labels are set 166 . Option Labeling Description Sets the labeling of individual chart elements. KPI value Displays the KPI value in the component. Short dial markings Indicates the number of short dial markings between the long dial markings.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Thresholds Displays the thresholds in the component.ARIS MashZone Option Long dial markings Description Indicates the number of long dial markings. Data determination Sets the automatic data determination for the component. KPI name Displays the KPI name in the component. Formatting The following options are available for formatting the component. Can be disabled with the option None. Shadow Highlights the component with a shadow.

Sets the color of the speedometer border.  Elements  Speedometer Sets the color of the speedometer background.  Data points Assigns a particular color scheme to the data points of the component. Sets the reflection effect of certain elements and the data points in percent (%). Assigns a color scheme to particular component elements.  Needle   Scale Border  Reflection  Saturation Sets the color saturation of certain elements and the data points in percent (%).ARIS MashZone Option  Font Description Sets the font display:     Color Alignment Font Font size Colors Sets the colors of individual component elements. Sets the color of the speedometer needle. Option Name Description Name of the display component 167 . Note You can customize the color of individual elements. Sets the color of the dial markings. Border The following options are available for displaying the border.

 Indent Sets the indent of the title in the bar. with a weak. Shadow Displays the border without. the border can be customized (Set button).      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) 168 . In addition. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. Sets the font display:     Color Alignment Font Font size  Font Display borders Displays a border around the component.  Form Displays the border with or without header or transparent with title bar.ARIS MashZone Option Display title Description Displays the name of the display component as a title in the header.

Component: Single traffic light The following options are available for configuring the component. 169 . 7. Traffic light shape Indicates the various symbols of an active traffic light.ARIS MashZone Option  Saturation Description Sets the color saturation of the background in percent (%). Shadow Highlights the component with a shadow.1.11 Single traffic light Behavior Displays in color the range of values in which a KPI value is located. Data determination Sets the automatic data determination for the component. Note Is available only if the option Display labeling is enabled. Sets the position of the labeling in the component. Note This option is available if data is assigned to the traffic light. Option Display labeling Position Description Displays the labeling of the component. Inactive traffic light Indicates the symbol of a traffic light without assigned data. You specify the symbol color when you define the thresholds. The shapes can be configured for the individual value ranges.

 Border 170 . Font Sets the font display:     Colors Color Alignment Font Font size Sets the colors of individual component elements.  Elements Assigns a color scheme to particular component elements. Note You can customize the color of individual elements. Can be disabled with the option None. Sets the color of the traffic light line. Option Labeling Description Sets the labeling of individual chart elements.  Animation Displays an animation when the chart display changes.  Inactive traffic light Sets the color of an inactive traffic light.ARIS MashZone Option  Refresh Description Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Formatting The following options are available for formatting the component. Note Is available only if a label was specified.

or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. Shadow Displays the border without. with a weak.ARIS MashZone Option  Reflection Description Sets the reflection effect of particular elements. In addition.  Saturation Border The following options are available for displaying the border. the border can be customized (Set button). Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header.  Form Displays the border with or without header or transparent with title bar.  Indent Sets the indent of the title in the bar. Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component. 171 . Sets the color saturation of particular elements in percent (%).

Option Display labeling Position Description Displays the labeling of the component. Shadow Highlights the component with a shadow. vertical or horizontal traffic light in which threshold range a KPI value is located. Inactive traffic light Indicates the symbol shape of a traffic light without assigned data. Note Is available only if the option Display labeling is enabled. Sets the position of the labeling in the component.ARIS MashZone Option      Border Header Background Shadow Reflection Description Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). 172 . Component: Multiple traffic light The following options are available for configuring the component.  Saturation 7.12 Multiple traffic light Behavior Displays in a multi-color.1.

 Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Option Labeling Description Sets the labeling of individual chart elements.  Animation Displays an animation when the chart display changes. Note Is available only if a label was specified. Formatting The following options are available for formatting the component. Note This option is available if data is assigned to the traffic light. The shapes can be configured for the individual value ranges. You specify the symbol color when you define the thresholds. Can be disabled with the option None.  Font Sets the font display:     Color Alignment Font Font size 173 . Data determination Sets the automatic data determination for the component.ARIS MashZone Option Traffic light shape Description Indicates the various symbol shapes of an active traffic light.

 Indent Sets the indent of the title in the bar.  Inactive traffic light Sets the color of an inactive traffic light. 174 . Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component. Sets the color of the traffic light line. Note You can customize the color of individual elements.  Border  Reflection  Saturation Border The following options are available for displaying the border. Sets the color saturation of particular elements in percent (%). Sets the reflection effect of particular elements.  Elements Assigns a color scheme to particular component elements. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header.ARIS MashZone Option Colors Description Sets the colors of individual component elements.

. Shadow Displays the border without.g. Component: Text The following options are available for configuring the component. with a weak.ARIS MashZone Option  Form Description Displays the border with or without header or transparent with title bar. 175 . e. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.13 Text Behavior Displays a fixed text you have entered.1. the border can be customized (Set button). In addition. a selection box.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). or a text that is maintained dynamically in another component.  Saturation 7.

Option Font Description Sets the font display:     Color Alignment Font Font size Border The following options are available for displaying the border. Can be disabled with the option None.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. 176 . Enables the input of the following HTML tags         Anchor tag (<a>) Bold tag (<b>) Line break tag (<br>) Font tag (<font>) Italic tag (<i>) List item tag (<li>) Paragraph tag (<p>) Underline tag (<u>) Data determination Sets the automatic data determination for the component.ARIS MashZone Option The content is html-coded Description Interprets the contents of the text box as HTML code. Formatting The following options are available for formatting the component.

or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. with a weak. the border can be customized (Set button). In addition.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) 177 . Sets the font display:     Color Alignment Font Font size  Font Display borders Displays a border around the component. Shadow Displays the border without.ARIS MashZone Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header.  Form Displays the border with or without header or transparent with title bar.  Indent Sets the indent of the title in the bar.

7.g. a selection box. Option The content is html-coded Description Interprets the contents of the text box as HTML code. The text is output in LCD format.1. Can be disabled with the option None.. Component: LCD text The following options are available for configuring the component. e.14 LCD text Behavior Displays a fixed text you have entered. Enables the input of the following HTML tags         Data determination Anchor tag (<a>) Bold tag (<b>) Line break tag (<br>) Font tag (<font>) Italic tag (<i>) List item tag (<li>) Paragraph tag (<p>) Underline tag (<u>) Sets the automatic data determination for the component. or a text that is maintained dynamically in another component.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. 178 .ARIS MashZone Option  Saturation Description Sets the color saturation of the background in percent (%).

the border can be customized (Set button). Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component.ARIS MashZone Option  Animation Description Displays an animation when the chart display changes. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. Option Font Description Sets the font display:     Color Alignment Font Font size Border The following options are available for displaying the border. Formatting The following options are available for formatting the component. In addition.  Form Displays the border with or without header or transparent with title bar. 179 .  Indent Sets the indent of the title in the bar.

Component: Image The following options are available for configuring the component. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. Option URL/path to image file Description Specifies the file path/URL to the relevant image.ARIS MashZone Option Shadow Description Displays the border without.  Saturation 7. with a weak.  Determine URL/path by data assignment Assigns a file path/URL to the image file via Assign data.15 Image Behavior Displays images of your choice in the MashApp. 180 .      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%).1.

Scaling Sets the image size:   Original size: Displays the image in its original size.  Indent Sets the indent of the title in the bar. Border The following options are available for displaying the border. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header.  Free-scale: Image is scaleable Data determination Sets the automatic data determination for the component. aspect ratio is retained. enables direct input of URL/path Note You can select a file in the resource directory of the ARIS MashZone server or specify a URL (http). 181 .ARIS MashZone Option  Enter URL/path directly Description Directly assigns file path/URL. Can be disabled with None.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Proportionate scale: Image is scaleable.

or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. with a weak. Shadow Displays the border without. In addition.ARIS MashZone Option  Font Description Sets the font display:     Color Alignment Font Font size Display borders Displays a border around the component. the border can be customized (Set button).      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%).  Form Displays the border with or without header or transparent with title bar.  Saturation 182 .

Note If no default value is defined.Numerical values Description Displays values from a data feed in the selection box. the minimum value is displayed.ARIS MashZone 7. are increased by this value until the maximum is reached. Default value: No selection Data determination Sets the automatic data determination for the component. No selection Does not display any preselected value in the selection box. Option Values . Displays a list of numerical values from a defined value range in the selection box.16 Selection box Behavior A drop-down menu provides the user with a selection of values.From data feed Values .1.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Step width 183 . starting with the minimum. Component: Selection box The following options are available for configuring the component.  Minimum/Maximum Smallest/largest value of the selection box Step width of the values displayed in the selection box.  Default value Value that is preselected by default.  Entry Text that is displayed by default instead of a preselected value. The values in the selection box.

Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. Sets the font display:     Color Alignment Font Font size Border The following options are available for displaying the border. Formatting The following options are available for formatting the component.  Indent Sets the indent of the title in the bar. Can be disabled with None. Element for which labels are set.ARIS MashZone Option  Load activity icon Description By default displays an animation if loading is taking a lot of time. Option Labeling Elements Font Description Sets the labeling of individual chart elements. Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component. 184 .

 Saturation 7. In addition.17 Spin control Behavior Provides the user with a selection of values in the form of a spin control. Component: Selection box The following options are available for configuring the component. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. the border can be customized (Set button). Shadow Displays the border without.ARIS MashZone Option  Form Description Displays the border with or without header or transparent with title bar. 185 .1.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). with a weak. you can display values automatically by using an auto-play function. In addition.

Step width of the values displayed in the spin control. Default value: No selection Autoplay Enables automatic display of values in the spin control by means of a button. Data determination 186 . No selection Does not display any preselected value in the spin control. are increased by this value until the maximum is reached. The values are automatically displayed in the specified time interval.  Autostart Automatically starts Autoplay for the component when displaying the MashApp. Displays a list of numerical values from a defined value range in the spin control.From data feed Values . Sets the automatic data determination for the component.  Step width  Default value Value that is preselected by default.  Entry Text that is displayed by default instead of a preselected value. Note If no default value is defined.  Minimum/Maximum Smallest/largest value of the spin control.ARIS MashZone Option Values . starting with the minimum.  Interval Specifies the length of the time interval in seconds. The values in the spin control.Numerical values Description Displays values from a data feed in the spin control. the minimum value is displayed.

 Indent Sets the indent of the title in the bar. Option Labeling Elements Font Description Sets the labeling of individual chart elements.ARIS MashZone Option  Refresh Description Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Load activity icon By default displays an animation if loading is taking a lot of time. Element for which labels are set Sets the font display:     Color Alignment Font Font size Border The following options are available for displaying the border. Formatting The following options are available for formatting the component. 187 . Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. Can be disabled with the option None.

     Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). Shadow Displays the border without. the border can be customized (Set button). In addition.  Form Displays the border with or without header or transparent with title bar.ARIS MashZone Option  Font Description Sets the font display:     Color Alignment Font Font size Display borders Displays a border around the component.  Saturation 188 . with a weak. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.

Step width of the values displayed in the spin control. Option Values .18 Slider Behavior Provides the user with a selection of values in the form of a slider.1.  Minimum/Maximum Smallest/largest value of the spin control.Numerical values Description Displays values from a data feed in the spin control. starting with the minimum. Displays a list of numerical values from a defined value range in the spin control.  Default value Value that is preselected by default. The values in the spin control. Data determination Sets the automatic data determination for the component.From data feed Values . are increased by this value until the maximum is reached. Displays the values as a tooltip.ARIS MashZone 7. Component: Slider The following options are available for configuring the component. Note If no default value is defined. the minimum value is displayed. Display values Display tooltip No selection Displays the values as slider labels.  Refresh Refreshes automatic data determination and sets the time interval for the automatic refresh in seconds  Step width 189 . Does not display any preselected value in the spin control.

 Indent Sets the indent of the title in the bar. Can be disabled with the option None. Sets the font display:     Display borders Color Alignment Font Font size  Font Displays a border around the component.ARIS MashZone Option  Load activity icon Description By default displays an animation if loading is taking a lot of time. Element for which labels are set Sets the font display:     Color Alignment Font Font size Border The following options are available for displaying the border. Formatting The following options are available for formatting the component. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. 190 . Option Labeling Elements Font Description Sets the labeling of individual chart elements.

the border can be customized (Set button). Option Multiple selection Description Enables the selection of multiple time periods in the calendar by means of a pressed mouse button.  Saturation 7. 191 . or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). with a weak. In addition. Shadow Displays the border without.1.19 Time filter Behavior Displays an interactive calendar for configuring a time filter Component: Time filter The following options are available for configuring the component.ARIS MashZone Option  Form Description Displays the border with or without header or transparent with title bar.

 Format Sets the format how the selected time period is to be displayed as text.ARIS MashZone Option Quarters Description Displays the quarters in the calendar. The default value is Automatic. 192 . Display selection Displays the selected time period as text above the calendar. Option Labeling Description Sets the labeling of individual chart elements. Months Displays the months in the calendar.  Default selection Displays a default time period when opening the MashApp. Note Supported formats are    yyyy yyyy-'Q'Q yyyy-MM Formatting The following options are available for formatting the component.   Elements Font Element for which labels are set Sets the font display:     Colors Color Alignment Font Font size Sets the colors of individual component elements.

 Time range Sets the color of the central time range that can be selected. 193 .  Saturation Border The following options are available for displaying the border. Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. Specifies the color of the mouseover effect.  Border areas  Border  Selection  Mouseover  Reflection Sets the reflection effect of particular elements.ARIS MashZone Option  Elements Description Assigns a color scheme to particular component elements. Sets the color of the left and right border area. Sets the color saturation of particular elements in percent (%). Sets the color of the selected time sections. The mouseover effect emphasizes the element that the mouse pointer is currently positioned over.  Indent Sets the indent of the title in the bar. Note You can customize the color of individual elements. Sets the color of the calendar border.

Shadow Displays the border without.ARIS MashZone Option  Font Description Sets the font display:     Color Alignment Font Font size Display borders Displays a border around the component.  Saturation 194 .      Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). with a weak. In addition. or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled.  Form Displays the border with or without header or transparent with title bar. the border can be customized (Set button).

Option Data type Description Data type of the input box    Default value Date Figure Text Value that is displayed by default when opening the MashApp.20 Input box Behavior Enables you to enter values that can be used dynamically in other components. Component: Input box The following options are available for configuring the component.1. 195 . Option Name Display title Description Name of the display component Displays the name of the display component as a title in the header. Formatting The following options are available for formatting the component.   Element Font Element for which labels are set Sets the font display:     Color Alignment Font Font size Border The following options are available for displaying the border.ARIS MashZone 7. Option Labeling Description Sets the labeling of individual chart elements.

     Border Header Background Shadow Reflection Sets the color of the border Sets the color of the header Sets the color of the background Sets the color of the shadow Sets the reflection effect of the background in percent (%) Sets the color saturation of the background in percent (%). or with a strong shadow or shadow within the border Colors Sets the colors of the display component Note Is available if the option Display border is enabled. the border can be customized (Set button).  Saturation 196 .ARIS MashZone Option  Indent Description Sets the indent of the title in the bar. Shadow Displays the border without. with a weak. In addition. Sets the font display:     Color Alignment Font Font size  Font Display borders Displays a border around the component.  Form Displays the border with or without header or transparent with title bar.

XML file (Page 206) Extracts data from an XML file. Note The data source ARIS PPM is available only if you activated an ARIS MashZone Professional Edition license key. The data records are identified using a recurring element. Data feed (Page 210) Manual data feed (Page 211) ARIS PPM (Page 212) Extracts data from an existing data feed..2. RSS or atom feed. Description Extracts data from a CSV file. Extracts data from webMethods Optimize using the webMethods Optimize query interface Quickly determines data from a predefined webMethods Broker server using a real-time buffer server. Database (Page 215) wM Optimize (Page 217) wM Business Events (Page 219) Extracts data from a preconfigured JDBC database. Name CSV file (Page 197) MS Excel file (Page 201) Extracts data from an Excel spreadsheet in MS Excel 97 or MS Excel 2007 format.ARIS MashZone 7. 7. in which the individual columns are separated by a comma. e. A 197 .2 Data sources The following data sources (Page 66) are available in the feed editor (Page 68). Note Empty lines in the source data are automatically removed when importing.g. Note Password-protected MS Excel files cannot be imported as a data source. semicolon. Uses the ARIS PPM query interface to determine data from favorites defined in ARIS PPM. etc.1 CSV file Behavior Reads the CSV file and writes the individual values (character strings) to table columns in the data feed based on the specified parameters. Enables you to define the feed columns and input data directly in the data feed.

ARIS MashZone

change of column is identified by the specified separator between the individual values. Tip The columns to be extracted can be selected in the Configure columns dialog box. The column data types are determined automatically but can be changed in the text (Type as text). Parameter The following parameters are available. Parameter Source Description Text file, with values consistently separated using the same separators. Possible sources: Internet      URL: http address for the source file Do not use UTF-8 to encode URL: Special characters in the URL are masked using UTF-8, this option is disabled by default. Authentication: Specifies whether the source URL is access protected. For basic authentication, a user name and password are required. User: User name for accessing the source file. Password: Password associated with the user for accessing the source file Note If another operator dynamically applies the URL, the URL cannot be edited here.

198

ARIS MashZone

Parameter

Description Google Docs app    Published document Specifies the document to be imported (table) as public. URL: URL to a published document (table) in the Google Docs app. Private document: Specifies the document to be imported (table) as private and personal. The URL of a private table is not public, but is automatically generated based on the document key, user name, and password.  Key: Key of the private document. The document key can be obtained from the Google Docs app.    Worksheet: Indicates the number of the worksheet to be imported. User: User name that is used for accessing the private document in the Google Docs app. Password: User password that is used for accessing the private document. Note If another operator dynamically applies the URL, the URL cannot be edited here. ARIS MashZone server  Path: Path to a directory on the ARIS MashZone server.

Note  The source files must be located in a defined resource directory on the ARIS MashZone server (by default the resources directory in the ARIS MashZone installation directory) or any subdirectory resources\<Directory>.  If another operator dynamically applies the URL, the URL cannot be edited here. Local; upload from client  Path: Local path to source file. The source file is integrated into the database and is included when exporting the data feed. Note This option is available from ARIS MashZone Professional edition. The data feed must have been saved first.

199

ARIS MashZone

Parameter

Description Cache time specifies the time until the source file is imported again, default value: 5 minutes Specification: Mandatory Note The URL or the file path to the source file can be set in the Select source dialog box or using a single value operator, e.g., Create URL.

Separator

Separates the column values; masked separators are treated as single values or part of a value. Separators can be set as required (options: comma (,), semicolon (;), space, tab, pipe ((l)) Default value: Comma (,) Data type: Text Specification: Mandatory

Masking

Protects the enclosed characters against being split at the separator. If column values contain the specified separator, they can be enclosed in a pair of masking characters, e.g., "1,23". Masking characters can be set as required (available masking characters: quotation marks ('), double quotation marks (")) Default value: {None} Specification: Optional

Usage

Indicates whether existing masking characters are to be kept or deleted. Default value: Keep masking characters Specification: Optional

Column name from row

Determines the names of the individual columns from a particular row. Data type: Number Default value: 1 Specification: Optional Note Empty cells are given the name Unnamed column plus the consecutive number of unnamed columns, if other rows in the column contain values and thus the column is not completely empty.

200

ARIS MashZone

Parameter Import values from row

Description Extracts the values from the source file starting from a particular row. Data type: Number Default value: 1 or 2, if the Import values from row option is enabled. Specification: Mandatory Note If the Column name from row option is used, the row from which the values are imported must be after the row containing the column name.

Character set

Character set in which the source file is coded. The default value can be changed manually if the extracted data refers to a different coding type. Data type: Text Default value: Windows-1252 Specification: Mandatory

Error behavior The following error behavior can occur. Error situation The source is not available (e.g., file not available, URL cannot be reached) Not all values in a column match the automatically determined data type A column contains no data The specified user does not have read access to the resource alias containing the source file. The column remains empty. Operator returns no data. Error message. Warning that not all rows could be converted into the target data format. The affected rows remain empty in the result. Behavior Operator returns no data. Error message.

7.2.2

XLS file
Behavior Reads a worksheet of an MS Excel file and writes the individual values to table columns in the data feed based on the specified parameters. The source table can be imported as a list or crosstab.

201

ARIS MashZone

As a list table, a corresponding column is created in the data feed for every non-empty column in the source table. Three columns are created in the data feed as a crosstab. A vertical iteration column corresponding to the first source column with the header, a horizontal iteration column defined in the operator, and a value column. Note  Cells that have the Number data type in Excel are extracted accurately, regardless of their formatting. Therefore, the values in ARIS MashZone can be more accurate than they are displayed in Excel. By contrast, cells that have the Date data type in Excel are extracted based on the format information to maintain the accuracy of the time stamp.  A cell may only have up to 2000 characters.

Tip In the Configure columns dialog box, the columns to be extracted can be selected and their name and data type changed. The horizontal iteration steps (column title) in a crosstab are summarized as Horizontal iteration. The column data types are determined automatically but can be changed in the text (Type as text). Parameter The following parameters are available. Parameter Source Description MS Excel file from Excel 97 (xls) to Excel 2007 (xlsx) versions Size limit: .xls: 10 MB, .xlsx: 1 MB Possible sources: Internet      URL: http address for the source file Do not use UTF-8 to encode URL: Special characters in the URL are masked using UTF-8, this option is disabled by default. Authentication: Specifies whether the source URL is access protected. For basic authentication, a user name and password are required. User: User name for accessing the source file. Password: Password associated with the user for accessing the source file Note If another operator dynamically applies the URL, the URL cannot be

202

ARIS MashZone

Parameter

Description edited here. Google Docs app    Published document Specifies the document to be imported (table) as public. URL: URL to a published document (table) in the Google Docs app. Private document: Specifies the document to be imported (table) as private and personal. The URL of a private table is not public, but is automatically generated based on the document key, user name, and password.  Key: Key of the private document. The document key can be obtained from the Google Docs app.   User: User name that is used for accessing the private document in the Google Docs app. Password: User password that is used for accessing the private document. Note If another operator dynamically applies the URL, the URL cannot be edited here. ARIS MashZone server  Path: Path to a directory on the ARIS MashZone server.

Note  The source files must be located in a defined resource directory on the ARIS MashZone server (by default the resources directory in the ARIS MashZone installation directory) or any subdirectory resources\<Directory>.  If another operator dynamically applies the URL, the URL cannot be edited here. ARIS Business Server    URL: URL to the XLS file on ARIS Business Server User: User name you use to log in to ARIS Business Server. Password: User password you use to log in to ARIS Business Server.

Note The ARIS Business Server connection does not support dynamic URL

203

. Specification: Mandatory Note The URL or the file path to the source file can be set in the Select source dialog box or using a single value operator. whose row number must be specified. if the affected columns contain further data. Cache time specifies the time until the source file is imported again. Default value: First worksheet Data type: Text Specification: Mandatory List table/crosstab Specifies the table type. Horizontal iteration Determines the column names of the individual iteration steps from a 204 . The data feed must have been saved first. Data type: Number Default value: 1 Specification: Optional Note Blank cells in the row with the column name are named Unnamed column + the consecutive number of the unnamed columns. The source file is integrated into the database and is included when exporting the data feed. Note   This option is available from ARIS MashZone Professional edition. Worksheet Worksheet in the source table to be extracted. Create URL. e. only one vertical iteration on the left side of the table is currently supported. This option is not available for crosstabs. upload from client  Path: Local path to source file. Default value: List table Specification: Mandatory Note For crosstabs.g.ARIS MashZone Parameter Description transfer. Column name from row Determines the names of the individual columns from a particular row. Local.

The affected rows remain empty in the result. Operator returns no data.g. but it may contain empty rows or columns. file not available.. specified using column and row coordinates. Data type: Number Default value: 2 Specification: Mandatory Import data range from/to Area of the table from which data is to be extracted. Error situation The source is not available (e. If no upper limit (to) is specified for the data range. A3 to H128 Data type: Text Specification: Optional Note Only a single continuous data range is possible. Error message.ARIS MashZone Parameter from row Description particular row. Behavior Operator returns no data. URL cannot be reached) The specified user does not have read access to the resource alias containing the source file. Data type: Number Default value: 1 Specification: Mandatory Note The column name of the vertical iteration is also determined from this row. Not all values in a column match the automatically determined data type Warning that not all rows could be converted into the target data format. 205 .. all cells above the lower limit (from) are extracted.g. Error behavior The following error behavior can occur. Import values from row Extracts all values from the source file starting from a particular row. Error message. e.

2. Excel crosstab Material Plant Hamburg Paris London Metal 100 89 67 Wood 15. and Glass Vertical iteration Plant with iteration steps Hamburg. The data records are identified using a recurring element. 206 . Paris.3 XML file Behavior Extracts data from an XML file. and London Resulting data feed Plant Hamburg Hamburg Hamburg Paris Paris Paris London London London Horizontal iteration Metal Wood Glass Metal Wood Glass Metal Wood Glass Values 100 15.5 17 28 Glass 166 209 45 Horizontal iteration from row 2 with iteration steps Metal.5 45 89 17 209 67 28 45 7. The individual values are written to table columns in the data feed based on the specified parameters.ARIS MashZone Error situation A column contains no data Example Behavior The column remains empty. Wood.

Parameter The following parameters are available. Password: Password associated with the user for accessing the source file Note The URL can be set in the Select data source dialog box or by using a single value operator. For basic authentication. User: User name for accessing the source file. Note The source files must be located in a defined resource directory on the ARIS MashZone server (by default the resources directory in the ARIS MashZone installation directory) or any subdirectory resources\<Directory>.ARIS MashZone Note The columns to be extracted can be selected in the Configure columns dialog box. the URL cannot be edited here. Authentication: Specifies whether the source URL is access protected. Parameter Source Description XML file Possible sources: Internet      URL: http address for the source file Do not use UTF-8 to encode URL: Special characters are masked using UTF-8. a user name and password are required. If another operator dynamically applies the URL. If another operator dynamically applies the URL. The column types are determined automatically but can be changed in the text (Type as text). 207 . the URL cannot be edited here. is disabled by default. ARIS MashZone server  Path: Path to a directory on the ARIS MashZone server.

only a simple specification for the repeating element is possible. e. Template Template file assigns a format to the XML source file. Data type: Text Specification: Optional Note The options that can be set are the same as those for the source file. Templates: RSS 0.g. If preprocessing is specified. Default value: {None} Data type: Text Specification: Optional Preprocessing XLST file for preprocessing (transformation) of the XML source file before it is extracted. Create URL. upload from client  Path: Local path to source file.0 or Atom. Specifying a template sets a default for the Repeat element parameter and links to the assigned XPath. If another operator dynamically applies the URL. the result table shows the result of this preprocessing rather than the original raw data for the source.91.0. Repeat element XML element that is repeated for each row (Xpath to repeat element). Cache time specifies the time until the source file is imported again. The data feed must have been saved first. 208 .. Specification: Mandatory Note The URL or the file path to the source file can be set in the Select source dialog box or using a single value operator.ARIS MashZone Parameter Description Local. the URL cannot be edited here. RSS 1. The source file is integrated into the database and is included when exporting the data feed. Default value: Root character for XPath (/) Specification: Note When specifying the XPath expression. Note   This option is available from ARIS MashZone Professional edition. RSS 2.

Default value: {Enabled} Specification: Optional Note The column name consists of a series of the tag names of the hierarchy elements last edited. Error behavior The following error behavior can occur. Default value: {Enabled} Specification: Optional Use sub-elements to level Imports the sub-elements for the repeat element up to the specified level. Is automatically identified and can be changed manually. Specification: Optional Import attributes in columns Reads all tag attributes of the repeat element and the processed sub-elements and writes them to separate columns. Import text content in Reads all text contents of the repeat element and the processed columns sub-elements and writes them to separate columns. 209 . this could be: /catalog/journal/article /data/row /catalog/book Character set Character set in which the source file is coded. Default value: {Enabled} Specification: Optional Note The column name consists of a series of the tag names of the hierarchy elements last edited.ARIS MashZone Parameter Description For example. Data type: Text Default value: Extract from source.

Warning that not all rows could be converted into the target data format. Operator returns no data.ARIS MashZone Error situation The specified resource is not available. Parameter The following parameters are available. Error message. The specification for the repeat An empty feed is created. Description Name of the data feed from which columns are imported. Behavior An empty feed is created. The specified user does not have read access to the resource alias containing the source file. Error message.2. Error message. Tip The columns to be extracted can be selected in the Configure columns dialog box. Error message. The affected rows remain empty in the result. element does not match the XML file or is not contained in the XML file. 7.4 Data feed Behavior Extracts data from an existing data feed. The column types are transferred from the source data feed but can be changed in the text (Type as text). Not all values in a column match the automatically determined data type A column contains no data The column remains empty. The XSLT file specified for preprocessing does not match the corresponding XML file as an exception occurs. Specification: Mandatory Parameter Data feed 210 . An empty feed is created.

5 Manual data Behavior Enables you to define the feed columns and input data directly in the data feed. 7. Error message. Source: Constant Specification: Mandatory Parameter Column name Type Column data type: Date. Data type Date    Adjustable: Format. Parameter The following parameters are available. Warning that not all rows could be converted into the target data format. file not available. Operator returns no data.g. The user can create new columns manually. Behavior Operator returns no data. The column remains empty.ARIS MashZone Error behavior The following error behavior can occur. Description Name of the new data feed column. Default format: MM/dd/yyyy. 211 . Number. URL cannot be reached) Not all values in a column match the automatically determined data type A column contains no data The logged in user does not have read privileges for the source data feed. or Text. Day of the week and Language. Permitted date formats (see Format selection box). Error situation The source is not available (e.2. The affected rows remain empty in the result. assign them a data type. and populate the individual columns with the desired values in the Enter data dialog box. Error message..

Data type Number   Adjustable: Decimal separator (comma. Error situation Not all values in a column match the automatically determined data type A column contains no data The column remains empty. 7. 212 . The affected rows remain empty in the result.6 ARIS PPM Behavior Uses the ARIS PPM query interface to determine data from favorites defined in ARIS PPM. Specification: Mandatory Error behavior The following error behavior can occur.ARIS MashZone Parameter Description The following formatting symbols are available for the date format:          Year: y or Y Quarter: Q Month: M Day of the week: E or e Day of the month: d Day of the year: D Hour: H or h Minute: m Second: s Note The day of the week is adjustable if EEEE (day of the week long) or E (day of the week short) is selected as the format. Behavior Warning that not all rows could be converted into the target data format. Default value: Comma Default value: Text. period).2.

e.g. The required favorite must provide the analysis data in the form of a list table.g.g. \Favorites\Process throughput time Folder type: Public for shared favorites or Private for private favorites. For ARIS PPM from version 4. API_umg_en Language: Language in which the data is to be supplied (client language).ARIS MashZone Note     The data source ARIS PPM is available only if you activated an ARIS MashZone Professional Edition license key. Parameter The following parameters are available. Prerequisite You have installed at least the ARIS MashZone Professional edition.. the query API interface must be installed. Tip You can use the pop-up menu for a favorite to copy the corresponding favorite URL in ARIS PPM. de or en Favorites path: Path for the favorite in the favorites tree including favorites folder and name. Select the Copy path as/URL for query interface option in the pop-up menu and paste the URL in the URL input box of the operator..2 onwards. The column types are determined automatically. e.. default value: Public Specification: Mandatory Note 213 . The corresponding ARIS PPM client server must be launched to enable the favorites to be accessed using the ARIS PPM Web service. Parameter URL Description URL that can be used to access the ARIS PPM favorites The URL is made up of the following parameters:       Host: Name of the ARIS PPM client server Port: Port number of the ARIS PPM client server Context: The context name is made up as follows: API_<client name>. e. The columns to be extracted can be selected in the Configure columns dialog box.

such as filter criterion and filter values. Example The character combination of space + ( in the filter value (e. e. 214 . depending on the filter criterion. For detailed information on the ARIS PPM query interface. please refer to the ARIS PPM documentation ARIS Performance Dashboard User Guide.g. which can be used to log into the client Data type: Text Specification: Mandatory Create column for key Extracts all key values from the list table and writes them to separate values columns of the data feed. ABC (123)) can lead to different results. Data type: Text Specification: Mandatory Password Password associated with the specified user. User User name to be used to log in to the client.. If another operator dynamically applies the URL. the URL cannot be edited here.g. date or process throughput time. please observe the predefined syntax of the ARIS PPM query interface (query API). Source: Constant Data type: Text Specification: Optional Value Filter value for the filter entered Source: User input or constant Data type: Text. Date Specification: Optional Note When specifying parameters.ARIS MashZone Parameter Description The URL anchor point can be used to obtain the URL dynamically from a URL operator. Number. Specification: Optional Filter Filter criterion that can be used to filter the values from the list table during the query from ARIS PPM. dimension or KPI from ARIS PPM.

 If you filter for "SOLDTO_NAME(DESC)=ABC (123)". Error message. The affected rows remain empty in the result. Operator returns no data.g. Error message. ARIS PPM searches for the customer with the name = "ABC" and the description = "123".ARIS MashZone   If you filter for "SOLDTO_NAME=ABC (123)". Behavior Operator returns no data.. reached) Not all values in a column match Warning that not all rows could be converted into the target the automatically determined data type A column contains no data The column remains empty. ARIS PPM searches for the customer name "ABC (123)" and does not take into account the description. If you filter for "SOLDTO_NAME(VAL)=ABC (123)". URL cannot be Error message.2. Error in query API X . Error behavior The following error behavior can occur. PPM system is not available. Error situation Authentication or URL is incorrect. data format.Wrong view type . Operator returns no data. 7.Wrong filter or filter could not be resolved The source is not available (e.7 Database Behavior Extracts data from a preconfigured JDBC database. User/password combination does not match. ARIS PPM searches for the customer whose description is "ABC (123)" and does not take into account the name. 215 . file not available.

Tip You can set up the database connections (Page 93) in the Administration. Parameter The following parameters are available.ARIS MashZone The Select data source dialog box lists alias names of configured JDBC URLs or JNDI look-ups on local ODBC data sources as database connections. Error behavior The following error behavior can occur. Prerequisite You have installed at least the ARIS MashZone Professional edition. 216 . Parameter Source Description Reads data from a JDBC database. Cache time specifies the time until the source data is imported again. which can be selected from a list of configured database connections. You can set the columns to be extracted from the database in the Configure columns dialog box. Specification: Mandatory Default value: 5 min User User name for authentication in the selected database Data type: Text Specification: Mandatory Password Password for authentication in the selected database Data type: Text Specification: Mandatory SQL instruction Any SQL instruction for accessing the data in the database Default value: SELECT * FROM <table> Data type: Text Note The single-value anchor point can be used to obtain the SQL instruction dynamically from a single-value operator.

Tip The URL anchor point can be used to obtain the URL dynamically. Parameter The following parameters are available. You can set the columns to be extracted in the Configure columns dialog box. Error message. from a URL operator. Prerequisite You have installed at least the ARIS MashZone Professional edition. Warning that not all rows could be converted into the target data format. 7.g. URL cannot be reached) Not all values in a column match the automatically determined data type A column contains no data The column remains empty. The URL is made up of a base URL and the parameters of the query definition.8 wM Optimize Behavior Extracts data from webMethods Optimize using the webMethods Optimize query interface The operator accesses webMethods Optimize via URL and extracts data using a dedicated query definition. file not available. 217 .ARIS MashZone Error situation Connection failed Behavior An empty feed table is created. Operator returns no data. Column is CLOB or BLOB An empty column is created.. Error message. Database returns an exception An empty feed table is created. Error message.2.. The affected rows remain empty in the result. Warning message. e. The source is not available (e.g.

you must enable the Do not use UTF-8 to encode URL option so that special characters are not masked redundantly. http Host: Name of the webMethods server Port: Valid port number of the webMethods server. 218 . e. Cache time specifies the time until the source data is imported again. you can copy the parameters of a query definition to the clipboard and paste them to the Query box. Query Parameters of a query definition for the webMethods Optimize Web services API Note The following parameters should be included:    Identifiers of data sources (mandatory) Data range (optional) Aggregation information (optional) Tip In webMethods Optimize. If another operator dynamically applies the URL. The parameters are automatically appended to the URL. Specification: Mandatory Default value: 5 min Note The URL can be set in the Select data source dialog box or by using a single value operator.g.ARIS MashZone Parameter URL Description URL for access to webMethods Optimize Web services. By default in the form Protocol://host:port The URL is made up of the following parameters:      Protocol: Protocol for the base URL.. between 255 and 65535 User: User name for authentication for webMethods Optimize Web services Password: User password for authentication for webMethods Optimize Web services Note If the URL inserted is already fully UTF-8 coded. the URL cannot be edited here.

or Data type. Behavior Operator returns no data. Number.ARIS MashZone Parameter Description Data type: Text Specification: Mandatory Note The data in a column to be extracted must be of the Text. You have created real-time buffer instances (Page 100). Warning that not all rows could be converted into the target data format..g. Error behavior The following error behavior can occur. Error situation The source is not available (e. Default value: 15 sec Parameter Source 219 .9 wM Business Events Behavior Quickly determines data from a predefined webMethods Broker server using a real-time buffer server. the URL cannot be reached) Not all values in a column match the automatically determined data type A column contains no data The column remains empty. Parameter The following parameters are available. Prerequisite You have installed the ARIS MashZone Event edition. Error message 7.2. Description Reads data from a real-time buffer that can be selected from a list of configured real-time buffer instances. Cache time specifies the time until the source data is imported again. The affected rows remain empty in the result. If the column has a different data type or the data type cannot be established. the column is automatically assigned the Text type.

Error message The column remains empty.ARIS MashZone Parameter Description Specification: Mandatory Password Password to be used for authenticating the data source at the real-time buffer instance Data type: Text Specification: Mandatory Error behavior The following error behavior can occur. or Date data types Insert (Page 232) Inserts new columns in the data feed. Description Name Data feeds Combine (Page 223) Merges two data feed rows by comparing two or more key columns Concatenate (Page 225) Adds the rows from the right-hand table after the final row of the left-hand table and merges columns of the same name and type.3 Operators The following operators (Page 70) are available in the feed editor (Page 68). Changes the data types of the specified columns to the Number. Copy (Page 226) Columns Change data type (Page 226) Creates up to four independent copies of the data feed. Each of the columns can be populated with an initial value. the URL is unavailable) A column contains no data Behavior Operator returns no data. Text. Error situation The source is unavailable (e.. Duplicate (Page 234) Copies the specified columns of the data feed to new or 220 .g. 7.

Link texts (Page 257) Links the values of the specified columns or text fragments one row at a time Find text (Page 258) Searches a search column one row at a time for the specified search text and writes the position of the text found to a numerical target column. Average (Page 246) Calculates the average values of two or more columns one row at a time.ARIS MashZone Name Delete (Page 233) Rename (Page 234) Description existing columns of the same type Deletes the specified columns from the data feed Changes the names of the specified columns of the data feed Calculation Aggregation (Page 235) Combines rows if identical values occur multiple times in specified dimension columns. The numerical values in the remaining columns are combined using Average. or a closed area from imported GPS data. Geo aggregation (Page 238) Calculates an entire route. Goal accomplishment (Page 248) Calculates the degree of goal accomplishment of column values one row at a time. Sum. The operands are columns of the incoming data feed. Rounding (Page 247) Rounds the number of decimal places (accuracy) of numerical column values. user input. 221 . Replace (Page 255) Changes the value in the specified column one row at a time if certain conditions are met. Filter (Page 252) Filters the data feed one row at a time using particular conditions. or Number. based on the rating and the two planned values for 100% and 0%. Column values Geocoding (Page 250) Imports a column containing addresses and uses the Google Maps API to determine the corresponding coordinates (lat/long) and writes them to the relevant target columns. constant values. or incoming values from other operators. consecutive legs (sections of routes). Min/Max. Arithmetic (Page 225) Executes various arithmetical calculations.

Replace date field (Page 282) Replaces the specified date fields (e. or writes the text to a target column. About (Page 269) Provides system information on the logged-in user or the current date. Convert text (Page 262) Converts all characters in the source column one row at a time. the first value found is returned. The operator can also generate a random number.. Replace text (Page 260) Replaces text in a search column with the specified Find or Replace text one row at a time. or Date data types. Text. Data feed to value (Page 263) Filters a single value from the data feed.g.ARIS MashZone Name Extract text (Page 259) Description Creates an extract from each value of a text column starting from the specified position and with the specified length and writes the result to a target column. Link text (Page 267) Create URL (Page 267) Combines the specified text fragments Enables the creation of any URL by entering individual URL elements in corresponding input boxes. Date Rounding (Page 277) Converts date values from a date column to a rougher time unit and writes the results to a target column. Move (Page 280) Moves a date by a specified amount of time in a given direction and writes the results to a target column. Individual values Copy single value (Page 263) Creates an independent copy of a single value. without changing the input value. year) in all rows of the selected source column with the value specified in the Date field. based on the specified transformation rule. If the filter delivers multiple values. Convert (Page 277) Converts date values from a date column into a rougher time unit and writes the results to a target column. Values to data feed (Page 266) Converts an individual value into a data feed so that it can be connected to an operator. 222 . Change data type (Page 271) Changes the data type of the incoming single value to the Number.

Several pairs of key columns can be specified. The main table is linked to the upper left anchor point. Finishes the feed definition. to which all columns from the second table are added except for its key columns.3.1. Both key columns must have the same data type. Parameter The following parameters are available. The key columns for the left and right table are defined in pairs.1 7.3. One table is defined as the main table. For every row in the main table. the case and spaces in the column names can be taken into account. 7. a check is made as to whether there is a row in the right table that has the same values in all key column pairs.ARIS MashZone Name Determine earliest/latest date (Page 284) Other Output (Page 286) Description Searches a date column for the latest or earliest date and transfers these rows to the results table. The operator is inserted in the feed definition by default and cannot be deleted. Source: Source tables. The penultimate operator of the feed definition must be connected to the Output operator. Data type: Text Specification: Mandatory Note In addition. Description Name of the left or right key column.1 Data feeds Combine data feeds Behavior Merges two data feeds by comparing the values in key columns one row at a time. These rows are then combined into one row. Parameter Left/right column 223 .

and which therefore can be merged. Error behavior The following error behavior can occur. Specification: Optional Always transfers the key values from both data feeds. regardless of whether there are matching rows in the right data feed. Rows with matching key values are merged. _L or _R is appended to the names of these columns.ARIS MashZone Parameter Include key values of left data feed Description Always transfers all key values from the left data feed (main data feed). 224 . The operator returns no data. Specification: Optional Allow multiple values Allows multiple occurrences of rows with identical key values in the right table. missing. Since the individual table columns are identified by name when being imported you need to ensure that the columns of the table area to be imported have unique names. Rows in the right data feed whose key values do not occur in the left table are omitted. other than the key columns. Specification: Optional Include identical key values of both data feeds Include key values of both data feeds Transfers only the rows whose key values match in the two data feeds. as all combinations of the rows with identical key values are transferred to the results. Rows with matching key values are merged. This can lead to a large number of result rows. even if their key values do not occur in the other data feed. same key values several times. Error message.  If other columns with identical names occur in both feeds. Specification: Optional Note   The key columns have the name they had in the left table. Behavior Error situation One of the two source tables is The available table is returned unchanged. The right table contains the Error message. but the Allow multiple values option is not enabled.

Specification: Mandatory Example Left table Column 1 1 2 3 Right table Column 1 4 5 6 Result Column 1 1 2 3 4 5 6 3 4 a b c 1 2 3 Column 2 1 Column 3 Column 3 Column x (L) (R) 1 2 3 4 Column 2 Column 3 Column x a b c 1 2 3 Column 2 1 Column 3 1 2 Parameter Left/right data feed 225 .ARIS MashZone 7. Description Two data feeds to be combined.1. Parameter The following parameters are available.2 Concatenate data feeds Behavior Adds the rows from the right-hand table after the final row of the left-hand table and merges columns of the same name and type.3.

Action Conversion of Text to Number Conversion of Number to Text Text representation of the number in the specified format. 226 . Text.3. or Date data types Result Numerical value of the text taking into account the decimal separator.2.3. Specification: Mandatory Parameter Data feed 7.2 7.1. any thousand separator is detected automatically. Parameter The following parameters are available.3.1 Columns Change data type Behavior Changes the data types of the specified columns to the Number. the results are formatted in the internal date format.3 Copy data feeds Behavior Creates up to four independent copies of a data feed. Note If nothing is specified here. Description Data feed to be copied.ARIS MashZone 7. Note If the decimal separator is set correctly.

but without grouping characters. Conversion of Date to Text Text representation of the date in the internal format. or minute. month. year. the corresponding language must be specified. day of the week. based on the specified format and. Date values before the common era are not supported. The time format must be specified.g. separated by separators. e. all other symbols except Y and y for years are ignored. If no language is specified. or based on the language and the specified format Note Non-editable text must be enclosed in quotation marks. If no format is specified. Conversion of Number to Date Date value corresponding to the value of the number as milliseconds since 01/01/1970 Conversion of Date to Number Number of milliseconds since 01/01/1970 Internal number format Anglo-Saxon style number format with a period as the decimal separator and at least one decimal place. The time format is made up of sequences of characters. Note The date must be in the AD era. where applicable. which stand for date fields. The format and language specifications are optional. the data is output in the internal date format. the language. 227 .. The only decisive factor is then the order of Q/q and Y/y. English (EN) is applied as the default language.ARIS MashZone Action Conversion of Text to Date Result Date value of the text in the internal format. When using the Q or q symbol for quarters. in the relevant language. Non-editable text must be enclosed in quotation marks. In addition.

2. This is the transfer format. It is expected that a source value containing a quarterly date consists of just two sequences of figures indicating the year and the quarter. The section of the format that is not enclosed between single quotation marks is used to determine whether q / Q or y / Y appears first. Procedure: 1. e. Source: Source table Data type: Date. Parameter The following parameters are available.g. Number. If q or Q appears first. or Text Specification: Mandatory New type New column data type Default value: Text Specification: Mandatory Format Time format for conversion from date type to text type and vice versa. Prerequisites for conversion of text into quarterly date values: 1. 2. e. 3. otherwise yyyy-MM-ddThh:mm:ss The number of digits corresponds to the accuracy of the date. The (first) two sequences of digits are determined from the source value. otherwise the reverse. Quarterly specifications These are indicated by a Q within the section of the format that is not in single quotation marks. the first sequence of digits is interpreted as the quarter and the second as the year. and the remaining digits are omitted.. The following formatting symbols are available when converting date into text:  Year: y or Y 228 . after and between them.. quarter Q/y or Q Y.ARIS MashZone Internal date format yyyy-Q for specifying to the nearest quarter. Quarter 04/2009. The pattern uses Y or y as the symbol for the year and Q or q for the quarter.g. Parameter Column Description Name of the column to be changed. Any non-numerical characters can occur before.

.ARIS MashZone Parameter Description               Quarter: Q Month: M Calendar week: w Day of the week: E or e Day of the month: d Day of the year: D Hour: H or h Minute: m Second: s AM/PM: a Time zone: z (e. -0900) Era: G (must always be AD) Default value: MM/dd/yyyy The following formatting symbols are available when converting text to date:                  Year: y Quarter: Q Month: M Calendar week: w Week of the month: W Day of the week: E Day of the month: d Day of the year: D Hour (0-23): H Hour (1-24): k Hour AM/PM (0-11): K Hour AM/PM (1-12): h Minute: m Second: s AM/PM: a Time zone: z RFC time zone: Z 229 .g..g. GMT) RFC time zone: Z (e.

tab character. yy and yyyy return 2009. Specification: Mandatory Language Language if the target format is of the Date type. In this case.). i. FEB. underscore (_). however. 230 . an e/E number < 4 returns the day abbreviations (MON. Exceptions: For a month. the Q/q can be combined with any other symbols. and space. Only the order of Q/q and Y/y is then decisive. a language must also be specified so that the name of the month can be transformed correctly. etc.ARIS MashZone Parameter Description  Era: G Default value: yyyy-MM-dd'T'HH:mm:ss. comma (. Available languages: de and en.). RFC time zone (Z) and week of the year (w) are case-sensitive. Specification: Mandatory when using names of months and names of days of the week Decimal separator Separator for the decimal places. while e/E = or > 4 returns the full name of the day. etc. but may only occur once (not QQ/yy). yyyy returns the year 9 and yy the year 2009. Permitted separators in both cases: Dash/minus (-). When converting text to date.) and <3 if it is specified as a figure. For a year format such as 2009. time zone (z).) Specification: Mandatory Note  The characters in the time format can be combined in any order and repeated any number of times. colon (:). When formatting date values as days of the week for a date to text conversion. period (. if the Q or q symbol is used for quarters all other symbols except Y and y are ignored. minute (m). the number of characters must be >= 3 (MMM or MMMM) if the month is specified in text format (JAN. For the reverse conversion from date to text. For a year format such as 09.   Only the month (M). slash (/). TUE. y can be specified any number of times..e. if the target format is of the Number type. Default value: Comma (.).

09" -> "d . Warning message The incorrect cell remains empty in the target column. Error: If the character string is still not successfully changed. 3. No message is output.yy' at 'hh:mm' '.MM. The data type change for the column is continued for the remaining rows. Text -> number: Column contains character strings that cannot be directly interpreted as numbers. e.. e. E. The data type change for the column is continued for the remaining rows. or -E is embedded in figures.g. These character strings may only consist of the year. Error situation Text -> date: Time format contains characters that are not indicated by quotation marks and are not available as date characters in the transferred language.  All other character strings must be enclosed in single quotation marks (').y" but not "2.yy 'at' hh:mm.. +e. Text -> date: Column contains empty cells The incorrect row remains empty.ARIS MashZone  Quarter entries are currently only possible in the form YYYY-Q or YYYY-QQ.M . Error behavior The following error behavior can occur. Behavior The operator returns no data. separator.3 .g.g. the affected cell remains empty.. Warning message. Warning message. or 'On 'dd.y".M . e. +E. because they contain units. 231 . 'On' dd.  The space pattern in the source and target format must match. Error message.09" -> "d . they are interpreted as part of "computerized scientific notation" of the number and are not ignored. e. Text -> date: Column contains non-empty character strings that do not match the time format. and quarter. Tolerance: All non-numerical characters are ignored and a numerical value is created from the rest. Exception: If.MM. Spaces can be inside or outside. "2 .

Number.M. Examples Source format: "22. Behavior The number is rounded to a value without decimal places and the The source number has decimal data type is changed using this value. or Text Specification: Mandatory Parameter Column name 232 .2 Insert columns Behavior Inserts new columns of Text. Source: Source table Data type: Date. Each of the columns can be populated with an initial value.2. quarter' y or "QQ/yyyy".YYYY " Source format:"03/22/09 30:24 PM" Time format: "MM/DD/YY hh:mm a" or "M/d/y HH:mm A" but not "M/d/y HH:MM A" or "m/d/y HH:mm A" Source format: "Time: 2009-FEBRUARY-01T22:33:44" Time format: "Time: 'y-MMM-d'T'h:m:s" or "'Time:' y-MMMMM-d'T'h:m:s".y" or "DDDD. but not "YQ" 7.MM.ARIS MashZone Error situation Number -> date: places.3. Number.3. or Date data type into the data feed. but not "'Time: 'y-MM-d'T'h:m:s" Source format: "3.2009" Time format: "d. Description Name of the new column. Parameter The following parameters are available. quarter 2009" Time format: "QY" or "Q'.YYYY".MMM. but not "DD.

The values start at 1 or the value entered in the Value input box and increase by a value of 1 in each subsequent row.. this has no effect on the result table. Specification: Optional Note This only applies to numerical columns.e. Source: User input or constant Data type: Depends on the data type of the source column. Default value: Text. 233 . i. Specification: Mandatory Fill column with ascending values Fills the new column with ascending values.3 Delete columns Behavior Deletes the specified columns from the data feed.3. Existing columns are not overwritten by new columns with the same name. Value Initial value of the new column. Behavior Error message Error situation Value does not match the column data type. Multiple columns with the same name cannot exist in a table. the original column values are retained. or Text. Parameter The following parameters are available. Specification: Optional Note If a name of an existing column is specified as the column name. regardless of its data type. Date.ARIS MashZone Parameter Type Description New column data type.2. Error behavior The following error behavior can occur. Number. 7.

Source: Source table Data type: Date. it is replaced.4 Duplicate columns Behavior Copies the specified columns from the data feed to new or existing columns of the same type.3.2. Source: Constant Data type: Corresponds to source column. regardless of type. or Text Specification: Mandatory Parameter Source column Target column Name of the new or existing column.3. Description Name of the column to be duplicated. or Text Specification: Mandatory 7. Parameter The following parameters are available. All columns can be duplicated. Source: Source table Data type: Date.5 Rename columns Behavior Changes the names of the specified columns from the data feed. 7. If it does exist.2.ARIS MashZone Parameter Column Description Name of the column to be deleted. Number. it is created. Specification: Mandatory Note If the target column does not exist. Number. The data type of the column is retained. Parameter The following parameters are available. 234 .

Source: Constant Data type: Corresponds to source column.3. This also applies if no columns are specified for aggregation. 235 . If no dimension column is specified. Behavior Error message Error situation Column name and new name are identical.3. Error message 7. only a single row is created and all values in the columns to be aggregated are combined to a single value for each column. Maximum.3.e. Number. i.3 7.1 Calculation Aggregation Behavior Combines rows if identical values occur multiple times in specified dimension columns. Specification: Mandatory Error behavior The following error behavior can occur. Source: Source table Data type: Date. or Text Specification: Mandatory New name New name of the renamed column.ARIS MashZone Parameter Column Description Name of the column to be renamed. One or more numerical columns in a table are aggregated using no. or Number. The numerical values in the remaining columns are combined using Average. In all rows that have the same values in all dimension columns.. No rows are created for combinations that do not occur in the original table. the result contains one row for each combination of dimension columns. Sum. one or several dimension columns. Minimum. New column name already exists. the values in the columns to be aggregated are combined into one row based on an aggregation rule.

Data type: Number Default value: {None} Specification: Optional Aggregation type Aggregation type for the column to be aggregated: Average. if aggregation column selected. containing a weighting factor for each row. Maximum Finds all rows that have a particular combination of values in the dimension columns and returns the highest value that occurs in these rows in the column to be aggregated. Default value: Average. 236 . Aggregation type Minimum Description Finds all rows that have a particular combination of values in the dimension columns and returns the lowest value that occurs in these rows in the column to be aggregated. Specification: Mandatory. Source: Source table Data type: Date.ARIS MashZone Parameter The following parameters are available. For weighting purposes. Specification: Optional Aggregation type The following aggregation operations can be applied to the columns to be aggregated. if aggregation column selected. Sum. Number. Parameter Dimension column Description Name of dimension column. Average value Finds all rows that have a particular combination of values in the dimension columns and returns the average of the values in the column to be aggregated. a numerical column for weighting of the rows can be specified for each column to be aggregated. Source: Aggregation column is transferred from the source table. The weighting information is combined as a pair with the source column. or Text Default value: {None} Specification: Optional Aggregation column Name of the column to be aggregated. Minimum. an additional column can be specified for each source column. Weighting If the aggregation type is Average or Sum. Maximum or Number.

must be set. If no aggregation columns or dimension columns are specified. an additional column can be specified for each source column. Number Finds all rows that have a particular combination of values in the dimension columns and returns the number of values in the column to be aggregated. Error behavior The following error behavior can occur. Values Dim 1 Dim 2 1 A B X Y 1 3 Values 2 2 4 Weight (values 2) 3 4 237 .ARIS MashZone Aggregation type Sum Description Finds all rows that have a particular combination of values in the dimension columns and returns the sum of the values in the column to be aggregated. Example The following table is to be aggregated based on the Dim 1 and Dim 2 columns. Behavior The operator returns no data. Last row Finds all rows that have a particular combination of values in the dimension columns and returns the value of the row with the highest row index (according to the index column). The weighting information is combined as a pair with the source column. containing a weighting factor for each row. Error situation The columns to be aggregated are not all numerical. For weighting. the incoming table remains unchanged. or both. First row Finds all rows that have a particular combination of values in the dimension columns and returns the value of the row with the lowest row index (according to the index column). Note At least one dimension or aggregation column. Error message.

One or more numerical columns in a table (aggregation columns) can be aggregated using no. The Weighting (values 2) column is used for weighting the Values 2 column one row at a time.3.3. If no dimension column is specified. This also applies if no columns are specified for aggregation. i.2 Geo aggregation Behavior Calculates an entire route. the values in the columns to be aggregated are combined into one row based on an aggregation rule.e. consecutive legs (sections of routes). one or several dimension columns. or a closed area from imported GPS data. No rows are created for combinations that do not occur in the original table. only a single row is created and all values in the columns to be aggregated are combined to a single value for each column. 238 .57 (4*4 + B Y 12 (3+9) 10*3)/(4+3) 9. Result: Sum (values Dim 1 Dim 2 1) Average (values 2) 5.ARIS MashZone Values Dim 1 Dim 2 1 C A B C Z X Y Z 5 7 9 11 Values 2 6 8 10 12 Weight (values 2) 3 4 3 4 The sum is to be calculated for the Values 1 column and the average for the Values 2 column.43 (6*3 + C Z 16 (5+11) 12*4)/(3+4) 7. the result contains one row for each combination of dimension columns. In all rows that have the same values in all dimension columns..43 (2*3 + A X 8 (1+7) 8*4)/(3+4) 6.

3. 10. Leg: Calculates consecutive sections of routes from the GPS data. Specification: Mandatory Index column Indicates the column determining the order of coordinates. 239 . If multiple rows have the same index value or if index values are missing the order of these rows is not defined and can change with each calculation. Longitude (long) Indicates the column containing the longitudes.99). Latitude (lat) Indicates the column containing the latitudes. -1. Data type: Number Specification: Mandatory Note Index values can begin with any value.56. Parameter Mode Description Indicates the usage of the GPS data imported. Area/closed route Calculates a closed area from the GPS data. Corresponds to the entire route with the first waypoint added as the last waypoint so that the route is always closed.ARIS MashZone Prerequisite You have installed at least the ARIS MashZone Professional edition.g. Parameter The following parameters are available. and the order of indices may have gaps (e. Data type: Number Specification: Mandatory Note The coordinates must be entered in the data source as decimal values (decimal degrees). 4. Cells with missing index values are ignored. 6. Data type: Number Specification: Mandatory Note The coordinates must be entered in the data source as decimal values (decimal degrees). -3.    Entire route: Calculates an entire route from the GPS data. You have installed the Google Maps API key in Administration (Page 87).

or Text Default value: {None} Specification: Optional Aggregation column Name of the column to be aggregated.  Optimize display for zoom Reduces or increases the number of waypoints depending on the zoom factor specified. Specification: Mandatory if the option Limit the maximum number of waypoints is enabled. Default value: Average. Specification: Optional.ARIS MashZone Parameter Route identification columns Description Name of the columns used for assigning the coordinates to particular routes (dimension column). requires the option Optimize number of waypoints to be enabled. Minimum. if aggregation column selected. Specification: Optional Route optimization Enables an optimal reduction of waypoints calculated for a route and thus reduces the calculation effort for a route. first row. a numerical column for weighting of the rows can be specified for each column to be aggregated. Source: Aggregation column is transferred from the source table. Data type: Number Default value: {None} Specification: Optional Aggregation type Aggregation type for the column to be aggregated: Average. last row. Number.  Optimize number of waypoints Reduces the number of waypoints that are not required for the global and local characteristics of the route. Number. if aggregation column selected. Data type: Date. Specification: Mandatory. 240 . Maximum. Weighting If the aggregation type is Average or Sum.  Maximum number Maximum number of waypoints to be calculated. Sum. Specification: Optional   Tolerance Limit the maximum number of waypoints You enter the maximum number of waypoints of a route to limit this number.

First row Finds all rows that have a particular combination of values in the dimension columns and returns the value of the row with the lowest row index (according to the index column). an additional column can be specified for each source column. The column name can be transferred from the source table or freely entered. containing a weighting factor for each row.ARIS MashZone Parameter Target column Description Name of the column to which the result is written. an additional column can be specified for each source column. The weighting information is combined as a pair with the source column. Aggregation type Minimum Maximum Finds all rows that have a particular combination of values in the dimension columns and returns the highest value that occurs in these rows in the column to be aggregated. The weighting information is combined as a pair with the source column. 241 . Data type: Text Default value: Result_1 Specification: Mandatory Aggregation type The following aggregation operations can be applied to the columns to be aggregated. Sum Finds all rows that have a particular combination of values in the dimension columns and returns the sum of the values in the column to be aggregated. For weighting purposes. containing a weighting factor for each row. For weighting. Description Finds all rows that have a particular combination of values in the dimension columns and returns the lowest value that occurs in these rows in the column to be aggregated. Average value Finds all rows that have a particular combination of values in the dimension columns and returns the average of the values in the column to be aggregated. Last row Finds all rows that have a particular combination of values in the dimension columns and returns the value of the row with the highest row index (according to the index column). Number Finds all rows that have a particular combination of values in the dimension columns and returns the number of values in the column to be aggregated.

Route Index 1 Width Length Name North KPI Time 22. but is not The existing column is replaced. the columns Time and Name are aggregated using the First row aggregation type.2010 47.207305 route South 44 08:26:05 13. Error message Example The following table is to be aggregated based on the Route column (route identification column (dimension column)).ARIS MashZone Error behavior The following error behavior can occur.338166 7.08. The KPI column is aggregated using the Sum aggregation type.234966 7.338235 7.08.08.2010 49. of the TEXT type. Error situation Index column missing Behavior Error message Empty cells in the index column Error message Longitudes column missing Latitudes column missing Error message Error message Double indices in index column Error message Target column exists.191524 route North 2 17:32:27 22.2010 A 2 A 48 B 3 A 59 B 60 B 49.08.191487 route South 4 17:03:21 13.08.2010 47.207785 route 45 08:59:17 Result of Entire route mode: Route Coordinates Name KPI Time 242 .2010 49.338396 7.2010 47.191025 route South 3 16:56:01 13.234568 7.206987 route North 32 08:09:45 22.235023 7.08.

as encoded string South route 123 13.7.338235.08.191524 A 49.207305 47.7.7.338396.7..3 Arithmetic Behavior Executes various arithmetical calculations.3.235023. as encoded string 47.08..338235.207305 B 47.3.19124 Name KPI Time A 49.207785 .207305 ..08. The calculation always runs from top to bottom.. as encoded string 47. as encoded string South route 89 South route 76 North route 7 North route 6 Name KPI Time 22....7.234966. 7.191025 .08... The values are set against each other one row at a time according to the specified calculation type. as encoded string 47.235023..338235. two operands are always set against each other one row at a time and the result from the first two operands is then set against the third operand. 7.206987 North route 9 22.7.7.2010 08:09:45 13.08.207785 .234568.7. In other words.191025 .206987 B 47.191487 .234568.7.191487 A 49. 243 .2010 17:32:27 22. The arithmetic operator sets any number of numerical operands against each other.191487 49..ARIS MashZone Route Coordinates 49.338396.2010 08:09:45 Result of Leg mode: Route Coordinates 49..2010 08:26:05 7.2010 17:32:27 B 47.7.338166.234966.234966. as encoded string 49.2010 17:03:21 13.08.338166.7.7.

Parameter The following parameters are available. otherwise two numerical operands. Data type: Number Specification: Mandatory 244 .ARIS MashZone Note Compounding can be mapped by using a separate operator for each expression in brackets. Source: Source table. user input or incoming values from other operators. Parameter Operands Description One numerical operand per operation for the "Square" and "Square root" calculation types. constants.

245 . and atan in degrees.ARIS MashZone Parameter Calculation type Description Addition (+) Subtraction (-) Division (/) Multiplication (*) Percent (%) Adds two columns row by row Subtracts 2 columns row by row Divides the first column by the second column Multiplies two columns row by row Multiplies row by row the second column with the percent value of the first column Square (x²) Root Sine (sin) Calculates the square of a column Calculates the square root of a column Calculates for a column the sine value of an angle in degrees Cosine (cos) Calculates for a column the cosine value of an angle in degrees Tangent (tan) Calculates for a column the tangent value of an angle in degrees Arcsine (asin) Calculates for a column the arcsine of an angle in degrees Arccosine (acos) Calculates for a column the arccosine of an angle in degrees Arctangent (atan) Calculates for a column the arctangent of an angle in degrees Logarithm (lg) Logarithm (ln) Power (exp) Calculates for a column the common logarithm Calculates for a column the natural logarithm Calculates for a column S1 the S2nd power of S1 (S1 to the power of S2) Minimum (min) Maximum (max) Absolute value (abs) Calculates the minimum of column 1 and column 2 Calculates the maximum of column 1 and column 2 Calculates for a column the absolute value Default value: Addition (+) Specification: Mandatory Note You need to specify the source values for the trigonometric functions sin. cos. acos. tan. asin.

The column name can be transferred from the source table or freely entered.ARIS MashZone Example Example: Column 1 1000 2000 3000 Result = Column 1 + Column 2 -– Column 3 Column 2 2000 3000 4000 Column 3 50 1000 1200 2950 4000 5800 Result 7. If the target column does not exist.4 Average Behavior Calculates the average of the values from several numerical source columns one row at a time. Data type: Number Default value: Result_1 Specification: Mandatory 246 . a single value from a feed (single-value operator). it is created. Data type: Number Specification: Optional Target column Name of the column to which the result is written. Column is transferred from the source table.3. an input value or a constant. writes the result to a target column and overwrites any existing values there. Data type: Number Specification: Mandatory Parameter Column Weighting Weighting factor. Parameter The following parameters are available.3. Description Name of the column for which the average value is calculated. which can be specified for each column to be aggregated: a column with values.

the decimal places are ignored. the value is rounded down if the next decimal place is < 5. 247 . A row does not contain a value The value 1 is used in the calculation for missing values. weighting factor and does not have a default value. Behavior The operator returns no data. it is created.3. in any of the source columns. this value is the result. A row contains no values in one Missing values are ignored in the calculation. Error message.5 Rounding Behavior Rounds the values from a numerical source column to the specified number of decimal places (accuracy). When rounding. If the target column does not exist. value in one other source column. weighting factor but has a default value. if necessary multiplied by the weighting factor. Error situation The selected columns are not all numerical.ARIS MashZone Error behavior The following error behavior can occur. Values that already have the same number or fewer decimal places than specified remain unchanged. writes the results to the target column and overwrites any existing values there. Error message.. An input box does not provide a The operator returns no data. The operator returns no data. the integer value is used. A single-value operator does not return a weighting factor. i.e.3. in one or more weighting columns. otherwise it is rounded up. If the accuracy itself is specified as a decimal number. A row does not contain a value The affected rows are ignored. If there is only a or more source columns. 7. Error message. An input box does not provide a The default value is used for the calculation. but there is at least one column that contains a value.

Error message. 7. Parameter Source column Description Name of the column whose values are rounded. Error message. Accuracy column does not exist. 248 .3.3. Source: Source table. Error situation Accuracy column exists. The operator returns no data. Behavior The operator returns no data. or a constant.6 Goal accomplishment Behavior Calculates the degree of goal accomplishment of column values one row at a time. input value.ARIS MashZone Parameter The following parameters are available. Data type: Number Specification: Mandatory Target column Name of the column to which the result is written. Source: Source table Data type: Number Specification: Mandatory Accuracy Numerical value specifying the number of decimal places. The column name can be transferred from the source table or freely entered. Parameter The following parameters are available. based on the rating and the two planned values for 100% and 0%. single-value operator. Data type: Number Default value: Result_1 Specification: Optional Error behavior The following error behavior can occur. but is not of the NUMERIC type.

or a constant. or a constant. input value. Source: Source table. Source: Source table or constant. e. e. input value. single-value operator. Data type: Text Default value: Positive: Specification: Mandatory 100% relates to target values that are compared with the source values. Data type: Number Specification: Mandatory Note Goal accomplishment depends on the rating:   Positive rating: Target values <= source values Negative rating: Target values >= source values Target column Name of the column to which the result is written. single-value operator. sales revenue Negative: Higher values are assessed as negative. process throughput time.g. Possible values: Positive or Negative   Positive: Higher values are assessed as positive.g.ARIS MashZone Parameter Value column Description Name of the column for which the goal accomplishment is calculated. Data type: Number Specification: Mandatory Note Goal accomplishment depends on the rating:   Positive rating: Source values >= target values Negative rating: Source values <= target values 0% relates to target values that are compared with the source values. Source: Source table.. 249 .. Source: Source table Data type: Number Specification: Mandatory Rating Assessment of the column values for which the goal accomplishment is calculated.

For unsigned API keys. country.3.4. 250 . In addition to the Latitude (lat) and Longitude (long) target columns you can create further columns containing information on the events and their individual address fields.500 in 24 hours. The operator returns no data.ARIS MashZone Parameter Description Default value: Result_1 Data type: Number Specification: Optional Error behavior The following error behavior can occur. Error situation Behavior No value specified for the upper Error message limit. and zip code. Google limits the maximum number of queries to 2. city. The operator returns no data. Calculation value column exists. e. Error message. Calculation value column does not exist. but is not of the NUMERIC type. No value specified for the lower Error message limit.4 7. Note The number of possible Google Maps queries depends on the Google Maps API key registered. Error message.1 Column values Geocoding Behavior Imports a column containing addresses and uses the Google Maps API to determine the corresponding coordinates (lat/long) and writes them to the relevant target columns.3. 7.g. level of accuracy.

Source: Source table Data type: Text Specification: Mandatory Options Specify search area Provides further options Restricts the search to a particular region (country) in Google Maps. Data type: Number Default value: Result_lat Specification: Optional 251 . Default value: US (United States) Specification: Optional Note If you do not specify a region. If no region can be identified. Parameter Address column Description Name of the column containing the addresses to be imported. Multiple results Allows output of multiple results if multiple identical addresses were found. A global search is not supported. Data type: Number Specification: Optional Maximum number Specifies the maximum number of events. You have installed the Google Maps API key in Administration (Page 87). Default value: 1 Specification: Optional Sort results by accuracy Latitude (lat) Sorts multiple identical events by their accuracy. Specification: Optional Name of the column into which the latitudes determined will be imported. Google Maps conducts a default search in the region US (United States). Parameter The following parameters are available.ARIS MashZone Prerequisite You have installed at least the ARIS MashZone Professional edition. Google Maps tries to determine a region from the address data first.

g. Error situation Google does not deliver any results Google returns error code Address column not of TEXT type Target column exists. Data type: Number Default value: Result_long Specification: Optional Configure additional result columns Enables you to specify additional columns into which data determined by Google Maps will be imported.2 Filter values Behavior Filters the data feed one row at a time using particular conditions. You can select address boxes on the Base fields. of the proper type.ARIS MashZone Parameter Longitude (long) Description Name of the column into which the longitudes determined will be imported. Colum values of the Number. Text. but is not The existing column is replaced. or Date type are either let passed or blocked. An appropriate filter criterion can be selected depending on the data type. Return results in the following language: Returns results in the language selected Specification: Optional Error behavior The following error behavior can occur. and Other fields tabs.4. Error message Error message Behavior Error message 7.    Result column: Name of the result column to be created Short name: Displays the short version of the column name.3. e. 252 . Administrative area. city or region.

Possible actions:   if   all conditions are met one condition is met Let values pass (from source table) Block values (from source table) Default value: Let values pass if all conditions are met. Condition not met: If a comparison value is missing. Comparison value missing   Condition met: If a comparison value is missing. Source: Source table Data type: Number. Specification: Mandatory Comparison operator Operator that compares the values from the source column with the comparison values. Specification: Mandatory Column Name of the column whose values are filtered. single-value operator. or a constant Data type: Must be identical to that of the source column. Default value: is equal to Specification: Mandatory Comparison values Values that are compared with the values from the source column. Available comparison operators depend on the data type of the source column. user input. Text. Date. Source: Source table. the condition is assumed to not be met. Parameter Action Description Executed if particular conditions are met.ARIS MashZone Parameter The following parameters are available. the condition is assumed to be met. Specification: Mandatory 253 .

Error message. 254 .ARIS MashZone Comparison operators Data type Figure Comparison operators         Text         Date        Is equal to Is not equal to Is less than Is less than or equal to Is greater than Is greater than or equal to Is empty Is not empty Is equal to Is not equal to Starts with Ends with Contains Does not contain Is empty Is not empty Before After In Before or on On or after Is empty Is not empty Error behavior The following error behavior can occur. Error situation The comparison value type does not match the column Behavior The operator returns no data.

Default value: is equal to Specification: Mandatory Replace Source column Values are replaced if one or all conditions is/are met. you can specify whether all or at least one condition must be met.ARIS MashZone Error situation type. Source: Source table Data type: Number. Replacement must be linked to a condition. user input. Parameter The following parameters are available. Default value: is equal to 255 . Text. Date. Source: Source table Data type: Number. Name of the column whose values are compared. Available comparison operators depend on the data type of the source column.e. Source: Column with values. single value from a feed (single-value operator). Specification: Mandatory Comparison operator Operator that compares the values from the source column with the comparison values. Replaces existing values in the column with new values. Description Name of the column whose values are replaced. Date. Text. or a constant. i.3. Several conditions can be specified and these are linked to each other with "AND".4..3 Replace values Behavior Changes the value in the specified column one row at a time if certain conditions are met. Specification: Mandatory Parameter Column New value Value that replaces the value in the source column. Behavior 7.

Source: Column with values. or a constant. Data type: Must be identical to that of the source column.ARIS MashZone Parameter Comparison values Description Specification: Mandatory Values that are compared with the values from the source column. user input. single value from a feed (single-value operator). Comparison value missing   Condition met: If a comparison value is missing. the condition is assumed to not be met. the condition is assumed to be met. Specification: Mandatory Comparison operators Data type Figure Comparison operators         Text         Date  Is equal to Is not equal to Is less than Is less than or equal to Is greater than Is greater than or equal to Is empty Is not empty Is equal to Is not equal to Starts with Ends with Contains Does not contain Is empty Is not empty Before 256 . Condition not met: If a comparison value is missing.

Parameter The following parameters are available. Source: Source table. value does not match the data type of the condition column.ARIS MashZone Data type Comparison operators       After In Before or on On or after Is empty Is not empty Error behavior The following error behavior can occur. 7. single-value operator. Error situation New value does not match the Behavior The operator returns no data.4 Link texts Behavior Combines the values of the specified columns or text fragments into one text.4. Error message. it is created. If the target column does not exist. Error message. Comparison value in condition. writes the results to the target column and overwrites any existing values there. Description Text to be linked. or a constant. Data type: Number. Date. input value. Text. The operator returns no data.3. Appends the values from the source columns or the source values to one another one row at a time. data type of the source column. Specification: Optional Parameter Text 257 .

Date. Source: Source table Data type: Number. Specification: Mandatory Parameter Search column Search text Character string for which the search is performed. of the TEXT type. the position is -1. The <Name of target column> column is added to the feed table. Data type: Text Default value: Result_1 Specification: Optional Error behavior The following error behavior can occur. Source: Source table or constant. 258 . or a constant. Error situation Behavior Target column exists. Description Name of the column whose values are searched. Parameter The following parameters are available. but is not The operator returns no data.4. Source: Column values from source table.ARIS MashZone Parameter Target column Description Name of the column to which the linked text is written.5 Find text Behavior Finds the specified search text in a search column and writes the position of the found text to a numerical target column. single value from a feed (single-value operator). Data type: Text Specification: Mandatory Target column Name of the column to which the search result is written. The target column has a set of empty rows. 7. No entries made for text input. If the search text is not found. input value. Error message. Text.3.

4.ARIS MashZone Parameter Description Data type: Number Default value: Result_1 Specification: Optional First/last hit If multiple results are found.3. Parameter The following parameters are available. of the TEXT type. Description Name of the column whose values are searched. single-value operator. Searches the source column at the specified start index and using the specified length for the string and displays it in the target column. or constant. Error behavior The following error behavior can occur. input value. Start index and length must be >= 0. Size >= 0. Error situation Behavior Search column exists. Data type: Number 259 . Error message. but is not The operator returns no data. 7. Source: Source table Data type: Text Specification: Mandatory Parameter Column Start index Start position of the character string to be extracted. otherwise an empty entry appears in the target column. the first or last hit is taken as the search result.6 Extract text Behavior Creates an extract from each value in a text column starting from the specified position (start index) and with the specified length and writes the result to a target column. Source: Source column.

Source: Source column. 260 . Error message. If the search text cannot be found. Error message. user input. An input box does not provide a The operator returns no data. Error situation No values specified for start index and length. Parameter The following parameters are available. start index or length and has no Error message. default value: Search column exists. or constant. 7.3. Behavior The operator returns no data. or writes the text to a target column. Data type: Number Default value: Result_1 Specification: Optional Error behavior The following error behavior can occur. single-value operator. but is not The operator returns no data.4. of the TEXT type.ARIS MashZone Parameter Description Specification: Mandatory Length Number of characters in the character string to be extracted. Number of characters >= 0 Data type: Number Specification: Mandatory Target column Name of the column to which the search result is written.7 Replace text Behavior Replaces text in a search column with the specified Find or Replace text one row at a time. the search text itself is written to the target column.

Error message. default value. search text and does not have a Error message. the first. Target column Name of the column to which the replacement result is written. 261 . or all hits is/are replaced. Source: Source table. Note The specification relates to occurrence within the individual rows of the search column and not to the sequence of rows. or constant. NOT "First row". single-value operator. or constant. An input box does not provide a The operator returns no data. Data type: Text Default value: Result_1 Specification: Optional First/last/all hits If multiple results are found. Source: Source table Data type: Text Specification: Mandatory Search text Character string for which the search is performed. Data type: Text Specification: Mandatory Note If no replacement text is specified. the search text found is replaced with a empty text. last. i. input value. single-value operator. input value. Data type: Text Specification: Mandatory Replacement text Character string that replaces the search text. "Last row" and "All rows". Source: Source table. Error behavior The following error behavior can occur. Error situation No values maintained for search text Behavior The operator returns no data.e..ARIS MashZone Parameter Column Description Name of the column whose values are searched.

Remove space(s): Removes all spaces from the column values. according to the rules of the specified language. 262 . according to the rules of the specified language.ARIS MashZone Error situation Behavior Search column exists. Data type: Text Default value: Result_1 Specification: Optional Note If the target column is identical to the source column.3. of the TEXT type. Error message. the values in the source column are overwritten. The transformation rule includes all rows in the selected source column. Lower-case letters: Converts all characters into lower case. Specification: Mandatory Target column Name of the column to which the conversion result is written. Parameter The following parameters are available.4. 7. Upper-case letters: Converts all characters into upper case. based on the specified transformation rule.8 Convert text Behavior Converts all characters in the source column one row at a time. Letters only: Removes all figures (0-9) from the column values. but is not The operator returns no data. Description Name of the column whose values are converted. Source: Source table Data type: Text Specification: Mandatory Parameter Text column Conversion Transformation rule for conversion of column values:      Numbers only: Removes all letters from the column values.

263 . Description Single value to be copied.5.5 7.3. Behavior The operator returns an empty output value of the same type. Error situation Column name and new name are identical. Original column values are changed.2 Data feed to value Behavior Filters a single value from the data feed. 7. New column name already exists elsewhere. 7. Source column exists.1 Individual values Copy single value Behavior Creates an independent copy of a single value.e.ARIS MashZone Error behavior The following error behavior can occur. without changing the input value. an existing column is replaced. If the filter delivers multiple values. Parameter The following parameters are available.3.5. but is not The operator returns no data. i. Parameter Single value Error situation Input value is empty. Behavior Original column values are changed. the first value found is returned.. Specification: Mandatory Error behavior The following error behavior can occur. of the TEXT type.3. Error message.

Date. Source: Source table Data type: Number. Default value: is equal to Specification: Mandatory 264 . Possible actions:   if   all conditions are met one condition is met Let values pass (from source table) Block values (from source table) Default value: Let values pass if all conditions are met. Parameter The following parameters are available. Specification: Mandatory Column Name of the column whose values are filtered. there is no filtering and the first value found is returned. Available comparison operators depend on the data type of the source column. Parameter Action Description Executed if particular conditions are met. and returns this as a single value. If no value is found. based on the specified condition. Text. Specification: Mandatory Comparison operator Operator that compares the values from the source column with the comparison values.ARIS MashZone Determines the first value found from a column in the source table. If no value is specified. No value is returned.

input value. Data type: Must be identical to that of the source column. the condition is assumed to be met. Specification: Mandatory Comparison operators Data type Figure Comparison operators         Text         Date    Is equal to Is not equal to Is less than Is less than or equal to Is greater than Is greater than or equal to Is empty Is not empty Is equal to Is not equal to Starts with Ends with Contains Does not contain Is empty Is not empty Before After In 265 . or a constant. Comparison value missing   Condition met: If a comparison value is missing. the condition is assumed to not be met.ARIS MashZone Parameter Comparison values Description Values that are compared with the values from the source column. Source: Source table. single-value operator. Condition not met: If a comparison value is missing.

Parameter The following parameters are available. Creates a feed table from a single value operator with a column of the source operator type and a row containing the value of the source operator. Error message.3 Values to data feed Behavior Converts an individual value into a data feed so that it can be connected to an operator.5. Data type: Text Default value: Result_1 Specification: Optional Error behavior The following error behavior can occur. or Date Specification: Mandatory Parameter Single-value operator Target column Name of the column to which the conversion result is written. Description Returns the value that is converted into a data feed. The name of the column corresponds to the name of the source operator (only possible for user input) or is assigned the default name Single value. not return a value. Data type: Text. Error situation Behavior The single-value operator does The operator returns no data.3.ARIS MashZone Data type Comparison operators     Before or on On or after Is empty Is not empty 7. 266 . Number.

Parameter The following parameters are available. Specification: Mandatory Parameter Source 267 . 7. Source: Constant Default value: Data from the Internet.3. Description Specifies whether the URL refers to a source on the Internet or a resource on the ARIS MashZone server. The internal text representation of the value is added. Parameter The following parameters are available.5 Create URL Behavior Allows the creation of any URL by entering the individual URL elements in corresponding input boxes without the need to specify the control characters ?. which can be accessed using an alias. single-value operator. & and =. or constant Data type: Text Specification: Optional Parameter Text fragments Error behavior The following error behavior can occur.3.ARIS MashZone 7.5. string but has a default value: An input value is not of the Text type. The URL can be provided to other operators and data sources. Error situation Behavior An input box provides an empty The default value is added.4 Link text Behavior Combines the specified text fragments. Description Any character strings Source: User input.5.

as these are part of the parameter section. http:// is used automatically. Example https://subdomain.com/some/path This section can be concluded with a separator. The first parameter is appended to the path with a ?. Source: Constant.com This can be followed by a path. single-value operator Data type: Text Specification: Mandatory Path The section of a URL that comes after the host name. paths may not contain the special characters =. or to a host name that already contains part of the path. user input.myhost. each subsequent one with a & Source: Constant Data type: Text Specification: Optional 268 . Example https://subdomain. &. and ?. user input.myhost. However. If no protocol is specified. It can be preceded by http:// and https:// as the protocol.com/some/path This section can be concluded with a separator. Source: Constant. the default is the slash (/). the default is the slash (/). As protocol Example https://subdomain.myhost.ARIS MashZone Parameter Host Description Initial section of a URL containing the host name. Several path sections can be appended to one another. single-value operator Data type: Text Specification: Optional Name Name of a parameter of the URL.

6 Retrieve info Behavior Provides system information on the logged-in user or the current date.php?regi on=dach&table=revenues Protocol=http Host: www. Parameter values are appended to the preceding parameter name with an = sign.com/users/myuser/mypage. user input. value: revenues 7.php Parameter:   key: region. Specification: Optional Example URL: http://www. These characters must be masked in a valid URL. The operator can also generate a random number. Only select this option if you are sure that all sections that make up the URL are already masked.subdomain. single-value operator Data type: Text Specification: Optional Do not use UTF-8 to encode URL Specifies whether the default masking of special characters (such as accented letters) using their UTF-8 codes is to be disabled. 269 .3.5. The value type of the resulting single value changes accordingly.mydomain. Source: Constant.mydomain.ARIS MashZone Parameter Value Description Name of a parameter value for the URL. Parameter The following parameters are available. value: dach key: table.subdomain.com Path: /users/myuser/mypage.

e-mail not maintained). Default value: {None} Specification: Optional Error behavior The following error behavior can occur. Month. no user information is available (e. displayed if Today's date is selected as the information type. Year Default value: Day Specification: Mandatory Number range Number range of the random number. displayed if Random number is selected as the information type. Day. Hour. Behavior An empty text value is created. The following values can be selected: Minute. Floating point numbers Default value: Decimal number Specification: Mandatory Upper/lower limit Upper or lower limit of the value range for the random number. Error situation In User data mode. displayed if Random number is selected as the information type.ARIS MashZone Parameter Information type Description The single-value operator can return the following types of information:    User data Today's date Random number Default value: User data Specification: Mandatory Property Properties of the logged-in user. E-mail Default value: Login Specification: Mandatory Accuracy Specifies the accuracy of the date. Last name. The following values can be selected: Login.g. displayed if User data is selected as the information type. First name. The following values can be selected: Integers. 270 .

the upper limit is lower than the lower limit or the lower limit is higher than the upper limit. Note If nothing is specified here. or Date data types.7 Change data type Behavior Changes the data type of the incoming single value to the Number. Action Conversion of Text to Number Conversion of Number to Text Text representation of the number in the specified format. Result Numerical value of the text taking into account the decimal separator. Note If the decimal separator is set correctly. Text.5. any thousand separator is detected automatically. Behavior An error message is displayed. 271 .ARIS MashZone Error situation In Random number mode. the results are formatted in the internal date format.3. 7.

If no format is specified. or based on the language and the specified format Note Non-editable text must be enclosed in quotation marks. 272 . the language. separated by separators. Conversion of Date to Text Text representation of the date in the internal format. month. If no language is specified. Conversion of Number to Date Date value corresponding to the value of the number as milliseconds since 01/01/1970 Conversion of Date to Number Number of milliseconds since 01/01/1970 Internal number format Anglo-Saxon style number format with a period as the decimal separator and at least one decimal place. English (EN) is applied as the default language. or minute. The only decisive factor is then the order of Q/q and Y/y.g. Date values before the common era are not supported. day of the week. The format and language specifications are optional. When using the Q or q symbol for quarters. Note The date must be in the AD era. The time format is made up of sequences of characters. but without grouping characters. in the relevant language. Non-editable text must be enclosed in quotation marks. where applicable. the data is output in the internal date format. the corresponding language must be specified. based on the specified format and. The time format must be specified. In addition. which stand for date fields. e.ARIS MashZone Action Conversion of Text to Date Result Date value of the text in the internal format. year.. all other symbols except Y and y for years are ignored.

Parameter The following parameters are available. or Text Specification: Mandatory New type New single-value data type Default value: Text Specification: Mandatory Format Time format for conversion from date type to text type and vice versa. Prerequisites for conversion of text into quarterly date values: 1. Quarter 04/2009. the first sequence of digits is interpreted as the quarter and the second as the year. If q or Q appears first.ARIS MashZone Internal date format yyyy-Q for specifying to the nearest quarter. Number. 2. Procedure: 1.. 2. otherwise yyyy-MM-ddThh:mm:ss The number of digits corresponds to the accuracy of the date. The following formatting symbols are available when converting date into text:   Year: y or Y Quarter: Q 273 .g.. The (first) two sequences of digits are determined from the source value. e. The pattern uses Y or y as the symbol for the year and Q or q for the quarter. after and between them.g. Quarterly specifications These are indicated by a Q within the section of the format that is not in single quotation marks. Parameter Single value Description Source: Single-value operator Data type: Date. Any non-numerical characters can occur before. e. otherwise the reverse. quarter Q/y or Q Y. It is expected that a source value containing a quarterly date consists of just two sequences of figures indicating the year and the quarter. This is the transfer format. and the remaining digits are omitted. 3. The section of the format that is not enclosed between single quotation marks is used to determine whether q / Q or y / Y appears first.

g.. -0900) Era: G (must always be AD) Default value: MM/dd/yyyy The following formatting symbols are available when converting text to date:                  Year: y Quarter: Q Month: M Calendar week: w Week of the month: W Day of the week: E Day of the month: d Day of the year: D Hour (0-23): H Hour (1-24): k Hour AM/PM (0-11): K Hour AM/PM (1-12): h Minute: m Second: s AM/PM: a Time zone: z RFC time zone: Z 274 .g. GMT) RFC time zone: Z (e.ARIS MashZone Parameter Description              Month: M Calendar week: w Day of the week: E or e Day of the month: d Day of the year: D Hour: H or h Minute: m Second: s AM/PM: a Time zone: z (e..

In this case.) Specification: Mandatory Note  The characters in the time format can be combined in any order and repeated any number of times..e. if the target format is of the Number type.). For a year format such as 2009. slash (/). i. RFC time zone (Z) and week of the year (w) are case-sensitive. Default value: Comma (. however. Available languages: de and en. yy and yyyy return 2009. 275 . Permitted separators in both cases: Dash/minus (-).) and <3 if it is specified as a figure.). TUE. minute (m). period (. while e/E = or > 4 returns the full name of the day. colon (:). a language must also be specified so that the name of the month can be transformed correctly.   Only the month (M). an e/E number < 4 returns the day abbreviations (MON. underscore (_). For the reverse conversion from date to text. but may only occur once (not QQ/yy). Specification: Mandatory when using names of months and names of days of the week Decimal separator Separator for the decimal places. etc. Specification: Mandatory Language Language if the target format is of the Date type. When converting text to date. yyyy returns the year 9 and yy the year 2009.). and space. Only the order of Q/q and Y/y is then decisive. time zone (z). comma (. the Q/q can be combined with any other symbols. FEB. Exceptions: For a month. etc. tab character. the number of characters must be >= 3 (MMM or MMMM) if the month is specified in text format (JAN. When formatting date values as days of the week for a date to text conversion. For a year format such as 09. if the Q or q symbol is used for quarters all other symbols except Y and y are ignored.ARIS MashZone Parameter Description  Era: G Default value: yyyy-MM-dd'T'HH:mm:ss. y can be specified any number of times.

Text -> date: Single value contains non-empty character strings that do not match the time format. e.g.M . The operator does not return a date value. 'On' dd.. because they contain units. Error situation Text -> date: Time format contains characters that are not indicated by quotation marks and are not available as date characters in the transferred language.y".ARIS MashZone  Quarter entries are currently only possible in the form YYYY-Q or YYYY-QQ. 3. Spaces can be inside or outside. Error: If the character string is still not successfully changed. These character strings may only consist of the year.M . E. A warning message is output.MM.y" but not "2. A warning message is output. 09" -> "d . +E.MM.yy 'at' hh:mm. and quarter. Error behavior The following error behavior can occur. Tolerance: is created from the rest. or 'On 'dd. separator. "2 .  All other character strings must be enclosed in single quotation marks (').  The space pattern in the source and target format must match. Single value contains character All non-numerical characters are ignored and a numerical value 276 . the affected cell remains empty... Exception: If.g. Text -> date: Single value contains empty cells Text -> number: strings that cannot be directly interpreted as numbers.09" -> "d . e. they are interpreted as part of "computerized scientific notation" of the number and are not ignored. e. No message is output. Behavior The operator returns no data. The operator does not return a date value. or -E is embedded in figures. +e.yy' at 'hh:mm' '. Error message.g.3 . e.

3. quarter 2009" Time format: "QY" or "Q'.ARIS MashZone Error situation Behavior A warning message is output. quarter' y or "QQ/yyyy". The number is rounded to a value without decimal places and the The source number has decimal data type is changed using this value.MM. but not "'Time: 'y-MM-d'T'h:m:s" Source format: "3. 277 .M.2009" Time format: "d. Parameter The following parameters are available.3.6.MMM.3.6 7. but not "DD.1 Date Round up/down date Behavior Converts date values from a date column to a rougher time unit and writes the results to a target column. Number -> date: places.YYYY " Source format: "03/22/09 30:24 PM" Time format: "MM/DD/YY hh:mm a" or "M/d/y HH:mm A" but not "M/d/y HH:MM A" or "m/d/y HH:mm A" Source format: "Time: 2009-FEBRUARY-01T22:33:44" Time format: "Time: 'y-MMM-d'T'h:m:s" or "'Time:' y-MMMMM-d'T'h:m:s".YYYY".y" or "DDDD. but not "YQ" 7. Examples Source format: "22.

. regardless of the interval value Always round down: Always rounds down. Minute Note If the accuracy of the source column is less accurate or the same as the target column format. If the target column is not of the Date type. 5 minutes or 1 year Data types: Numeric. Quarter.g. Hour. defined by the unit: Year. Rounding type: Specifies how the selected time interval is to be rounded.g. Minute. Source: Source table Data type: Date Specification: Mandatory Accuracy Accuracy of the new date format. The date values are rounded according to the selected interval. the original value is retained. 278 . the seconds are ignored. The values in the target column are overwritten.     Round up for half an interval: Automatically rounds up above an interval value higher than or equal to half of the interval value Round down for half an interval: Automatically rounds down below an interval value lower than or equal to half of the interval value Always round up: Always rounds up. it is replaced by a new date column.ARIS MashZone Parameter Source column Description Name of the source column whose values are rounded. and Interval: Depending on the selected unit. when rounding to minutes. or Second. e.. Only the unit to be rounded is taken into account. Text Default values: 1. e. Day. regardless of the interval value Target column Name of the target column to which the converted date is written Data type: Date Default value: Result_1 Specification: Optional Note The target column can be identical to the source column. Month.

A row in the source column does not contain a value. Error message. The affected rows are ignored.ARIS MashZone Error behavior The following error behavior can occur. Date type. Examples Source value 2009-12-24T16:23 2009-12-24T16:23 2009-12-24 2009-12-24 2009-12-24 Rounding 2010-08-06T17:15:27 2010-08-06T17:07:00 2010-08-06T17:18:00 10 seconds 15 minutes 15 minutes 2010-08-06T17:15:30 2010-08-06T17:00 2010-08-06T17:15 2010-08-06T04:00:00 Accuracy Day Hour Month Quarter Year Result 2009-12-24 2009-12-24T16 2009-12 2009-Q4 2009 2010-08-06T02:18:04 4 hours Round up Source value 2010-02-28T23:07:00: 00 AM 2010-02-28T23:07:30 2010-02-28T23:30:00 15 minutes 1 hour 2010-02-28T11:15:00 PM 2010-03-01T00 Accuracy 15 minutes Result 2010-02-28T23:00 Round down Source value 1970:01:01T09:00:01 Accuracy 6 hours Result 1970:01:01T12:00:00 279 . Error situation Behavior The source column is not of the The operator returns no data.

the result is the last day of the target month.2 Move date Behavior Moves a date by a specified amount of time in a given direction and writes the results to a target column. If the format of the moving period is more accurate than the format of the source date.3. If a date accurate to the nearest day with a number of days > 28 is moved to a month that has fewer days. Note A date can only be moved by an amount of time whose unit is the same as or less accurate than the unit of the date itself. If you move a date by quarters.6.ARIS MashZone Source value 1970:01:01T09:00:00 Accuracy 6 hours Result 1970:01:01T06:00:00 Always round up Source value 2010-02-28T11:15:00 PM 2010-02-28T11:15:01 PM 2010-02-28T20:00:01 6 hours 2010-03-01T00 15 minutes 2010-02-28T11:30:00 PM Accuracy 15 minutes Result 2010-02-28T11:15:00 PM Always round down Source value 2010-02-28T11:15:00 PM 2010-02-28T11:14:59 PM 2010-03-01T05:59:59 6 hours 2010-03-01T00 15 minutes 2010-02-28T23:00 Accuracy 15 minutes Result 2010-02-28T11:15:00 PM 7. the source date is retained. 280 . it is moved by three months for every quarter.

A date accurate to the nearest year can only be moved by years. Data type: Date Default value: Result_1 Specification: Optional Note The target column can be identical to the source column. Data type: Number Default value: 1 Specification: Optional Unit Unit of time by which the date is moved. Source: Source table Data type: Date Specification: Mandatory Direction Direction in which the date is moved. 281 . The values in the target column are overwritten. a date accurate to the nearest year by any unit. but not by days. quarters or years. Parameter Source column Description Name of the source column whose date values are moved. Possible values: Forward or Back Data type: Text Default value: Forward Specification: Mandatory Value Value by which the date is moved by the selected unit. Parameter The following parameters are available. Data type: Text Default value: Minute Specification: Optional Target column Name of the target column to which the result is written.ARIS MashZone Example You can move a date accurate to the nearest month by months. Error behavior The following error behavior can occur.

A date in the source column is less accurate than the amount to be moved. Source: Source table Data type: Date Specification: Mandatory Parameter Source column 282 . Month. Day. The source value is retained.3 Replace date field Behavior Replaces the specified date fields (e. Date type. The operator can be used to change the Year. Parameter The following parameters are available.. The operator returns no data. The affected rows are ignored. Error message.g.6. Error message. A required parameter is missing.ARIS MashZone Error situation Behavior The source column is not of the The operator returns no data. Hour. Examples Source value 2009-12-24T16:23 2009-12-24 2009-12-30 2009-11 2009-11 Amount 10 10 10 1 1 Unit YEAR DAY MONTH QUARTER DAY Direction PLUS PLUS MINUS PLUS PLUS Result 2019-12-24T16:23 2010-01-03 2009-02-28 2010-02 2009-11 7.3. Minute. and Second date fields for the values in a date column. A row in the source column does not contain a value. year) in all rows of the selected source column with the value specified in the Date field. Description Name of the source column whose date fields are replaced.

Date type. 283 . If the data type of a date column is subsequently changed. MM=Minute. HH=Hour. DD=Day. Year.2009 16:23) 2010-03 (3. Error situation Behavior The source column is not of the The column cannot be selected. Minute.ARIS MashZone Parameter Date Description Input value that is to replace the value of the date field. 'Q'Q=Quarter Example 2009-12-24T16:23 (24. an error message is displayed: The source column <Column name> is not a date column. Target column Name of the target column to which the new date is written. quarter 2010) Date fields Date fields to be replaced by the input value in the date from the source column. Day. Data type: Date Default value: Result_1 Specification: Optional Note The target column can be identical to the source column. T=Separator. The values in the target column are overwritten. and Second are available as date fields. MM=Month. Hour. Month. Error behavior The following error behavior can occur. The input value must correspond to the internal date format:        YYYY-MM-DDTHH:MM:SS YYYY-MM-DDTHH:MM YYYY-MM-DDTHH YYYY-MM-DD YYYY-MM YYYY-'Q'Q YYYY YYYY=Year.12.

The specified date format does Error message not correspond to the internal date format. The search can be limited to particular dimensions.3.01.01. A row in the source column does not contain a value. If one or more dimensions are specified. Examples Date = 01/01/1970 Date fields to be replaced = Year. At least one selected date field For these date fields. All other rows are filtered out.ARIS MashZone Error situation Behavior At least one selected data field For these date fields.2002 20:01:01 24. Day Source column 25. these values are set to 0. Month.2010 18:02 13.01.2000 17:00 12. Example If the date is 01/01/2010 in the source column and the Hours.02.4 Determine earliest/latest date Behavior Searches a date column for the latest or earliest date and transfers these rows to the results table.01. the operator determines the feed row with the earliest or latest date within the feed rows with identical dimension values and transfers this to the 284 . The affected rows are ignored. these values are set to 0.6.05. is not included in the specified date format.1970 20:01:01 7. and Seconds date fields are selected. Minutes. Example If the date 01/01/1970 is specified and Hour selected as the date field. does not exist in at least one row in the source table.1970 17:00 01.1970 18:02 01.2001 23:03:03 01. all hours are set to 0 in the source date.03. the value in the cell is converted to 01/01/2010 00:00:00.01.1970 23:03:03 Target column 01.

ARIS MashZone result table. Date type. all of them are transferred to the results table. Acts as a filter to restrict the values determined. Data type: Text Specification: Mandatory Note Multiple dimension columns can be set. Error behavior The following error behavior can occur. The source column is not of the The operator returns no data. Source: Source table Data type: Date Specification: Mandatory Earliest/latest date Determines the earliest or latest date values in the source column. Default value: Earliest date Dimension column Dimension for which the earliest or latest date values are determined. 285 . Parameter The following parameters are available. Parameter Source column Description Name of the source column for which the earliest or latest date values are determined. Error situation Behavior The source column or one of the The operator returns no data. If there are several feed rows with the earliest or latest date. Error message. dimension columns does not exist. Error message.

allowing a user to enter data manually in a MashApp. Name Date (Page 286) Text (Page 287) Figure (Page 288) Description Enables dynamic entry of date values in data feed processing. The input is made in the format yyyy-MM-dd'T'HH:mm:ss (up to the required accuracy) or yyyy-'Q'Q.7. 7. Parameter The following parameters are available.4 User input The following user input (Page 62) is available in the feed editor (Page 68). Note The penultimate operator of the feed definition must be connected to the Output operator. 7. Enables dynamic entry of numerical values in data feed processing. Enables dynamic entry of text in data feed processing. A user input is an interface to a data feed.ARIS MashZone 7.1 Date Behavior Enables dynamic entry of date values in data feed processing.7 7.1 Other Output Behavior Completes the feed definition and outputs the calculation result for the feed definition.4. The operator is inserted in the feed definition by default and cannot be deleted.3.3. 286 .

Parameter The following parameters are available. Error situation The value entered does not correspond to the required data format. Source: Constant Data type: Date Specification: Optional Error behavior The following error behavior can occur.4. A user input is an interface to a data feed. 287 . allowing a user to enter data manually in a MashApp. Debug value Value used for a test calculation in the feed editor. Source: Constant Data type: Date Specification: Optional Default value The value is used if the user does not provide any input.2 Text Behavior Enables dynamic entry of text in data feed processing. 7. Behavior An empty value of the Date type is returned.ARIS MashZone Parameter Name Description Name of user input Source: Constant Data type: Text Specification: Optional Note The names of the individual user input must be unique within the feed definition.

Source: Constant Data type: Text Specification: Optional Default value The value is used if the user does not provide any input.ARIS MashZone Parameter Name Description Name of user input Source: Constant Data type: Text Specification: Optional Note The names of the individual user input must be unique within the feed definition. Error situation The value entered does not correspond to the required data format.4. The input is done with a period (.56). 288 . 1234. 7.3 Figure Behavior Enables dynamic entry of numerical values in data feed processing. allowing a user to enter data manually in a MashApp. Parameter The following parameters are available. Debug value Value used for a test calculation in the feed editor. Behavior An empty value of the Date type is returned. A user input is an interface to a data feed.) as the decimal separator and with no thousand grouping character (e.. Source: Constant Data type: Text Specification: Optional Error behavior The following error behavior can occur.g.

Source: Constant Data type: Number Specification: Optional Error behavior The following error behavior can occur.ARIS MashZone Parameter Name Description Name of user input Source: Constant Data type: Text Specification: Optional Note The names of the individual user input must be unique within the feed definition. select the file aris_mashzone_setup_Win-32bit. select the file aris_mashzone_setup_Win-64bit. Behavior An empty value of the Date type is returned. If you work with a 32-bit operating system. Debug value Value used for a test calculation in the feed editor.exe. 289 .exe. Prerequisite You need the ARIS MashZone installation program. and for a 64-bit system. Source: Constant Data type: Number Specification: Optional Default value The value is used if the user does not provide any input.5 ARIS MashZone installation The chapters below describe how to install ARIS MashZone and what you need to be aware of when doing this. Error situation The value entered does not correspond to the required data format. 7.

2. 1. 290 . Click on OK. Procedure Click on Next.5.2 Accept license terms To continue with the installation.exe.5. Select the language in which you want to run the Installation Wizard. 3. 2. 7. Click on Next. Procedure 1. A summary of your settings is displayed. Click on Next. Enable the option I accept the terms of the license agreement. The start window of the Installation Wizard is displayed.5. The Installation Wizard is launched and the introduction page is displayed. Note  Default installs ARIS MashZone with the basic default settings. Note If you want to install ARIS MashZone with different settings. you need to accept the license terms.4 Select installation type You can choose between Default and Advanced. you need to uninstall your current version first. for example in a different installation directory or with extended functions.ARIS MashZone 7. 4.3 Update ARIS MashZone If you have already installed ARIS MashZone you will receive information on the version installed. 7. The ARIS MashZone server is installed with the ports 16360 and 16366.5. Double-click on the ARIS MashZone installation program setup.1 Start installation You can install ARIS MashZone using the Installation Wizard. The Select installation type (Page 290) dialog is displayed. The License terms (Page 290) dialog is displayed. 7. Your current settings will be transferred entirely upon updating.

The Install demo content (Page 291) dialog is displayed. Click on Next. the webMethods Broker add-on is not installed. The Installation Wizard automatically sets default values for all configurations. Click on Next. 7. 2. and webMethods Broker add-on installation. system profile selection.5. Enable the Default option to apply the preset values. 291 . 7. Procedure 1. such as ARIS MashZone server settings. Note The installation path must not contain any spaces. The demo content is installed in the ARIS MashZone database. Enable the Advanced option if you want to specify additional settings yourself. Specify the installation path in the input box or click on Select to select a folder.5. Procedure 1. click on Restore default folder. which you can apply by default. ARIS MashZone provides numerous illustrative demo MashApps and demo data feeds for display and editing.5 Select installation directory Specify the folder in which you want to install ARIS MashZone. The Select installation directory (Page 291) dialog is displayed.  Advanced provides additional configuration options. Tip To display the preset installation directory.ARIS MashZone Notebook is selected as the system profile. 3.6 Install demo content You can install predefined demo content to be used in ARIS MashZone. 2. Note The ARIS MashZone Quick Start Guide (Page 10) is based on the demo MashApp Green Car Roadshow and the demo data feed Green Car Roadshow participant.

select whether ARIS MashZone server as a Windows service is to start automatically when starting Windows or manually using the Start menu. The Configure proxy server (Page 293) dialog is displayed if you have selected the Default installation type. install demo content or No. The Select system profile (Page 293) dialog is displayed if you have selected Advanced as the installation type. Select Yes.5. do not install demo content. In the Start type selection box. The required port numbers of the protocols used are preset as follows:   http: 16360 Shutdown: 16366 Procedure 1. The Install BATCH start files option is enabled by default.7 Configure ARIS MashZone server You can install ARIS MashZone server as a Windows service and select a corresponding start type.ARIS MashZone Procedure 1. If you enable the option Install ARIS MashZone server as a Windows service the service Software AG MashZone is available. 3. 7. which you can start manually in the ARIS MashZone program folder or automatically during the Windows start. If required. The Configure ARIS MashZone server (Page 292) dialog is displayed if you have selected the Advanced installation type. Click on Next. Click on Next. enable the option Install ARIS MashZone server as a Windows service. Enter a free port number in the http and Shutdown input boxes. You call the BATCH start file in the ARIS MashZone program folder of the Start menu. 2. 2. 4. 292 . Note You use batch files to start and stop the ARIS MashZone server as an application.

293 .5. The Install webMethods Broker add-on (Page 293) dialog is displayed if you have selected Advanced as the installation type.ARIS MashZone Note Before you can display ARIS MashZone in your browser you need to Start ARIS MashZone server as an application or service (Page 6). Procedure 1.5. You can set a proxy server if your ARIS MashZone server uses a proxy server to communicate with the Internet without a direct connection to the Internet. Click on Next. 7. 7.8 Select system profile You can select a system profile to optimize the performance of ARIS MashZone.10 Configure proxy server If you want to use data from the Internet in ARIS MashZone the ARIS MashZone server must have an Internet connection. Activate the system profile that corresponds best to your hardware configuration. Procedure 1. The Configure proxy server (Page 293) dialog is displayed. 2. Enable the option Install webMethods Broker add-on if you want to install the interface to webMethods Broker. The real-time buffer extracts in real-time events published by webMethods Broker and provides it to ARIS MashZone as source data. 7. Click on Next.9 Install webMethods Broker add-on You can install an ARIS MashZone add-on that you can use for extracting data from webMethods Broker.5. 2. System profiles represent frequently used hardware configurations. The add-on ARIS MashZone real-time buffer is installed as an interface between ARIS MashZone and webMethods Broker. The installation program adapts the ARIS MashZone settings according to the profile selected.

Procedure 1. Enter the address of your proxy server in the Address box. if so. 4. Procedure 1. 4. 3. 8. Enable the In existing program group option if you want the shortcuts to be created in an existing program group in the Start menu. if required. Enable the In quick launch bar option if you want the shortcuts to be created directly in the quick launch bar. 294 . where you want to create shortcuts to the ARIS MashZone program files. 6. 2. The Configure ARIS MashZone server (Page 292) dialog is displayed if you have selected Extended (Page 290) as the installation type. the option is disabled. If there is no preset proxy server. 2. Enable the In new program group option if you want the shortcuts to be created in a new program group in the Start menu. 5. Enable the Other option and select the path to the folder in which you want to create the shortcuts. 3. Enable the Do not create shortcuts option if you do not want to create any shortcuts. Enable the Use proxy option. 7. 7. Ask your system administrator for the address and port of your proxy server. Click on Next. the Use proxy option is enabled and the Address and Port of the proxy server are preset.5. 9. Enable the In Start menu option if you want the shortcuts to be created directly in the Start menu without a separate program folder.11 Create program shortcut You can specify whether and. Enter a name for the new program group in the input box. Select a program group from the selection box.ARIS MashZone Note If a proxy server is already configured on the computer on which you install ARIS MashZone. Enter the port number of your proxy server in the Port box. The Create program shortcut (Page 294) dialog is immediately displayed if you have selected Default as the installation type (Page 290). Enable the On desktop option if you want the shortcuts to be created directly on the desktop with no entry in the Start menu.

Click on Install to finalize the installation. You can now start ARIS MashZone (Page 6). 3. The Installation complete dialog is displayed. By repeatedly clicking on Next you get back to the summary. 295 . Click on Finish to exit the Installation Wizard. 2. Tip The ARIS MashZone online help is also available in html and pdf format in the folder doc/en in the ARIS MashZone program directory. The Installation Wizard closes. Note If you want to change your settings. If required. 7. A summary of your settings is displayed. The ARIS MashZone server automatically starts once installation is complete.ARIS MashZone 10.5. enable the option Yes. Note After successful installation. an HTML page containing all of your settings is automatically displayed in your default browser. start server now if you want to start ARIS MashZone after the installation.12 Finish installation Once you have specified all required settings. 11. The Installation Wizard carries out the installation and displays the Start ARIS MashZone server dialog. 7. Click on Next. Procedure 1.13 Installation under Linux The following chapters describe the installation of ARIS MashZone under Linux. you can finalize the installation. 4. Click on Next.5. Enable the Create symbols for all users option if you want the shortcuts to be available to all users who log in on this computer. click on Back until you get to the relevant dialog and make your changes.

5. Therefore.bin 296 .13.13. Installation using console mode is impossible. copy the file aris_mashzone_setup_Linux-32bit. you cannot configure services in the Linux installation program. 7. Note The installation directory path selected must not contain any spaces.5. The system user has read and write privileges in the installation directory and is allowed to execute programs (mode 744 or 755).ARIS MashZone Note For 32-bit and 64-bit systems. Please ask your system administrator for support to set up the ARIS MashZone server as a system service.bin to the Home directory of the Linux system user. 7. The installation with graphical interface is the same as the installation for Windows described in chapter Perform installation. System environment    bash is provided as the login shell for the system user to be used for installing and operating ARIS MashZone. Use the following command to change the access privileges for the file so that it is executable.  System services are handled differently under Linux than under Windows. To run the installation program you need the X Window user interface.bin and for 64-bit Linux systems. Procedure 1.2 Install ARIS MashZone Note  To run the installation program under Linux you need the X Window user interface. different installation programs are available.1 Installation requirements Only the ARIS MashZone server was tested and approved for use with Linux.bin or chmod ug+x aris_mashzone_setup_Linux-64bit. copy the file aris_mashzone_setup_Linux-64bit. chmod ug+x aris_mashzone_setup_Linux-32bit. For 32-bit Linux systems. 2. Installation is identical for both variants.

bin./aris_mashzone_setup_Linux-64bit. run the program Uninstall mashzone in the system/_uninst_MASHZONE subdirectory. Start the installation program with the following command. 7. Open an X terminal and change to the directory to which you copied the installation program.5. Tip To stop ARIS MashZone server.sh in the ARIS MashZone installation directory. Programs started by common system users are not allowed to use these ports.13.5./aris_mashzone_setup_Linux-32bit.sh in the ARIS MashZone installation directory. Note   An installation under the virtual X server Xvfb is impossible because graphical screen output is impossible. 7. use the following command as an alternative. Note The program name to uninstall ARIS MashZone contains a space that you need to mask if you use the following call: .bin. 4.3 Start ARIS MashZone When the installation is done. If the installation program does not start./aris_mashzone_setup_Linux-32bit.13. Procedure Open a terminal window and run the program start_mashzone. run the program stop_mashzone./aris_mashzone_setup_Linux-64bit. The ARIS MashZone installation program is executed. sh . .bin or sh ./Uninstall\ mashzone 297 .4 Uninstall ARIS MashZone To uninstall ARIS MashZone.ARIS MashZone 3. If you specified a port number smaller than 1024 for ARIS MashZone server you must run ARIS MashZone server with root privilege. you can start ARIS MashZone server.bin or .

Do not use different driver versions of the same database type at the same time. To minimize the risk of accidental changes to the database schema used. we recommend that you do not run this type of command with ARIS MashZone. Technically. such as create or insert is not prohibited. however. execution of DDL (data definition language) commands. The JDBC database connection of ARIS MashZone requires the JDBC driver suitable for the database to be queried. depending on their complexity. Database queries are time-critical processes that may take up to several minutes. ARIS MashZone was tested with the following database systems and associated JDBC drivers: Oracle 9i. ARIS MashZone uses the driver class instantiated by the initial call of a connector. MS SQL Server 2008. which use this connection simultaneously. The required JDBC drivers are database-specific and are either part of the database installation or can be acquired from the manufacturer of the database system used. During the configuration of a database connection set the pool size to a value that corresponds at least to the minimum of data sources used in a MashApp. Oracle 10g. Tip You can acquire the JDBC driver suitable for your database from the manufacturer of your database system.1. Notes  Always use the JDBC driver suitable for the queried database version. Therefore.  If the JDBC driver of a database system contains multiple driver classes. IBM DB2 9.6 ARIS MashZone database connection Databases are connected via the standardized JDBC interface. you should set the cache time (Page 67) significantly higher than the longest response time expected for a database query.  The JDBC drivers of the database systems MS SQL Server 2000 and MS SQL Server 2005 cannot be used together. we recommend accessing the database schema via a role or user with only a read-only privilege. Selecting a suitable JDBC driver is not critical because ARIS MashZone uses standard JDBC features only. 298 . Oracle11g. This also applies if another driver class is configured for other DB connections with the same DB URL. MS SQL Server 2005. MySQL 5.1.ARIS MashZone 7.

(Page 42) URL parameter Parameter guid Description Unique internal ID to identify a MashApp. You can prevent this from happening by using the argument zeroDateTimeBehavior=convertToNull the JDBC URL.html?[GUID ]&<parameter>=<value> Example http://mypc:16360/mashzone/app/Viewer. Note The individual parameters are added with the & character and the values are assigned to the parameters with the = character. and certain parameters. 299 . Example: jdbc:mysql://dbsrv1:3306/umg?zeroDateTimeBehavior=convertToNu ll of 7. Make sure that you use the database connection as a system DNS. The URL consists of a base URL followed by a unique GUID for the relevant MashApp.  The JDBC driver of the database system MySQL returns empty date columns as 0000-00-00. enter a particular URL in your Web browser. not as a user DNS.html?guid=abc&language=de See also Call MashApps via URL (Page 43) Tip You can display the URL of a MashApp and copy it to the clipboard. Tip The GUID (internal ID) is located in the MashApp properties.7 MashApp URL parameters You can start a MashApp by entering a URL in your Web browser (Page 43). To do this.ARIS MashZone  To connect MS Access databases we recommend that you use a suitable commercial JDBC driver. http://[servername]:[port]/mashzone/app/Viewer.

you can still display this tab using a URL parameter: http://[servername]:[port]/mashzone/app/Viewer.ARIS MashZone Parameter tabidx Description Index of a MashApp tab that is initially displayed when calling a MashApp. The index starts at 0 (0. visible and hidden tabs..2. the call of the URL is redirected to the ARIS MashZone login page.). plainmode Hides the frame of the application in which the MashApp is displayed. the tab is not displayed in the MashApp. All tabs. However. Note Two pop-up menus are available in the MashApp view without frame. At present. The login page does not interpret URL parameters and the language parameter is ignored. the following values are supported:   de (German) en (English) Example http://[servername]:[port]/mashzone/app/Viewer..html?guid=abc&languag e=en Note If no valid session is running.e. are considered. Example http://[servername]:[port]/mashzone/app/Viewer..html?guid=abc&tabidx= 1 language Language in which the MashApp is displayed.e.html?guid=abc&plainmo de=true Prerequisite ARIS MashZone is installed in the Enterprise or Events edition. 300 .1. The call of the actual URL is only implemented after successful login to ARIS MashZone. i. Example Let us assume the following tabs exist and the index is displayed below each of them: Tab1 | Tab2 | Tab3 | Tab4 0 1 2 3 Tab2 is hidden. i. If this parameter has the value true only the MashApp is displayed.

password Password that a user logs in with to ARIS MashZone. To do so. you can create your own vector maps (vector graphics). This parameter is valid only in combination with the parameter password. you can set the zoom factor. such as Share. Example http://[servername]:[port]/mashzone/app/Viewer.8 User-defined vector graphics In addition to the vector maps supplied with ARIS MashZone. In the top right corner. The map definitions are available in the composer's data view. Print.html?guid=abc&user=sy stem&password=manager Prerequisite The parameter combination user/password must exist in ARIS MashZone.html?guid=abc&user=sy stem&password=manager Prerequisite The parameter combination user/password must exist in ARIS MashZone. No further login to ARIS MashZone is required. No further login to ARIS MashZone is required.ARIS MashZone Parameter Description   In the bottom left corner of the MashApp. Example http://[servername]:[port]/mashzone/app/Viewer. create a definition file in XML format and save it in the relevant ARIS MashZone directory. This parameter is valid only in combination with the parameter user. Note Specifying both parameters circumvents the ARIS MashZone login page. depending on your license key. Note Specifying both parameters circumvents the ARIS MashZone login page. user User name that a user logs in with to ARIS MashZone. or Save as image. various options are available. See also Use vector maps (Page 126) 301 . 7.

the definition file consists of any number of <polygonItem> elements. the file name is displayed in the selection box. The column is linked with the ID element of the vector map in the data view. Note The assigned data feed must have a feed column whose values are identical with the values of the various <polygonName> elements. The <polygonName> element is necessary for linking a row of the assigned data feed in ARIS MashZone with the corresponding polygon. <descriptions> The map is displayed in the selection box Map definition with the name as specified in the <descriptions> block in the definition file. which you can use to define a polygon with absolute positions. The following capital letters are available:    M = moveto L = lineto H = horizontal lineto 302 . If this <description> entry is missing. ARIS MashZone supports capital letters only. XML elements The XML definition file contains specific elements for structuring the vector map. The contents of the <path> element is an SVG path. <polygonItem> In addition to the <descriptions> block. <path> The <path> element is used for determining the actual polygon.ARIS MashZone Note The default directory for vector maps is the maps directory of your ARIS MashZone installation: %MASHZONE_HOME%\maps. <polygonName> A <polygonItem> must consist of a <polygonName> and a <path> element. as well. If no <description> entry is found for the language in which <_ARIS_ MashZone> is currently running the <description> is used with language="en". Each <polygonItem> element is drawn as a separate polygon in the vector map. Note To create an SVG path.

g.362186 z </path> </polygonItem> </polygons> Tip Use a vector graphic program to create your own vector graphic with the required <path> element. you can assign various color palettes to the data points and displayed elements. you can use the program Inkscape which you can download for free from the manufacturer's website.7142786. the line and column chart).62.91. you can create your own color schemes.9 User-defined color schemes In addition to the color schemes supplied with ARIS MashZone.21934 37.71428.62.7142786.054349.362186 5.115.21934 75. For example.org/2000/svg"> <descriptions> <description language="en" name="Map" /> <description language="de" name="Karte" /> </descriptions> <polygonItem> <polygonName>id1</polygonName> <path>M 145.71428.054349.9. <?xml version="1.554386 114.9.5050457 75.0" encoding="UTF-8"?> <!DOCTYPE polygons SYSTEM "polygons.362186 C 145.115.37422.71428.9.21934 5.169996 145.w3. These 303 .5050457 145.dtd"> <polygons xmlns:svg="http://www.169996 37.33.62.37422.554386 5.ARIS MashZone        V = vertical lineto C = curveto S = smooth curveto Q = quadratic Belzier curve T = smooth quadratic Belzier curveto A = elliptical Arc Z = closepath Definition file The definition file must be structured as follows..91. 7.714279.71428. For some components (e.115.7142786.33.5050457 114.714279.

The color scheme assigned to a component is retained and displayed after an import. create a definition file in XML format and save it in the relevant ARIS MashZone directory. The element receives one <description> element for each language. During the export of a MashApp. If there is no matching <description> element for the current language of ARIS MashZone the color scheme is displayed with the English element. even if the original definition file does not exist. and each of them is based on an individual color scheme. Note  The default directory for color schemes is the colorschemes directory of your ARIS MashZone installation: %MASHZONE_HOME%\assets\colorschemes.dtd"> <colorscheme> <descriptions> <description language="en" name="custom colors" /> <description language="en" name="user-defined colors" /> </descriptions> <colors>0xff0000. XML elements The XML definition file contains specific elements for structuring the color scheme. The individual colors must be separated with a comma. <colors> The element contains the list of colors to be included in this color scheme.0" encoding="UTF-8"?> <!DOCTYPE colorscheme SYSTEM "colorscheme. 0x00ff00. <descriptions> Indicates the name of the color scheme in the language in which ARIS MashZone was started. 0x0000ff</colors> 304 . If no English element exists. the definition files with the user-defined schemes are not imported. the name of the color scheme file is displayed in the selection box. Definition file The definition file must be structured as follows. <?xml version="1.ARIS MashZone components have individual color palettes.   The schema file will be imported during the next start of composer and displayed in the selection box of the color palette. See also Format display component (Page 52) To create an individual color scheme.

if required. In safe mode. or if existing MashApps and data feeds do not match the license key used.properties (Page 306) to enable the connection between ARIS MashZone and an LDAP system and configure it according to your requirements. Tip Export the MashApps and data feeds (Page 90) to create a backup copy. Personal) to a lower edition (e. except certain administration functions. for example. The configuration basically includes the following items. Free) and more users than allowed are logged in to ARIS MashZone.g. contact your LDAP system administrator for help with the configuration of the ARIS MashZone LDAP connection.ARIS MashZone </colorscheme> 7. 305 . This happens.g.    Use a matching and valid license key (Page 87) Reduce the number of users (Page 75) Delete the MashApps and data feeds violating the license (Page 89) Note If you are in safe mode and do not use a valid ARIS MashZone license (Free and Personal editions without license key) you cannot delete MashApps and data feeds because these editions do not include the Edit privilege for MashApps and data feeds. Note If necessary. A user with administration privilege has several options to run ARIS MashZone in normal mode again.1 System administration LDAP connection You can use the file umc. First.10 Safe mode ARIS MashZone automatically switches to safe mode if the number of users created is larger than the number of users allowed by the license key. you need to enter a valid license key. users have no access to most functions.11. if you change from a higher edition (e.11 7. 7.

The Admin. Attributes of these objects to be extracted (including first name. Where to search the LDAP system for users and user groups (searchpath). their LDAP properties take priority (e.ldap. Active.idsscheer.umc. User login data for logging in when importing from LDAP system (user/pwd). and the e-mail address. The following entries in the file umc. ARIS MashZone imports the users and user groups from the LDAP system to its own user database.g. last name.properties is located in the system directory of your ARIS MashZone installation. Object classes representing users and user groups in the LDAP system (objectclass). The file umc. e-mail address) Based on these settings.properties can be used to configure the LDAP connection.properties. Possible changes must always be made using the administration tools in the relevant LDAP system.idsscheer.only=  # Address at which the LDAP system can be found 306 . specifically the login name.11. Note If users created in LDAP already exist in ARIS MashZone when imported. this does not work the other way around. However. 7.1 Set the file umc. LDAP users can also be assigned to internal ARIS MashZone user groups.umc.auth. and Editor user properties are specific to ARIS MashZone and therefore can be set in ARIS MashZone.1.  # LDAP active (true) or inactive (false) com. password.aris.ldap. first name and last name.ARIS MashZone      Link from ARIS MashZone to LDAP system (url).active=  # Specifies whether only LDAP users can log in (true) or also ARIS MashZone specific users (false) com.properties The LDAP connection is enabled and the basic configuration is carried out in the file umc.aris. The users and user groups imported from the LDAP system can only be changed within certain constraints in ARIS MashZone itself. or e-mail address). first name and last name..

aris.pwd=  # Search path in the LDAP system to be searched for the users and user groups to be imported com.aris.idsscheer..idsscheer.ldap.aris.ldap.ldap.ldap.role.ldap.searchpath=  # Alternative search path for users com.idsscheer.user=  # Encrypted password of this user com.aris.aris.idsscheer. links to other LDAP systems) are to be followed (follow) or not (ignore) during the search of the LDAP system com.umc.ldap.skipOnFault=  # Recursion depth for the search (1 = Default.umc.umc.aris.aris.aris.ldap.g.ldap.url=  # User name used to log into the LDAP system for the import com.umc.umc.user.umc.idsscheer.umc.sync.aris.ldap.service.idsscheer.idsscheer.umc.user.searchpath=  # Object class in LDAP representing a user com. 0 = All) 307 .idsscheer.role.referral=  # Specifies how many sub-objects for an LDAP object are to be loaded for each block (0 = infinite) com.idsscheer.aris.service.aris.umc.ARIS MashZone com.searchpath=  # Alternative search path for user groups com.  # Specifies whether errors are to be skipped during the import (true) or whether the import is to be aborted (false) com.url=  # Alternative address in case the LDAP system cannot be reached at the above address com.umc.objectclass=  # Object class in LDAP representing a user group or a user role com.objectclass=  # Specifies whether additional object references (e.aris.idsscheer.backup.ldap.pagesize= Note This must be specified for the entry referral=follow.ldap.umc.ldap.umc.idsscheer.idsscheer.

firstname= com.DC\=corp\ .attribute.DC\= exampleCompany\.aris.backup.auth.aris.aris.idsscheer.umc.person= Example 1: (!(sAMAccountName=*$*)) Example 2: (&(objectClass=person)(sAMAccountName=*)((&(employeeID=*))))  # Attribute specifications for the object environment of an LDAP user or a group (including the relevant attributes) com.attribute.idsscheer.pwd=********************* *********** com.aris.searchpath=DC\=me\. you need to mask equal signs (=) and commas (.aris.ldap.objectclass=organizationalPe rson com.attribute.aris.role.aris.idsscheer. Example The following example shows a configuration for extracting an Active Directory (MS Windows): com.idsscheer.service.DC\=corp\.lastname= com.attribute.user=[user] com.idsscheer.guidformat= com.idsscheer.objectclass=group 308 .idsscheer.aris.attribute.url= com.umc.umc.g.idsscheer.aris.idsscheer.idsscheer.umc.user.name= com.umc.umc.recursion.url=ldap://exampleDirectory:389 com.unit.umc.aris.ldap.aris.aris.role.DC\=com com.idsscheer.attribute.ARIS MashZone com.hasmember= com..idsscheer.user.ldap.ldap.umc.memberof= com.user.service.attribute.umc.idsscheer.aris.attribute.aris.searchpath=OU\=employees\.attribute.ldap.ldap.aris.ldap.umc.umc.ldap.aris.depth=  # Filter for importing users (e.DC\=com com.ldap.umc.name= Note When specifying parameters.ldap.idsscheer.user.idsscheer.active=true com.ldap. which are managed as users in the LDAP system) com.filter.umc.ldap.name= com.idsscheer.umc.aris.ldap.idsscheer.idsscheer.umc.aris.umc.email= com.user.guid= com.idsscheer.idsscheer.DC\=exampleCompany\.DC\=corp\.aris.idsscheer.idsscheer.aris.idsscheer.ldap.aris.umc.umc.distinguishedname= com.ldap.umc.idsscheer. for general exclusion of technical equipment.ldap.umc.searchpath=DC\=me\.role.ldap.ldap.aris.DC \=me\.attribute.ldap.ldap.umc. such as computers and printers.) with the backslash (\).umc.idsscheer.attribute.ldap.objectclass= com.aris.DC\=com com.umc.DC\=exampleCompany\.ldap.umc.ldap.attribute.ldap.aris.aris.only=false com.umc.ldap.user.

they must first be deleted in ARIS MashZone or they will be explicitly excluded by a name filter when importing.umc.guid=objectGUID com.aris.email=mail com.objectclasscom.idsscheer. Thus.guidformat=Byte com.ldap.umc.aris.umc.ldap.aris.person= com.aris.idsscheer.name=sAMAccountNam e com.aris.memberof=memberOf com.idsscheer.name=name Notes   After changes to the file umc. There must not be any matches between ARIS MashZone and LDAP users or user groups here.ldap.referral=follow com.idsscheer.ldap.aris.umc.idsscheer.umc.ldap. The objects from the LDAP system that become user groups in ARIS MashZone are determined by the object class specified in the com.attribute.ldap.filter. the login name is decisive.aris.attribute.aris.firstname=givenNam e com.umc.properties.umc.ldap.pagesize=1000 com.user. there can be name conflicts between ARIS MashZone and LDAP users and user groups.attribute. but also user roles.aris.idsscheer.objectclass=objectClass com.umc. a direct check is carried out as to whether they already exist in the LDAP 309 . For users.idsscheer.ldap.depth=1 com.aris.role.sync.idsscheer.umc.objectclass configuration parameter. for example.idsscheer.idsscheer.umc.ldap.idsscheer.  All users imported from the LDAP system based on the LDAP configuration initially have no access to ARIS MashZone.unit.aris.attribute.idsscheer.attribute.attribute.umc.ari s.attribute.attribute.attribute.idsscheer.ARIS MashZone com.aris.skipOnFault=false com. They must be explicitly activated in the ARIS MashZone user management.aris.idsscheer.attribute.aris.umc.name=name com.umc. the group name for user groups.ldap.ldap. which become user groups in ARIS MashZone.ldap.user. the relevant object class specification can be used to import actual user groups from the LDAP system.   Only as many users as the active ARIS MashZone license allows can be activated.ldap.aris.ldap.role.user.umc.umc.umc.idsscheer.ldap.ldap. When an LDAP system is connected.distinguishedname=disti nguishedName com.umc.lastname=sn com.recursion.umc.idsscheer.aris.ldap.idsscheer. the ARIS MashZone server must be stopped and restarted.attribute.aris.attribute.ldap.  If users or user groups are created manually in ARIS MashZone.role.aris.umc.hasmember=member com.ldap. In order to import these from the LDAP system.idsscheer.idsscheer.user.

cache.1.umc.aris.umc. If necessary.1.aris.active=true  # Maximum number of users and user groups to be held in the cache com.idsscheer.aris.umc. you can use the command line program encryptpassword.bat in the folder %MASHZONE_HOME%\system\bin of the ARIS MashZone installation. the users imported from LDAP can no longer log into ARIS MashZone. Note The unencrypted password is entered in the command line in quotation marks as parameters.timeToIdle=43200 7.properties can be used to configure the caching. 310 .aris. The following entries in the file umc. all relevant properties are transferred from the LDAP system.umc. Only the ARIS MashZone users can log in.umc.cache.cache.11.pwd).ARIS MashZone system.service.1.aris.properties in encrypted form.properties (com.11.idsscheer.2 Encrypt LDAP password You need to enter the password you use to log in to the LDAP system after import to ARIS MashZone in the file umc.  # Cache active (true) or inactive (false) com.ldap.maxElements=500  # Minimum time span for which a cache object is held (in seconds) com.1 Set caching You can speed up access to users and user groups by setting up caching of the data.1. you copy it and enter it in the file umc. To encrypt the password. 7.idsscheer.timeToLive=43200  # Minimum time span for which a cache object must be inactive before it is removed from the cache (in seconds) com. The program outputs the encrypted password on the console.cache.  If the LDAP connection is disabled.idsscheer.idsscheer.

The SAML artifact is usually provided by the application calling. Tip For such an SSO scenario. we recommend that you integrate ARIS MashZone and the applications linked to ARIS MashZone into a common user management. 7. This means after login to one application. If you execute the command line in quick edit mode. you can easily copy the generated password to the clipboard.1. If this is not the case. 311 . The encrypted password is output in the command line.bat by executing the program without specifying parameters. For an SAML connection. the artifact contains the data of the user who wants to log in to ARIS MashZone.ARIS MashZone Example encryptpassword "my_password" Tip You can call the help on encryptpassword. login is successful and the user is granted access to ARIS MashZone. users may have to be created in each of the applications involved.x in its Enterprise edition.0. 2. Open a command line in the directory %MASHZONE_HOME%\system\bin. Enter encryptpassword followed by the desired password: encryptpassword "<password>". the user is automatically authorized to use additional applications. such as LDAP. Among other data. Press the Enter key. If the artifact is valid and the user is known to ARIS MashZone and active.2 SAML connection Use the SAML connection to embed ARIS MashZone in a single sign-on scenario. SAML (Security Assertion Markup Language) enables single sign-on (SSO) of a user for multiple applications in parallel. 3. Procedure 1. the HTTP query when calling ARIS MashZone must be added a so-called SAML artifact that ARIS MashZone verifies at an authentication service.11. Note From version 2. ARIS MashZone supports user login via SAML 1.

ARIS MashZone

7.11.2.1

Configure the file mashzone.properties
For login to ARIS MashZone with SAML, you need to set the following parameters in the file mashzone.properties. Note The file is located in the system directory of your ARIS MashZone installation. Tip You can edit the file using any text editor. With the following entries in the file mashzone.properties you configure SAML access.  mashzone.saml.artifact.param.name= artifact name; URL parameter for receiving the SAML 1.x artifact (provided by an authentication service)  mashzone.saml.identity.provider= URL of an authentication service for verifying the SAML 1.x artifact (usually a Web service that the calling application itself provides)  mashzone.saml.loginByDN=false SAML user login via LDAP distinguished name. Indicates whether the authentication service provides ARIS MashZone with the user name of the user (loginByDN=false) or the user's LDAP distinguished name (loginByDN=true).  mashzone.saml.useLoginNameFromDN=false Indicates whether the user name (part of the LDAP distinguished name) is to be used for login if the user is not found with its LDAP distinguished name.  mashzone.saml.loginNameKeywordInDN= Indicates the keyword under which the user name can be found within the LDAP distinguished name. Note If login is performed using the LDAP distinguished name and ARIS MashZone is not connected to an LDAP system, login is impossible. Login is possible, however, if the LDAP distinguished name contains the user name to be used as an alternative (useLoginNameFromDN=true).

312

ARIS MashZone

7.11.2.2

SSO integration in My webMethods
You can integrate ARIS MashZone under My webMethods in an SSO scenario by SAML (Page 311).

7.11.2.2.1

Configure mashzone.saml parameters
To integrate ARIS MashZone in an SSO scenario under My webMethods you need to configure the following parameters in the file mashzone.properties (Page 312) as follows.      mashzone.saml.artifact.param.name=SAMLart mashzone.saml.identity.provider=http://<hostname>:8585/services /SAML mashzone.saml.loginByDN=true mashzone.saml.useLoginNameFromDN=true mashzone.saml.loginNameKeywordInDN=uid

Instead of <hostname> you enter the name of the PC on which the My webMethod server is running into which you want to integrate ARIS MashZone via SSO. Based on these settings, users created in the My webMethods user management and users of an LDAP system can access ARIS MashZone. Note We recommend that you connect My webMethods and ARIS MashZone with the same LDAP system. Information on connecting My webMethods to an LDAP system is available in the relevant My webMethods documentation.

7.11.2.2.2

Integrate ARIS MashZone in My webMethods server
You can connect ARIS MashZone to My webMethods using the MashZone (Page 314) and wm_xt_ssolink (Page 316) portlets. While the wm_xt_ssolink (Page 316) portlet is part of the default My webMethods installation, you need to install the MashZone portlet in My webMethods yourself. The following chapters provide an overview of how to install the MashZone portlet and use the portlets to embed ARIS MashZone in My webMethods workspaces.

313

ARIS MashZone

Note Detailed information on using My WebMethods is available in the My WebMethods documentation.

7.11.2.2.2.1

Install MashZone portlet
You can install the MashZone portlet together with My webMethods or at a later time.  Use the Software AG Installer to install the portlet together with My webMethods. After you activated it, the portlet is immediately available in My webMethods in the Workspace Tools bar.  If you have already installed My webMethods, you can install the portlet at a later time using the Software AG Installer. To register the portlet at the My webMethods server, use the mws update application or the My webMethods administration interface. Note   The MashZone portlet is located in the Software AG Installer product tree under My webMethods User Interface. Detailed information on installing a portlet under My WebMethods is available in the My WebMethods documentation.

7.11.2.2.2.2

Use MashZone portlet
You can connect ARIS MashZone to My webMethods using the MashZone portlet. The connection enables you to display ARIS MashZone or individual MashApps in an embedded window (frame) on a My webMethods Web page (workspace). Prerequisite You have installed and activated the MashZone portlet (Page 314) so that it is available in the Workspace Tools bar. Procedure 1. Start My webMethods. 2. Insert the MashZone portlet from the Workspace Tools bar in a workspace. 3. Set the portlet properties.

314

ARIS MashZone

a. As SAML authentication enter the URL to ARIS MashZone, e.g. http://<host>:<port>/mashzone. b. Enter SAMLart for the artifact parameter. This is a default value. If you change it you also need to change the corresponding parameter in the file mashzone.properties. The portlet is configured for the integration of ARIS MashZone. If the ARIS MashZone SAML login to My WebMethods is properly configured and the user is known to ARIS MashZone and active (Page 74), ARIS MashZone starts without another login page. Note If you want to display a particular MashApp in the frame, you need to copy the MashApp link (Page 38) in ARIS MashZone and paste it in the portlet in the URL box. Only a single frame must be added to a My WebMethods workspace. If you add more frames, SSO problems can be the result.

Example: MashZone portlet properties

315

ARIS MashZone

Example: Workspace with MashApp view

7.11.2.2.2.3

Use wm_xt_ssolink portlet
You can connect ARIS MashZone to My webMethods using the SSO link portlet wm_xt_ssolink. This enables ARIS MashZone to open by mouse click in a new browser window without new login. Note The wm_xt_ssolink portlet is installed together with My webMethods by default. Procedure 1. Start My webMethods. 2. In the My webMethods configuration, activate the wm_xt_ssolink portlet so that it becomes available in the Workspace Tools bar. 3. Insert the portlet from the Workspace Tools bar in a workspace. 4. Set the portlet properties. a. Rename the portlet, e.g. Link to MashZone. b. As SAML authentication enter the URL to ARIS MashZone, e.g. http://<host>:<port>/mashzone. c. Select SAMLart as the artifact parameter.

316

ARIS MashZone

This is a default value. If you change it you also need to change the corresponding parameter in the file mashzone.properties. The portlet is configured for the integration of ARIS MashZone. You can click on the link in the portlet to start ARIS MashZone in a separate browser window. If the ARIS MashZone SAML login to My WebMethods is properly configured and the user is known to ARIS MashZone and active (Page 74), ARIS MashZone starts without another login page. Note If you use the POST method and the root context of ARIS MashZone is specified as a URL, the latter must end in a slash, for example http://<host>:<port>/mashzone/

Example: wm_xt_ssolink portlet properties

317

ARIS MashZone Example: Workspace with wm_xt_ssolink portlet 7.3.bat program is located in the following directory of your ARIS MashZone installation.11. Note The keytool. <MASHZONE_HOME>\system\jre\bin 7. This chapter describes how to install and configure an SSL certificate under Tomcat. 318 . JRE is part of your ARIS MashZone installation.1 Create keystore with self-signed certificate You can create a keystore with a self-signed certificate. To create a certificate you can use the Java Runtime Environment (JRE) command line program keytool. A keystore is a repository for security certificates (certification authority certificates or public key certificates) to be used in SSL encryption.11.bat.3 Tomcat SSL configuration With the SSL (Secure Socket Layer) encryption protocol. you can access ARIS MashZone and transfer your ARIS MashZone data securely within the network.

You can determine the certificate's period of validity by attaching the -validity parameter followed by the validity period in number of days to the command below.  To create the self-signed certificate.keystore Note If you want to use a certificate of a certification authority later. Warning If you save your keystore in the ARIS MashZone installation directory the file will be deleted when you update your ARIS MashZone version. Name of your city 319 .ARIS MashZone Note  The keystore generated contains a single entry with the alias tomcat. Open a DOS input box <MASHZONE_HOME>\system\jre\bin.g. Name of your organizational unit c. 3. depending on the certification service. This information will be shown to the users addressing ARIS MashZone via https://. www. you need to specify a file name and a directory in which you save your keystore file. Enter the required keystore password. Name of your organization d. If you just press the Enter key. The default password under Tomcat is changeit. you may have to enter the domain here (e. Execute the following command in the DOS box. a. Specify the queried data to create the self-signed certificate. 2.myside. 4. An entry consists of a private key and a self-signed certificate valid for 90 days.org). keytool -genkey [-keysize 2048] -alias tomcat -keyalg RSA -keystore <KEYSTORE_PATH>\. Procedure 1. The file path will be called KEYSTORE_PATH. various data on your identity will be queried. you may have to use certificates with a key length of at least 2048 characters.  When executing keytool. the data is marked as unknown. Specify the key length in the -keysize parameter. Please ensure that the data is correct. First and last name If you want to use a certificate of a certification authority later.bat. b. as well. You can also enter a different password that you need to specify in the Tomcat configuration (Page 320).

1. For ARIS MashZone to support SSL you must remove the comment signs and reboot ARIS MashZone server. Enter the password for the entry to be created in the keystore. Name of your state or province f. <KEYSTORE_PATH>\. The keystore is created and saved in the path specified.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" keystoreFile="KEYSTORE_PATH\. You need to specify the same password that you selected for the keystore (see step 3).3. 7.xml before you edit it. You define the connector in the file server. Confirm the summary with Yes.keystore" keyAlias="tomcat" keystorePass="changeit"/> --> ARIS MashZone can now be addressed under these two URLs:   http://<pcname>:<port>/mashzone https://<pcname>:8443/mashzone 320 . Note We recommend that you create a backup copy of the file server. If you specified different values when you created the keystore (Page 318) you need to specify these values here.xml in the directory <MASHZONE_HOME>\system\tomcat\conf\. The file already contains a preconfigured SSL connector. 6. <!-<Connector port="8443" protocol="HTTP/1. It is commented out by default.11. Country code (two letters) for this unit 5. If you do not confirm you will go back to step 4.ARIS MashZone e.1 Adapt Tomcat configuration After you created the keystore. Note The following entry is commented out by default. The values for keyAlias and keystorePass are preset so that they match the keystore created (Page 318) and the keystore entry. You also need to adapt the keystoreFile entry so that it points to the keystore you created. too.keystore. you need to define a connector for SSL in the Tomcat configuration.

1. <Connector connectionTimeout="20000" port="16360" protocol="HTTP/1.3. <security-constraint> <user-data-constraint> <transport-guarantee>CONFIDENTIAL</transport-guarantee> </user-data-constraint> <web-resource-collection> <url-pattern>/*</url-pattern> </web-resource-collection> </security-constraint> If the http://<pcname>:16360/mashzone is then called.1" redirectPort="8443"/> If ARIS MashZone is to be called via the http and https protocols exclusively using SSL you must add the following entry in the file web. too.3. 7.3 Real-time buffer service via SSL Note  If you are using the real-time buffer service please make sure that it runs on the same Tomcat server as ARIS MashZone server. If this is the case.1.ARIS MashZone Note Since you are using a self-signed certificate the browser will output a warning that the certificate is not trustworthy. generate a new Google Maps API key with https as protocol and replace the existing key.2 Address Google Maps via SSL Note If you use the Google Maps component (Page 110) with the corresponding API key and address ARIS MashZone later via SSL the component may no longer work. You can change the port for the SSL communication by adapting the entry port in the file mentioned above. 321 .11. the user is automatically redirected to the URL https://<pcname>:8443/mashzone. (Page 87) 7.11.xml in the directory <MASHZONE_HOME>\system\webapp\WEB-INF\. you need to change the entry redirectPort at the default connector.xml is overwritten during an ARIS MashZone version update. Note Please not that the file <MASHZONE_HOME>\system\webapp\WEB-INF\web. server. If you change the port for the SSL connector.xml.

properties. Open a DOS input box "MASHZONE_HOME"\system\jre\bin. The file certreq. you may have to adapt the entry mashzone. Procedure 1. You can send this file to the CA of your choice and receive the signed certificate you requested.3. keytool -certreq -keyalg RSA -alias tomcat -file <CERTREQ_PATH>\certreq.ARIS MashZone  If you want to address the real-time buffer service via SSL.uri in the directory <MASHZONE_HOME>\system\ of the file mashzone.  If you are using the real-time buffer service please make sure that the certificate used has not expired.de) you need to perform the following steps.11. The file path will be called CERTREQ_PATH. This is not required by default because the communication of ARIS MashZone with the real-time buffer service is internal. When executing keytool. you need to specify a file name and a directory in which you save your CSR file. 7.1 Create certificate signing request To receive a trustworthy certificate you need to create a certificate signing request (CSR). Tip Further information is available on the Web page of the certification authority.csr 3.11. 322 . Otherwise.2 Install trustworthy certificate If you want to use a trustworthy certificate issued by a certification service (certificate authority (CA)).csr is created in the directory <CERTREQ_PATH>.bat. Note You must create a self-signed certificate first (Page 318) before you can create a certificate signing request. 2.com. or trustcenter.3. such as verisign.2. thawte. Enter the same keystore password that you selected when created the keystore (Page 318) (default changeit). too. 7.rtbs. a connection between ARIS MashZone and the real-time buffer will not be established.com. Execute the following command in the DOS box.

Open a DOS input box "MASHZONE_HOME"\system\jre\bin. To run the user interface. you need Adobe Flash Player version 10.0-doc/ssl-howto.apache.11. 7. 7.ARIS MashZone 7.2 Import chain certificate or root certificate After you received the signed certificate of a certification authority you need to import the chain certificate of the certification service in your keystore. keytool -import -alias tomcat -keystore <KEYSTORE_PATH>\.3.2. Tip Further information on the SSL configuration of Tomcat is available in the relevant Tomcat documentation(http://tomcat.org/tomcat-6. As a repository (persistence layer). Note Please refer to the documentation of the certification authority you selected for information on how to receive the chain certificate. The server consists of a Java Web application based on the Spring Framework with Tomcat 6 as a server. Procedure 1.11. 2. The user interface (client) is an Adobe Flex application and is executed in an Internet browser. 2. Procedure 1. Open a DOS input box "MASHZONE_HOME"\system\jre\bin.12 System architecture ARIS MashZone is based on a Web application server. 323 . keytool -import -alias root -keystore <KEYSTORE_PATH>\.3.htm l).keystore -trustcacerts -file <path_to_chain_certificate> The chain certificate is imported into your keystore. Execute the following command in the DOS box. Execute the following command in the DOS box.3 Import signed certificate Now you can import your signed certificate that you received from the certification authority as an answer to your CSR.2.keystore -file <path_to_your_certificate> Your signed certificate has been imported.

12. e. The ARIS MashZone server uses another port for the server to receive administrative commands. How you activate the https protocol for the ARIS MashZone server and create a private SSL certificate is described in detail in the chapter Tomcat SSL configuration (Page 318). these ports must also be unlocked in the firewall. This requires at least one individual port that needs to be unlocked in the firewall if the ARIS MashZone server operates behind one. ARIS MashZone uses this management port 324 . such as CSV.g.1 Network communication ARIS MashZone server ARIS MashZone server and the user interface communicate exclusively via http protocol. XLS. http via SSL (https protocol). which is able to extract data using the ARIS PPM query interface. Other proprietary adapters allow integration of ARIS Business Server. and webMethods Broker. If you enable additional ports for communication.ARIS MashZone ARIS MashZone uses the RDBMS Apache Derby DB. and JDBC a proprietary ARIS PPM operator is available. which is addressed via JPA (Java Persistence API). 7. Overview of how ARIS MashZone functions In addition to data source operators for extracting various standard formats. XML. webMethods Optimize.

If you run ARIS MashZone under Linux you need to make sure that the directories used are available for the ARIS MashZone server system process. File access By default. Alternatively. These drives are available only if a user logs in. You can limit access to available home directories for specific ARIS MashZone users and groups. You can change the home directory for importing resources (Page 84). ARIS MashZone server can transfer the existing user management. Ensure that the home directories are not located in the directory structure of substituted drives or network drives. After changes to this file you must restart ARIS MashZone server. data can be specified directly in a data feed or uploaded and saved in the data feed. The upload is done using the ARIS MashZone server communication port. 325 .xml. You can also specify additional directories from which ARIS MashZone server can import files. data feed source files are imported into the directory structure of the %MASHZONE_HOME%\resources home directory. Chapter LDAP connection (Page 305) provides a detailed description of how to configure the LDAP connection.ARIS MashZone exclusively for stopping the server. When being connected to an LDAP system. The port used (default 389) must be unlocked in the firewall. You can change port usage later in the file %MASHZONE_HOME%\system\tomcat\conf\server. It is recommended that this port be locked in a firewall. It is recommended that you mount the drives located in other file systems during system start (/etc/fstab). Port usage of the server Communication port Management port Default 16360 16366 You can specify port usage when installing installing <_ARIS MashZone> (Page 289). ARIS MashZone server cannot access these drives if it was started as a Windows system service outside a user session. Data sources ARIS MashZone server is able to import data via the file system or the network.

Usually. The ports used must be unlocked in the firewall if access via a suitable proxy server is impossible. if ARIS MashZone server runs in a DMZ) it is recommended that you use a suitable procedure to tunnel the access to the JDBC data source behind the firewall. which transfers the queried JDBC data via https to ARIS MashZone server. To securely query data from a JDBC data source (e. the https protocol in a firewall is unlocked. A JDBC connection cannot be encrypted directly. The corresponding services must be started and available on the remote computers. ARIS MashZone can also import data directly from JDBC data sources. For database access. the ports required for the JDBC connection must be unlocked in the firewall. Examples are a direct SSH tunnel of the JDBC connection and a simple PHP interface of an https server behind the firewall. Data flow overview in ARIS MashZone 326 .g.ARIS MashZone Network access Data on remote computers can be imported via the http or https protocol.

ARIS MashZone When creating data feeds containing a JDBC operator. even if the individual data sources contain less than 10. 327 .000 characters. This limit can easily be reached during database queries. It also applies if multiple data sources are combined into one result. This limitation applies to the entire data feed. A data cell contains a maximum of 2.000 rows (data records) and a maximum of 48 columns.000 rows and 48 columns. avoid that data typed by the user become part of an SQL statement in order to minimize the risk of an SQL injection. The SQL statements generated need to take into account that an ARIS MashZone data feed supports a maximum of 10.

197 Database .98 Configure mashzone.29.143 Bar speedometer .197 B Bar chart .262 Copy data feeds .70 Change data type .50 Copy MashApp address to clipboard .132 Apply style .293 Configure real-time buffer .292 Configure EDA connection .43 Change data feed description .243 Assign data .63 Change data feed name .61 Assign users to particular user groups .4.263 Data feeds .298 ARIS MashZone installation .312 Configure webMethods Broker connection 96 Convert text .95 Change language .289 ARIS MashZone Quick Start Guide .225 Configure ARIS MashZone server .89 i .32 Delete columns .322 Create data feeds .33.28 Calculation .26 Create database connection .17 Assign keywords to a data feed .263 Create and edit MashApps .49 Create program shortcut .10 ARIS PPM .42 Copy single value .saml parameters .109 Change MashApp description .210 Data feed to value .60 Change password .87 Add MashApp view .139 D Data feed .267 Create user .100 Configure real-time buffer server .321 Aggregation .94 Create keystore with self-signed certificate 318 Create MashApp .97 Configure the file mashzone.313 Configure proxy server . 223 Data sources .294 Create resource directory .73 Assign keywords to a MashApp .250 Columns .235 Call MashApps via URL .properties .246 Column values .226 Combine data feeds .65 Delete data feeds/MashApps .212 Arithmetic .66.277.165 Bubble chart .290 Adapt Tomcat configuration .235 Appendix . 271 Change database connection .57 ARIS MashZone database connection .76 Automatically refresh data . 286 Define calculation rule .108 Change proxy server settings .77 CSV file .74 Create user groups .146 Buffer options .60 Column chart .86 Change resource directory .ARIS MashZone Index A Accept license terms .320 Add license key .48 Create certificate signing request .84 Change style template . 226 Copy MashApp .61 Change MashApp name . 226.58 Average .51 Address Google Maps via SSL .215 Date .101 C Calculate feed data .83 Create URL .233 Delete configuration of an EDA connection 100 Delete data feed . 223 Concatenate data feeds .

74.295 Integrate ARIS MashZone in My webMethods server .36 M Manage ARIS MashZone .295 Format display component .107 Display history of a MashApp .284 Display change history of a data feed .296 Install database drivers .73 Display data of a display component as a table .75 Determine earliest/latest date .56 Duplicate MashApp view .16 Install ARIS MashZone .87 Export data feeds/MashApps .51 G Geo aggregation .291 Install MashZone portlet .234 Duplicate display components .10 Goal accomplishment .250 Getting started .2 E EDA connection options .296 Installation under Linux .72 Display routes in Google Maps .195 Insert columns .74 Manage MashApps/data feeds .40 Delete MashApp view .107 Display MashApp properties .110 Display data feed properties .93 Install demo content .12 Display preview .80 Delete MashApp .232 Insert display component .180 Import chain certificate or root certificate 323 Import data feeds/MashApps .96 Delete display component .259 L LCD text .51 Delete real-time buffer configurations .44 Display MashApp view .85 Delete user groups .45 Display information on ARIS MashZone . 75 ii .267 Link texts .ARIS MashZone Delete database connection .105 Delete resource directory .248 Google Maps .52 Finish installation .323 Individual values .79 Import signed certificate .78 Encrypt LDAP password .314 Install trustworthy certificate .257 Log out .238 Geocoding .263 Input box .305 Line chart .52 Format MashApp view .89 Manage users .78 Delete users .178 LDAP connection .14 Edit user groups .156 I Image .293 Installation requirements .310 Enter Google Maps key .252 Find text .99 Edit data feeds .119 Duplicate columns .91 Import LDAP users and user groups .313 Introduction to ARIS MashZone .65 Edit e-mail templates .88 Edit MashApps .132 Display coordinates in Google Maps .322 Install webMethods Broker add-on .56 Delete LDAP users and user groups .136 Link text .25 Display raw data .109 F Figure .258 Finish feed definition .90 Extract text .46 Display help .40 Display MashApps .288 Filter values .73 Display components .

ARIS MashZone Manual data . 297 Start installation .108 Use cases .306 Set title .45 Save MashApp view as image .162 Spin control .3 Miscellaneous .149 Place display component .85 Single traffic light .27 Select installation directory .305 SAML connection .properties .220 Other . 287 Time filter .63 Share MashApp .59 Set server .81 Set gridlines .183 Set caching .22 Set function privileges .41 Select data source .286 P Pie chart .71 Set the file umc.290 Use carousel view .6 Start user interface .105 System administration .169 Slider .93 Set display size .297 Update ARIS MashZone .247 T Table .6.55 Multiple traffic light .290 Select system profile . 59 Set favorite .310 Set database connections .185 SSO integration in My webMethods .286 Output .293 U Uninstall ARIS MashZone .62 Use data sources .38 Share resource directory .23 Share data feed .24 Set source data .299 MashApps .44.38 Publish a MashApp with guest access .255 Retrieve info .48 Use data feeds .323 N Network communication .291 Select installation type .54 Speedometer chart .110 Use composer .311 Save data of a display component as a CSV file .25 Print MashApp view .290 Start real-time buffer instance .191 Tomcat SSL configuration .280 Move to front or back .277 Rounding .41 Procedure .46 Save display component as image .41 R Real-time buffer service via SSL .260 Replace values .44 Refresh data cache .133 Text .105 Move date .321 Refresh data .324 O Operators .83 Set size .175.313 Start ARIS MashZone .318 S Safe mode .305 System architecture .282 Replace text .234 Replace date field .66 iii .11 Set filter .269 Round up/down date .6 Submit ratings .211 MashApp URL parameters .189 Specify link .104 Start server .172 Selection box .67 Rename columns .

314 Use master view .301 V Values to data feed .266 Vector map .206 Z Zoom editor view .60 Use operators .110 Use MashApps .153 W Welcome to ARIS MashZone help .303 User-defined vector graphics .201 XML file .316 User input . 38 Use MashZone portlet .217 X XLS file .62 Use vector maps .68 Use Google Maps .10 Use user input .106 Use feed editor .219 wM Optimize .68 iv .13.286 User-defined color schemes .70 Use search .126 Use wm_xt_ssolink portlet .ARIS MashZone Use extended search .1 wM Business Events .

Sign up to vote on this title
UsefulNot useful