Salesforce

RangeAdd (Magic xpa 2.x)

« Go Back

Information

 
Created ByKnowledge Migration User
Approval Process StatusPublished
Objective
Description

RangeAdd (Magic xpa 2.x)

Adds filtering criteria to the range, so that the next time the view is refreshed, the new criteria will be used (in addition to the range defined in the task).

Syntax:

RangeAdd (variable, from, [to])

Parameters:

variable – Variable reference. Blob, OLE, Vector, and .NET variables are not supported.

from – From value, according to the variable type.

The string of '' is allowed for all types of variables and indicate that the From value will be ignored.

to – Optional. To value, according to the variable type.

Returns:

  • True – The range criteria were updated.

  • False – Illegal range criteria (such as illegal var index).

Note:

  • The RangeAdd function adds criteria to the task range. When the view is refreshed, the range is done according to the task range and the criteria added in the RangeAdd function.

  • The variable names should be unique in the data view.

  • The variable sent can be of parent tasks, so the relevant task range criteria will be updated.

  • This function can be used several times in order to perform the range on multiple variables.

  • The NULL function can be used as a value. In this case, a null value will be sent.

  • The asterisk (*) or question mark (?) characters used in the main source's range or locate is used as a wildcard character. It represents a string of characters. The asterisk and question mark can only be used as the last character in a string.

  • To use the asterisk or character as a value in the range or locate, precede the asterisk or character with a backslash (\). Since version: 1.9h

Examples:

Examples of range and locate syntax:

  • a* will do the range or locate on a* (where * is a wildcard character)

  • a\* will do the range or locate on a* (where * is a string)

  • a\\ will be a\

  • a\\* will do the range or locate on a\* (where * is a wildcard character)

  • a\b will remain a\b

See also:

RangeReset, LocateAdd

The Online and Rich Client Samples projects (program DV13 and RDV13)

 

Since version:

1.9

 

 

Local data source support – since 2.5

 

Reference
Attachment 
Attachment