Administration Guide

Work in the Settings App

On this page

Start the Settings App and use its navigation and search tools to find the manager you need. For how it relates to the Admin Center, see Admin Center and Settings App. For where each setting lives, see Settings Map.

In the Settings App

Before you begin

  • To sign in to the Settings App, your account needs the Basic Administrative Access permission. Without it, the Settings App refuses with the message You do not have enough permissions to use this function. Under automatic sign-in, it asks for another sign-in instead.
  • A node of the navigation tree can also need its own administrative permission; see What hides a node. Your administrative permissions come from the security roles your account belongs to; see Security Roles and Permissions Reference.

Start the Settings App

You can start the Settings App in any of these ways:

  • From the Start menu. In the Alloy Navigator server package, the shortcut is Programs > Alloy Software > Alloy Navigator 2026 > Tools > Settings. In the Alloy Navigator Administrative Tools package, the middle folder is Alloy Navigator instead of Alloy Navigator 2026.
  • From the Alloy Control Panel. The Alloy Control Panel installs with every package, with a Start-menu shortcut and a desktop shortcut. It lists the Settings App in the product's settings group, with a caption taken from "Alloy Administrative Settings Console" with the product and role words removed. Clicking the item opens the Settings App the same way the Start-menu shortcut does.
  • From the command line, with the options in Command-line options.
  • From another tool that hands off to it, as listed below.
Tool When it opens the Settings App How
DB Wizard On closing from its finish page, when the database is not yet activated or was just version-upgraded Opens the Settings App, optionally signed in automatically
Import Wizard At login, when the database holds no license and you agree to run the activator Opens the Settings App
One-Click Installer During first-run setup Opens the Settings App in activation-only mode

Each of these tools activates the running Settings App if there is one, or starts a new one.

Only one interactive Settings App runs at a time. If you start it while it is already running, the running window is activated and the new start exits.

Command-line options

Options take the form /NAME or /NAME=value. The option name is matched case-insensitively. A bare switch counts as present, and a value must follow = immediately.

Option Effect
/CONNECTION= Selects a stored connection, by GUID or by name.
/SQLSERVER= Overrides the connection's SQL Server.
/DATABASENAME= Overrides the connection's database.
/WINAUTH= YES or TRUE selects Windows authentication; any other value selects standard authentication.
/USERNAME= (alias /USER=) The login name for standard authentication.
/PASSWORD= The password for standard authentication. The value is decrypted when it is read, so this option does not expect a plaintext password.
/ACCESSKEY= Names the Database Access Key to read from the registry. Combined with an identity, it also forces automatic sign-in.
/AUTOLOGIN Skips the Log in window.
/import-config= Imports a configuration file with no window shown.

/import-config="<file>" runs the import before any window is created. It requires /AUTOLOGIN, /ACCESSKEY=, and either /WINAUTH or /USERNAME=, and it shows no progress window. Add /overwrite to switch the import to complete mode. Errors are written to cli_import_config.log in the program log folder. The exit code tells you the outcome:

Exit code Meaning
0 Success
1 Insufficient parameters
2 File not found
5 SQL connection failure
11 Invalid configuration file
12 Import failure

The main window

The window caption is Settings. On the left, a navigation bar of collapsible groups holds the tree; on the right is the selected manager, with a section title above it. For a node that opens no manager, such as the root of a tree, the right side shows a list of the node's child nodes instead. A splitter separates the two.

The status bar reads Connected to <server>:<database> as <login> (<full name>) and shows an Automation Server indicator that refreshes every 60 seconds. If the Automation Server service is not running at start-up, the Settings App shows a warning.

The tree is built at start-up. It is built again only when a session that started without a valid license saves one.

The navigation tree

The navigation bar has nine groups, in this order:

Group What it holds
General The administrative dashboard, workspaces, object identifiers, the relationship map, work calendars, report settings, system performance, License Management, regional settings and currencies, upgrade and migration, CSS styles, fields, shared views, the Web App view forms, shared snippets, and help and documentation
Users & Security Accounts, roles, applications, user sessions, the password policy, and SSO providers
AI Integration AI configuration and AI actions
Workflow and Business Logic Twelve business areas, listed below
Notifications Global Settings, Notification Queue, Logs, E-mail Notifications (with Settings and HTML Templates), and Push Notifications (with Settings)
E-mail Processing The Mail Connector, the MessageID tag, preprocessing, parsing, and logs
Self Service Portal Self-Registration, Workflow, and E-mail Templates
Services Active Directory integration, Alloy Discovery integration, AlloyScan, archiving, scheduled reports, scheduled tasks, the Automation Server, and mobile applications
Logs The log browsers, listed below

Workflow and Business Logic is organized by business area, not by kind of workflow item, and shows its areas as one flat list rather than as separate groups. The areas, in order, are Workflow Configuration, Macros, Global Components, Service Desk, Service Management, Project Management, Asset Management, Purchasing, Configuration Management, Software Asset Management, Organization Management, and Advanced.

  • Service Management requires the SLA license module, and Project Management the request and change license module.
  • Asset Management, Purchasing, Configuration Management, and Software Asset Management require the asset and CMDB license module.
  • Advanced holds Configuration Parameters, Processes, and System Macros.
  • Global Components holds Functions and E-mail Notifications.

A node of an object class carries up to six children, always in this order: Fields, Shared Views, View Form (Web App), Macros, Classification, and Workflow. The captions are the same everywhere they appear. Shared Views appears only when the database uses the old views option. Some classes carry a different set:

Class Children
Persons The full set, plus an Options node
All Configuration Items Fields, Shared Views, Macros, then Options
All Tickets, My Tickets Fields, Shared Views, and Macros only
Software Catalog Fields and Shared Views only
Stock Rooms Fields, Shared Views, Classification, then a Workflow node served by the toolbar-actions editor instead of the workflow editor
Approval Stages, Vendor Products The full set except Shared Views

A class's Workflow node opens the workflow manager. Its own tree gives each class Actions, Triggers, and Components. Components holds Templates, Forms, Functions, E-mail Notifications, and Push Notifications. Global Components > E-mail Notifications opens the e-mail notifications of the global workflow. Services > Scheduled Tasks holds only Tasks and Logs; no node lists notifications for scheduled tasks.

The Logs group lists these browsers, in this order: AD Synchronization, Archiving, Deleted Objects, Discovery Synchronization, AlloyScan, Incoming Mail, On Condition Triggers, Outgoing Notifications, Recurrent Tickets, Reporting, Scheduled Tasks, User Sessions, SSP Search, and Workflow. Then All Errors holds Error Log and Alerts; Alerts needs a separate right from Error Log.

What hides a node

  • License module. A node whose license module is not licensed is left out of the tree together with everything under it.
  • Administrative right. A node whose administrative right you do not hold is hidden. If you hold the right for a node below it, the hidden nodes above that node become visible again. A node that carries no administrative right, such as Administrative Dashboard, always shows. Workspaces and License Management under General, and Users & Security with every node under it, all carry the Security Management right, so that one right shows all of them. Jumps to a node from the Administrative Dashboard and from the Self Service Portal manager that lists E-mail Templates test your administrative right for that node; if you do not hold the right, they refuse with the message You do not have enough permissions to view this item.
  • Deployment. In Alloy Navigator Cloud, the Services > Archiving branch, with everything under it, and Services > Automation Server > High Availability Mode do not appear, and General > Help and Documentation is present but read-only. The Archiving branch also does not appear on Azure SQL. See Administering Alloy Navigator Cloud.
  • Database state. Some nodes are added only when a database option or the database's data calls for them, such as the Shared Views node above.
  • Invoice Items. Unless the workflow parameter for Invoice Items processing enables Invoice Items, the Settings App removes the Invoice Item class from its object list, so the class appears nowhere in the Settings App.

The toolbar carries Back and Forward buttons. Each is a drop-down of up to 20 recent pages. If you go back and then open a different node, the pages ahead of the current position are discarded.

Go To… opens a dialog that takes a workflow item number. Its box is a drop-down of recently opened item numbers, with its first entry selected when the dialog opens.

The Search menu offers Find, Find Next, Search in Workflow, and Go To…. Find Previous is available only as a shortcut, not as a menu item.

These main-window actions have keyboard shortcuts:

Shortcut Action
Ctrl+S Save
F5 Refresh
Ctrl+G Go To...
Ctrl+F Find...
F3 Find Next
Ctrl+F3 Find Previous
Ctrl+I Invert Selection (inverts the selection of the focused control)

Search in Workflow, Exit, and the export commands have no shortcut. For shortcuts in other applications, see Keyboard Shortcuts.

Move between records in an edit form

A record's edit form in the Settings App shows Next Item and Previous Item only when you open the record from a view, and First Item and Last Item are available with them. Ctrl+> runs Next Item and Ctrl+< runs Previous Item.

Attachments on an action form

When an action's form in the Settings App has an attachment element, the element offers these commands:

  • Attach, a menu with Files..., Link..., and Open Attachment Browser....
  • Paste File, which adds files or a picture from the clipboard. A picture is saved as JPEG or BMP, and each pasted item is checked for size.
  • Open, Properties... (which opens Attachment Properties), and Delete.

None of these commands has a keyboard shortcut.

When the element includes files, you can also drop files onto its list panel, which reads Drop files here to add. A dropped link is not added. For attachments in the Web App, see Attachments.

Search in workflow

Search in Workflow is on the Standard toolbar and the Search menu. It is unavailable while the database has no valid license. It opens a window captioned Search in Workflow that lists every workflow item and component whose stored text contains the text you type. The search covers event, validation, and form-section conditions, field names and values, macro text, function groups, operation definitions, parameter defaults and mappings, e-mail headers, sections and bodies, HTML and Self Service Portal e-mail templates, Mail Connector options, System Log notification addresses, and preview pages. In many of these the text is also matched in its HTML-escaped form, and in HTML macros, e-mail bodies, templates, and preview pages only in that form.

  1. Choose Search in Workflow.
  2. In Text to find:, type the text, and then click Find.
  3. Select a result and click Open on the grid toolbar. The item's editor opens on the tab that the result's placement names.

The result grid also offers Filter by Selected Field and Filter Row. The window also has Close.

A condition on a lookup field stores the list item's key, not its caption, so search for the key. A virtual lookup whose key is empty stores its text instead. For most lists the key is a GUID; Person titles use the title and currency codes use the currency code. To get an item's GUID, open the class's Classification node, select the item, and choose Copy Item ID (GUID) to Clipboard on the shortcut menu, or press Ctrl+Alt+C. Then paste the GUID into Text to find:.

Customize a grid view

Grids in the Settings App have their own Customize View dialog. For customizing a view in the Web App, see Customize a View.

  1. In a Settings App grid, right-click a record and choose Customize View....
  2. Change the settings on the tabs of the Customize View dialog, described below.
  3. Click OK. The dialog also has Apply and Cancel.

The dialog has the tabs Fields, Advanced Filter, Grouping, Summary, Sorting, Conditional Formatting, and Options.

Tab Contents
Advanced Filter Shown only for a grid that uses the advanced filter or a chart filter.
Grouping Available Fields: and Group by These Fields:, with Add ->, <- Remove, << Remove All, Move Up, and Move Down.
Summary Available Fields: and Define Summary for These Fields:, with Add ->, <- Remove, and << Remove All.
Sorting Available Fields: and Sort by These Fields:.
Conditional Formatting A list of rules (Name, Condition, Sample, Enabled) with Add, Edit, Delete, Move Up, Move Down, and Copy. A rule opens Conditional Formatting Rule, with Name:, Enabled, Apply to (Row, First column, or Column:), Condition, and Apply Style.
Options A View group (Preview lines count [1-99, 0 - Unlimited]:, Column Auto Width, Row Auto Height, Show Grid Lines, Show Footer, Show Filter Row), a Grouping group (Group by Sorting, Group by Box, Hide Columns on Grouping, Group Date Columns in Outlook Style), and Show Group Footers (Never, When Expanded, Always).