SharePoint 2010 Cookbook: How to Fix ‘Unable to display this Web Part’ when Working with External Lists in SharePoint 2010

Contrary to the behavior of the BDC in SharePoint 2007, SharePoint 2010 creates Business Connectivity Services (BCS) through SharePoint Designer 2010, and not via Central Administration. This can be pretty strange for someone who’s used to the SharePoint 2007 method, and you may encounter some issues while configuring the BCS. In this article, we’ll take a look at how to fix some problems that may arise when you work with an External List or connect to SQL Server 2008 through the BCS features.

Challenge:

One issue you may encounter involves the following message:

Unable to display this Web Part. To troubleshoot the problem, open this Web page in a Microsoft SharePoint Foundation-compatible HTML editor such as Microsoft SharePoint Designer. If the problem persists, contact your Web server administrator. Correlation ID: ………..“.

I should mention that I have also encountered this error when working with an External List.

Solution:

To solve this problem, we will need to execute a PowerShell cmdlet and change the configuration.

Step by step:

1. Open SharePoint 2010 Management Shell: Start -> Microsoft SharePoint 2010 Products.

First type the following command: “Get-SPServiceApplicationProxy”

You will see a list of services in the form of proxy applications, including Business Data Connectivity Service.

2. Next type the command:
Get-Database-ThrottleType SPBusinessDataCatalogThrottleConfig-Scope Items-ServiceApplicationProxy 25572329 … (Depending on the service’s GUID BDC)

3. Now, you change the throttle.
$ Db = Get-SPBusinessDataCatalogThrottleConfig-Scope ThrottleType Items Database-GUID-ServiceApplicationProxy ..
Set-SPBusinessDataCatalogThrottleConfig-Identity $ Db-8000-default maximum 6000

After completing the three steps above, you can connect to SQL Server 2008 through the BCS features successfully, without an error message in sight.

See Also:

  • SharePoint 2010 Cookbook: Creating an Association Between External Content Types for BCS Configuration Using SharePoint Designer 2010
  • SharePoint 2010 Cookbook: How to Create External Lists & Include Databases Using SharePoint Designer 2010