Macro parameters

output

All

Determines how the output data of the script is to be formatted for output.

The following options are available:

• html - Data is output as a HTML table (default)

• xhtml - Data is rendered using the Confluence XHTML renderer

• wiki - Data is rendered using the Confluence wiki renderer

script

All

Specifies the location of source code. Default is the macro body itself. If a location is specified, the included data will, by default, follow the body data.

The following options are available:

• #filename - Data is read from the file located in Confluence home directory/script/filename. Subdirectories can be specified.

• #http... - Data is read from the URL provided. If basic authentication is required, use the User and Password parameters.

• global page template name - Data is read from a global page template.

• space:page template name - Data is read from a space template.

• ^attachment - Data is read from an attachment to the current page.

• page^attachment - Data is read from an attachment to the page name provided.

• space:page^attachment - Data is read from an attachment to the page name provided in the space indicated.

bodyAfter

All

Determines where the macro body code is added w.r.t the script parameter. Default is false to add the body code before the script parameter code. Set to true to add the body code after the script code.

errorMessage

All

Provides a more user friendly error message. If specified, error information for running the script is suppressed and only this error message is displayed in an error box. 

showErrorOutput

All

Determines how the error output is displayed. Default is false where the error output from the script is discarded. Set to true to display the error output from the script as unformatted text. Error output is generated with something like err.print("xxxxx").

showCode

All

Controls the display of the script code used. Default is false to never show the script code even if the script was successfully run. Set to true to always show a panel with the script code.

Formerly, was the showJava parameter which is still valid for source compatibility.

timeout

All

Determines the time in seconds to wait for incoming data through the specified URL connection. Use this to increase time needed for slow connections. Be careful using 0 for an infinite wait.

user

All

Specifies the user ID to be used for URL connections requiring basic authentication.

password

All

Specifies the user password to be used for URL connections requiring basic authentication.

classpath

Groovy, Gant

Loads external binaries that are not available to Confluence runtime. Provide the absolute path of the binary as an input to this _classpath_ parameter.

targets

Gant

Specifies the list of Gant targets.

strict

Beanshell

Controls what is considered valid source. This mode attempts to make BeanShell syntax behave as Java syntax, eliminating conveniences like loose variables, etc. When enabled, variables are required to be declared or initialized before use, and method arguments are required to have types.

share

jython

Specifies the name required for Python interpreter sharing.

encoding

All

Determines the file encoding for an external file if different from the system default handling. Example: UTF8.