Skip to main content

External users

An external user (ExternalUser) is a portal account linked to a contractor, a permission level, and assigned projects. It controls who can view documents, add them, or manage contractor users in Aspire-Contractor.

Navigation: Sidebar → Document Management → External users
Pages: /Entities/DMS/ExternalUser · /Entities/DMS/ExternalUser/new · /Entities/DMS/ExternalUser/{id}

What this screen does​

  • Creates contractor portal users with name and email
  • Sets permissionLevel
  • Links contractor and projects via ProjectPicker
  • Activates or deactivates the account (Active / isActive)

List and summary cards​

List columns​

ColumnMeaning
Full NameFull name
ContractorContractor
EmailEmail
PhonePhone
Assigned ProjectsAssigned projects
Permission LevelPermission level
StatusActive toggle
ActionsRow actions

Filters​

FilterUse
SearchFullName / Name / Email / Phone
ContractorContractor
PermissionLevelPermission level

Stats cards​

Total Users · Active Users · Contractor Admins · Contractor Projects

Fields​

FieldRequired?Use
fullNameYesFull name
emailYesEmail (portal login)
phoneNoPhone
permissionLevelYesSee table below (default: View Only)
Contractor—Linked contractor
Assigned Projects—Projects via ProjectPicker
isActive (Active)—Account active

permissionLevel values​

ValuePortal meaning
View OnlyRead documents and statuses
Add New DocumentView and submit new documents
AdminManage users, projects, and documents within the contractor scope

Legacy values accepted in some edit checks: upload and comment (case-insensitive match).

How to use the screen​

  1. Create the contractor and projects first
  2. Create the user with fullName and email
  3. Choose permissionLevel and contractor
  4. Set Assigned Projects from ProjectPicker
  5. Leave Active enabled for portal access

Best Practices​

Least privilege that still works

Start with View Only or Add New Document; reserve Admin for people who actually manage contractor users.

Only Admin manages users

Managing external users from the portal requires permissionLevel = Admin. Otherwise create/update of users is denied.

Assigned projects bound the scope

Without correct assigned projects, portal access to project documents narrows or breaks.