a!isNullOrEmpty() Function

Function

Returns true if the value is null, an empty string, or an empty list. Otherwise returns false.

See also:

Parameters

Keyword Type Description

value

Any Type

Value to be checked.

Returns

Boolean

Usage considerations

Replace if() and isnull() expressions with a!isNullorEmpty

This function is similar to the behavior of using if() and isnull() to check for the absence of a value or an empty string or list.

For example, you could create an expression using if() and isnull():

1
2
3
4
5
6
7
or( 
    or(tostring(ri!input) = "", isnull(ri!input)), 
    if(isnull(ri!input), 
        true, 
        length(a!flatten(ri!input)) = 0
    ) 
)

Or you could use a!isNullorEmpty(), which requires fewer lines of code:

1
a!isNullOrEmpty(ri!input)

Examples

1
a!isNullOrEmpty(togroup(null))

Returns true

1
a!isNullOrEmpty("")

Returns true

1
a!isNullOrEmpty({1,2,3,4})

Returns false

1
a!isNullOrEmpty(cast(recordType!Address, null))

Returns true

1
a!isNullOrEmpty(recordType!Address)

Returns false

Feature compatibility

The table below lists this function's compatibility with various features in Appian.
Feature Compatibility Note
Portals Compatible
Offline Mobile Compatible
Sync-Time Custom Record Fields Compatible

Can be used to create a custom record field that only evaluates at sync time.

Real-Time Custom Record Fields Incompatible
Process Reports Incompatible

You cannot use this function to configure a process report.

Process Events Incompatible

You cannot use this function to configure a process event node, such as a start event or timer event.

Open in Github Built: Fri, Jan 27, 2023 (07:42:59 PM)

On This Page

FEEDBACK