AppendixD: Using the Expression Editor
User Guide   251
Syntax
prompt ( prompt_name , datatype , defaultText , text , queryItem , 
trailing_text )
Example
select . . . where COUNTRY_MULTILINGUAL.COUNTRY_CODE  > #prompt('Starting 
CountryCode',
'integer',
'10'
)#
Result:  select . . . where COUNTRY_MULTILINGUAL.COUNTRY_CODE  > 150
promptmany
Prompt the user for one or more values. Only the prompt_name argument is required.
Syntax
promptmany ( prompt_name , datatype , defaultText , text , queryItem , 
trailing_text )
Example
select . . . where COUNTRY_MULTILINGUAL.COUNTRY IN ( #promptmany ( 
'CountryName' ) # )
Result:  select . . . where COUNTRY_MULTILINGUAL.COUNTRY_CODE  IN ('Canada' , 'The 
Netherlands' , 'Russia')
sb
Surround the passed string with square brackets.
Syntax
sb ( string_exp )
Example
#sb ( 'abc' )#
Result: [abc]
sq
Surround the passed string with single quotes.
Syntax
sq ( string_exp )
Example
#sq ( 'zero' )#
Result: 'zero'
sort
Sorts the elements of the array in alphabetical order. Duplicates are retained.
Syntax
sort ( array_exp )
Example
#csv ( sort ( array ( 's3', 'a', 'x' ) ) )#
Adding a page to a pdf in preview - insert pages into PDF file in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Guide C# Users to Insert (Empty) PDF Page or Pages from a Supported File Format
adding a page to a pdf file; add page number pdf file
Adding a page to a pdf in preview - VB.NET PDF Page Insert Library: insert pages into PDF file in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Easy to Use VB.NET APIs to Add a New Blank Page to PDF Document
adding page numbers in pdf; add page to pdf reader
252    Report Studio
AppendixD: Using the Expression Editor
Result:  'a', 's3', 'x'
split
Splits a string or the string elements of the array into separate elements.
Syntax
split ( pattern_string, string_exp | array_exp )
Example 1
#csv ( split ( '::', 'ab=c::de=f::gh=i' ) )#
Result:  'ab=c' , 'de=f', 'gh=i'
Example 2
#csv ( split ( '=' , split ( '::', 'ab=c::de=f::gh=i' ) ) )#
Result:  'ab' , 'c' , 'de' , 'f',  'gh' , 'i'
substitute
Search for a pattern in a string or in the string elements of an array and substitute the found text 
with other text.
Syntax
substitute ( pattern_string, replacement_string, string_exp | array_exp )
Example 1
#sq ( substitute ( '^cn=', '***', 'cn=help' ) )#
Result:  '***help'
Example 2
#csv ( substitute ( '^cn=', '***', array ( 'cn=help' , 'acn=5' ) ) )#
Result:  '***help' , 'acn=5'
Example 3
#csv ( substitute ( 'cn=', '', array ( 'cn=help' , 'acn=5' ) ) )#
Result:  'help' , 'a5'
unique
Removes duplicate entries from the array. The order of the elements is retained.
Syntax
unique ( array_exp )
Example
Example:
#csv ( unique ( array ( 's3', 'a', 's3', 'x' ) ) )#
Result:  's3', 'a', 'x'
urlencode
URL encodes the passed argument. Useful when specifying XML connection strings.
C# PDF insert image Library: insert images into PDF in C#.net, ASP
digital photo, scanned signature or logo into PDF document page in C# solve this technical problem, we provide this C#.NET PDF image adding control, XDoc
adding page numbers to pdf document; add page number to pdf preview
C# PDF insert text Library: insert text into PDF content in C#.net
Insert formatted text and plain text to PDF page using .NET XDoc.PDF component in C#.NET class. Supports adding text to PDF in preview without adobe reader
adding a page to a pdf in reader; add a page to a pdf in reader
AppendixD: Using the Expression Editor
User Guide   253
Syntax
field_one=urlencode(prompt('userValue'))
Example
urlencode(prompt('some_val'))
Result: 
%27testValue%27
CSVIdentityName
Use the identity information of the current authenticated user to lookup values in the specified 
parameter map. Each individual piece of the user's identity (account name, group names, role 
names) is used as a key into the map. The unique list of values that is retrieved from the map is 
then returned as a string, where each value is surrounded by single quotes and where multiple 
values are separated by commas.
Syntax
CSVIdentityName ( %parameter_map_name [ , separator_string ] )
Example
#CSVIdentityName ( %security_clearance_level_map )#
Result: 'level_500' , 'level_501' , 'level_700'
CSVIdentityNameList
Returns the pieces of the user's identity (account name, group names, role names) as a list of 
strings. The unique list of values is returned as a string, where each value is surrounded by single 
quotes and where multiple values are separated by commas.
Syntax
CSVIdentityNameList ( [ separator_string ] )
Example
#CSVIdentityNameList ( )#
Result: 'Everyone' , 'Report Administrators' , 'Query User'
CAMPassport
Returns the passport.
Syntax
CAMPassport ( )
Example
#CAMPassport ( )#
Result: 111:98812d62-4fd4-037b-4354-26414cf7ebef:3677162321
CAMIDList
Returns the pieces of the user's identity (account name, group names, role names) as a list of 
values separated by commas.
Syntax
CAMIDList ( [ separator_string ] )
Example
#CAMIDList ( )#
Result: CAMID("::Everyone"), CAMID(":Authors"), CAMID(":Query Users"), 
CAMID(":Consumers"), CAMID(":Metrics Authors")
VB.NET PDF insert text library: insert text into PDF content in vb
Studio .NET PDF SDK library supports adding text content to Add text to certain position of PDF page in Visual Add text to PDF in preview without adobe reader
add page numbers pdf files; add page numbers to a pdf in preview
C# Create PDF Library SDK to convert PDF from other file formats
What's more, you can also protect created PDF file by adding digital signature (watermark) on PDF Create a new PDF Document with one Blank Page in C#
adding page numbers to a pdf file; add and delete pages in pdf
254    Report Studio
AppendixD: Using the Expression Editor
CAMIDListForType
Returns an array of the user's identities based on the identity type (account, group, or role). It can 
be used with the macro functions csv or join.
Syntax
CAMIDListForType ( identity type )
Example
[qs].[userRole] IN ( #csv ( CAMIDListForType ( 'role' ) ) # ) 
Result: [qs].[userRole] IN ( 'Administrator', 'developer' )
Common Functions
_format
Associates a format with the expression. The keyword can be PERCENTAGE_0, 
PERCENTAGE_1 or PERCENTAGE_2.
Syntax
_format ( expr , keyword  )
Example
_format( [Unit Sale Price] / [Unit Price] , PERCENTAGE_2 )
Result: 0.75123 displayed as 75.12%
_round
Returns the numeric expression rounded to the integer_exp places right of the decimal point.  
Note: integer_exp MUST be a non-negative integer.
Syntax
_round ( numeric_exp, integer_exp )
Example
_round ( 1220.42369, 2 )
Result: 1220.42
abs
Returns the absolute value of numeric_exp. The sign of negative values is changed to positive.
Syntax
abs ( numeric_exp )
Example 1
abs ( 15 )
Result: 15
Example 2
abs ( -15 )
Result: 15
C# Word - Insert Blank Word Page in C#.NET
This C# .NET Word document page inserting & adding component from RasterEdge is written in managed C# code and designed particularly for .NET class applications
add pages to pdf in preview; add pages to pdf reader
C# PowerPoint - Insert Blank PowerPoint Page in C#.NET
This C# .NET PowerPoint document page inserting & adding component from RasterEdge is written in managed C# code and designed particularly for .NET class
add pages to pdf acrobat; add page numbers to pdf document
AppendixD: Using the Expression Editor
User Guide   255
ancestor
Returns the ancestor of the specified member at either the specified (named) level or the specified 
number of levels above the member.  Note: The result is not guaranteed to be consistent when 
there is more than one such ancestor.
Syntax
ancestor ( member, level | integer )
ancestors
Returns all the ancestors of a member at a specified level, or distance above the member.  (Most 
data sources support only one ancestor at a specified level, but some support more than one. 
Hence the result is a member set.)
Syntax
ancestors ( member , level | index )
bottomCount
This function sorts a set according to the value of "numeric_exp" evaluated at each of the 
members of "set_exp", and returns the bottom "index_exp" members. 
Syntax
bottomCount ( set_exp , index_exp , numeric_exp )
bottomPercent
This function is similar to bottomSum, but the threshold is "numeric_exp1" percent of the total. 
Syntax
bottomPercent ( set_exp , numeric_exp1 , numeric_exp2 )
bottomSum
This function sorts on "numeric_exp2", evaluated at the corresponding member of "set_exp", 
and picks up the bottommost elements whose cumulative total is at least numeric_exp1.
Syntax
bottomSum ( set_exp , numeric_exp1 , numeric_exp2 )
caption
Returns the caption values of the specified argument.
Syntax
caption ( level | member | set_exp )
cast
Converts an expression to a specified data type. Some data types allow for a length and precision 
to be specified. Make sure that the target is of the appropriate type and size.
Syntax
cast ( expression, datatype_specification )
Example 1
cast ( '123' , integer )
Result: 123
Example 2
cast ( 12345 , VARCHAR ( 10 ) )
C# PowerPoint - How to Process PowerPoint
& Insert PowerPoint Page/Slide in C#. Use the provided easy to call and write APIs programmed in C# class to develop user-defined PowerPoint slide adding and
add page numbers to pdf preview; adding pages to a pdf
C# TIFF: TIFF Editor SDK to Read & Manipulate TIFF File Using C#.
1. Support embedding, removing, adding and updating ICCProfile. 2. Render text to text, PDF, or Word file. You will see the following aspects on this guide page.
add page break to pdf; add a page to a pdf file
256    Report Studio
AppendixD: Using the Expression Editor
Result: a string containing 12345
Notes
You can specify the following datatypes: CHARACTER, VARCHAR,  CHAR, NUMERIC, 
DECIMAL, INTEGER, SMALLINT, REAL, FLOAT, DATE, TIME, TIMESTAMP, TIME 
WITH TIME ZONE, TIMESTAMP WITH TIME ZONE, and INTERVAL.
When you convert a value of type TIMESTAMP to type DATE, the time portion of the 
timestamp value is ignored.
When you convert a value of type TIMESTAMP to type TIME, the date portion of the 
timestamp is ignored.
When you convert a value of type DATE to type TIMESTAMP, the time components of the 
timestamp are set to zero.
When you convert a value of type TIME to type TIMESTAMP, the date component is set to 
the current system date.
When you type cast to an INTERVAL type, you must specify one of the following interval 
qualifiers: YEAR, MONTH, or YEAR TO MONTH for the year-to-month interval datatype; 
DAY, HOUR, MINUTE, SECOND, DAY TO HOUR, DAY TO MINUTE, DAY TO 
SECOND, HOUR TO MINUTE, HOUR TO SECOND, or MINUTE TO SECOND for the 
day-to-second interval datatype. It is invalid to convert one interval datatype to the other (for 
instance because the number of days in a month is variable). Note that you can specify the 
number of digits for the leading qualifier only, i.e. YEAR(4) TO MONTH, DAY(5).
Errors will be reported if the target type and size are not compatible with the source type and 
size.
ceiling
Returns the smallest integer greater than or equal to numeric_exp.
Syntax
ceiling ( numeric_exp )
Example 1
ceiling ( 4.22 )
Result: 5
Example 2
ceiling ( -1.23 )
Result: -1
character_length
Returns the number of characters in string_exp.
Syntax
character_length ( string_exp )
Example
character_length ( 'Canada' )
Result: 6
children
Returns the set of children of a specified member.
Syntax
children ( member )
C# Word - Insert Image to Word Page in C#.NET
VB.NET How-to, VB.NET PDF, VB.NET Word, VB.NET Excel, VB.NET PowerPoint, VB.NET Tiff, VB.NET Imaging It's a demo code for adding image to word page using C#.
adding page to pdf in preview; add page numbers to pdf online
AppendixD: Using the Expression Editor
User Guide   257
closingPeriod
Returns the last sibling among the descendants of a member at a specified level. Typically used 
with a time dimension.
Syntax
closingPeriod ( level [, member ] )
coalesce
Returns the first non-null argument (or null if all arguments are null). The Coalesce function 
takes two or more arguments.
Syntax
coalesce ( exp_list )
completeTuple
Similar to "tuple", identifies a cell location (intersection) based on the specified members, each of 
which must be from a different dimension. However, completeTuple implicitly includes the default 
member from all dimensions not otherwise specified in the arguments, rather than the current 
member. The value of this cell can be obtained with the "value" function.
Syntax
completeTuple ( member { , member } )
cousin
Returns the child member of member2 with the same relative position as the member1 is under its 
parent.
Syntax
cousin ( member1 , member2 )
current_date
Returns a date value representing the current date of the computer that the database software runs 
on.
Syntax
current_date
Example
current_date
Result: 2003-03-04
current_time
Returns a time with time zone value, representing the current time of the computer that runs the 
database software.
Syntax
current_time
Example
current_time
Result: 16:33:11+05:00
current_timestamp
Returns a datetime with time zone value, representing the current timestamp of the computer that 
runs the database software.
258    Report Studio
AppendixD: Using the Expression Editor
Syntax
current_timestamp
Example
current_timestamp
Result: 2003-03-03 16:40:15.535000+05:00
currentMember
Returns the current member of the hierarchy during an iteration. If the specified hierarchy is not 
present in the context in which the expression is being evaluated, its default member is assumed.
Syntax
currentMember ( hierarchy )
defaultMember
Returns the default member of a hierarchy.
Syntax
defaultMember ( hierarchy )
descendants
Returns the set of descendants of a set of members at a specified level(qualified name) or 
distance(integer 0..n) from the root. Duplicates will be removed from the set.  Multiple options 
may be specified (separated by a space) to determine which members are to be returned.
Syntax
descendants ( set_expr , level | distance [ , { self | before | 
beforewithmember | after } ] )
Example
descendants([national].[Line].[Line].[Line1]->:[PC].[Line 
(Root)].[Dishwashers], 2, SELF AFTER)
Result: 
Result: AcmeWash MR AcmeWash AcmeWash HE
Notes
self:   Only the members at the specified level are included in the final set (this is the default 
behaviour in the absence of any options).
before:   If there are any intermediate levels between the member's level and the one specified, 
members from those levels are included. If the level specified is the same as the member upon 
which the function is applied, the member is included in the final set.
beforewithmember:   If there are any intermediate levels between the member's level and the 
one specified, members from those levels are included.  The member upon which the function 
is applied is also included in the final set.
after:   If other levels exist after the specified level, members from those levels are included in 
the final set.
emptySet
Returns an empty member set for the specified hierarchy.
Syntax
emptySet ( hierarchy )
except
Returns the members of "set_exp1" that are not also in "set_exp2". Duplicates are retained only 
if the optional keyword ALL is supplied as the third argument.
AppendixD: Using the Expression Editor
User Guide   259
Syntax
except ( set_exp1 , set_exp2 [,ALL] )
exp
Returns e raised to the power of numeric_exp. The constant e is the base of the natural logarithm. 
See also log.
Syntax
exp ( numeric_exp )
Example
exp ( 2 )
Result: 7.389056
extract
Returns an integer representing the value of datepart (year, month, day, hour, minute, second) in 
datetime_exp.
Syntax
extract ( datepart , datetime_exp )
Example 1
extract ( year , 2003-03-03 16:40:15.535 )
Result: 2003
Example 2
extract ( hour , 2003-03-03 16:40:15.535 )
Result: 16
filter
Returns the set resulting from filtering a specified set based on the boolean condition. Each 
member is included in the result if and only if the corresponding value of "boolean_exp" is true.
Syntax
filter ( set_exp , boolean_exp )
firstChild
Returns the first child of a member.
Syntax
firstChild ( member)
firstSibling
Returns the first child of the parent of a member.
Syntax
firstSibling ( member )
floor
Returns the largest integer less than or equal to numeric_exp.
Syntax
floor ( numeric_exp )
260    Report Studio
AppendixD: Using the Expression Editor
Example 1
floor ( 3.22 )
Result: 3
Example 2
floor ( -1.23 )
Result: -2
generate
This function evaluates "set_exp2" for each member of "set_exp1" and joins the resulting sets by 
union. If ALL is specified, duplicates in the result are retained.
Syntax
generate ( set_exp1 , set_exp2 [ , ALL ] )
head
Returns the first "index_exp" elements of "set_exp". The default for "index_exp" is 1.
Syntax
head ( set_exp [ , index_exp ] )
hierarchize
This function orders the members of a set in a hierarchy. Members in a level are sorted in their 
natural order, which is the default ordering of the members along a dimension when no other sort 
conditions are specified.
Syntax
hierarchize ( set_exp )
hierarchy
Returns the hierarchy that contains the specified level, member or member set.
Syntax
hierarchy ( level | member | set_exp )
intersect
Returns the intersection of two input sets. The result retains duplicates only when the optional 
keyword ALL is supplied as the third argument.
Syntax
intersect ( set_exp1 , set_exp2 [ , ALL ] )
item
Returns a member from a specified location within a set. The index into the set is zero based
Syntax
item ( set_exp , index )
lag
Returns the sibling member that is a specified number of positions prior to a specified member.
Syntax
lag ( member , index_exp )
Documents you may be interested
Documents you may be interested