Scenario
I have a requirement wherein I will be using External Content Type (BCS) using a Stored Procedure.
- The stored procedure has parameters.
- I have to set up Read List and Read Item operations.
Objective
The objective of this exercise is to write a Stored Procedure that returns a list of SharePoint History from the SharePoint Test database and displays these results by using the Business Data List web part. We will also see how we can use various filters (ID for our example) to limit the result set returned by the stored procedure.
Steps:
Create External Content Type
In this step, we will use SharePoint Designer to create an External Content Type from the stored procedure created in the previous step.
- Browse to the “SharePoint – 80″ site in your development environment.
- On the Site Actions drop-down, click Edit in SharePoint Designer.
- In the Navigation pane, click External Content Types.
- In the New group of the ribbon, click External Content Type.
- In the External Content Type Information group, edit each of the parameters as below and leave the remaining to their default settings.
Property | Value |
Name | SharePoint History |
Display Name | SharePoint History |
Namespace | SharePointTest |
Version | 1.0.0.0 |
- Next to External System, click Click here to discover external data sources and…
- In the Data Source explorer, expand the SharePoint Test to find the stored procedure sp_Sharepoint_History under the Routines node.
- Right click on sp_Sharepoint_History to open a pop-up menu and click New Read List Operation.
- Click the Next > button at the bottom of the Read List dialog.
- On the Input Parameters page, click @ID in the Data Source Elements pane.
- In the Properties pane, edit the values as below. Then, click Click to Add against the Filter property.
- In the Filter Configuration dialog, select New Filter. Edit the properties as below leaving the rest to their default. Then click OK.
Property | Value |
New Filter | ID |
Filter Type | Comparison |
Operation | Equals |
- Click the Next> button at the bottom of the Read List dialog.
- On the Return Parameters page, click ID in the Data Source Elements pane.
- In the Properties pane, check the box for Map to Identifier and Show In Picker.
- Click the Finish button.
- Click the Save button in the Quick Access Toolbar to commit the changes.
- Navigate to your SharePoint 2013 site.
- From this page select the Site Actions | Edit Page.
- Click on Add a Web Part, in the left web part zone.
- From the web parts selection menu, select Business Data in the Categories section and then from the list of web parts select Business Data List and click add.
- From the web part’s action menu, click on Edit Web Part to open the tool pane for this web part.
- In the Business Data List section of the edit pane, click on the picker icon next to Type field to bring up the External Content Type Picker dialog form.
- In the dialog form, select the content type created in the previous steps and click OK.
- For the View Property, select Default (SharePoint History Read List) in the drop down.
- Then click OK in the web part’s tool pane.
Final O/P:
Summery:
Now we have seen how to configure the External Content Type and Business data List Web Part to make BCS looks like SharePoint List. Hope you enjoyed my article.
Read more articles on SharePoint: