Skip to main content

Troubleshooting

Welcome to the Dime.Scheduler troubleshooting hub. This central resource helps you quickly find solutions to common issues across all areas of the platform. Whether you're experiencing integration problems, user interface issues, or configuration challenges, you'll find guidance here.

Troubleshooting by Area​

Select the area that matches your issue to find detailed troubleshooting guides:

User Troubleshooting
Resolve common issues users encounter when working with the planning interface.
Login Issues • Planning Board • Profile Layouts • Permissions
Administration
Diagnose and fix administrative configuration and setup problems.
User Management • Field Templates • Settings
Business Central Integration
Troubleshoot data synchronization and integration issues with Business Central.
Connection Issues • Transaction Errors • Authentication • Timeouts
NAV Integration
Resolve integration problems with Microsoft Dynamics NAV.
Web Services • Appointments • Data Sync
Exchange Integration
Fix calendar synchronization and Exchange connectivity issues.
Calendar Sync • Authentication • Mailbox Access

General Troubleshooting Tips​

Before diving into specific guides, try these general steps:

1. Check System Status & Connectivity​

  • Verify service availability: Ensure Dime.Scheduler and connected systems are online
  • Review recent changes: Consider any recent updates, configuration changes, or system maintenance
  • Check browser console: Open your browser's developer tools (F12) to look for JavaScript errors

2. Review Transaction Logs​

Most integration issues can be diagnosed by checking the transaction logs:

  1. Navigate to Administration > Transactions > Errors
  2. Look for failed transactions related to your issue
  3. Click on a transaction to view detailed error messages
  4. Use the error message to find specific solutions in the relevant troubleshooting guide

3. Verify Authentication & Permissions​

  • Check authentication: Confirm credentials are valid and haven't expired
  • Verify permissions: Ensure user roles and service accounts have necessary access
  • Review API keys: Check that API keys have the required scopes and secrets have not expired

4. Clear Cache & Refresh​

Sometimes browser cache can cause unexpected behavior:

  • Clear your browser cache (Ctrl+Shift+Delete)
  • Hard refresh the page (Ctrl+F5 or Cmd+Shift+R)
  • Try in an incognito/private browser window
  • Log out and log back in

Common Error Patterns​

Transaction Errors​

Symptoms: Appointments don't sync, error badges appear, notifications show failures

Where to look:

Connection Issues​

Symptoms: "Cannot connect", timeout errors, 504 gateway timeout errors

Common causes:

  • Firewall blocking traffic (most common)
  • Incorrect URL in connector configuration
  • Service not running or unavailable
  • Network routing problems
  • Profiles and layouts configured to load excessive amounts of data

Where to look:

Authentication Failures​

Symptoms: "Unauthorized", "Authentication failed", credentials rejected

Common causes:

  • Expired or incorrect credentials
  • Wrong authentication method selected
  • User account locked or disabled
  • API key expired or revoked

Where to look:

User Interface Issues​

Symptoms: Components not loading, blank screens, layout problems

Common causes:

  • Browser compatibility
  • Cached resources
  • Profile or layout configuration
  • JavaScript errors

Where to look:

Integration-Specific Guides​

Business Central​

The most comprehensive troubleshooting resources for Business Central integration:

Microsoft Dynamics NAV​

Exchange​

Other Integrations​

Getting Additional Help​

If you can't find a solution in these guides:

1. Gather Diagnostic Information​

Before contacting support, collect:

  • Error messages: Complete error text from transaction logs
  • Screenshots: Capture the issue, configuration screens, and any error dialogs
  • Steps to reproduce: Document the exact steps that trigger the issue
  • Timing: Note when the issue started and if it's consistent or intermittent
  • System info: Browser version, Dime.Scheduler version, connected system versions

2. Contact Support​

3. Report Bugs​

If you've found a bug:

  • Document the issue clearly with steps to reproduce
  • Include screenshots and error messages
  • Note the expected vs actual behavior
  • Submit through the support portal

Stay Updated​

  • Check Release Notes: New versions often fix known issues
  • Review Documentation: Guides are regularly updated with new solutions
  • Monitor System Health: Use the System Monitoring page
Need Immediate Help?

For urgent issues affecting production systems, contact Dime.Scheduler Support directly with your diagnostic information ready.

Last updated on by Hendrik Bulens