Admin Center and Settings App
On this page
Alloy Navigator has two applications for administrators: the Admin Center and the Settings App. Both work on the same Alloy Navigator database and cover the same top-level subjects. The Settings App provides low-level authoring tools, while the Admin Center also configures the web-hosted applications.
For the other applications of Alloy Navigator and the people who use them, see About Alloy Navigator.
What each application is for
| Admin Center | Settings App | |
|---|---|---|
| What it is | The browser-based administration application. It is installed as part of the Web App, not as a separate package. | A Windows application, installed with the Administrative Tools. On a computer where it is installed, the Alloy Control Panel lists it in the product's group of tools. |
| What it is for | Configuring the web-hosted applications (the Web App, the Self Service Portal, and the API) and the day-to-day administrative tasks that a technician performs from a browser. | Low-level authoring of the workflow and the data model, at the level of objects and expressions. |
| How it is organized | A navigation menu of sections. The top bar carries, from left to right, the branding logo (the Alloy logo when no branding image is set), the Admin Center title, a navigation search box, the current page's own toolbar, the export and import menu for the configuration, and the context help button for the current page. See Work in the Admin Center. | One window titled Settings: a navigation bar of collapsible groups on the left and the selected page on the right. See Work in the Settings App. |
The Settings App's navigation bar has nine groups:
| 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, Web App view forms, shared snippets, 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 areas of the workflow and business logic. See Workflow Overview. |
| Notifications | Global Settings, Notification Queue, Logs, E-mail Notifications (Settings and HTML Templates), and Push Notifications (Settings). See Notifications Overview. |
| 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. See Logs. |
To find where a particular setting lives in each application, see Settings Map.
Exporting and importing the configuration
Both applications export and import the configuration, but only the Settings App exports part of it:
- In the Admin Center, the export and import menu of the top bar is available on every page and holds Download (the last export), Export Settings, and Import Settings. The Export Settings window has only a File name, a Description, and a Complete pack check box, and it always exports the whole configuration. Import Settings asks for one XML file and imports it as a whole.
- In the Settings App, File > Export and Import holds Export Selected Settings…, which exports the node selected in the navigation tree or the record selected in a list, Export All Settings…, and Import Settings…. When an import replaces the existing workflow, the Settings App shows a Backup group: with Enable backup selected, it saves the current configuration to the location in Back up to: before replacing it.
To export only some classes, sections, or records, use the Settings App. Both applications import a complete workflow pack. For the procedures, see Export and Import Configuration.
Where a setting lives
The split between the two applications follows one rule:
- A setting belongs to the Admin Center when it configures a web-hosted application (the Web App, the Self Service Portal, or the API), or when it is a day-to-day administrative task that a technician performs from a browser.
- A setting belongs to the Settings App when it edits the workflow or the data model at the level of objects and expressions.
Where both applications expose a setting, they edit one stored value.
Where both applications have a setting
For some settings that both applications show, one of them lacks a part. Where the Admin Center lacks a part, its page usually says so in place: "This feature is not yet available in the Admin Center. Please use the desktop Settings App."
| Setting | Part missing in | What the Admin Center has | What the Settings App has |
|---|---|---|---|
| General > Fields and the Fields of an object class | Admin Center | The field form, without a usage view. | The Field Properties dialog, whose Usage tab lists the views that use the field ("This field is being used in following Views:"). |
| Mail Connector > Settings | Admin Center | The Mail Connector settings form. Server Type also lists POP3, EWS, and MAPI, but choosing one of them shows only the warning, and the form loses its other tabs and OK. The client choice Alloy Mail Connector (admin consent required) is disabled with the same text. | The Mail Connector dialog, which configures all three server types. |
| Mail Connector > Processing | Admin Center | The Operations tree is display-only, with the text "The current logic is displayed for informational purposes only and can be configured using a dedicated desktop Settings application." The Unmatched sender workflow, Email attachment, Incoming email handling, and End of session options stay editable. | The configuration of the processing logic. |
| E-mail Notifications > Settings | Admin Center | Forms for SMTP, Exchange Online with OAuth, and Google Mail. Choose e-mail service also lists EWS and MAPI, but choosing either shows only the warning, with no Test Settings. | The connectivity page, which configures EWS and MAPI. |
| Scheduled Tasks | Admin Center | The task form, whose Programming heading holds only a variant of the warning. | The task dialog, with a Programming page. |
| Automation Server > Job List | Admin Center | Every job opens from the list, but Trigger On Condition, Recurrent Ticket, and Archiving jobs have no form: they open a drawer that holds only the Scheduled Tasks variant of the warning and Close. | The event editor of the trigger, and the property dialogs of Recurrent Ticket and Archiving jobs. |
| AI Configuration | Settings App | Vector indexing progress: Last run, Status, Indexed as processed / total (percent), Free space, and the Database path. | The embedding switch and the model, with no progress display. |
| Classification icons of an object class | Settings App | Icon upload that accepts PNG, JPEG, BMP, SVG, and ICO files. | An image picker that loads BMP, ICO, and PNG files only. |
Pages only one application has
Only in the Admin Center
| Admin Center page | What it configures |
|---|---|
| Apps and Portals | Per-instance configuration of the Web App, Self Service Portal, and API instances. |
| Services > Microsoft 365 Integration | The Microsoft 365 registration. See Microsoft 365 Integration. |
| Services > Calendar Sharing | Web-hosted calendar publishing. |
| Workflow > Tag Management | The catalog of tags. |
| Logs > SSP AI Assistant | The log of the Self Service Portal's AI assistant. |
| General > Preview | The preview configuration of each object class. The Settings App's CSS Styles > Preview Pane styles the preview; it does not configure it. |
| Workflow > object class > Form Layouts | The form layouts of an object class. None of the Settings App's pages for an object class edits a form layout. |
Only in the Settings App
| Settings App node | What it holds |
|---|---|
| General > Upgrade and Migration | Maintenance. |
| General > Shared Snippets | Authoring of shared snippets. |
| General > Shared Views | Shared views. The node appears only when the database is set to use the legacy views. |
| General > Dashboard Management > Widgets | Widgets. The node appears only when the database still holds legacy widget types. |
| Workflow > Advanced > Configuration Parameters | Configuration parameters. |
| Workflow > Global Components | Functions and e-mail notifications, for workflow authoring. |
| Services > Archiving | Archiving. Archiving is configured only in the Settings App; the Admin Center shows archive logs in its Logs section. In Alloy Navigator Cloud, and when the database runs on Azure SQL, the Settings App does not show the node, and neither application offers the archiving configuration. In Alloy Navigator Cloud, the Admin Center also hides the archive logs; see Administering Alloy Navigator Cloud. |
| Self Service Portal > Workflow | Authoring of the portal workflow. |
| All Configuration Items > Options | The Related CI template, which formats the Related CI field of tickets. See Set the Related CI format. |
| Persons > Options | The Full Name template and the Address template of person records. See Set the person name and address templates. |
| Services > Automation Server > High Availability Mode | The high availability mode of the Automation Server. In Alloy Navigator Cloud, the Settings App does not show the node; see Administering Alloy Navigator Cloud. |
Who may open each application
Admin Center
To open the Admin Center, your account must hold the Basic administrative access permission. Alloy Navigator checks this permission for each web session and keeps the result for 60 minutes, so a change to your roles does not open or close the Admin Center entry for you immediately. For how you open the Admin Center from the Web App, see Work in the Admin Center.
The Form Layouts entry of an object class needs a further permission. See Security Roles and Permissions Reference.
Settings App
For the permission you need to sign in to the Settings App, see Work in the Settings App.
What you see in the Settings App depends on conditions such as these:
- Your administrative permissions. Each group of the navigation bar is tied to an administrative permission, and a node you have no permission for is hidden. When you have permission for a node deeper in the tree, the nodes above it are shown. The Notifications and E-mail Processing groups are tied to the same permission.
- Your license. Nodes that belong to a license module your license does not include are not shown, together with the nodes under them.
- The deployment and the database. Some nodes appear only in certain deployments or database states, as the table above notes.
The navigation tree is built when the Settings App starts. If you start it without a valid license and then save one, the tree is rebuilt.