This documentation is archived and is not being maintained.

InScope Function (Reporting Services)

Updated: 15 September 2007

Indicates whether the current instance of an item is within the specified scope.


InScope(Scope)

Scope

(String) The name of a dataset, grouping, or data region that contains the report items to which to apply the function.

Returns a Boolean.

The InScope function is useful in data regions that have dynamic scoping, such as a matrix. For example, InScope can be used in a drillthrough link in a matrix cell to provide a different report name and different sets of parameters depending on which cell is clicked. An example of this is as follows:

  • This expression, used as the report name in a drillthrough link, opens the ProductDetail report if the clicked cell is in the Month grouping, and the ProductSummary report if it is not.
    =Iif(InScope("Month"), "ProductDetail", "ProductSummary")
    
  • This expression, used in the Omit property of a drillthrough report parameter, will pass the parameter to the target report only if the clicked cell is in the Product grouping.
    =Not(InScope("Product"))
    

Scope cannot be an expression.

The following code example indicates whether the current instance of the item is within the Product dataset, data region, or grouping.

InScope("Product")
Show: