SOAP Service Binding

Use SOAP service binding to create a service provider.

Binding

This section has the following fields.

Field Description
Name The name of the service binding.
Description A short description of the service getting exposed.
Target Namespace The Target Namespace of the service.
Expose Security Context Selecting this option exposes the transport level security context in the message header, and places the information from the user's security context (either authentication or SSL certificate information) into the Context or SecurityContext output element.
Note: This is a fairly expensive operation and SSL certificates can consume memory resources. Select this option only if you require information from the user's security context for later use in your process.

Generate Concrete WSDL

The SOAP service binding helps you to create the concrete WSDL using Concrete WSDL Generation Wizard. For more information, see Generating Concrete WSDL.

SOAP Default Configuration

This section has the following fields.

Field Description
SOAP Version The version of the SOAP specification: 1.1 or 1.2. The default is 1.1.
Style The default SOAP binding style for all operations. Specify either Document or RPC style.
Encoding Encoding is literal.
Attachment Style Select the default attachment style for all the binding operations. Can be overidden at the operations level for each operation.

The following attachment styles are available:

  • SwA - Supports both, Bound and Unbound Attachments
  • MTOM

The MTOM attachment style is available if SOAP 1.1 or SOAP 1.2 specification is used.

Transport Configuration

This section has the following fields.

Field Literal Value/Module Property Description
Transport Type None The transport over which SOAP message is sent. The HTTP and JMS transports are supported.
Connector Name None The name of the shared resource. This points to either the HTTP or JMS shared transport configuration.
Configuration for HTTP Transport
HTTP Connector Name None Name of the HTTP Connector resource.
Tip: Click in the HTTP Connector Name field to display details about the HTTP Connector resource.
Endpoint URI Yes The endpoint URI for the service.
Configuration for JMS Transport
JMS Connection Name None The name of the JMS Connector resource.
Tip: Click in the JMS Connection Name field to display details about the JMS connector resource.
Acknowledge Mode None The acknowledge mode for service request messages.
  • Auto: The SOAP Service Binding acknowledges the message upon receipt.
  • Client: The SOAP Service Binding does not acknowledge the message upon receipt. Use Confirm activity in the TIBCO ActiveMatrix BusinessWorks™ to confirm the message. If the Confirm activity is not used, SOAP Service Binding automatically acknowledges the message while sending the service reply.
    Note: One-way operations with fault, if the service uses the Catch block to handle the exception, the message is acknowledged.

    To retain a message in a queue, do not create a catch block handler.

    Set max retry attempts at queue level to avoid infinite number of deliveries of JMS messages to a SOAP service.

  • Dups OK:The SOAP Service Binding acknowledges the message upon receipt. JMS provides this mode for lazy acknowledgment, but ActiveMatrix BusinessWorks™ acknowledges messages upon receipt.
  • Tibco EMS Explicit: (only available for TIBCO Enterprise Message Service)

    SOAP service binding does not acknowledge the message. Use Confirm activity in the ActiveMatrix BusinessWorks to confirm the message.

    If the Confirm activity is not used, then the message is automatically acknowledged by the SOAP Service Binding while sending the service reply.

    The session is not blocked and one session handles all incoming messages for each process instance.
    Note: For One way operations with fault, if the service handles the exception using the Catch block, message gets acknowledged.

    If you want to retain a message in a queue , do not create a catch block handler.

    It is recommended to set max retry attempts at queue level to avoid infinite number of deliveries for JMS message to a SOAP service.

  • Tibco EMS Explicit Dups OK: (only available for TIBCO Enterprise Message Service)

    The message is not acknowledged when it is received by a SOAP service binding. You can confirm the message by using the Confirm activity in the ActiveMatrix BusinessWorks process that is configured as the operation implementation.

    If the Confirm activity is not used, the message is automatically acknowledged by SOAP Service Binding while sending the service reply.

    The session is not blocked and one session handles all the incoming messages for each process instance. The messages however, are lazily acknowledged.
Delivery Mode (Response) None The message delivery mode.
  • Persistent Messages - stored and forwarded.
  • Non-Persistent Messages - not stored and can be lost due to failure.

The default mode is Persistent.

JMS Message Type None Specifies the type of the service request messages. It can be either Text message or Bytes message.
Messaging Style None Specifies the style of the service request messages. It can be Generic, Queue, or Topic.
JMS Destination Yes Specifies the name of the destination for the service request messages. The syntax of the destination name is specific to the JMS provider.
JMS Application Properties None User-defined JMS Properties expected to be available in the service request messages.
Note: JMS Application properties should be defined in a schema only through a complex type. Also, all JMS Application properties should be direct child of this complex type.
JMS Application Properties (Response) None User-defined JMS Properties expected to be sent in the the service response messages.

NOTE: JMS Application properties should be defined in a schema only through a complex type. Also all JMS Application properties should be direct child of this complex type.

Max Sessions None When the Acknowledge Mode field is set to Client, this field configures the maximum number of JMS sessions that is created for the service request messages.

When a message is received, the session is blocked until the message is acknowledged in the process. If acknowledgement is not done at process level then it is automatically acknowledged when the SOAP Service Binding sends a service reply.

After reaching the maximum number of sessions, no new incoming messages can be processed. After any of the messages are processed, the total number of active sessions decreases and another incoming message can be processed.

Operations None This field is available only when Topic is selected in the JMS Destination Type field.

Operation Name - Specifies the operation name.

Durable Subscription - Set to true if the client is a durable subscriber.

Subscription Name - Specify the Subscription Name if the Durable Subscription value is set to true.

Note: Imported projects display the HTTP Authentication check box under the Transport Configuration section if the check box was selected in a previous version ActiveMatrix BusinessWorks 6.x. Authentication remains enabled on the SOAP Service Binding if you do not clear the check box. If you clear the Authentication check box, a warning message is displayed prompting you to confirm your action. To remove authentication from the binding, click OK. Once you have removed authentication from the SOAP Service Binding, you can reapply it using the Basic Authentication policy.

For additional details, see Enforcing Basic Authentication and Enforcing WSS Provider in the TIBCO ActiveMatrix BusinessWorks™ Application Development guide.

Persistence Configuration

This section has the following fields.

Field Literal Value/Module Property Description
Persistence Type None Select either the NONE or File (Directory, Create Directories, and Threshold Size fields) persistence configuration types.
Directory Yes This is the directory where attachments are serialized.
Create Directories Yes Creates new directories if not present on the disk.
Threshold Size Yes The maximum size of the attachment that can be kept in memory. Attachments larger than the specified size are written to the disk. The file name generated for serialization is random except when the Content-disposition header is available for the attachment. Here, the name is the same as the content-disposition header value.

Configure the size to Bytes, KB or MB.

Threading Policy Details

The following are the details for the SOAP Service Binding threading policy.

Activity Type Multi-Threaded? Default Thread Count Thread Count Configuration
Transport: HTTP
ProcessStarter Yes
  • Minimum thread pool threads = 10
  • Maximum thread pool threads = 75
It can be configured on the HTTP Connector shared resource using the following fields:
  • Minimum QTP threads
  • Maximum QTP threads

Add Binding

Click the Add Binding icon to add a binding.

Delete Binding

Click the Delete Binding icon to delete a binding.

Policy

The Policy field is displayed for those Bindings that support policies.

To associate a new or existing policy with the SOAP HTTP Binding, click the Add Policy icon.

To edit policy details, click Policy Name. The Policy section has the following fields.

Field Description
Policy Name The name of the policy.
Policy Type The type of policy associated with the binding. The SOAP HTTP Service Binding can support the following policies:
  • Basic Authentication
  • WSS Provider
Description A description of the policy.