Search Page Audit Dashboard

The Search Page Audit dashboard provides comprehensive monitoring and analysis of all ColdFusion (.cfm) files across your application. This powerful tool scans files by type (Search, RecordEdit, RecordAction, RecordView, RecordDelete, Ajax, Display, TinyMCE, CustomTag, and SiteRoot), tracks compliance patterns, manages tasks, and provides detailed insights into file usage, references, and health status.

Quick Start

  1. Click Rescan Files to populate the audit database with current file information
  2. Use the search box to find specific files or apply Path/Type filters
  3. Click the chevron icon next to any file to view detailed scan results, tasks, and references
  4. Toggle PLHA (Private/Locked/Hidden/Active) flags by clicking the letters in the rightmost column
  5. Use Apply Mission to queue automated fixes for selected files

Toolbar Functions

Primary Actions

Button Function
Rescan Files Opens popup to scan all .cfm files and update the audit database with current file information, compliance checks, and metadata
Ref Scan Scans all .cfm files to identify which files reference each audit file, populating the "Called By" information
Back Returns to the previous page in browser history
Close Closes the current page or returns to Control Panel if embedded
â?» Refreshes the current page to reload all data

Search and Filters

Control Function
Search Box Searches across filename, page type, source folder, status type, sticky prefix, and notes. Results persist across page refreshes
All Paths Dropdown Filters by source folder: Admin, CustomTags, or SiteRoot
All Types Dropdown Filters by page type: Search, Edit, Action, View, Delete, Ajax, Display, TinyMCE, CTag, or Root
Show All Button Clears all search terms and filters to display complete results
Show Inactive Button Displays files marked as inactive/deleted (Active flag = 0)

Mission Management

Feature Description
Apply Mission Dropdown Creates automated fix jobs for selected files using predefined mission templates
Rescan Selected Re-runs compliance scans on only the selected files
View Jobs Opens the Mission Jobs dashboard to review queued and completed automation tasks
Mission Control Opens the Scan Missions management interface
Manage Criteria Opens the Scan Criteria configuration page

Data Table Columns

Column Description
â?쳌 Selection checkbox for bulk operations. Use the header checkbox to select/deselect all visible rows
â?· Detail row toggle. Click to expand and view scan results, tasks, references, and notes for the file
Filename The .cfm filename being audited. This is the primary identifier for each file
Type Page classification with color-coded badges: Search Edit Action View Delete
Path Source folder location: Admin, CustomTags, or SiteRoot. Click to browse the folder
Help Needs Help flag. Shows Help when flagged, - when not. Click to toggle
Nav Navigation status with color-coded indicators: Linked (has linkset entry), Called (referenced by other files), Used (HTTP accessed), Unused (orphaned)
Scan Quick access to detailed scan status. Click "Status" to view all compliance check results in a popup
Progress Task completion ratio (e.g., "3/5" means 3 of 5 tasks done). Hover to see progress bar and percentage. Color indicates status: green (100%), orange (50%+), red (<50%)
Notes Shows "Notes" if the file has annotations, "-" if none. Hover to preview note content
Created File system creation date in YYYY-MM-DD format
Modified File system last modification date in YYYY-MM-DD format
Scanned Timestamp of last audit scan in M/D H:MM AM/PM format
PLHA Status flags: P (Private), L (Locked), H (Hidden), A (Active). Red = enabled, gray = disabled. Click any letter to toggle that flag
ID Unique audit record identifier for database operations

Detail Row Information

Click the chevron (â?·) icon next to any file to expand a detail row containing comprehensive information organized in three sections:

Scan Health Section

Displays results from all compliance criteria scans with color-coded status badges:

  • Pass - Criteria met successfully
  • Fail - Criteria not met, needs attention
  • N/A - Criteria not applicable to this file type

Mission Pipeline Section

Shows assigned missions with their status and required fixes:

  • Mission Name - The automation template assigned to this file
  • Status - Done for completed missions, Active for pending
  • Fix List - Specific criteria that will be automatically corrected

References, Notes & Tasks Section

Component Description
Called By Lists up to 15 files that reference this file in their code. Shows "...and X more" if additional references exist
Notes Free-form text annotations (max 500 characters). Click "Edit Notes" to modify
Tasks Manual todo items with checkboxes. Green checkmark = completed, red circle = pending. Click icons to toggle status, "Add Task" to create new items

Workflow Procedures

Initial Setup Workflow

  1. Run Initial Scan - Click "Rescan Files" to populate the audit database with all .cfm files
  2. Run Reference Scan - Click "Ref Scan" to identify file dependencies and usage patterns
  3. Review Results - Use filters and search to identify problematic files
  4. Configure Missions - Set up automated fix templates in Mission Control
  5. Apply Fixes - Select files and apply missions to queue automated corrections

Daily Maintenance Workflow

  1. Check Dashboard - Review the page count and task summary in the toolbar
  2. Address Failures - Filter by specific criteria or search for problem indicators
  3. Update Tasks - Mark completed manual tasks and add new ones as needed
  4. Monitor Progress - Track completion percentages and mission status
  5. Rescan Modified Files - Re-audit files that have been recently changed

Bulk Operations Workflow

  1. Apply Filters - Use path and type filters to narrow your selection
  2. Select Files - Use checkboxes to select target files, or "Select All" for all visible
  3. Choose Mission - Pick an appropriate mission from the "Apply Mission" dropdown
  4. Review Job - The system redirects to the job review page before execution
  5. Monitor Execution - Track progress in the Mission Jobs dashboard

Permission Requirements

Access Restrictions

Admin Only: This page requires Client.ID = 1 (primary administrator). All other users receive "Access Denied" regardless of their permission level. This restriction protects sensitive file system operations and audit data.

Required Permissions

  • Database Access - Full read/write access to SearchPageAudit tables and related mission/criteria tables
  • File System Access - Read access to scan .cfm files across Admin, CustomTags, and SiteRoot directories
  • Mission Execution - Ability to create and execute automated fix jobs
  • Configuration Management - Access to modify scan criteria and mission templates

Data Management

Active/Inactive Records

The system uses bitwise flags in the Active column to manage record states:

  • Active Records - Active flag has odd values (1,3,5,7,9,11,13,15) indicating the base Active bit is set
  • Inactive Records - Active flag has even values (0,2,4,6,8,10,12,14) indicating soft deletion
  • Show Inactive Button - Toggles view to display soft-deleted records for recovery or permanent removal

PLHA Flag System

Flag Bit Value Purpose
P (Private) 8 Marks files as private/confidential requiring special handling
L (Locked) 4 Prevents automated modifications to protect critical files
H (Hidden) 2 Hides files from standard navigation and listings
A (Active) 1 Base active flag - when off, record is considered deleted

Data Persistence

The system maintains several types of persistent data:

  • Sticky Search - Search terms persist in Client.SPA_query across page refreshes
  • Sticky Filters - Path and Type filters persist in Client session variables
  • Table State - DataTables saves column sorting, pagination, and display preferences in localStorage
  • Audit History - All scan results and task changes are preserved with timestamps

Integration Features

Mission Automation

The audit system integrates with the Mission framework for automated file corrections:

  • Mission Templates - Predefined sets of criteria and fixes for common patterns
  • Job Queue - Safe execution environment with review and rollback capabilities
  • Criteria Engine - Extensible rule system for detecting compliance issues
  • Fix Modes - Multiple correction strategies from simple replacements to complex transformations

Reference Tracking

Advanced dependency analysis helps identify file relationships:

  • Code References - Files that include, call, or reference each audit file
  • Link Integration - Cross-references with the Links table for navigation entries
  • Usage Statistics - HTTP access counts and last access timestamps
  • Orphan Detection - Identifies unused files that may be candidates for removal

Reporting Capabilities

Built-in analytics provide insights into application health:

  • Compliance Metrics - Pass/fail rates across different criteria
  • Task Progress - Completion percentages and pending work identification
  • File Age Analysis - Creation and modification date patterns
  • Type Distribution - Breakdown of files by classification and folder

Summary

The Search Page Audit dashboard provides comprehensive file management and compliance monitoring for ColdFusion applications. Use the rescan functionality to populate current data, apply filters to focus on specific issues, expand detail rows for in-depth analysis, and leverage mission automation for bulk corrections. The PLHA flag system and task management features enable precise control over file status and workflow tracking. Regular use of this tool ensures application health, identifies unused files, and maintains coding standards across your entire .cfm file inventory.