Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Integration Guide
Version 8.1 QF0009
December, 2009
Copyright © 2005, 2009 Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be
trademarks of their respective owners.
This software and related documentation are provided under a license agreement containing restrictions
on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in
your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast,
modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any
means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for
interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-
free. If you find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS. Programs, software, databases, and related documentation and technical
data delivered to U.S. Government customers are "commercial computer software" or "commercial
technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific
supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall
be subject to the restrictions and license terms set forth in the applicable Government contract, and, to
the extent applicable by the terms of the Government contract, the additional rights set forth in FAR
52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle
Parkway, Redwood City, CA 94065.
This software is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications which may
create a risk of personal injury. If you use this software in dangerous applications, then you shall be
responsible to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe
use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused
by use of this software in dangerous applications.
The Programs may provide links to Web sites and access to content, products, and services from third
parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites.
You bear all risks associated with the use of such content. If you choose to purchase any products or
services from a third party, the relationship is directly between you and the third party. Oracle is not
responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of
the agreement with the third party, including delivery of products or services and warranty obligations
related to purchased products or services. Oracle is not responsible for any loss or damage of any sort
that you may incur from dealing with any third party.
Contents
PersonMatchService 60
OrganizationCrossReferenceService 62
PersonCrossReferenceService 66
GroupCrossReferenceService 70
FinancialAssetCrossReferenceService 73
Appendix A: Appendix
Roadmap for Manually Importing Siebel UCM Web Services 85
Process for Manually Creating Organization CRUD Web Services 86
Process for Manually Creating Person CRUD Web Services 89
Process for Manually Creating Group CRUD Web Services 92
Process for Manually Creating Financial Account CRUD Web Services 95
Process for Manually Creating Organization Cross Reference Web Services 98
Process for Manually Creating Person Cross Reference Web Services 100
Process for Manually Creating Group Cross Reference Web Services 103
Process for Manually Creating Financial Account Cross Reference Web Services 105
Process for Manually Creating Organization Match Web Services 108
Process for Manually Creating Person Match Web Services 110
This chapter contains information about Siebel CRM and Siebel UCM integration as well as user
scenarios. It contains the following topics:
■ Pull Mode. The customer record is pulled from Siebel UCM by the Siebel Business application
either for returning a set of matched candidates or for requesting a complete profile.
■ Push Mode. The customer record (either updated or newly created) is pushed from the Siebel
Business application to Siebel UCM for synchronization. The newly created or updated record is
then pushed back to the Siebel Business Application.
These two sub-processes do not depend on the Siebel Business application having constant access
to Siebel UCM records. The Siebel database may query for the desired record, and if the query
returns no results, then the Match and Request process can be made to Siebel UCM. The local version
of customer record is independent of the Match and Request process to Siebel UCM. The Match and
Request process is done to refresh customer data, and may only be called during such a requirement.
Sync Customer
Sync Customer processes allow a Siebel application user who has the authority to create and update
customer information to have the golden master version of the customer record, and also to
synchronize any new Create or Update operations from the Siebel Business application to Siebel
UCM. This is a push-type operation either from the Siebel Business application to Siebel UCM
(synchronizing the new or updated records from the application to Siebel UCM), or from Siebel UCM
to the Siebel Business application (synchronizing the new or updated processed records from Siebel
UCM to the Siebel Business application).
Sync Customer processes allow a Siebel application user who has the authority to create and update
customer information to have the golden Master version of the customer record, and also that any
new Create or Update operations to the Siebel Business application to be synchronized to Siebel
UCM.
Merge Customer
The Merge Customer process allows Siebel Business applications to consume a merge operation that
was performed and initiated in Siebel UCM. The merge operation involves merging two customer
records (two accounts or two contacts) to create a single record in Siebel UCM. This merge operation
in Siebel UCM results in invoking a Merge Customer Oracle Application Integration Architecture
process, which indicates which two original records were merged and which is the resulting record.
This process assumes that the merge operation always originates in Siebel UCM.
■ “Scenario for Manually Creating a New Customer Record and Synchronizing with Siebel UCM” on
page 7
■ “Scenario for Using Match and Request Functionality to Create an Account Record” on page 7
■ “Scenario for Using Match and Request Functionality to Create a Person Record” on page 8
■ “Scenario for Manually Creating a New Customer Record and Synchronizing with Siebel UCM” on
page 8
■ “Scenario for Synchronizing Account or Customer Changes to Siebel UCM” on page 9
A customer service representative (CSR) using Siebel Call Center receives an incoming call from a
prospective customer representing an organization who is requesting product information. The CSR
records information about the customer including the organization name, address, and contact
information.
The CSR uses Account Type or Account Class to flag the customer as a Prospect, then creates an
Opportunity record as required to fulfill the product information request. The CSR manually invokes
a Sync process to push the newly created records to Siebel UCM.
Siebel UCM then synchronizes the record and applies any additional data quality or cleansing
processes to record. Siebel UCM then calls an automatic synchronization process to send the record
back to the Siebel Business application. The Siebel Business application receives the updated record
(if Siebel UCM has applied changes to the original record that was submitted).
A customer service representative (CSR) using Siebel Call Center receives an incoming call from a
representative of an organization who is a potential customer. The CSR enters the organization name
in the Account screen and clicks the Match button, triggering the Match flow.
The Match flow passes the input data to Siebel UCM through Oracle Application Integration
Architecture. Siebel UCM invokes fuzzy matching logic functionality as part of its Data Matching
algorithm and returns a list of matching candidate Organization records based on the provided input
criteria.
The list of matching candidates is displayed to the CSR in the Accounts screen. The CSR selects a
specific Organization record from the list. After selecting the record, the CSR wishes to get a
complete profile of the Organization record to perform other tasks, such as issue resolution, order
capture and so on. To get a complete profile, the CSR clicks the Fetch button to initiate the Fetch
Customer process.
The Fetch Customer process requests the identified organization customer from Siebel UCM to
retrieve the entire customer profile. Siebel UCM queries the selected organization customer and
invokes a discrete Sync customer service to push the entire Account profile to the Siebel Business
application. The synchronization process occurs in the background requiring no CSR or UI interaction.
Upon successful synchronization, the Siebel Business application must put the retrieved Account
record in focus to eliminate the need for CSR to re-query the record.
A customer service representative (CSR) using Siebel Call Center has received an incoming call from
a customer. The CSR enters the customer information, such as first name, last name, address and
so on, into the Siebel Contact screen, and then clicks the Match button, triggering the Match flow
process.
The Match flow passes the input data to Siebel UCM through Oracle Application Integration
Architecture. Siebel UCM invokes fuzzy matching logic functionality as part of its Data Matching
algorithm and returns a list of matching candidate Person records based on the input criteria. The
list of matching candidates is displayed in the Contact screen. The CSR selects a specific Contact
record from the list.
After selecting the record, the CSR wishes to get the complete profile of the Contact record to
perform other tasks, such as issue resolution, order capture, and so on. To get a complete profile,
the CSR clicks the Fetch button to initiate the Fetch Person Customer process.
The Fetch Person Customer process requests the identified person customer from Siebel UCM to
retrieve the entire customer profile. Siebel UCM queries the selected person customer record and
invokes a discrete Sync customer service to push the entire Account profile to the Siebel Business
application. The synchronization process occurs in the background requiring no user or user interface
interaction. Upon successful synchronization, the Siebel Business application must put the retrieved
Organization (Account) record in focus to eliminate the need for the CSR to re-query the record.
A customer service representative (CSR) using Siebel Call Center receives an incoming call from a
prospective customer representing an Organization who is requesting product information. The CSR
records information about the customer including the organization name, address, contact
information. The CSR uses Account Type or Account Class to flag the customer as a Prospect. The
CSR creates an Opportunity as required to fulfill the product information request. The CSR manually
invokes a Sync process to push created records to Siebel UCM.
Siebel UCM synchronizes the record and applies any additional data quality or cleansing processes
to record. Siebel UCM calls an automatic synchronization process to send the record back to the
Siebel Business application. The Siebel Business application receives the updated record (if Siebel
UCM has applied changes to the original record that was submitted).
A customer service representative (CSR) using Siebel Call Center has updated an address and phone
number record of an Account based on newly obtained information. The CSR invokes a real-time Sync
process in the Siebel Business application to synchronize the changes to Siebel UCM.
Siebel UCM accepts the changes from the Siebel Business application and updates the master
Account record in Siebel UCM. Siebel UCM may make additional updates to incoming record based
on embedded Data Quality services.
Updates to the Account profile are synchronized from Siebel UCM to the Siebel Business application.
Account profiles are updated the Siebel Business application.
■ “Scenario for Manually Merging Two Accounts in Siebel UCM and Publishing a Merge Message” on
page 9
■ “Scenario for Sending Contact Information to Third Party Provider for Enrichment” on page 10
A data steward performs periodic review of duplicate account records that have not been auto-
merged. Auto-merges may not take place to a record falling between the upper and lower match
confidence thresholds of the data matching engine.
The data steward logs into Siebel UCM and navigates to the Account Data Management tab. The data
steward sees two account records in the duplicate queue that have been flagged for review based on
automated match criteria.
The two account records have the following characteristics that make them candidates for merge:
■ Existing Account: Oracle Corp, 101 Main Street, San Francisco, CA 94104
■ Potential duplicate Account (sent by Siebel CRM): Oracle Corporation, 123 Main Street, San
Francisco, CA 94111
The data steward decides that the second record is the same record as the existing record. The data
steward invokes Link and Update button to combine the two records.
Survivorship Rules that have been setup determine which record takes precidence. The same
survivorship rule dictates that the original Address field from Siebel Business application has a higher
confidence level so therefore this field remains unchanged.
The duplicate record is removed (but retained in the audit history). The updated existing record now
has the following best version profile:
Existing Account: Oracle Corporation, 101 Main Street, San Francisco, CA 94104
The merge record is published (in real-time or during a batch process) to synchronize the Surviving
record profile and the Victim record Id.
A data steward decides to utilize a third party data enrichment services to enrich the information of
an existing Contact with whom the company conducts business. The data steward initiates a process
to send first name, last name and address information to third party provider by way of Oracle
Application Integration Architecture.
Depending on the data enrichment services that the organization has subscribed to, the third party
provider consumes the message parameters and passes back additional attributes, such as privacy
information and, or cleansed address information.
Siebel UCM contact information is updated by the contact message returned from the third party
provider by way of Oracle Application Integration Architecture. The data steward refreshes the
screen view to reveal updated contact information. The data steward manually invoke a Sync service
to update the record in the Siebel Business application with updated information (if those
applications have been setup to handle enriched attributes.
This chapter includes process topics on how to use Siebel Tools and the Siebel Mobile Web client to
automatically configure Create, Read, Update and Delete (CRUD) Web services to work with Person,
Group, Financial Account, and Organization records. The chapter also includes topics on how to
manually configure each UCM Web service. Topics include:
■ “OrganizationService” on page 25
■ “PersonService” on page 34
■ “GroupService” on page 44
■ “OrganizationMatchService” on page 58
■ “PersonMatchService” on page 60
■ “OrganizationCrossReferenceService” on page 62
■ “PersonCrossReferenceService” on page 66
■ “GroupCrossReferenceService” on page 70
■ “FinancialAssetCrossReferenceService” on page 73
Oracle Customer Hub (UCM) uses industry standard Web Services Definition Language (WSDL) for
publishing Web services to external systems. In earlier version of Oracle Customer Hub (UCM)
Oracle’s CRMML, an XML based markup language, provided the means for data exchange. CRMML
was used for communication within Oracle Customer Hub (UCM). For example it was used for inbound
request/response and in Publish/Subscribe types of message delivery.
This information was used by Oracle Customer Hub (UCM) for security verifications
■ Inbound requests from an external application to insert, query, update or delete a database
object
■ CRMML is proprietary to Oracle UCM and not part of Oracle|Siebel messaging standards
In the proposed solution of replacing CRMML with Siebel SOAP messages the following will be
accomplished:
■ Alignment to the open standards of XML over SOAP which allows UCM to be closer to Core
messaging infrastructure
■ Harmonizes the Web services with Siebel Order to Cash, AIA EBO’s and Oracle Fusion services
If your implemented language code is non-ENU you will need to import the non-ENU symbolic strings
that came with your QF0009 installation. Perform the following task:
Field Value
4 Browse to the QF0009 installation directory, and locate the desired LMU file.
5 Click Import.
You must now import the System Preferences and the List of Values data from the Seed Data folder
located in your QF0009 installation directory.
4 Enter a datasource name, and enter the server name you will be connecting to.
TIP: For an Oracle database, enter the TNS service name that you created to connect your tools
to the database.
5 Navigate to the Siebel Tools installation directory and change the directory to
REPPATCH\ACR437_UCM.
NOTE: The /h log will log in case of unique constraint violations and not error out. The /e n will
enforce the dataimp to look at only tables in inp file.
■ Replace <Tools Install Directory> with your Siebel Tools installation directory.
■ Replace <ODBC Source Name> with the ODBC you created in Step 3.
2 Import two additional .dat files (seed.dat and seed_locale_<lang code>.dat) and two .inp files
(UCMMST811_seedimp.inp and UCMMST811_seedimp_locale.inp).
4 Run the following command for seed_locale_xxx.dat, where xxx is the language.
■ Replace <Tools Install Directory> with your Siebel Tools installation directory.
■ Replace <ODBC Source Name> with the ODBC you created in Step 3 on page 14.
6 Review the log file <Siebel Tools Install Directory>\temp\UCMMST881_Seed.log file to make
sure that the import was completed successfully.
SIF files contain Siebel object definitions that can be imported into Siebel Tools to replace existing
definitions. Following successful application of QF0009, you will then locate and import the .sif file
that came with the QuickFix into Siebel Tools. This .sif file contains object definitions that are
different from those contained in your present repository.
■ Schemas
■ SeedData
■ Sifs
■ WebServices_XML
4 Open the Sifs folder, and verify that the following .sif files are present:
■ BusinessComponents.sif
■ BusinessServices\BusinessServices.sif
■ Business Services\OracleAIA-PROXYBusinessServices.sif
■ BusinessServices\OracleAIA-AcxiomPROXYBusinessService.sif
■ IntegrationObjects.sif
■ Tables\Tables.sif
■ Tables\EIMTables.sif
■ Applets.sif
■ Class.sif
■ PickLists.sif
■ SymbolicStrings.sif
■ Workflow.sif
5 After verifying that the .sif files are all present, log on to Siebel Tools.
■ Account
■ Contact
■ DeDuplication
■ Employee
■ FINS Portfolio
■ Household
■ Table Asset
■ Table CIF
■ Table Household
■ Table Organization
■ Table Person
■ UCM SDH
■ UCM Survivorship
■ Web Service
■ EIM Organization
■ EIM Person
■ EIM Asset
■ EIM CIF
■ EIM Household
7 Import all the listed .sifs to the server database choosing the Merge option.
NOTE: Before importing the SymbolicStrings.sif file, make sure the following parameter value is
set in tools.cfg file: SymStrPrefix = SBL_.
8 In Siebel Tools navigate to Screens, System Administration, and then List Of Values.
9 In the List of Values screen, query for the values shown in Figure 1, then activate the values if
they are not already active.
NOTE: If these values are not found they must be added before proceeding.
10 In Siebel Tools Object Explorer, navigate to Tables and query for the tables that have been
modified by selecting the query with the Changed flag set.
■ S_ADDR_PER_UCMX
■ S_ASSET
■ S_CONTACT
■ S_CON_ADDR
■ S_ORG_EXT
■ S_ORG_GROUP
■ S_ORG_GRP_UCMX
■ S_PRIVACY
■ S_UCM_ADDR_PER
■ S_UCM_ASSET
■ S_UCM_CONTACT
■ S_UCM_ORGGRP
■ S_UCM_ORG_EXT
■ S_UCM_PRIVACY
■ S_USER
■ EIM_ACCOUNT1
■ EIM_ADDR_PER
■ EIM_ASSET
■ EIM_CONTACT2
■ EIM_FN_CIF_SYST
■ EIM_GROUP
■ EIM_GROUP_DTL
■ EIM_PRIVACY
■ EIM_UCM_ADRPER
■ EIM_UCM_ASSET
■ EIM_UCM_CON
■ EIM_UCM_ORG
■ EIM_UCM_ORGGRP
■ EIM_UCM_PRIVCY
■ EIM_USER
MSSQL
❏ Database user
ORACLE
❏ Table space
❏ Index space
❏ Database user
DB2
❏ Table space
❏ Index space
❏ Database user
14 Click Apply.
The modification process may take a moment.
15 Once the process is finished Click OK to finish the table schema changes.
16 Repeat Step 12 through Step 15 until all required tables have been modified.
TIP: You can apply the schema changes to all the tables in one pass by selecting the Current
Query in the Tables drop-down in the Apply Schema window. To perform this you have to have
executed a query with changed flag set.
Activating Workflows
This step is part of “Process for Configuring Siebel UCM Web Services” on page 13.
3 For each workflow, click Activate button in the top of the Repository Workflow Processes view.
4 Verify that the Activation Date/Time and Expiration Date fields display a valid date and time. If
not, change the Expiration Date time to a future date and time.
■ Account
■ Contact
■ DeDuplication
■ Employee
■ FINS Portfolio
■ Household
■ TableAsset
■ TableCIF
■ TableHousehold
■ TableOrganization
■ TablePerson
■ UCM Merge
■ UCM Privacy Management
■ UCM SDH
■ UCM Survivorship
■ Web Service
■ EIM Organization
■ EIM Person
■ EIM Asset
■ EIM CIF
■ EIM Household
4 Query for the Integration Objects which were imported from the .sif files.
For example: use the query Swi* to see all the relevant Integration Objects.
5 For each of the four Integration Objects for CRUD, choose Undeploy from the right-click menu,
then refresh.
2 In the Deployed Integration Objects view verify that all the Integration Objects you deployed in
Siebel Tools are showing the correct time of deployment.
This will allow you to make sure the Integration Objects displayed are those you imported.
NOTE: If you have Oracle AIA-Siebel UCM Integration see Step 3, if not see Step 5.
3 From the Outbound Web Services view Query for the Oracle AIA Web services:
■ SyncOrganizationUCMJMSProducer
■ SyncPersonUCMJMSProducer
4 Change the Address of the ports corresponding to these Web services to point to the appropriate
Oracle AIA end point.
5 If non Oracle AIA integration, navigate to the Outbound Web Services view and query for the
Web service that was created in “To create the proxy business service” on page 80.
6 Change the address of the ports corresponding to the Web services to point to the appropriate
middleware end point.
3 If not found, create new records for each of the parameters displayed in in the following table:
Parameter Value
Parameter Value
Parameter Value
VICTIM_OPERATION_TYPE Delete
SURVIVOR_OPERATION_TYPE Upsert
6 Select UCM DeDuplication Results (Contact) and in the Object Explorer, navigate to Business
Component User Prop.
VICTIM_OPERATION_TYPE Delete
SURVIVOR_OPERATION_TYPE Upsert
2 Register a new system as a Middleware System by checking the Middleware check-box, and
provide a convenient name for the newly created system.
6 Select the appropriate Business Service Name and Method Name by clicking the PickList button
on the two columns: Business Service Name and Business Service Method and choose the values
listed in the following table:
CAUTION: These are the Business Service names and Business Service method names that are
required if Oracle AIA is your middleware. For any other non-AIA middleware provider choose the
Web Service Names and Method Names that were created as part of “To create the proxy business
service” on page 80.
■ Always use the WSDL files provided in the Quick Fix installation folder:
...\ACR437_UCM\Schemas\wsdls
■ Note that all UCM Web services specify an external system which requests the operation as an
attribute in the SOAP request. For more information, see the schema definition in the Quick Fix
installation folder: ...\ACR437_UCM\Schemas\xsd.
■ For all UCM Web services a requesting operation is specified as an attribute in the SOAP request.
For more information, see the schema definition in the Patch folder:
...\ACR437_UCM\Schemas\xsd.
■ Always perform the required UCM operation invoking the respective UCM Web Services. For
instance, executing an Update request invoking the UCM Create Web service is not advised as
unreliable output will result.
■ “OrganizationService” on page 25
■ “PersonService” on page 34
■ “GroupService” on page 44
■ “OrganizationMatchService” on page 58
■ “PersonMatchService” on page 60
■ “OrganizationCrossReferenceService” on page 62
■ “PersonCrossReferenceService” on page 66
■ “GroupCrossReferenceService” on page 70
■ “FinancialAssetCrossReferenceService” on page 73
OrganizationService
Use this Web service to perform all operations related to the Organization and or the Account object
in the Siebel Business application. This Web service is used for all party operations. UCM organization
messages are used in insert, query, update and delete operations to maintain Organization
information.
OrganizationService Operations
For a list of operations associated with this Web service, see Table 1.
Name Description
SwiOrganizationIO Account
Methods
For a description of the methods for this Web service, see Table 12.
Operation Method
createOrganization RunProcess
updateOrganization RunProcess
deleteOrganization RunProcess
getOrganization RunProcess
Request
See the following file to view the sample code:
...WebServices_XML\CRUDServices\OrganizationService\Request.xml
Response
See the following file to view the sample code:
......WebServices_XML\CRUDServices\OrganizationService\Response.xml
WSDL:
...WSDL\OrganizationService.wsdl
Schema:
..WSDL\ListofSwiOrganizationServiceIO.xsd
..WSDL\ListofSwiOrganizationServicePublishIO.xsd
PersonService
Use this Web service to create, update, retrieve and delete Person records.
PersonService Operations
For a list of operations associated with this Web service, see Table 13.
Name Description
SwiPersonIO Contact
Methods
For a description of the methods for this Web service, see Table 24.
Operation Method
createPerson RunProcess
updatePerson RunProcess
deletePerson RunProcess
getPerson RunProcess
Request
See the following file to view the sample code:
...WebServices_XML\CRUDServices\PersonService\Request.xml
Response
See the following file to view the sample code:
...WebServices_XML\CRUDServices\PersonService\Response.xml
WSDL:
...WSDL\FetchAccountSiebelReqABCSImpl.wsdl
Schema:
...WSDL\SwiPersonIO.wsdl
...WSDL\SwiPersonPublishIO.wsdl
GroupService
Use this Web service to perform all operations related to Households (Groups). UCM Household
messages are used in insert, query, update and delete operations to maintain Household information.
GroupService Operations
For a list of operations associated with this Web service, see Table 25.
Name Description
SwiGroupIO Household
Methods
For a description of the methods for this Web service, see Table 36.
Operation Method
createGroup RunProcess
updateGroup RunProcess
deleteGroup RunProcess
getGroup RunProcess
Request
See the following file to view the sample code:
......WebServices_XML\CRUDServices\GroupService\Request.xml
Response
See the following file to view the sample code:
......WebServices_XML\CRUDServices\GroupService\Response.xml
WSDL:
...WSDL\GroupService.wsdl
Schema:
...WSDL\SwiGroupIO.wsdl
...WSDL\SwiGroupPublishIO.xsd
Name Description
createFinancialAsset Creates a new financial account record.
Methods
For a description of the methods for this Web service, see Table 48.
Operation Method
createFinancialAsset RunProcess
updateFinancialAsset RunProcess
deleteFinancialAsset RunProcess
getFinancialAsset RunProcess
Request
See the following file to view the sample code:
......WebServices_XML\CRUDServices\FinancialAssetService\Request.xml
Response
See the following file to view the sample code:
......WebServices_XML\CRUDServices\FinancialAssetService\Response.xml
WSDL:
...WSDL\FinancialAssetService.wsdl
Schema:
...WSDL\ListofSwiFinancialAssetIO.xsd
...WSDL\ListofSwiFinancialAssetPublishIO.xsd
OrganizationMatchService
Use this Web service to find similar Accounts and Organizations in designated databases, such as
UCM database, corresponding to the one being sent in a request message. The similarity is based on
advanced algorithms (as opposed to a plain search where a user would input A* and receive all
Account records beginning with A) and depends on the matching engine (such as ISS, SSA and so
on) used at the back-end with the match strategies, rules, and configurations in place.
OrganizationMatchService Operations
For a list of operations associated with this Web service, see Table 49.
Name Description
SwiOrganizationMatchOutputIO SwiOrganizationMatchOutputIO
Methods
For a description of the methods for this Web service, see Table 54.
Operation Method
Request
See the following file to view the sample code:
......WebServices_XML\OrganizationMatchService\Request.xml
Response
See the following file to view the sample code:
...WebServices_XML\OrganizationMatchService\Response.xml
...WSDL\OrganizationMatchService.wsdl
...WSDL\SwiOrganizationMatchInputIO.xsd
...WSDL\SwiOrganizationMatchOutputIO.xsd
PersonMatchService
Use this Web service to find similar Contacts in designated databases, such as UCM database,
corresponding to the one being sent in a request message. The similarity is based on an advanced
algorithms (as opposed to a plain search where a user would input A* and receive all Account records
beginning with A) and depends on the matching engine (such as ISS, SSA and so on) used at the
back-end with the match strategies, rules, and configurations in place.
PersonMatchService Operations
For a list of operations associated with this Web service, see Table 55.
Name Description
SwiPersonMatchOutputIO SwiPersonMatchOutputIO
Methods
For a description of the methods for this Web service, see Table 60.
Operation Method
Request
See the following file to view the sample code:
....WebServices_XML\PersonMatchService\Request.xml
Response
See the following file to view the sample code:
...WebServices_XML\PersonMatchService\Response.xml
...WSDL\PersonMatchService.wsdl
...WSDL\SwiPersonMatchInputIO.xsd
...WSDL\SwiPersonMatchOutputIO.xsd
OrganizationCrossReferenceService
Use this Web services to create explicit links between organization records within UCM and those in
participating applications.
OrganizationCrossReferenceService Operations
For a list of operations associated with this Web service, see Table 61.
Name Description
SWIOrganizationPublishIO Account
Methods
For a description of the methods for this Web service, see Table 72.
Operation Method
createOrganizationCrossReference RunProcess
updateOrganizationCrossReference RunProcess
deleteOrganizationCrossReference RunProcess
getOrganizationCrossReference RunProcess
Request
See the following file to view the sample code:
...WebServices_XML\CrossReferenceServices\OrganizationCrossReferenceService\Request.xml
Response
See the following file to view the sample code:
...WebServices_XML\CrossReferenceServices\OrganizationCrossReferenceService\Response.xml
WSDL:
...WSDL\OrganizationCrossReferenceService.wsdl
Schema
...WSDL\ListofSwiOrganizationIO.xsd
...WSDL\ListofSwiOrganizationPublishIO.xsd
PersonCrossReferenceService
Use this Web services to create explicit links between person records within UCM and those in
participating applications.
PersonCrossReferenceService Operations
For a list of operations associated with this Web service, see Table 73.
Name Description
SWIPersonPublishIO Contact
Methods
For a description of the methods for this Web service, see Table 84.
Operation Method
createPersonCrossReference CreatePersonCrossReference
updatePersonCrossReference UpdatePersonCrossReference
deletePersonCrossReference DeletePersonCrossReference
getPersonCrossReference GetPersonCrossReference
Request
See the following file to view the sample code:
...WebServices_XML\CrossReferenceServices\PersonCrossReferenceService\Request.xml
Response
See the following file to view the sample code:
...WebServices_XML\CrossReferenceServices\PersonCrossReferenceService\Response.xml
WSDL:
...WSDL\PersonCrossReferenceService.wsdl
Schema:
...WSDL\ListofSwiPersonIO.xsd
...WSDL\ListofSwiPersonPublishIO.xsd
GroupCrossReferenceService
Use this Web services to create explicit links between Group records within UCM and those in
participating applications.
GroupCrossReferenceService Operations
For a list of operations associated with this Web service, see Table 85.
Name Description
Methods
For a description of the methods for this Web service, see Table 96.
Operation Method
createGroupCrossReference CreateGroupCrossReference
updateGroupCrossReference UpdateGroupCrossReference
deleteGroupCrossReference DeleteGroupCrossReference
getGroupCrossReference GetGroupCrossReference
Request
See the following file to view the sample code:
...WebServices_XML\CrossReferenceServices\GroupCrossReferenceService\Request.xml
Response
See the following file to view the sample code:
....WebServices_XML\CrossReferenceServices\GroupCrossReferenceService\Response.xml
WSDL:
...WSDL\GroupCrossReferenceService.wsdl
Schema:
...WSDL\ListofSwiGroupIO.xsd
...WSDL\ListofSwiGroupPublishIO.xsd
FinancialAssetCrossReferenceService
Use this Web services to create explicit links between financial account records within Siebel
AccountUCM and those in participating applications.
FinancialAssetCrossReferenceService Operations
For a list of operations associated with this Web service, see Table 97.
Name Description
Name Description
Operation Method
createFinancialAssetCrossReference CreateFinancialAssetCrossReference
updateFinancialAssetCrossReference UpdateFinancialAssetCrossReference
deleteFinancialAssetCrossReference DeleteFinancialAssetCrossReference
getFinancialAssetCrossReference GetFinancialAssetCrossReference
Request
See the following file to view the sample code:
...WebServices_XML\CrossReferenceServices\FinancialAssetCrossReferenceService\Request.xml
Response
See the following file to view the sample code:
...WebServices_XML\CrossReferenceServices\FinancialAssetCrossReferenceService\Response.xml
WSDL:
...WSDL\FinancialAssetCrossReferenceService.wsdl
Schema:
...WSDL\ListofSwiFinancialAssetPublishIO.xsd
This chapter includes processes on topics on how to configure Siebel Outbound Web Services for
integration with Siebel UCM. Topics include:
NOTE: You only perform this step if you are creating proxy business services using WSDL files
provided by a third party data enrichment Web service.
CAUTION: This configuration step is not required for OracleAIA-UCM Integration. There is a
prerequisite requirement for a middleware provider to be installed and set up to handle outbound
data enrichment calls. If you are setting up an Oracle AIA-Siebel UCM Integration, make sure Oracle
AIA is set up and functioning. If Siebel UCM is integrated with any other middleware, make sure the
middleware installation is completed before proceeding with the following steps.]
2 In the New Object wizard click the EAI tab and select the Web Service Icon.
3 Lock the project Web Service Integration and and lock the Project name.
4 Browse to the location of the WSDL file provided by the third party data enrichment Web service.
The run-time data file and log file entries are automatically created.
5 Click Next.
6 Check the Deploy Integration Objects and Proxy Business Services check box.
7 Click Finish.
8 Check in the logs for the entry Outbound proxy business service definitions to be generated. At
the end of the definition, you will see the name of the proxy business service you created.
For example:
In this example, ProcessPersonUCMReqABCSImpl is the name of the proxy service that was
created.
9 Once the proxy business service is created, click the Business Services object in the Object
Explorer.
NOTE: You only perform this step if you are creating proxy business services using WSDL files
provided by a third party data enrichment Web service.
4 Note the Integration Object names, then using the Object Explorer, locate and delete these
objects.
The default Integration Objects will not be used, instead the newly imported Integration Objects
will take their place.
5 Replace the existing Integration Object name in the Business Service Method Arguments of the
proxy service with the new Integration Object name displayed in the following table:
Person SwiPersonIO
RequestTypeContact ProcessPersonReqMsg:ListOfSwiPersonIO
ResponseTypeContact ProcessPersonRespMsg:ListOfSwiPersonIO
UCMIONameContact SwiPersonIO
2 From the Outbound Web Services view query for the following OracleAIA webservice:
ProcessPersonUCMReqABCSImpl
3 Change the address of the ports corresponding to this Web service to point to the appropriate
AIA end point.
4 If you do not have Axciom Integration, from the Outbound Web Services view query for the
webservice that you created in the following task: “To create the proxy business service” on
page 80.
5 Change the address of the ports corresponding to the Web services to point to the appropriate
Middleware end point.
Field Value
Active Y
Sequence 1
Field Value
NOTE: There may be other events for the same Object and Event,
so you must provide a different number from the existing events.
Field Value
Event PreWriteRecord
Action Set Name The name you provided in Step 3 on page 82.
9 Query for: Enable Data Enrichment, and make sure the System Preference Value is set to TRUE.
This appendix contains information about manual import and creation of Siebel UCM Web services.
It contains the following topics:
NOTE: These topics are optional. In the event that your services were not configured during
installation and setup, you may manually create them using the tasks which follow.
■ “Process for Manually Creating Financial Account CRUD Web Services” on page 95
■ “Process for Manually Creating Organization Cross Reference Web Services” on page 98
■ “Process for Manually Creating Person Cross Reference Web Services” on page 100
■ “Process for Manually Creating Group Cross Reference Web Services” on page 103
■ “Process for Manually Creating Financial Account Cross Reference Web Services” on page 105
■ “Process for Manually Creating Organization Match Web Services” on page 108
■ “Process for Manually Creating Person Match Web Services” on page 110
■ “Process for Manually Creating Financial Account CRUD Web Services” on page 95
■ “Process for Manually Creating Organization Cross Reference Web Services” on page 98
■ “Process for Manually Creating Person Cross Reference Web Services” on page 100
■ “Process for Manually Creating Group Cross Reference Web Services” on page 103
■ “Process for Manually Creating Financial Account Cross Reference Web Services” on page 105
■ “Process for Manually Creating Organization Match Web Services” on page 108
■ “Process for Manually Creating Person Match Web Services” on page 110
Field Value
Namespace http://xmlns.oracle.com/apps/mdm/customer.
Name OrganizationService
Status Active
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Workflow Process Name UCM Organization Customer Profile Integration SOAP Process
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
7 Click Save, then click New to make the next entry for Service Port 2.
10 Click the Select button in the Type field, and when the applet appears, click New.
11 Enter values displayed in the following table:
Field Value
12 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
8 In the Operations view, click Add, then in the popup applet, click New.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
Field Value
Namespace http://xmlns.oracle.com/apps/mdm/customer
Name PersonService
Status Active
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Workflow Process Name UCM Person Customer Profile Integration SOAP Process
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
7 Click Save, then click New to make the next entry for Service Port 2.
10 Click the Select button in the Type field, and when the applet appears, click New.
11 Enter values displayed in the following table:
Field Value
Workflow Process Name UCM Person Customer Profile Integration SOAP Query Process
12 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
8 In the Operations view, click Add, then in the popup applet, click New.
2 Select the PersonService from the Inbound Web Services screen, and click the Generate WSDL
button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory will be
used.
Field Value
Namespace http://xmlns.oracle.com/apps/mdm/customer.
Name GroupService
Status Active
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Workflow Process Name UCM Group Customer Profile Integration SOAP Process
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
7 Click Save, then click New to make the next entry for Service Port 2.
10 Click the Select button in the Type field, and when the applet appears, click New.
11 Enter values displayed in the following table:
Field Value
Workflow Process Name UCM GroupCustomer Profile Integration SOAP Query Process
12 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
4 Leave the default value of the Method Display Name to Run Process.
8 In the Operations view, click Add, then in the popup applet, click New.
2 Select the GroupService from the Inbound Web Services screen, and click the Generate WSDL
button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
Field Value
Namespace http://xmlns.oracle.com/apps/mdm/customer.
Name FinancialAssetService
Status Active
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Workflow Process Name UCM Financial Asset Customer Profile Integration SOAP Process
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
7 Click Save, then click New to make the next entry for Service Port 2.
10 Click the Select button in the Type field. , and when the popup applet appears, click New.
11 Enter values displayed in the following table:
Field Value
12 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
8 In the Operations view, click Add, then in the popup applet, click New.
2 Select the FinancialAssetService from the Inbound Web Services screen, and click the Generate
WSDL button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
Field Value
Namespace http://xmlns.oracle.com/apps/mdm/customer
Name OrganizationCrossReferenceService
Status Active
Comment Organization Cross Reference Service
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Name OrganizationCrossReferenceService
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
3 Enter the following name: createOrganizationCrossReference.
4 Click the Select button in the Method Display Name field, and when the popup applet appears,
pick the following entry:
Authentication
Method Display Name Name Type
2 Select the OrganizationCrossReferenceService from the Inbound Web Services screen, and click
the Generate WSDL button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
100 Siebel UCM and CRM Integration Guide Version 8.1 QF0009
Appendix ■ Process for Manually Creating Person Cross Reference Web Services
Field Value
Namespace http://xmlns.oracle.com/apps/mdm/customer
Name PersonCrossReferenceService
Status Active
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Name PersonCrossReferenceService
Implementation Type Business Service
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
4 Click the Select button in the Method Display Name field, and when the applet appears, pick the
following entry:
2 Select the PersonCrossReferenceService from the In the Inbound Web Services screen, and click
the Generate WSDL button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
102 Siebel UCM and CRM Integration Guide Version 8.1 QF0009
Appendix ■ Process for Manually Creating Group Cross Reference Web Services
Field Value
Namespace http://xmlns.oracle.com/apps/mdm/customer
Name GroupCrossReferenceService
Status Active
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Name GroupCrossReferenceService
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
3 Enter the following name: createGroupCrossReference.
4 Click the Select button in the Method Display Name field, and when the applet appears, pick the
following entry:
Authentication
Name Method Display Name Type
104 Siebel UCM and CRM Integration Guide Version 8.1 QF0009
Appendix ■ Process for Manually Creating Financial Account Cross Reference Web Services
Authentication
Name Method Display Name Type
2 Select the GroupCrossReferenceService from the In the Inbound Web Services screen, and click
the Generate WSDL button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
■ “Registering the Financial Account Cross Reference Web Service” on page 105
Field Value
Namespace http://xmlns.oracle.com/apps/mdm/customer
Name FinancialAssetCrossReferenceService
Status Active
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Name FinancialAssetCrossReferenceService
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
106 Siebel UCM and CRM Integration Guide Version 8.1 QF0009
Appendix ■ Process for Manually Creating Financial Account Cross Reference Web Services
2 In the Operations view, click Add, then in the popup applet, click New.
4 Click the Select button in the Method Display Name field, and when the applet appears, pick the
following entry:
Authentication
Name Method Display Name Type
2 Select the FinancialAssetCrossReferenceService from the In the Inbound Web Services screen,
and click the Generate WSDL button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
Field Value
Namespace http://siebel.com/DataQuality
Name OrganizationMatchService
Status Active
4 Click the Select button in the Type field, and when the applet appears, click New.
108 Siebel UCM and CRM Integration Guide Version 8.1 QF0009
Appendix ■ Process for Manually Creating Organization Match Web Services
Field Value
Name OrganizationMatchService
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
3 Enter the following name: OrganizationMatch.
4 Click the Select button in the Method Display Name field, and when the applet appears, pick the
following entry:
2 Select the OrganizationMatchService from the In the Inbound Web Services screen, and click the
Generate WSDL button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
Field Value
Namespace http://siebel.com/DataQuality
Name PersonMatchService
Status Active
110 Siebel UCM and CRM Integration Guide Version 8.1 QF0009
Appendix ■ Process for Manually Creating Person Match Web Services
4 Click the Select button in the Type field, and when the applet appears, click New.
Field Value
Name PersonMatchService
6 Click OK, then in the Service Ports view, enter remaining values displayed in the following table:
Field Value
Transport HTTP
Binding SOAP_DOC_LITERAL
2 In the Operations view, click Add, then in the popup applet, click New.
4 Click the Select button in the Method Display Name field, and when the applet appears, pick the
following entry:
2 Select the PersonMatchService from the In the Inbound Web Services screen, and click the
Generate WSDL button.
This generated WSDL will not be used, instead the WSDL in the QuickFix installation directory
will be used.
112 Siebel UCM and CRM Integration Guide Version 8.1 QF0009