Skip to Content mrc logo mrc logo
  • What is m-Power?
    Overview Demos Build Process Case Studies Specs Pricing Trial
    m-Power Resources
    Overview How-To Videos Webinars & Podcasts White Papers Fact Sheets
  • What does m-Power build?
    Overview Database Front-Ends Reporting CRM Systems Business Intelligence Dashboards Inventory Management Mobile Apps ERP Enhancements Modernization Spreadsheets to the Web MS Access to the Web B2B/Web Portals Scheduling Embedded Analytics Web Forms Workflow Data Exploration Budgeting & Forecasting APIs & Web Services Db2 Web Query Alternative
    Solutions by Industry
    Overview Manufacturing Government Foodservice Software Vendors Logistics & Supply Chain Software Consultants Healthcare
  • Development Services Training Mentoring
  • Overview Partners Press Releases Careers Events Contact Blog
  • Support Home FAQ Documentation Customer Portal Enhancements Updates Roadmap Techblog
Try m-Power

m-Power Manual

Browse:

  • Home
  • Utilities
  • Setting up the User-Defined Dashboard within the m-Power Interface
Back to Manual

Setting up the User-Defined Dashboard within the m-Power Interface

The User-Defined Dashboard allows end users to choose an existing dashboard layout, or create their own by selecting applications from a list of developer designated applications.  Any dashboard settings made by the user can be saved within their browser or to the server; this allows each user to make adjustments to the dashboard and save their changes separately. These user created dashboards can then be shared via URL, or made public to other users.&nbsp

finDash

To configure a dashboard, select 'Dashboards' on the left toolbar within the m-Power interface.  This will bring you to a listing of all configured dashboards for your current data dictionary.

appList2

Creating a Dashboard

To add a dashboard to this list, click the green plus sign.

create-new

Enter a name and description. Note: If your dashboard name has any spaces in it, these will be converted to dashes.  However, at runtime, any dashes within the name will be converted to spaces.  Click accept.

Adding Applications to the Dashboard

We are now ready to add our first application to the dashboard.  Click the edit button on your dashboard.  This will bring you to Manage Dashboard screen.

addapp

Click on the 'Add New Application' button

Select the dictionary, application type, and application name from the dropdowns. The 'Additional App Parameters' and 'Title' input boxes will be auto-populated. In the 'Additional App Parameters' input box you will see the text basic=3, dash=2, and run=2.  These parameters optimize the application's appearance to be loaded from within a dashboard.  The 'Title' input box will display the name of the application and will be seen by end-users at runtime.  You can change this if you like.

addapp2

You have the option of seeing a preview of your application as it should appear in your dashboard with the 'Preview' tab.

Once saved, your application will be added to the list of available applications in your dashboard.

appList3

If you’ve created a dashboard record selection with a matching field in this application, you can click ‘Map Selection Criteria’ to filter your application, based on the dashboard criteria value. 

addapp3

Select the field in the application you wish to apply the record selection to from the first dropdown.  Select the appropriate dashboard criteria from the second dropdown.  Once finished, click ‘Add Parameter Mapping’.  I can now see that m-Power has automatically added some parameters to the Additional App Parameters box. My screen will now appear as so:

addapp4

The mapping will appear differently depending on whether the record selection is a Single Value, Multiple Values, or Range.  Once you’ve added your mapping, add a title and a description.  These will only appear within the dashboard listing in the interface, and will not be shown to the end-users.  Once you are finished, click accept.  This will bring you back to the dashboard listing page.  You are now ready to run your dashboard.  Click on the green arrow to the left of the dashboard name to run the dashboard.

greenarrow

After the dashboard has been setup, upon execution, the end-user will see the following screen. This is a blank canvas where you or your end user can design the dashboard's layout. Please proceed to Customizing the User Defined Dashboard at Runtime for more information.

newdash

Adding Runtime Selection Criteria

Click ‘Configure’.  This will open a small window.

configure

Now you can either add an application to the dashboard, or add  record selection criteria.  This criteria in a dashboard works the same as a runtime record selection in an application.  However, selection criteria in a dashboard allows the user to enter a value which will filter any applications assigned to the dashboard.

After clicking ‘Add Runtime Selection Criteria’, you will be brought to the Add New Dashboard Selection screen.  Enter the description that you would like the end-users to see.  My selection will filter all applications based on the entered Region Number, so I will set my description to Region:

new_selection

Here, you have the option to allow users to enter a single value, multiple values, or a range of values. For my example, I will select Single Value. Click accept to save this selection, and return to the dashboard listing.

Customizing the Selection Dialog/Panel

Once in the listing, click ‘Configure’.  Note that an additional option has been created within this list, ‘Generate/Customize Selection Dialog’. This will allow you to edit the Dashboard Selection Criteria inputs as they appear in the selection dialog or left selections panel (depending upon the option you selected when first creating the dashboard). If you have not designated any selections, you can continue to Adding an Application.  If you have added selection criteria, you must generate the HTML that will allow the criteria to appear at runtime.  If this is the first time you click on this link, you will immediately be brought to m-Painter, where you can customize the selections.  If you have previously clicked on this link, you will see this window:

customizeselection

You can either edit the existing presentation layer for the selection criteria, or revert to the default and edit that instead.  This is the same concept as overwriting the HTML of an application  After you make a selection you will be brought into m-Painter.  Once you have finished customizing the selections, you are ready to add applications to the dashboard.

Promoting the Dashboard to Production

You can promote a dashboard to production by promoting the entire data dictionary.  Note that any applications that are in the dashboard but not in the same data dictionary will need to be promoted as well.

If you only want to promote the dashboard, you will need to promote the following files:

mrc_dashboards.txt

'DASHBOARD-NAME'_dashboard.html

'DASHBOARD-NAME'_d.html

These files can all be found in \mrcjava\WEB-INF\classes\'DATA DICTIONARY', where 'DATA DICTIONARY' is the data dictionary name.  Additionally, the web.xml file in the mrcjava\WEB-INF folder also must be promoted.  Replace 'DASHBOARD-NAME' with the name of the dashboard you wish to promote.  The 'DASHBOARD-NAME'_d.html file contains the HTML for the dashboard selections, therefore this file is only created if selections have been generated.

Created: August 12, 2013 | Modified: February 9, 2018

Search


Browse By Category

Build Process (13)
Starting with m-Power (8)
Retrievals (10)
Reports (15)
Summaries (4)
Maintainers (17)
Graphs (8)
m-Power Data Explorer (4)
General (24)
Calculations (5)
Utilities (9)
m-Power Administration (23)
Security (11)
Freemarker (6)
m-Painter (29)
Form Validation (5)
External Objects & UDFs (12)
Deprecated Documentation (23)
Bootstrap Templates (7)

Popular Tags

Java SQL Getting Started External Objects Graph Properties Graphing Email Bar Graphs Data Dictionary Retrievals Build Process mrc-Productivity Series Maintainers Form Validation Application Properties Maintainer Summaries Advanced App Properties Database Retrieval Security Excel Administration Parameters Popular Dropdowns Report m-Painter Record Selections Prompt Screens Bootstrap Templates Reports Compiling Production DB2 Video Graphs Dates Freemarker Performance Tomcat RPG Calculations Admin

See all tags »

michaels, ross & cole, ltd. (mrc)

Privacy Policy Cookie Policy Cookie Settings Notice at Collection Do Not Sell or Share My Personal Information

mrc (US)

2001 Midwest Road
Suite 310
Oak Brook, IL 60523
630-916-0662

mrc (UK)

Mortlake Business Centre
20 Mortlake High Street
London, SW14 8JN
+44-20-335-59566


© mrc. All rights reserved.