PublishSubset

PublishSubset publishes a named private subset on the server. This function was introduced in Planning Analytics 2.0.9.10/TM1 Server 11.8.9 and cannot be used in previous versions.

This function is valid in TM1 TurboIntegrator processes only.

Syntax

PublishSubset(DimName, SubName, OverwriteExistingSubset);
Table 1. PublishSubset arguments

Argument

Description

DimName

The parent dimension of the private subset you want to publish.

SubName

The name of the private subset to be published.

OverwriteExistingSubset

This Boolean argument (1 or 0) determines if any existing identically named public subset are overwritten when the private subset is published.

If OverwriteExistingSubset is true (1) , any existing identically named public subset is overwritten when the private subset is published.

If this argument is false (0), the public subset is not overwritten, the private subset is not published, and an error is written to the TurboIntegrator log file.

Example

PublishSubset('Region', 'Northern Europe', 1);

This example publishes the private Northern Europe subset of the Region dimension. If a public subset named Northern Europe already exists for the Region dimension, the public subset is overwritten then the private subset is published.