Skip navigation.

eDocs Home > BEA AquaLogic Service Bus 2.1 Documentation > Using the AquaLogic Service Bus Console > Business Services

Using the AquaLogic Service Bus Console

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader

Business Services

This section includes the following topics:

 

Overview of Business Services

Business services are AquaLogic Service Bus definitions of the enterprise services with which you want to exchange messages. You define business services using WSDLs (Web Services Definition Language) just as you would define a proxy service. However, the configuration of business services differs from that of proxy services in that a business service does not have a pipeline. Therefore, a business service is any service not implemented by the BEA AquaLogic Service Bus pipelines.

Note: If a business service requires Web service security, make sure the WSDL you specify has the necessary WS-Policies attached when you create the business service. Furthermore, if the WS-Policy of the business service requires encryption, make sure the public certificate of the business service is embedded in the WSDL. If the business service is a WebLogic Server 9.0 Web service, you can retrieve its WSDL using the http://<host>:<port>/<service url>?WSDL URL, the public certificate will be automatically embedded for you if necessary.

The following table lists the Business Services pages you can access from the Resource Browser and the Project Explorer modules:

Table 13-1 Pages Accessed from Project Explorer and Resource Browser Modules

Page

Associated Tasks

Help Topics

Summary of Business Services

View a list of business services.

Listing and Locating Business Services

Filter the list.

Delete a business service.

Deleting Business Services

Edit a Business Service

Add a business service

Adding a Business Service

Business Service Details

View details of a specific business service

Viewing and Changing Business Services

Change details of a specific business service


 

Service Types

Each service type is modeled following the same pattern. Their configuration is composed of a common part and a service type specific part.

The common configuration consists of the following properties.

Table 13-2 Service Type Configuration

Property

Description

Resource Definition

The resource definition consists of:

  • The service name (that is, project, path, and local name)

  • An optional description for the service

  • The service type (read only)

Transport Configuration

You can configure the following parameters for each business service:

  • List of <string URI, integer weight> pairs—for example, <http://www.bea.com, 100>. For a random-weighted list, the list should contain at least one element.

  • Load-balancing algorithm—enumeration, one of round-robin, random, or random-weighted. If you select random-weighted, the weights are applicable for each URI.

  • Retry Count

  • Retry Interval

The transport you select must be able to support the transport mode (that is, request/response, one-way or both) required by the binding definition, and be configured accordingly.

For services exchanging messages in both modes, you must configure the binding layer so that it can choose the transport mode accordingly (for any transport implementing the request/response as two asynchronous calls, for example, JMS). This occurs automatically when the service is a concrete type, as it is described in the binding definition. When it is not a concrete type, to configure the binding layer, you must set the mode in the $outbound variable.

Based on the transport and WSDL, the transport mode is automatically selected, but you can overwrite it in $inbound or $outbound.


 

Each service type must define the following configurations:

 

Adding a Business Service

The Edit a Business Service pages enable you to add a new business service. Business services are AquaLogic Service Bus definitions of the enterprise services with which you want to exchange messages. To learn more, see Overview of Business Services.

To add a business service, you must first configure general information for the service, then configure general and protocol-dependent transport information for the service. If this is a messaging service, you must also configure the message types. You can review the configuration before you create the new business service.

The tasks in this procedure include:

To Add a Business - Service - General Configuration

  1. If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
  2. From the left navigation pane, select Project Explorer. The Project View page is displayed.
  3. Select the project to which you want to add the business service. You can add a business service directly under the project, or you can add the business service under a selected folder.

    4. Note: Click the name of a folder to select it. The Folder View page is displayed.

  4. From the Project View or Folder View page, in the Create Resource field, select Business Service from under Service. The Edit a Business Service - General Configuration page is displayed.
  5. In the Service Name field, enter a unique name. This is a required field.
  6. In the Description field, enter a description for this business service.
  7. In the Service Type field, do one of the tasks described in the following table.

    8. Note: A service type defines the types and packaging of the messages exchanged by the service. This is a required field.

    Table 13-4 Service Type Field

    To...

    Complete These Steps...

    Create a service from WSDL port

      1. Select WSDL port from under Create a New Service.

      2. Click Browse. The WSDL Browser is displayed.

      3. In the WSDL Browser, select a WSDL resource, then select a port in the Definitions pane.

      4. Click Submit to close the dialog box and return to the General Configuration page.

    Note: When you create a business service or proxy service based on a WSDL, you can select only a WSDL port or a WSDL binding, as a WSDL may only have one of these entities defined. The WSDL port describes what the actual transport address is. You use it for a concrete interface.

    To learn more about this service type, see Service Types in Overview of Business Services.

    Create a service from WSDL binding

      1. Select WSDL binding from under Create a New Service.

      2. Click Browse. The WSDL Browser is displayed.

      3. In the WSDL Browser, select a WSDL resource, then select a binding in the Definitions pane.

      4. Click Submit to close the dialog box and return to the General Configuration page.

    Note: When you create a business service or proxy service based on a WSDL, you can select only a WSDL port or a WSDL binding, as a WSDL may only have one of these entities defined. The WSDL binding describes the structure of the interface and how it is packaged. You use it to map the transport address.

    To learn more about this service type, see Service Types in Overview of Business Services.

    Create a messaging service

    Select Messaging Service to create a service that exchanges messages of very different content-type. These exchanges can be either request/response or one-way. Unlike Web services, the content-type of the request and response need not be the same.

    To learn more about this service type, see Service Types in Overview of Business Services.

    Create a SOAP service that does not have an explicitly defined, concrete interface

    Select Any SOAP Service to create a SOAP service that does not have an explicitly defined, concrete interface.

    To learn more about this service type, see Service Types in Overview of Business Services.

    Create an XML service that does not have an explicitly defined, concrete interface

    Select Any XML Service to create an XML service that does not have an explicitly defined, concrete interface.

    Note: HTTP GET is only supported in the Any XML Service service type.

    To learn more about this service type, see Service Types in Overview of Business Services.

    Create a service from an existing business service

      1. Select Business Service from under Create from Existing Service.

      2. Click Browse. The Service Browser is displayed.

      3. In the Service Browser, select a business service.

      4. Click Submit to close the dialog box and return to the General Configuration page.

    Create a service from an existing proxy service

      1. Select Proxy Service from under Create from Existing Service.

      2. Click Browse. The Service Browser is displayed.

      3. In the Service Browser, select a proxy service.

      4. Click Submit to close the dialog box and return to the General Configuration page.

    To learn more about proxy services, see Overview of Proxy Services.


     
  8. Click Next.

    9. If you selected Messaging Service in the Service Type field, the Edit a Business Service - Message Type Configuration page is displayed. Continue in To Add a Business Service - Message Type Configuration.

    For all other service types, the Edit a Business Service - Transport Configuration page is displayed. Continue in To Add a Business Service - Transport Configuration.

To Add a Business Service - Message Type Configuration

If you selected Messaging Service in the Service Type field, the Edit a Business Service - Message Type Configuration page is displayed when you click Next on the Edit a Business Service - General Configuration page.

The binding definition for messaging services consists of configuring the content-type of the messages that are exchanged. The content-type for the response does not need to be the same as for the request; therefore, the response is configured separately (for example, the service could accept an MFL message and return an XML acknowledgment receipt).

  1. Select a message type for the request and response messages:
    1. In the Request Message Type field, select a message type for the request message.

      2. Table 13-5 Request Message Type Field

      Message Type

      Description

      None

      Select None if there no content-type for the message.

      Binary

      Select Binary if the content-type of the message is unknown or not important.

      Text

      Select Text if the message can be restricted to text.

      MFL

      Select MFL if the message is a binary document conforming to an MFL definition. You can configure only one MFL file.

      Note: For MFLs, you can click Browse to select an MFL from the MFL Browser, then click Submit.

      XML

      Select XML if the message is an XML document. To provide some type information, you can choose to declare the XML schema type of the XML document exchanged.


       
    2. In the Response Message Type field, select a message type for the response message.

      3. Table 13-6 Response Message Type Field

      Message Type

      Description

      None

      Select None if there no content-type for the message.

      Binary

      Select Binary if the content-type of the message is unknown or not important.

      Text

      Select Text if the message can be restricted to text.

      MFL

      Select MFL if the message is a binary document conforming to an MFL definition. You can configure only one MFL file.

      Note: For MFLs, you can click Browse to select an MFL from the MFL Browser, then click Submit.

      XML

      Select XML if the message is an XML document. To provide some type information, you can choose to declare the XML schema type of the XML document exchanged.


       
  2. Click Next.

    3. The Transport Configuration page is displayed. Continue in To Add a Business Service - Transport Configuration.

To Add a Business Service - Transport Configuration

The Transport Configuration page is displayed when you click Next on the Edit a Business Service - General Configuration page. It is displayed for messaging services when you click Next on the Edit a Business Service - Message Type Configuration page.

Note: This page enables you to configure transport information for the business service. Inbound transport-level security applies to the client applications and AquaLogic Service Bus proxy services. Outbound transport-level security applies to the connections between AquaLogic Service Bus proxy services and business services. For more information about transport-level security, see "Transport-Level Security" in Securing Inbound and Outbound Messages in the BEA AquaLogic Service Bus User Guide.

  1. In the Protocol field, select one of these transport protocols:
  2. In the Load Balancing Algorithm field, select one of these load-balancing algorithms.

    3. Table 13-7 Load Balancing Algorithm Field

    Load-Balancing Algorithm

    Description

    Round-robin

    Dynamically orders the URLs that you enter in the Endpoint URI field for this business service. If the first one fails, it tries the next one, and so on until the retry count is exhausted.

    For every new message, there is a new order of URLs.

    Random

    Randomly orders the list of URLs that you enter in the Endpoint URI field for this business service. If the first one fails, it tries the next one, and so on until the retry count is exhausted.

    Random-weighted

    Randomly orders the list of URLs that you enter in the Endpoint URI field for this business service, but some are retried more than others based on the value you enter in the Weight field.

    None

    Orders the list of URLs that you enter in the Endpoint URI field for this business service from top to bottom.


     
  3. In the Endpoint URI field, enter an endpoint URL in the format based on the transport protocol you selected in the Protocol field, then click Add.

    4. Table 13-8 Endpoint URI Field

    Transport Protocol

    Format

    Email

    mailto:java-net@java.sun.com

    File

    file:///drivename:/somename

    FTP

    ftp://host:port/directory

    HTTP

    http://host:port/someService

    HTTPS

    https://host:port/someService

    JMS

    jms://host:port/factoryJndiName/destJndiName

    To target a JMS destination to multiple servers, use the following URI format:
    jms://host1:port,host2:port/QueueConnectionFactory/DestName


     

    Note: You can configure multiple URLs. You can click Delete in the Action column to delete them at any time. At run time, the URLs are selected based on the load balancing algorithm you selected in the Load Balancing Algorithm field.

    Note: If you selected Random-weighted in the Load Balancing Algorithm field, you can also enter a weight in the Endpoint URI field. The default is 1.

  4. In the Retry Count field, specify the number of times the list is retried. The number of retries is for the list of URIs, not the URIs themselves. For example, if you specify 3 in this field, the list is cycled through 3 times.
  5. In the Retry Interval field, specify the number of seconds' wait time between retries.
  6. Click Next.

    7. An additional Transport Configuration page is displayed. This page enables you to configure protocol-dependent transport information for the business service. Continue in To Add a Business Service - Protocol-Dependent Transport Configuration.

To Add a Business Service - Protocol-Dependent Transport Configuration

The [Protocol] Transport Configuration page is displayed when you click Next on the Edit a Business Service - Transport Configuration page. This page enables you to configure additional transport information for the business service, based on the transport protocol you selected in the Protocol field.

  1. Based on the transport protocol you selected in the Protocol field, do one of the following:

    2. Table 13-9 Protocol Field

    Transport Protocol...

    Complete These Steps...

    HTTP

      1. In the Timeout field, enter the timeout interval, in seconds, before the connection is dropped. If you enter 0, there is no timeout.

      2. In the HTTP Request Method field, select POST or GET as the HTTP request method header for sending a message.

    The GET method can include as part of the request some of its own information that better describes what to get. This information is passed as a sequence of characters appended to the request URL in a query string. The POST method passes all its data, of unlimited length, directly over the socket connection as part of its HTTP request body. The exchange is invisible to the client, and the URL doesn't change at all.

      3. Select the Basic Authentication Required checkbox to specify that basic authentication is required to access this service, or leave it blank to specify that basic authentication is not required. Basic authentication instructs WebLogic Server to authenticate the client using a username and password against the authentication providers configured in the security realm, such as a Lightweight Directory Access Protocol (LDAP) directory service and Windows Active Directory. The client must send its username and password on the HTTP request header. If you select this field, you must also enter a service account in the Service Account field.

    Note: Basic authentication over HTTP is strongly discouraged because the password is sent in clear text. However, it is safe to send passwords over HTTPS because HTTPS provides an encrypted channel.

      4. In the Service Account field, enter a service account. A service account is an alias resource for a username and password. This is a required field if you selected the Basic Authentication Required field. To learn more about service accounts, see Overview of Service Accounts. You can create service accounts in the Project Explorer module. To learn more, see Adding a Service Account.

    HTTP continued

      5. Make sure the Follow HTTP Redirects checkbox is selected if HTTP redirects, which are requests with a response code 3xx, should be automatically followed. A re-direct occurs when you send an outbound request to the URL of a business service, and that service returns a response code (for example, 302) that says the URL is no longer valid and this request needs to be sent to another URL. If the Follow HTTP Redirects check box is selected, AquaLogic Service Bus automatically re-sends the request to the new URL without any action on your part. Uncheck this checkbox if you do not want the HTTP redirects to be automatically followed.

      6. In the Dispatch Policy field, select a dispatch policy for this endpoint. Default signifies the default dispatch policy.

    Dispatch policy refers to the instance of WLS 9.0 Work Manager that you want to use for the service endpoint. For example, if the proxy service has a JMS transport protocol, the service endpoint is an MDB (message-driven bean) JAR file that you can associate with the specific dispatch policy.

      7. In the Request encoding field, accept the default iso-8859-1 as the char set encoding for requests in HTTP transports, or enter a different char set encoding.

      8. In the Response encoding field, accept the default iso-8859-1 as the char set encoding for responses in HTTP transports, or enter a different char set encoding.

    HTTPS

      1. In the Timeout field, enter the timeout interval, in seconds, before the connection is dropped. If you enter 0, there is no timeout.

      2. In the HTTP Request Method field, select POST or GET as the HTTP request method header for sending a message.

    The GET method can include as part of the request some of its own information that better describes what to get. This information is passed as a sequence of characters appended to the request URL in a query string. The POST method passes all its data, of unlimited length, directly over the socket connection as part of its HTTP request body. The exchange is invisible to the client, and the URL doesn't change at all.

      3. In the Business Service Authentication field, select None, Basic, or Client Certificates as the business service authentication method. If you select Basic, you must also enter a service account in the Service Account field.

      4. In the Service Account field, click Browse to select a service account. A service account is an alias resource for a username and password. This is a required field if you selected Basic in the Business Service Authentication field.To learn more about service accounts, see Overview of Service Accounts. You can create service accounts in the Project Explorer module. To learn more, see Adding a Service Account.

      5. Make sure the Follow HTTP Redirects checkbox is selected if HTTP redirects, which are requests with a response code 3xx, should be automatically followed. A re-direct occurs when you send an outbound request to the URL of a business service, and that service returns a response code (for example, 302) that says the URL is no longer valid and this request needs to be sent to another URL. If the Follow HTTP Redirects check box is selected, AquaLogic Service Bus automatically re-sends the request to the new URL without any action on your part. Uncheck this checkbox if you do not want the HTTP redirects to be automatically followed.

      6. In the Dispatch Policy field, select a dispatch policy for this endpoint. Default signifies the default dispatch policy.

    Dispatch policy refers to the instance of WLS 9.0 Work Manager that you want to use for the service endpoint. For example, if the proxy service has a JMS transport protocol, the service endpoint is an MDB (message-driven bean) JAR file that you can associate with the specific dispatch policy.

      7. In the Request encoding field, accept the default iso-8859-1 as the char set encoding for requests in HTTPS transports, or enter a different char set encoding.

      8. In the Response encoding field, accept the default iso-8859-1 as the char set encoding for requests in HTTPS transports, or enter a different char set encoding.

    JMS

      1. In the Destination Type field, select Queue or Topic.

      2. In the Message Type field, select Bytes or Text.

      3. If you selected Queue in the Destination Type field, select the Is Response Required checkbox or leave it blank. This checkbox determines whether or not a response is expected after an outbound message is sent. When you select the checkbox, you must enter data in two additional fields: Response URI and Response Timeout.

      4. In the Response URI field, enter a response URI in the format jms://host:port/factoryJndiName/destJndiName. This field is required if you selected Is Response Required.
      To target multiple servers, use the following URI format:
      jms://host1:port,host2:port/QueueConnectionFactory/DestName

      5. In the Response Timeout field, enter the amount of time to wait for the response, in seconds. This field is required if you selected Is Response Required.

      6. In the Request encoding field, accept the default utf-8 as the character set encoding for requests in JMS transports, or enter a different character set encoding.

      7. In the Response encoding field, accept the default utf-8 as the character set encoding for requests in JMS transports, or enter a different character set encoding.

      8. In the Dispatch Policy field, select a dispatch policy for this endpoint. Default signifies the default dispatch policy. Dispatch policy refers to the instance of WLS 9.0 Work Manager that you want to use for the service endpoint. For example, if the proxy service has a JMS transport protocol, the service endpoint is an MDB (message-driven bean) JAR file that you can associate with the specific dispatch policy.

      9. Click Advanced Settings to display additional fields.

      10. Select the Use SSL checkbox if the requests are made over a TLS/SSL connection or leave blank if they are not. TLS/SSL (Secure Sockets Layer) provides secure connections by allowing two applications connecting over a network to authenticate the other's identity and by encrypting the data exchanged between the applications. Authentication allows a server, and optionally a client, to verify the identity of the application on the other end of a network connection. Additionally, if the administrator has restricted access to individual JMS destinations (queues or topics) by setting access control on the JNDI entry for the destination, the Business Service must authenticate when looking up the entry in the JNDI tree with a username and password.

      11. In the Expiration field, enter the expiration or time-to-live value for a message, in seconds. If you enter 0, the message never expires.

    JMS continued

      12. In the Unit of Order field, enter a message unit-of-order. Message Unit-of-Order is a WebLogic Server value-added feature that enables message producers to group messages into a single unit with respect to the processing order. This single unit is called a Unit-of-Order and requires that all messages from that unit be processed sequentially in the order they were created.

      13. In the JNDI service account field, click Browse to select a service account to use for JNDI lookups. To learn more about service accounts, see Overview of Service Accounts.

      14. In the JMS service account field, click Browse to select a service account to use for the JMS resource managed by the JMS server.To learn more, see Overview of Service Accounts.

    Email

      1. In the Mail Server address field, enter an existing SMTP server in the format host:port. This is a required field if you do not select a JNDI name in the Mail Session field.

      2. In the Service Account field, click Browse to select a service account. This is a required field if the SMTP Server used requires authentication. A service account is an alias resource for a username and password. To learn more about service accounts, see Overview of Service Accounts. You can create service accounts in the Project Explorer module. To learn more, see Adding a Service Account.

      3. In the Mail Session field, select the JNDI name of a configured session. This is a required field if you do not enter an SMTP server name in the Mail Server address field.

      4. In the From Name field, enter a display name for the originating email account for this service.

      5. In the From Address field, enter the originating email account for this service.

      6. In the Reply To Name field, enter a display name for the reply to email account.

      7. In the Reply To Address field, enter an email address to reply to.

      8. In the Connection Timeout field, enter the timeout interval, in seconds, before the connection is dropped. If you enter 0, there is no timeout.

      9. In the Request encoding field, accept the default iso-8859-1 as the char set encoding for requests in Email transports, or enter a different char set encoding.

    File

      1. In the Prefix field, enter a prefix that is prepended to the file name. This is a required field.

    Note: Do not enter * in this field. This character causes a run-time exception.

      2. In the Suffix field, enter a suffix that is appended to the file name. This is a required field.

    Note: Do not enter * in this field. This character causes a run-time exception.

      3. In the Request encoding field, accept the default utf-8 as the char set encoding for requests in File transports, or enter a different char set encoding.

    FTP

      1. In the User Authentication field, select anonymous if the user of the FTP server is anonymous or select external_user if the user of the FTP server is an externally configured account.

      2. In the Identity (e-mail id) or Service Account field, enter the mail ID for the anonymous user if you selected anonymous in the User Authentication field, or enter the service account if you selected external_user in the User Authentication field. This is a required field if you selected external_user. To learn more about service accounts, see Overview of Service Accounts. You can create service accounts in the Project Explorer module. To learn more, see Adding a Service Account.

      3. In the Timeout field, enter the socket timeout, in seconds. The default is 60 seconds.

      4. In the Prefix for destination File Name field, enter a prefix for the file name under which the file is stored on the remote server. This is a required field.

    Note: Do not enter * in this field. This character causes a run-time exception.

      5. In the Suffix for destination File Name field, enter a suffix for the file name under which the file is stored on the remote server. This is a required field.

    Note: Do not enter * in this field. This character causes a run-time exception.

      6. In the Transfer Node field, select ascii or binary as the transfer mode.

      7. In the Request encoding field, accept the default utf-8 as the char set encoding for requests in File transports, or enter a different char set encoding.


     

Note: If a business service is created from a WSDL that includes WS-Policy attachments, the policies (read-only) are displayed on the [Protocol] Transport Configuration page. If any of the service's WS-Policies specifies authentication, then you must select a service account. A proxy service that routes to this business service will use this service account to authenticate to the business service.

  1. Click Next.

    2. The General Configuration Review page is displayed. Continue in To Add a Business Service - General Configuration Review.

To Add a Business Service - General Configuration Review

The General Configuration Review page is displayed when you click Next on the Protocol Transport Configuration page. This page enables you to review the configuration data that you have entered for this business service. If necessary, you can click Edit to make changes to the configuration before you save the business service.

Note: The new business service is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Related Topics

Listing and Locating Business Services

Viewing and Changing Business Services

Deleting Business Services

 

Listing and Locating Business Services

The Summary of Business Services page enables you to view a list of business services. Business services are AquaLogic Service Bus definitions of the enterprise services with which you want to exchange messages. To learn more, see Overview of Business Services.

To List and Locate Business Services

  1. From the left navigation pane, select Business Services from under Resource Browser. The Summary of Business Services page is displayed, which displays the following information for each business service. For a more detailed description of the properties, see Viewing and Changing Business Services.

    2. Table 13-10 Summary of Business Services Page

    Property

    Description

    Name

    A unique name for the business service. The name is a link to the View Details page. To learn more, see Viewing and Changing Business Services.

    Path

    The path is the project name and the name of the folder in which the business service resides. It is a link to the project or folder that contains this resource. To learn more, see Viewing Project Details or Viewing Folder Details.

    Actions

    For business services, the Actions column displays the following:

    • A Manage Monitoring icon, which is a link to the Monitoring Configuration - [service name] page. Click the icon to enable or disable monitoring for a specific service, enable or disable the service itself, and view or configure alert rules for a specific service. To learn more, see Listing and Locating Alert Rules.

    • A Launch Test Console icon, which you can click to invoke the Test Console, which you use to validate and test the design of your services and transformations. For business services, you can only use the Test Console at run time; that is, when the session is activated. To learn more, see Testing Services.

    Options

    The Options column displays the following:

    You cannot delete a resource if it is referenced by other resources in AquaLogic Service Bus. Instead of the Delete icon, a Delete icon with a red X is displayed for these resources.


     
  2. To locate a specific business service, do one of the following:

Related Topics

Adding a Business Service

 

Viewing and Changing Business Services

The View Details page enables you to view and change details of a specific business service. Business services are AquaLogic Service Bus definitions of the enterprise services with which you want to exchange messages. To learn more, see Overview of Business Services.

To View and Change Business Service Details

  1. Locate the business service. To learn more, see Listing and Locating Business Services.
  2. Click the business service name.

    3. The View Details page displays the following information:

    Table 13-11 View Details Page

    Property

    Description

    Resource Name

    The name of this business service.

    Created By

    The user who created this business service or imported it into the configuration.

    Created On

    The date and time that the user created this business service or imported it into the configuration.

    References

    The number of objects that this business service references. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.

    Referenced by

    The number of objects that reference this business service. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.

    Description

    A description of this business service, if one exists.


     

    The View Details page displays the following General Configuration information:

    Table 13-12 General Configuration Information

    Property

    Description

    Service Type

    The service type


     

    If the service type for this business service is Messaging Service, the page displays the following Message Type Configuration information:

    Table 13-13 Message Type Configuration Information

    Property

    Description

    Request Message Type

    A message type for the request message: None, Binary, Text, MFL, or XML.

    Response Message Type

    A message type for the response message: None, Binary, Text, MFL, or XML.


     

    The page displays the following Transport Configuration information:

    Table 13-14 Transport Configuration Information

    Property

    Description

    Protocol

    The transport protocol

    Load Balancing Algorithm

    The load balancing algorithm

    Endpoint URI

    The endpoint URI

    Retry Count

    The retry count

    Retry Interval

    The retry interval


     

    If the transport protocol is Email, the page displays the following Email Transport Configuration information:

    Table 13-15 Email Transport Configuration Information

    Property

    Description

    Mail Server Address

    The SMTP server for this service

    Service Account

    The service account for this mail server

    Mail Session

    The mail session for this service

    From Name

    The originating display name for this service

    From Address

    The originating address for this service

    Reply to Name

    The reply to display name for this service

    Reply to Address

    The reply to address for this service

    Request Encoding

    The char set encoding for requests in Email transports.


     

    If the transport protocol is File, the page displays the following File Transport Configuration information:

    Table 13-16 File Transport Configuration Information

    Property

    Description

    Prefix

    A prefix that is prepended to the file name.

    Suffix

    A suffix that is appended to the file.

    Request Encoding

    The char set encoding for requests in File transports.


     

    If the transport protocol is FTP, the page displays the following FTP Transport Configuration information:

    Table 13-17 FTP Transport Configuration Information

    Property

    Description

    User Authentication

    The user authentication method: anonymous or externally configured account.

    Identity (e-mail id) or Service Account

    The mail ID for an anonymous user or service account for an externally configured account.

    Timeout

    The socket timeout, in seconds.

    Prefix for destination File Name

    The prefix for the file name under which the file is stored on the remote server.

    Suffix for destination File Name

    The suffix for the file name under which the file is stored on the remote server.

    Transfer Mode

    The transfer mode: Binary or ASCII.

    Request Encoding

    The char set encoding for requests in FTP transports.


     

    If the transport protocol is HTTP, the page displays the following HTTP Transport Configuration information:

    Table 13-18 HTTP Transport Configuration Information

    Property

    Description

    Timeout

    The amount of time in seconds it takes the service to time out.

    HTTP Request Method

    The HTTP request method.

    Basic Authentication Required

    Whether or not basic authentication is required: displays Enabled if it is required.

    Follow HTTP Redirects

    Whether or not a re-direct occurs when you send an outbound request to the URL of a business service, and that service returns a response code (for example, 302) that says the URL is no longer valid and this request needs to be sent to another URL. Displays Enabled if AquaLogic Service Bus automatically re-sends the request to the new URL without any action on your part.

    Service Account

    If you selected one, a service account for this transport.

    Request Encoding

    The char set encoding for requests in HTTP transports.

    Response Encoding

    The char set encoding for responses in HTTP transports.


     

    If the transport protocol is HTTPS, the page displays the following HTTPS Transport Configuration information:

    Table 13-19 HTTPS Transport Configuration Information

    Property

    Description

    Timeout

    The amount of time in seconds it takes the service to time out.

    HTTP Request Method

    The HTTP request method: POST or GET.

    Business Service Authentication

    The authentication method for the business service: None, Basic, or Client Certificates.

    Follow HTTP Redirects

    Whether or not a re-direct occurs when you send an outbound request to the URL of a business service, and that service returns a response code (for example, 302) that says the URL is no longer valid and this request needs to be sent to another URL. Displays Enabled if AquaLogic Service Bus automatically re-sends the request to the new URL without any action on your part.

    Service Account

    If you selected one, a service account for this transport.

    Request Encoding

    The char set encoding for requests in HTTPS transports.

    Response Encoding

    The char set encoding for responses in HTTPS transports.


     

    If the transport protocol is JMS, the page displays the following JMS Transport Configuration information:

    Table 13-20 JMS Transport Configuration Information

    Property

    Description

    Destination Type

    The destination type: Queue or Topic.

    Use SSL

    Displays Enabled if the requests are made over a TLS/SSL connection.

    Message Type

    The message type: Text or Bytes.

    Expiration

    The expiration or time-to-live value for a message, in seconds. If it is 0, the message never expires.

    Is Response Required

    Whether or not a response is expected after an outbound message is sent.

    Response URI

    A response URI in the format jms://host:port/factoryJndiName/destJndiName.

    To target multiple servers, use the following URI format:
    jms://host1:port,host2:port/QueueConnectionFactory/DestName

    Response Timeout

    The amount of time to wait for the response, in seconds.

    Unit of Order

    The Message Unit-of-Order that enables message producers to group messages into a single unit with respect to the processing order. This single unit requires that all messages from that unit be processed sequentially in the order they were created.

    JNDI service account

    The service account to use for JNDI lookups.

    Request Encoding

    The char set encoding for requests in JMS transports.

    Response Encoding

    The char set encoding for responses in JMS transports.

    JMS service account

    The service account to use for the JMS resource managed by the JMS server.


     
  3. If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session or click Edit to enter an existing session to make changes to the current configuration. To learn more, see Using the Change Center.
  4. To make a change to the fields on the configuration pages, click Edit for the appropriate page. See Adding a Business Service for a description of the pages and fields.

    5. Note: You cannot change the Service Name or Service Type fields.

  5. Do one of the following:

Note: The business service is updated in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Related Topics

Overview of Business Services

Listing and Locating Business Services

Adding a Business Service

Deleting Business Services

 

Deleting Business Services

The Summary of Business Services page enables you to delete a business service. Business services are AquaLogic Service Bus definitions of the enterprise services with which you want to exchange messages. To learn more, see Overview of Business Services.

Note: You cannot delete a resource if it is referenced by other resources in AquaLogic Service Bus. Instead of the Delete icon, a Delete icon with a red X is displayed for these resources.

To Delete a Business Service

  1. If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
  2. From the left navigation pane, select Business Services from under Resource Browser. The Summary of Business Services page is displayed.
  3. In the Options field of the business service you want to delete, click the Delete icon.

    4. The business service is removed from the list.

    Note: If necessary, you can undo the deletion of this resource. To learn more, see Undoing a Task.

    The business service is deleted in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Related Topics

Listing and Locating Business Services

Adding a Business Service

Viewing and Changing Business Services

 

Skip navigation bar  Back to Top Previous Next