What can we improve?

Dokumentation

Translation is in progress...

Not all topics are available at the moment and content links may be broken.

System Variables

System variables are variables that are available in every script. The user can utilize them to create efficient scripts that can solve generic tasks. The according system variables are set automatically when the script is called, depending on the trigger. The following table provides an overview over the variables which are available in which scripts.

Regard upper and lower case when writing these variables (Case Sensitive)!

Table: General System Variables

The following system variables are always available.

System Variable Description
$_IPS['SELF'] ScriptID of the current script
$_IPS['THREAD'] ThreadID of the current script
$_IPS['SENDER'] Trigger of the current script. Further global variables are possible, depending on the value. Possible values are further specified in the table "Additional System Variables"

Table: Additional System Variables

The following system variables are available, depending on the value of $_IPS['SENDER'].

Designer

When the script was called by a component of the Dashboard.

System Variable Description
$_IPS['COMPONENT'] Content of the field IPSYMID. The type of the value is always string
$_IPS['FORM'] FormID of the formular from which the execution was called

Execute

When the Script was called from the management console.
No additional system variables.

HeatingControl

When the script was called from an event of HeatingControl.

System Variable Description
$_IPS['INSTANCES'] IDs of the sending instances
$_IPS['INVERTS'] States if a device is inverted (true/false)
$_IPS['VALUE'] States if a device should heat (true) or not (false)

ISDN (up to Version 3.4)

When the script was called from an event from the ISDN module.

System Variable Description
$_IPS['CONNECTION'] ChannelID of the connection
$_IPS['DATA'] Contains the pressed button when $_IPS['EVENT'] is DTMF
$_IPS['EVENT'] The variable can contain the following values:
Incoming: Incoming call
Connect: Established connection
Disconnect: Terminating connection
PlayFinish: Audio file has finished playing
DTMF: Received a DTMF sound

RegisterVariable

When the script was called by a RegisterVariable instance.

System Variable Description
$_IPS['INSTANCE'] ID of the triggering RegisterVariable instance
$_IPS['VALUE'] Value of the puffer that was received from the splitter or I/O module
$_IPS['CLIENTIP'] (only for I/O ServerSocket) Received IP adress of the Client
$_IPS['CLIENTPORT'] (only for I/O ServerSocket) Receiving port of the Client
$_IPS['TYPE'] Status of the receiving port (0 = Data; 1 = Connected; 2 = Disconnected)

RunScript

When the script was called by an IPS_RunScript function. In addition, IPS_RunScriptEx can be called to pass additional parameters. No additional system variables.

Shutdown

During IP-Symcon Shutdown (see EventControl).
No additional variables.

ShutterControl

When the script was called by a ShutterControl Module.

System Variable Description
$_IPS['DIRECTION'] Moving direction:
0 = Stop
1 = Up
2 = Down
$_IPS['DURATION'] Moving duration in milliseconds
$_IPS['INSTANCE'] InstanceID that was set in ShutterControl
$_IPS['INSTANCE2'] InstanceID #2 that was set in ShutterControl

Startup

During IP-Symcon Startup (see EventControl).
No additional system variables.

StatusEvent

When the script is called by a state change of an instance. Further informations are found at EventControl and IPS_GetInstance.

System Variable Description
$_IPS['INSTANCE'] InstanceID for state change
$_IPS['STATUS'] State of the instance. A list of possible values is found here: IPS_GetInstance
$_IPS['STATUSTEXT'] A short text according to the state

TimerEvent

When the script was called by a cyclic or a schedule event.

System Variable Description
$_IPS['ACTION'] ID of the calling action (only schedule event)
$_IPS['EVENT'] ID of the triggered event
$_IPS['TARGET'] ID of the superior object

Variable

When the script was called be a Variable Event ("triggered event").

System Variable Description
$_IPS['EVENT'] ID of the calling event
$_IPS['OLDCHANGED']
(as of Version 5.1)
Timestamp of the last change of the old value
$_IPS['OLDVALUE'] Value of the affected variable before switching
$_IPS['OLDUPDATED']
(as of Version 5.1)
Timestamp of the last update of the old value
$_IPS['TARGET'] ID of the superior object
$_IPS['TRIGGER'] Type of the calling event
$_IPS['VALUE'] Value of the affected variable when switching
$_IPS['VARIABLE'] ID of the affected variable

Watchdog

When the script is called by the Watchdog.

System Variable Description
$_IPS['STATUSTEXT'] The passed state text
$_IPS['VALUE'] Value of the variable that is outside of its interval
$_IPS['VARIABLE'] ID of the variable that is outside of its interval

WebFront

When the script was called by the WebFront.

System Variable Description
$_IPS['CONFIGURATOR'] ID of the currently used configurator
$_IPS['VALUE'] (only for action script) New value of the variable
$_IPS['VARIABLE'] (only for action script) ID of the changing variable

WebHook (since Version 4.0)

When the script was called by a WebHook.

System Variable Description
$_SERVER['HOOK'] Complete URL of the called WebHook
$_GET Received data via GET
$_POST Received data via POST

WebInterface

When the script was called by the Webserver.

System Variable Description
$_IPS['INSTANCE'] ID of the calling Webserver instance
$_SERVER['DOCUMENT_ROOT'] Contains the Document Root folder that contains the currently executed script as it is set within the configuration of the server.
$_SERVER['HTTP_ACCEPT'] Contains the content of the Accept: Header of the current request if one was sent
$_SERVER['HTTP_ACCEPT_CHARSET'] Contains the content of the Accept-Charset: Header of the current request if one was sent
$_SERVER['HTTP_ACCEPT_ENCODING'] Contains the content of the Accept-Encoding: Header of the current request if one was sent
$_SERVER['HTTP_ACCEPT_LANGUAGE'] Contains the content of the Accept-Language: Header of the current request if one was sent. Example: "en"
$_SERVER['HTTP_CACHE_CONTROL'] Is used to set options that are applied during all caching mechanisms during the Request/Answer chain
$_SERVER['HTTP_CONNECTION'] Contains the content of the Accept: Header of the current request if one was sent. Example: "Keep-Alive"
$_SERVER['HTTP_CONTENT_ENCODING'] Contains the type of the used content encoding
$_SERVER['HTTP_COOKIE'] Contains an HTTPS cookie that was previously set by the server
$_SERVER['HTTP_DATE'] Contains the time point of sending
$_SERVER['HTTP_EXPIRES'] Contains the date when the file is considered as expired
$_SERVER['HTTP_HOST'] Contains the content of the Accept-Charset: Header of the current request if one was sent
$_SERVER['HTTP_USER_AGENT'] The User Agent string of the client. It contains information about the client such that, for example, a script on the server can send content depending on different browsers
$_SERVER['PHP_AUTH_PW'] If HTTP authentication is used, this variable contains the password the user provided
$_SERVER['PHP_AUTH_USER'] If HTTP authentication is used, this variables contains the user name the user provided
$_SERVER['PHP_SELF'] File/Path of the started script
$_SERVER['QUERY_STRING'] If available, the query string that was used to access the website
$_SERVER['REMOTE_ADDR'] The IP adress that the user used to access the website
$_SERVER['REQUEST_METHOD'] Contains the request method that was used for the access, e.g., "GET", "HEAD", "POST", or "PUT"
$_SERVER['REQUEST_URI'] The URI that was used to access the current website, e.g., "/index.html"
$_SERVER['SCRIPT_NAME'] Contains the path of the current script. This can be useful for websites that link to themselves

VoiceControl

System Variable Description
$_IPS['VALUE'] The triggered value - for scenes, this value states whether the scene was activated (true) or deactivated (false)
Deutsche Webseite verfügbar
Go to cart
Any questions?