QPR Knowledge Base 2017.1

Customizing the Element View

Customizing the Element View

Previous topic Next topic No directory for this topic  

Customizing the Element View

Previous topic Next topic Topic directory requires JavaScript Mail us feedback on this topic!  

You can customize the appearance of the Element View in the Scorecards section of QPR Portal by modifying template files. See the sections below for possible options and required files. Note that after template customizations you need either need to restart QPR WAS or clear the template cache with the <host name or IP of the server>/QPR2017-1/Portal/qpr.isapi.dll?QPRWAS&*cleartemplatecache request.

 

 

Customizing the Amount of Recent Actions Shown

 

You can customize the amount of recent actions shown in the Element View (in both Summary and Details modes). To do this, open the sc_elementview_recentevents.tpl file (located in the C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\WAS\SC folder) and modify the recentactionscount setting. By default this setting is set to 50.

 

 

Hiding the Recent Actions Section

 

You can hide the Recent Actions section if you want to. There are different ways to do this:

Set the recentactionscount setting to 0 in the sc_elementview_recentevents.tpl file. This will hide the Recent Actions section regardless of the amount of actions.

Set the _iAutoHideRecentActions variable in the sc_elementview_summary.tpl file to 1. This will hide the Recent Actions section in the Summary view in the case there are no actions connected to the measure. Setting this to 0 displays the recent actions according to the recentactionscount setting in the sc_elementview_recentevents.tpl file.

Set the _iAutoHideRecentActions variable in the sc_elementview_details.tpl file to 1. This will hide the Recent Actions section in the Details view in the case there are no actions connected to the measure. Setting this to 0 displays the recent actions according to the recentactionscount setting in the sc_elementview_recentevents.tpl file.

 

 

Customizing the Fields Shown in the Recent Actions Section

 

In addition to the default fields Type, Date, Person, and Header shown in the Recent Actions section, you can define the following extra fields to be shown for action plans:

Assigned to

Deadline

Progress

Status

Owner

Creation Date

 

In order to get these fields into use, remove the HTML comment tags (<!-- and -->) around the tag rows in sc_elementview_recentevents.tpl and sc_elementview_recenteventsrow.tpl files located in the C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\WAS\SC folder.

 

 

Hiding the Sub-elements Section

 

You can hide the Sub-elements section if you want to. See below for instructions:

Set the _iAutoHideSubElements variable in the sc_elementview_summary.tpl file to 1. This will hide the Sub-elements section in the Summary view in the case the measure does not have any sub-elements. Setting this to 0 displays the sub elements section if the template specifies so.

Set the _iAutoHideSubElements variable in the sc_elementview_details.tpl file to 1. This will hide the Sub-elements section in the Details view in the case the measure does not have any sub-elements. Setting this to 0 displays the sub elements section if the template specifies so.

 

 

Customizing the Sub-elements Section

 

There are some customizations available for the Sub-elements section, see below for instructions:

 

To include the Description field into the Sub-elements section:

Remove HTML comment tags from the "<td><#Object attribute="description" AcceptSoftHyphen="1" ConvertLF="1">" row in sc_elementview_subelements_row.tpl file.

Remove HTML comment tags from the "<th align="left"><#LocalizedText id="Description">" row in sc_elementview_subelements.tpl file.

 

The #Value, #Period, #ColorImage, and #TrendImage tags also accept a parameter called Offset to define whether a period offset should be applied to the period otherwise shown. Valid values for Offset are positive and negative integers. For example <#Value unit="true" offset="2"> would display the value (with unit included) for the period that's two periods after the period selected for the view.

 

Hiding the Values Section

 

You can hide the Vales section if you want to. See below for instructions:

Set the _iAutoHideValues variable in the sc_elementview_summary.tpl file to 1. This will hide the Values section in the Summary view in the case the measure does not have any sub-elements. Setting this to 0 displays the values section if the template specifies so.

Set the _iAutoHideValues variable in the sc_elementview_details.tpl file to 1. This will hide the Values section in the Details view in the case the measure does not have any sub-elements. Setting this to 0 displays the values section if the template specifies so.

 

Controlling the Series Visible in the Values Table

 

The sc_elementview_values.tpl file has a setting (alwaysshowmanual, 0 by default) for defining which series are visible in the Values table of the Element View:

Series shown with alwaysshowmanual=0 are

the default series and all series visible in any of the chart elements in the graph.

Series shown with alwaysshowmanual=1 are

othe default series, all series visible in any of the chart elements in the graph, and all series with manual value input

If the element does not have any chart elements included in the element graph, the series shown are the default series and all series with manual value input (with both values of alwaysshowmanual).

If the value settings have a custom series order defined, the custom order overrides all inclusion rules defined by the alwaysshowmanual setting

 

 

Controlling the Element View Subelement Period Listing

The sc_elementview_subelements.tpl file has a periodmode setting for defining how a selected period should be translated to a concrete period in QPR Portal. The values for the periodmode setting are latest and latest for all (default). The actual periods shown depend on the periodmode setting and the number of indicators on the graph layout as shown in the table below. The first row (Current, Latest, etc.) indicates the period currently selected in QPR Portal, the first column shows how many indicators (0 or n) there are in the graph layout and the value of the periodmode setting.

 


Current

Latest

Latest for All

Default

Fixed

1 Indicator & Latest

Current

Indicator period

Indicator period

Indicator period

Fixed

0...n Indicators & Latest

Current

Top element latest

Element's latest

Element's latest

Fixed

1 Indicator & Latest for All

Current

Latest for all subelements

Latest for all subelements

Latest for all subelements

Fixed

0...n Indicators & Latest for All

Current

Latest for all subelements

Latest for all subelements

Latest for all subelements

Fixed