Skip to content

Provision a new staff user account

As a Super User, I want to create a login for a new staff member with the right Security Role and Fund, so that they can access exactly the parts of PRIZM their job requires — no more, no less — from their first day.

Screen: Sidebar > MAINTENANCE > Administration > Users > Add User

Steps

  1. Open MAINTENANCE > Administration > Users. This grid lists every PRIZM login (74 in the UAT environment) with User Name, User Type, Email Address, Mobile Device #, Creation date, Last Login, and Locked status, plus per-row Reset Password/Retrieve Password actions.
  2. Click Add User.

    Add User button on Maintenance > Administration > Users

  3. Fill in the form. It has no first/last name fields at all — just:

    • Username
    • Email Address
    • Password / Password Confirmation
    • Contractor (checkbox — leave unset unless this login represents a contractor)
    • Locked Out User (checkbox — leave unchecked for a new account; this is the same checkbox you'll come back to uncheck if the account ever trips PRIZM's lockout policy)
    • a "Choose a Member" link, if this login should be tied to an existing Member record
    • Security Role (dropdown — what the person can do, see below)
    • Fund (dropdown — what data the person can see, see below)
    • Business Agent (leave unset unless this login specifically represents one)
  4. Pick Security Role from its exact dropdown values: Accounting, BusinessAgent, Contract, ETFStaff, HWStaff, Management, MembershipStaff, SuperUser. This should match the job the person is actually doing — it's the role the signed Roles & Security Matrix grants Add/Update/View Only permissions to, module by module.
  5. Pick Fund from its dropdown values: All, ETF, H&W, Union. This is a separate axis from Security Role (BLR Common 1.16 "Fund Based Security") — it gates which fund's data (dependents, beneficiaries, Member+ values, notes, invoices/remittances) the account can see at all, before Security Role further limits what they can do with it. A role that genuinely spans every fund (Management, Accounting, Contract) gets All; a fund-specific staff role (H&W Staff → H&W, ETF Staff → ETF) gets that one fund; most line-of-business roles (Business Agent, Membership Staff) get Union.
  6. Submit the form.

Things to watch out for

Password policy: 7–50 characters, one digit, one special character

PRIZM rejects an otherwise-strong password if it's all-alphanumeric — the form's own error message on a rejected submit is: "Password must be between 7 to 50 characters which contain at least one numeric digit and a special character e.g. @ or #." There's no other warning before you submit, so build this into the password you choose rather than discovering it on a failed Add User attempt.

Fund = All is an account-level value only

All only ever appears in the Add User form's Fund dropdown — the session header's own "Fund:" selector (which an All-fund account uses to switch between Union/H&W/ETF while logged in) never offers All as a choice itself. If you're trying to find an All option somewhere inside a live session and can't, that's expected — it's a setup-time value, not a session-time one.

A locked-out account needs this same screen to unlock, not a password reset alone

If a staff member's account trips PRIZM's own lockout policy (repeated failed logins), fix it here by unchecking Locked Out User and submitting — a password reset alone doesn't clear the lockout flag.

Leave optional fields unset for a narrowly-scoped account

Business Agent / Contractor / Member-link only need values if this specific login represents that thing. A general-purpose staff account doesn't need any of them filled in just to exercise its Security Role/Fund combination correctly.

See also Manage a member's security roles for the related but distinct Members > Roles tab (a member-held role, not a system login).