Overview #

The Users Module in ConMan (Construction Manager) allows you to view, add, edit, and delete user accounts within the application. Each user account includes details such as username, email, password, and login history, displayed in an easy-to-use table format. This module is accessible from the ConMan Main Form and is designed to help administrators manage who can access the system.

This documentation guides you through the key features of the Users Module and how to use them effectively.

Getting Started #

1. Accessing the Users Module:
   • Launch ConMan and log in via the Main Form’s Login Screen.
   • From the Menu Screen, click the Users tile, or use the toolbar (Modules > Users).
   • The Users window opens, centered on your screen, with the title “Users” at the top.
2. Interface Layout:
   • Users Table: A grid displaying all user accounts, filling the entire window.
   • Navigation Bar: Buttons at the top of the table for managing records (e.g., add, save, delete).

Key Features and How to Use Them #

1. Users Table #

The Users Table is the main feature of this module, showing a list of all user accounts in ConMan.

Features: #

• Columns:
  • Username: The user’s login name (visible, editable).
  • Email: The user’s email address (visible, editable).
  • Password: The user’s password (visible, editable).
  • Last Login: The date and time of the user’s most recent login (visible, read-only).
  • Id: A unique identifier for each user (hidden).
  • Created At: The date and time the account was created (hidden).
• Navigation Bar: Includes buttons to:
  • Add a new user.
  • Save changes.
  • Delete a user.
  • Navigate through records (first, previous, next, last).
• Footer: Displays the total number of users at the bottom of the Username column.
• Customization: Right-click column headers to show/hide columns or adjust their order.

How to Use: #

1. View Users:
   • The table loads automatically when the module opens, showing all user accounts.
   • Scroll horizontally or vertically to see all columns and rows.
   • The Last Login column updates automatically when a user logs in (managed by the Main Form).
2. Add a New User:
   • Click the Insert button (a plus sign) in the navigation bar at the top of the table.
   • A new blank row appears at the top of the table.
   • Enter the Username, Email, and Password in the respective columns.
   • Click the Post button (a checkmark) to save the new user.
   • The user is added to the database with the current date/time as Created At.
3. Edit a User:
   • Click a cell in the table (e.g., a username) to edit it.
   • Type the updated value (e.g., change “john_doe” to “john.doe”).
   • Press Enter or click the Post button to save changes.
   • Note: Last Login cannot be edited manually; it updates on login.
4. Delete a User:
   • Click a row to select it.
   • Click the Delete button (a red “X”) in the navigation bar.
   • Confirm the deletion if prompted (the table updates immediately).
5. Count Users:
   • Look at the footer under the Username column to see the total number of users (e.g., “5”).
6. Customize the Table:
   • Right-click any column header (e.g., “Email”).
   • Select Customize Columns from the popup menu.
   • Drag columns to reorder them or check/uncheck boxes to show/hide columns like Id or Created At.
   • Changes apply instantly but are not saved between sessions (see Main Form documentation for persistent layout saving).

Tips and Best Practices #

• Keep Passwords Secure: Use strong, unique passwords and avoid sharing them.
• Use Clear Usernames: Choose recognizable usernames (e.g., “jane.smith”) for easy identification.
• Check Last Login: Use the Last Login column to monitor account activity.
• Save After Editing: Always click Post after adding or editing a user to ensure changes are saved.
• Minimize Window Clutter: Close the Users window when done to keep your workspace tidy.

Troubleshooting #

• Table is Empty: Ensure you’re connected to the database (contact your administrator if issues persist).
• Changes Not Saving: Click the Post button after editing; unsaved changes are lost when closing the window.
• Can’t Delete a User: Ensure the user isn’t currently logged in (check Last Login for recent activity).
• Hidden Columns: Right-click the table header and customize to show Id or Created At if needed.

Glossary #

• Username: The name a user logs in with (required).
• Email: The user’s email address (required).
• Password: The user’s login password (required).
• Last Login: The last time the user accessed ConMan (auto-updated).
• Navigation Bar: The row of buttons above the table for managing records.