Troubleshooting Canvas

Once you have begun creating screens with Canvas, you might try something that doesn't go as expected including the following:

• Make a suggestion
• Report an issue
• Reset your workspace
• Resolve a compiler (validation) error
• Resolve a preview (run mode) error

To Make a Suggestion

1. Consider options to a current function or behavior you would like to see changed.
2. Imagine or provide an example of how a specific option or feature could behave to really impress you.
3. Send us your feedback. Ask us, tell us, or show us!

To Report an Issue

1. Review the steps you took prior to the problem occurring.
2. If possible, try reproducing the same process and seeing what results you get this time.
3. Send us the exception report, including experience details.

To Reset your Workspace

If your workspace is in a state such that you want to just start fresh, you can:

1. In the Backstage view, click Settings and then Settings folder to access your settings files.
2. Close the Canvas application.
3. Find the canvas.workspace file (Users\<CurrentUser>\AppData\Roaming\Canvas) and delete it. The workspace will be reset, and the file will be regenerated the next time Canvas is closed.

To Resolve a Compiler Error

1. When you validate script, an error may be reported, such as:

   "The type or namespace name '{X}' does not exist in the namespace 'CygNet.API' (are you missing an assembly reference?)"

2. Perhaps the linked assembly is not located in the Global Assembly Cache, nor is it co-located with your Canvas application in the folder structure. If so, try the following:
   1. Copy the assembly to the same folder location as your Canvas.exe file.
   2. Restart your Canvas application.
   3. Validate the script to see if it compiles successfully.

To Resolve a Preview Error

When you preview a screen to view it in run mode, an error may occur, such as an expected CygNet value not resolving properly in your control. In this situation, perhaps the Point Tag format is incorrect. Try the following to learn more:

1. Check your Canvas log file (for example, Canvas001.csv in the Users\<CurrentUser>\AppData\Local\CygNet\LogFiles\Canvas folder) to view more specific error messages or see additional details that could inform you about the error.
2. Solve any likely issues that were found.
3. Run the screen again to see if it now behaves as expected.