Skip to main content

Actr_Control (function reference)

By January 1, 2024January 25th, 2024Online Help, Troi Activator Plug-in
Activator Plug-in for FileMaker Pro


Controls the triggering of the plug-in. You can disable and enable local triggering of the plug-in. This allows you to change the contents of a field which is validated by triggering a script.

SyntaxFunction badge

Actr_Control ( switches ; password )


switches these determine how the function works. You can disable or enable all functions
password the password to be used


switches can be one of the following:

-DisableLocalTriggers disable triggering of scripts on this computer and also the scheduling of new triggers
-EnableLocalTriggers enable triggering of scripts on this computer and also the scheduling of new triggers
-GetLocalTriggerStatus get the status of the local triggering: 1 is on, 0 is off

Returned Result

Data type returned

Error code


The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be:

0 no error
$$-4217 pwdAlreadySet password already set (enable first)
$$-4218 alreadyEnabled functions are already enabled
$$-4219 pwdWrong given password was wrong

Other errors may be returned.

Originated in

Activator Plug-in 1.2


FileMaker Pro 17 to 2023


When you call Actr_ScheduleEvent when triggering is disabled an error code of $$-4220 is returned.

When you disable triggering, the scheduling of new local trigger events is also disabled until restart of FileMaker. Other users can still trigger scripts on their computer and you can also send a remote event to another computer.


Set Field [ result ; Actr_Control ( "-DisableLocalTriggers" ; "secret password" ) ]

This will disable the trigger functions of the plug-in on this computer.

Example 2

We assume that in your FileMaker file the following fields are defined:

gErrorCode		Global, number	
gPassword		Global, text

gPassword should contain a password, for example “rapunsel”. Add the following steps to a script:

Set Field [ gErrorCode ; Actr_Control ( "-DisableLocalTriggers" ; gPassword ) ]
#... do for example a Replace function  on a script validated function...
Replace Contents [ ValidateField ; newValue ]
Set Field [ gErrorCode ; Actr_Control ( "-EnableLocalTriggers" ; gPassword ) ]

This will first disable the plug-in’s triggers. Then you can change the values. The last step reactivates triggering.

Used in example file


Related functionFunction badge


Related topics

Activator Plug-in online help (overview)

Online Help Page for Activator Plug-in for 17 to 2023 –> Actr_Control (actrp4610) 2024-0125 14:41:13