Difference between revisions of "Role"

From docs
Jump to: navigation, search
(Notes)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
Path: [[Callproof Support]] - [[Website]] - [[Role]]
 +
 
= Role =
 
= Role =
 
Lets managers define role labels (for example Manager, Buyer, Decision Maker) used on people/personnel under Accounts when People Tab is on, and for Role filters on Contacts/Accounts search.
 
Lets managers define role labels (for example Manager, Buyer, Decision Maker) used on people/personnel under Accounts when People Tab is on, and for Role filters on Contacts/Accounts search.
Roles allow managers to define job titles or relationship labels (such as **Manager**, **Buyer**, or **Decision Maker**) that can be assigned to contact personnel.
+
Roles allow managers to define job titles or relationship labels (such as '''Manager''', '''Buyer''', or '''Decision Maker''') that can be assigned to contact personnel.
 
Assigned roles help organize personnel records and can also be used as search filters on the Contacts and Accounts pages.
 
Assigned roles help organize personnel records and can also be used as search filters on the Contacts and Accounts pages.
  
[[File:RoleIndex.png|250px|thumb|Roles Index View]]
+
[[File:RoleIndex.png|300px|thumb|Roles Index View]]
  
 
'''Navigation:''' '''Home''' → '''Settings & Customization''' → '''Role'''
 
'''Navigation:''' '''Home''' → '''Settings & Customization''' → '''Role'''
Line 10: Line 12:
 
'''Note:'''
 
'''Note:'''
  
* The **Role** menu appears only when the company has **People Tab** enabled.
+
* The '''Role''' menu appears only when the company has '''People Tab''' enabled.
* Role pages use the **Company Directory** sidebar.
+
* Role pages use the '''Company Directory''' sidebar.
 
* The menu is dynamically generated and is not part of the default `menuurl.sql`.
 
* The menu is dynamically generated and is not part of the default `menuurl.sql`.
  
Line 29: Line 31:
 
# Log in as a manager.
 
# Log in as a manager.
 
# Navigate to '''Home → Settings & Customization → Role'''.
 
# Navigate to '''Home → Settings & Customization → Role'''.
# The **Roles** page opens (`/role/`).
+
# The '''Roles''' page opens (`/role/`).
 
# Review the list of available roles.
 
# Review the list of available roles.
 
# Use the available actions to edit or delete roles.
 
# Use the available actions to edit or delete roles.
Line 38: Line 40:
  
 
{| style="border:0;"
 
{| style="border:0;"
| [[File:RoleAdd.png|250px|thumb|Click the Add Role(plus) icon]]
+
| [[File:RoleAdd.png|300px|thumb|Click the Add Role(plus) icon]]
| [[File:RoleAddView.png|250px|thumb|Add Role]]
+
| [[File:RoleAddView.png|300px|thumb|Add Role]]
 
|}
 
|}
  
 
</div>
 
</div>
# Open the **Roles** page.
+
# Open the '''Roles''' page.
 
# Click '''Add Role'''.
 
# Click '''Add Role'''.
 
# The Add Role page opens (`/role/new/`).
 
# The Add Role page opens (`/role/new/`).
# Enter the **Role Name**.
+
# Enter the '''Role Name'''.
 
# Click '''Save'''.
 
# Click '''Save'''.
 
# The new role appears in the Roles list.
 
# The new role appears in the Roles list.
 +
<div style="clear:both;"></div>
  
 
== Edit Role ==
 
== Edit Role ==
Line 55: Line 58:
  
 
{| style="border:0;"
 
{| style="border:0;"
| [[File:RoleEdit.png|250px|thumb|Click the Edit Role(pencil) icon]]
+
| [[File:RoleEdit.png|300px|thumb|Click the Edit Role(pencil) icon]]
| [[File:RoleEditView.png|250px|thumb|Edit Role]]
+
| [[File:RoleEditView.png|300px|thumb|Edit Role]]
 
|}
 
|}
  
 
</div>
 
</div>
# Open the **Roles** page.
+
# Open the '''Roles''' page.
# Click the **Edit** (pencil) icon beside the desired role.
+
# Click the '''Edit''' (pencil) icon beside the desired role.
 
# The Edit Role page opens (`/role/edit/{id}/`).
 
# The Edit Role page opens (`/role/edit/{id}/`).
# Update the **Role Name**.
+
# Update the '''Role Name'''.
 
# Click '''Update'''.
 
# Click '''Update'''.
 
# The updated role is saved.
 
# The updated role is saved.
 +
<div style="clear:both;"></div>
  
 
== Delete Role ==
 
== Delete Role ==
 
Removes a role that is no longer needed so it no longer appears in Role dropdowns or filters.
 
Removes a role that is no longer needed so it no longer appears in Role dropdowns or filters.
 
Deleting a role removes only the role definition. Personnel records that previously used the role remain unchanged, and their role reference is cleared.
 
Deleting a role removes only the role definition. Personnel records that previously used the role remain unchanged, and their role reference is cleared.
[[File:RoleDelete.png|250px|thumb|Role Delete]]
+
[[File:RoleDelete.png|300px|thumb|Role Delete]]
  
# Open the **Roles** page.
+
# Open the '''Roles''' page.
 
# Locate the role to delete.
 
# Locate the role to delete.
# Click the **Delete** (X) icon.
+
# Click the '''Delete''' (X) icon.
 
# Confirm the deletion.
 
# Confirm the deletion.
 
# The role is removed from the company.
 
# The role is removed from the company.
 +
<div style="clear:both;"></div>
  
 
== Notes ==
 
== Notes ==
  
 
* Only managers can manage roles.
 
* Only managers can manage roles.
* The Role menu is available only when **People Tab** is enabled.
+
* The Role menu is available only when '''People Tab''' is enabled.
 
* Role names are required.
 
* Role names are required.
 
* Role names accept only letters, spaces, and hyphens.
 
* Role names accept only letters, spaces, and hyphens.

Latest revision as of 07:10, 17 July 2026

Path: Callproof Support - Website - Role

Role

Lets managers define role labels (for example Manager, Buyer, Decision Maker) used on people/personnel under Accounts when People Tab is on, and for Role filters on Contacts/Accounts search. Roles allow managers to define job titles or relationship labels (such as Manager, Buyer, or Decision Maker) that can be assigned to contact personnel. Assigned roles help organize personnel records and can also be used as search filters on the Contacts and Accounts pages.

Roles Index View

Navigation: HomeSettings & CustomizationRole

Note:

  • The Role menu appears only when the company has People Tab enabled.
  • Role pages use the Company Directory sidebar.
  • The menu is dynamically generated and is not part of the default `menuurl.sql`.
User Access
Manager Full access to view, add, edit, and delete roles
Standard User No access. Redirected to the Dashboard with a "Not a manager" message.

View Roles

Display all role names configured for the company.

  1. Log in as a manager.
  2. Navigate to Home → Settings & Customization → Role.
  3. The Roles page opens (`/role/`).
  4. Review the list of available roles.
  5. Use the available actions to edit or delete roles.

Add Role

Creates a new people-role label for the company so it can be assigned to people on Accounts when People Tab is enabled.

Click the Add Role(plus) icon
Add Role
  1. Open the Roles page.
  2. Click Add Role.
  3. The Add Role page opens (`/role/new/`).
  4. Enter the Role Name.
  5. Click Save.
  6. The new role appears in the Roles list.

Edit Role

Updates an existing role’s name so personnel labels stay accurate across Accounts.

Click the Edit Role(pencil) icon
Edit Role
  1. Open the Roles page.
  2. Click the Edit (pencil) icon beside the desired role.
  3. The Edit Role page opens (`/role/edit/{id}/`).
  4. Update the Role Name.
  5. Click Update.
  6. The updated role is saved.

Delete Role

Removes a role that is no longer needed so it no longer appears in Role dropdowns or filters. Deleting a role removes only the role definition. Personnel records that previously used the role remain unchanged, and their role reference is cleared.

Role Delete
  1. Open the Roles page.
  2. Locate the role to delete.
  3. Click the Delete (X) icon.
  4. Confirm the deletion.
  5. The role is removed from the company.

Notes

  • Only managers can manage roles.
  • The Role menu is available only when People Tab is enabled.
  • Role names are required.
  • Role names accept only letters, spaces, and hyphens.
  • Maximum role name length is approximately 64 characters.
  • Roles are available when adding or editing Contact Personnel.
  • Roles can also be used as search filters on the Contacts and Accounts pages.

Technical Information

Item Value
URL `/role/`
Add `/role/new/`
Edit `/role/edit/{id}/`
Views `role/views.py`
Templates `templates/role/`