Difference between revisions of "Role"
Ashley DeBon (talk | contribs) (→Add Role) |
Ashley DeBon (talk | contribs) (→Notes) |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
= 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 | + | 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. | ||
| Line 12: | Line 12: | ||
'''Note:''' | '''Note:''' | ||
| − | * The | + | * The '''Role''' menu appears only when the company has '''People Tab''' enabled. |
| − | * Role pages use the | + | * 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 31: | 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 | + | # 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 45: | Line 45: | ||
</div> | </div> | ||
| − | # Open the | + | # 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 | + | # Enter the '''Role Name'''. |
# Click '''Save'''. | # Click '''Save'''. | ||
# The new role appears in the Roles list. | # The new role appears in the Roles list. | ||
| Line 63: | Line 63: | ||
</div> | </div> | ||
| − | # Open the | + | # Open the '''Roles''' page. |
| − | # Click the | + | # 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 | + | # 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 == | ||
| Line 75: | Line 76: | ||
[[File:RoleDelete.png|300px|thumb|Role Delete]] | [[File:RoleDelete.png|300px|thumb|Role Delete]] | ||
| − | # Open the | + | # Open the '''Roles''' page. |
# Locate the role to delete. | # Locate the role to delete. | ||
| − | # Click the | + | # 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 | + | * 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
Contents
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.
Navigation: Home → Settings & Customization → Role
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.
- Log in as a manager.
- Navigate to Home → Settings & Customization → Role.
- The Roles page opens (`/role/`).
- Review the list of available roles.
- 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.
- Open the Roles page.
- Click Add Role.
- The Add Role page opens (`/role/new/`).
- Enter the Role Name.
- Click Save.
- The new role appears in the Roles list.
Edit Role
Updates an existing role’s name so personnel labels stay accurate across Accounts.
- Open the Roles page.
- Click the Edit (pencil) icon beside the desired role.
- The Edit Role page opens (`/role/edit/{id}/`).
- Update the Role Name.
- Click Update.
- 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.
- Open the Roles page.
- Locate the role to delete.
- Click the Delete (X) icon.
- Confirm the deletion.
- 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/` |