Troubleshooting
This comprehensive guide covers common issues, problems, and their solutions across all worksheet functionality including row operations, column operations, data management, navigation, performance, menu options, and linking.
Row Operation Issues
Cannot Add Rows
- Check Permissions: Verify user has create permissions & create link option is enabled in worksheet configuration
- Relationship Constraints: Check if relationship cardinality allows additional rows
Cannot Delete Rows
- Permission Check: Verify delete permissions on selected rows & state of the rows
Row Reordering Not Working
- Enable Reordering: Check if "Allow Reordering" is configured
- Permission Check: Verify user has edit permissions
Validation Errors
- Required Fields: Ensure all mandatory fields have values
- Data Format: Check that data matches expected format (dates, numbers, etc.)
- Business Rules: Review custom validation rules applied using regex that may be failing
Column Operation Issues
Filtering Not Working
- Check Reordering: Ensure row reordering is disabled
- Data Type Issues: Verify filter criteria match column data type
Column Display Issues
- Hidden Columns: Check column visibility configuration
- Width Problems: Verify column width configuration
- Header Display: Ensure column labels are properly configured
- Data Loading: Check if data is properly loaded for the column
Data Management Issues
Save Issues
- Validation Errors: Fix highlighted validation errors before saving
- Network Problems: Check internet connection stability
- Permission Changes: Verify user still has save permissions
- Concurrent Edits: Handle conflicts with other users' changes
Copy-Paste Issues
- Unsupported Fields: User and Reference fields don't support copy-paste
- Format Mismatch: Ensure data format matches field requirements
- Date Format Issues: Ensure date formats match system configuration
- Permission Restrictions: Verify user has edit permissions for the column
- Large Data: Break large paste operations into smaller chunks
- Browser Limitations: Check browser clipboard access permissions
Auto-fill Limitations
- Complex Data Types: Auto-fill not supported for Reference - enter each field value individually using appropriate selectors
Export Failures
- Permission Issues: Verify export configuration for worksheet
- Format Problems: Check data formatting in export results
- Network Timeouts: Retry failed exports or reduce data volume
Auto-save Issues
- Network Connectivity: Auto-save may fail during network connectivity issues
- Large Data: Large amounts of data may cause server performance issues
- Concurrent Users: Data conflicts, lost changes, inconsistent states
Menu Operation Issues
Menu Options Not Appearing
- Right-click Location: Make sure you are right clicking on worksheet cells or headers to open context menu
- Permission Check: Verify user has necessary permissions
- Browser Refresh: Try refreshing the browser page
- Data State: Some options only appear with specific data conditions
Operations Failing
- Validation Errors: Check for data validation issues
- Session Timeout: Re-login if session has expired
- Network Problems: Verify internet connection stability
Menu Performance Issues
- Large Operations: Break large operations into smaller chunks
- Data Volume: Use filters to reduce dataset size before operations
- Network Problems: Verify internet connection stability
Navigation Issues
Keyboard Shortcuts Not Working
- Browser Focus: Ensure worksheet has focus
- Custom Editors: Remember limitations with custom field editors
- Operating System: Verify correct key combinations for your OS
Performance Issues
Unresponsive Editing
- Check Validation: Verify data matches expected format and any regex validation added for field
- Review Field Types: Check for conflicts with complex field types
Slow Initial Loading
- Apply Filters: Use default filters to reduce initial dataset
- Clear Cache: Clear browser cache to improve loading speed
General Resolution Strategies
Immediate Fixes
- Refresh Browser: Often resolves temporary display or interaction issues
- Clear Cache: Remove cached data that might be causing problems
- Check Permissions: Verify user has appropriate access rights
- Reload Data: Refresh worksheet data to get latest information
- Retry Operations: Attempt failed operations again after a brief pause
Best Practices to Avoid Issues
Data Management
- Regular Saves: Save work frequently to prevent data loss
- Validate Early: Fix validation errors as soon as they appear
- Use Filters: Apply filters to work with manageable data sets
- Test Changes: Verify changes work correctly before proceeding
- Backup Data: Export important data regularly
Performance Optimization
- Limit Columns: Show only necessary columns to improve performance
- Reduce Data Volume: Use appropriate filters and pagination
- Network Awareness: Consider connection quality when working with large datasets