Skip to content

Change Records

Changes the dimension items of records.

Permissions

Command KindNeeded User Kind
WriteAll

Parameters

NameTypeDescriptionRequiredDefaultValues
Changearray of stringA specified dimension item can be changed ([Dimension].[Old Item].[New Item]) or all items of a dimension can be changed ([Dimension].[New Item])yes
TablestringName of the table ([Table]).yes
AddbooleanIf 'True', the new value is added to an existing one. If 'False', the new value overwrites an existing one. The default value is 'False'.nofalse
DateOffsetintegerMoves the date dimension items by the offset. The default value is '0'. For example the month '2022-02' with an offset of 5 becomes '2022-07'.no0
Factorarray of stringA number value is changed via a factor ([NumberField].[Factor]). For example a factor of 1.25 adds 25% to the value.no
Filterarray of stringFilters by dimension item ([Dimension].[Item]) or tree sum ([Dimension].[Tree].[Sum]). The tree sum format is equal to 'FilterTree'.no
FilterAttributearray of stringFilters by attribute ([Dimension].[Attribute].[Value]).no
FilterFieldarray of stringFilters by field ([Field].[Operator].[Value]). The operators are (long and short): Contains (CO), Ends (EN), Equal (EQ), Greater (GR), GreaterEqual (GE), Less (LS), LessEqual (LE), NotContains (NC), Starts (ST) and Unequal/NotEqual (UE/NE)no
FilterRangearray of stringFilters by an item range ([Dimension].[StartItem].[EndItem]).no
FilterTreearray of stringFilters by tree sum ([Dimension].[Tree].[Sum]).no
Percentarray of stringA number value is changed via a percent ([NumberField].[Factor]). For example a percent of 125 adds 25% to the value.no
SubtablestringName of the subtable ([Subtable]). A subtable contains additional filters used by the table.no
Valuearray of stringSets the value of a number field ([Field Name].[123.45]) or text field ([Field Name].[Text]).no

Result

No fields

Code

text
CHANGE RECORDS
CHANGE=[string, Multiple, Needed]
TABLE=[string, Needed]
ADD=[boolean, default=false]
DATEOFFSET=[integer, default=0]
FACTOR=[string, Multiple]
FILTER=[string, Multiple]
FILTERATTRIBUTE=[string, Multiple]
FILTERFIELD=[string, Multiple]
FILTERRANGE=[string, Multiple]
FILTERTREE=[string, Multiple]
PERCENT=[string, Multiple]
SUBTABLE=[string]
VALUE=[string, Multiple]