Configuring MashZone for Workflow Dashboard

OneData uses MashZone to visualize the workflow reports as graph and summary tables. You can analyze these visualizations under workflow dashboards. OneData supports MashZone 2.2 and later versions.

OneData provides you a .mzp file containing eight data feeds that establishes the connection between OneData and MashZone. These data feeds use the data from the system objects for workflow analysis and generates the graph and summary tables. The data feeds are:

OD_WF_WFRules_Feed

OD_WF_Object_Feed

OD_WF_Approvers_Feed

OD_WF_OldestPendingItems_Feed

OD_WF_MostPendingObjects_Feed

OD_WF_MostPendingApprovers_Feed

OD_WF_Graph_Feed

OD_WF_ApprRej_Graph_Feed

For more information about the system objects, see System Objects Used In Workflow Dashboard.

Important:
You must install MashZone from http://www.mashzone.com/en/download on your machine before configuring the workflow dashboard. For MashZone installation steps, see the ARIS documentation on the Software AG Documentation website.

To configure MashZone for workflow dashboard

1. Log on OneData.

2. On the Menu toolbar, select Administer > System > System Properties.

3. Under the header General, provide the MashZone URL.

MashZone URL format is:

http://server_name:port

4. Go to <OneData_Installation_Directory>\OneData\MashZone-2.2.0.0 and do the following:

a. Copy M_OD_WF_Dashboard.mzp file and paste to the location MashZone HOME\importexport.

Note:
The .mzp file provides eight data feeds that connect OneData and MashZone.

b. Copy onedata_workflow folder and paste to the location MashZone HOME\resources\demo.

Note:
The onedata_workflow folder contains the image files used by workflow dashboard reports.

5. Start MashZone Server.

6. Import M_OD_WF_Dashboard.mzp file into MashZone Server as follows:

a. On top right side of the screen, click Administration.

b. Click Import/Export/Delete.

c. Click Import and select M_OD_WF_Dashboard.mzp file.

d. Click OK.

e. Click Import All.

f. Click OK.

The import process is now complete.

7. Click Home on the top right of the screen.

8. Click the Data feeds tab to view the below listed data feeds.

OD_WF_WFRules_Feed

OD_WF_Object_Feed

OD_WF_Approvers_Feed

OD_WF_OldestPendingItems_Feed

OD_WF_MostPendingObjects_Feed

OD_WF_MostPendingApprovers_Feed

OD_WF_Graph_Feed

OD_WF_ApprRej_Graph_Feed

9. In the Source: XML File dialog of each of the above data feeds, update Source fields to set the below variables in the URL.

Important:
You must click the Refresh icon next to the Source field after each update to the field. After refreshing, if you see any field in the screen highlighted in red (indicating error), contact Software AG Global Support.

Tip:
After clicking the refresh icon, if MashZone shows a warning that says unable to load column configuration, you must click Cancel to proceed without any error and to avoid the deletion of existing column configuration.

Variable	Description
Server_Name	Name of the server on which OneData runs.
Port	Port number of the server on which OneData runs.
Repository	Name of the repository.

The URL format is:

http://<Server_Name>:<Port>/onedata/rest/<Repository>/Standard Project/...

10. Save the changes.

11. Activate guest access in MashZone Server to enable guest access to MashApp while viewing dashboards in OneData.

a. Click Administration on top right of the screen.

b. Click User Management on the left side.

c. Select Guest access tab and click Activate.

d. Click Home on top right of the screen.

e. Select MashApps tab.

f. Select the data feed OD_WF_Dashboard.

g. Click More... > Share... on the top right side of the screen.

h. Select the Publish (allows displaying without login) check box and click Share to complete guest access activation.

You have now configured MashZone to view the workflow dashboards.