Asterisk cmd ExecIf

Synopsis

Executes dialplan application, conditionally.

Usage

Version 1.2 and 1.4

ExecIF (<expr>|<app>|<data>)

Version 1.4.24.1

ExecIF (<expr>?<app>|<data>)

Version 1.6

ExecIf(expression?appiftrue(args)[:appiffalse(args)])

Description

If <expr> is true, execute and return the result of <app>(<data>).
If <expr> is true, but <app> is not found, then the application will return a non-zero value.

It is important not to have any spaces as it does not seem to like that (gives a could not find application if spaces are present). Also, if you don’t use quotation marks and the first value contains spaces (ex.: SYSTEMSTATUS=”internal server error”), it’ll always evaluate to true (ExecIf will evaluate as ExecIf(internal?Background)).

Also note that the separator between the expression is a comma or a vertical bar, not a question mark (as is the case with GotoIf)(Version 1.2 and 1.4).
As of 1.6 the syntax is inline with GotoIf and the 1.2/1.4 syntax will give you errors.

Example

Version 1.2 and 1.4

exten => s,n,ExecIf($["${SYSTEMSTATUS}" = "SUCCESS"]|Background|dictate/playback)

Version 1.4.24.1

exten => s,n,ExecIf($["${SYSTEMSTATUS}" = "SUCCESS"]?Background|dictate/playback)

Version 1.6

exten => s,n,ExecIf($["${SYSTEMSTATUS}" = "SUCCESS"]?Background(dictate/playback))

See Also

• Asterisk cmd GotoIf
• Asterisk func if
• Asterisk cmd ExecIfTime
• Asterisk cmd System
• Asterisk cmd AGI

Asterisk | Applications | Functions | Variables | Expressions | Asterisk FAQ