Difference between revisions of "Measures"

From Hornbill
Jump to navigation Jump to search
 
(37 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
This document can now be found at its new location in the [https://docs.hornbill.com/esp-config/advanced-analytics/measures/ Hornbill Document Library].
 +
 +
[[file:hornbill-document-library.png|Measures|link=https://docs.hornbill.com/esp-config/advanced-analytics/measures/]]
 +
 +
<!--
 
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
 
<div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
 
__NOTOC__
 
__NOTOC__
Line 10: Line 15:
 
|style="width:73%"|
 
|style="width:73%"|
 
== Introduction ==
 
== 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.
+
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.
−
<br>
 
−
<br>
 
−
[[File:measures1.png |1000px|Sample measures showing targets and trends over time]]
 
−
<br>
 
 
<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.
 
  
 
|style="width:5%"|
 
|style="width:5%"|
Line 26: Line 26:
 
:* [[Widgets]]
 
:* [[Widgets]]
 
:* [[Reports]]
 
:* [[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.
−
=== Output ===
+
<br>
 
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:
 
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.
+
[[File:measures1.png |thumb|link=https://wiki.hornbill.com/images/e/ed/Measures1.png|Sample measures showing targets and trends over time]]
−
* Sparklines. This is a count of the data that the measure has recorded per period shown in a chart format
+
:* '''Scorecards'''
−
* Actual vs Target. This is a count of the data recorded vs the target count of the measure per period.
+
:: This is a count of the data that the measure has recorded per period.
−
 
+
:* '''Sparklines'''
−
==Features==
+
:: This is a count of the data that the measure has recorded per period shown in a chart format
−
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1200px">
+
:* '''Actual vs Target'''
−
====Basic Information====
+
:: This is a count of the data recorded vs the target count of the measure per period.
−
<div class="mw-collapsible-content">
 
−
:*Title - The title is visible from withing the list of defined measures.  It is also used when creating a widget based on a measure.
 
−
:*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.
 
−
:*Status - A "running" measure is currently active and sampling data based on the frequency.
 
 
<br>
 
<br>
 
<br>
 
<br>
−
[[File:newMeasure.png |1200px|Creating a new measure]]
+
==Features==
 +
===Basic Information===
 +
[[File:newMeasure.png |thumb|right|link=https://wiki.hornbill.com/images/1/16/NewMeasure.png|Creating a new measure]]
 +
:* '''Title'''
 +
:: The title is visible from within the list of defined measures.  It is also used when creating a widget based on a measure.
 +
:* '''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.
 +
:* '''Status'''
 +
:: A "running" measure is currently active and sampling data based on the frequency.
 
<br>
 
<br>
 +
 +
===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>
−
</div>
 
−
</div>
 
−
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1200px">
 
−
====Measure====
 
−
<div class="mw-collapsible-content">
 
−
:*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 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>
 +
 +
===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>
−
[[File:measures2.png |1200px|Measure Details]]
+
{{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>
 
<br>
 
<br>
−
</div>
+
 
−
</div>
+
===Data Source===
−
<div class="mw-collapsible mw-collapsed" data-collapsetext="Show Less" data-expandtext="Read More" style="width:1200px">
+
[[File:measures4.png |thumb|link=https://wiki.hornbill.com/images/d/dc/Measures4.png|Data Source Details]]
−
====Targets & Goals====
+
:* '''Table'''
−
<div class="mw-collapsible-content">
+
:: This is the primary table from which the measure will collect its data.
−
:* Target Threshold. This is the count that needs to be achieved in order to meet the measure's target.
+
:* '''Key Column'''
−
:* Warning Threshold. This is the count between the target and the breach thresholds.
+
:: This is the primary key of the named table.  Being the primary key, this provides a unique identifier for each record
−
:* Breach Threshold. This is the count that needs to be achieved in order for the measure to breach its target.
+
:* '''Additional Tables'''
−
<br>
+
:: This is where you would specify any additional tables from which the measure will collect its data.
−
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.
+
:* '''Date Ranging Column'''
−
<br>
+
:: 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.  
−
<br>
+
:* '''Date Ranging Column 2'''
−
[[File:measures3.png |1200px|Measure Thresholds]]
+
:: 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>
 
−
<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>
 
−
[[File:measures4.png |1200px|Data Source Details]]
 
−
<br>
 
−
<br>
 
−
</div>
 
−
</div>
 
−
 
−
====Examples====
 
  
−
In this section we will include examples of the different types of Measure which can be defined
+
==Examples==
  
−
:* Count - Incidents Logged Per Month {{#ev:youtube|t7LRw7XO834|400|left}}
+
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}}
  
−
[[Category:Administration]][[Category:Videos]]
+
-->
 +
[[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"