Table of Contents


User Class Reference

The User class provides access to user account information and profile data within the Magentrix platform. This class is essential for working with user records, personalization, and access control in controllers and Active Classes.


Overview

The User class represents user accounts in the Magentrix platform. Each user has a single assigned Security Role that determines their permissions and access levels. The User class provides properties for profile information, localization settings, and organizational data.

Key Characteristics:

  • Single role per user (one RoleId assignment)
  • Support for custom fields through platform customization
  • Integration with Security Roles for permission control
  • Localization support (timezone, language, locale, currency)

User Properties Reference

Core Identity Properties

PropertyTypeRequiredDescription
IdstringYesUnique identifier for the user record
NamestringAutoFull name (auto-generated from Firstname + Lastname)
UsernamestringYesLogin username (unique across portal)
FirstnamestringYesUser's first name
LastnamestringYesUser's last name
EmailstringYesUser's email address (validated format)
AliasstringNoDisplay alias for privacy settings

Contact Information

PropertyTypeRequiredDescription
PhonestringNoPrimary phone number
MobilePhonestringNoMobile phone number
OrganizationstringNoOrganization name
TitlestringNoJob title
DepartmentstringNoDepartment name
DivisionstringNoDivision name
EmployeeNumberstringNoEmployee identifier

Address Properties

PropertyTypeRequiredDescription
StreetstringNoStreet address (multiline)
CitystringNoCity name
StatestringNoState or province
CountrystringNoCountry name
PostalCodestringNoZIP or postal code

Account Status

PropertyTypeRequiredDescription
IsActiveboolYesWhether user account is active (default: true)
AgreedToTermsboolNoWhether user accepted terms and conditions
DeactivationDateDateTimeNoDate when account was deactivated
LastLoginDateDateTimeAutoLast successful login timestamp (read-only)

Security and Roles

PropertyTypeRequiredDescription
RoleIdstringYesAssigned Security Role ID (single role per user)
RoleRoleAutoSecurity Role object (navigation property)
ManagerIdstringNoManager's User ID
ManagerPersonAutoManager object (navigation property)
FederationIdentifierstringNoSAML Federation identifier for SSO

Localization Settings

PropertyTypeRequiredDescription
TimezonestringNoUser's timezone (picklist value)
LanguagestringNoLanguage code (2-character, e.g., "en")
LocalestringNoLocale code (5-character, e.g., "en-US")
CurrencyIsoCodestringNoISO currency code (3-character, e.g., "USD")

Profile and Social

PropertyTypeRequiredDescription
DescriptionstringNoAbout me / bio (255 characters max)
PrivacySettingshortNoPrivacy level: Private (0) or Public (1)
ColorstringNoUser's assigned color for UI elements
PhotoUrlstringAutoProfile photo URL (read-only)
ThumbnailPhotoUrlstringAutoThumbnail photo URL (read-only)
CoverPhotoPathstringAutoCover photo path (read-only)

System Fields

PropertyTypeRequiredDescription
CreatedOnDateTimeAutoRecord creation timestamp
CreatedByIdstringAutoUser ID who created the record
ModifiedOnDateTimeAutoLast modification timestamp
ModifiedByIdstringAutoUser ID who last modified the record
OwnerIdstringAutoOwner ID (always the user themselves)

Related Topics