Variable Identifier

Description

The variable identifier is the name of the variable to access on the specified DCO object. If a variable does not exist, the contents are considered to be empty. If a variable name is not specified, then the “TEXT” variable of the object is accessed, making @X equivalent to @X.TEXT.

Example

For example, assuming the current object is a page level object:

@X.MyVar accesses “MyVar” on the current object.

@P.MyVar also accesses “MyVar” on the current page.

@D.MyVar accesses “MyVar” on the parent document object.

@F.MyVar accesses “MyVar” on the current field object.

When a variable name is not specified, then the “TEXT” variable of the object is accessed. Again, using the example of these smart parameters on a page level object:

@X accesses “TEXT” on the current object.

@P also accesses “TEXT” on the current page.

@D accesses “TEXT” on the parent document object.

@F accesses the “TEXT” property on current field object.

Example of Variable Use In Actions

You can use Smart parameters and navigation as parameter input to any action whose parameters support smart parameters. This provides an additional and powerful tool to create applications because the input parameter value can be determined at runtime. rrSet, rrCompare, and rrCompareNot are some of the common actions that use smart parameters, but the use is not limited to these actions.

The following is a page level example where a barcode type is checked and if it is “Invoice”, the page type is set to “Invoice”.

rrCompare(“@X. GetBarCode”, “Invoice”)

SetPageType(“Invoice”)

The following example shows to how accomplish the same objective in a different way, where the page type is always set to the barcode value directly.

SetPageType(“@X. GetBarCode”)

Note:

The application in the above examples must handle the cases where the page is an unexpected type or the barcode is not read.

In the following page level example, a FileNet property is set to the ID of the document level object.

FNP8_SetProperty("DocumentTitle”, “@D.ID")

In the following field level example, a FileNet property is set to the text value of the field, or as in the second example the 'TEXT' variable value if the calling object is a Batch, Document or Page DCO node.

FNP8_SetProperty("InvoiceNumber”, “@F") OR FNP8_SetProperty("InvoiceNumber”, “@X")