Essbase @MATCH

Performs wildcard member selections.

Syntax

@MATCH (mbrName|genName|levName, "pattern")
Parameter Description

mbrName

The default or user-defined name of the member on which to base the
search. Essbase searches the member names and alias
names of the specified member and its descendants.

genName

The default or user-defined name of the generation to search. Essbase searches all member names and member alias names in
the generation.

levName

The default or user-defined name of the level to search. Essbase searches
all member names and member alias names in the level.

“pattern”

The character pattern to search for, including a wildcard character
(* or ?).

? substitutes one occurrence of any character. You can
use ? anywhere in the pattern.

* substitutes any number of characters. You can use * only
at the end of the pattern.

To include spaces in the character pattern, enclose the pattern in double
quotation marks (“”).

Notes

This function performs a trailing-wildcard member selection. Essbase searches for member names and alias names that match
the pattern you specify and returns the member and alias names it finds.

If the members names in the database you are searching are case-sensitive,
the search is case-sensitive. Otherwise, the search is not case-sensitive.
To define database member names as case-sensitive, use Outline Editor in Oracle Essbase Administration Services. See the Oracle Essbase Administration Services Online Help.

You can use more than one @MATCH function in a calculation script.

If Essbase does not find any members that match
the chosen character pattern, it returns no member names and continues with
the other calculation commands in the calculation script.

Example

In the Sample Basic database:

@MATCH(Product,"???-10")

Returns 100-10, 200-10, 300-10,
and 400-10

@MATCH(Year,"J*")

Returns Jan, Jun, Jul

@MATCH(Product,"C*") 

Returns 100 (Colas), 100-10
(Cola), 100-30 (Caffeine Free Cola), 300 (Cream Soda)