FORMULA LANGUAGE


@Commands
The @Command and @PostedCommand functions execute a Notes command. The first argument to @Command or @PostedCommand is a keyword argument that specifies the Notes command. Depending on the Notes command, other arguments may be required.

You must use @PostedCommand in applications that run in Notes R3 and R4. The difference between @Command and @PostedCommand is the order of evaluation.

Because of their large number and special status, these @functions comprise a separate category called @commands. Each @command is named after the first argument to @Command or @PostedCommand, which is a keyword argument.

Most @commands mimic a menu command. For example:

@Command([AddDatabase]; "Legal1":"Trademrk.nsf")

@Command([AdminRegisterUser])

@PostedCommand([DesignForms])

@PostedCommand([EditDown]; "5")

You must be careful with @commands due to their side-effects and their order of evaluation.

You can use @commands in formulas for tools, events, button hotspots, action hotspots, and actions. You can use @commands in agents that have no target documents. See the individual @command descriptions for further restrictions.

Setting the NoExternalApps environment variable to 1 disables any formula containing an @command function. The user does not receive an error message -- the formula simply does not execute.