User Guide

How to create a custom tool

This guide shows you how to add a custom Tool to your site's catalog so that operators can launch it against a device from the device form, alongside the built-in entries.

Prerequisites

  • You sign in with the Administrator role on the current site. Custom-tool authoring is not exposed to the User role.
  • The local executable, script, or client that the custom tool will invoke is installed on the workstations of the operators who will use it. Custom tools run on the operator's workstation, not on the AlloyScan server and not on the target device.
  • The Alloy Integration Launcher is installed on each operator workstation.

Steps

  1. Open Admin Center > Site Settings > Customization > Tools.
  2. Click + New tool.

  3. Fill out the tool definition.

    • Caption — the label shown to operators in the device form's Tools menu.
    • Run — the command the Alloy Integration Launcher runs on the operator workstation. Use the placeholder picker to insert dynamic device values, such as %[AD.IP_ADDRESS]%, %[AD.NAME]%, or %[AD.INFO_MAC]%.
    • Display PowerShell window — shows the PowerShell window when the tool runs.

    Note: Global administrators can change the built-in tools available to new sites through the Site template.

  4. Save the tool. It now appears in the site's Tools catalog at Admin Center > Site Settings > Customization > Tools and is offered in the device form's Tools menu.

  5. (Optional) Use the per-tool overflow menu in the catalog to Edit, Duplicate, or Delete the tool definition later.

Verify

After saving, you should see:

  • The new tool in the catalog grid at Admin Center > Site Settings > Customization > Tools, with its Name visible.
  • The new tool listed in the Tools menu of a device form.

To smoke-test it, follow How to use a tool on a device and pick the new tool. The Launcher should start the matching local executable with the substituted device attributes.