Documentation
IPS_RunActionWait
string IPS_RunActionWait (string $ActionID, array $ActionParameters)
Parameters
| ActionID | ID of the executed action |
| ActionParameters | List of Parameters for the executed action |
Returns
Error message of the execution
Description
This function causes the execution of the Action with the ID ActionID and the parameters ActionParameters. The action is executed and waits for its end to return a possible error message. If the execution was without error, it returns an empty string.
The action parameters need to include the following entries:
| Parameter | Beschreibung |
|---|---|
| TARGET | ID of the target object of the action (-1 for general actions) |
| ENVIRONMENT | The execution environment of the action, see Environments |
| PARENT | ID of the object that executes the action, e.g. the PHP script or the Flow Script |
Example
// Execute the script with the ID 12345
$error = IPS_RunActionWait("{7938A5A2-0981-5FE0-BE6C-8AA610D654EB}", ["TARGET" => 12345, "ENVIRONMENT" => "Default", "PARENT" => $_IPS['SELF']]);
if ($error === "") {
echo "Action was executed succesfully";
}
else {
echo "There was an error during execution: " . $error;
}