Creating and Managing Roles

Creating and Managing Roles

Overview

Roles in iVendNext control user access and editing rights. To keep workflows secure and efficient, it's important to set them up correctly. This article walks you through adding, configuring, and managing roles step by step.





Step 1: Adding a New Role

1. Navigate to the Role List

  • Go to Home > Users and Permissions > Role List.

  • Alternatively, use the Awesome Bar (global search) and type "Role List."



2. Create a New Role

  • Click "Add Role" to open the Role Creation Screen.



3. Enter Role Details

Fill in the following fields:


Field

Description

Role Name

A unique identifier (e.g., "Inventory Manager").

Home Page

Sets the default landing page (e.g., Stock Dashboard).

Restrict to Domain

Limits access to specific functional areas (e.g., Inventory, Sales).

Desk Access

Enables access to iVendNext modules (uncheck for restricted roles).

Two-Factor Auth

Adds extra security for sensitive roles (recommended for admins).


4. Save the Role

  • Click "Save" to finalize.




Step 2: Assigning Permissions to the Role

After creating a role, define its permissions using the Role Permissions Manager.


1. Open Role Permissions Manager

  • From the Role list, select the role and click "Role Permissions Manager."



2. Set Document-Level Permissions

  • Select a Document Type (e.g., "Sales Invoice").

  • Assign permissions: Read, Write, Create, Submit, Cancel, etc.

  • Use Permission Levels (0-9) to restrict specific fields (e.g., hide financial data from non-accounting roles).



3. Apply User Permissions (Optional)

Restrict access to specific records (e.g., only sales from a user’s territory):


  • Go to Home > Users and Permissions > User Permissions.

  • Link the role to a Customer, Territory, or Company.




Step 3: Using Role Profiles for Efficiency

Role Profiles allow bulk assignment of multiple roles (e.g., "Sales Supervisor" = Sales User + Employee + Manager).


1. Create a Role Profile

  • Navigate to Home > Users and Permissions > Role Profile List.

  • Click "Add Role Profile."



2. Assign Roles

  • Add relevant roles (e.g., "Sales User," "Employee").

  • Save the profile.


3. Assign to Users

  • Go to the User record and select the Role Profile.





Best Practices for Role Management

Here’s a quick look at some of the best practices for Role Management.


  1. Principle of Least Privilege: Grant only necessary permissions.

  2. Audit Roles Quarterly: Remove outdated access.

  3. Use Permission Levels: Hide sensitive fields (e.g., costs, salaries).

  4. Leverage Role Profiles: Simplify onboarding for teams with similar needs.




Troubleshooting Common Issues

Here’s a quick look at some common issues you might run into.


  • Users can’t access a document? Check Role Permissions Manager and User Permissions.

  • Permission changes not applying? Ensure the role is assigned correctly under User > Roles.




    • Related Articles

    • Creating and Managing Users

      Overview This guide provides a step-by-step approach to setting up and managing users in iVendNext. Requesting an Account Before creating users, you need an iVendNext administrator account. Follow these steps: Contact the Onboarding Team: Reach out ...
    • Creating and Managing Custom Fields

      Overview Custom fields in iVendNext let you tailor forms to fit your specific data needs—like extra customer info, project tags, or inventory tweaks. They help your system match your workflow, not the other way around. This guide walks you through ...
    • Managing User Roles and Permissions

      Overview Roles and permissions in iVendNext control what users can view, edit, and manage, ensuring secure access. This article explains how to: ✔ Create and assign roles ✔ Configure granular permissions ✔ Restrict document access (e.g., "Only If ...
    • Understanding User Roles and Permissions

      Overview User roles and permissions are key to keeping your application secure and running smoothly. They control who can access what, based on each user’s responsibilities. This article explains the basics to help you set up and manage roles in ...
    • Creating and Managing Retail Permissions

      Overview Retail permissions define what actions users can perform at the Point of Sale (POS), such as processing sales, overriding prices, or managing shifts. This article provides a step-by-step approach to setting up retail permissions, covering ...