- 5 Minutes to read
- Print
- DarkLight
- PDF
Using SpotlightXL-Model Administration Subtask
- 5 Minutes to read
- Print
- DarkLight
- PDF
Validation
The Model Validation report validates selected source and target models and provides information on invalid objects as well as member formulas. This is useful for models that are sourced from Planful Structured Planning, Consolidation, or Reporting applications that may have changes that impact a Dynamic Planning model. An example of this might be a change to rollup members in a hierarchy or deletion of an object in SpotlightXL such as a substitution variable used in reports. User can run this report for any model type (for example Master or Analytic).
The objects that are validated in the model are maps, formulas, views, reports, and lookups.
To run the Model Validation report, select the Model task and the Model Administration - Validation subtask. Then, select the model for which user want to run the report. If no data is displayed, the Model is valid and requires no modifications. An example report is shown below.
Fields displayed are based on the individual model. In the report below, there are several invalid or missing lookup objects for the Account Lookup. User can access the Lookup page by selecting Model task and the Lookup subtask and then selecting Account Lookup. Modify the source or target lookup information. Save and rerun the Model Validation report.
In some cases, member values are recommended if a close relationship exists in the name.
Validation Report for Duplicate Members
Once users have downloaded Metadata from Structured Planning, Consolidation, and Reporting applications, they should look to see how Dynamic Planning will handle duplicate member names. The Structured Planning, Consolidation, and Reporting applications allows the use of a Member Code within one hierarchy and the same Member Code within another hierarchy. For example, Member Code “Project Manager” could be used within a Company hierarchy of “IT” and also under a Company hierarchy of “R&D.”
Dynamic Planning requires that all the member codes be unique.
When it encounters duplicate member codes, it renames one by concatenating Member Code and Member ID with an underscore between them. See New Member Code below.
Power or Contributor user access is required for these steps.
Model > Model Administration > Validation
Navigate to Model > Model Administration > Validation. In the example below, HACPM_Financial is selected from the Model list box. The report runs. See example below. The status shows Failed if Dynamic Planning had to modify any member names due to duplication.
If the user does not like the New Member Code, there is no way to change it in Dynamic Planning. They need to change the segments in Structured Planning, Consolidation, and Reporting applications to avoid the duplication.
Duplicate Members Report
This report displays duplicate dimension members sourced from the Structured Planning, Consolidation, or Reporting applications. Access the Validation report by selecting the Model task and the Model Administration – Validation subtask. For Model, select HACPM_Financial.
Duplicate members are appended with the Member ID. To eliminate duplicate members, update the member codes in Structured Planning, Consolidation, or Reporting applications and then perform a model refresh.
Provides information on each formula downloaded from Planful Structured Planning, Consolidation, or Reporting applications to Dynamic Planning. Formulas that could not be converted to Dynamic Planning are identified so that they can be manually converted and applied.
The section below describes the spreadsheet fields on the Member Formulas subtask.
Fields and Descriptions
Dimension
The dimension where the formula is applied.
Member
The dimension member the formula is applied to.
Formula
The formula syntax.
Translation Status
Provides information on whether the formula was successfully translated from Planful Structured Planning, Consolidation, or Reporting applications to SpotlightXL.
- Cross-Dimensional: The formula contains more than one dimension. Multiple dimension formulas are not supported.
- Invalid Formula: The formula is invalid.
- If blank, the formula was translated successfully.
Lookup
With Lookups user can customize data labels for display within a model or report. Lookups are applied when added to a map and that map is executed. The lookup replaces the original (such as source) code values for a dimension with the updated (such as target) values. User must select Metadata or Both for Map "Type" when the model is created to use Lookup functionality because it only applies to metadata.
Once user creates a model and apply lookups to that model map they cannot update the lookups. If user generate a model that has an updated lookup table, the model will be unusable and they have to rebuild it. User can incrementally add new lookup members (such as new accounts, products, companies) to a lookup if they are refreshed from the Planful Structured Planning, Consolidation, or Reporting application.
Actions Available
A description of the actions available for the Lookup subtask is provided below. Access the Lookup subtask by navigating to Model > Model Administration > Lookup.
Refresh - After a selection is made, click Refresh to view updated data.
Save - Save a defined lookup.
Delete - Delete a selected lookup.
Spreadsheet Fields
The spreadsheet fields on the Lookup page are described below.
Name - Enter a lookup name or select an existing lookup.
Source - The member name in Dimension setup. See the Create a Lookup example below for more detailed information.
Target - The name of the dimension member that will be displayed in Dynamic Planning.
How to Create a Lookup?
- In SpotlightXL, select the Model task and the Model Administration > Lookup subtask.
- Select New Lookup from the list box to create a new lookup.
- The Source represents the member name in Dimension setup.
- The Target represents the name of the dimension member that user want to display in Dynamic Planning. Instead of selecting an already defined lookup, select New Lookup from the Name list box.
- Enter a name for the lookup.
- Copy and paste values into the spreadsheet or enter Source and Target labels.
- Click Save.
Create a Reverse Lookup
Reverse Lookups facilitate writing data back from the Dynamic Planning application to the Structured Planning, Consolidation, or Reporting applications when lookups have been applied to a model.
Reverse Lookups are the inverse of the original Lookup created. For example, Account Lookup has Source (Code from the Structured Planning, Consolidation, or Reporting application) to Target (Name from the Structured Planning, Consolidation, or Reporting applications), which updates all dimension values to Name for presentation in Dynamic Planning. Reverse Account Lookup will have the inverse. It will include Source (Name from the Structured Planning, Consolidation, or Reporting applications) to Target (Code from the Structured Planning, Consolidation, or Reporting applications).
How to Create a Reverse Lookup?
- In SpotlightXL, go to Model task and the Model Administration > Lookup subtask.
- Apply the lookup to the Writeback Map. For example, the map might have Source Model as FinanceMaster and Target Model as HACPM_Financial (the proxy for Planful Structured Planning, Consolidation, or Reporting applications).
- Apply the Reverse Lookup to the newly created map ensuring Writeback ID is created (same name as the Data Load Rule created for Writeback in the Structured Planning, Consolidation, or Reporting application).
- Execute the map.