Role not found for user: required role missing

User lacks the specific role required by an ACL, UI action, or application module after recent role changes or new application installations. (high likelihood)

Role names were modified during a system upgrade or plugin update, breaking existing references in ACLs or scripted conditions. (high likelihood)

Custom application or scoped application references a role that was deleted or renamed without updating dependent configurations. (medium likelihood)

Role inheritance chain was broken due to changes in role hierarchy or contains_roles relationships in the sys_user_role table. (medium likelihood)

Hard-coded role names in business rules, client scripts, or ACL scripts reference non-existent roles due to typos or outdated references. (low likelihood)

Step 1: Navigate to System Diagnostics > Log > Application Log and search for the exact error message to identify which specific role and user are involved.

Step 2: Go to User Administration > Roles and search for the role name mentioned in the error to verify if the role exists in the sys_user_role table.

Step 3: If the role exists, navigate to User Administration > Users, find the affected user, and check their Roles tab to confirm the required role is assigned.

Step 4: If the role doesn't exist, search System Definition > Access Controls (ACLs) for references to the missing role name to identify which ACL is causing the error.

Step 5: Check System UI > UI Actions and System Definition > Modules for any conditions that reference the missing role using the Global Search functionality.

Step 6: Either assign the required role to the user, update the ACL/UI action/module to reference the correct role name, or create the missing role if it was accidentally deleted.

Step 7: Test the fix by impersonating the affected user or having them retry the action that originally triggered the error.

Step 8: Monitor the Application Log for 24 hours to ensure the error doesn't reoccur and validate that role assignments are working correctly.