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.
Move between pages and search
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.
- Choose Search in Workflow.
- In Text to find:, type the text, and then click Find.
- 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.
- In a Settings App grid, right-click a record and choose Customize View....
- Change the settings on the tabs of the Customize View dialog, described below.
- 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). |