- 3.3.4 Common Issues and Troubleshooting
- Issue: File Size Exceeds Limit
- Description: Users attempt to upload a document larger than 10 MB.
- Resolution:
- Action: Display an error message indicating the file size limit.
- Steps:
- Inform the user to upload a smaller file.
- Suggest compressing the document or splitting it into smaller parts if necessary.
- Issue: Unsupported File Type
- Description: Users try to upload a file type that is not allowed (e.g., .exe, .jpg).
- Resolution:
- Action: Display an error message specifying the allowed file formats.
- Steps:
- Instruct the user to convert the file to a supported format (e.g., .txt, .pdf).
- Provide guidelines on acceptable document types.
- Issue: Invalid File (Double Extensions)
- Description: Users attempt to upload files with double extensions (e.g., report.pdf.exe).
- Resolution:
- Action: Reject the upload and display an error message regarding invalid file names.
- Steps:
- Advise the user to rename the file to remove additional extensions.
- Ensure the file name ends with a single, allowed extension.
- Issue: Failed MIME Type Validation
- Description: The system detects an invalid MIME type for the uploaded file.
- Resolution:
- Action: Reject the upload and notify the user of the invalid file.
- Steps:
- Instruct the user to verify the file’s integrity and format.
- Suggest re-saving the document in a supported format.
- Issue: Unable to Download Document
- Description: Users encounter errors when attempting to download a document.
- Resolution:
- Action: Check the server status and ensure the file is available.
- Steps:
- Verify network connectivity.
- Refresh the page and attempt the download again.
- Contact support if the issue persists.
- Issue: Unable to Delete Document
- Description: Users are unable to delete a document from the repository.
- Resolution:
- Action: Ensure the user has the necessary permissions to delete documents.
- Steps:
- Verify user roles and access rights.
- Check for any system errors or ongoing processes that might prevent deletion.
- Contact support if the issue remains unresolved.
- Issue: File Size Exceeds Limit
Common Issues and Troubleshooting
Updated on August 26, 2025
devdocs