Alteryx Designer

Definitive answers from Designer experts.
Register for the upcoming Live Community Q&A Session - and don't forget to submit your questions for @DeanS regarding the future role of analytics here.

Unhandled Exception Occurred, Now What?

Alteryx
Alteryx
Created

Where do you start when you see "An Unhandled Exception occurred"?  There could be a wide range of causes for this kind of error, so the resolution requires that you collect some more information.

Prerequisites
  • Alteryx Designer or Alteryx Server
    • all versions

Procedure

The error information shown below is vague, so when you see it, you might not immediately know what to do about it. 
An Unhandled Exception occurred.

A previous action may not have completed successfully.

Click OK to send the development team the error log so that we can fix this error in a subsequent release. 

idea Skyscrapers

This error message is a catch-all.  What it means is that you've done something beyond what the programmers expected. 
Be proud of your innovation!
idea Skyscrapers
  1. Pay close attention to what you were doing when the error occurred.  Were you modifying a tool's configuration or issuing some sort of command like opening, running, or saving something?
  2. Look for Error Logs that might have been generated for the error.
    1.  If ErrorLogs have been created, they'll likely be in %ProgramData%\Alteryx\.  ProgramData is a hidden directory, so you may need to paste that path into your File Explorer or set it to show Hidden Items:
      idea Skyscrapers
    2. If the ErrorLogs directory exists, open it and look for appropriate time stamps, including within subdirectories.
      idea Skyscrapers
    3. If there is a log that has an appropriate time stamp, particularly in the AlteryxGui subdirectory, open it in an editor like Notepad or Notepad++, and see what it says beside "Message:".  There are some examples below:
      idea Skyscrapers
      idea Skyscrapers
      idea Skyscrapers
      idea Skyscrapers
    4. If you can tell what the problem is, go ahead and fix it.  Even if you cannot interpret the Message, then at least you can search Community with more information than just "Unhandled Exception."
    5. If you cannot find relevant information in the Community, then please open a case by contacting Customer Support and describe what you were doing when you saw the Unhandled Exception, preferably with a full screen shot that includes context.  Also provide the error log you found.
Additional Resources