Skip to main content

Permissions Matrix Reference

Most of the time you don't read this page — you build a role on the Roles page, pick levels from the on-screen controls, and Aeon enforces them. This is the reference you reach for when you're designing a role and need to know exactly what each switch controls: what "Edit" gives someone that "View" doesn't, which part of the Customization Manager a configuration group unlocks, or which fields a default field group hides.

Everything a role can grant lives in three layers. The first two are what you set on a role; the third is a separate restriction layer. The tables below are the authoritative list of every value in each layer.

When you'll use this
  • You're creating or editing a role and want to confirm what a given level actually permits before you save it.
  • A staff member can (or can't) do something and you're tracing which capability and level is responsible.
  • You're planning a least-privilege role and need the full menu of categories and groups to choose from.
The three layers at a glance
LayerWhat it controlsHow you set itWhere you see it
Operational capabilitiesWhat the role can do in the main workspace (requests, users, billing, …)A level per category: None / View / Edit / FullRole editor → Operational tab
Configuration capabilitiesWhich sections of the Customization Manager the role can openAn on/off toggle per groupRole editor → Configuration tab
Field restrictionsWhich sensitive fields are hidden from the roleField groups assigned to the roleRole editor → Field Restrictions tab

Access levels

Operational capabilities use four levels. They are cumulative and ordered — each level includes everything the levels below it allow, so granting Full also grants View and Edit, and granting Edit also grants View.

LevelMeaning
NoneNo access. The feature is hidden or disabled for the role.
ViewRead-only. The role can open and read records in the category but cannot change them.
EditView, plus the ability to create and modify records — including locking a record for editing.
FullEdit, plus the higher-impact actions in the category (for example, deleting, or other privileged operations).
How the level is checked

Aeon compares the role's level against the level a feature requires, using the order None < View < Edit < Full. A feature that requires Edit is available to anyone at Edit or Full; a feature that requires View is available at View, Edit, or Full. This is why you only ever pick one level per category — the higher levels automatically cover the lower ones.

Operational capabilities

These ten categories appear as rows on the role editor's Operational tab, each with a None / View / Edit / Full selector. The tab is introduced on screen as "Control what this role can do in the main workspace."

The role editor's Operational tab showing the None, View, Edit, and Full grid for the ten operational categories

Category (on-screen label)Governs
RequestsOpening, editing, routing, cloning, merging, cancelling, and otherwise processing requests. Edit is the level required to lock a request for editing.
UsersViewing and editing patron (user) records, clearance, notes, proxies, and related user actions.
ActivitiesViewing and editing activities, their members, attendance, and activity requests.
AppointmentsViewing, creating, editing, confirming, and cancelling reading-room appointments.
Reading RoomSigning patrons in and out, marking them away, and assigning seating and locations.
EmailComposing and sending email, and working with the outgoing email queue (pending and failed).
Batch ProcessingRunning batch / bulk workflow processes across multiple requests.
BillingViewing and editing charges, payments, invoices, and billing accounts on requests and users.
Web AlertsViewing, creating, editing, and deleting web alerts.
Reports & ExportExporting data — for example, exporting the results of a bulk selection or a custom search. (The category is labeled Reports & Export, but in the current release it controls the export actions.)
note
Categories gate operations, not field-level visibility

A category level controls whether a role can perform an action — for example, whether someone can edit a user record at all. It does not, on its own, hide individual fields within a record the role can see. Hiding specific sensitive fields is the job of field restrictions (below).

Configuration capabilities

These ten groups appear as checkboxes on the role editor's Configuration tab, introduced on screen as "Control which sections of the Customization Manager this role can access." Each is a simple on/off toggle — there are no View/Edit/Full levels for configuration. A role with a group off does not see that part of the Customization Manager at all.

The role editor's Configuration tab showing the ten configuration-capability checkboxes with their descriptions

The label and one-line description below are exactly what appears beside each checkbox.

Group (on-screen label)On-screen description
Data & FieldsCustom fields, lookup tables, and field definitions
DesignersCard, form, and print template designers
WorkflowQueues, routing rules, and cancellation reasons
Web InterfaceFlags, alerts, and web interface settings
IntegrationsAddons, Z39.50, and external integrations
OperationsSites, site groups, reading rooms, and system settings
BillingBilling defaults, accounts, and service packages
StaffStaff user management
Roles & PermissionsRole definitions, field groups, and staff role assignments
ImplementationGuided implementation wizard for new and existing sites
Roles & Permissions is the one that can lock you out

The Roles & Permissions group is what lets a role open this very area — roles, field groups, and staff role assignments. Removing it from your own role is the one change that can shut you out of permissions management entirely. If you try, the editor warns you on the spot: "You are removing Roles & Permissions access from your own role. If saved, you will be locked out of this settings page." Aeon also refuses to leave the system with no administrator at all. See Protecting Against Lockout: One-Admin Minimum for the full rules.

Field restrictions

Field restrictions are the third layer. Instead of controlling actions, they hide specific fields from a role even on records the role is otherwise allowed to open. You apply them by assigning one or more field groups to a role on the Field Restrictions tab. A field group is just a named bundle of columns (for example, a patron's government ID fields). Assign the group to a role, and those fields are hidden for everyone in that role.

Aeon includes three system-default field groups. These can't be deleted, but you can edit them, assign them to any role, and create your own custom groups alongside them.

The role editor's Field Restrictions tab showing the field groups available to restrict, including the three system-default groups

System-default field groupWhat it hides
Personal IdentifiersGovernment IDs and date of birth (the user's ID, alternate ID, their types, and date of birth).
Contact InformationPhone numbers, fax, and physical addresses (mailing and shipping address fields).
FinancialBilling amounts, payment details, and invoice information (max cost, account/invoice numbers, base/unit fees and tax rate, and payment method, reference, amount, and authorization code).
Field restrictions only reach restrictable data

Field groups can only target fields Aeon has marked as restrictable — currently patron data and billing and payment data. You can't, for example, hide a request's call number with a field group. For how to build and assign your own groups, see Field Restriction Groups and Creating a Custom Field Restriction Group.

The two built-in roles

Every Aeon site starts with two system-default roles. They mark the two ends of the spectrum and can't be deleted, which makes them a useful reference point when you're deciding what a custom role should grant.

RoleOperational capabilitiesConfiguration capabilitiesField restrictions
AdministratorEvery category at FullEvery group onNone
StaffEvery category at FullEvery group offNone

In other words, the only difference between the two built-in roles is configuration access: Staff can do everything in the day-to-day workspace but can't open the Customization Manager, while Administrator adds full configuration access on top. A custom role is simply a different mix — lower some operational levels, turn on only the configuration groups a person needs, and add field restrictions where data should be hidden. See System Default Roles: Administrator and Staff for more on when to use each.