Error Messages

This page lists a variety of error messages you might see when developing with WebWidgets, and how to fix them.

Front-End / JavaScript Errors

There are a variety of errors that can happen during a syncItem() call.

• MaintenanceMode :: The administrator of the system has put it into Maintenance Mode. This can happen when the service is being moved to a new machine. In that case, if an update was made on the old machine it might not get carried over to the new machine, so it is better to prevent updates. The administrator should have include a message about when the service will return to normal mode.
• UserLoggedOut :: This is a relatively common error that means your session has expired. This can happen if you load a page in a tab, leave it open for a while, then come back and make some updates. You can normally fix this by reloading the page, and logging-in again.
• AccessDenied :: This means the user does not have write permissions for the Widget DB corresponding to the update. Widget developers should try to avoid showing data-update options (create new, edit, etc) to users who do not have write permissions.
• EmailProblem :: This error occurs when attempting to create an Widget Email record that is improperly formatted. Possible issues could include: the email address is not formatted properly, the email body does not have the required footer tag, or the sender is not allowed to deliver messages to the recipient. See the Send Email documentation for more info.
• WidgetNotFound :: This means that the Widget corresponding to the update could not be found. This error should be extremely rare if the Widget code is properly written; it might happen if the Widget developer tried to change the private internal data in the WWIO JavaScript API.
• SyncError :: This error means that another user has modified the exact record you are trying to update, in the time since you loaded the page. If we allow this update to proceed, it is possible that one user could inadvertently overwrite another user's info. Widget developers should design their data schemas to avoid situations where multiple users might attemp to update the same record at the same time.
• NumberConversionError :: This happens when the user tries to enter an integer that is larger than 2.1 billion. The WWIO backend does not currently support these large integer values. If you need to use very large numbers, you could 1) split the number up into two values, one representing a "billions" quantity and the other representing the remainder, 2) simply use a string type.

Data Upload Errors

These are errors you might see when you attempt to upload Widget code or DBs to the WWIO server, using the Python scripts. Note that the WWIO server will reject an entire upload if any error is encountered, it will never partially apply an update. The Python scripts will attempt to catch some of these errors.

• CodeFormatError :: This means your Widget code files are incorrectly formatted. While Widget code technically uses the ".jsp" extension, you cannot use any JSP tags other than the DataInclude commands.
• IncludeArgError :: This error is caused by attempting to use an incorrectly formatted DataInclude argument. Badly composed arguments will cause errors when you attempt to load the widget page, so following the "fail-fast" principle, the server tries to reject code with erroneous formatting as early as possible.
• MailboxError :: This happens when you try to upload a Widget mailbox DB. Mailbox DBs can be downloaded but not uploaded.
• BlobStoreError :: This is caused by attempting to upload a Widget DB that has improperly named blob-store columns. In order to use the blob store feature, you must following the naming rules exactly, see Blob Storage for more info.
• MissingWidgetError :: You attempted to upload a DB or code-zip, but there was no Widget found with that name. You need to create new Widgets in the Admin Console before uploading. There are a few exceptions to this rule for specially-named code data with special names like "include".
• ReservedNameError :: You attempted to upload a Widget DB or Zip file with a reserved name. Please give your widgets distinctive names.
• UploadSizeError :: This happens when you attempt to upload a Widget DB or code ZIP file that is too large. The WWIO system is designed for modestly sized datasets. If you want to use very large asset files such as video or photos, please use the Blob Storage feature.