Difference between revisions of "Measures"

From Hornbill
Jump to navigation Jump to search
 
(43 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
__NOTOC__[[Main Page|Home]] > [[Administration]] > [[Reporting]] > Measures
+
This document can now be found at its new location in the [https://docs.hornbill.com/esp-config/advanced-analytics/measures/ Hornbill Document Library].
−
==Introduction==
 
−
In order to provide strategic business intelligence through reporting one of the key requirements is to define measures that are sampled and stored periodically. Once these measures are stored over a period of time the type of reporting possible is expanded considerably and include things like trending, performance measurement against goals and thresholds, and predictions based on historical trends.
 
−
<br>
 
−
<br>
 
−
[[File:measures1.png |2000px|Sample measures showing targets and trends over time]]
 
−
<br>
 
−
<br>
 
−
The creation of a Measure includes selecting the data that you which to sample, the frequency that the samples are taken, and the targets and goals that you which to achieve.
 
  
−
=== Output ===
+
[[file:hornbill-document-library.png|Measures|link=https://docs.hornbill.com/esp-config/advanced-analytics/measures/]]
−
The information provided by measures can be used to build Widgets for displaying on Dashboards. The output consists of numerical values that enable the population of:
 
−
* Scorecards. This is a count of the data that the measure has recorded per period.
 
−
* Sparklines. This is a count of the data that the measure has recorded per period shown in a chart format
 
−
* Actual vs Target. This is a count of the data recorded vs the target count of the measure per period.
 
  
−
==Features==
+
<!--
−
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1200px">
+
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
−
====Basic Information====
+
__NOTOC__
−
<div class="mw-collapsible-content">
+
{| style="width:100%"
−
:*Title - The title is visible from withing the list of defined measures.  It is also used when creating a widget based on a measure.
+
|[[Main Page|Home]] > [[Administration]] > [[Advanced Analytics]] > Measures
−
:*Description - A details description of the measure can be provided so that other users with the ability to view and edit this measure can understand more about the measure.
+
|style="text-align:right;"|[[:Category:Service Manager Administration|Index]]
−
:*Status - A "running" measure is currently active and sampling data based on the frequency.
+
|}
−
<br>
 
−
<br>
 
−
[[File:newMeasure.png |1200px|Creating a new measure]]
 
−
<br>
 
−
<br>
 
−
</div>
 
 
</div>
 
</div>
−
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1200px">
+
{|style="width: 100%"
−
====Measure====
+
|- valign="top"
−
<div class="mw-collapsible-content">
+
|style="width:73%"|
−
:*Frequency. This is the frequency that the measure will take a data sample. The options are:
+
== Introduction ==
−
::*DAILY
+
In order to provide strategic business intelligence through reporting, one of the key requirements is to define measures that are sampled and stored periodically. Once these measures are stored over a period of time, the type of reporting possible is expanded considerably. It includes trending, performance measurement against goals and thresholds, and predictions based on historical trends.
−
::*WEEKLY
 
−
::*MONTHLY
 
−
::*QUARTERLY (Please choose the starting quarter)
 
−
::*YEARLY
 
−
:* Value Aggregate. This is the type of calculation that the measure will perform.
 
−
::*COUNT - An integer that represents a count of items in a result set that match a specific criteria
 
−
::*AVERAGE - A numeric value that represents the average value in a series of values in the data set
 
−
::*MIN - A numeric value that represents the lowest value in a series of values in the data set
 
−
::*MAX - A numeric value that represents the highest value in a series of values in the data set
 
−
::*SUM - A numeric value that represents the sum of a series of values in the data set
 
−
::*PERCENT - A percentage of items in a given data set that match a criteria from a larger subset. For example, the count of records where column X = 5 in a set of records in a given date range, returned as a percentage.
 
−
:*Scorecard Limit. This is the number of samples that will be shown against a scorecard. [[File:scorecard.png |150px|Scorecard]]
 
−
:*Sparkline Limit. This is the number of samples that will be shown against a sparkline. [[File:sparkline.png |150px|Sparkline]]
 
−
:*Maximum Sample History. This is the maximum number of samples that the system will store against this particular measure.
 
 
<br>
 
<br>
 +
 +
|style="width:5%"|
 +
|
 +
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
 +
 +
== Related Articles ==
 +
:* [[Application_Entity_Viewer|Application Entity Viewer]]
 +
:* [[Widgets]]
 +
:* [[Reports]]
 +
|}
 +
The creation of a Measure includes selecting the data you wish to sample, the frequency that the samples are taken, and the targets and goals you wish to achieve.
 
<br>
 
<br>
−
[[File:measures2.png |1200px|Measure Details]]
+
The information provided by measures can be used to build Widgets for displaying on Dashboards. The output consists of numerical values that enable the population of:
 +
[[File:measures1.png |thumb|link=https://wiki.hornbill.com/images/e/ed/Measures1.png|Sample measures showing targets and trends over time]]
 +
:* '''Scorecards'''
 +
:: This is a count of the data that the measure has recorded per period.
 +
:* '''Sparklines'''
 +
:: This is a count of the data that the measure has recorded per period shown in a chart format
 +
:* '''Actual vs Target'''
 +
:: This is a count of the data recorded vs the target count of the measure per period.
 
<br>
 
<br>
 
<br>
 
<br>
−
</div>
+
==Features==
−
</div>
+
===Basic Information===
−
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1200px">
+
[[File:newMeasure.png |thumb|right|link=https://wiki.hornbill.com/images/1/16/NewMeasure.png|Creating a new measure]]
−
====Targets & Goals====
+
:* '''Title'''
−
<div class="mw-collapsible-content">
+
:: The title is visible from within the list of defined measures. It is also used when creating a widget based on a measure.  
−
:* Target Threshold. This is the count that needs to be achieved in order to meet the measure's target.
+
:* '''Description'''
−
:* Warning Threshold. This is the count between the target and the breach thresholds.
+
:: A details description of the measure can be provided so that other users with the ability to view and edit this measure can understand more about the measure.
−
:* Breach Threshold. This is the count that needs to be achieved in order for the measure to breach its target.
+
:* '''Status'''
 +
:: A "running" measure is currently active and sampling data based on the frequency.
 
<br>
 
<br>
−
The direction of the threshold can be changed by clicking the arrow to the right of the threshold targets. In terms of requests or requests logged you would want to say that the lower the number is, the better the teams are performing, however for total number of resolved calls, a higher count is better.
+
 
 +
===Measure===
 +
[[File:measures2.png |thumb|link=https://wiki.hornbill.com/images/d/dc/Measures2.png|Measure Details]]
 +
:* '''Frequency'''
 +
:: This is the frequency that the measure will take a data sample. The options are:
 +
:::* ''DAILY''
 +
:::* ''WEEKLY''
 +
:::* ''MONTHLY''
 +
:::* ''QUARTERLY (Please choose the starting quarter)''
 +
:::* ''YEARLY''
 +
:* '''Value Aggregate'''
 +
:: This is the type of calculation that the measure will perform.
 +
:::* '''''COUNT'''''
 +
:::An integer that represents a count of items in a result set that match a specific criteria
 +
:::* '''''AVERAGE'''''
 +
:::: A numeric value that represents the average value in a series of values in the data set
 +
:::* '''''MIN'''''
 +
:::: A numeric value that represents the lowest value in a series of values in the data set
 +
:::* '''''MAX'''''
 +
:::: A numeric value that represents the highest value in a series of values in the data set
 +
:::* '''''SUM'''''
 +
:::: A numeric value that represents the sum of a series of values in the data set
 +
:::* '''''PERCENT'''''
 +
:::: A percentage of items in a given data set that match criterion from a larger subset. For example, the count of records where column X = 5 in a set of records in a given date range, is returned as a percentage.
 +
:* '''Scorecard Limit'''
 +
:: This is the number of samples shown against a scorecard. [[File:scorecard.png |150px|Scorecard]]
 +
:* '''Sparkline Limit'''
 +
:: This is the number of samples shown against a sparkline. [[File:sparkline.png |150px|Sparkline]]
 +
:* '''Maximum Sample History'''
 +
:: This is the maximum number of samples that the system will store against this measure.
 
<br>
 
<br>
 
<br>
 
<br>
−
[[File:measures3.png |1200px|Measure Thresholds]]
+
 
 +
===Targets & Goals===
 +
[[File:measures3.png |thumb|link=https://wiki.hornbill.com/images/3/3a/Measures3.png|Measure Thresholds]]
 +
:* '''Target Threshold'''
 +
:: This is the count that needs to be achieved in order to meet the measure's target.
 +
:* '''Warning Threshold'''
 +
:: This is the count between the target and the breach thresholds.
 +
:* '''Breach Threshold'''
 +
:: This is the count that needs to be achieved in order for the measure to breach its target.
 
<br>
 
<br>
 +
{{infobox|The direction of the threshold can be changed by clicking the arrow to the right of the threshold targets. In terms of requests or requests logged, you would want to say that the lower the number is, the better the teams are performing; however, for the total number of resolved calls, a higher count is better.}}
 
<br>
 
<br>
−
</div>
 
−
</div>
 
−
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1200px">
 
−
====Data Source====
 
−
<div class="mw-collapsible-content">
 
−
:* Table. This is the primary table from which the measure will collect its data.
 
−
:* Key Column. This is the primary key of the named table.
 
−
:* Additional Tables. This is where you would specify any additional tables from which the measure will collect its data.
 
−
:* Date Ranging Column. This is the date column that the measure will base its data collection on. For a measure designed to count the number of requests logged, you would select h_datelogged here.
 
−
:* Date Ranging Column 2. This is the 'to' date column that the measure will base its data collection on
 
−
:* Query where clause. This is where you can add a filter to the measure.
 
−
:* Percentage Sub-Query. This is where you can add a percentage filter to the measure.
 
−
:* Saved Data Columns. This is where you can specify which column are available to be drilled down on and grouped by.  '''Unless columns are defined against the measure, they will not be available to group or drill down by when configuring widget content based on the measure'''.
 
 
<br>
 
<br>
−
<br>
+
 
−
[[File:measures4.png |1200px|Data Source Details]]
+
===Data Source===
 +
[[File:measures4.png |thumb|link=https://wiki.hornbill.com/images/d/dc/Measures4.png|Data Source Details]]
 +
:* '''Table'''
 +
:: This is the primary table from which the measure will collect its data.
 +
:* '''Key Column'''
 +
:: This is the primary key of the named table.  Being the primary key, this provides a unique identifier for each record
 +
:* '''Additional Tables'''
 +
:: This is where you would specify any additional tables from which the measure will collect its data.
 +
:* '''Date Ranging Column'''
 +
:: Here, you select a date column that the measure will base its data collection on. The dates held in this column will be used to count/sum/average the records based on frequency, such as last month, last year or all records since the beginning of this year.
 +
:* '''Date Ranging Column 2'''
 +
:: This is an optional field where you can provide a second date column to be included as part of the criteria for data collection.  This will be used to count/sum/average the records where the collected data for the selected frequency will be based on both ''Date Ranging Column'' AND ''Date Ranging Column 2.'' 
 +
:* '''Query where clause'''
 +
:: This is where you can add a filter to the measure.
 +
:* '''Percentage Sub-Query'''
 +
:: This is where you can add a percentage filter to the measure.
 +
:* '''Saved Data Columns'''
 +
:: This is where you can specify which columns are available to be drilled down on and grouped by.  '''Unless columns are defined against the measure, they will not be available to group by or drill down when configuring widget content based on the measure'''.
 
<br>
 
<br>
 
<br>
 
<br>
−
</div>
 
−
</div>
 
  
−
====Examples====
+
==Examples==
  
−
In this section we will include examples of the different types of Measure which can be defined
+
In this section, we will include examples of the different types of Measure which can be defined.
  
 
:* Count - Incidents Logged Per Month {{#ev:youtube|-rnzzGBzc6g|400|left}}
 
:* Count - Incidents Logged Per Month {{#ev:youtube|-rnzzGBzc6g|400|left}}
  
−
 
+
-->
−
[[Category:Administration]]
+
[[Category:HDOC]]

Latest revision as of 20:07, 11 April 2024

This document can now be found at its new location in the Hornbill Document Library.

Measures

Retrieved from "https://wiki.hornbill.com/index.php?title=Measures&oldid=32287"