Installation Details

Installation Details

πŸ“Œ Overview

The Installation Details module allows users to view and manage installation-related information for a project, including site conditions, scheduling details, and other custom-defined fields.

This module is fully dynamic and driven by the Custom Fields configuration in the Administrator application. Fields are displayed based on your company’s setup and can be customized in both structure and layout.

image-20260320-185803.png

πŸ“ Accessing Installation Details

You can access Installation Details from:

  • πŸ“ Project Record

  • 🏒 Company Record

⚠️ Note:

  • When accessed from a Company, only Company-level fields are available

  • When accessed from a Project:

    • Company-level fields = Read-only

    • Project-level fields = Editable


🧩 Module Layout

The screen is divided into two main sections:

🏒 Company Information

  • Displays Company-level custom fields

  • Editable only from the Company Record

  • Read-only when accessed from a Project

  • Values carry over to the Project


πŸ“ Project Information

  • Displays Project-level custom fields

  • Only visible and editable from a Project Record


🧰 Toolbar Actions

πŸ’Ύ Save

  • Saves all entered values

  • Fields marked with a red asterisk (*) are required

  • Save is blocked until all required fields are completed


πŸ”— Open Company

  • Opens the associated Company Record

  • Only available when accessed from a Project


πŸ”„ Refresh Fields

  • Reloads fields from Administrator configuration

  • Use when:

    • New fields are added

    • Existing fields are modified or removed


πŸ–¨οΈ Print

  • Generates a report via Telerik Reporting

  • Fields are:

    • Grouped by Report Group Name

    • Sorted by Report Sort Order


🧱 Company Fields Layout

  • Customize Company section layout

  • Requires permission: β€œSave Form Layouts”

  • Saves layout for entire company


🧱 Project Fields Layout

  • Customize Project section layout

  • Same permissions as Company layout

  • Only available from Project Record


✏️ Editing Field Values

Fields behave based on configuration type:

  • Text

  • Checkbox

  • Dropdown

  • Date

  • Number / Decimal

πŸ”΄ Required Fields

  • Marked with a red asterisk (*)

  • Must be completed before saving


🎨 Layout Customization

Users can fully customize field display using the layout editor.

image-20260320-190053.png

⚠️ Important:
Only one layout per section can be saved for the entire organization.
πŸ‘‰ Your Administrator should configure this for all users.

πŸšͺ Opening the Layout Editor

  • Click Company Fields Layout or Project Fields Layout


🧭 Customization Tools

The Customization Form consists of multiple interactive elements that facilitate layout modification. The image and table below describe these UI elements and their functionality.

🌳 Layout Tree View

  • Primary editing interface

  • Displays layout structure

  • Supports drag-and-drop organization

πŸ’‘ Tip: Use this to manage grouping and structure efficiently


πŸ‘» Hidden Items

  • Fields not currently displayed

  • Can be dragged back into the layout at any time


πŸ› οΈ What Can Be Customized

  • Reorder fields

  • Create groups/sections

  • Add headers and labels

  • Insert spacing and splitters

  • Apply colors and styling

  • Show/hide fields


πŸ’Ύ Saving Layout Changes

  • Saved as default for entire company

  • Applies to all users


βž• How Fields Are Added

Fields are initially created in a basic layout.
Admins or authorized users can then:

  • Organize fields into logical groups

  • Improve usability and readability

  • Customize experience for all users


βœ… Best Practices

  • Group related fields together

  • Use headers (e.g., Site Info, Scheduling)

  • Keep frequently used fields near the top

  • Use spacing for readability

  • Avoid overly complex layouts


πŸ“ Notes

  • Company-level layout is shared between Company and Project records

  • Layout customization affects display onlyβ€”not the underlying data