SetCube

Syntax

SetCubeResult SetCube(CubeId tCube, SetCubeArg tArg)

Parameters

tCube. Opened cube instance moniker.

tArg. Parameters for changing metadata.

Description

The SetCube operation changes cube metadata.

Comments

This operation enables the user to change the following cube structure settings:

Set of dimensions.
Display versions.
Controlling dimension parameters.
Source cubes and dimension fixation parameters on working with cube view.
Aggregation by cube dimension.

To execute the operation, in the tCube parameter specify the opened cube instance moniker and in the tArg parameter specify parameters, according to which the changes must be made. The moniker can be obtained on executing the OpenCube operation. The cube must be opened for edit. In the tArg.pattern field specify the pattern to change cube structure, and in the tArg.meta field specify updated metadata.

The operation results in the changed cube moniker and requested metadata that can be specified in the tArg.metaGet pattern.

To save the changes, execute the SaveObject or SaveObjectAs operation after the SetCube operation.

NOTE. Foresight Analytics Platform enables the user to change only standard cube structure.

Example

Various methods of using this operation are given in the following examples:

Example name

Adding a dimension to cube structure

Setting up cube aggregation

Changing calculated cube structure