Edit

Share via

Step 1: Publish the Siebel Business Component Operations as a WCF Service

  • Article

Step 1 of 4

Time to complete: 10 minutes

Objective: You can use the WCF Adapter Service Development Wizard to generate a WCF service that can be hosted in a hosting environment such as Internet Information Services (IIS) or Windows Process Activation Service (WAS). This topic demonstrates how to use the wizard to generate a WCF service file.

Prerequisites

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 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.

Publish the Siebel Business Components as a WCF Service

  1. Start Visual Studio, 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.

    Note

    If you installed Visual Studio with the Web Development component, the WCF Adapter Service template is also available from the New Website option.

  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 Creat 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 Read about BizTalk Adapter 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.

      Select Siebel business component operations

  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.

    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 https://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 https://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.

      Configure Service and Endpoint Behaviors page

  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 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 Class.
    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.

    Configure Service Endpoint Binding and Address

  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 Services (IIS). See How to Set Up SSL.

    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 BusinessObjects_Account_Account_Operation.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

Next Steps

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.

See Also

Tutorial 1: Presenting Data From a Siebel System on a SharePoint Site