Error Messages

This comprehensive guide provides detailed explanations and solutions for error messages that may occur when using the Drag & Drop extension in Business Central.

Installation and Configuration Errors

Extension Management Errors

Error: "Extension could not be installed"

Full Message: "The extension 'Drag & Drop' could not be installed. Please contact your system administrator."

Cause: Installation permissions or system requirements not met
Solution:
1. Verify System Administrator permissions for installing user
2. Check Business Central version compatibility (14.0 minimum required)
3. Ensure sufficient database storage space available
4. Verify Q-Team App Authenticator dependency is available
5. Contact Microsoft partner for On-Premise installation assistance

Error: "Dependency not found"

Full Message: "Cannot install extension because required dependency 'Q-Team App Authenticator' is not available."

Cause: Q-Team App Authenticator not installed or incompatible version
Solution:
1. Install Q-Team App Authenticator from AppSource (SaaS)
2. Download and install manually (On-Premise)
3. Verify compatible version numbers
4. Contact Q-Team Solutions for dependency resolution assistance

Error: "License validation failed"

Full Message: "Extension cannot be activated due to license validation failure. Please check your license configuration."

Cause: Business Central license missing required Q-Team modules (On-Premise)
Solution:
1. Contact license partner to add Q-Team modules to license
2. Required modules: "Q-Team Authenticator", "Q-Team Project Dossier"
3. Upload updated license file to Business Central
4. Restart Business Central service if required
5. Verify license includes drag-and-drop functionality

Permission and Access Errors

Error: "Insufficient permissions"

Full Message: "You do not have permission to access the Drag & Drop functionality."

Cause: Permission set not assigned to user
Solution:
1. Navigate to Users page in Business Central
2. Select affected user account
3. Add "QTEAM DRAG AND DROP" permission set
4. Ensure effective dates are appropriate
5. Sign out and sign back in to refresh permissions

Error: "Cannot access external service"

Full Message: "The system cannot connect to Q-Team Solutions for license validation. Please check your network connection."

Cause: Network connectivity issues preventing license validation
Solution:
1. Verify internet connectivity from server (On-Premise)
2. Check firewall rules for outbound HTTPS access
3. Test connectivity to q-teamsolutions.com domain
4. Configure proxy settings if required
5. Contact network administrator for access configuration

File Upload Errors

File Validation Errors

Error: "File type not supported"

Full Message: "The file type '{file-extension}' is not supported for upload."

Cause: File format not included in supported types list
Solution:
1. Convert file to supported format (PDF, DOCX, XLSX, etc.)
2. Verify file extension is correct for file content
3. Check corporate security policies for file type restrictions
4. Rename file with appropriate extension if content is valid
5. Contact administrator for file type policy clarification

Error: "File size exceeds maximum"

Full Message: "The file size ({size} MB) exceeds the maximum allowed size of {max-size} MB."

Cause: File larger than configured maximum size limit
Solution:
1. Compress file to reduce size below limit
2. Split large documents into multiple smaller files
3. Convert to more efficient format (e.g., PDF optimization)
4. Contact administrator to review size limit configuration
5. Consider alternative storage for very large files

Error: "Invalid file name"

Full Message: "The file name contains invalid characters. Please rename the file and try again."

Cause: File name contains characters not permitted by Business Central
Solution:
1. Remove special characters: < > : " / \\ | ? *
2. Replace spaces with underscores or hyphens if needed
3. Limit file name length to reasonable size (< 150 characters)
4. Use only alphanumeric characters and standard punctuation
5. Avoid non-English characters if experiencing issues

Upload Process Errors

Error: "Upload failed - network timeout"

Full Message: "File upload failed due to network timeout. Please try again."

Cause: Network connection interrupted during upload
Solution:
1. Check internet connection stability
2. Try upload during off-peak network hours
3. Use wired connection instead of WiFi for large files
4. Contact network administrator if timeouts persist
5. Consider uploading files individually rather than in batches

Error: "Upload failed - server error"

Full Message: "File upload failed due to server error. Please contact your administrator."

Cause: Business Central server issue preventing file storage
Solution:
1. Try upload again after brief delay
2. Check Business Central service status
3. Contact administrator to verify server disk space
4. Review Business Central error logs for specific error details
5. Report to Q-Team Solutions if error persists

Error: "File could not be processed"

Full Message: "The uploaded file could not be processed. Please verify file integrity and try again."

Cause: File corruption or invalid file format
Solution:
1. Re-download or re-save original file
2. Scan file for corruption with file verification tools
3. Try opening file in appropriate application to verify integrity
4. Upload from different source location
5. Convert file to alternative format and retry

Browser and Client-Side Errors

JavaScript and Browser Errors

Error: "Drag and drop not supported"

Full Message: "Drag and drop functionality is not supported in your current browser."

Cause: Older browser version or JavaScript disabled
Solution:
1. Update browser to latest version (Edge, Chrome, Firefox recommended)
2. Enable JavaScript in browser settings
3. Disable browser extensions that might block JavaScript
4. Use click-to-browse alternative if available
5. Contact IT support for browser configuration assistance

Error: "FileReader API not available"

Full Message: "File reading functionality is not available. Please upgrade your browser."

Cause: Legacy browser lacking HTML5 FileReader API support
Solution:
1. Upgrade to modern browser version
2. Enable HTML5 features in browser settings
3. Clear browser cache and restart
4. Use alternative browser for drag-and-drop functionality
5. Contact IT support for browser upgrade assistance

Error: "Access to file system denied"

Full Message: "Cannot access files due to security restrictions."

Cause: Browser security policies preventing file system access
Solution:
1. Check browser permissions for Business Central site
2. Allow file access for Business Central domain
3. Disable strict security extensions temporarily
4. Try files from local drive instead of network locations
5. Contact IT support for security policy configuration

Memory and Performance Errors

Error: "Out of memory"

Full Message: "Insufficient memory to process file. Please close other applications and try again."

Cause: Browser or system running low on available memory
Solution:
1. Close unnecessary browser tabs and applications
2. Restart browser to free up memory
3. Process smaller files or reduce batch size
4. Increase virtual memory allocation if possible
5. Try upload on different computer with more memory

Error: "Processing timeout"

Full Message: "File processing timed out. Please try with smaller files or contact support."

Cause: File too large or complex for efficient processing
Solution:
1. Reduce file size through compression or optimization
2. Split large files into smaller components
3. Try uploading individual files rather than batches
4. Check available system resources and close other applications
5. Contact Q-Team support for processing limitations guidance

Business Central Integration Errors

Record and Context Errors

Error: "Invalid record context"

Full Message: "Cannot attach file because record context is invalid or missing."

Cause: FactBox not properly linked to current Business Central record
Solution:
1. Ensure record is saved before attempting file upload
2. Refresh page to reload FactBox context
3. Navigate away from record and back to refresh context
4. Check that record has valid primary key values
5. Contact administrator if context errors persist

Error: "Record access denied"

Full Message: "You do not have permission to attach documents to this record."

Cause: User lacks modify permissions for source record
Solution:
1. Verify user has appropriate permissions for record type
2. Check if record is locked by another user
3. Contact administrator to review permission set assignments
4. Ensure user has Document Attachment table permissions
5. Try accessing record with different user account for testing

Error: "Document attachment table locked"

Full Message: "Cannot save attachment because the document attachment table is locked."

Cause: Database concurrency issue or maintenance operation
Solution:
1. Wait a few moments and try upload again
2. Check if system maintenance is in progress
3. Verify other users are not experiencing same issue
4. Contact administrator to check database lock status
5. Report persistent locking issues to technical support

Database and Storage Errors

Error: "Database storage full"

Full Message: "Cannot save file because database storage capacity has been exceeded."

Cause: Business Central database approaching storage limits
Solution:
1. Contact administrator to check database storage usage
2. Review document attachment retention policies
3. Clean up old or unnecessary attached documents
4. Plan for database storage expansion
5. Consider external storage solutions for large files

Error: "Document attachment failed to save"

Full Message: "The file was uploaded but could not be saved to the database."

Cause: Database connectivity or transaction issue
Solution:
1. Try upload again after brief delay
2. Check Business Central database connection status
3. Verify database disk space and resources
4. Review Business Central error logs for specific database errors
5. Contact database administrator for transaction investigation

Q-Team Authenticator Errors

License and Validation Errors

Error: "License expired"

Full Message: "Your Q-Team Solutions license has expired. Please renew your license."

Cause: Annual license renewal required
Solution:
1. Contact Q-Team Solutions for license renewal
2. Check license expiration date in system
3. Verify payment and renewal status
4. Update license information if renewed
5. Plan for automatic renewal if available

Error: "License user limit exceeded"

Full Message: "Cannot activate functionality because user license limit has been exceeded."

Cause: More users than licensed attempting to use functionality
Solution:
1. Review license terms for user limitations
2. Check active user count against license allocation
3. Contact Q-Team Solutions to increase user limit
4. Remove unused user assignments if applicable
5. Consider license upgrade for additional users

Error: "Authentication service unavailable"

Full Message: "Cannot validate license because Q-Team authentication service is unavailable."

Cause: Q-Team Solutions service temporarily down or connectivity issue
Solution:
1. Check Q-Team Solutions service status
2. Verify internet connectivity for license validation
3. Try functionality again after brief delay
4. Contact Q-Team support if service issues persist
5. Check firewall configuration for Q-Team domain access

Troubleshooting Error Resolution

Systematic Error Diagnosis

Step 1: Error Classification - Installation/Configuration errors → Check system requirements and permissions - File upload errors → Verify file properties and network connectivity<br> - Browser/Client errors → Test browser compatibility and settings - Business Central integration errors → Check record access and database status - Q-Team Authenticator errors → Verify license status and connectivity

Step 2: Information Collection

Gather the following information for support:
- Exact error message text and error code (if provided)
- Business Central environment details (SaaS/On-Premise, version)
- Browser type and version information
- File details (size, type, name) when applicable
- User account and permission set information
- Steps taken immediately before error occurred

Step 3: Resolution Escalation

1. Self-Service: Follow specific solution steps provided above
2. Administrator: Contact internal Business Central administrator
3. Q-Team Support: Contact Q-Team Solutions for extension-specific issues
4. Microsoft Support: Contact for Business Central platform issues
5. Emergency: Use alternative document attachment methods as temporary workaround

Preventive Measures

Error Prevention Strategies: - Regular system and browser updates - User training on proper file preparation - Proactive monitoring of system resources and licensing - Clear documentation of supported file types and sizes - Regular testing of functionality across different user scenarios

This comprehensive error message guide enables quick identification and resolution of issues encountered while using the Drag & Drop extension. For errors not covered in this documentation, contact Q-Team Solutions support with complete error details and system information.