Jedox / PALO OLAP Functions

48
Copyright © Jedox AG Jedox / PALO OLAP Functions Introduction Jedox Software includes standard worksheet functions, subset filter functions (labeled with 1) ), and array functions (labeled with 2) ). After the description of all PALO functions you can find a list of possible parameters and general information on subset filter functions and array functions. Description of PALO functions PALO.AFILTER() 1) This filter removes the elements that do not match defined attribute patterns. Argument Form Description Filt. definition Text Array Array containing the definition of the attribute patterns. Supported operators for numeric criteria are: <, >, =, <=, >=, <> Type Integer, TRUE, FALSE Defines the filter behavior. Possible values are: • 0, FALSE, or blank: Filter uses wildcard patterns for search, case sensitive. • 1 or TRUE: Filter uses PERL regular expressions, case sensitive. • 2: Filter uses PERL regular expressions, case insensitive. • 3: Filter uses wildcard patterns for search, case insensitive. Translat. array Array An array that contains true or false values. The attribute pattern passed as first argument is an array that contains information about the filter expressions to be applied for each attribute. It has to consist of at least two rows: the first row specifying

Transcript of Jedox / PALO OLAP Functions

Copyright © Jedox AG

Jedox / PALO OLAPFunctions

IntroductionJedox Software includes standard worksheet functions, subset filter

functions (labeled with 1)), and array functions (labeled with 2)). After

the description of all PALO functions you can find a list of possible

parameters and general information on subset filter functions and

array functions.

Description of PALO functions

PALO.AFILTER() 1)

This filter removes the elements that do not match defined attribute

patterns.

Argument Form Description

Filt. definition Text Array Array containing the definition of the attribute patterns. Supported operators for numeric criteria are: <, >, =, <=,

>=, <>

Type Integer, TRUE, FALSE Defines the filter behavior. Possible values are:

• 0, FALSE, or blank: Filter uses wildcard patterns for search, case sensitive.

• 1 or TRUE: Filter uses PERL regular expressions, case sensitive.

• 2: Filter uses PERL regular expressions, case insensitive.

• 3: Filter uses wildcard patterns for search, case insensitive.

Translat. array Array An array that contains true or false values.

The attribute pattern passed as first argument is an array that contains

information about the filter expressions to be applied for each

attribute. It has to consist of at least two rows: the first row specifying

Copyright © Jedox AG

at least one existing attribute, and the second row consisting of a

filtering expression for that attribute. Each column in the array

represents one attribute, plus filtering expressions. Expressions for

various attributes in one row are combined with the logical operator

AND.

You can include more than one row with filtering expressions in the

array. The filters are then combined using the logical (inclusive)

operator OR, meaning that elements matching either the expression

from the first, or (also) the second row will be included.

For example, the array below (two rows, two columns) defines a filter

on a dimension with attributes “Name” and (numeric) “Price”, and

includes all elements in the result where the Name includes the string

“Off-Road Bike” and the Price is greater than 500:

{"Name","Price";"Off-Road Bike",">500"}

Note: For formulas, you must use straight quotation marks.

A logical operator AND for two filter expressions on the same attribute

can be achieved by setting multiple columns for the attribute in the

array. The array on the right returns all elements where the Price

attribute is greater than 500 AND smaller than 1000:

{"Price","Price";">500","<1000"}

A wildcard pattern is a sequence of characters that defines a search

Copyright © Jedox AG

pattern and only “*” and “?” can be used as wildcards.

If PERL regular expressions are used, signs such as “[” or “$” have an

impact.

Examples of PERL regular expressions:

“Jan|Feb|Nov”Matches the attributes “Jan”, “Feb” or

“Nov”.

“^J”Matches all the attributes starting with a

“J”.

“[s,d]”Matches all the attributes with “s” or “d”

in the attribute name.

“n$” Matches all the attributes ending in “n”

“X*”

Matches all the attributes starting with an

X and followed by an arbitrary number of

characters.

“XP+”Matches all the attributes in which “XP”

occurs several times or at least once.

PALO.AGR.CHILDREN()

This is a helper function for the statistical functions PALO.DATA.AVG

and PALO.DATA.CNT.

PALO.AGR.LEAVES()

This is a helper function for the statistical functions PALO.DATA.AVG

Copyright © Jedox AG

and PALO.DATA.CNT.

PALO.AGR.SELF()

This is a helper function for the statistical functions PALO.DATA.AVG

and PALO.DATA.CNT.

PALO.CONNECTIONUSER(Server)

Available in Jedox Excel Add-in and Jedox Web (in Jedox Web, this

function isn’t displayed in the function wizard).

This function displays the user of the connection “Server”, e.g.:

=PALO.CONNECTIONUSER("localhost")

PALO.COORD()

This is a helper function for certain statistical functions. For more

information, see PALO.DATA.AVG.

PALO.CUBE_CLEAR(Server/Database,Cube,Coordinate1,Coordin

ate2,…)

Clears the value of a whole cube or a specified cube area. This function

can only be used in a VBA script, e.g:

Sub Test4()

Dim serverdb As String

Dim cube As String

Dim ignore As Variant

Copyright © Jedox AG

serverdb = "localhost/Demo"

cube = "sales"

' clear whole cube

ignore = Application.Run("PALO.CUBE_CLEAR", serverdb,

cube)

Dim subcube(1 To 6) As Variant

Dim Years(1 To 2) As Variant

Years(1) = "2004"

Years(2) = "2005"

subcube(4) = Years

' clear partial cube

ignore = Application.Run("PALO.CUBE_CLEAR", serverdb,

cube, subcube)

MsgBox ignore

End Sub

PALO.CUBE_EXISTS(Server/Database, Cubename)

Copyright © Jedox AG

Returns TRUE, if cube exists, else FALSE. e.g.:

=PALO.CUBE_EXISTS("localhost/Demo","Sales")

PALO.CUBE_LIST_DIMENSIONS(Server/Database, Cube)

Returns a list with all dimensions of the specified cube in an area you

define in advance, e.g.:

=PALO.CUBE_LIST_DIMENSIONS("localhost/Demo","Sales")

PALO.DATA(Server/Database,Cube, Coordinate1,

Coordinate2,… Coordinate16)

Reads the value of the described data cell from the cube, e.g.:

=PALO.DATA("localhost/Demo","Sales","Desktop

L","Germany","Oct",2015,"Actual","Units")

You can input a maximum of 253 characters. If the argument of the

function is an empty string instead of a coordinate, the result is an

empty string.

PALO.DATA.AVG(Server/Database, Cube, Coordinates,

Expandtypes)

Returns the average value of the cells in the specified cell range whose

value is not zero, e.g.:

=PALO.DATA.AVG("localhost/Demo","Sales",PALO.COORD("A

ll

Products","Europe","Year","2015","Actual","Units"),PA

LO.EXPANDTYPE(1,4,2))

Copyright © Jedox AG

PALO.EXPANDTYPE() specifies the coordinates of PALO.COORD().

Explanation for PALO.EXPANDTYPE(1,4,2)

1=SELF (All Products) 4=LEAFS (Base cells of Europe: 19 countries)

2=CHILDREN (Children from Year: Qtr.1,Qtr.2,Qtr.3,Qtr.4) Other coordinates have the default value 1 (=SELF)

In the specified area, all cells that do not have a zero value will be

added and divided by the number of terms of the sum. However, if all

cell values are 0, then the output is 0.

PALO.DATA.CNT(Server/Database, Cube, Coordinates,

Expandtypes)

Returns the number of cells of the specified range whose value is not

zero, e.g.:

=PALO.DATA.CNT("localhost/Demo","Sales",PALO.COORD("A

ll

Products","Europe","Year","2015","Actual","Units"),PA

LO.EXPANDTYPE(1,4,2))

For more information about PALO.EXPANDTYPE, see PALO.DATA.AVG.

PALO.DATA.MAX(Server/Database, Cube, Coordinates,

Expandtypes)

Returns the maximum of the cells of the specified range of cells whose

value is not zero, e.g.:

=PALO.DATA.MAX("localhost/Demo","Sales",PALO.COORD("A

ll

Products","Europe","Year","2015","Actual","Units"),PA

Copyright © Jedox AG

LO.EXPANDTYPE(1,4,2))

Calculation: the largest value of a cell in the specified area is returned.

Zero values are ignored. Exceptions: if all cell values are 0, then the

output is 0.

For more information about PALO.EXPANDTYPE, see PALO.DATA.AVG.

PALO.DATA.MIN(Server/Database, Cube, Coordinates,

Expandtypes)

Returns the minimum of the cells of the specified range of cells whose

value is not zero, e.g.:

=PALO.DATA.MIN("localhost/Demo","Sales",PALO.COORD("A

ll

Products","Europe","Year","2015","Actual","Units"),PA

LO.EXPANDTYPE(1,4,2))

Calculation: the smallest value of a cell in the specified area is

returned. Zero values are ignored. Exception: if all cell values are 0,

then the output is 0.

For more information about PALO.EXPANDTYPE, see PALO.DATA.AVG.

PALO.DATA.SUM(Server/Database, Cube, Coordinates,

Expandtypes)

Returns the sum of cells in the specified range of cells, e.g.:

=PALO.DATA.SUM("localhost/Demo","Sales",PALO.COORD("A

ll

Copyright © Jedox AG

Products","Europe","Year","2015","Actual","Units"),PA

LO.EXPANDTYPE(1,4,2))

For more information about PALO.EXPANDTYPE, see PALO.DATA.AVG.

PALO.DATA.SUM is only used internally for average calculation.

PALO.DATA.SUM returns the aggregated sum. The result isn’t different

from normal PALO.DATA.

The example returns the same value as

=PALO.DATA("localhost/Demo","Sales","All

Products","Europe","Year","2015","Actual","Units")

PALO.DATABASE_EXISTS(Server/Database)

Returns TRUE, if database exists, else FALSE. E.g.:

=PALO.DATABASE_EXISTS("localhost/demo")

PALO.DATABASE_LIST_CUBES(Server/Database,[Type, Show

permission]) 2)

Argument Form

Server/Database Text

Type Empty: Lists all cubes

or optional a number for the type of cubes: 0=normal cubes,

1=system cubes,

2=attribute cubes, 3=userinfo cubes, 4=gpu cubes

Show permission Optional: TRUE, FALSE(default)

Copyright © Jedox AG

Lists the cubes of a database in an area you define in advance, e.g.:

=PALO.DATABASE_LIST_CUBES("localhost/Demo",1) – Lists

system cubes of the database “Demo”.

PALO.DATABASE_LIST_DIMENSIONS(Server/Database, [Type]) 2)

Argument Form

Server/Database Text

Type Empty: Lists all dimensions

or optional a number for the type of dimensions:

• 0 – normal dimensions

• 1 – system dimension

• 2 – attribute dimensions

• 3 – userinfo dimensions

Lists the dimensions of a database in an area you define in advance,

e.g.:

=PALO.DATABASE_LIST_DIMENSIONS("localhost/demo",0) –

Lists the normal dimensions of the database “Demo”.

PALO.DATABASE_LIST_DIMENSIONS_EXT(Server/Database,

[Show normal d., ….]) 2)

Argument Form

Server/Database Text

Show normal d. Optional: TRUE(default), FALSE

Show system d. Optional: TRUE, FALSE (default)

Show attribute d. Optional: TRUE, FALSE (default)

Copyright © Jedox AG

Show userinfo d. Optional: TRUE, FALSE (default)

Show permiss. d. Optional: TRUE, FALSE (default)

Lists the dimensions of a database in an area you define in advance,

e.g.:

=PALO.DATABASE_LIST_DIMENSIONS_EXT("localhost/demo",F

ALSE,TRUE) – Lists the system dimensions of the database “Demo”.

PALO.DATAA(Server/Database,Cube, CoordinateArray)

The array version of PALO.DATA. It reads the value of the described

data cell from the cube, e.g:

=PALO.DATAA("localhost/Demo","Sales",{"DesktopL","Ger

many","Oct",2015,"Actual","Units"})

PALO.DATAC(Server/Database,Cube, Coordinate1,

Coordinate2,… Coordinate16)

Reads the value of the described data cell from the cube, e.g.:

=PALO.DATAC("localhost/Demo","Sales","Desktop

L","Germany","Oct",2015,"Actual","Units")

Contrary to PALO.DATA, all PALO.DATAC functions of a cube in one file

are updated with a single call of the server, and this is consequently

faster than with PALO.DATA functions.

If, instead of a coordinate, an empty string is used as a function

argument (or if an empty cell is referenced), then the result will be not

be an error message but an empty string. This is true for both Jedox

Copyright © Jedox AG

Excel Add-in and Jedox Web.

Important constraints for using PALO.DATAC():

In Excel the function PALO.DATAC internally triggers two1.

recalculation cycles of the workbook. During the first cycle,

the result of the PALO.DATAC formula is not yet available.

This implies that it is problematic to have formulas depend

on PALO.DATAC() where a result has to be present at all

times, such as a second PALO.DATAC formula indirectly

depending on a first PALO.DATAC formula. Therefore

PALO.DATAC may only be used to display values from the

cube or writeback values into the cube. PALO.DATAC() or

its value may not be used in formulas, as this leads to

incorrect results.

If you use Excel’s copy/paste functionality, and you have2.

PALO.DATAC() on the sheet, and automatic recalculation of

the workbook is turned on, then the clipboard will be

empty after pasting its content for the first time. The

workaround for this problem would be to disable automatic

recalculation.

In Jedox Web, you can generally use DATAC formulas as3.

input for other functions. The only constraint is that DATAC

can not be used inside of cyclic calculations. Also, when

using DATAC inside of an IF() formula, a scenario where the

formula calculation encounters two DATAC formulas should

be avoided. For example, there can’t be one DATAC

Copyright © Jedox AG

formula the “condition” argument, and then another in the

“then” or “else” argument; however, using DATAC only in

both “then” and “else” arguments is allowed, as only one

of them would be executed during the calculation.

PALO.DATAAC(Server/Database,Cube, CoordinateArray)

The array version of PALO.DATAC. It reads the value of the described

data cell from the cube, e.g:

=PALO.DATAAC("localhost/Demo","Sales",{"DesktopL","Ge

rmany","Oct",2015,"Actual","Units"})

PALO.DATAT(Server/Database,Cube, Coordinate1,

Coordinate2,… Coordinate16)

Reads the value of the descriptive text cell from the cube, e.g.:

=PALO.DATAT("localhost/Demo","Market","Comment","Year

","Units","All Products","2015","Total")

It enables displaying more than 255 characters if they are entered in

an array function. In this case, the continuation of the text is displayed

in the next cell of the array.

If, instead of a coordinate, an empty string is used as a function

argument (or if an empty cell is referenced), then the result will not be

an error message but an empty string. This is true for both Jedox Excel

Add-in and Jedox Web.

PALO.DATAAT(Server/Database,Cube, Coordinate array)

Copyright © Jedox AG

Behaves like PALO.DATAA, but the cell value is a string. It returns a

string array of maximum 255 characters.

PALO.DATAATC(Server/Database,Cube, Coordinate array)

Behaves like PALO.DATAAC, but the cell value is a string. It returns a

string array of maximum 255 characters.

PALO.DATAV(Server/Database,Cube, Coordinate1,

Coordinate2,… Coordinate16)

Returns the value of a data cell from a cube when you use an Excel

array formula.

This function is similar to PALO.DATA and PALO.DATAC, but it improves

performance because a single array formula is generated for the

complete area. Use of PALO.DATAV is only possible in related cell

areas.

PALO.DATAX(Server/Database,Cube, coordinate1,

coordinate2,… coordinate16)

This function, which is available only in Jedox Excel Add-in, returns the

value of the described element from the cube if the corresponding cell

is on the currently active work sheet.

Note: This function corresponds to the PALO.DATA function. However,

the computation is limited to the currently active table. This speeds up

the computation, because it is no longer necessary to compute the

whole workbook. If, however, you switch to a different worksheet and

later come back to the worksheet containing the PALO.DATAX

formulas, you may have to manually trigger a re-computation of the

worksheet. This step will always be necessary if calling the worksheet

Copyright © Jedox AG

returns “#NV” instead of a value.

PALO.DFILTER() 1)

Calculates either a numeric value or a string value for each of the

elements of the subset. In the case of numeric values, a slice can be

defined for each of the elements of the subset. The slice is always the

same except for the element itself. Now you can do operations using

the cell values within the slices, such as Total Sum, Maximum, or

Minimum based on all cells. This results in a value for each of these

elements.

The elements can now be filtered based on their values, whereby

operations such as “<100” will be applied.

The filtering is similar for string values, e.g. you could filter by applying

“>w”, whereby lexicographical rules apply. However, the slice may

contain only one cell. The reason is obvious: you cannot summarize

strings.

You can use multiple DFilters in one subset. They all have to filter for

the same dimension, but can run on different subcubes. By default, the

result sets of all DFilters are combined using OR. All elements that are

part of either DFilter result will be in the final result set. This behavior

can be changed by setting the eighth parameter of the DFilter function

(see below).

Argument Form Description

PALO.SUBCUBE() Function PALO.SUBCUBE is an essential selection criterion when using DFilter. The arguments are the

name of the cube and the dimensions, excluding the dimension that is covered by the subset.

The elements are entered in the sequence in which the dimensions are defined in the cube.

The place in the dimension, which is already determined by the subset, remains empty.

Copyright © Jedox AG

Operations See examples: Checks whether the values determined for the elements satisfy the criteria.

Possible operators:=,<,>,<=,>=,<>

Example 1 for a data value: {">=".3000}

Example 2 for a string: {"="."Super"} (Here, “Super” is an entry in a text-element)

Top Number This is another possible argument. In case an integer value TOP is passed, only a number of

TOP elements with the highest values are displayed. If the argument is left blank, the elements

will not be restricted.

Upper percentage Number If a numeric value between 1 and 99 (inclusive) is entered here, then only the largest

elements (whose total value reaches the exact limit or whose total value is closest to it) are

selected. The selection starts at the largest element, then adds the second largest, and so on.

The selection ends when the total sum is closest to the limit.

Lower percentage Number If a numeric value between 1 and 99 (inclusive) is entered here, then only the smallest

elements (whose total value reaches the exact limit or whose total value is closest to it) are

selected. The selection starts at the smallest element, then adds the second smallest, and so

on. The selection ends when the total sum is closest to the limit.

If both upper and lower percentage arguments are used, the “mid-percentage” applies. In

this case, the values up to the highest or the lowest marginal value respectively will be

removed from the selection. Taking the above example, all values between >50% (starting

with the highest value) and >5% (starting with the lowest value) will be included in the

selection.

Cell Operator Number If a value is entered, the respective operator will be applied to each slice. You can, for

example, calculate the sum, minimum, or maximum of the cells in the slice. 6 = STRING

expects strings to be contained in the cells. For slice use 1.

Operators: 0/blank = SUM, 1=ALL, 2=AVERAGE, 3=MAXIMUM, 4=ANY, 5=MINIMUM, 6=TEXT

Elements are returned – not the values.

No Rules True/False Empty/false = enterprise rules are computed for DFilters.

True = enterprise rules are not computed for DFilters.

Use AND True/False Empty/false = result sets of multiple DFilters are joined using OR.

True = result sets of multiple DFilters are joined using AND. Only elements that are in result

sets of all DFilters are included.

PALO. DIMENSION_EXISTS(Server/Database, Dimensionname)

Returns TRUE, if dimension exists, else FALSE. E.g.:

=PALO.DIMENSION_EXISTS("localhost/Demo","Regions")

PALO.DIMENSION_LIST_CUBES(Server/Database,Dimension,

[Type]) 2)

Argument Form

Server/Database Text

Dimension Text

Copyright © Jedox AG

Type Empty: Lists all cubes

or optional a number for the type of cubes: 0=normal cubes, 1=system cubes, 2=attribute cubes, 3=userinfo cubes, 4=gpu cubes

Lists in which cubes a dimension is contained, in an area you define in

advance. E.g.:

=PALO.DIMENSION_LIST_CUBES("localhost/Demo","Months",

0) – Lists all normal cubes of the database “Demo” which contain the

specified dimension.

PALO.DIMENSION_LIST_ELEMENTS(Server/Database,

Dimension, Unused) 2)

Argument Form

Server/Database Text

Dimension Text

Unused Argument is not yet used.

Lists which elements are contained in a dimension, in an area you

define in advance. E.g.:

=PALO.DIMENSION_LIST_ELEMENTS("localhost/Demo","Month

s")

PALO.ECC

Stops the cache collection. This function expects no arguments. It can

be used only in VBA scripts and not in Excel cells.

PALO.EADD(Server/Database, Dimension, Type, Element,

Parent Element, Weight, Clear, Error suppr.)

Adds the described dimension element or structures to a database,

e.g.:

=PALO.EADD("localhost/Demo","Years","n","2015","",1,F

Copyright © Jedox AG

ALSE) – consolidated element = BLANK here

=PALO.EADD("localhost/Demo","Months","c","Qtr.1","Yea

r",1,FALSE)

Possible values for Clear are 0 (or FALSE), 1 (or TRUE) and 2

0: Removes no elements of the dimension before importing

1: Removes all elements of the existing dimension before

importing

2: Removes all existing elements of the C-dimension before

importing. Basic elements are not deleted.

Note 1: make sure that all PALO.EADD functions referring to the same

dimension use identical parameters (true or false). Otherwise, all

PALO.EADD functions will execute that parameter for the complete

dimension that was found first. Reason: the sequence in which Excel

formulas are processed cannot be determined. During an import the

Delete command will only be executed once with the first PALO.EADD

() and then it will be ignored.

Note 2: the function PALO.EADD can only be used in connection with

an import, because the Import Wizard recalculates the database.

PALO.EALIAS(Server/Database, Dimension, Attribute, Alias,

Index) 2)

Lists all elements with the matching alias, in an area you define in

Copyright © Jedox AG

advance.

In the database “Demo”, the attribute “Color” was created for

“Products”, and nine products have received the attribute “black” in

the following examples:

=PALO.EALIAS("localhost/Demo","Products","Color","bla

ck") displays these nine products.

=PALO.EALIAS("localhost/Demo","Products","Color","bla

ck", 3) displays the 3rd of the nine products.

=PALO.EALIAS("localhost/Demo","Products","Color","bla

ck", 10) displays again the nine products, because

the index 10 does not exist.

PALO.ECHILD(Server/Database, Dimension, Element, Index,

Error suppr.)

Returns the name of the specified child element, e.g.:

=PALO.ECHILD("localhost/Demo","Regions","South",3)

returns “Spain”.

PALO.ECHILDCOUNT(Server/Database, Dimension, Element,

Error suppr.)

Returns the number of children in the described consolidated element,

e.g.:

=PALO.ECHILDCOUNT("localhost/Demo","Regions","South")

returns “3”.

PALO.ECOUNT(Server/Database, Dimension, Error suppr.)

Returns the total number of elements in the described dimension, e.g.:

Copyright © Jedox AG

=PALO.ECOUNT("localhost/Demo","Years") returns “9”.

PALO.EDELETE(Server/Database, Dimension, Element, Error

suppr.)

Deletes the described element, e.g.:

=PALO.EDELETE("localhost/Demo","Products","Subnote

XK")

Note: with Excel Add-in the function PALO.EDELETE can only be used

in connection with an import, because there the deletion is controlled

via the import.

PALO.EEXISTS(Server/Database, Dimensionname,

Elementname)

Returns TRUE, if element exists, else FALSE. E.g.:

=PALO.EEXISTS("localhost/Demo","Regions","Spain")

PALO.EFIRST(Server/Database, Dimension, Error suppr.)

Returns the first element in the described dimension, e.g.:

=PALO.EFIRST("localhost/Demo","Regions") returns

“Germany”.

PALO.EINDENT(Server/Database, Dimension, Element, Error

suppr.)

Returns the hierarchy level of an element within the dimension, e.g.:

=PALO.EINDENT("localhost/Demo","Regions","Italy")

returns “3”.

Copyright © Jedox AG

PALO.EINDEX(Server/Database, Dimension, Element, Error

suppr.)

Returns the position of the specified element in the dimension, e.g.:

=PALO.EINDEX("localhost/Demo","Regions","France")

returns “2”.

PALO.EISCHILD(Server/Database, Dimension, Parent Element,

Element…)

Checks whether a consolidated element contains the described

element, e.g.:

=PALO.EISCHILD("localhost/Demo","Regions","West","Ger

many") returns TRUE.

PALO.EL()

PALO.ELALL()

Both functions are helper functions, related to flexible cube layout.

They are used within other PALO functions, such as PALO.DATA*(), to

specify not just an element name or array of elements, but also to

specify a dimension name with it. Functions that use PALO.EL() for

coordinates will continue to work, even if the layout of a cube (e.g.

order of dimensions) changes.

PALO.EL() expects two parameters as input. The first is the name of the

dimension; the second is either an element name, or (for use in

PALO.DATAV) an array of element names. Note that if you want to use

the PALO.EL() formula, it has to be used for all coordinate arguments.

You can not mix the old, simple element coordinate syntax with usage

Copyright © Jedox AG

of PALO.EL().

When using the PALO.EL() formulas, the order in which coordinates are

specified then does not matter. The dimension name is used to look up

the specified elements, regardless of the dimension layout (order) in

the cube. Each dimension that defines a default read/write element can

be completely omitted.

PALO.ELALL() is specific case, used in PALO.CUBE_CLEAR(). It only

takes a dimension name as argument. It’s meaning is “all elements in

dimension X”.

Example:

=PALO.DATA("localhost/Demo","Sales",PALO.EL("Regions"

,"Europe"),PALO.EL("Products","All

Products"),PALO.EL("Years","All

Years"),PALO.EL("Months","Year"),PALO.EL("Versions","

All Versions"),PALO.EL("Measures","Units"))

PALO.ELEMENT_LIST_ANCESTORS(Server/ Database, Dimension,

Element) 2)

Argument Form

Server/Database Text

Dimension Text

Element Text

Error suppr. Empty or FALSE: Error messages will not be suppressed.

TRUE: Error messages will be suppressed.

Copyright © Jedox AG

Lists all ancestors of the given element in a predefined area, e.g.:

=PALO.ELEMENT_LIST_ANCESTORS("localhost/Demo","Months

","Jan")

PALO.ELEMENT_LIST_CHILDREN (Server/ Database, Dimension,

Element) 2)

Lists all child elements of a consolidated element in a predefined area,

e.g.:

=PALO.ELEMENT_LIST_CHILDREN("localhost/Demo","Regions

","West")

PALO.ELEMENT_LIST_CONSOLIDATION_ELEMENTS (Server/

Database, Dimension, Element, Start, Limit)

An extension of PALO.ELEMENT_LIST_CHILDREN, used for very large

amounts of data. The following arguments are optional:

start: can define the first index of the children to return or

the name of the element to start the list.

limit: the maximum count of elements that should be

returned.

PALO.ELEMENT_LIST_DESCENDANTS(Server/ Database,

Dimension, Element, Error suppr.) 2)

Argument Form

Copyright © Jedox AG

Server/Database Text

Dimension Text

Element Text

Error suppr. Empty or FALSE: Error messages will not be suppressed.

TRUE: Error messages will be suppressed.

Lists all children and grandchildren of an element in a predefined area,

e.g.:

=PALO.ELEMENT_LIST_DESCENDANTS("localhost/Demo","Prod

ucts","Monitors")

PALO.ELEMENT_LIST_PARENTS(Server/ Database, Dimension,

Element) 2)

Lists all parents of an element in a predefined area, e.g.:

=PALO.ELEMENT_LIST_PARENTS("localhost/Demo","Months",

"Jan")

PALO.ELEMENT_LIST_SIBLINGS (Server/ Database, Dimension,

Element) 2)

Lists all siblings of an specified element, also the specified element

itself, in a predefined area, e.g.:

=PALO.ELEMENT_LIST_PARENTS("localhost/Demo","Months",

"Qtr.1")

PALO.ELEVEL(Server/Database, Dimension, Element, Error

suppr.)

Copyright © Jedox AG

Returns the number of hierarchy levels that follow after the element

within the dimension, e.g.:

=PALO.ELEVEL("localhost/Demo","Regions","Germany")

returns “0”.

=PALO.ELEVEL("localhost/Demo","Regions","West") returns

“1”.

PALO.ENAME(Server/Database, Dimension, Index)

Returns the name of the element of a specific position (first position is

1), e.g.:

=PALO.ENAME("localhost/Demo","Regions",2) returns

“France”.

Note: to display or select aliases in a PALO.ENAME formula on

protected Excel sheets, it is necessary to allow changing cell formats.

Displaying or selecting element names without alias usage works even

if cell format cannot be changed by users.

PALO.ENEXT(Server/Database, Dimension, Element, Error

suppr.)

Returns the name of the subsequent element within the dimension,

e.g.:

=PALO.ENEXT("localhost/Demo","Regions","Italy") returns

“Portugal”.

PALO.EPARENT(Server/Database, Dimension, Element, Index,

Error suppr.)

Returns the name of the nth parent of the specified element, e.g.:

Copyright © Jedox AG

=PALO.EPARENT("localhost/Demo","Regions","Italy",1)

returns “South”.

=PALO.EPARENT("localhost/Demo","Regions","Italy",2)

returns “New Group”, if “New Group” has been created before and

“Italy” is consolidated in it.

Note: if an element occurs only in one consolidation, only the

parameter “number” = “1” is possible. If an element occurs in several

consolidations, the “Number” determines which consolidated element

is returned.

PALO.EPARENTCOUNT(Server/Database, Dimension, Element,

Error suppr.)

Returns the number of consolidated elements in which the described

element is contained, e.g.:

=PALO.EPARENTCOUNT("localhost/Demo","Regions","Italy"

) returns “1”.

=PALO.EPARENTCOUNT("localhost/Demo","Regions","Italy"

,2) returns “2”, if “New Group” has been created before and “Italy” is

consolidated in it.

PALO.EPREV(Server/Database, Dimension, Element, Error

suppr.)

Returns the name of the preceding base element, e.g.:

=PALO.EPREV("localhost/Demo","Regions","Italy") returns

“Austria”.

PALO.ERENAME(Server/Database, Dimension, Old Name, New

Copyright © Jedox AG

Name, Error suppr.)

Renames the described element, e.g.:

=PALO.ERENAME("localhost/Demo","Products","Notebook

TT","Notebook TS")

Note: the function PALO.ERENAME can only be used in connection with

an import, because the renaming is controlled via the import.

PALO.ERROR_LOG(Error, Path, Value, Cube, Coordinate1,

Coordinate2,…,Coordinate15) available only in Jedox Excel Add-in.

Writes the data records of an import file that does not adhere to import

specifications into an error file, e.g.:

=PALO.ERROR_LOG(F3,"c:\Error.txt",A1,B1,C1,D1,E1,F1)

Note: the function PALO. ERROR_LOG can only be used in connection

with an import.

PALO.ESELECT(Server/Database, Dimname, Element,

Subfunction Subsetname, Subsettype, Alias, Aliasformat)

Returns the name or the alias of an element from dimension or subset.

This function allows specifying a stored subset, which is used to filter

element lists shown in the Select Element dialog. Additionally, it

allows specifying an Alias and an Alias format. Long element lists on

specific dimension levels are displayed in paged mode. The search in

both Paste Elements dialog and Select Element dialog will search

across the full dimension.

Argument Form Description

Server/Database Text Reference to server and database.

Copyright © Jedox AG

Dimname Text Reference to dimension

Element Text Reference to path for selected element.

Parts of path are separated by backslash.

Subfunction Number 0/empty: Double-click opens dialog “Select Element”, 1: Double-click opens cell entry for editing.

Subsetname Text Reference to subset. If empty or missing then all elements are used.

Subsettype TRUE/FALSE The type of the stored subset: TRUE is global, FALSE is private.

Alias Text Reference to attribute name. If empty or missing then element name will be used. If the Alias has a localized value in the current user’s locale,

that value will be returned.

Aliasformat Number 0 : alias

1 : element name

2 : element name + ” – ” + alias

3 : alias + ” – ” + element name

4 : element name + ” (” + alias + “)”

5 : alias + ” (” + element name + “)”

6 : element name + ” ” + alias

7 : alias + ” ” + element name

Example:

=PALO.ESELECT("Localhost/Biker","Months","Qtr.1\Mar",

0,"Calendar",TRUE,"deutsch",2)

Result: Mar – Mrz

The ESELECT function’s primary use is to offer an element picker which

is shown when a report user double-clicks a cell that holds an ESELECT

function. It is not intended for programmatic usage of attribute values,

for example within other spreadsheet functions like IF() or

CONCATENATE(). In these cases, a PALO.DATA or DATAC function

pointing to the attribute cube should be used.

PALO.ESIBLING(Server/Database, Dimension, Element, Index,

Error suppr.)

Argument Form

Server/Database Text

Dimension Text

Element Text

Index The element itself has the index 0, the sibling in the hierarchy view found directly below has the index 1, and so on.

The sibling found directly above has the index -1 and so on.

Copyright © Jedox AG

Error suppr. Empty or FALSE: Error messages will not be suppressed.

TRUE: Error messages will be suppressed.

Returns a sibling element of the specified element. The sibling, which

should be returned, must be specified with the index number. E.g.:

=PALO.ESIBLING("localhost/Demo","Regions","Portugal",

1) returns “Spain”.

=PALO.ESIBLING("localhost/Demo","Regions","Portugal",

-1) returns “Italy”.

This function can also be used to verify whether an element exists in a

dimension by entering the name of the element and the position “0”. If

the element exists, the name of the element is returned; if not, “#

Name?” is returned, e.g.:

=PALO.ESIBLING("localhost/Demo","Regions","Italy",0)

returns “Italy”.

==PALO.ESIBLING("localhost/Demo","Regions","Greece",

0) returns “#Name?”.

PALO.ETOPLEVEL(Server/Database,Dimension)

Returns the number of hierarchy levels in a dimension, e.g.:

=PALO.ETOPLEVEL("localhost/Demo","Regions") returns “2”.

PALO.ETYPE(Server/Database, Dimension, Element, Error

suppr.)

Argument Form

Server/Database Text

Copyright © Jedox AG

Dimension Text

Element Text

Error suppr. Empty or FALSE: Error messages will not be suppressed.

TRUE: Error messages will be suppressed.

Returns the type of the described element (numeric, string, or

consolidated), e.g.:

=PALO.ETYPE("localhost/Demo","Regions","Italy") returns

“numeric”.

PALO.EUPDATE(Server/Database, Dimension, Element, Type, C-

Elements, Append)

Updates an element after the specified data. To demonstrate this

function here a nonsense example:

=PALO.EUPDATE=("localhost/demo","Months","Jan","C",{"

Feb",1,"Jun",2})

After this import command “Jan” is a C element, consolidated with

1xFeb and 2xJun. A correction of the last example would be the

following import:

=PALO.EUPDATE("localhost/Demo","Months","Jan","N",{0,

0})

PALO.EWEIGHT(Server/Database, Dimension, Parent, Name of

child, Error suppr.)

Returns the weighting factor of the described element at consolidation,

e.g.:

Copyright © Jedox AG

=PALO.EWEIGHT("localhost/Demo","Regions","West","Germ

any") returns “1”.

PALO.EXPANDTYPE(Integer, Integer, Integer)

This is a helper function for some statistical functions. For more

information, see PALO.DATA.AVG.

PALO.GETELEMENT

Returns the name of the element. The argument must be an Excel cell

containing a PALO.ENAME or a PALO.SELECT formula, e.g:

PALO.GETELEMENT(A1) will display “Year” if in A1 the following

formula is inserted in the cell A1:

=PALO.ESELECT("localhost/Biker";"Months";"Year";0;;;"

deutsch";0).

PALO.HFILTER() 1)

PALO.HFILTER() defines hierarchically a subset with criteria relative to

1. ELEMENT or 2. REVOLVE_ELEMENT. Case 1 and Case 2 should not

be combined.

Argument Form Description

Element Element name Activates the selection of elements that are above or below

“Element” within the dimension hierarchy

Copyright © Jedox AG

Above 0, FALSE or BLANK

1 or TRUE

2

This argument can only be used in combination with “Element”. If

argument is 1 or TRUE, the elements that are above the

“Element” within the hierarchy are selected. If argument is 0,

FALSE or BLANK, the elements below are selected. Above/below

means that the elements have to be direct or indirect children or

parents of “Element”.

If argument is 2, the siblings of “Element” are selected. In

parallel hierarchies, when “Element” is not specified with path,

siblings for all parents are returned.

Exclusive TRUE/FALSE This argument can only be used in combination with “Element”.

TRUE = Do not show the element itself, i.e. Element indicated in

“Element”. Blank or FALSE = Show the element.

Hide Number This argument can only be used in combination with “Element”. It

hides either the base elements (HIDE = 1) or the consolidations

(HIDE = 2). Blank = nothing will be hidden.

Revolve element Element name The effect of this argument is that it will remove elements from

the subset if they are not on the same level as “Revolve

element”. Therefore this argument should not be used in

combination with “Element”. Blank = None. “Revolve element”

additionally requires the specification of “Revolve count”.

Otherwise, an error message will be returned.

Revolve count Number Determines how long the revolving list should be. The length of

the list is dictated by the number in “Revolve count”. Blank =

None.

Revolve add Number Display elements at a lower level (= 1) or at a higher level (=2).

Here, the level fields of the elements assigned by the Jedox

Server are used as criterion. “Revolve add” additionally requires

the specification of “Revolve count”. Otherwise, an error message

will be returned. Blank = nothing .

Start level Number Elements will be removed if they do not meet the level entered in

“Level start” at a minimum and the level in “End level” at a

maximum.

End level Number 2nd argument belonging to “Level start”.

Use relative level FALSE or BLANK

TRUE

Default value is “FALSE”. If TRUE, the “start” and “end” levels are

not absolute to hierarchy, but relative to the “bound” element

(first argument), that have level 0. If no bound element is

selected, only top elements are returned.

PALO.LOGINTEST(Server, Username, Password)

Copyright © Jedox AG

Verifies the username and password combination.

PALO.PICKLIST() 1)

With PALO.PICKLIST(), you can either add elements to the subset that

cannot be removed, or you can determine a set of elements as pre-

selection, i.e., only these elements will be passed on to further filters of

the subset.

Argument Form Description

Definition Name of elements Which elements belong to the pick list. The definition is essential to the pick

list.

Type Number 0/empty =Insert before the list, 1 =Insert after the list, 2 = insert into the list,

3 = As pre-selection for the subset.

PALO.PING

This function updates the internal client cache. It must be called after

finishing creating or deleting elements and can only be used in a VBA

script, e.g:

' Update internal client cache

ignore = Application.Run("PALO.Ping", connectionname)

The expected argument is connectionname, provided in

PALO.REGISTER. If successful, it returns TRUE.

PALO.REGISTER

This function opens the OLAP connection to the Jedox Server. It can

Copyright © Jedox AG

only be used in a VBA script, and not in an excel cell, e.g:

' Define connectionname

connectionname = Application.Run("PALO.REGISTER",

"myserver", "localhost", 7777, "admin", "admin")

Argument Form

connectionname String

dns or ip String.

port Number

username String

password String

Note: For Windows SSO, use “” for the username and password.

If successful, it returns the connection name.

PALO.REMOVE_CONNECTION

Closes the OLAP connection to the Jedox Server. It can only be used in

a VBA script, and not in an excel cell, e.g.:

'Close connection

ignore = Application.Run("PALO.REMOVE_CONNECTION",

connectionname)

Copyright © Jedox AG

The expected argument is connectionname, provided in

PALO.REGISTER. If successful, it returns TRUE.

PALO.ROOT_LIST_DATABASES(Server, List system, List

userinfo) 2)

Argument Form

Server Text

List system TRUE: system databases will also be listed

FALSE: system databases will not be listed

List userinfo TRUE: userinfo databases will also be listed

FALSE: userinfo databases will not be listed

Lists the databases that exist on the server, in an area you define in

advance, e.g.:

=PALO.ROOT_LIST_DATABASES("localhost",TRUE,TRUE)– Lists

the following databases after a default installation: System (system),

Demo (normal), Biker (normal), Config (userinfo), fgrp1(userinfo),

fgrp2(userinfo), rgrp1(userinfo), rgrp2(userinfo), pkgs (userinfo).

PALO.ROOT_LIST_DATABASES_EXT(Server, List system, List

userinfo, ShowPermission)

An array function, extension of PALO.ROOT_LIST_DATABASES. It

displays information about the permission if the parameter

ShowPermission is set to TRUE.

Copyright © Jedox AG

This function can return up to 8 columns of data:

Column Number Content

1 The name of the database.

2

The type of the database:

• 0 – normal

• 1 – System

• 3 – UserInfo

3

The status of the database:

• 0 – unloaded

• 1 – loaded

• 2 – changed

• 3 – loading

4 The number of dimensions.

5 The number of cubes.

6The permission on the database (D, W, R,

N)

7 The time needed for loading.

8 The memory usage.

PALO.SCC

Starts the cache collection. This function expects no arguments. It can

only be used in VBA scripts and not in Excel Cells.

PALO.SERVER_INFO(Server, Show counters) 2) available in Jedox

Copyright © Jedox AG

Excel Add-in and Jedox Web.

This function displays:

major version of the server

minor version of the server

number used to distinguish type of server (1 – ST 32bit, 2 –

MT 32bit, 3 – ST 64bit, 4 – MT 64bit, 5 – GPU 64bit)

build number of the server

encryption (0 for none, 1 for optional, 2 for required)

corresponding HTTPS port or 0 if HTTPS is not supported

data token (changed by every write operation), e.g.:

=PALO.SERVER_INFO("localhost")

PALO.SERVER_SUBSET(Server/Database, Dimension, Global,

Subsetname, Variable, Variable,…) 2)

Returns a subset of dimension elements.

Variables passed in the function itself are accepted. The values offor

the variables can be passed via the function PALO.SERVER_SUBSET

directly, as pairs of arguments for each variable.

The following example retrieves elements for a stored subset named

“base elements” on dimension “Months”, and passes the value

“German” for the variable “alias”:

=PALO.SERVER_SUBSET("localhost/Demo","Months",TRUE,"b

ase elements","alias","German")

Copyright © Jedox AG

PALO.SETDATA(Value, Splash, Server/Database, Cube,

Coordinate1, Coordinate2,…..)

Writes the value into the cell specified through the coordinates. Set

Splash to “True” if you want to write in a consolidated element.

Otherwise, set it to “False”. The parameter “Value” can be a number or

the reference to a spreadsheet cell with a number, e.g., A1.

Alternatively, it can be a formula.

Examples:

=PALO.SETDATA($A$1,FALSE,"localhost/Demo","Sales","De

sktop L","Germany","Dec","2018","Budget","Units")

=PALO.SETDATA($E$1*$F$1*$G$1,FALSE,"localhost/Demo","

Sales","Desktop

L","Germany","Dec","2018","Budget","Units")

PALO.SETDATA_BULK(Server/Database,Cube,Cells,Values,Splas

hmode,Wait)

Available in Jedox Excel Add-in and Jedox Web (in Jedox Web this

function isn’t displayed in the function wizard).

Sets values of several cube cells The values are written into the cells

specified through the parameter cells. Cells and values can be arrays.

The result of PALO.SETDATA_BULK is TRUE.

Splashmodes:

0=No splashing 1= Standard splashing (Splash-Parameter #)

2= Set value to base cells (Splash-Parameter !) 3= Add value to base cells (Splash-Parameter !!)

Example with arrays:

Copyright © Jedox AG

=PALO.SETDATA_BULK("localhost/Demo","Sales",{"Desktop

L","Germany","Dec","2018","Budget","Units";"Desktop

Pro","Germany","Dec","2018","Budget","Units"},{10000;

20000},2)

Example with ranges:

The parameter cells and values of this example are in the ranges

C4:H5 (without quotes) and J4:J5.

=PALO.SETDATA_BULK("localhost/Demo","Sales",$C$4:$H$5

,J4:J5,2)

PALO.SETDATAA(Value, Splash, Server/Database, Cube,

Coordinate Array, Locking Area, SVS_Trigger, Wait)

Writes the value into the cell specified through the coordinates given

as an array. Set Splash to “True” if you want to write in a consolidated

element. Otherwise, set it to “False”. The parameter “Value” can be a

number or the reference to a spreadsheet cell with a number, e.g., A1.

Alternatively, it can be a formula.

Optional Parameter:

Locking_area: locked cell_area (it is possible to define an area of child

cells if target is a parent cell).

Note: The “Value” can only be set to one cell, not to an area of cells!

Therefore only one row can be used for the cell address.

The advantage of this functions compared with PALO.SETDATA() is that

you can restrict splashing with the parameter Locking_area!

Copyright © Jedox AG

Example:

Description: PALO.SETDATAA() splashes 170000 in parent cell “Destop

L,Europe,Dec,2019,Budgets,Units”, displayed childs France and Spain

are locked.

PALO.SETDATAIF(Condition, Value, Splash, Server/Database,

Cube,Coordinate1, Coordinate2,…)

Writes the value into the specified cell of the cube If condition is TRUE,

same as PALO.SETDATA(). If the condition is FALSE, nothing happens.

PALO.SORT() 1)

This is a structuring filter. It can, for example, sort by the order of

definition, by data values, by element names, by alias names or by the

order of consolidations.

In addition, it can produce a hierarchical order, which takes parallel

hierarchies in the subset into account.

Without the sorting filter, the elements are displayed in the order of

definition, as in the unordered list view in Modeler.

Argument Form Description

Whole Number 0/empty = Order of definition.

1 = Builds a hierarchic order and shows the children of elements that have been removed from the subset. It is a prerequisite that the children are contained in the subset.

2 = Will not show the children, but will cut the view at those particular positions.

Criteria Number Sort by 0/blank= Definition, 1=Value, 2=Elementname, 3=Alias, 4=Consolidation (Order of the elements in the hierarchical view in Modeler). This argument should not be

used in combination with “Attribute”.

Attribute Text Does not sort by Aliases if defined, but by the terms defined by the attribute. Note: this argument should not be used in combination with “Criteria”!

Copyright © Jedox AG

Type limitation Number 0/blank = No impact

1 = Sorts base elements only

2 = Sorts consolidations only

To do a sort, it is necessary to indicate the sort criteria. Therefore, this argument works only in connection with the arguments “Whole” and “Criteria”.

Level element Text If not blank, sorting takes place only at the level of this element. To do a sort, it is necessary to indicate the sort criteria. Therefore, this argument works only in connection

with the arguments “Whole” and “Criteria”.

Reverse Number 0/empty = Without effect.

1 = Hierarchical presentation of parents below the children and sorted on every level using criteria.

2 = Complete reversal of the sorting criteria.

3 = Hierarchical presentation and on every level reversal of sorting using criteria.

1 or 3 as argument only works in conjunction with “Whole <> 0/empty”.

With 2 as an argument, it is allowed that “Whole = 0/empty”.

Show duplicates Number 0/empty = Don’t display duplicates

1 = Display duplicates

Number of

elem.

Number Number of returned elements.

Start with Number Element position with which the display of elements begins (element 1 has element position 0, element 2 has 1, and so on.).

Element path TRUE,

FALSE or

empty

TRUE: Subset result will also contain full element path.

PALO.SUBCUBE() 1)

This function is an essential selection criterion when using DFilter. The

arguments are the name of the cube and the dimensions excluding the

dimension that is covered by the subset.

The elements are entered in the sequence in which the dimensions are

defined in the cube. The place in the dimension that is already

determined by the subset remains empty.

PALO.SUBSET() 1)

The principal structure of this function is:

=PALO.SUBSET(Server/Database,Dimension,Indent,Alias,Filter1

,Filter2,Filter3,Filter4,Filter5,Filter6).

The function PALO.SUBSET() is the basic filter required by all the other

filters to display data.

Filters can have an impact on a subset in three different ways:

Restricting, by removing elements 1.

Structuring, by changing the order and possibly the2.

Copyright © Jedox AG

frequency of the elements, or by directly adding elements

Indirectly, by changing the behavior of other filters3.

The function PALO.SUBSET() has the following arguments:

Argument Form Description

Server/Database Text localhost/Demo or A1 (the cell which contains the entry)

Dimension Text Products or A2 (the cell that contains the name of the dimension).

Indent Number The allowed values are 1 (equivalently: empty), 2, 3 and 4. The argument alters the numbering of the hierarchy level, which in turn affects the subset, where the hierarchy level

is specified in the filter.

Indent 1: The elements of the highest hierarchy level get the number 1, the second highest level gets number 2, and so on.

Indent 2: The elements in the lowest hierarchy level (base elements) get the number 0. The number is incremented by 1 for every step up in the hierarchy.

Indent 3: The elements of the highest hierarchy level get the number 0, the second highest level gets the number 1, and so on.

Indent 4: This number will dynamically adjust the indent of elements in the subset based on the overall subset results. All elements for which no parent element is found will

get indent number 1, regardless of their position level in the dimension. Elements for which at least one parent element is found in the subset will get an indent number

calculated from their parent’s indent in the result (incremented by 1).

Alias Text/Array Contains at most two aliases: {“Alias1″,”Alias2”} or “Alias”. Alternatively, it is possible to use a reference to the cell, e.g. {A1} or {A1:A2}. When using “Alias”, the sorting

filters do not use the original names of the elements for their operations but rather the aliases defined in the attribute cube. If empty, aliases are deactivated. If you want to

paste a subset with a defined Alias parameter, you must select at least two columns as a range in order to see the alias. If you select three, Idnent is also displayed on the first

column.

Filter Filter name() Allowed are: PALO.HFILTER(), PALO.TFILTER(), PALO.AFILTER(), PALO.DFILTER(), PALO.PICKLIST(), and PALO.SORT().

PALO.SUBSETSIZE(Server/Database,Dimension,Indent,Alias,Filt

er1,Filter2,…)

Returns the number of dimension elements of the subset.

The arguments are the same as of the function PALO.SUBSET().

PALO.SUBSETX(Server/Database,Dimension,Indent,Alias,Filter1

,Filter2,…)

This function is equal to PALO.SUBSET() with one difference: it must be

called from active sheet.

PALO.TFILTER() 1)

Removes elements from a selection when they do not match defined

Copyright © Jedox AG

Elementname or Alias patterns.

Argument Form Description

Filt. definition Text Array which contains the definition of the element patterns.

Extended Integer,

TRUE, FALSE

Defines the filter behavior. Possible values are:

0, FALSE or blank: Filter uses wildcard patterns for search, case sensitive.

1 or TRUE: Filter uses PERL regular expressions, case sensitive.

2: Filter uses PERL regular expressions, case insensitive.

3: Filter uses wildcard patterns for search, case insensitive.

Not Alias TRUE/FALSE If FALSE (default), TFILTER will search on Alias if one is defined. Otherwise TFILTER will

search on Elementname. If TRUE, TFILTER will search on Elementname even if an Alias

is defined.

A wildcard pattern is a sequence of characters that defines a search

pattern and only “*” and “?” can be used as wildcards.

PALO.USERGROUPS(Server) 2)

Available in Jedox Excel Add-in and Jedox Web. In Jedox Web, this

function isn’t displayed in the function wizard.

This function lists all user groups of the user of the connection

“Server”, e.g.:

=PALO.USERGROUPS("localhost")

2.1 ParametersName Possible entry

Server/Database A text entry (Name) such as “localhost/Demo” or a coordinate such as

A1

Cube A text entry (Name) such as “Sales” or a coordinate such as A2

Dimension A text entry (Name) such as “Europe” or a coordinate such as A4

Copyright © Jedox AG

Element/consolidated element A text entry (Name) such as “Variance” or a coordinate such as B8

Coordinate Can be an element

Type “n” for numeric, “s” for String/Text and “c” for consolidated

Weighting factor A number

Delete True or false (true if existing entries should be deleted)

Position of base element A number

Position A number

Number of consolidated element. A number

Old name, new name Two coordinates such as A1,B1.

Note: the names to be changed are in the coordinates.

Position of the sibling element A number

Value The coordinate that holds the value to be written.

Note: instead of a coordinate such as A1, you can also use a formula

such as A1*B1. This is explained in the push rules.

Splash True or false (true = write in consolidated element)

Error A coordinate, e.g., B10. This refers to the cell, in which the appropriate

PALO.SETDATA function is executed.

Storage location (path) A path such as C:\Documents and Setting\Own Files\Error log.txt. In this

case the faulty data records of an import are saved in the “Error

log.txt” file.

Empty String In the current version, various functions have been extended to accept

the argument “Empty String”. If you enter “TRUE” as actual argument

here, an error message, if it occurs, will not be displayed. Instead, the

cell will be left empty!

Notes:

You might have to replace the comma (,) with a semicolon (;) and the

apostrophe (‘) with quotation marks (“). This depends on country

settings.

If an argument remains blank in a formula, two quotation marks (“”)

are normally set to generate a blank string.

Copyright © Jedox AG

2.2 Subset filter functionsThe filter functions PALO.HFILTER(), PALO.TFILTER(), PALO.PICKLIST(),

PALO.AFILTER(), PALO.DFILTER(), and PALO.SORT() are sub-functions of

PALO.SUBSET (). They do not work independently, but need

PALO.SUBSET() as the basic function. In addition, the function

PALO.SUBCUBE() is required when using PALO.DFILTER().

Behavior of filter functions:

The listed filter functions have a restricting and/or structuring effect on

the elements of the dimension that is selected in PALO.SUBSET().

Hierarchy filter PALO.HFILTER()

This filter is both restricting as well as structuring. It is restricting in

that it defines a subset within the hierarchy of a dimension (e.g. all

elements below a specific element). It is structuring in that it revolves

the structure of the subset, meaning that the selected elements will be

repeated until a defined number of elements has been reached.

Text filter PALO.TFILTER()

This restricting filter removes elements from a selection that do not

match defined element name or alias patterns. If an alias for the

element exists, the third function argument specifies whether the alias

will be used for the search.

Picklist filter PALO.PICKLIST()

Copyright © Jedox AG

With the picklist filter you can do one of two things:

add elements directly, so that they cannot be removed1.

from the subset by any means.

pre-select elements, whereby the remaining filters of the2.

subset will only be applied to the selected elements. In this

case Picklist filter is restrictive.

Attribute filter PALO.AFILTER()

This restrictive filter eliminates elements from a selection if they don’t

match defined attribute patterns.

Data filter PALO.DFILTER()

The data filter is both restrictive and structuring. For each element, a

data value will be calculated. If the data value meets specific criteria,

the element will be retained; otherwise it will be dismissed. The

element will then be sorted by the calculated data values using the

sorting filter.

Sorting filter PALO.SORT()

This structuring filter determines the sequence of the elements in the

subset (e.g. sorting by data value, alphabetically, or by alias). If the

sorting filter is not used, the elements will be displayed in the order of

creation.

Sequence of execution:

First, the restricting filters will be applied. If the “Preselecting”

Copyright © Jedox AG

argument is chosen in the picklist filter, only the selected elements will

be passed on to the further filtering of the subset. Otherwise all

elements of the chosen dimension will be passed on. With filters that

both restricting and structuring characteristics, only the restricting part

will be executed. The order of execution is irrelevant, because

elements are merely removed from the selection.

Next, the structuring filters will be applied. There is an exactly defined

sequence that results inevitably from the filters:

At first, there is a list of elements that have not been

eliminated by the previous filters. They appear in the

sequence in which they are defined in the Modeler.

If the argument “Insert” has been chosen in the function

PALO.PICKLIST(), its elements will be inserted in the order

of creation.

If PALO.SORT() has been specified with arguments, then its

instructions will be executed at this point.

If the argument “Insert before the list” or “Insert after the

list” has been chosen in the function PALO.PICKLIST(), this

instruction will be executed next.

Finally, the revolving arguments of the hierarchical filter

will be executed.

Copyright © Jedox AG

2.3 Array functionsThe output of an array function normally needs more than one cell.

To activate an array function:

Create the array function with the function wizard in the1.

selected cell.

Copy the function to the area in which you can expect an2.

output of the function.

Highlight this area. 3.

Click in the formula bar at the end of the function. 4.

Press Ctrl + Shift + Enter.5.

To deactivate an array function:

Highlight the whole area of the array function. 1.

Click in the formula bar at the end of the function. 2.

Press Ctrl + Enter.3.