Part 1: Getting Started & Desktop Interface Navigation

System Installation & Setup

MRSware Desktop is a native Windows application built on the Microsoft .NET Framework for maximum speed, security, and offline capability. It runs on Windows 10, Windows 11, and Windows Server environments.

Desktop Interface Navigation

The MRSware Desktop interface is structured into four primary interactive zones:

• Top Menu Bar & Toolbars: Fast action buttons for New Contact, Quick Add Invoice, Send Email, Edit in Spreadsheet, and Data Analysis.
• Navigation Sidebar: Left panel allowing quick switching between CRM, MREPS Sales/Commissions, SFA, File Share, and System Admin modules.
• Workspace Viewport: Main workspace area supporting instant toggling between Table View, Compact Cards, and Multiline Cards.
• Dockable Panels & Status Bar: Integrated preview pane, statistics panels, database sync indicator, and RSS news bulletins.

Multi-Window Workspaces

Unlike standard web browsers that overwrite your context, MRSware Desktop supports true multi-window multitasking. You can right-click any company, customer, project, sales rep, or invoice listing and choose "Open in Separate Window". This allows you to inspect multiple transactions side-by-side without losing your place in master listings.

View Modes: Table View, Compact Card View & Multiline Card View

MRSware Desktop provides three standardized presentation view modes across CRM (Companies, Contacts, Tasks, Journals, Projects) and MREPS (Sales Rep Management):

Detailed Capabilities of Each View Mode

User Preferences & Display Font Customization

MRSware Desktop allows you to tailor typography and font sizes across the application interface to suit your display hardware, screen resolution (e.g. 4K, laptop, or multi-monitor setups), and personal readability preferences.

Accessing the Preferences Dialog

1. On the main menu bar at the top of MRSware Desktop, click Tools and select Preferences (or press Alt+T, then P).
2. In the category tree on the left of the Preferences dialog, locate and expand the (General) folder.
3. Click Settings under (General) to open display font and general preference options.

Configurable Font Settings

The Settings page provides dedicated font configuration controls for the primary display areas of the desktop client:

How to Change a Font

1. On the Settings page, click the Font Dialog button next to the display area you wish to customize (e.g. Font for Card Views : or Font for Table Listings :).
2. In the standard Windows Font selection dialog:
   • Select your preferred Font family (e.g. Arial, Segoe UI, or Tahoma).
   • Select the Font style (e.g. Regular or Bold).
   • Select the point Size (e.g. 9, 10, 11, or 12).
3. Click OK in the Font dialog. The text box next to the button will immediately display your selection (for example: 10 pt. Segoe UI).
4. Click OK or Apply at the bottom of the Preferences dialog to save your changes. Open card views, grids, and dashboard panels refresh automatically with the updated typography.

Sort Search Menu Items

Also located on the Settings page is the Sort Search Menu Items checkbox:

• Checked by default (Recommended): When enabled, all entries under the top-level Search menu are alphabetized (e.g., Activities, Companies, Contacts, Customers, Invoices, Opportunities, Orders, Projects, Sales Reps). This provides fast alphabetical lookup when jumping directly to specialized search forms.
• Unchecked: If unchecked, menu items remain in their original default system order.

Dockable Record Preview Window

The Record Preview Window (or Preview Pane) delivers instantaneous, zero-click inspection of any selected record across Table View, Compact Card View, and Multiline Card View without launching modal dialogs.

Key Capabilities of the Preview Window:

• Zero-Click Inspection: Moving your selection with arrow keys or mouse clicks instantly renders the full record profile in the preview pane.
• Flexible Docking Layouts: Dock the preview pane to the Right (recommended for wide monitors), to the Bottom, set to auto-hide, or undock/float it onto a secondary physical monitor.
• Rich HTML Document Rendering: Powered by an embedded read-only HTML engine displaying structured tables, contact badges, key dates, and financial metrics.
• Line-Break & Formatting Preservation: Multi-line notes, call interaction logs, and project descriptions preserve natural line breaks (<br/>) and whitespace formatting cleanly.
• Top Action Bar:
  • Edit Button: Instantly opens the standard Add/Edit dialog for the highlighted record.
  • Print Button: Triggers direct WYSIWYG printing using the native Windows Print dialog (DocumentPrint()) for immediate hard-copy generation.
• High-Performance 250ms Debouncing: Equipped with an intelligent 250ms selection timer to ensure rapid scrolling through thousands of records without UI stutter or unnecessary database round-trips.
• Selection-Based Blanking: Cleans the preview canvas automatically when no record is selected or during active search filtering.

Edit in Spreadsheet Functionality

For high-volume data entry and rapid multi-row maintenance, MRSware Desktop incorporates the reusable SpreadsheetGridControl engine. This feature brings full Microsoft Excel spreadsheet ergonomics directly into core business screens—including Invoice Entry, Product Catalog, and Sales Rep Management.

Spreadsheet Features & Power-User Tools:

• In-Cell Editing & Keyboard Navigation: Click any cell or press Enter to begin typing. Press Tab to advance to the next cell or Enter to move down to the next row.
• Add-New Row Line: An empty insertion row is anchored at the bottom of the grid (NewRowPosition.BottomRow), allowing continuous rapid data entry without opening new dialogs.
• Excel Clipboard Copy & Paste (Ctrl+C / Ctrl+V): Copy multi-column tabular data straight from external Microsoft Excel spreadsheets or CSV files and press Ctrl+V (or click "Paste from Excel") to populate hundreds of rows instantaneously.
• Freeze Columns: Right-click any column header and select Freeze Column to lock key reference columns (e.g. Invoice #, Part #, Rep Name) on the left while scrolling horizontally through wide datasets.
• Header Sorting & Context Menu: Sort columns ascending or descending by clicking headers, auto-fit column widths, or customize column alignment.
• Cell Fill-Down: Duplicate values down consecutive rows quickly for repetitive field entry.
• Search & Filter (Ctrl+F): Built-in search toolbar to highlight and filter rows by any keyword or column value in real-time.
• Export to CSV / Excel: Export your customized spreadsheet view to standard CSV or Excel files with a single click.
• Atomic Batch Validation & Transactional Save: Includes Save Changes and Save & Close options with live progress indicators. All rows undergo data validation (e.g. valid dates, required lookups, split percentage bounds) and commit to the database in a single atomic transaction.

Interactive Statistics Panels & Home Dashboard

MRSware Desktop features dynamic statistics panels engineered to give agency principals and reps immediate operational intelligence without running formal reports:

Grid Controls, Sorting & Grouping

All listings in MRSware Desktop feature comprehensive sorting, grouping, and customization tools:

• Table Column Header Sorting: In Table View, click any column header to sort ascending or descending. An arrow indicator shows the current sort order.
• Sort Toolbar Button (Card Views): In Compact Cards and Multiline Cards where table headers are absent, use the Sort dropdown button on the top toolbar. Click any available field to sort, and click the currently selected field to toggle between Ascending (Asc) and Descending (Desc) order (indicated with a checkmark).
• Column Chooser: Right-click grid headers to add, remove, or reorder custom data fields.
• Multi-Column Grouping: Drag header column buttons to the top grouping panel to nest records hierarchically (e.g. Group by Principal > Group by Sales Rep).
• Summary Aggregates: Display real-time totals, averages, and counts at the bottom of numeric columns (Sales, Commission, Cost, Lifetime Value, Churn) formatted cleanly as whole numbers.

Search & Advanced Filtering

MRSware provides versatile tools to locate and isolate records quickly across tables and card views:

1. Filter Toolbar Button: Dropdown button on the workspace toolbar enabling fast filtering by status, category, or follow-up flag color (Red, Yellow, Green, Blue, Purple, Orange, Complete, Not Flagged, or All).
2. Context Menu Filtering (By Selection & Excluding Selection): Right-click any card or row and select:
   • Filter > By Selection: Shows only records matching the selected entity (e.g. all emails from that sender or tasks for that contact).
   • Filter > Excluding Selection: Inverts the filter to hide records matching that entity, removing noise from recurring alerts or automated notifications.
   • Filter > Remove Filter: Restores the full recordset.
3. Inline Grid Search: Type directly in column header search cells for instant autocomplete in Table View.
4. Multi-Condition Filter Builder: Combine AND / OR conditions across multiple criteria (e.g. Sales Rep = 'Smith' AND YTD Sales > $50,000).
5. Date Range Filtering: Presets for This Month, Last Quarter, Year-to-Date, or custom calendar ranges.
6. Saved Filter Presets: Save frequently used search filters to your personal toolbar shortcuts.