Code Sample: Sample Orders ASP.NET Web Service

Applies to: SharePoint Server 2010

The Orders ASP.NET Sample Web Service sample shows how to use an ASP.NET Web service as an external system. The Web service exposes methods for Create, Read, Update, and Delete (CRUD) operations and other methods that return data based on relationships between the different entities. This Web service creates the data on-the-fly without storing or retrieving it in a database.

The Web methods that this sample exposes are equivalent to the following Business Data Connectivity (BDC) service stereotype methods:

AccessChecker, AssociationNavigator, Associator, BulkAssociatedIdEnumerator, BulkAssociationNavigator, BulkIDEnumerator, BulkSpecificFinder, ChangedIDEnumerator, Creator, Deleter, Disassociator, Finder, GenericInvoker, IdEnumerator, Scalar, SpecificFinder, StreamAccessor, Updater.

The BDC model file for this sample defines the external system, the external content types, and stereotype methods. The BDC model file maps a subset of the methods that the Web service exposes to stereotype methods. The BDC model file can be found in the Sample Orders BDC Models folder and is named OrdersASP.NET-BDCModel.xml.

Prerequisites:

  • Internet Information Services (IIS)

  • Microsoft .NET Framework 3.5 Service Pack 1

  • Microsoft SharePoint Server 2010

Download and use the sample

  1. Download the Microsoft SharePoint 2010 Software Development Kit (SDK) from SharePoint 2010 Reference: Software Development Kit.

  2. Extract bcs sample kit.zip from the path %ProgramFiles%\Microsoft SDKs\SharePoint 2010\Samples\Business Connectivity Services to a local folder.

  3. In the folder where you extracted the files, locate the Sample Orders ASP.NET Web Service folder and open the Readme.htm file.

  4. Follow the instructions in Readme.htm to use the sample.