Import Distribution

Imports a distribution from a text file. The text file is loaded from the server.

Permissions

Command Kind	Needed User Kind
Write	All

Parameters

Name	Type	Description	Required	Default	Values
Dimension	string	Name of the dimension ([Dimension]).	yes
Distribution	string	Name of the distribution ([Distribution]). A distribution contains items of a dimension. Each item has a factor. The factor is used to distribute values over the items.	yes
File	string	Name/path of the import file. The file is imported on the server.	yes
Item	string	Name of the dimension item ([Item]).	yes
Adjust	boolean	If 'True' protected command chars are replaced: '[' becomes '(', ']' becomes ')' and '=' becomes empty. The default value is 'True'.	no	true
Attribute	string	Column of the attributes ([Column1]). The format is [Attribute].[Value], e.g. [Size].[L],[Color].[Blue]	no
Caption1	string	Column of caption 1 ([Column1]).	no
Caption2	string	Column of caption 2 ([Column1]).	no
Caption3	string	Column of caption 3 ([Column1]).	no
Caption4	string	Column of caption 4 ([Column1]).	no
Caption5	string	Column of caption 5 ([Column1]).	no
Caption6	string	Column of caption 6 ([Column1]).	no
Caption7	string	Column of caption 7 ([Column1]).	no
Caption8	string	Column of caption 8 ([Column1]).	no
Caption9	string	Column of caption 9 ([Column1]).	no
Caption10	string	Column of caption 10 ([Column1]).	no
Coding	string	Coding of the file: Automatic (checks the file), Ansi, Ascii, BigEndianUnicode, Unicode (Utf16/Utf-16), Utf7 (Utf-7) or Utf8 (Utf-8). The default value is Automatic	no	Automatic	Automatic, Ansi, Ascii, BigEndianUnicode, Unicode, Utf7, Utf8
Contains	string	If not empty, only rows containing this value are imported.	no
CreateItems	boolean	If 'True' non existing items will be created. The default value is 'False'.	no	false
DateOffset	integer	Moves 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'.	no	0
DecimalSeparator	string	Decimal separator (long and short): Comma (,) or Point (.). The default value is Point (.)	no	Point	Comma, Point
EditItems	boolean	The import can include captions and attributes. If 'True', the captions and attributes are used to change the dimension items. The default value is 'False'.	no	false
Factor	string	Column of the factor ([Column1]).	no
FieldSeparator	string	Field separator (long and short): Circumflex (^), Comma (,), Semicolon (😉, Tabulator (Tab) or Pipe (|).	no	Tabulator	Circumflex, Comma, Semicolon, Tabulator, Pipe
Headers	integer	Number of header lines. These are skipped at the import. The default value is '0'.	no	0
IgnoreErrors	boolean	If 'True' errors are ignored. If 'False' the command is stopped and an error message is displayed. The default value is 'False'.	no	false
MaxRecords	integer	Max number of records to be imported. The default value is '0', which means all records are imported.	no	0
Quoted	boolean	If 'True' the text fields are quoted ("Text"). The default value is 'False'.	no	false
Skip	string	If not empty, rows containing the specified value are skipped.	no
ThousandSeparator	string	Thousand separator (long and short): None, Apostrophe ('), Comma (,), Point (.) or Space (_).	no

Result

No fields

Code

IMPORT DISTRIBUTION
DIMENSION=[string, Needed]
DISTRIBUTION=[string, Needed]
FILE=[string, Needed]
ITEM=[string, Needed]
ADJUST=[boolean, default=true]
ATTRIBUTE=[string]
CAPTION1=[string]
CAPTION2=[string]
CAPTION3=[string]
CAPTION4=[string]
CAPTION5=[string]
CAPTION6=[string]
CAPTION7=[string]
CAPTION8=[string]
CAPTION9=[string]
CAPTION10=[string]
CODING=[string, default=Automatic, values=[Automatic,Ansi,Ascii,BigEndianUnicode,Unicode,Utf7,Utf8]]
CONTAINS=[string]
CREATEITEMS=[boolean, default=false]
DATEOFFSET=[integer, default=0]
DECIMALSEPARATOR=[string, default=Point, values=[Comma,Point]]
EDITITEMS=[boolean, default=false]
FACTOR=[string]
FIELDSEPARATOR=[string, default=Tabulator, values=[Circumflex,Comma,Semicolon,Tabulator,Pipe]]
HEADERS=[integer, default=0]
IGNOREERRORS=[boolean, default=false]
MAXRECORDS=[integer, default=0]
QUOTED=[boolean, default=false]
SKIP=[string]
THOUSANDSEPARATOR=[string]