Skip to main content

Dimensions

Dimensions
Add Dimensions

PROCESS NAME

Asset Type Management (AX06P6)

 

FEATURE / USER STORY NAME

Add Dimension (AX06P6US01/High/S2)

 

DESCRIPTION

Enable back-office users to create custom data fields (dimensions) for specific asset types in the SMART360 platform. Dimensions include a name, a data type (Numerical or Character), and optionally a unit if the data type is Numerical. These dimensions will be stored and reflected in the Dimensions tab of the Add Asset form based on the asset type selected.

 

ACTORS

  • Back Office User

 

USER STORY

As a Back-Office User,

I want to add custom dimensions for specific asset types,

So that I can store asset-specific details in a structured manner during asset creation.

 

STORYTELLING

Sarah, a back-office user at Samoa Water Authority, is tasked with setting up custom fields for asset types to streamline asset data collection. She navigates to the Dimensions tab under settings for "Chlorine Pump" and adds a custom dimension called "Pressure." She selects the Numerical data type and specifies PSI as the unit. For another asset, Sarah adds a dimension named "Serial Number" and chooses the Character data type, where no unit is required. When field engineers add assets under the "Chlorine Pump" type, these predefined dimensions appear in the Dimensions tab, ensuring consistent and accurate data input.

GOALS

Allow back-office users to configure custom dimensions (data fields) for specific asset types.

 

PROCESS FLOW DIAGRAM

MAJOR STEPS INVOLVED

  1. Back-office user logs into the SMART360 platform.

  2. Navigates to AX Module > Settings > Asset Category > Asset Type.

  3. Selects a specific asset type (e.g., Chlorine Pump).

  4. Clicks the Dimensions tab.

  5. Clicks the Add Dimension button.

  6. Inputs the Dimension Name.

  7. Selects the Data Type from the dropdown:

  8. If Numerical is selected: The Unit field becomes accessible and mandatory.

  9. If Character is selected: The Unit field disappears.

  10. Clicks Save to add the dimension.

  11. The new dimension appears in the Dimensions list view.

  12. The dimensions are automatically displayed in the Dimensions tab when adding an asset of the selected asset type.

 

BUSINESS RULES

  1. Only authorized back-office users can access the Add Dimension feature.

  2. Dimension Name is mandatory and should only accept characters.

  3. Asset Type should be dropdown and should fetch data of all asset types added.

  4. Data Type must be selected from the dropdown:

  5. Options: Numerical, Character.

  6. If Numerical is selected as the Data Type:

    1. The Unit field must become accessible and mandatory.

  7. If Character is selected as the Data Type:

    1. The Unit field must disappear.

  8. Each Dimension Name must be unique within the selected asset type.

  9. For duplicate names, display: “This Dimension name already exists.”

  10. If the Dimension Name field is empty, display:

    1. “This field is mandatory.”

  11. Dimension Name should accept only alphabets.

  12. If numbers or special characters are entered, display: “Enter valid data.”

  13. Created By must auto-populate with the name of the logged-in user.

  14. Created Date must auto-populate with the current local system date and time.

  15. Newly added dimensions must immediately appear:

    1. In the Dimensions list view.

    2. In the Dimensions tab of the Add Asset form when the corresponding asset type is selected.

 

SAMPLE DATA

  • Asset Type: Chlorine Pump

  • Dimension Name: Pressure

  • Data Type: Numerical

  • Unit: PSI

  • Created By: S. Jones

  • Created On: 12/2/2024

 

  • Asset Type: Water Meter

  • Dimension Name: Serial Number

  • Data Type: Character

  • Unit: (Not Applicable)

  • Created By: M Johnson

  • Created On: 12/2/2024

ACCEPTANCE CRITERIA

  1. The Add Dimension form should open when the Add Dimension button is clicked.

  2. The Dimension Name field must be mandatory and saved successfully when valid data is entered.

  3. Asset type should be dropdown field and should fetch all asset types added .

  4. The Data Type dropdown must contain two options: Numerical and Character.

  5. If the Numerical data type is selected:

  6. The Unit field must become visible and mandatory.

  7. If the Character data type is selected:

  8. The Unit field must disappear.

  9. The following validations should occur:

  10. If the Dimension Name is empty, display: “This field is mandatory.”

  11. If a duplicate Dimension Name is entered, display: “This Dimension name already exists.”

  12. If invalid characters are entered in the Dimension Name, display: “Enter valid data.”

  13. Created By and Created Date fields must auto-populate.

  14. Upon successful saving, display the message:

  15. “Dimension successfully added.”

  16. The newly added dimension must appear in:

    1. The Dimensions list view under settings.

    2. The Dimensions tab in the Add Asset form when the corresponding asset type is selected.

 

PRODUCT TOUR

TEST CASES

TEST DATA

 

View Dimensions

PROCESS NAME

Asset Type Management (AX06P6)

 

FEATURE / USER STORY NAME

View Dimension (AX06P6US02/High/S2)

 

DESCRIPTION

Enable back-office users to view all dimensions created for specific asset types in the SMART360 platform. The View Dimensions feature provides a structured list displaying Dimension Name, Data Type, and Unit (if applicable) for selected asset types, aiding in efficient management and review of custom asset data fields.

 

ACTORS

  • Back-Office User

 

USER STORY

As a Back-Office User,
I want to view all custom dimensions for specific asset types,
So that I can review and manage the dimensions configured for asset condition assessments.

 

STORYTELLING

Alex, a back-office user at Samoa Water Authority, needs to review the custom dimensions configured for various asset types to ensure data consistency. He navigates to the Dimensions tab under the Chlorine Pump asset type in the SMART360 platform. Alex sees a structured list of dimensions, including fields such as Dimension Name, Data Type, and Unit. He confirms that the "Pressure" dimension is set to Numerical with PSI as the unit, while the "Serial Number" dimension is correctly set to Character with no unit. This allows Alex to validate the setup before field engineers start adding asset data.

GOALS

Allow back-office users to view all configured dimensions for specific asset types in a clear and structured list.

 

PROCESS FLOW DIAGRAM

MAJOR STEPS INVOLVED

  1. Back-office user logs into the SMART360 platform.

  2. Navigates to AX Module > Settings > Asset Category > Asset Type.

  3. Selects a specific asset type (e.g., Chlorine Pump).

  4. Clicks on the Dimensions tab.

  5. Views the list of all dimensions configured for the selected asset type.

    1. Dimension Name

    2. Asset type

    3. Data Type (Numerical or Character)

    4. Unit (if applicable).

    5. Action(View)

  6. Confirms the correctness of displayed dimensions.

 

BUSINESS RULES

  1. Only authorized back-office users can access the View Dimensions feature.

  2. The Dimensions list must display the following fields:

    1. Dimension Name

    2. Asset type

    3. Data Type

    4. Unit (if applicable, only for Numerical data type).

    5. Created By

    6. Created On

  3. The Dimensions list should be sorted alphabetically by Dimension Name.

  4. If no dimensions are configured for the selected asset type, display: “No dimensions found for this asset type.”

  5. The Dimensions list must automatically update when a new dimension is added, edited, or deleted.

 

SAMPLE DATA

  • Asset Type: Chlorine Pump

  • Dimension Name: Pressure

  • Data Type: Numerical

  • Unit: PSI

 

 

ACCEPTANCE CRITERIA

  1. The Dimensions list must display the following columns:

    1. Dimension Name

    2. Data Type

    3. Unit (if applicable).

  2. The list must display all dimensions configured for the selected asset type.

  3. The Unit column should display values only for dimensions with the Numerical data type; it must remain blank for dimensions with the Character data type.

  4. The Dimensions list must sort alphabetically by Dimension Name.

  5. If no dimensions are configured for the selected asset type, display the message: “No dimensions found for this asset type.”

  6. The Dimensions list must reflect updates immediately when dimensions are added, edited, or deleted.

 

PRODUCT TOUR

TEST CASES

TEST DATA

 

Search, Sort, Filter, and Download Dimension

PROCESS NAME

Asset Type Management(AX06P6)

 

FEATURE / USER STORY NAME

Search, Sort, Filter, and Download Dimension (AX06P6US03/High/S2)

 

DESCRIPTION

Enable back-office users to efficiently retrieve, organize, and export dimension data in the SMART360 platform. Users can search for specific dimensions, sort the list based on relevant fields, apply filters to refine the data, and download the results for offline access or reporting purposes.

 

ACTORS

  • Back Office User

 

USER STORY

  1. Search Dimension
    As a Back-Office User,
    I want to search for dimensions by keywords,
    So that I can quickly locate a specific dimension in the list.

  2. Sort Dimension
    As a Back-Office User,
    I want to sort the list of dimensions based on specific columns,
    So that I can organize the data in an order that suits my analysis.

  3. Filter Dimension
    As a Back-Office User,
    I want to filter dimensions based on predefined criteria,
    So that I can view only relevant dimensions for specific asset types or data types.

  4. Download Dimension
    As a Back-Office User,
    I want to download the list of dimensions in a suitable format,
    So that I can share the data with others or use it offline for reporting purposes.

 

 

STORYTELLING

Search Dimension
John, a back-office user at Samoa Water Authority, needs to locate a dimension named “Pressure” for Chlorine Pumps. He enters “Pressure” into the search bar in the Dimensions tab, and the list immediately narrows to show only the matching result. This saves him time navigating through long lists of dimensions.

Sort Dimension
Sarah is reviewing the dimensions configured for different asset types. She needs to view the list alphabetically. She clicks on the “Dimension Name” column header to sort the list in ascending order. The data rearranges instantly, making it easy to scan for missing or duplicate entries.

Filter Dimension
Alex, another back-office user, wants to focus only on Numerical dimensions with specified units for review. He opens the filter options, selects “Numerical” from the Data Type dropdown, and applies the filter. The list updates to show only Numerical dimensions.

Download Dimension
Sarah has been tasked with preparing a report of all configured dimensions for asset types. She uses the Download button in the Dimensions tab and exports the list as a CSV file. The downloaded file includes all the dimensions, which she shares with the field team for reference.

 

GOALS

  • Enable back-office users to efficiently search, sort, filter, and download dimension data.

  • Improve usability by allowing quick access and organization of dimension records.

  • Provide offline access to dimension data for reporting or analysis.

 

 

PROCESS FLOW DIAGRAM

MAJOR STEPS INVOLVED

  1. Search Dimension

    1. Back-office user logs into SMART360.

    2. Navigates to AX Module > Settings > Asset Category > Asset Type > Dimensions Tab.

    3. Enters a keyword in the Search Bar.

    4. The list dynamically updates to show only matching dimensions.

  2. Sort Dimension

    1. Back-office user navigates to the Dimensions Tab.

    2. Clicks on a column header (e.g., Dimension Name, Data Type, Created Date) to sort the list.

    3. The list rearranges in ascending/descending order based on the selected column.

  3. Filter Dimension

    1. Back-office user navigates to the Dimensions Tab.

    2. Opens the Filter Options and selects:

      1. Asset Type

      2. Data Type (Numerical or Character)

    3. Applies the filter.

    4. The list updates to display only the dimensions matching the applied criteria.

  4. Download Dimension

    1. Back-office user navigates to the Dimensions Tab.

    2. Clicks on the Download Button.

    3. Selects the file format (e.g., CSV).

    4. The system generates and downloads the list of dimensions.

 

BUSINESS RULES

  1. Search Dimension

  2. Search should work dynamically as users type keywords.

  3. Search applies only to the Dimension Name field.

  4. Sort Dimension

  5. Sorting should be enabled for the following fields:

    1. Dimension Name (Alphabetical)

    2. Data Type (Numerical/Character)

    3. Created Date (Ascending/Descending).

  6. Filter Dimension

  7. Users can filter dimensions by:

    1. Asset Type

    2. Data Type (Numerical or Character).

  8. Filters should work in combination (e.g., Asset Type = Chlorine Pump + Data Type = Numerical).

  9. Download Dimension

  10. Downloaded data must include the following fields:

    1. Dimension Name

    2. Data Type

    3. Unit (if applicable)

    4. Asset Type

    5. Created By

    6. Created Date

  11. File format: CSV.

 

SAMPLE DATA

  • Dimension Name: Pressure

  • Data Type: Numerical

  • Unit: PSI

  • Asset Type: Chlorine Pump

  • Created By: S. Jones

  • Created On: 12/2/2024

 

ACCEPTANCE CRITERIA

  1. Search Dimension

    1. When the user enters a keyword, the list dynamically updates to show matching results.

    2. If no results match the search term, display: “No dimensions found.”

  2. Sort Dimension

    1. The list must rearrange in ascending or descending order when the column headers are clicked.

    2. Sorting must be available for Dimension Name, Data Type, and Created Date.

  3. Filter Dimension

    1. Users can filter the list based on Asset Type and Data Type.

    2. Filters must work in combination.

    3. When no data matches the filter, display: “No dimensions found.”

  4. Download Dimension

    1. When the user clicks on the Download button, the list of dimensions is downloaded as a CSV file.

    2. The file must include Dimension Name, Data Type, Unit (if applicable), Asset Type, Created By, and Created Date.

    3. Display success message: “Dimensions successfully downloaded.”

 

PRODUCT TOUR

TEST CASES

TEST DATA

No Comments
Back to top