Before running the wizard, install the following:

• Microsoft Windows Communication Foundation (WCF) Line of Business (LOB) Adapter SDK either with the Complete option or the Custom option (and choosing Tools within this option). This installs the Visual Studio template for the WCF Adapter Service Development Wizard.
  
  
• Microsoft BizTalk Adapter 3.0 for Siebel eBusiness Applications
  
  
• The required Siebel client.
  
  

For more information about these prerequisites, see the BizTalk Adapter Pack installation guide. The installation guide is typically installed at <installation drive>:\Program Files\Microsoft BizTalk Adapter Pack\Documents.

1. Start Visual Studio 2005, and then create a project.

2. In the New Project dialog box, from the Project types pane, select Visual C#. From the Templates pane, select WCF Adapter Service.

   Alternatively, from the Project types pane, expand Visual C#, and then select Web. From the Templates pane, select WCF Adapter Service.

   Important
   If you installed Visual Studio 2005 SP1 with the Web Development component, the WCF Adapter Service template is also available from the New Web Site option (File > New > Web Site). However, the Siebel adapter only supports Web sites that are created on the file system. Therefore, while creating a Web site in the New Web Site dialog box, you must click File System in the Location list.

3. Specify a name and location for the solution, and then click OK. The WCF Adapter Service Development Wizard starts.

4. On the Welcome page, click Next.

5. On the Choose Operations page, specify a connection string to connect to the Siebel system. To do so:

   1. In the Select a binding list, click siebelBinding, and then click Configure.
      
      
   2. In the Configure Adapter dialog box, click the Security tab.
      
      
   3. In the Client credential type list, select Username, and then specify the user name and password to connect to the Siebel system.
      
      
   4. Click the URI Properties tab, and then specify values for the connection parameters. For more information about the connection URI for the Siebel adapter, see The Siebel System Connection URI.
      
      

      Note
      If the connection parameters contain any reserved characters (such as XML special characters), you must specify them as-is in the URI Properties tab, that is, without using any escape characters. However, if you specify the URI directly in the Configure a URI field and the connection parameters contain reserved characters, you must specify the connection parameters using proper escape characters.

   5. Click the Binding Properties tab, and then specify values for the binding properties, if any, required for the operations you want to target.
      
      For more information about binding properties, see Working with BizTalk Adapter 3.0 for Siebel Binding Properties.
      
      
   6. Click OK, and then click Connect. After the connection is established, the connection status is shown as Connected.
      
      

6. On the Choose Operations page, in the Select contract type list, click Client (Outbound operations).

7. In the Select a category box, expand the Siebel Business Objects node to see the list of business objects in the Siebel repository. For this example, do the following:

   1. Expand the Account business object, and then click the Account business component.
      
      
   2. In the Available categories and operations box, select the Query operation, and then click Add. The selected operation is listed in the Added categories and operations box.
      
      
      

8. On the Choose Operations page, click Next.

9. On the Configure Service and Endpoint Behaviors page, specify values to configure the service and endpoint behavior.

   1. In the Service Behavior Configuration box, specify values for the following:
      
      

      For the property	Specify the value
      EnableMetadataExchange	Set this to True to create a metadata exchange endpoint. By setting this to True, you make the service metadata available using standardized protocols, such as WS-Metadata Exchange (MEX) and HTTP/GET requests. Default is False.
      IncludeExceptionDetailsinFault	Set this to True to include managed exception information in detail of SOAP faults returned to the client for debugging purposes. Default is False.
      Name	Name for the service behavior configuration.
      UseServiceCertificate	Specifies whether you want to use the message level security mode of WCF. Default is True. For this tutorial, you must set this to False.
      FindValue	A string that specifies the value to search for in the X.509 certificate store. Note Specify a value for this property only if UseServiceCertificate is set to True.
      StoreLocation	A value that specifies the location of the certificate store that the service can use to validate the client's certificate. Note Specify a value for this property only if UseServiceCertificate is set to True.
      StoreName	Name of the X.509 certificate store to open. Note Specify a value for this property only if UseServiceCertificate is set to True.
      X509FindType	The type of X.509 search to be executed. Note Specify a value for this property only if UseServiceCertificate is set to True.

      Note
      For more information about the certificates and the associated properties, see "X509ClientCertificateCredentialsElement Properties" at http://go.microsoft.com/fwlink/?LinkId=103771.

   2. In the Endpoint Behavior Configuration box, specify values for the following:
      
      

      For the property	Specify the value
      Authentication Type	Set this to ClientCredentialUserNamePassword to enable the clients to specify the user name and password while consuming the WCF service. Set this to HTTPUserNamePassword to enable clients to specify user name and password as part of the HTTP header. Set this to Auto to first enable clients to specify credentials through the ClientCredential interface. If this fails, clients can pass credentials as part of the HTTP header. Default is Auto. For Microsoft Office SharePoint Server to consume the WCF service, you should set this as HTTPUserNamePassword.
      Name	Specify a name for the endpoint behavior configuration.
      UsernameHeader	Name for the user name header. For this example, specify MyUserHeader. For more information about HTTP headers, see "Support for Custom HTTP and SOAP Headers" at http://go.microsoft.com/fwlink/?LinkId=106692. Note You must specify a value for this property if the Authentication Type is set to HTTPUserNamePassword. If Authentication Type is set to Auto, this property is optional.
      PasswordHeader	Name for the password header. For this example, specify MyPassHeader. For more information about HTTP headers, see "Support for Custom HTTP and SOAP Headers" at http://go.microsoft.com/fwlink/?LinkId=106692. Note You must specify a value for this property if the Authentication Type is set to HTTPUserNamePassword. If Authentication Type is set to Auto, this property is optional.

   The following figure shows the Configure Service and Endpoint Behaviors page with the specified values.

   

10. On the Configure Service and Endpoint Behaviors page, click Next.

11. On the Configure Service Endpoint Binding and Address page, the Select a contract to configure box lists the contracts for the Siebel business components for which you selected the operations on the Choose Operations page. The Operations under the selected contract box displays the operations you selected for each artifact on the Choose Operations page.

12. In the Configure the address and binding for the contract box, specify values for the following:

    For the property	Specify the value
    Binding Configuration	The wizard only supports basic HTTP binding. So, the binding configuration field is automatically populated to System.ServiceModel.Configuration.BasicHttpBindingElement. Click on the ellipsis button (…) to change the properties for HTTP binding. To use a secure communication channel, you must always set the Mode property to Transport. The wizard sets the default value for the Mode property as Transport. For more information about the other bindings exposed, see "BasicHttpBindingElement Members" at http://go.microsoft.com/fwlink/?LinkId=103773.
    Endpoint Name	Specify an endpoint name for the contract.

    The other fields on this page are automatically populated based on the values you specified in the earlier pages.

    Click Apply. Perform this step for all the contracts displayed under the Select a contract to configure box.

    Note
    If you do not specify any values on this page, the default values are accepted for all the contracts.

    The following figure shows the Configure Service Endpoint Binding and Address page with the specified values.

    

13. On the Configure Service Endpoint Binding and Address page, click Next. The Summary page lists a tree structure of the contracts for the selected Siebel business components and, under that, the operations selected for each business component.

14. Review the summary, and then click Finish.

15. The wizard creates a WCF service and adds the following files to the Visual Studio project:

    1. .svc file. This is the WCF service file. The wizard generates one file for each contract.
       
       
    2. Web.config file.
       
       
    3. Service code (.cs file).
       
       

16. Publish the WCF service.

    1. Make sure SSL is enabled for Internet Information Service (IIS). For instructions on how to enable SSL for IIS, see http://go.microsoft.com/fwlink/?LinkId=119751.
       
       
    2. Right-click the project in Solution Explorer, and then click Publish.
       
       
    3. In the Publish Web dialog box, specify a URL for the WCF service. For example:
       
       
       https://<computer_name>/Siebel_Account/

    4. From the Copy box, click All project files.
       
       
    5. Click Publish.
       
       

17. Verify that the WCF service is published successfully.

    1. Start the IIS Microsoft Management Console. Click Start, point to Administrative Tools, and then click Internet Information Services.
       
       
    2. Navigate to the node where you published the service. For the Siebel_Account service, navigate to Internet Information Services > <Computer Name> > Web Sites > Default Web Site > Siebel_Account.
       
       
    3. On the right pane, right-click the Rfc.svc file, and then click Browse.
       
       
    4. The Web page shows up with the URL for retrieving the WSDL. You may want to test metadata retrieval using the svcutil command. For example, the command to retrieve metadata for the Siebel_Account service is:
       
       
       svcutil.exe https://localhost/Siebel_Account/BusinessObjects_Account_Account_Operation.svc?wsdl

You now have a WCF service for the Siebel business component. Use the Business Data Catalog Definition Editor to create an application definition file for the Siebel business component operations. See Step 2: Create an Application Definition File for Siebel Business Component Operations for instructions. The application definition file identifies where the LOB data is stored and the format in which it is stored.

Other Resources