Purpose Statement
Historical Occupancy Details capture ensures that ITM (Inspection, Testing, and Maintenance) reports permanently preserve property information exactly as it existed at the time of submission. This feature protects the integrity of your department's compliance records by maintaining an accurate historical snapshot of occupancy data—including address, business name, inspection district, zone, complex name, and parcel number—even if those details change in the future. This historical preservation is critical for compliance auditing, legal documentation, enforcement tracking, and accurate reporting on fire protection system maintenance activities over time.
Background Information
Fire protection system maintenance records often span months or years, during which property details can change significantly. A business may relocate, be sold to new owners, change its name, or properties may be rezoned into different inspection districts. Without historical data preservation, these changes could make it difficult or impossible to accurately track compliance history, understand enforcement patterns, or respond to legal inquiries about specific properties at specific points in time.
Why Historical Capture Matters:
When a service provider submits an ITM report through the Business Portal, the system automatically captures and permanently stores a snapshot of key occupancy details as they existed at that exact moment. If the occupancy record is later updated—for example, when a business changes ownership or the property is assigned to a different inspection zone—the historical ITM reports retain the original information. This creates a complete audit trail showing not just what maintenance was performed, but exactly where and for whom that service was provided.
Common Use Cases:
- Tracking compliance history when businesses change names or ownership
- Maintaining accurate records when properties are rezoned or redistricted
- Providing historical documentation for legal proceedings or insurance claims
- Analyzing inspection patterns across districts or zones over time
- Verifying service provider billing against historical property assignments
- Responding to public records requests with accurate point-in-time information
Required Permissions
To view and work with historical occupancy details in ITM Reports, users need the following permissions:
Viewing ITM Reports:
- ITM Reports - Read - Required to access the ITM Reports list and view submitted reports
- ITM Manager or ITM User role - Provides appropriate access level to review ITM submissions
Related Permissions (for context):
- Occupancy Records - Read - Allows viewing current occupancy information for comparison with historical data
- ITM Reports - Update - Required if reviewing and approving reports (not necessary just to view historical details)
Video
Step-by-Step Guide
1. Click on ITM.
2. Click on ITM Reports.
3. Click on Columns.
4. Click on Clear all. We will be selecting the Occupancy Details that will be captured at the time of submission.
5. Select: Address, Business Name, Inspection District, Inspection Zone, Complex Name and Parcel Number.
These are the Occupancy Details that will be captured for historical purposes as they were at the time of the ITM Report Submission.
6. The report list view is showing the Occupancy Details that will be captured for historical purposes at the time of ITM Report submission.
Best Practices
Column Selection Best Practices:
Select only the columns you regularly need - While it's tempting to show all available information, too many columns can make the list view cluttered and difficult to scan efficiently
Start with the 6 core historical occupancy fields listed in this article, then add report-specific columns based on your workflow needs
Create multiple saved views for different purposes (e.g., one view for historical tracking, another for day-to-day processing, one for compliance auditing)
Include Report Date in your view - This provides crucial context for understanding when the historical data was captured
Consider your screen resolution - If working on smaller displays or laptops, limit the number of columns to maintain readability
Using Historical Data Effectively:
- Document property changes in your records - When you notice discrepancies between historical ITM data and current occupancy records, investigate and document the reason for changes
- Use historical data for trend analysis - Export ITM reports with historical occupancy details to analyze compliance patterns across different districts, zones, or time periods
- Verify service provider billing - Historical occupancy details help confirm that service providers are billing for work at the correct properties
- Support enforcement actions - Historical data provides definitive evidence of property ownership, location, and district assignment at the time of violations or non-compliance
- Respond to records requests accurately - When providing historical compliance information, use the preserved occupancy details to ensure accuracy
Troubleshooting & FAQs
Issue: I don't see the Columns button in my ITM Reports view
Solution: Verify you have ITM Reports - Read permission enabled in your user role
Solution: Check that you're in the ITM Reports list view (not the detailed view of a single report)
Solution: If using a mobile device or small screen, the Columns button may be in a collapsed menu (look for three dots or hamburger menu icon)
Solution: Contact your system administrator to verify the Columns feature is enabled for your agency
Issue: Some occupancy detail columns are showing blank or "N/A" in older ITM reports
Solution: This typically indicates the occupancy record didn't have that information filled out at the time of ITM submission—the historical capture feature only preserves data that existed at submission time
Solution: Review the current occupancy record and fill in missing details to ensure future ITM submissions capture complete information
Solution: For critical missing historical data, check if older inspection records or archived documents contain the information, then document it in occupancy notes
Issue: Historical data in ITM report doesn't match current occupancy record, but there's no record of when it changed
Solution: Updates to occupancy records typically create system logs—check the occupancy record's history or audit log if available
Solution: Review inspection history for the property to see if field personnel noted any changes during routine inspections
Solution: Contact the current property owner or business to gather information about when changes occurred
Solution: Document your findings in the occupancy notes for future reference
Issue: I configured my columns but the changes didn't save
Solution: Make sure to click Apply, Save, or Done after selecting columns (simply selecting columns without confirming may not persist changes)
Solution: If your organization uses shared views, you may need special permissions to save permanent view changes—contact your administrator
Solution: Try saving a personal custom view rather than modifying a shared default view
Solution: Clear your browser cache and try configuring columns again
FAQ: If I update an occupancy record today, will it change the historical data in old ITM reports?
Answer: No. Historical occupancy details captured in ITM reports are permanently preserved exactly as they were at submission time. Changes to current occupancy records do not retroactively modify historical ITM data. This is by design to maintain audit trail integrity.
FAQ: Can service providers see these historical occupancy details when they view their submissions?
Answer: Service providers viewing their ITM reports through the Business Portal see the occupancy information as it was at submission time. However, they may have limited column configuration options compared to fire department users. The historical preservation works the same way regardless of who is viewing the report.
FAQ: How far back does the historical occupancy capture go?
Answer: Historical occupancy details are captured for all ITM reports from the time this feature was implemented in your system. Reports submitted before the feature was enabled may not have historical occupancy data preserved, but all reports submitted after implementation will include this historical snapshot.
FAQ: Can I export ITM reports with historical occupancy details for long-term archiving?
Answer: Yes. Use the Export function in the ITM Reports list view after configuring your columns to include historical occupancy details. The export will include all visible columns in your current view, creating a permanent external record of the historical data. This is recommended for long-term archiving beyond the system's retention period.
FAQ: What happens to historical occupancy data if an occupancy record is deleted?
Answer: Historical occupancy details preserved in ITM reports remain intact even if the associated occupancy record is deleted. The ITM report maintains its snapshot of the property information. However, best practice is to inactivate rather than delete occupancy records to maintain complete data relationships.
FAQ: Are there other types of historical data captured in ITM reports besides occupancy details?
Answer: Yes. ITM reports also preserve historical information about the system being serviced, the service provider's information at submission time, and other relevant details. The occupancy details covered in this article are among the most frequently referenced historical elements, but the entire report serves as a point-in-time record of the maintenance activity.
FAQ: Can I create reports that analyze changes in occupancy details over time using this historical data?
Answer: Yes. By exporting ITM reports with historical occupancy details and analyzing them in spreadsheet or business intelligence tools, you can track how properties have changed over time—including business turnover rates, district reassignments, and property redevelopment. This can provide valuable insights for planning inspection resources and understanding your jurisdiction's development patterns.
Use Case Examples
Example 1: Business Name Change After Sale
ABC Restaurant submits ITM reports monthly for their kitchen suppression system. In June, the business is sold and renamed to XYZ Bistro. The occupancy record is updated with the new business name.
ITM reports submitted January through May show "ABC Restaurant" in the Business Name column
ITM reports submitted June onward show "XYZ Bistro" in the Business Name column
When reviewing compliance history, fire prevention staff can see exactly when the business changed, helping them understand any gaps in service or changes in compliance patterns
Example 2: District Redistricting Project
The fire department reorganizes inspection districts, moving several properties from District 2 to District 3 in March. Properties in the affected area have their occupancy records updated with the new district assignment.
ITM reports submitted before March show "District 2" in the Inspection District column
ITM reports submitted after March show "District 3" in the Inspection District column
When analyzing inspector workload or district compliance rates, staff can accurately attribute historical ITM activity to the correct district at the time of service, preventing data skewing in performance reports
Example 3: Complex Name Addition
A shopping center's individual tenant spaces initially have occupancy records without a complex name. In July, the fire department adds "Riverside Plaza" as the complex name to better organize records.
ITM reports submitted before July show blank or "N/A" in the Complex Name column
ITM reports submitted after July show "Riverside Plaza" in the Complex Name column
This helps staff understand when property organization improvements were made and doesn't retroactively modify historical records that accurately reflected the data state at that time