Skip to content

TSTool / Troubleshooting

Troubleshooting TSTool for TimesheetsCom involves confirming that the core product and plugin are performing as expected. Issues may also be related to timesheets.com data.

Troubleshooting Core TSTool Product

See the main TSTool Troubleshooting documentation.

Troubleshooting TimesheetsCom TSTool Integration

The following sections summarize typical issues that are encountered when using TSTool with the TimesheetsCom plugin. Use the following as resources for troubleshooting:

  • The TSTool View / Datastores menu item displays the status of datastores.
  • The TSTool Tools / Diagnostics - View Log File... menu item displays the log file. A text editor can also be usd to edit the log file.
  • Set the Debug=True property in the datastore configuration to turn on more logging messages. If the API changes, an error message is typically returned that indicates the problem.

Commands(Plugin) Menu Contains Duplicate Commands

If the Commands(Plugin) menu contains duplicate commands, TSTool is finding multiple plugin jar files. To fix, check the plugins folder and subfolders for the software installation folder and the user's .tstool/NN/plugins folder. Remove extra jar files, leaving only the version that is desired (typically the most recent version).

Web Service Datastore Returns no Data

If the web service datastore returns no data, check the following:

  1. Review the TSTool log file for errors. Typically a message will indicate an HTTP error code for the URL that was requested.
  2. Copy and paste the URL into a web browser to confirm the error. The browser will typically show a specific web service error message such as a missing query parameter or typo.
  3. See the timesheets.com API documentation to check whether the URL is correct.
  4. Add Debug=True to the datastore configuration file and restart TSTool. Look for API errors and possible changes to the API that require software changes.
  5. Contact timesheets.com support for to determine whether data limits are in place. A recent enhancement to the API will allow limits to be checked and needs to be implemented in TSTool.

If the issue cannot be resolved, contact the Open Water Foundation.