1.8.2 Modeling Release Notes, October

This document describes all the new features and enhancements with this release of Spotlight/SpotlightXL, as well as any known or resolved issues.

New Features and Enhancements

Dimension-Based Lock Report Lock Property at Application Level

Application level dimension based locking was released for Views. This release, admin users can also lock dimension members for reports at the application level.

To enable locked dimension members in reports at the application level:

1. Select the Manage task and the Application Administration, Application Settings subtask.

2. Under the Reports Property called Dimension Based 'Locked', select Application Level (shown below).

Selecting Application Level applies dimension based locking to all Reports and related Models in the Modeling application.

See Also: How to Lock Dimension Members

See Also: Application Level Dimension Based Locking

For Dimension based Locked property, select from the following 2 values:

• Application Level – Globally lock dimension members for all reports at the application level.

• None – Lock at the individual cell level within Report Design using Format Manager as shown below.

Additional Functionality for Locking Data

With this release, you can lock a model to prevent modification or clearing. Analytic and Master models only can be locked. Models must be in a Generated state to be locked. Not Generated models can’t be locked.

To lock a model:

1. Access the Model task and the Setup subtask.

2. Select a Generated model.

3. Click the Lock Model action (which is only enabled when a Generated model is selected). Notice the Status of the model changes from Generated to Locked as shown below. Also notice that the Lock Model icon changes to Unlock Model.

While locking a model ensures data integrity and prevents clearing the data, it also means that all data may not be saved/updated (see Saving Report Data to Locked Models and Saving View Data to Locked Models) from Views, Reports, Data Load, API Library, Calculation, and so on.

See: Saving Report Data to Locked Models and Saving View Data to Locked Models

Saving Report Data to Locked Models

• If a report is associated with a locked model and the Enable Save property is set to All Models as shown below, users cannot save data from that report.

• If a report is associated with multiple models, one of the models is locked, and Enable Save is set to All Models, users cannot save data from that report.

• If a report is associated with a model that is locked, Enable Save is set to Calculation Model and Calculation on Save is based on the model that is locked as shown below, users cannot save data from that report.

• If a report is associated with multiple models (some that are) locked, Enable Save is set to Calculation Model, and Calculation on Save is not based on the model that is locked, users can save data from that report to the models that are not locked.

Saving View Data to Locked Models

• If Enable Save is set to Yes in a View on a model that is locked as shown below, users cannot save data from that view.

Functionality that can be used on locked models includes:

• Append

• Set Display Label

• Set Dimension Based Properties

• Attribute

• Set Attribute Mapping

To unlock a model:

1. Access the Model task and the Setup subtask.

2. Select a Locked model.

3. Click the Unlock Model action.

Locking and Unlocking Models Using a Calculation

Another way to lock or unlock a model is to select the LockModel or UnlockModel type as a line item in a Calculation. Performing the lock or unlock in a calculation saves time as it automates the process. For example, you might want to unlock a locked model, generate a formula, run aggregation, and then lock the model once again. If this is the case, your Calculation might look like the following:

To lock/unlock a model using a Calculation:

1. Access the Model task and the Calculation subtask.

2. Select the model you want to lock or unlock.

3. In the Type list-box select the LockModel or UnlockModel type as shown below.

Appending Metadata

We’ve added a new type to Calculation called AppendMetadata, which allows you to add new members to an existing dimension. Until this release, appending metadata was only available from the user interface (Model, Dimension, Append actions).

Appending metadata differs from a full or partial Model Refresh. For example, let’s say you are loading data from Host Analytics Core and you want to refresh that data on a monthly basis. There is no need to clear and recreate the entire model, which is what a full refresh would do. If you perform a partial refresh, only the mapping of type Data is performed meaning that new a dimension member (like a new Department) is not mapped so the Calculation will fail due to the new member.

This feature also differs from the Append action you can select for a dimension because selecting Append allows you to enter new dimension members directly into Modeling, but does not load them from another source like Host Analytics core.

To use the Append Metadata type in a Calculation:

1. Access the Model task and the Calculation subtask.

2. Select the model in which you want to append metadata.

3. Under Type, select AppendMetadata as shown below.

An example of typical full refresh Calculation steps are shown below. Notice the full refresh clears the model and generates it again while the partial refresh appends the metadata.

An example of typical partial refresh Calculation steps are shown below.

Modification of Dimension Type

Key and Analytic dimension types can now be modified. For example, if you originally assigned a Project dimension as a Key dimension, you can now change it to a Value type dimension. Similarly, if you assign a Project dimension as a Value type, you can now change it to Key.

To change a dimension from a Key to a Value or vice versa follow the steps below.

1. Access the Model Setup page.

2. Select the Model and click the Modify Model action.

3. Select the dimension you want to modify and click Modify as shown below.

4. On the Modify Dimension dialog page, select the new Type from the list-box as shown below.

5. Click OK and Close the dimension dialog page.

Other Enhancements

• Query optimization in Views if ‘Suppress Blank Rows’ property is set to ‘Yes’. With this release we have optimized the query processing. This will be helpful for users with multiple dimensions on rows where all of them are of type ‘Key’ zooming to the leaf level.

• Set View Properties has been renamed to Set Dimension Based Properties on the Model Dimension page in the Action list-box shown below.

• Calculation Script and Calculation Process has been renamed to Calculation.

• Drill Through report displayed the dimension member codes. With this release it will display either code or display label based on the display property of the view / report. Also, the display label will be based on the source model (i.e. HACPM) model. In the image below, Display Label is selected for Display on the Report Properties page so Display Label is displayed when Drill Through is performed on that same report.

• _Attribute_Default is the default member that will be added to the attribute. If a leaf dimension member is not mapped to any attribute members then all those leaf dimension members will be mapped to this default member.

• The Attributes check box (shown below) in the Design Manager will not remove the attribute member mappings. Checking this will show the attributes that are available in the selected model and unchecking this will hide the attributes from the Design Manager.

Known and Resolved Issues

Known Issues

Resolved Issues