Siebel Adapter 6.0 SP3 | webMethods Siebel Adapter Documentation | webMethods Siebel Adapter Installation and User’s Documentation | webMethods-To-Siebel Communication | Configuring Associate Services
 
Configuring Associate Services
The Associate service performs a Siebel Associate operation. This service establishes relationships among multi-value group (MVG) business component records.
For more information, see Associate Services.
*To configure an Associate service
1. Review the steps in Before Configuring or Managing Adapter Services.
2. Start Digital Event Services or Designer.
Note:
Make sure the server with which you want to use Digital Event Services or Designer is running.
3. Perform one of the following:
*If you are using Digital Event Services, select File > New > Adapter Service and click Next.
*If you are using Designer, perform the following:
1. Right-click the package in which the service should be contained and select New > Adapter Service.
2. Select the parent namespace and type a name for the adapter service.
3. Click Next.
4. Select Siebel Adapter as the adapter type and click Next.
5. Select the appropriate Adapter Connection Name and click Next.
6. Select the Associate template and click Next.
*If you are using Digital Event Services, click Next, select a package and folder to contain the service, type a unique name for the service, and click Finish.
*If you are using Designer, click Finish.
7. The service is created and its parameters and controls are displayed in the adapter service editor. You can select the Adapter Settings tab at any time to confirm adapter properties such as adapter type, connection name, and service template, as needed.
8. Select the Navigation Path tab to specify the records that the service accesses, using the following fields:
Parameter
Description/Action
Business Object
The name of the business object that contains the business component for which you are creating a service.
Business Component
The name of the business component for which you are creating the service.
Multi-Valued Links
Select a field of the business component to use as a multi-valued link (MVL) to the business component that you want to associate. For example, if you selected a business component named Orders, you might want to associate with it all the order line items. That is, you might select a field named Line Item, which is a multi-valued link to a business component named Order Line Item.
You can associate only those component records that are linked by an association relationship. These component records are identified by the suffix *ASSOCIATE. Fields without this suffix are not linked by an association; they represent a one-to-many relationship, rather than a many-to-many relationship.
Additional Business Component [1]
The parent business component of the business component you selected, if one exists.
Additional Business Component [2]
The parent business component of the business component you selected in Additional Business Component [1], if one exists.
9. Use the Search tab to define a search expression for the selected business component. To define a search expression, provide values for the fields on the top row of the tab. Also define search expressions for a multi-valued link and up to two additional business components, if you specified them.
a. Use the icon (or the icon) to create new rows as needed.
b. Select a logical operator from the AND/OR field, an Operator, and separators (the left and right parentheses) as needed, and provide values for the following parameters:
Parameter
Description/Action
AND/OR
A logical operator.
Siebel Field
A search field of the selected business component.
Siebel Field Data Type
The data type of Siebel Field.
Operator
An operator for the search expression.
Note: For case insensitive search, select ‘~='. For case sensitive search, select ‘='.
Input Field
An input field of the adapter service.
Input Field Data Type
The data type of Input Field.
10. For information about using the Input/Output, Settings, Audit, Permissions, and Results tabs, see the webMethods Service Development Help for your release.
Digital Event Services and Designer contain the Adapter Settings and Input/Output tabs. The information from the Audit and Permissions tabs now appears in the Properties panel, and the information from the Results tab now appears in the Results panel.
11. Select File > Save.
12. To run the adapter service directly from Digital Event Services or Designer at this time, perform the following steps:
a. If you are using Digital Event Services, set the view to the Test perspective.
b. In Digital Event Services or Designer, expand the package and folder that contain the service you want to test.
c. Double-click the service you want to test.
Digital Event Services or Designer displays the configured service in the service template's Adapter Service Editor.
d. Perform one of the following
*If you are using Digital Event Services, select Test > Run.
*If you are using Designer, select Run > Run As > Run Service.
e. To connect to the Siebel Server using credentials that are different than the credentials provided at design time, specify the username and password here:
Parameter
Description/Action
user
The user name used to connect to the Siebel Server.
password
The password used to connect to the Siebel Server.
Note:
If you do not provide the user credentials here, the user credentials specified when the connection was configured are used. For more information, see Configuring Adapter Connections and Passing Credentials at Run Time while Invoking an Adapter Service.
f. If you defined any variable input fields, you will be prompted to enter their input values. Click OK.
g. Click the Results tab to view the output from this service. The output is a string field named Rows Associated, which indicates the number of rows of the associated MVG business component record.