2. Agents

This module enables users to onboard new agents.

The Agents module includes the following features:

2.1 Agents Dashboard

Here, the user can view the list of agents, as shown in the following screenshot.

agents-dashboard.png

Agents dashboard has the following features.

User can search for any specific agent with their names.

2. Filter

By using this feature, the user can refine the search by selecting a filter option (such as username, role, profile, status, etc.), choosing the appropriate option from the displayed list, and clicking on the 'Add' button. Afterward, click the 'Apply' button, as shown in the screenshot below. The filtered results will then be displayed in the agents list.

agents-dashboard-filter.png

3. Customize table view

User can customize the table by selecting the various columns and click on save button (shown by below screenshot), then the selected columns populate in agents table with the data. 

agents-dashboard-tableview..png

4. Total Records

Total number of agents present in the system displayed in bottom of the agents table.

5. Pagination

A pagination view is displayed next to the total number of records, allowing the user to select pagination options (5, 10, 25, 50, 100) to display the desired number of records in the list.

6. Agent detail view page

User can view and edit the agent details by clicking on agent from the list.

The Agent module has two features:

·        New Agent

·        Bulk Upload




2.2 Pre-Requisites For Agent Onboarding

To onboard agents, the user must configure roles, skillset, and resource groups in the settings module.

i. Navigate to Settings and open the Agents section to configure the Profile and Skillset.

ii. Navigate to Settings and open the My Organization section to configure Roles and Resource Groups.

iii. Go to the Agents module and create a new agent with the Supervisor role.

iv. Go to the Vendor module and create a new vendor beforehand. 

i. Settings -> Agents -> Profile:

settings-agents-profile.png

Add Profile: To create a profile, users can type in the text box and click the "Add Profile" button.

Profiles Bulk Upload: To create multiple profiles simultaneously, users can click the "Bulk Upload" button, download the CSV file, fill in the data, and upload the file to save multiple profiles.

Edit Profile: Users can edit an existing profile by clicking the edit icon in each row of the profile list.

Delete Profile: Users can delete an existing profile by clicking the delete icon in each row of the profile list.

Settings -> Agents -> Skillset:

settings-agents-skillset.png

1. Add Skillset: Users can add a new skillset to use in various modules like agents and assets. To create a skillset, type in the skillset text box and click the "Add Skillset" button.

2. Skillset Bulk Upload: To create multiple skillsets at once, users can click on the "Bulk Upload" button, download the CSV file, fill in the data, and upload the file to save multiple skillsets.

3. Edit Skillset: Users can edit an existing skillset by clicking the edit icon available in each row of the skillset list.

4. Delete Skillset: Users can delete an existing skillset by clicking the delete icon available in each row of the skillset list.

 

ii. Settings -> My Organization -> Roles:

Here, users can create a new role for onboarding, which can be utilised in various modules like agents and asset creation.

settings-my organization-role1.png

1. Add Role: Click on the "Add New Role" button, provide the role name, and select the role type (mandatory fields), as shown in the screenshot below. Then, click on the "Submit" button to save the role details.

settings-my organization-role2.png

2. Permissions: Users can assign permissions to a role by clicking on the "Edit Permissions" button. Select the checkboxes to grant the appropriate permissions for the selected role, which was created earlier, as shown in the screenshot below.

settings-my org-roles3.png

 Settings -> My Organization -> Resource Groups:

Users can create a new resource group by clicking on the "Add Resource Group" button, which can be used in various modules such as agents and asset creation.

settings-my organization-resource group1.png

1. Create Resource Group: When the user clicks on the "Add Resource Group" button, the following page will be displayed. Fill in all the mandatory fields to enable the "Save" button. Once completed, click on the "Save" button to save the resource group.

settings-my organization-resource group2.png

2. View Resource Group: Users can view the resource group that was created earlier.

3. Edit Resource Group: Users can edit the selected resource group that was created earlier.

4. Delete Resource Group: Users can delete the selected resource group that was created earlier

iii. Left menu -> Agents -> Create Agent with Supervisor Role:  

agents-new agent1.png

iv.   Left Menu -> Vendor -> New Vendor:

Go to the Vendor module and create a new vendor (to select the vendor from the dropdown while creating a new agent or asset). Fill in the mandatory and non-mandatory fields to save the vendor details.

Note: For more details, please review sections 9.2 "Pre-requisites for Vendor Creation" and 9.3 "New Vendor" in the Vendor module.

vendor-new1.png




2.3. New Agent

This feature allows users to create individual agents; new agents can be onboarded on this page.

Left menu -> Agents -> New Agent:

agents-new agent1..png

The save button will be enabled only after the user fills out all required fields and any optional ones. Vendor details and resource group are optional fields.

Note: Each agent should provide a unique email ID that does not match any other agent's email ID.

agent-new agent2..png

Click the save button to onboard the new agent. An "Agent added successfully" confirmation message will appear, and the screen will navigate to the agent dashboard, where the newly added agent will be displayed at the top of the list.

agents-new agent3.png

In the agent list, the newly added agent will appear at the top.

agents-new agent4 (2).png




2.4. Agent Login Procedure

Registered users will receive an account confirmation email containing temporary credentials and a login link for the Asseto application. This will be sent to the registered email ID provided on the new agent registration page.

agents.login1.png

Once the agent clicks on the "Log in to Asseto" button, they will be directed to the Asseto login page, where they can log in using the temporary credentials. This process is illustrated in the screenshot below.

agents.login2.png

The system will navigate to the password reset page, allowing the user to set a new password. After entering and confirming the new password, the user should click the submit button to complete the process.

agents.login3.png

A confirmation message will be displayed: "You need to verify your email address to activate your account."

agents.login4.png

agents.login5.png

agents.login8.png

Click the checkbox to enable the accept button. Once clicked, the user will be directed to the Asseto landing page (dashboard).

agents.login9.png


 




2.5. Forgot Password

When a user forgets their password, they may click on the "Forgot Password" option on the login page. This will navigate them to the Forgot Password page.

agent-forgot password1.png

Enter the username and click the "Submit" button. The user will receive an email with a link to reset the password for the Asseto application, sent to the registered email ID provided on the new agent registration page, as shown in the following screenshot.

agent-forgot password3.png

agent-forgot password4.png

After providing the "New Password" and "Confirm Password," click the "Submit" button. A confirmation message will appear: "Verify your email address to activate your account."

agent-forgot password5.png

Users will receive an email.

agent-forgot password6.png

agent-forgot password7.png

When the user clicks the "Accept" button, they will be directed to the Asseto landing page (dashboard).

agents.login9.png



 

2.6. Bulk Upload

This feature allows the user to onboard multiple agents in bulk.

Agents -> Bulk Upload:

agents-bulk1.png


It has three sections:

  1. Preparation: Download the template.
  2. Precheck: Perform a validation check to identify any errors in the uploaded sheet.
  3. Processing: View the progress of the bulk upload process.

The Info button allows users to view the field validation rules to correctly fill in the values in the CSV file.

agents-bulk-info.png

1. Preparation: Click the "Download Template" button to download the CSV file. The file will be saved in the Downloads folder on your local PC, as shown in the following screenshot.

agents-bulk2.png

Fill in the data for all agents to be onboarded in the downloaded CSV file, using the bulk upload feature.

agents-bulk3.png

Upload the file by clicking the "Choose File" button on the bulk upload page.

agents-bulk4.png

After uploading the CSV file, the "Next" button will be enabled. Click the "Next" button to navigate to the validation check page.

2. Precheck/Validation Check: If the uploaded file contains any errors, they will be displayed here. The user will not be able to proceed to the next stage until those errors are corrected. The "Submit" button will be enabled (as shown in the screenshot below) if there are no errors in the CSV file.

agents-bulk5.png

Note: Click on the tooltip (icon) to check the validation status on the validation/pre-check page.

agents-bulk6.png

If there are no errors, the user can view the passed count (i.e., the number of agents added) and the "Submit" button will be enabled. Click the "Submit" button to navigate to the next page.

3. Processing: The user can view the progress of the bulk upload. A confirmation message, "Agents created successfully," will be displayed.

agents-bulk7.png

Any issues found within the sheet will notified to user.            -

agents-bulk8.png

Click on close. added agents through bulk upload will be displayed on the agents list page as shown by following screenshot.

agents-bulk9.png




2.7. Agent Detail View

Agent detail view page: The user can view and edit agent details by clicking on the agent from the list.

agents-view2.png




2.8. Agent Edit

Agent Edit: On the agent details view page, the user can edit and update the agent details by clicking on the edit icon located near the agent's name in the top left corner of the page.

agent-edit1.png

Note: Greyed-out fields are not editable.

agent-edit2.png

Update the data and click the "Save" button at the bottom of the page. The system will navigate back to the agent's detail view page, and a confirmation message, "Agent successfully updated," will be displayed.

agent-edit3.png