Performs wildcard member selection. Essbase searches for member names that match the pattern you specify, and returns the member names it finds.
Provides an optional parameter to specify if the search should be performed on member names or aliases, regardless of whether the query output in the report script uses members or aliases.
If you defined the members names in the database you are searching as 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 Administration Services (see the Oracle Essbase Administration Services Online Help).
You can use more than one MATCHEX command in your report.
If Essbase does not find any members that match the chosen character pattern, it returns no member names and continues with the other report commands in your report.
Syntax
<MATCH ("Member"|"Gen"|"Level","Pattern",ALT|MBR|BOTH)
Parameter | Description |
---|---|
"Member" | Member name at the top of the member hierarchy you want to search. Essbase searches the member name and its descendants. |
"Gen" | Default or user-defined name of the generation you want to search. |
"Level" | Default or user-defined name of the level you want to search. |
"Pattern" | The character pattern you want to search for, including a wildcard character (* or ?).
|
ALT|MBR|BOTH | Optional—The ALT|MBR|BOTH option overrides default pattern matching specifications. The default pattern matching uses aliases for pattern matching if aliases are to be displayed in report output, but uses names otherwise.
|
Notes
MATCHEX does not function with Hybrid-Analysis relational sources.
Example
<NewAlt "" <matchex(product,100,MBR) ! <outaltselect default <nmatchex(product,Caff*,ALT) ! <OUTALTSELECT "Default" <NewAlt "Product" <OUTMBRNAME <LINK( (<MATCHEX("Product", "100", MBR) AND < IDESCENDANTS("Product"))) !