HierarchyUpdateDirect

HierarchyUpdateDirect performs a full rewrite of a hierarchy that has been subject to direct editing in a TurboIntegrator process, essentially compacting the memory footprint of the hierarchy.

A dimension that undergoes a series of direct-only edits (element deletions, in particular) will eventually use more memory than its fully-rewritten counterpart would. This function can optionally be used after directly editing a dimension with HierarchyElementInsertDirect, HierarchyElementDeleteDirect, HierarchyElementComponentAddDirect, HierarchyElementComponentDeleteDirect, and/or HierarchyTopElementInsertDirect. Calling HierarchyUpdateDirect incurs an initial full-copy memory cost, however it can be used to guarantee that the dimension is at its smallest possible memory footprint after processing is complete.

This function is valid in TM1® TurboIntegrator processes only.

HierarchyUpdateDirect(DimName, HierName);

HierarchyUpdateDirect('Region', 'Western');