Reporting Group Configuration – User Fields

Overview

A User field is additional information about the reporting group which can be used to describe the reporting group. After configuring user fields, authorized user can add/edit these additional values for each reporting group as and when required.  User fields’ definitions are generic to all reporting group.  

Authorized users are able to select configure reporting group option for any reporting group and can add/edit/delete the user fields for that particular reporting group from the “User Fields” tab.  The main purpose to define these user fields are that user can add additional details/additional fields about any particular reporting group as and when required. 

Step-by-Step Process

Step 1 – Configure Reporting Group

  • From the left navigation panel, click the  icon to navigate to the "Configure Reporting Groups" page
  • The "Configure Reporting Groups" page contains two tabs:
    • User Fields
      • This navigates users to the “Configure User Fields” page (Refer to Step 2)
    • Site Configuration
      • This navigates users to the “Configure Reporting Group – Site Configuration” page

Step 2 – Configure User Fields Tab

  • The “User Fields” tab is selected by default when navigating to the “Configure Reporting Groups" page
  • If no user fields have been added, there will be a “No data to display” message and a “+” button
    • Users can add user fields by selecting the “+” button and being redirected to the “Add User Field” page. (Refer to Step 3)
  • Users will be able to view the list of already added user fields, including the following details:
    • Name
    • Description
    • Type
    • Order
    • Action
      • Edit
        • This navigates users to the “Edit User Field” page (Refer to Step 4)
      • Delete
        • This navigates users to the “Delete User Field” page (Refer to Step 5)

Step 3 – Add User Field

  • Click the "+" button to add a user field
    • Enter the following user field values into the "Add User Field" pop-up (above):

Field

Type

Required?

Description

Name

Text Box

Yes

This field requires unique name for the user field for the reporting group

Description

Text Box

No

Brief description about the user field

Type

Drop down

Yes

It requires to select the parameter type for user field values

API Key

Text Box

Yes

It requires API key associated with the user field. API key is unique identifier for User field.

Order

Text Box

Yes

It requires order number. Order number is used to decide in which order this user field will be displayed in the list.

  • Click the “Cancel” button to go back without saving any information
  • Click the “Save” button to save the new user field information
    • The new user field information is validated after the user clicks the “Save” button
  • If proper values are inserted into all required fields, the following will occur:
    • The system will notify the user with a success message “User field Added successfully”
    • The user will be redirected to the “Configure Reporting Group” page (Refer to Step 1)
    • The new user field will be added to the list in the “User Field" tab
  • The user will be notified with proper error messages in the event of:
    • If the user needs to enter any field level information
    • If the field name already exists
    • If the API key already exists
    • If the user enters a duplicate order
      •  

Step 4 – Edit User Field

  • Users can edit below details of any particular user field by clicking on “Edit” icon
    • Field Name
      • Name of the user field
    • Description
      • Description of the user field
    • API key
  • Click the “Save” button to save the edited user field values
    • The system will validate the user field information and notify the user if there is an error
  • Click “Cancel” to go back without editing any information

Step 5 – Delete User Field

  • Click “Delete” for any user field in the list
    • A pop-up opens with the confirmation message
      • Click “Cancel” to go back without deleting the user field
      • Click “OK” to delete the user field
        • The user field will be removed from the list
        • The system will notify the user with a success message