Remove Method

The Remove method removes a specific object from a collection.

Syntax

collection .Remove(Item)

Applies To

Associations Collection

CalculationDefinitions Collection

Categories Collection

CategorySets Collection

Columns Collection

CubeCustomViews Collection

Cubes Collection

CurrencyRates Collection

CurrencyRecords Collection

CurrencyTables Collection

CustomViews Collection

DataSources Collection

Dimensions Collection

DrillDowns Collection

DrillThroughTargets Collection

Filters Collection

Levels Collection

Measures Collection

Namespaces Collection

PackageDatasourceConnections Collection

Packages Collection

Prompts Collection

Queries Collection

Reports Collection

SecurityObjects Collection

Signons Collection

Views Collection

Discussion

Use the Item parameter of this method to select the specific object to remove from the collection. Use the Delete method to remove objects that exist outside of a collection, such as those selected with the Item method.

You cannot remove the default primary drill-down path created by Transformer for each dimension.

When removing associations, an update on the parent object is called, therefore, all changes made to the parent are saved.

A COM exception is thrown in error situations. The message that is passed with the exception varies depending on the error situation.

Parameter

Description

Item

Required. Specifies an object or position in the collection. The value can be a numeric index position (starting at 1), a string giving an object name, or an object defined in the script.

Type: Variant

Return Type

None

Examples

packages = model.Packages packages.Remove(temp_package)