Authoring Step 1: Define the External System

  • Article

Applies to: SharePoint Server 2010

The LobSystem object is the container for metadata that describes a particular external system. In XML terms, it is the node that contains other metadata objects related to a single external system. It provides authentication and connection string information to the Business Data Connectivity (BDC) service. In the case of Web services, it provides additional Web service–specific properties. For a detailed list of LobSystem properties, see BDC Custom Properties.

This topic explains how to define the XML for the LobSystem object to connect to the Sample Orders Web Service provided with the Microsoft SharePoint 2010 Software Development Kit (SDK).

Prerequisites

The Code Sample: Sample Orders ASP.NET Web Service deployed on a Web server and a server running Microsoft SharePoint 2010.

To define the XML for the LobSystem object

  1. Create a text file, and then save it as SampleWebService.XML. The location to which you save the file does not matter.

  2. Open the text file for editing in your text editor.

  3. Insert the following XML to define the top-level parameters of the LobSystem object.

    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
<Model xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
       xsi:schemaLocation="https://schemas.microsoft.com/windows/2007/BusinessDataCatalog BDCMetadata.xsd" 
       Name="SampleWebService_Model" 
       xmlns="https://schemas.microsoft.com/windows/2007/BusinessDataCatalog">
  <LobSystems>
    <LobSystem Type="Wcf" Name="http://air-mail/WSOrders2010/service.asmx?wsdl">
      <Properties>
        <Property Name="WsdlFetchAuthenticationMode" 
                  Type="System.String">PassThrough</Property>
        <Property Name="WcfMexDiscoMode" 
                  Type="System.String">Disco</Property>
        <Property Name="WcfMexDocumentUrl" 
                  Type="System.String">http://air-mail/WSOrders2010/service.asmx?wsdl
        </Property>
        <Property Name="WcfProxyNamespace" 
                  Type="System.String">BCSServiceProxy</Property>
        <Property Name="WildcardCharacter" 
                  Type="System.String">*</Property>
        <Property Name="ReferenceKnownTypes" 
                  Type="System.Boolean">true</Property>
      </Properties>
    </LobSystem>
  </LobSystems>
</Model>

Next Steps

Authoring Step 2: Define Top-Level Security Parameters