Entities/Customers
Entities Overview
Entities enable the organization and grouping of users with specific functions, either within an organization (e.g., departments like HR or Sales) or externally (e.g., clients, partners, or suppliers). These groups are granted access to a predefined set of assessments and/or assessment groups, making them essential for tailored resource management. For example, a tenant may create an entity for each customer they serve, assign unique permissions, and define accessible resources.
How to Create an Entity
To create an entity, tenant users can follow these steps:
1. Navigate to the Entities Section:
- Log into the platform using your tenant account credentials.
- Access the Entities module from the main navigation menu.
2. Initiate Entity Creation:
- Click the "Add New Entity" or similar button (e.g., "+" Button or "Create Entity").
- You will be directed to the entity creation form.
3. Provide Basic Information:
- Fill out the entity's basic details, including:
- Name: The name of the entity (e.g., "Customer A" or "HR Department").
- ID: A unique identifier for the entity.
- Contact Email: The primary email address associated with the entity for notifications and communications.
4. Add Primary or Owner User:
- Assign a primary user or owner user account to the entity:
- This user has rights to manage operations and users within the entity.
- Provide the user's full name, email, and other required details.
5. Configure Application Modules:
- Define the modules the entity will have access to depending on their specific requirements:
- Examples of selectable modules: Access to Data Pools, Approval Flows, or Raw Response Data PDF Downloads.
6. Configure Metadata (Optional):
- Set up additional metadata for the entity to capture specific organizational and user details:
- Customer Relational Metadata:
- Add details such as:
- Industry Type: The type of industry the entity belongs to.
- Country of Operations: The primary country where the entity operates.
- Headcount: The approximate size of the organization or group.
- Add details such as:
- User Operational Metadata:
- Add custom metadata for users linked to the entity, such as:
- Department or Team the user belongs to.
- Job Title, Tenure, or their Manager’s Email.
- Add custom metadata for users linked to the entity, such as:
- Customer Relational Metadata:
7. Link Subscription Plans:
- Select and assign one or more subscription plans to the entity:
- This determines the assessments and/or assessment groups the entity will have access to.
- Ensure the right plan fits the entity's needs for functionality and resource access.
8. Review and Save:
- Carefully review all entries, including the entity’s details, metadata, and linked subscription plans.
- Click "Save" or "Activate" to complete the entity creation process.
Key Steps Summary:
Step | User Action |
Navigate to Entities Section | Access the Entities module from the main menu. |
Initiate Entity Creation | Click "Add New Entity" to open the entity creation form. |
Provide Basic Information | Input details like entity name, ID, and contact email. |
Add Primary User | Assign a primary/owner user with full management rights for the entity. |
Configure Modules | Define which platform modules the entity will have access to. |
Set Metadata (Optional) | Add customer relational and user operational metadata, such as industry type or job title. |
Link Subscription Plans | Attach relevant subscription plans to define accessible assessments/resources. |
Review and Save | Verify entries and click "Save" or "Activate" to finish creating the entity. |
Key Features of Entities:
Feature | Description |
Group Specific Users | Organize users for targeted access to assessments, based on their roles or organizational units. |
Custom Metadata | Use relational and operational metadata to capture specific details about the entity and its users. |
Subscription Plans | Link subscription plans to define access to functionality, assessments, and resources. |
Module Accessibility | Enable or restrict access to features such as data pools, approval workflows, or external data. |
Context
Entities allow tenants to efficiently manage groups of users with tailored features, access controls, and resources. They can represent internal business units (e.g., Sales Teams, HR Departments) or external customers and partners. By leveraging features like metadata configuration and subscription plan linking, tenants can ensure customized, organized, and secure access for each entity, boosting collaboration and operational efficiency.