Search
This is a legacy or outdated guide that will be replaced or updated in the future. All current guides can be found in the Troubleshooting Guides section.
Search Operation Troubleshooting
Search functionality may fail due to various configuration issues, missing index groups, or permission restrictions. Systematic diagnosis helps identify the root cause and appropriate resolution.
Service Activation Verification
Confirm that the IndexSearch service is properly activated in the system configuration before investigating specific search issues.
Navigate to the instance configuration by accessing Instance Configuration | Modules in the system settings. Verify that IndexSearch is enabled and properly configured at the system level.
Search Process Configuration
Check for the presence of custom search processes that may interfere with standard search operations.
Review the internal processes section located at Processes | Internal to identify any indexsearch_process implementations. Custom search processes can override default behavior and may contain configuration errors that prevent proper search execution.
Debug Logging Activation
Enable detailed logging to capture search query information and identify processing issues.
Activate the INDEXSEARCH or INDEXSEARCH_EXTENDED debug log levels to display search queries in the server log. This logging provides visibility into query construction, execution, and result processing.
The INDEXSEARCH_EXTENDED level provides more comprehensive debugging information including detailed query parsing and result mapping operations.
Index Group Availability
Missing or inactive index groups commonly cause search failures for specific data types.
Verify that the required index group is active by examining the IndexRecordContainer configuration. Navigate to the specific group configuration and confirm that the group status is set to active.
Check whether the group contains indexed data by running a FullIndexer operation for the specific group. Empty groups will not return search results even when properly configured.
Permission-Based Search Restrictions
Entity-level permissions can prevent search results from appearing for users who lack appropriate access rights.
When permissions are active for an index group, verify that all fields used by the permission logic are included in the index schema. Missing permission fields will cause the search system to exclude results even when users have appropriate access rights.
Review the entity permission configuration to ensure that permission field mappings correspond to indexed field names and data types.
Pattern Extension Validation
Custom search patterns may contain syntax errors that prevent proper query execution.
If a PatternExtension is configured in the RecordContainer, verify that the pattern syntax is correct by testing it through the advanced search interface. Monitor the process logs to confirm that the pattern is properly parsed and executed.
Incorrect pattern syntax can cause search operations to fail silently or return unexpected results. Test pattern logic with known data sets to validate proper functionality.
Problem isn't solved?
For additional troubleshooting guidance on specific search scenarios, refer to these specialized guides: