Specifications

Load actionPlug-in typePassword
Loads the plug-in with the
following changes:
Third-partyValid scripted plug-in password
but not one of the built-in
passwords
• Always puts it in the custom
section
• If the plug-in requested a
section other than custom
or if its name clashes with
a built-in tool or
configurator, adds an
underscore in front of its
name
Loads the plug-in in the
requested section
Built-inOne of the built-in passwords
Creating a scripted plug-in
Introduction
A scripted plug-in is a regular script package that has been saved with a special password and
is placed in the appropriate folder, so that it can be located and loaded by Switch. Once
successfully loaded, the scripted plug-in's icon appears in the Elements pane and it can be used
just like any other built-in tool or configurator.
The scripting API offers several entry points, properties and functions to support optional features
that are specific to scripted plug-ins (for example, centralized management of the path to a
third-party application). Since none of these features are required, a regular script package can
be turned into a scripted plug-in in a matter of seconds.
Furthermore, all scripted plug-in features can be developed and tested using SwitchScripter. The
only thing which cannot be done without an appropriate password is loading the scripted plug-in
in the Switch Elements pane.
Password
Enfocus may license selected third-party vendors to develop scripted plug-ins; see Obtaining
permission on page 344. In most cases, users have to submit their (unprotected) script package
to Enfocus for code review and quality assurance. Upon approval, Enfocus saves the scripted
plug-in with the appropriate password.
If users have been handed a scripted plug-in password (and signed the required licensing
agreement), they can create a scripted plug-in by entering the password in the main script
properties in SwitchScripter Declaration pane.
Location
A scripted plug-in must be located in the special “scripted-plugins” folder located near the
Switch Server executable. Each plug-in consists of a folder (inside the “scripted-plugins” folder)
that contains a single script package (with the filename extension .sscript) and any additional
resources used by the scripted plug-in.
Scripted plugins created by anyone other than Enfocus must be located in a folder called
"third-party-plugins" located next to the regular “scripted-plugins” folder. After a fresh install
this folder is empty.
345
Enfocus Switch 10