In this section: |
The following appendix contains information for working with legacy Measures in PMF.
Note: Legacy measures will be deprecated in a future release.
|
|
How to: |
Reference: |
The following is an overview of the steps involved in designing a simple measure load.
For detailed information, see How to Design a Simple Measure Load.
|
|
Note: This will be deprecated in a future release.
The Edit Measure panel controls the measure series, each of which is a distinct measure, and its connected rows of values, which you can optionally link to an objective. The Edit Measure panel is accessible from the Manage page. To access data in the Edit Measure panel, perform the following steps.
Note: To create a new measure, New.
|
|
Note: This will be deprecated in a future release.
The following table lists and describes the fields and buttons in the Edit Measure panel.
Field |
Description |
---|---|
Measure Name |
The measure you are editing. |
Units |
The unit of measure used for this measure. |
Link/Unlink Objectives... (button) |
Displays the Link Measures to Objectives panel, which enables you to link the measure to additional scorecards and objectives. For details on this panel, see How to Link or Unlink Measures. |
Measure Type |
Type of production measure.
|
Aggregation Method |
Method you can use when aggregating this measure. Choose from Additive, Percentage, Change in Percentage, or Ratio. |
Threshold/Flex Type |
The type of value used in the Threshold/Flex fields:
|
Threshold/Flex Direction |
Direction to be used to determine how thresholding is performed.
For more information about these options, see Indicator Concepts. |
Threshold/Flex |
In the first field, the value used for the threshold, which determines the outer range when an indicator shows red. In the second field, the value used to determine the inner edge of the yellow zone. Setting a flex of 0 indicates that the measure does not allow any deviation from the target. |
Threshold/Flex Slider |
Displays a grid that enables you to graphically adjust the threshold and flex values. |
Target |
Select the type of target you desire.
When you select Use fixed value or Aggregate fixed value, the Set Fixed Target Values button appears, which opens the Fixed Target pop-up dialog box where you can select the desired target types and enter a target value for each. |
Owner Id |
The owner ID currently assigned to the measure. You can select another owner to reassign the measure to that owner ID. |
Audit Measures
(check box) |
Select this check box to archive any changes made to the measure in the PMF measures history table, used for reporting purposes. |
Access Security
(check box) |
When this check box is selected, data is filtered using access security at the user's security level. |
Display Format |
A WebFOCUS numeric display format valid for the unit of measure. Valid format types are D (floating-point double-precision), F (floating-point single-precision), I (integer), and P (packed decimal). The formats are In, Dn.o, Fn.o, and Pn.d, where n represents the maximum number of digits to display, and .o, which is optional, and .d, which is required, represent the decimal point and the number of digits to display after the decimal point. The maximum number you can code before and after the decimal point is 10 for I, 15 for D, 7 for F, and 31 for P. For more information about numeric display options, see the Describing Data With WebFOCUS Language manual. |
Description |
Intuitive description of the data loaded into this measure. |
Measure Report |
From the drop-down menu, select an operational or PMF measure view to which users can automatically drill down. |
Measure Formula |
You can add a text description of the calculation method and source fields that you will use in the load procedure for this measure here. Reports use this field to prompt for actual values displayed for a measure. This field is useful to explain to constituents how a measure was calculated. |
|
|
Note: This will be deprecated in a future release.
The next pane shows the current threshold and flex values, and the percentage of the target value reached based on the most current data.
For the ascending measure shown in the following image, to set the threshold value to 15%, drag the Threshold flag to 85% on the percent ruler, stop when the Threshold flag displays 15%, and click the mouse to anchor the flag. A Flex value is set the same way. An example is shown in the following image.
The values displayed on the percent ruler are useful when setting threshold and flex values. For ascending measures, the percent values increase from left to right towards the target. For descending measures, the percent values increase from right to left towards the target. For range measures, the percent values increase towards the target and decrease in either direction away from the target.
|
|
Note: This will be deprecated in a future release.
The Configure Predictive Data panel opens, as shown in the following image, for the Sales measure series.
The Configure Predictive Data window opens displaying a time sampling graph and a selectable list of the top 50 predictive methods.
You can scroll and select any of the other predictive methods listed in the Accuracy Method columns to display the results of that method in the time sampling graph on the panel. Compare results until you are satisfied with the selected method.
|
|
Note: This will be deprecated in a future release.
Note: If your procedures and metadata are not located in the Mainstreet application, make sure that you have added the WebFOCUS application containing them to the WebFOCUS Reporting Server APP PATH setting before you attempt a load operation. You can do this using the Web Console.
If you do not see the measure you need, you may need to define it in the Edit Measures panel. The properties displayed in all of the read-only fields in this panel can also be changed in the Edit Measures panel. For more detailed information, see How to Access and Save Measure Metadata.
The Edit Measure panel opens.
The Edit Measure Loader opens to the Dimensions view, showing the fields and options available from the Dimensions tab.
Note: The Edit Measure Loader automatically loads and displays the levels defined for the metadata and checks the measure to make sure it is correctly set up. If anything is wrong, the Load status list displays the error.
For more information about the available fields and options, see Manage Tab - Measure Loader Fields (Dimensions View), and Manage Tab - Measure Loader Fields (All Views).
Field maps determine how data from the external table is mapped into the PMF field. The target is the goal amount for the metric. Actual is the value to be evaluated against the target. You can specify a single field in the drop-down menu or type a calculation (using standard WebFOCUS formula syntax) that controls how fields from the source are processed.
For more information, see Manage Tab - Measure Loader Fields (Field Maps View), and Manage Page - Measure Loader Fields (All Views).
Filters limit the rows of data to be retrieved during the load. Filters are saved and become part of the load logic.
For more information, see Manage Tab - Measure Loader Fields (Filters View), and Manage Tab - Measure Loader Fields (All Views).
|
|
Note: This will be deprecated in a future release.
The following table lists and describes the fields available for all views in the Measure Loader (Dimensions tab, Field Maps tab, and Filters tab).
Fields |
Description |
---|---|
Load |
Select one of the following options from the drop-down menu:
|
On Error |
Select one of the following options from the drop-down menu:
|
Source Table |
Allows you to select a source table or Master File for the dimension, or you can use this to select sample data you want to view. |
Limit display |
Type in a number of records. This does not affect loading, only the display of sample data. It improves performance of the Load Wizard. You can leave it at the default (100 records) unless you need to see a deeper data range. |
|
|
Note: This will be deprecated in a future release.
The following table lists and describes fields that are specific to the Dimensions view in the Measure Loader.
Field |
Description |
---|---|
Case sensitive compare |
This option is checked, by default. When this option is checked, if there is a mismatch on the dimensionality, it will be flagged as an error in the Measure Loader report. When this option is not checked, PMF uppercases everything before comparing the dimensionality. |
Dimension |
Lists the type of dimension. |
Aggregation at Level |
Lets you select the appropriate level of aggregation for the associated dimension. |
Join from Key Field |
Joins a key field from the measures source table with the associated dimension source table. If there is a field in the measures source table with the same name as the key field in the dimension source table, PMF automatically selects that field as the Join from Key Field. If this is not the correct join field, use this Join from Key Field drop-down menu to select another field. This option is only available if the Separate table option is selected from the Table Type drop-down menu in the Dimension Loader. |
|
|
Note: This will be deprecated in a future release.
The following table lists and describes the fields in the Field Maps view in the Measure Loader.
Field |
Description |
---|---|
Define Procedure |
Available only if Custom coding is selected as the Source Type. Select a procedure from the drop-down menu. This is the procedure that contains the defined fields you can use when you load the measure from the source data. The define procedure contains fields mapped to the ACTUAL, TARGET, and THRESHOLD series fields, as well as any component fields used in calculating these values, and any JOINs necessary to perform the calculations. |
Date Mapping |
If Field Mapping is selected as the Source Type, select one of the following Time dimensions from the drop-down menu:
|
Measure Field Name |
If Field Mapping is selected as the Source Type, the following data metrics are displayed:
If Measure Dt determines Time Dim is selected as the Date Mapping option, the following date metric is also displayed:
If you selected any of the discrete date options beginning with Time Dim, the following date metrics are displayed instead of MEASURE_DATE:
|
Source |
Select one of the following from the drop-down menu:
|
Field/Field Mapping Code |
Allows you to do one of the following:
|
|
|
Note: This will be deprecated in a future release.
The following table lists and describes the fields and option buttons in the Filters view in the Measure Loader.
Field |
Description |
---|---|
Add Filter Below |
This button adds an additional filter level field below the filter currently selected with the option button to the left of the Filter Name. |
Add Filter Above |
This button adds an additional filter level field above the filter currently selected with the option button to the left of the Filter Name. |
Drop Filter |
This button deletes the filter level field currently selected with the option button to the left of the Filter Name. |
Move Level Up |
This button moves the filter level field currently selected up one level. Use the option button to the left of the Filter Name to select a filter to move. |
Move Level Down |
This button moves the filter level field currently selected down one level. Use the option button to the left of the Filter Name to select a filter to move. |
Filter Name |
Name for the filter. You can type a maximum of 50 characters. |
Source |
Select one of the following from the drop-down menu:
|
Field/Filter Code |
Enables you to do one of the following:
|
Operator |
Select one of the following comparisons from the drop-down menu:
|
Value |
Type a value in the field in single quotes (for example, '2001'). |
|
|
Note: This will be deprecated in a future release.
The following table lists and describes the option buttons available for all views in the Measure Loader (Dimensions tab, Field Maps tab, and Filters tab).
Options |
Description |
---|---|
Prefix Code |
This button opens a field box in which you can type FOCUS or SQL code that will run before the measure is loaded. Click OK to save the code or Cancel to close the field box without saving your changes. If the table you are using is DBA protected, you can type the command SET USER = user_DBA_ password before you select the source table. For example, the sample Century Corp data uses the password WEBFOCUS. |
Formula |
This button opens a field box in which you can enter a formula for the measure load. Click OK to save the formula or Cancel to close the field box without saving your changes. |
Preview |
This button runs and displays the Measure Loader report in the Data for tab of the Measure Loader. This report shows you how the load will be performed. For more information, see Interpreting the Measure Loader Report. |
Save |
This button saves metadata information for a measure. |
Load |
This button performs the measure load. Use this after you enter the appropriate information and make the proper selections in all of the required fields of the Dimensions, Field Maps, and Filters tabs. For more information, see Running a Measure Load. |
Schedule |
This button opens the measure load schedule panel, where you can schedule a one-time or recurring measure load. For more information, see Scheduling a Measure Load. |
Sample Data |
This button displays a report in a new browser window, showing sample data for the source table you selected in the Source Table drop-down menu. For more information, see Sample Data From Source Tables. |
|
|
Reference: |
Note: This feature is deprecated in PMF 8. Use captured sources instead.
User-entered measures enable users to manually input measures and their targets for any of the following reasons:
The benefits to creating user-entered measures include:
From the Author or Manage page, select the Measures panel button. To create a new user-entered measure, select New. To view or edit an existing user-entered measure, select the desired measure in the User Entered Measures folder of the tree structure. After measures are created, they are immediately available on all linked scorecards.
If data for a user-entered measure becomes available at a later date for loading from a data source, you can change the measure to be loaded from external data. You can also change a measure currently loaded from external data to a user-entered measure. To do either, edit the Measure Type field in the Edit Measure Metadata panel.
Users can enter data for a user-entered measure by selecting Measures to Input from the drop-down menu near the upper-right corner of the Today page. For more information, see Inputting User-Entered Measures.
|
|
Note: This will be deprecated in a future release.
If you create formulas for the actual and target values of user-entered measures, users are presented with a multi-cell calculation screen when entering measures. PMF displays the results of the calculation for user verification.
When creating formulas, all fields must be within square brackets. Supported operators are +, -, *, and /, and you can use parentheses to separate operations to create complex formulas. You must use a semi-colon to terminate a formula. The following is an example of a formula:
([Total Calls]-[Dropped Calls])/[Processed Calls]
You can specify which users have access to enter actuals or targets by setting access for their Functional Role from the Manage page. For more information, see How to Limit Roles to Entering Only Actual or Target Values.
|
|
Note: This will be deprecated in a future release.
When you are ready to load production measures from operational data, you can review and edit the properties for specific measures before loading. You may want to adjust the Threshold, Flex, Alert Threshold, and Alert Flex settings to ensure that they reflect the data you are about to load. If you have any user-entered measures that can now be loaded from a data source, you may want to convert these measures to loaded measures.
To review, modify, delete, and add new production measures, there are several different ways you can access measures in PMF. You can:
Selecting any of the individual measures opens the Edit Measure panel where you can view, edit, or delete measures.
The following table lists and describes the fields in the Edit Measure panel.
Field |
Description |
---|---|
Measure Name |
The measure you are editing. |
Units |
The unit of measure used for this measure. |
Link/Unlink Objectives... (button) |
Displays the Link Measures to Objectives panel, which enables you to link the measure to additional scorecards and objectives. For details on this panel, see How to Link or Unlink Measures. |
Dimensions |
The one-character dimension identifier or identifiers to which the measure is linked. For example, the value TOP means that the measure is linked to the Time, Organization, and Product dimensions. |
Measure Loader (button) |
Available only when the selected measure is a production measure. Displays the Measure Loader panel, which enables you to design and complete a measure load. |
Measure Type |
Type of production measure.
|
Aggregation Method |
Method you can use when aggregating this measure in views. |
Threshold/Flex Type |
The type of value used in the Threshold/Flex fields:
|
Threshold/Flex Direction |
Direction to be used to determine how thresholding is performed.
For more information about these options, see Indicator Concepts. |
Threshold/Flex |
In the first field, the value used for the threshold, which determines the outer range when an indicator shows red. In the second field, the value used to determine the inner edge of the yellow zone. Setting a flex of 0 indicates that the measure does not allow any deviation from the target. |
Threshold/Flex Slider |
Displays a grid that enables you to graphically adjust the threshold and flex values. |
Calculating % Reached |
Basis used for calculating the percent (%) reached for the descending measure.
|
Basis Value |
Sets a basis value for calculating Pct Reached. This is especially useful if you have a target at, or near to, zero. The Basis determines the amount above your target at which Pct Reached = 0%. This prevents very large negative Pct Reached values from being displayed. This option is only available for Descending Measures. |
Target |
Select the type of target you desire.
When you select Use fixed value or Aggregate fixed value, the Set Fixed Target Values button appears, which opens the Fixed Target pop-up dialog box where you can select the desired target types and enter a target value for each. |
Owner Id |
The owner ID currently assigned to the measure. You can select another owner to reassign the measure to that owner ID. |
Add Predictions... (button) |
Displays the Configure Predictive Data panel, which enables you to select options for predictive data analysis. |
Audit Measures
(check box) |
Select this check box to archive any changes made to the measure in the PMF measures history table, used for reporting purposes. |
Access Security
(check box) |
When this check box is selected, data is filtered using access security at the security level of the user. |
Display Format |
A WebFOCUS numeric display format valid for the unit of measure. Valid format types are D (floating-point double-precision), F (floating-point single-precision), I (integer), and P (packed decimal). The formats are In, Dn.o, Fn.o, and Pn.d, where n represents the maximum number of digits to display, and .o, which is optional, and .d, which is required, represent the decimal point and the number of digits to display after the decimal point. The maximum number you can code before and after the decimal point is 10 for I, 15 for D, 7 for F, and 31 for P. For more information about numeric display options, see the Describing Data With WebFOCUS Language manual. |
Description |
Intuitive description of the data loaded into this measure. |
Measure Report |
From the drop-down menu, select an operational or PMF measure view to which users can automatically drill down. |
Measure Formula |
You can add a text description of the calculation method and source fields that you will use in the load procedure for this measure here. Reports use this field to prompt for actual values displayed for a measure. This field is useful to explain to constituents how a measure was calculated. |
Time Summary |
Option to vary how measured data is aggregated over time. Select Standard to aggregate using standard Time rules. All of the measure data shown at higher time levels adds up to the total of all data at the lowest loaded level (for linear aggregation) and includes all percent or ratio data over the entire time period (for percent, ratio, and change in percent aggregation). This option is the default. Select Average to show an average value, which calculates a mean average of all the data loaded across the lower Time levels for the duration of the higher level period. Select Most Recent to show the latest values. Only the most recently loaded value of all the data loaded across the lower Time levels for the duration of the higher level period will be shown. Note: These options will only be available if the Alternate Time Summary setting in the Summarization settings is enabled. |
Loading measures tends to be an administrative function. For more information, see Performance Management Framework Administrator.
|
|
In PMF 5.3.1 and earlier, you scheduled loads for each dimension and each measure, which resulted in a lot of scheduling and coordination. You had to know the data sources for each individual measure and make sure the external data from which you were loading was ready at the time each measure was scheduled. This meant you had to keep track of all these external sources, and when they got refreshed, make sure your measures always had the most recent data.
As of PMF 5.3.2, you do not need to schedule measure loads if you are using the new measure data acquisition model. The model controls scheduling in a manner that is closer to the point from which data is harvested. Measures are linked from sources, to datapoints, through the recalculation model. PMF keeps track of when data is refreshed. Schedules are only created to specify the times at which your external sources are refreshed. PMF does the rest automatically.
Currently, both the old and new models are supported. As PMF 5.3.2 moves through its hotfix cycle, legacy measures will be converted to new measures. At that point, legacy schedules will no longer be appropriate, and will return an error and schedules will need to be recreated.
|
|
In this section: |
Note: This will be deprecated in a future release.
After you have designed, tuned, and saved your measure load, you can load the data by clicking the Load button in the Measure Loader. A message appears, informing you that the measure you loaded is completed (for example, Successfully loaded (“Sales”)).
|
|
How to: |
You can automatically run a saved measure load during specified time intervals using ReportCaster.
|
|
The New Schedule panel opens.
Note: The New Schedule panel generates Interval, Start Date, and Start Time values based on the values you specified for the load. You can edit these values as needed.
For information on editing a saved schedule, see Manage Tab - Schedules.
|
|
Note: This will be deprecated in a future release.
After you have designed the load for a measure (for example, Sales), click Preview to open the Data for: Sales window, in which you can preview the Measure Loader report.
Note: You must select a Filter field for the first filter level in order to activate this option.
The following image shows an example of a Measure Loader report.
The Measure Loader report displays the hierarchy of dimension values to be loaded. The report compares data to be loaded to what is already loaded so you can tune measure loads. The report shows you the changes you will make when you load the new data.
Minus (-) signs appear next to records to indicate that the records will be deleted. Plus (+) signs appear next to records to indicate that the records will be added. If a record does not have a plus or a minus sign, it means that the record already exists for the measure. You can sort on the signs so that the records appear in ascending or descending order.
After you are finished tuning the measure load and are satisfied that the data to be loaded is correct, click Save to save the metadata. You cannot perform a new measure load unless the metadata has been saved. However, you can load an existing measure load provided no changes have been made since the last time it was run. If changes are made, save the load and then run it.
|
|
Note: This will be deprecated in a future release.
If you create a moderately complex measure load, you must change data levels, transform the data, and calculate different sources.
|
|
Note: This will be deprecated in a future release.
When working with measures, you must determine whether to use standard aggregation or percent and ratio type measures. Standard aggregation consists of one field that holds a number.
|
|
How to: |
The measure data displayed in your PMF views can be “ghosted-in” to display values from a previously loaded period. This functionality enables you to carry previous data values forward into the current period until the actual current data is available. PMF marks the data with a special notation so users can distinguish between actual current data and data carried forward from a past load. This functionality is enabled globally by setting the Previous Period Forward setting to Y (Yes) in the Summarization panel on the Settings menu. To utilize previous period data in your views, you must select the Previous Period Moving Forward option for every measure for which you want to carry previous data values forward.
|
|
To select the Previous Period Moving Forward option for a measure, perform the following steps:
The Edit Measure panel opens.
After activating this functionality for a measure, PMF automatically creates the forward moving data for each actual and target every time you load the measure. The data will begin displaying in reports and views immediately after the next measure load for that measure.
|
WebFOCUS |