PushIt — Settings View Guide

Overview

The Settings view is where you configure the data source (CSV or drofus) and specify which Revit categories PushIt should target when searching for mock room families. Changes made here take effect when you click Load Data to return to the main window.

---

Accessing Settings

Click the ⚙ Settings button in the top-right corner of the main window header. The window content switches to the Settings view.

---

Window Layout

The Settings view is divided into the following sections from top to bottom:

Section	Purpose
Header banner	Blue banner showing “Settings”
Message banner	Status and validation messages
Data Source section	Choose and configure the active data source
Supported Categories section	Enable or disable Revit categories that PushIt searches for mock rooms
Bottom buttons	Cancel (discard changes) or Load Data (apply and return)

---

Data Source Section

The Data Source section lets you choose where room data is loaded from and configure the connection details.

1. Data Source dropdown — select either CSV or drofus. Selecting a source reveals its configuration controls below the dropdown.

2. Provider-specific configuration panel — appears immediately below the dropdown once a source is selected.

For full configuration details, refer to the relevant guide:

• 03_csv_data_source_ui.md — CSV file configuration

• 02_drofus_data_source_ui.md — drofus API connection and property mappings

---

Supported Categories Section

The Supported Categories grid lists the Revit family categories that PushIt will search when looking for mock room families in the model.

Column	Description
IsEnabled	Checkbox — tick to include this category in PushIt operations
CategoryName	Name of the Revit category (read-only)

Changes to the checkboxes are applied automatically — no separate Apply button is required.

Note: Enabling only the categories that contain your mock room families improves performance and reduces false matches.

---

Bottom Buttons

Button	Action
Cancel	Discards all changes made in this session and returns to the main window without loading data
Load Data	Saves the current settings, loads data from the configured source, and returns to the main window with the mock rooms grid populated

The Load Data button is disabled if the selected data source has unresolved validation errors (e.g., invalid file path or missing drofus connection).

---

Typical Settings Workflow

1. Click ⚙ Settings in the main window header.

2. Select your data source (CSV or drofus) in the Data Source dropdown.

3. Configure the data source (see the relevant guide linked above).

4. In the Supported Categories section, tick the categories that contain your mock room families; untick any that do not apply.

5. Click Load Data to apply settings, populate the grid, and return to the main window.

6. Click Cancel at any time to discard changes and return without reloading data.