UnselectAllDimensions Method

Clears all selected Dimension objects in the dimension line that can be filtered when a report is opened in the IBM® Cognos® portal.

Syntax

DeploymentOptions.UnselectAllDimensions

Discussion

Use this property when a report author specifies that a report consumer can filter a report opened in the IBM Cognos portal. The user can filter unnecessary information so that only the required information appears in the report.

This method clears all selected Dimension objects in the dimension line for the DeploymentOptions object so that the user can use the PromptForDimension property to select specific dimensions or to remove filtering on all dimensions.

Return Type

Nothing

Example

This example clears all selected dimensions from the dimension line filter and then specifies the dimensions that a user can filter in a report.

Sub Main()

   Dim objPPRep as Object

   Dim objDeploymentOptions as Object

   Set objPPRep = GetObject(,"CognosPowerPlay.Report")

   Set objDeploymentOptions = objPPRep.DeploymentOptions

   objDeploymentOptions.PromptForCurrency = True

   objDeploymentOptions.PromptForLongShortNames = True

   objDeploymentOptions.PromptForZeroSuppression = True

   objDeploymentOptions.PromptForSwapRowsAndColumns =
True

   objDeploymentOptions.UnselectAllDimensions

   objDeploymentOptions.Dimension(1) = True

   objDeploymentOptions.Dimension(2) = True

   objPPRep.Save

   Set objDeploymentOptions = Nothing

   Set objPPRep = Nothing

End Sub