Definitions validation |
Validation is very important in SharePoint development, because SharePoint itself very often hides errors or provides useless exception messages. Fluent Ribbon always validates your ribbon elements definitions, and display very descriptive messages, if, for example, some required fields were missed.
When you pass definition of a Ribbon tab or contextual tab group into Fluent Ribbon, this definitions are first of all will be validated using Fluent Ribbon internal validation routines.
Validation is performed at run-time, when your Application Page or WebPart Page is loaded into one's browser, or when Feature with RibbonCustomAction code is activated.
If validation is failed, ValidationException will be thrown, and the Error page will be displayed. To get the error description, you should observe your ULS logs, located in "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\LOGS" folder.
Also you can configure IIS to display error text right in the browser. In this case, you need to turn CustomErrors setting to "Off" or "RemoteOnly" value in your web.config file:
<customErrors mode="Off" />
or
<customErrors mode="RemoteOnly" />
RemoteOnly option allows to display errors only to localhost clients.
Actually you need to change two web.config files:
For Application Pages, web.config file is located in "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS" folder.
For Webpart Pages and lists, web.config file is located inside "inetpub" folder, under your portal virtual directory folder. For instance, if you have portal on the default, 80 port, you will need "C:\inetpub\wwwroot\wss\VirtualDirectories\80\web.config" file.
After these changes, you will see the error message right in your browser, for example: