Code Sample: Custom Error Messages

SharePoint 2010

Last modified: December 03, 2013

Applies to: SharePoint Server 2010

Note Note

The information in this topic applies to SharePoint 2013 as well as to SharePoint 2010. The samples provided in the SharePoint 2010 SDK also work in SharePoint 2013, but are not included in the SharePoint 2013 SDK.

The Custom Error Messages sample is one of three sample JavaScript files in the SharePoint 2010 SDK download file (SharePoint 2010 Reference: Software Development Kit) that show best practices for programming the Visio Web Access Web Part. The Custom Error Messages sample shows how to use the Visio Web Access Web part to display and hide custom HTML error messages. It creates a user interface for the code sample that consists of two text boxes, which are used to capture the error message title and body, and two buttons to show and hide the error message.

The JavaScript samples included in this SharePoint 2010 SDK are as follows:

  • Annotations sample

  • Custom Error Messages sample

  • Mouse Interaction sample

You can use these JavaScript files on your own Web Parts pages. The SharePoint 2010 SDK provides a brief document for each sample that explains how to use it, and the code in each sample file includes extensive explanatory comments.

  1. Download the SharePoint 2010 Reference: Software Development Kit, which includes the Custom Error Messages sample.

  2. When you install the SharePoint 2010 SDK, the compressed (.zip) file that contains the samples is installed by default in the path C:\Program Files (x86)\Microsoft SDKs\SharePoint 2010\Samples\Visio Services. You can extract the samples to a folder location you select.

After you download the SharePoint 2010 SDK and extract the sample, complete the following procedures. These procedures are explained in Customizing Visio Web Drawings in the Visio Web Access Web Part in this SharePoint 2010 SDK.

  1. Create or open an existing Visio drawing that contains several shapes and save it as a .vdw file to a document library.

  2. Create a Web Parts Page in Microsoft SharePoint Server 2010 and add a Visio Web Access Web Part to the page.

  3. Add a Content Editor Web Part to the same page.

  4. Link the Content Editor Web Part to the CustomErrorMessages.js file.

You should also follow the additional instructions that are provided in the comments in the sample file.