Siebel Financial Services Connector for ACORD P&C and Surety Guide > Configuration Roadmap > Configuring the Workflow Process >

Configuring an Inbound Siebel Connector for ACORD XML


For an inbound message, one that originates in an external application, Figure 7 shows the structure of a workflow that receives a request and sends back a response. The example workflow is the ACORD Server Policy Package Workflow included in the sample workflows.

Figure 7. ACORD Server Policy Package Workflow

Click for full size image

NOTE:  The error handling conditions and business services on the right side of the diagram are necessary to handle any rare processing errors. The sample workflow provides information about how they are configured.

Adding Process Property Values

You need to create Process Property values for the workflow, to be used in later configurations.

To create process properties

  1. Click the Process Properties tab.
  2. Enter the values shows in Table 28.

Table 28. Process Property Values for the Example Workflow
Name
Data Type
Default String
<Value>
String
<Value>
ACORD Client Application Name
String
Siebel Financial Services
ACORD Client Application Operation
String
Siebel Systems, Inc.
ACORD Client Application Version
String
7.0
ACORD DOCTYPE
String
 
ACORD DispMap Integration Object Name
String
ACORDDispMap
ACORD Envelope Integration Object Name
String
Newdefault
ACORD Service Provider Name
String
Siebel Partner
ACORD Signoff
String
FALSE
Error Code
String
 
Error Message
String
 
IsClient
String
FALSE
Object Id
String
 
PropSet Converter Out (Incoming)
Hierarchy
 
PropSet Converter Out (Outgoing)
Hierarchy
 
PropSet DTE Out (Incoming)
Hierarchy
 
PropSet DTE Out (Outgoing)
Hierarchy
 
PropSet Dispatcher Out (Incoming)
Hierarchy
 
PropSet TransMgr Out (Outgoing)
Hierarchy
 
PropSet XML Converter Out (Incoming)
Hierarchy
 
SiebelFINSOperation
String
 
SignonRsEcho
Hierarchy
 
XML Document Response
String
 

Configuring an XML Hierarchy Converter (Incoming)

The first connector component in the inbound sequence is a hierarchy converter. For information about Siebel hierarchy converters, see Siebel Business Process Designer Administration Guide.

To configure an XML hierarchy converter

  1. Name the hierarchy converter appropriately (it must be unique within the workflow).
  2. Choose the type of business service from the multi-value group (MVG) window.
  3. For this component, choose the XML Hierarchy Converter.

  4. Choose the method.
  5. This example uses the XML Document to XML Hierarchy method because, for an incoming message, the conversion is from an XML document to an XML hierarchy that can be used by the FINS ACORD XML Dispatcher.

  6. Set the input and output arguments, XML Hierarchy name, and XML document name.
  7. Following are the input argument settings for the example hierarchy converter incoming configuration.

    Input Argument
    Type
    Value
    Property Name
    Property Data Type
    XML Document
    Process Property
     
    <Value>
    String

    Following are the output argument settings for the example hierarchy converter incoming configuration.

    Property Name
    Type
    Value
    Output Argument
    PropSet XML Converter Out (Incoming)
    Output Argument
     
    XML Hierarchy

Configuring the FINS ACORD XML Dispatcher (Incoming)

The second connector component is the dispatcher.

To configure the dispatcher

  1. Name the dispatcher appropriately (it must be unique within the workflow).
  2. Choose the type of business service from the multi-value group (MVG) window.
  3. For this component, choose the FINS ACORD XML Dispatcher.

  4. Choose the method.
  5. The example uses the Dispatch Message method.

  6. Set the input and output arguments.
  7. Following are the input argument settings for the example dispatcher incoming configuration.

    Input Argument
    Type
    Value
    Property Name
    Property Data Type
    DispatcherMapName
    Process Property
     
    ACORD DispMap Integration Object Name
    String
    XMLEnvIntObjectName
    Process Property
     
    ACORD Envelope Integration Object Name
    String
    XML Property Set
    Process Property
     
    PropSet XML converter Out (Incoming)
    Hierarchy

    Following are the output argument settings for the example dispatcher incoming configuration.

    Property Name
    Type
    Value
    Output Argument
    PropSet Dispatcher Out (Incoming)
    Output Argument
     
    XML Property Set

Configuring the FINS ACORD XML Converter (Incoming)

The third connector component is the converter.

To configure the converter

  1. Name the converter appropriately (it must be unique within the workflow).
  2. Choose the type of business service from the multi-value group (MVG) window.
  3. For this component, choose the FINS ACORD XML Converter.

  4. Choose the method.
  5. The example uses XMLPropSetToPropSet, because the converter is converting an XML property set from the dispatcher into a Siebel-hierarchy-based property set.

  6. Set the input and output arguments.
  7. Following are the input argument settings for the example converter incoming configuration.

    Input Argument
    Type
    Value
    Property Name
    Property Data Type
    IsClient
    Process Property
     
    IsClient
    String
    XMLEnvIntObjectName
    Process Property
     
    ACORD Envelope Integration Object name
    String
    XML Property Set
    Process Property
     
    PropSet Dispatcher Out (Incoming)
    Hierarchy

    Following are the output argument settings for the example converter incoming configuration.

    Property Name
    Type
    Value
    Output Argument
    PropSet Converter Out (Incoming)
    Output Argument
     
    XML Property Set
    SignonRsEcho
    Output Argument
     
    SignonRsEcho

Configuring the FINS ACORD XML Data Transformation Engine (Incoming)

The fourth connector component is the data transformation engine (DTE).

To configure the DTE

  1. Name the DTE appropriately (it must be unique within the workflow).
  2. Choose the type of business service from the multi-value group (MVG) window.
  3. For this component, choose the FINS ACORD XML DTE.

  4. Choose the method.
  5. The example uses the Transform to Siebel Hierarchy method because the data is moving from an external system to a Siebel internal system.

  6. Set the input and output arguments.
  7. Following are the input argument settings for the example DTE incoming configuration.

    Input Argument
    Type
    Value
    Property Name
    Property Data Type
    XML Property Set
    Process Property
     
    PropSet Converter Out (Incoming)
    Hierarchy

    Following are the output argument settings for the example DTE incoming configuration.

    Property Name
    Type
    Value
    Output Argument
    PropSet DTE Out (Incoming)
    Output Argument
     
    XML Property Set

Configuring the FINS ACORD Transaction Manager

The fifth connector component is the transaction manager.

To configure the transaction manager

  1. Name the transaction manager appropriately (it must be unique within the workflow).
  2. Choose the type of business service from the multi-value group (MVG) window.
  3. For this component, choose the FINS ACORD XML Transaction Manager.

  4. Choose the method.
  5. The example uses the Execute Transaction method because the data is being received from the external data source and must be delivered to the Siebel application.

  6. Establish the input and output arguments.
  7. Following are the input argument settings for the example transaction manager configuration. Notice that the data flow within the connector changes direction at this point from incoming to outgoing.

    Input Argument
    Type
    Value
    Property Name
    Property Data Type
    Only product Integration Object Instance
    Literal
    true
     
     
    Report Error in Message
    Literal
    true
     
     
    Rollback In Error
    Literal
    false
     
     
    SiebelFINSOperationOut
    Process Property
     
    Siebel FINS Operation
    String
    Status Object
    Literal
    true
     
     
    XML Property Set
    Process Property
     
    PropSet DTE Out (Incoming)
    Hierarchy

    Following are the output argument settings for the example transaction manager configuration.

    Property Name
    Type
    Value
    Output Argument
    PropSet TransMgr Out (Outgoing)
    Output Argument
     
    XML Property Set

Configuring the FINS ACORD XML Data Transformation Engine (Outgoing)

The sixth connector component is the data transformation engine (DTE).

To configure the DTE

  1. Name the DTE appropriately (it must be unique within the workflow).
  2. Choose the type of business service from the multi-value group (MVG) window.
  3. For this component, choose the FINS ACORD XML DTE.

  4. Choose the method.
  5. The example uses the Transform to External Hierarchy method because the data is moving from the Siebel internal system to an external system.

  6. Set the input and output arguments.
  7. Following are the input argument settings for the example DTE outgoing configuration.

    Input Argument
    Type
    Value
    Property Name
    Property Data Type
    XML Property Set
    Process Property
     
    PropSet TransMgr Out (Outgoing)
    Hierarchy

    Following are the output argument settings for the example DTE outgoing configuration.

    Property Name
    Type
    Value
    Output Argument
    PropSet DTE Out (Outgoing)
    Output Argument
     
    XML Property Set

Configuring the FINS ACORD XML Converter (Outgoing)

The seventh connector component is the converter.

To configure the converter

  1. Name the converter appropriately (it must be unique within the workflow).
  2. Choose the type of business service from the multi-value group (MVG) window.
  3. For this component, choose the FINS ACORD XML Converter.

  4. Choose the method.
  5. The example uses PropSetToXMLPropSet because the converter is converting a property set from the DTE into a standard XML property set.

  6. Set the input and output arguments.
  7. Following are the input argument settings for the example converter outgoing configuration.

    Input Argument
    Type
    Value
    Property Name
    Property Data Type
    Client Application Name
    Process Property
     
    ACORD Client Application Name
    String
    Client Application Organization
    Process Property
     
    ACORD Client Application Organization
    String
    Client Application Version
    Process Property
     
    ACORD Client Application Version
    String
    Is Client
    Process Property
     
    IsClient
    String
    Is Signoff
    Process Property
     
    ACORD Signoff
    String
    Service Provider Name
    Process Property
     
    ACORD Service Provider Name
    String
    SignonRsEcho
    Process Property
     
    SignonRsEcho
    Hierarchy
    XMLEnvIntObjectName
    Process Property
     
    ACORD Envelope Integration Object
    String
    XML Property Set
    Process Property
     
    PropSet DTE Out (Outgoing)
    Hierarchy

    Following are the output argument settings for the example converter outgoing configuration.

    Property Name
    Type
    Value
    Output Argument
    PropSet Converter Out (Outgoing)
    Output Argument
     
    XML Property Set

Configuring an XML Hierarchy Converter (Outgoing)

The eighth connector component is a hierarchy converter. For information about Siebel hierarchy converters, see Siebel Business Process Designer Administration Guide.

To configure an XML hierarchy converter

  1. Name the hierarchy converter appropriately (it must be unique within the workflow).
  2. Choose the type of business service from the multi-value group (MVG) window.
  3. For this component, choose the XML Hierarchy Converter.

  4. Choose the method.
  5. This example uses the XML Hierarchy to XML Document method because, for an outgoing message, the final conversion is from an XML hierarchy to an XML document that can be accepted by any XML-compliant converter at the external location.

  6. Set the input and output arguments, XML Hierarchy name, and XML document name.
  7. Following are the input argument settings for the example hierarchy converter outgoing configuration.

    Input Argument
    Type
    Value
    Property Name
    Property Data Type
    XML Header Text
    Process Property
     
    ACORD DOCTYPE
    String
    XML Hierarchy
    Process Property
     
    PropSet Converter Out (Outgoing)
    Hierarchy

    Following are the output argument settings for the example hierarchy converter outgoing configuration.

    Property Name
    Type
    Value
    Output Argument
    <Value>
    Output Argument
     
    XML Document

    This step completes the inbound workflow. The inbound ACORD XML connector can be used as the basis for any workflow that is used to receive an inbound request message.


 Siebel Financial Services Connector for ACORD P&C and Surety Guide 
 Published: 18 April 2003