Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Server Addon tab in the customization manager facilitates the installation and management of custom Server Addon scripts that you can create to perform certain processes automatically without staff intervention, such as routing items and adding or removing flags. Unlike system and form addons, which run on the client, server addons run in the system manager. They are stored in the ServerAddons database table instead of the file system and configured from within the customization manager.

...

Note

This server addon functionality is available in versions 8.7 and higher.

Server Addons in the Customization Manager

Server Addons are administered within the Customization Manager from the Server Addons Tab. The following functions are available from the Server Addons ribbon:

  • New: Opens a File Open dialog to upload a new Addon package (zip file).
  • Update: Works the same as the New button but will update the currently selected addon with a new version.
  • Export: Exports an addon with the default package settings.
  • Save: This button is enabled when pending changes exist.
  • Delete: This will remove the currently selected addon. This cannot be undone. The next time the system manager addon interval kicks off, this addon will stop executing.
  • Cancel: If there are any pending changes, they will be canceled and will return to the currently saved state of the addon.
  • Reset Settings: This will reset any customized settings back to the package defaults. The save button will need to be clicked to save the reset settings back to the database.

Installing a New Addon

Server Addons are installed and affect ALL sites and will display to ALL sites, no matter the site selected at installation.
DSP Addons are installed the same way but affect ONLY the site selected.

  1. Save the Addon .zip folder in an accessible location. This folder may have been downloaded from the ILLiad Addon Directory or created for you by Atlas or a local software developer.
  2.  Click the New button in the Server Addons ribbon of the ILLiad Customization Manager.
  3. A dialog window will open with a prompt to select a file to upload. Navigate to the Addon .zip folder and upload by clicking on the Open button.
  4. The Addon will be inactive by default. Activate the Addon with the Yes option in the lower-left window.
  5. Edit values as necessary in the lower right window.
  6. Save changes with the Save option in the Server Addons ribbon.

The name of the Addon can be modified in the editing window on the lower left. This will not save to the underlying config.xml but can be modified to create an alias for a particular addon when viewing it in the Customization Manager.

Editing Server Addons

 To edit the values in a server Addon:

...

The Reset Settings will restore only the changes in the Values column to the default settings when Addon was initially installed.

Updating A Server Addon

  1. When a new version of an Addon is available, select the Update button.
  2.  A dialog prompt will allow you to select the new version to load.
  3. The new version will now display.

...

  1. Copy the config and save as config.xml.
  2. Save the lua as an actual lua file.
  3. Ensure all lua files are referenced in the Files element of the config.xml as shown here: <Files> <File>TwilioSMSNotifications.lua</File> </Files>

  4. Zip both the the config.xml and the code file(s).

Exporting an Addon

 Users may choose to export an Addon with the default settings. The default file name will be the Addon name with a zip extension. The initial directory is set as the last directory used when uploading or exporting an Addon. If the user has never uploaded/exported an Addon, it is set to the base path of the Customization Manager. The last used directory is saved as in user settings for the Customization Manager so it will be specific to each windows profile user.

...