Sie sind auf Seite 1von 268

Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
Siebel 8.1.x e z @ nt G
Integration
s q u tude
( f cva this S
e d aVolumesIe Student Guide
s t a e to u
z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

D71810GC10
Edition 1.0
April 2011
D72827
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Disclaimer

This document contains proprietary information and is protected by copyright and other intellectual property laws. You may copy and
print this document solely for your own use in an Oracle training course. The document may not be modified or altered in any way.
Except where your use constitutes "fair use" under copyright law, you may not use, share, download, upload, copy, print, display,
perform, reproduce, publish, license, post, transmit, or distribute this document in whole or in part without the express authorization
of Oracle.
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

The information contained in this document is subject to change without notice. If you find any problems in the document, please
report them in writing to: Oracle University, 500 Oracle Parkway, Redwood Shores, California 94065 USA. This document is not
warranted to be error-free.

Restricted Rights Notice

If this documentation is delivered to the United States Government or anyone using the documentation on behalf of the United
States Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS


The U.S. Governments rights to use, modify, reproduce, release, perform, display, or disclose these training materials are restricted
by the terms of the applicable Oracle license agreement and/or the applicable U.S. Government contract.

Trademark Notice s a
h a
c l)
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective
l
nte uide
owners.

e
@ nt G
Author e z
u tude
Neil Lang s q
( f cva this S
Technical Contributors and Reviewers da e
e u s
Siebel CRM Team
a sta se to
C Oracle
This book was published using:
z c en Tutor
e l i
squ rable
e V fe
e l i p a n s
F n-t r
no
Table of Contents
Siebel 8.1.x Integration: Course Introduction .......................................................................................... 1-1
Siebel 8.1.x Integration: Course Introduction ............................................................................................ 1-2
Lesson Agenda ....................................................................................................................................... 1-3
Instructor and Class Participants ............................................................................................................. 1-4
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Training Site Information ......................................................................................................................... 1-5


Course Audience .................................................................................................................................... 1-6
Course Prerequisites............................................................................................................................... 1-7
Course Goal ........................................................................................................................................... 1-8
Course Objectives................................................................................................................................... 1-9
Course Methodology ............................................................................................................................... 1-10
Course Materials..................................................................................................................................... 1-11
Siebel Documentation ............................................................................................................................. 1-12
Feedback ............................................................................................................................................... 1-13
Course Agenda ....................................................................................................................................... 1-14
s a
h a
Introduction to Siebel Application Integration ......................................................................................... 2-1

l c l)
Introduction to Siebel Application Integration............................................................................................ 2-2
nte uide
Objectives............................................................................................................................................... 2-3
e
e z @ nt G
Patterns for Siebel Application Integration................................................................................................ 2-4

s q u tude
Peer Application Integration..................................................................................................................... 2-5

cva this S
Consumer of Services ............................................................................................................................. 2-6
( f
Alternate User Interfaces (UIs) ................................................................................................................ 2-7

e da use
Alternate User Interface: Examples.......................................................................................................... 2-8

sta se to
Siebel Application Integration Choices ..................................................................................................... 2-9
a
Data-Layer Integration............................................................................................................................. 2-10
C cen
e z
u le li
Business-Layer Integration ...................................................................................................................... 2-11

s q
Siebel Enterprise Application Integration (EAI) ......................................................................................... 2-12
V ferab
Closely Coupled Integrations ................................................................................................................... 2-13
e
l ip rans
Loosely Coupled Integrations .................................................................................................................. 2-14
e
F n-t
UI-Layer Integration ................................................................................................................................ 2-15

no
UI Integration: Example ........................................................................................................................... 2-16
Common Steps in Implementing Integration ............................................................................................. 2-17
Overview of This Course ......................................................................................................................... 2-18
Lesson Highlights.................................................................................................................................... 2-19
Overview of Integration Workflows .......................................................................................................... 3-1
Overview of Integration Workflows........................................................................................................... 3-2
Objectives............................................................................................................................................... 3-3
Data Exchange ....................................................................................................................................... 3-4
Data Exchange Scenarios ....................................................................................................................... 3-5
Siebel Send ............................................................................................................................................ 3-6
Siebel Send/Receive ............................................................................................................................... 3-7
Siebel Receive ........................................................................................................................................ 3-8
Siebel Receive/Respond ......................................................................................................................... 3-9
Integration Processing for Send............................................................................................................... 3-10
Integration Processing for Receive .......................................................................................................... 3-11
Transporting Data in Integration Workflows .............................................................................................. 3-12
Types of Transports ................................................................................................................................ 3-13
Additional Integration Processing............................................................................................................. 3-14
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


i
Prebuilt EAI Business Services................................................................................................................ 3-15
Example of a Siebel Integration Workflow ................................................................................................ 3-16
Review: XML (Extensible Markup Language) ........................................................................................... 3-17
XML Documents: Review ........................................................................................................................ 3-18
XML Schema Definition (XSD): Review.................................................................................................... 3-19
XML Namespaces: Review...................................................................................................................... 3-20
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Using XML Namespaces Review ............................................................................................................. 3-21


Lesson Highlights.................................................................................................................................... 3-22
Practice 3 Overview: Overview of Integration Workflows.......................................................................... 3-23
Integration Objects ................................................................................................................................... 4-1
Integration Objects .................................................................................................................................. 4-2
Objectives............................................................................................................................................... 4-3
Integration Objects .................................................................................................................................. 4-4
Integration Object.................................................................................................................................... 4-5
Types of Integration Objects .................................................................................................................... 4-6
Internal Integration Object ....................................................................................................................... 4-7
s a
a
External Integration Object ...................................................................................................................... 4-8
h
c l)
Integration Components (ICs) .................................................................................................................. 4-9
l
nte uide
Integration Component Key ..................................................................................................................... 4-11
e
e z @ nt G
Status Key .............................................................................................................................................. 4-12

s q u tude
Creating an Internal Integration Object..................................................................................................... 4-13
1. Identify the Siebel Data to be Exchanged ............................................................................................. 4-14

f cva this S
2. Create the Integration Object ............................................................................................................... 4-15
(
e da use
2. Specify the Business Object ................................................................................................................ 4-16
3. Select the Integration Components ...................................................................................................... 4-17

a sta se to
3. Review messages ............................................................................................................................... 4-18
z C cen
3. Select the Integration Components: Wizard Action .............................................................................. 4-19

q e
u le li
4. Inactivate Unneeded Integration Component Fields.............................................................................. 4-20
s
V ferab
5. Inactivate Unneeded Integration Component Keys ............................................................................... 4-21
e
e l ip rans
Deploying New and Modified Integration Objects...................................................................................... 4-22
F n-t
Directly Deploying an Integration Object .................................................................................................. 4-23

no
Refreshing the Run-Time Database ......................................................................................................... 4-24
Synchronizing Integration Objects ........................................................................................................... 4-25
Creating an External Integration Object.................................................................................................... 4-26
1. Obtain a Schema of the External Data ................................................................................................. 4-27
2. Create the External Integration Object ................................................................................................. 4-28
2. Create the External Integration Object: Specify the Root Level Node ................................................... 4-29
3. Select Integration Components ............................................................................................................ 4-30
4. Verify the Integration Object ................................................................................................................ 4-31
Lesson Highlights.................................................................................................................................... 4-32
Practice 4 Overview: Integration Objects................................................................................................. 4-33
EAI Siebel Adapter .................................................................................................................................... 5-1
EAI Siebel Adapter .................................................................................................................................. 5-2
Objectives............................................................................................................................................... 5-3
EAI Business Services ............................................................................................................................ 5-4
Property Sets and Business Services ...................................................................................................... 5-5
Property Set............................................................................................................................................ 5-6
Hierarchical Data Structures .................................................................................................................... 5-7
Property Set for Hierarchical Data ........................................................................................................... 5-8
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


ii
EAI Siebel Adapter .................................................................................................................................. 5-9
Using the EAI Siebel Adapter to Read Siebel Data ................................................................................... 5-10
Integration Object Instance...................................................................................................................... 5-11
Using the EAI Siebel Adapter to Write Siebel Data ................................................................................... 5-12
EAI Siebel Adapter Methods.................................................................................................................... 5-13
Query Method ......................................................................................................................................... 5-14
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

QueryPage Method ................................................................................................................................. 5-16


Synchronize Method ............................................................................................................................... 5-17
Insert Method.......................................................................................................................................... 5-19
Update Method ....................................................................................................................................... 5-20
Upsert Method ........................................................................................................................................ 5-21
Delete Method ........................................................................................................................................ 5-23
Execute Method ...................................................................................................................................... 5-24
Business Object Layer Considerations..................................................................................................... 5-25
Transaction-Based Processing ................................................................................................................ 5-26
Lesson Highlights.................................................................................................................................... 5-27
s a
Practice 5 Overview: EAI Siebel Adapter................................................................................................. 5-28
) h 6-1a
c l
Data Conversion .......................................................................................................................................

t el ide 6-2
Data Conversion .....................................................................................................................................
n
e G u 6-3
Objectives...............................................................................................................................................
@
ez den t
Processing Integration Object Instances .................................................................................................. 6-4
s q u tu
EAI XML Converter ................................................................................................................................. 6-5
v a S
a (fc e this
Siebel XML ............................................................................................................................................. 6-6

e d
EAI XML Converter Methods ...................................................................................................................
s 6-8

s t a e to u
IntObjHierToXMLDoc Method.................................................................................................................. 6-9

C a ns
XMLDocToIntObjHier Method.................................................................................................................. 6-10

e z l i c e
XML Hierarchy Converter ........................................................................................................................ 6-11

squ.......................................................................................................................
b l e
XML Converter........................................................................................................................................

ra Service ................................................................................................ 6-14


6-12

e VService fBusiness
Character Set Conversion
e
6-13

elip -tran
The Transcode s
F
Attachments............................................................................................................................................
n
6-15

no
Handling Attachments .............................................................................................................................
Embedded Attachments .......................................................................................................................... 6-17
6-16

MIME...................................................................................................................................................... 6-18
MIME: Example ...................................................................................................................................... 6-19
Writing XML Strings to Files .................................................................................................................... 6-20
EAI File Transport ................................................................................................................................... 6-21
EAI XML Write to File .............................................................................................................................. 6-22
EAI XML Read from File.......................................................................................................................... 6-23
Lesson Highlights.................................................................................................................................... 6-24
Practice 6 Overview: Data Conversion .................................................................................................... 6-25
Integration Workflows .............................................................................................................................. 7-1
Integration Workflows.............................................................................................................................. 7-2
Objectives............................................................................................................................................... 7-3
Integration Workflow ............................................................................................................................... 7-4
Integration Workflows.............................................................................................................................. 7-5
Process Properties.................................................................................................................................. 7-6
Process Property Types .......................................................................................................................... 7-7
Inputs to Business Services..................................................................................................................... 7-8
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


iii
Outputs of Business Services .................................................................................................................. 7-9
Building an Integration Workflow.............................................................................................................. 7-10
1. Define the Workflow Processing .......................................................................................................... 7-11
2. Create the Workflow Process............................................................................................................... 7-12
3. Add Steps to the Workflow Process ..................................................................................................... 7-13
4. Add Workflow Process Properties ........................................................................................................ 7-14
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

5. Configure the Inputs and Outputs ........................................................................................................ 7-15


6. Test the Workflow ............................................................................................................................... 7-16
Invoking a Workflow ................................................................................................................................ 7-18
Workflow Policy ...................................................................................................................................... 7-19
Run-Time Event ...................................................................................................................................... 7-20
Declarative Call....................................................................................................................................... 7-21
Scripting ................................................................................................................................................. 7-22
Considerations for Invoking Workflow ...................................................................................................... 7-23
Lesson Highlights.................................................................................................................................... 7-24
Practice 7 Overview: Integration Workflows............................................................................................. 7-25
s a
a
EAI HTTP Transport .................................................................................................................................. 8-1
h
c l)
EAI HTTP Transport................................................................................................................................ 8-2
l
nte uide
Objectives............................................................................................................................................... 8-3
e
e z @ nt G
Using HTTP Transport ............................................................................................................................ 8-4

s q u tude
Fundamentals of HTTP Transport: Review............................................................................................... 8-5
Communication Modes Review............................................................................................................... 8-6

f cva this S
Data Transmission: Review .................................................................................................................... 8-7
(
e da use
Siebel Architecture for HTTP Transport.................................................................................................... 8-8
Sending (Siebel Application as the Client) ................................................................................................ 8-9

a sta se to
Configuring Outbound HTTP Transport .................................................................................................... 8-10
z C cen
1. Add the HTTP Transport Step.............................................................................................................. 8-11

q e
u le li
2. Assign Inputs and Outputs................................................................................................................... 8-12
s
V ferab
3. Assign Request Methods and URLs: Sessionless................................................................................. 8-13
e
e l ip rans
3. Assign Request Methods and URLs: Session Mode ............................................................................. 8-14
F n-t
Receiving (Siebel Application as the Server) ............................................................................................ 8-15

no
Processing Incoming HTTP Requests...................................................................................................... 8-16
Profile Configurations for HTTP Services ................................................................................................. 8-17
Profile Configurations for HTTP Service: Parameters ............................................................................... 8-18
URLs for Siebel EAI Object Manager ....................................................................................................... 8-19
Configuring a New HTTP Service ............................................................................................................ 8-20
1. Identify the Workflow or Business Service ............................................................................................ 8-21
2. Create the Profile Configuration ........................................................................................................... 8-22
3. Assign the Parameters ........................................................................................................................ 8-23
4. Modify the eai.cfg File.......................................................................................................................... 8-24
Lesson Highlights.................................................................................................................................... 8-25
Practice 8 Overview: EAI HTTP Transport .............................................................................................. 8-26
EAI Message Queue Transport ................................................................................................................. 9-1
EAI Message Queue Transport ............................................................................................................... 9-2
Objectives............................................................................................................................................... 9-3
Message Queues .................................................................................................................................... 9-4
Benefits of Message Queues ................................................................................................................... 9-5
Properties of Message Queues ............................................................................................................... 9-6
How Siebel CRM Supports Message Queues .......................................................................................... 9-7
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


iv
Example: Order Management .................................................................................................................. 9-8
Siebel-Supported Messaging Systems..................................................................................................... 9-9
Siebel Messaging Transports .................................................................................................................. 9-10
Sending Messages ................................................................................................................................. 9-12
Configure Outbound Transport ................................................................................................................ 9-13
1. Create a Transport Connection Subsystem Profile ............................................................................... 9-14
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

2. Add an EAI Transport Business Service Step to an Integration Workflow .............................................. 9-15
3. Add Process Properties ....................................................................................................................... 9-16
4. Add Input and Output Arguments ......................................................................................................... 9-17
Receiving Messages: Direct Reads ......................................................................................................... 9-18
Receiving Messages: Receiver Tasks...................................................................................................... 9-19
Receiving Messages: Receiver Components and Methods....................................................................... 9-20
Receiving Messages: Transport Data Handling Subsystems .................................................................... 9-21
Available Dispatch Targets ...................................................................................................................... 9-22
Configure Inbound Transport ................................................................................................................... 9-23
1. Create Profiles .................................................................................................................................... 9-24
s a
2. Create a Workflow or Business Service to Process the Message .......................................................... 9-25
)h a
c l
3. Start a Receiver Task .......................................................................................................................... 9-26

t el ide
Summary: Siebel CRM Messaging System Support ................................................................................. 9-27
n
e
Additional Configuration: Java Support in Siebel CRM.............................................................................. 9-28
@ G u
ez den t
The JVMSubsys Profile ........................................................................................................................... 9-29

s q u tu
The jndi.properties File............................................................................................................................ 9-30
v a S
(fc e this
Lesson Highlights.................................................................................................................................... 9-31
a
Practice 9 Overview: Using JMS Message Queues ................................................................................. 9-32
ed o us
t a
Data Mapping ............................................................................................................................................
t 10-1
s
a nse
Data Mapping ......................................................................................................................................... 10-2
z C e
Objectives...............................................................................................................................................
c 10-3
e l i
Choices for Data squ.......................................................................................................................
b l e
Data Mapping .........................................................................................................................................

ra ............................................................................................................. 10-6
10-4

e V feEngine
Mapping 10-5

eMap
Transformation
an s
lip................................................................................................................................................
EAI Data
F
Data
n - t r 10-7

no
Data Map Components ...........................................................................................................................
Data Map Components: Example ............................................................................................................ 10-9
10-8

Data Map Editor ...................................................................................................................................... 10-10


Conditional Mapping ............................................................................................................................... 10-11
Creating a Data Map ............................................................................................................................... 10-12
1. Create an Integration Object Map ........................................................................................................ 10-13
2. Auto-Map the Components .................................................................................................................. 10-14
3. Create Integration Component Maps.................................................................................................... 10-15
4. Create Integration Field Maps.............................................................................................................. 10-16
5. Validate the Map ................................................................................................................................. 10-17
Purging the Cache .................................................................................................................................. 10-18
Using a Data Map ................................................................................................................................... 10-19
EAI Value Maps ...................................................................................................................................... 10-20
Using EAI Value Maps ............................................................................................................................ 10-21
Custom Mapping..................................................................................................................................... 10-22
Lesson Highlights.................................................................................................................................... 10-23
Practice 10 Overview: Data Mapping ...................................................................................................... 10-24
The EAI Dispatch Service ......................................................................................................................... 11-1
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


v
The EAI Dispatch Service........................................................................................................................ 11-2
Objectives............................................................................................................................................... 11-3
EAI Dispatch Service .............................................................................................................................. 11-4
EAI Dispatch Service Methods ................................................................................................................ 11-5
Modifying Messages ............................................................................................................................... 11-6
Rules ...................................................................................................................................................... 11-7
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Search Expression Notation for Rules...................................................................................................... 11-8


Structure of Rules ................................................................................................................................... 11-9
Rule Set ................................................................................................................................................. 11-10
Rule ....................................................................................................................................................... 11-11
Transform ............................................................................................................................................... 11-12
Benefits of the EAI Dispatch Service........................................................................................................ 11-14
Creating a Dispatch Rule Set .................................................................................................................. 11-15
1. Create the Rule Set ............................................................................................................................. 11-16
2. Create the Rule ................................................................................................................................... 11-17
3. Create the Transforms......................................................................................................................... 11-18
s a
4. Update Run-Time Memory................................................................................................................... 11-19
)h a
c l
5. Test the Rule Set ................................................................................................................................ 11-20

t el ide
Using a Dispatch Rule Set ....................................................................................................................... 11-21
n
e u
Outbound Processing: Overview of Steps ................................................................................................ 11-22
@ G
ez den t
Inbound Processing: Overview of Steps ................................................................................................... 11-24

s q u tu
Lesson Highlights.................................................................................................................................... 11-26
v a S
(fc e this
Practice 11 Overview: The EAI Dispatch Service..................................................................................... 11-27

e d a
Using Siebel Inbound Web Services ........................................................................................................
s 12-1

s t a e to u
Using Siebel Inbound Web Services ........................................................................................................ 12-2

Ca cens
Objectives............................................................................................................................................... 12-3

e z
Web Services .........................................................................................................................................
l i 12-4

squ r....................................................................................................................
Standards for Web Services
a b l e 12-5

e VExamplefe........................................................................................................................
SOAP Message ...................................................................................................................................... 12-6

l i p
SOAP Message
n s 12-7
FeServices
Web
n - ra Language (WSDL) Document.......................................................................... 12-8
tinDescription
no Siebel Applications ........................................................................................................ 12-9
Web Services
Structure of Siebel Web Services ............................................................................................................ 12-10
Service ................................................................................................................................................... 12-11
Service Ports .......................................................................................................................................... 12-12
Operations .............................................................................................................................................. 12-13
Working with Siebel Inbound Web Services ............................................................................................. 12-14
Administering Inbound Web Services....................................................................................................... 12-15
Completing the Service Address .............................................................................................................. 12-16
Generating the WSDL Document............................................................................................................. 12-18
Invoking Inbound Web Services............................................................................................................... 12-20
Prebuilt Integration Using Web Services .................................................................................................. 12-22
Lesson Highlights.................................................................................................................................... 12-23
Practice 12 Overview: Using Siebel Inbound Web Services ..................................................................... 12-24
Configuring Siebel Inbound Web Services .............................................................................................. 13-1
Configuring Siebel Inbound Web Services ............................................................................................... 13-2
Objectives............................................................................................................................................... 13-3
Inbound Web Service Architecture........................................................................................................... 13-4
Inbound Web Services: Service Ports ...................................................................................................... 13-5
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


vi
Inbound Web Services: Operations.......................................................................................................... 13-6
Execution of an Inbound Web Service ..................................................................................................... 13-7
Web Service Inbound Dispatcher............................................................................................................. 13-8
Publishing a Siebel Inbound Web Service ................................................................................................ 13-9
1. Create the Web Service Definition ....................................................................................................... 13-10
2. Create a Service Port .......................................................................................................................... 13-11
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

2. Create a Service Port: Binding ............................................................................................................. 13-12


3. Publish the Operations ........................................................................................................................ 13-13
4. Generate the WSDL File...................................................................................................................... 13-14
Transports for Web Services ................................................................................................................... 13-16
Publishing from Siebel Tools ................................................................................................................... 13-17
Default Web Service Security .................................................................................................................. 13-18
Enhancing Security ................................................................................................................................. 13-19
Sessions................................................................................................................................................. 13-20
Sessionless" Sessions ............................................................................................................................ 13-21
Stateless Sessions.................................................................................................................................. 13-22
s a
a
Stateful Sessions .................................................................................................................................... 13-23
)h
c l
Configure Siebel Inbound Web Sessions ................................................................................................. 13-24

t el ide
Web Service Security .............................................................................................................................. 13-26
n
e
Implementing WS-Security for Inbound Web Services .............................................................................. 13-27
@ G u
ez den t
Implementing HTTPS .............................................................................................................................. 13-30

s q u tu
Lesson Highlights.................................................................................................................................... 13-31
v a S
(fc e this
Practice 13 Overview: Siebel Inbound Web Services ............................................................................... 13-32

e d a
Siebel Outbound Web Services ................................................................................................................
s 14-1

s t a e to u
Siebel Outbound Web Services ............................................................................................................... 14-2

C a ns
Objectives............................................................................................................................................... 14-3

e z l i c e
Outbound Web Services.......................................................................................................................... 14-4
u le........................................................................................................ 14-5
sqSpecification
Outbound Web Service Architecture
Outbound Web Service
e

f e rab ....................................................................................................... 14-6
VService...........................................................................................................................
l i p
Proxy Business
n s 14-7
Fe Business
Proxy
n - a Arguments ......................................................................................................... 14-8
trService
no
Proxy Business Service Class ................................................................................................................. 14-9
Creating an Outbound Web Service......................................................................................................... 14-10
1. Create the Proxy Business Service ...................................................................................................... 14-11
2. Import the WSDL File .......................................................................................................................... 14-12
3. Inspect the Objects Created: Business Service .................................................................................... 14-13
3. Inspect the Objects Created: Business Service Arguments ................................................................... 14-14
3. Inspect the Objects Created: Integration Objects .................................................................................. 14-15
3. Inspect the Objects Created: Business Service User Properties ............................................................ 14-16
4. Compile the Objects Created ............................................................................................................... 14-17
5. Create the Outbound Web Service....................................................................................................... 14-18
Invoking a Proxy Business Service .......................................................................................................... 14-19
Options for Mapping to/from the Integration Objects ................................................................................. 14-20
Implementing Session-Based Security ..................................................................................................... 14-21
Lesson Highlights.................................................................................................................................... 14-22
Practice 14 Overview: Siebel Outbound Web Services ............................................................................ 14-23
Overview of Data Federation .................................................................................................................... 15-1
Overview of Data Federation ................................................................................................................... 15-2
Objectives............................................................................................................................................... 15-3
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


vii
Data Federation ...................................................................................................................................... 15-4
Advantages of Data Federation ............................................................................................................... 15-5
Data Federation ...................................................................................................................................... 15-6
Siebel External Table .............................................................................................................................. 15-7
External Business Component (EBC) ...................................................................................................... 15-8
Distributed Join ....................................................................................................................................... 15-9
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Virtual Business Component (VBC) ......................................................................................................... 15-10


Business Component Behavior................................................................................................................ 15-11
Limitations of EBCs and VBCs ................................................................................................................ 15-12
Additional Limitations .............................................................................................................................. 15-13
Lesson Highlights.................................................................................................................................... 15-14
Practice 15 Overview: Overview of Data Federation ................................................................................ 15-15
External Business Components ............................................................................................................... 16-1
External Business Components ............................................................................................................... 16-2
Objectives............................................................................................................................................... 16-3
External Business Component................................................................................................................. 16-4
s a
a
Structure of an External Business Component ......................................................................................... 16-5
h
c l)
System Fields ......................................................................................................................................... 16-6
l
nte uide
Data Source Property.............................................................................................................................. 16-7
e
e z @ nt G
DataSource ............................................................................................................................................ 16-8

s q u tude
Creating an External Business Component .............................................................................................. 16-9
1. Create an ODBC Connection............................................................................................................... 16-10

f cva this S
2. Generate a Schema File for the External Table .................................................................................... 16-11
(
e da use
3. Create the Table Object in the Siebel Repository.................................................................................. 16-12
3. Examine the Table and Columns Created ............................................................................................ 16-13

a sta se to
4. Map System Fields as Required .......................................................................................................... 16-14
z C cen
5. Specify the Data Source ...................................................................................................................... 16-15

q e
u le li
6. Create the External Business Component ............................................................................................ 16-16
s
V ferab
7. Identify the Data Source in the Application ........................................................................................... 16-17
e
e l ip rans
Using an External Business Component .................................................................................................. 16-20
F n-t
Distributed Join ....................................................................................................................................... 16-21

no
Considerations........................................................................................................................................ 16-22
Lesson Highlights.................................................................................................................................... 16-23
Practice 16 Overview: External Business Components ............................................................................ 16-24
Virtual Business Components .................................................................................................................. 17-1
Virtual Business Components.................................................................................................................. 17-2
Objectives............................................................................................................................................... 17-3
Virtual Business Component (VBC) ......................................................................................................... 17-4
Data Access and Manipulation ................................................................................................................ 17-5
Required Methods................................................................................................................................... 17-6
Optional Methods.................................................................................................................................... 17-7
Business Services................................................................................................................................... 17-8
XML Gateway Business Service .............................................................................................................. 17-9
Custom Business Service........................................................................................................................ 17-10
Custom Business Service Considerations ................................................................................................ 17-11
Creating a Virtual Business Component ................................................................................................... 17-12
1. Create a Business Component ............................................................................................................ 17-13
2. Create Fields for the VBC .................................................................................................................... 17-14
3. Create the Custom Business Service if Necessary ............................................................................... 17-15
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


viii
4. Associate the Business Service with the VBC ...................................................................................... 17-16
5. Implement the Methods (Custom Service) ............................................................................................ 17-18
5. Configure the Target (XML Gateway) ................................................................................................... 17-19
Using a Virtual Business Component ....................................................................................................... 17-20
Restrictions on Virtual Business Components .......................................................................................... 17-21
Lesson Highlights.................................................................................................................................... 17-22
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Practice 17 Overview: Virtual Business Components............................................................................... 17-23


Embedding Web Content in a Siebel View ............................................................................................... 18-1
Embedding Web Content in a Siebel View ............................................................................................... 18-2
Objectives............................................................................................................................................... 18-3
Displaying External Web Content ............................................................................................................ 18-4
Aggregate View ...................................................................................................................................... 18-5
Detail View ............................................................................................................................................. 18-6
Key Concepts ......................................................................................................................................... 18-7
Symbolic URL ......................................................................................................................................... 18-8
Business Component Field...................................................................................................................... 18-9
s a
a
Specialized Applet .................................................................................................................................. 18-10
h
c l)
Display External Web Content in a Siebel Application .............................................................................. 18-11
l
nte uide
Display External Web Content in a Siebel Application (Real-Time Quotes)................................................ 18-12
e
e z @ nt G
1. Determine the Required URL............................................................................................................... 18-13

s q u tude
2. Add a Field to the Business Component............................................................................................... 18-14
3. Create the Applet ................................................................................................................................ 18-15

f cva this S
3. Assign a Web Template ...................................................................................................................... 18-16
(
e da use
3. Map the Field ...................................................................................................................................... 18-17
3. Delete the Controls ............................................................................................................................. 18-18

a sta se to
3. Adjust the Applet Class ....................................................................................................................... 18-19
z C cen
3. Modify the Default List Column Configuration ....................................................................................... 18-20

q e
u le li
4. Create the View .................................................................................................................................. 18-21
s
V ferab
5. Add the View to the Screen ................................................................................................................. 18-22
e
e l ip rans
6. Complete the Configuration ................................................................................................................. 18-23
F n-t
7. Administer the Symbolic URL .............................................................................................................. 18-24

no
Test the Configuration ............................................................................................................................. 18-26
Considerations........................................................................................................................................ 18-29
Symbolic URLs in the Dedicated Web Client ............................................................................................ 18-30
Host Aliases............................................................................................................................................ 18-31
Lesson Highlights.................................................................................................................................... 18-32
Practice 18 Overview: Embedding Web Content in a Siebel View ............................................................ 18-33
Embedding Siebel Content in an External Application ............................................................................ 19-1
Embedding Siebel Content in an External Application .............................................................................. 19-2
Objectives............................................................................................................................................... 19-3
Options for Embedding Siebel Content in External Applications ................................................................ 19-4
Review: Rendering a Siebel Web Application ........................................................................................... 19-5
The Siebel Web Engine XML Web Interface............................................................................................. 19-6
Architecture: Application Request ............................................................................................................ 19-7
Architecture: Siebel CRM Response ........................................................................................................ 19-8
Invoking the XML Web Interface .............................................................................................................. 19-9
Customize the AOM ................................................................................................................................ 19-10
Example: Siebel Sales Wireless .............................................................................................................. 19-11
Add Commands to the URL ..................................................................................................................... 19-12
Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


ix
Example 1: Raw XML.............................................................................................................................. 19-14
Example 2: Apply a Stylesheet ................................................................................................................ 19-15
Example 3: Programmatic Access ........................................................................................................... 19-16
Example 3: Result ................................................................................................................................... 19-18
Add an XML Request to the Body of an HTTP POST Command............................................................... 19-19
XML Interface vs. Web Services .............................................................................................................. 19-20
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Lesson Highlights.................................................................................................................................... 19-21


Practice 19 Overview: Exploring the XML Interface ................................................................................. 19-22
Siebel Workflow Appendix ....................................................................................................................... 20-1
Siebel Workflow Appendix ....................................................................................................................... 20-2
Objectives............................................................................................................................................... 20-3
Workflow Process ................................................................................................................................... 20-4
Basic Workflow Process Steps ................................................................................................................ 20-5
Process Properties.................................................................................................................................. 20-6
Creating a Workflow Process................................................................................................................... 20-7
Create a Workflow Process Definition ...................................................................................................... 20-8
s a
a
Start the Designer ................................................................................................................................... 20-9
h
c l)
Create the Steps ..................................................................................................................................... 20-10
l
nte uide
Connect the Steps .................................................................................................................................. 20-11
e
e z @ nt G
Set Property Values ................................................................................................................................ 20-12

s q u tude
Multi Value Property Window (MVPW) ..................................................................................................... 20-13
Set Input and Output Arguments.............................................................................................................. 20-14

f cva this S
Testing a Workflow Process .................................................................................................................... 20-15
(
e da use
Set Property Values ................................................................................................................................ 20-16
Start the Simulator .................................................................................................................................. 20-17

a sta se to
Start the Simulation................................................................................................................................. 20-18
z C cen
Run the Simulation.................................................................................................................................. 20-19

q e
u le li
Watch Window........................................................................................................................................ 20-20
s
V ferab
Verify the Result ..................................................................................................................................... 20-21
e
e l ip rans
Deploying a Workflow Process ................................................................................................................ 20-22
F n-t
Publish the Workflow............................................................................................................................... 20-23

no
Activate the Workflow.............................................................................................................................. 20-24
Publish and Activate Workflow................................................................................................................. 20-25
Lesson Highlights.................................................................................................................................... 20-26

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Siebel 8.1.x Integration Table of Contents


x
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
Siebel 8.1.x e z @ nt G
Integration:
Course s q u tude
Introduction
( f c va his S
e d aChapterse1 t
s t a e to u
z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 1
Siebel 8.1.x Integration: Course Introduction
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Siebel 8.1.x Integration:


Course Introduction
s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 2
Lesson Agenda

Lesson Agenda
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

This lesson provides an introduction to the:


Instructor and class participants
Training site information
Course:
Audience
Prerequisites
Goal s a

h a
Objectives
l c l)
Methodology
e nte uide
Materials
e z @ nt G
Agenda
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 3
Instructor and Class Participants

Instructor and Class Participants


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Who are you?


Name
Company
Role
What is your prior experience?
Siebel applications
a
Application Integration
) has
lcl
Supporting technologies (XML, HTTP, web services)
te d e
e n
How do you expect to benefit from this course? u i
z n t G
@
q e
u tude
s
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 4
Training Site Information

Training Site Information


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Rest rooms Class duration and breaks

Telephones Meals and refreshments

s a
h a
l c l)
Fire Exits Questions? e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 5
Course Audience

Course Audience
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

This course is designed for members of Siebel


implementation teams responsible for integrating Siebel
CRM applications with other applications
Application developers
System architects and configurators
Technical Support personnel
s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 6
Course Prerequisites

Course Prerequisites
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Siebel 8.1.x Tools


Siebel 8.1.x Technical Foundations (recommended)
Familiarity with web services

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 7
Course Goal

Course Goal
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

To enable participants to integrate Siebel applications with


external applications by using:
The Siebel Enterprise Applications Integration (EAI) toolset
Web services and other service-oriented technologies

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 8
Course Objectives

Course Objectives
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

To expose Siebel functionality and data as web services


To access external functionality deployed as web services
To configure a Siebel application for a point-to-point
integration solution based on integration workflows
To configure an integration solution based on data sharing
using external business components and virtual business
components s a
h a
To embed web pages from an external web source l c
inl)a
e e
Siebel view ent Guid
u e z@ ent
a s q Stud
( f cv this
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 9
Course Methodology

Course Methodology
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Subject matter is delivered through:


Lecture and slide presentations
Software demonstrations
Class discussions
Hands-on practices

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 10
Course Materials

Course Materials
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Course content is delivered over five days


Student Guide
All slides presented during lecture
Student notes with references to the Siebel Bookshelf
documentation library
Activity Guide
s a
Hands-on practices
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 11
Siebel Documentation

Siebel Documentation
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Siebel applications are documented in Siebel Bookshelf, a


searchable collection of guidebooks
Bookshelf is also called Siebel Business Applications
Documentation Library
Updated regularly
In the classroom, Siebel Bookshelf is available on Oracle
Technology Network a
as h
www.oracle.com/technology/documentation/siebel.html
l c l)
nteof uide
Make sure you are using the appropriate version
e
Bookshelf
ue tude z@ nt G
q
Example: Siebel 8.1.1
s
cva this S

( f
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 12
Feedback

Feedback
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

If you have feedback on this or other Siebel courseware,


please email
SIEBEL_CRM_CURRICULUM_WW@oracle.com

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 13
Course Agenda

Course Agenda
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Introduction
Lesson 2: Introduction to Siebel Application Integration
Lesson 3: Overview of Integration Workflows
Lesson 4: Integration Objects
Configuring Integration Workflows
Lesson 5: EAI Siebel Adapter
s a
Lesson 6: Data Conversion h a
Lesson 7: Integration Workflows l c l)
Lesson 8: EAI HTTP Transport e nte uide
e z @ nt G
Lesson u tude
9: EAI Message Queue Transport
s q
Lesson 10: Data Mapping
( f cva this S
Lesson da Service
11: The EAI Dispatch
e to us
e
t a
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 14
Course Agenda

Course Agenda
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Siebel Web Services


Lesson 12: Using Siebel Inbound Web Services
Lesson 13: Configuring Siebel Inbound Web Services
Lesson 14: Siebel Outbound Web Services
Data Federation
Lesson 15: Overview of Data Federation
s a
Lesson 16: External Business Components h a
Lesson 17: Virtual Business Components l c l)
Embedding External Content e nte uide
e z @ nt G
Lesson 18: Embedding Web Content
s q t u de View
uin a Siebel
Lesson 19: Embedding Siebel a is inSan External
cvContent
Application a ( f th
d e
t a e to us
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 15
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Siebel 8.1.x Integration: Course Introduction


Chapter 1 - Page 16
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
Introduction z @
to Siebel
n t G
q e de
u Integration
Application
s t u
( f c va his S
e d aChapterse2 t
s t a e to u
z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 1
Introduction to Siebel Application Integration
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Introduction to Siebel Application Integration

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 2
Objectives

Objectives
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

After completing this lesson, you should be able to:


Describe several patterns of Siebel integrations
List common Siebel integration implementation solutions
Identify several common integration tasks

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 3
Patterns for Siebel Application Integration

Patterns for Siebel Application Integration


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Peer application integration


Consumer of services
Alternate user interfaces

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use More

a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 4
Peer Application Integration

Peer Application Integration


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

The Siebel application shares data and functionality with


other applications in the enterprise
The applications in such an integration:
Have the same view of the data
Can originate requests for data and functionality
Some examples:
s a
The Siebel application creates an order and sends it to the
h a
order fulfillment system l c l)
nte uidata
The Human Resources (HR) system updateseemployee de
G
in the Siebel application
q ez@ ent
u tud
s
( f cva this S
e a se
dSiebel
HR
t
a e toCRM u
a s s
Fulfillment

z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 5
Consumer of Services

Consumer of Services
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

The Siebel application uses an external application to


provide a specific service
The service provider doesn't have the same view of the data
as the Siebel application
The request typically originates in the Siebel application
Some examples:
Siebel applications use the Oracle BI Publisher server to as a
generate reports
c l )h
t el ide
Siebel applications use the Informatica IdentitynResolution
@ e data G u
server to match and cleanse account and z contact t n
s q ue tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 6
Alternate User Interfaces (UIs)

Alternate User Interfaces (UIs)


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

The Siebel application provides CRM data and


functionality through a different (non-Siebel) UI
Provides users an interface that:
Resembles that of another application they regularly use
May be more targeted to a task
May be more streamlined
Allows Siebel data and functionality to be accessed through s a
a
a wider range of devices, such as smart phones l) h
n t elc ide
@ e G u
ez den t
s q u tu
v a S
a (fc e this
a ed o us
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 7
Alternate User Interface: Examples

Alternate User Interface:


Examples
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

CRM Desktop allows users to access Siebel data and


functionality in Microsoft Outlook
Siebel gadget apps on smart phones and tablet computers

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
CRM Desktop a
a st se to Smart phone

z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 8
Siebel Application Integration Choices

Siebel Application Integration Choices


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Siebel applications can be integrated using one of multiple


integration strategies
Data-layer integration
Business-layer integration
UI-layer integration

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use More

a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 9
Data-Layer Integration

Data-Layer Integration
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Involves exchanging data between a Siebel database and


an external data source
Siebel tables are directly accessed and populated
All business layer functionality and policies are bypassed
Is implemented using Enterprise Integration Manager
(EIM)
Is a Siebel Server component that enables the batch s a
h a
exchange of data between a Siebel database and external
l c l)
data sources ntee ide
u
@ t G
Provides import, export, merge, and delete functionality

q u ez den
v a s S tu
a (fc e this
a ed o us
a st se t
z C cen
q e
u le li
s rab locate the Oracle University course on EIM.
V feplease
For more information,
e
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 10
Business-Layer Integration

Business-Layer Integration
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Involves accessing data and functionality through the


business layer of a Siebel object manager
Business layer functionality and policies are implemented
Siebel tables are not directly accessed or populated
Is implemented using Siebel Enterprise Application
Integration (EAI)
s a
h
) a
Is a collection of tools, technologies, and prebuilt integration
functionality that allow Siebel applications to: lcl

e nte uide
Access data and business logic from external applications
z @ nt G
Provide data and business logic to external applications
e
u tude

s q
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 11
Siebel Enterprise Application Integration (EAI)

Siebel Enterprise Application Integration (EAI)


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

EAI integrations can be:


Closely coupled
Loosely coupled

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use More

a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 12
Closely Coupled Integrations

Closely Coupled Integrations


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Typically require a detailed understanding of the external


applications:
Programming language and operating system
Data structures and relationships
Can be implemented using:
Virtual business components
s
Discussed in
this course
a
External business components
h a
Programmatic interfaces l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 13
Loosely Coupled Integrations

Loosely Coupled Integrations


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Are based on exposing data and functionality in the form of


services
A service is a modular unit of functionality that is easily
accessed
Independent of platform and programming language
Can be implemented using:
Siebel web services s a
Discussed in
h a
Industry standard transports this course
l c l)
nte uide
Process integration packs using Oracle's Application
e
Independent Architecture (AIA)
ue tude z@ nt G
s q
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 14
UI-Layer Integration

UI-Layer Integration
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Refers to integration choices that either:


Embed an external application or web page directly into the
Siebel application
Display a representation of a Siebel view in an external
application
Allow users to interact with the external application as if
they were running the application directly s a
h a
Can be implemented using: cl) l e
Symbolic URLs e nte uid
G
q u tud ez@(SWE
Siebel web engine programming interfaces e n t
APIs)
s
( f cva this S Discussed in
this course

e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 15
UI Integration: Example

UI Integration: Example
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Siebel report scheduling is administered using a view that


embeds a BI Publisher server web page

Siebel
view

s a
a
)BI hPublisher
c l
n t el web i d epage
@ e G u
ez den t
s q u tu
v a S
a (fc e this
a ed o us
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 16
Common Steps in Implementing Integration

Common Steps in Implementing Integration


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Siebel integration strategies often involve several common


steps
Accessing Siebel data
Converting data between a proprietary format and an
industry-standard format
For example, XML documents
Transporting data and requests between systems s a
h a

l l)
Use industry standard transport such as HTTP or commercial
c
message queuing systems
e n te uide
Transforming data between Siebel and external
z @ datan t G
structures
q e
u tude
s
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 17
Overview of This Course

Overview of This Course


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Instructs students how to integrate Siebel applications with


external applications
Covers:
Accessing Siebel data for data exchange
Converting Siebel data to an industry standard format
Transporting data
s a
Handling inbound requests
h a
Making outbound requests l c l)
Using prebuilt inbound web services e nte uide
e z @ nt G
Configuring inbound and outbound web
s q u tude
services

cvathethSiebel
Displaying external data inside
( f i s SUI

e a an external
Displaying Siebel datadin
s e UI
Embedding external o u in a Siebel application
ta webtcontent
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 18
Lesson Highlights

Lesson Highlights
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Siebel applications are integrated with other applications in


common patterns
Peer-application integration
Consumer of services
Alternate user interfaces
Siebel applications support integration at the UI, business,
a
and data layers
)h as
c l
n t el ide
@ e G u
ez den t
s q u tu
v a S
a (fc e this
a ed o us
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 19
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Introduction to Siebel Application Integration


Chapter 2 - Page 20
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
Overview of e z @ nt G
Integration
Workflows s q u tude
( f c va his S
e d aChapterse3 t
s t a e to u
z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 1
Overview of Integration Workflows
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Overview of Integration Workflows

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s Copyright 2011, Oracle and/or its affiliates. All rights reserved.

e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 2
Objectives

Objectives
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

After completing this lesson, you should be able to:


Describe the integration strategy of data exchange
List the general steps in integration workflows

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 3
Data Exchange

Data Exchange
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is an integration strategy in which applications exchange


data using explicit business processing
Siebel applications typically use integration workflows to
exchange data
Can often involve keeping identical copies of a set of data
in both applications
When data in one application changes, a synchronization s a
a
l) h
processing occurs to update data in the other application
Updates can occur in both directions
n t elc ide
@ e G u
Usually is characterized by:
ez den t
Small sets of records being updated
s q u tu
v a S
Updates occur based on user
a t his activity
(fc oresystem
a ed o us
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 4
Data Exchange Scenarios

Data Exchange Scenarios


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Can be initiated either in the Siebel application or in an


external application
Can be either one way or return with a response
From the Siebel-application perspective
Siebel send
Siebel send/receive
s a
Siebel receive h a
Siebel receive/respond l c l)
e nte uide
e z @ nt G
Siebel
s q u tude
Order

( f cva this S
e da use
sta se to
More

a
C cen
e z
u le li
s q
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 5
Siebel Send

Siebel Send
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Activity in the Siebel application initiates a data exchange


The Siebel application does not expect or wait for a response
Example:
An order is created in Siebel CRM
The order record is sent to the provisioning system

s a
h a
l c l)
e nte uide
e z @ nt G
Siebel
s q u tude
Order

Order
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 6
Siebel Send/Receive

Siebel Send/Receive
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Activity in the Siebel application initiates a data exchange


The Siebel application waits for a response
Example:
An agent in Siebel CRM determines the availability of an
item
An availability-to-promise (ATP) request is sent to the
provisioning system s a
h a
The quantity available is received by Siebel CRM cl)
n t el ide
@ e G u
Siebel ezOrderden t
s q u tu
ATP Request
v a S
a (fc e this
a ed o us
Quantity

a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 7
Siebel Receive

Siebel Receive
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Activity in an external application initiates a data exchange


The external application does not expect or wait for a
response
Example:
An expected delivery date is updated in the provisioning
system
The updated order record is sent to Siebel CRM s a
h a
l c l)
e nte uide
e z @ nt G
Siebel
s q u tude
Order

(
Updatedf va his S
cOrder
e d a se t
s t a e to u
z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 8
Siebel Receive/Respond

Siebel Receive/Respond
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Activity in an external application initiates a data exchange


The external application waits for a response
Example:
The provisioning system needs to verify a shipping address
Request for the shipping address is sent to Siebel CRM
The shipping address is sent to the provisioning system
s a
h a
l c l)
e nte uide
e z @ nt G
Siebel
Address Requests q u tude
Order

( f cva this S
e da Address
Shipping
u se
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 9
Integration Processing for Send

Integration Processing for Send


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

The minimal set of processing that must be performed in


the Siebel application consists of:
Accessing data from the Siebel application
Converting it from its Siebel internal representation to an
industry-standard format for data exchange
Typically an XML document
Sending it to an external application s a
h a
By using an industry-standard transport

l c l)
e nte uide
e z @ nt G
Siebel
s q u tude
Access Siebel
c v aData is S
Convert Send
Data
a f
( e th Data

a ed o us
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 10
Integration Processing for Receive

Integration Processing for Receive


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

The minimal set of processing that must be performed in


the Siebel application consists of:
Receiving a message from an external application using an
industry-standard transport
Converting the message to its Siebel internal representation
Using the data in the Siebel application
Store the data persistently s a

h a

l l)
Use the data in a subsequent step in the integration workflow
c
t e anide
Example: Check the customers credit limit before submitting

n
order
@ e G u
ez den Siebel t
s q u tu
Receive Convert v a is S
(fc e thData
Access Siebel
Data Data
a
ed o us
a
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 11
Transporting Data in Integration Workflows

Transporting Data in Integration Workflows


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is implemented by a set of EAI Transport business


services that send and receive string and binary data
EAI Transport business services use industry standard
transport protocols
A transport service implements some/all of these methods:
Outbound: The Siebel application sends data and continues processing
Send immediately
s a
The Siebel application sends data and waits for a responseha
Outbound:
SendReceive before proceeding
l c l)
Inbound: The Siebel application processes receivededata nte uide
Receive
e z @ nt G
Inbound:
s
The Siebel application invokesq uadditional
t u de after
processing
ReceiveDispatch receiving data
( f cva this S
The Siebel a ereturnsadditional
Inbound:
e
receiving
ddataapplication
and u sinvokes
then
processing after
data to the sending application
sta se to
ReceiveDispatchSend
a
C cen
e z
u le li
s q
Outbound:e
V ferab
e l ip The a n s
F n-t
Send: r Siebel application sends data and continues processing immediately.
o
nSendReceived: The Siebel application sends data and waits for a response before
proceeding.

Inbound:
Receive: The Siebel application processes received data.
ReceiveDispatch: The Siebel application invokes additional processing after receiving
data.
ReceiveDispatchSend: The Siebel application invokes additional processing after
receiving data and then returns data to the sending application.

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 12
Types of Transports

Types of Transports
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

File transport:
Uses files to transport data
HTTP transport:
Uses HTTP protocol to send and receive data
Requires a web server to receive data
Queue-based transport: a
Uses third-party messaging middleware such as: h a s
l c l)
nte uide
Java Message Service (JMS)

IBM WebSphere MQ
e
@ nt G
Microsoft MSMQ e z
u tude

s q
Custom:
( f cva this S
Uses the EAI DLL Transport
e da ubusiness
se service

a sta se to DLL transport


Invokes a customer-provided

z C cen
q e
u le li
s rabis a set of application programming interfaces for managing
V system
The JMS message
e f e
l ip queues
message
e a n s than a commercial product.
rather
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 13
Additional Integration Processing

Additional Integration Processing


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Additional processing may be required in some situations


To transform the data between the Siebel data model and
that of the external application
May be required if the external application or
middleware/integration server does not recognize Siebel-
structured data
To evaluate the incoming message and route it to the a
desired processing based on some data in the message has
l c l)
May be required when the Siebel application receives multiple
nte uide

documents that require different processing


e
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 14
Prebuilt EAI Business Services

Prebuilt EAI Business Services


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

EAI integration uses prebuilt business services to:


Access data in the Siebel application
EAI Siebel Adapter
Convert the format of data
EAI XML Converter
Transport data to external applications (file, web server,
queue) s a
EAI File Transport
a
)h

c l
EAI HTTP Transport
n t el ide
EAI MQSeries Server Transport @ e G u

z
estructures
e n t
Transform data between different data
s q u tu d
v a S

a fc this
EAI Data Transformation Engine
(on
Process messages based
e d ucontent se

a sta se to
EAI Dispatch Service
z C cen
q e
u le li
s b business services is found Integration Platform Technologies:
e Vpredefined
A list of all the
f e raEAI
Siebel
e l ipEnterprise
a n s
Application Integration: in Predefined Business Services.
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 15
Example of a Siebel Integration Workflow

Example of a Siebel Integration Workflow


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

An integration workflow that accesses a Siebel contact and


uses HTTP transport
Consists of three business service steps
Invokes the EAI Invokes the EAI
Siebel Adapter XML Converter
business service business service

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva tInvokes
h is Sthe EAI
d a e
e to us business service
HTTP Transport

t a
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 16
Review: XML (Extensible Markup Language)

Review:
XML (Extensible Markup Language)
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is a text-based language with user-definable tags


Is frequently used in Siebel workflow-based integrations
Is used to describe the nature and structure of information
Is well suited for describing hierarchically related data
Key parts of XML
XML documents a
XML Schema Definition (XSD) h a s
XML namespaces l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
sta se to
More

a
C cen
e z
u le li
s q b for exchanging data among applications. It is:
e Va universal
XML Provides
f e rasyntax
ip rans
lPlatform-independent
e
F Operating
n -t system-independent
o
nDatabase-independent
Vendor-neutral language

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 17
XML Documents: Review

XML Documents:
Review
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Contain one or more elements


Are delimited by start and end tags that enclose content
The name in the tag is known as an element type
Might include one or more attribute specifications
Is a name-value pair immediately following a start tag
The value is a string in quotation marks
Might include additional elements s a
h a
l c l)
childe
e of acontact
Start tag for the
root element Attribute
e n t
Phones
element
Is
u id
z@ and n G
ist a parent of

q u e d ehome and cell


s t u
( f cva this S
da use Element
Start tag
End tag for the e
root element
a sta se to End tag
z C cen
q e
u le li
s rab that contains all the other elements.
A root element
e Vis anfelement
e
e l
A childipelement a n s
is an element that is contained within another element,
F nelement r
-t is an element that contains child elements.
A parent
n o

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 18
XML Schema Definition (XSD): Review

XML Schema Definition (XSD):


Review
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Defines the element names, parent/child relationships, and


attributes in a class of XML documents
Is written in XML itself
Is used by applications to:
Understand the structure of data passed into the application
Verify that the an XML document is correctly constructed
s a
h a
l c l)
e nte uide
e z @ nt G
q e of the xsd that
u tudFragment
s
( f cva this S describes the previous
xml document

e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 19
XML Namespaces: Review

XML Namespaces:
Review
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Are collections of element types and attribute names that


are unique
Each namespace must have a unique name
Often the name is based on the organizations' URL
Are used to distinguish duplicate names with different
meanings
s a
h a
l c l)
e nte uide
Different
e z @ nt G
meanings
s q u tude
( f cva this S
One namespace:
e da use http://www.abc.com/books
Another namespace:

sta se to
http://www.abc.com/contacts
a
C cen
e z
u le li
s q
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 20
Using XML Namespaces Review

Using XML Namespaces


Review
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Specify a namespace for a document or element using an


xmlns attribute
Results in unique names by combining:
The name of the namespace
The local element type or attribute name
Allows combining fragments from multiple documents that
might contain duplicate names s a
h a
Is particularly important in web services to distinguish
l c l)
e e
names among various web services ent
@ nt G uid
e z
u tude
s q
( f cva this S
e da use Namespace for the
book element
t a t o
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 21
Lesson Highlights

Lesson Highlights
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Data exchange is an integration strategy in which


applications exchange data using explicit business
processing
Typically requires integration workflows in Siebel CRM
applications
Data exchange can be:
Send only (no response) s a
h a
Send and receive
l c l)
Data exchange can originate in either the Siebele nte uide
application or the external application ez@ ent
G
s q u tud
Integration workflows include steps v a isaccess
to S Siebel data,
f c
( e thto/from the external
convert to/from XML, andatransport
application d
e to us
t a
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 22
Practice 3 Overview: Overview of Integration Workflows

Practice 3 Overview:
Overview of Integration Workflows
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

This practice covers the following topics:


Examining internal and external data structures

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 23
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Overview of Integration Workflows


Chapter 3 - Page 24
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
@ nt G
IntegrationezObjects
s q u tude
( f cva this S
Chapter 4

e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 1
Integration Objects
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Integration Objects

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s Copyright 2011, Oracle and/or its affiliates. All rights reserved.

e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 2
Objectives

Objectives
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

After completing this lesson, you should be able to:


Explain the role of internal and external integration objects
Create an internal integration object
Create an external integration object based on an XML
schema definition (XSD)

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 3
Integration Objects

Integration Objects
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Define the structure of data being exchanged between a


Siebel application and an external application
Are used as templates to create memory-resident
instances of data for processing by business services

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s ab Technologies: Siebel Enterprise Application Integration:
V ferPlatform
Reference: Integration
e
e l ip Objects
Integration
a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 4
Integration Object

Integration Object
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is designed to represent Integration Object


hierarchical data structures Integration
Contact
Component
Consists of multiple
Contact
integration components
Each integration First Name

component consists of Last Name


a
multiple integration
component fields Job Title ) h
as
l c l
n t e
Contact_Business Addressu i d e
@ e G
e z n t
Integration sq
u tude Street Address

( f cva this S
Component
Field
State

e da use Postal Code


a
st se t o
a
C cen
e z
u le li
s q
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 5
Types of Integration Objects

Types of Integration Objects


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Internal integration object


Describes the structure of the data extracted from or inserted
into the Siebel application
External integration object
Describes the structure of the data that is exchanged
between the Siebel application and the external application
s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use More

a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 6
Internal Integration Object

Internal Integration Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Represents a subset of a Siebel business object


Integration components represent business components
Integration component fields represent business component
fields
Integration Object
Integration Business
Contact Object Object

s a
Contact h a
l c l)
First Name Integration
Component e
nteComponent
Business
u ide
Last Name
e z @ nt G
s q u tude
Job Title
( f cva tIntegration
h i sS
Contact_Business Address
e d a se Component Field

s t a e to u Field

z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 7
External Integration Object

External Integration Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Specifies the structure of the data that is actually


transported between the Siebel application and the
external application
Is required only when the external application is not able to
handle data in Siebel format ("Siebel data")
Additional processing is required within the Siebel
application to convert the integration object instance
s a
h a
l c l)
Is often described by an XSD or Document Type Definition
(DTD) file
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 8
Integration Components (ICs)

Integration Components (ICs)


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

An integration object includes the following:


One parent integration component corresponding to the
primary business component in the business object
Zero or more child integration components corresponding to
other business components in the business object

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 9
Integration Components (ICs)

Integration Components (ICs)


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

In addition, each MVG in the primary and child business


components is represented by a child integration
component

s a
h a
l c l) IO
MVFs expand to ICs in the

e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 10
Integration Component Key

Integration Component Key


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is a field or set of fields that uniquely identify a record


being exchanged
Is based on user keys for the tables referenced by the
business components

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 11
Status Key

Status Key
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is a special type of integration component key used to


return the result of an operation, such as insert or update
Type is Status Key
Can be used to indicate:
Success or failure of an operation
Actual operation performed (for example during an upsert)
ROW_ID for a newly created record s a
Integration component key fields specify the data to bel) h a
returned when status is requested
n t elc ide
@ e G u
ez den t
s q u tu
v a S
a (fc e this
a ed o us
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 12
Creating an Internal Integration Object

Creating an Internal Integration Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

1. Identify the Siebel data to be exchanged


2. Create the integration object
3. Select the integration components
4. Inactivate unneeded integration component fields
5. Inactivate unneeded integration component keys
s a
Example: Create an internal integration object for accessing h a
l c l)
Siebel contact data
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use More

a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 13
1. Identify the Siebel Data to be Exchanged

1. Identify the Siebel Data to be Exchanged


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Identify the data in the Siebel UI to integrate


Determine the underlying Siebel business objects, business
components, and fields

In the client, use About View

s a
)h a
c l
n t el ide
In Tools, use
@ e G uDetermine
Edit Web ez den t
Layout
s q u t u
the field

( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 14
2. Create the Integration Object

2. Create the Integration Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Use the Integration Object Builder to create an integration


object based on a Siebel business object
Select the EAI Siebel Wizard business service

Select File >


New Object >
EAI and click
Integration
Object s a
h a
l c l)
e nte uide
z @ Constructs
n t Gan
q e e object from
u tuintegration
da business
v s
a is S object
f c
( e th
d a
t a e to us
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 15
2. Specify the Business Object

2. Specify the Business Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Select the business object


Provide a name for the integration object

Identifies the parent


business component in
s the business object a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 16
3. Select the Integration Components

3. Select the Integration Components


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Select components to include in the integration object


All components are selected by default

s a
a
)h
c l
n t el ide
@ e G u
ez den t
s q u tu
v a S
a (fc e this
a ed o us
a st se t
z C cen
q e
u le li
Many SiebelV
s rab have a very large number of child business components. Most
eobjects
business
external
l e
ipthese f
s do not have as many child components so in many cases you need to
data structures
n
e
F n-t
remove r a
extra child components from the integration object.
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 17
3. Review messages

3. Review messages
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Review messages about fields made inactive


Click Finish to configure the integration object

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 18
3. Select the Integration Components: Wizard Action

3. Select the Integration Components:


Wizard Action
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Integration Object Wizard:


Finds all links, business components, and underlying tables
Identifies all business component fields that map to user
keys in tables
Creates integration component user keys based on those
fields
Notes any key columns that are not exposed in a business s a
component l ) ha
c but
elfields, e
n t
Creates calculated fields as integration component i d
marks them inactive
ez den @e t Gu

s u
Such fields cannot be updated
q tu
v a S
a (fc e this
a ed o us
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 19
4. Inactivate Unneeded Integration Component Fields

4. Inactivate Unneeded Integration Component


Fields
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Set unneeded fields to inactive in each integration


component to improve performance
Do not delete unneeded fields; deleted fields become
active when the business object is upgraded

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use Field will not be included in
a sta se to the integration object

z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 20
5. Inactivate Unneeded Integration Component Keys

5. Inactivate Unneeded Integration Component


Keys
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Make sure that the fields in the integration component keys


are consistent with the component fields
Inactivate unneeded key fields in each integration
component
Inactivate any key that has no active fields

s a
h a
l c l)
e nte uide
Inactivate entire key
e z @ nt G
s q u tude
( f cva this S
e da use
a sta sselect
Inactivate
e o in key
tfields
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 21
Deploying New and Modified Integration Objects

Deploying New and Modified Integration Objects


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

During development deploy the integration object directly


to the run-time database
Overrides object definition in the .srf file
For production compile the integration object into the
application's .srf file

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 22
Directly Deploying an Integration Object

Directly Deploying an Integration Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

In Siebel Tools, select the integration object


Right-click and select Deploy to Runtime Database

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 23
Refreshing the Run-Time Database

Refreshing the Run-Time Database


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

In the Siebel client:


Navigate to Administration - Web Services > Deployed
Integration Objects
Verify that the integration object was deployed
Navigate to Administration - Web Services > Inbound Web
Services
Click Clear Cache to update the runtime database
s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 24
Synchronizing Integration Objects

Synchronizing Integration Objects


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

When business objects are modified or updated, it is


necessary to make sure the integration object is still
consistent
If business object changes are minor, click Synchronize to
update the integration object
Example: adding a new single value field
If business object changes are extensive, delete and s a
recreate the integration object h a
l c l)
Example: creating a new MVG

e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 25
Creating an External Integration Object

Creating an External Integration Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

1. Obtain a schema of the external data


2. Create the external integration object
3. Select integration components
4. Verify the integration object

Example: Create an external integration object that describes a


contact data in an external application h a s
l)
n t elc ide
@ e G u
ez den t
s q u tu
v a S
a (fc e this
ed o us
More

a
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 26
1. Obtain a Schema of the External Data

1. Obtain a Schema of the External Data


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Use the schema if published by the external application


Alternatively, create a file containing sample XML received
by or sent to the external application
Use an XML utility to generate the schema as an XSD

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 27
2. Create the External Integration Object

2. Create the External Integration Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Use the Integration Object Builder to create an integration


object
Select the EAI XSD Wizard or EAI DTD Wizard service

s a
a
)h
c l
n t el ide
@ e G u
ez den t
s q u tu
v a S
is to create
c thintegration
( f Select an

e da use leaf elements as fields


object with

a sta se to
z C cen
q e
u le li
s rab is not checked then all leaf elements are converted to integration
V feObject
If Simplify Integration
e
e l ip rans
components.
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 28
2. Create the External Integration Object: Specify the Root Level
Node

2. Create the External Integration Object:


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Specify the Root Level Node


Specify the source object to serve as the root-level node

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 29
3. Select Integration Components

3. Select Integration Components


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Select the integration components

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 30
4. Verify the Integration Object

4. Verify the Integration Object


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Examine the configured integration object


Verify that it contains the desired components and fields
Inactivate unneeded integration component fields

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 31
Lesson Highlights

Lesson Highlights
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Integration objects define the structure of data being


exchanged between a Siebel and an external application
Integration objects are used as templates to create memory-
resident instances of data for processing by business
services
Internal integration objects are a subset of Siebel business
objects s a
h a
Use the EAI Siebel Wizard to configure an internal cl)
l de
integration object nte i
e Gu
@ keys
Requires inactivating multiple fields andzuser nt
q e de
uexternal
Use the EAI XSD Wizard to build
v a s
an S tu integration
object based on the schema
a e t his with the external
(fcassociated
data
a ed o us
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 32
Practice 4 Overview: Integration Objects

Practice 4 Overview:
Integration Objects
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

This practice covers the following topics:


Creating an internal integration object
Creating an external integration object based on an
external XSD file

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 33
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Integration Objects
Chapter 4 - Page 34
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
@ nt G
EAI SiebeleAdapter
z
s q u tude
( f cva this S
Chapter 5

e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 1
EAI Siebel Adapter
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

EAI Siebel Adapter

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s Copyright 2011, Oracle and/or its affiliates. All rights reserved.

e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 2
Objectives

Objectives
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

After completing this lesson, you should be able to:


Describe the purpose of the EAI Siebel Adapter business
service
Explain the use of each method
Examine the output of the EAI Siebel Adapter business
service using the business service simulator
s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 3
EAI Business Services

EAI Business Services


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Recall: EAI integration workflows typically consist of a


sequence of EAI business services
Configuring these workflows requires manipulating their
inputs and outputs especially:
Integration objects
XML strings
s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 4
Property Sets and Business Services

Property Sets and Business Services


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

A property set is the in-memory data structure used to:


Pass a set of input arguments into a business service
method
Receive a set of output arguments from a method
Business
service
StringManipulation
s aSieb
Siebel 4 a
)h
Length
l c l
eString ide
OutputString
InputString Length
e n t u
Number
Truncate e z @ nt G
s q u tude
Input
property ( f cva this S Output
property set
set a se
dConcatenate
Method e
s t a e to u
z Ca cens
s q ue le li
The example the
Vshows b
raStringManipulation business service with three methods (Length,
eand s f e
ip ran and Length=4 that are being passed
Truncate, Concatenate). The input property set contains values for two arguments.
e l
F n-t
InputString=Siebel into the Truncate method. The output
no set contains one output argument, OutputString=Sieb.
property

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 5
Property Set

Property Set
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Represents data using name/value pairs


Has two predefined properties: Type and Value
Has an array for storing user-provided name/value pairs

Values for predefined Array of user-provided


properties name/value pairs
Predefined
s a
property Type h aInputString Siebel
names
Value Length l c l) 4
e nte uide
e z @ nt G
s q u tude
( f c va his S
Input property
e d a se t
a e to u
set

s t
z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 6
Hierarchical Data Structures

Hierarchical Data Structures


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Some business services have inputs and outputs that are


complex data structures
For instance, business services that process XML data
Argument type is hierarchy

EAI XML Read from File s a


a
)h Output arguments
c l
n t el ide
Filename
@ e
XMLHierarchy
G u
String
ReadXMLMsg ez denHierarchyt
s q u tuArgument type for
v a S
a (fc e this complex data structure
a ed o us
a st se t
z C cen
q e
u le li
s
the raEAIb XML Read from File business service and the ReadXMLMsg
The example
e Vshows f e
method.
e l ip AisFilename
a n s string argument is passed in and an XMLHierarchy argument of type
F n-t
Hierarchy r
passed out.
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 7
Property Set for Hierarchical Data

Property Set for Hierarchical Data


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Includes multiple child property sets to represent


hierarchical data in addition to an array of data
For instance data described in an XML file
Child property sets can contain property sets themselves

Parent
property set Type s Name Oracle
a
h a
Value l c l) Site HQ
Child
property set e nte uide
City

e z @ nt G
San Mateo

Grandchild s q u tude
State CA

property set
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 8
EAI Siebel Adapter

EAI Siebel Adapter


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is an EAI business service that accesses data in a Siebel


application
Reads data to send to an external application
Writes data received from an external application
Accesses data through the business object layer
Includes methods to:
s a
Query for records h a
Insert a new record l c l)
Update an existing record e nte uide
e z @ nt G
Delete records
s q u tude
Synchronize records
( f cva this S
Execute a sequence ofdaoperations
e to us
e on a set of records
t a
C as nse
u e z lice
sq rPlatform
a b le
e V fe
Reference: Integration Technologies: Siebel Enterprise Application Integration: EAI
ip
Siebel Adapter s
Business Service.
Fel n-tran
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 9
Using the EAI Siebel Adapter to Read Siebel Data

Using the EAI Siebel Adapter to Read Siebel Data


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

EAI Siebel Adapter:


Uses an integration object as a template
Integration object is specified as an input argument
Produces a memory-resident object instance that contains
Siebel application data structured by the integration object
Values are assigned to integration component fields
s a
Contact Contact a
)h
Contact el c l
ide
Contact
e n t u
First Name
z @ t
First Name:
n G
Victor

q e de Edmondson
u LasttuName:
Last Name s
va his S
( f c t
Contact_Business Address
e d a se Contact_Business Address

Integration Object s t a e to u Integration Object Instance


z Ca cens
s q ue le li
The graphicV shows the
f ab
erIntegration Object which describes the structure for the data. The
i p e s
Fel fornthe n
Integration Object Instance contains values for the data in the structure. For example, the First
Name - t r a
contact = Victor, the Last Name = Edmondson and so on.
n o

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 10
Integration Object Instance

Integration Object Instance


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Consists of a top-level property set with:


Type set to SiebelMessage
Name/value properties that identify the type of data and the
integration object that structures the data
Includes child property sets containing the Siebel data
Are referred to as "Siebel messages" a
h a s
Type SiebelMessage IntObjFormat Siebel Hierarchical Format
l
of
c l)
message

Value IntObjName Sample Contact


e
e
ntIntegrationu ide
object
MessageID 1- ABC @
z n t Ggenerated
One or more child property sets
that contain Siebel records
q e
u Object
Identifier
deto track messages
Message Type Integration
s t u
( f cva this S What the message

e a
d us e contains

Integration s

ta Instanceto
a
C cens
Object
e
z
ue le li
s q
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 11
Using the EAI Siebel Adapter to Write Siebel Data

Using the EAI Siebel Adapter to Write Siebel Data


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

EAI Siebel Adapter:


Receives a memory-resident object instance that contains
Siebel application data structured by an integration object
The integration object is specified as part of the instance
Writes the values assigned to the integration component
fields into the corresponding business component fields
Requires that the object instance be a properly formatted s a
SiebelMessage
c) ha
l
Type SiebelMessage IntObjFormat
n t e l
Siebel Hierarchical i d e
@ e G u
Value IntObjName
ez d1- eABCn t
Sample Contact
MessageID
s q u tu
v a
c this S
( f
Message Type Integration Object

e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 12
EAI Siebel Adapter Methods

EAI Siebel Adapter Methods


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Query Method
QueryPage Method
Synchronize Method
Insert Method
Update Method
Upsert Method
s a
h a
Delete Method
l c l)
Execute Method
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use More

a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 13
Query Method

Query Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Reads business object instances from the Siebel


application
Returns all records that satisfy the query conditions
Receives the following as input arguments:
Integration object used to structure the Siebel data
Details of query to be executed
s a
Delivers as output arguments: h a
Number of records returned l c l)
nte property
SiebelMessage containing the Siebel data asechild u ide
sets e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 14
Query Method

Query Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Performs a query based on one of:


Primary Row ID of the primary business component record
Values of a user key
A search specification
Query by example
The input SiebelMessage contains one or more elements with
assigned values s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 15
QueryPage Method

QueryPage Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Returns up to a specified number of records


Similar to populating an applet in the client application
Receives the following as input arguments:
Integration object used to structure the Siebel data
Details of query to be executed
Page size (number of records to be returned)
a
Sequence number of the first record to be returned in sethas
)
Sort specification if required lcl e
Delivers as output arguments: e nte uid
e z @ nt G
Number of records returned
s q u tude
SiebelMessage containing the a asischild
cvdata S property sets
( f
athis is sthe h
t set of records in query
Flag indicating whether
e d e last
s t a e to u
z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 16
Synchronize Method

Synchronize Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Updates the parent record, as required, if it exists


Otherwise inserts a new parent
Operates on child records as follows:
If a child component is present in the SiebelMessage,
updates the corresponding child business component
records to match
Deletes records with no corresponding integration component
s a

instances h a
l c l)

instances e nte uide


Updates records with corresponding integration component

e z @ nt G

s q u tude
Creates new records for other integration component instances
If a child component is missing
c v a the
from
i s SSiebelMessage,
f
( business
leaves all correspondingachild th component records
d e
untouched
t a e to us
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 17
Synchronize Method

Synchronize Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Results in making the set of child records the same when


the integration component exists in the SiebelMessage
Receives the following as input arguments:
SiebelMessage containing the data as child property sets
Flag indicating whether to return the integration component
status keys
Delivers as output arguments: s a
h a
Status keys to report operation performed (optional)
l c l)
Is used to make sure the Siebel record matches e ntethe uide
z @ records
n t G
incoming data without losing additional
q echild
u tude in the
Siebel record s
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 18
Insert Method

Insert Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Functions similarly to a Synchronize operation when the


root record does not exist in the Siebel application
Creates the new root record
Synchronizes all the child records
Receives the following as input arguments:
SiebelMessage containing the data as child property sets
Flag indicating whether to return the integration componentas
a
h
status keys cl) t el ide
Delivers as output arguments: e n u
@ t G
Status keys to report success/failureuwhen
q ez StatusObject
d e n
input argument is set TRUE as
v S tu
Is used when the externala application(fc e thisknows that no record
yet exists a ed o us
a st se t
z C cen
q e
u le li
s b if the record already exists in the Siebel application.
e V errors
The Insert method
f e raout
Ane l ip would
insert nbesused , for example, when an external application creates a new order.
F n-t r a
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 19
Update Method

Update Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Functions similarly to a Synchronize operation when the


root record exists in the Siebel application
Updates the existing root record
Synchronizes all the child records
Receives the following as input arguments:
SiebelMessage containing the data as child property sets
a
Flag indicating to return the integration component statushas
)
keys lcl te de
Uses the user keys in the incoming messageen u
to locate ithe
z@ ent G
records to be updated u e
q Stud
Delivers as output arguments: a s
cv (f s hi
da e t (optional)
Status keys to report success/failure
us knows the record exists
Is used when external t a eapplication
t o
C as nse
u e z lice
sq rable
The UpdateV e out if the record does not already exists in the Siebel application.
method errors
i p e
l would s f
Ane
F update - t r anbe used , for example, when an external application wishes to update an
non
existing order.

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 20
Upsert Method

Upsert Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

If the parent record exists in the Siebel application, it:


Updates the parent record
Updates all child records that already exist in application
Inserts new child records if none already exist
Does not delete child records in the application
Receives the following as input arguments:
SiebelMessage containing the data as child property sets s a
Flag indicating to return the integration component status
l ) ha
keys elc e nt id
Uses the user key in the incoming message
@ G u if
eto determine
t
records already exist
s q Stuuez den
a
cv this
( f
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 21
Upsert Method

Upsert Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Delivers the following as output arguments:


Status keys to report operation performed (optional)
Is used when the external application is uncertain whether
a record already exists
Example: External application upserts activity for a service
record
Updates only the activities added or modified

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 22
Delete Method

Delete Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Deletes one or more business object instances from the


Siebel application
Receives the following as input arguments:
SiebelMessage containing the Siebel data as child property
sets
Flag indicating to return the integration component status
keys s a
Determines records to delete based on: l ) ha
Search specification n t elc ide
@ e G u
User keys in the incoming SiebelMessage ez den t
s
Primary Row ID of the primary businessq u tu
component record
c v a i s S
Delivers as output arguments:
a f
( e th
d us
esuccess/failure
Status keys to report (optional)
s t a t o
z Ca cense
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 23
Execute Method

Execute Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Performs a combination of operations on components in a


SiebelMessage
Is specified by adding an operation attribute to the
integration component in the XML representation of the
SiebelMessage
Is used when the external application chooses to send a
a
series of data access operations as )h
c l
t el ide
<SiebelMessage MessageId="" MessageType="Integration Object"
XML representation
n
IntObjectName="Sample Account">
@ e
of SiebelMessage
G u
<ListofSampleAccount>
ez den t
<Account operation="upsert">
s q u tu a child Contact
v a
<Name>A. K. Parker Distribution</Name> . . . .
S Deletes
c this updating
<ListOfContact>
( f
a se
<Contact operation="delete">
record without otherwise
the parent
e d
to u
<FirstName>Stan</FirstName>. . . . Account record
t a
C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 24
Business Object Layer Considerations

Business Object Layer Considerations


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

EAI Siebel Adapter accesses data through the business


object layer and behaves as a surrogate user
Executes any additional processing in the business
component class
Executes any scripts associated with the business objects
and components
Is subject to business component and field properties such s a
as No Insert, No Update, Read Only l ) ha
c
Can be subject to access control restrictions tel de e n u i
ViewMode user property of integration object can be set to
z@ ent G
u e
specify different view visibility (personal, manager, and so forth)
q Stud
a s
ViewMode input argument in the QueryPage method can be set
v his

(
Is overridden by integrationf cuser t
property

e d a s e
Requires a position

t a to u
that can determine visibility of records

C as nse
u e z lice
sq rable
e V fe
e l i p a n s
F n-t r
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 25
Transaction-Based Processing

Transaction-Based Processing
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

EAI Siebel Adapter considers the SiebelMessage to be a


single transaction
Operations on all integration objects and components in the
SiebelMessage must complete without error
Complete rollback occurs if there is any error
Does not rollback any additional processing triggered by the
data access operations a
h a s
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 26
Lesson Highlights

Lesson Highlights
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

The EAI Siebel Adapter is an EAI business service that


accesses data in a Siebel application
Uses an integration object as a template
Produces or receives an integration object instance with
Siebel data
Multiple methods are supported
Query and Querypage s a
h a
Synchronize, Insert, Update, and Upsert
l c l)
Delete and Execute e nte uide
z @as a single
n t G
EAI Siebel Adapter operations are treatede
u tude
transaction s q
( f c va his S
EAI Siebel Adapter operations
d a sexecute
e t through the
e
a e to u
business object layer
s t
z Ca cens
s q ue le li
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 27
Practice 5 Overview: EAI Siebel Adapter

Practice 5 Overview:
EAI Siebel Adapter
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

This practice covers the following topics:


Examining the behavior of the EAI Siebel Adapter using
the business service simulator

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

EAI Siebel Adapter


Chapter 5 - Page 28
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

s a
h a
l c l)
e nte uide
Data Conversione z @ nt G
s q u tude
( f cva this S
Chapter 6

e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 1
Data Conversion
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Data Conversion

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s Copyright 2011, Oracle and/or its affiliates. All rights reserved.

e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 2
Objectives

Objectives
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

After completing this lesson, you should be able to:


Describe the purpose of the EAI XML Data Conversion
business services
Write an XML string to a file and read an XML string from a
file
Describe ways to handle an attachment
s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 3
Processing Integration Object Instances

Processing Integration Object Instances


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Integration objects produced by the EAI Siebel Adapter


need to be converted to an industry standard data format
for exchange
Siebel EAI uses XML
Siebel EAI includes several business services to convert
property sets (in general) and Siebel messages (in
particular) to and from XML strings a
as
)h
EAI XML Converter c l
XML Hierarchy Converter n t el ide
@ e G u
XML Converter ez den t
s q u tu
v a S
a (fc e this
ed o us
More

a
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 4
EAI XML Converter

EAI XML Converter


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is an EAI business service that converts:


A SiebelMessage to an XML string
An XML string to a SiebelMessage
Uses an integration object definition to:
Create XML from the SiebelMessage
Create the SiebelMessage from XML
s a
a
)h
c l
EAI XML t el ide
Siebel
n
SiebelMessage
Converter @ e XML
G u
ez den t
s q u tu
v a S
a (fc e this
a ed o us
a st se t
z C cen
q e
u le li
s rab Siebel Enterprise Application Integration: Siebel XML Converters
e V Reference:
Reference: XML
f e
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 5
Siebel XML

Siebel XML
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is XML that corresponds to the SiebelMessage


Elements represent the integration object, components, and
component fields
Root element is SiebelMessage

Root

s a
Integration
h a
object
l c l)
e nte uide
Integration
e z @ nt G
component
s q u tude
Integration ( f cva this S
component
e da use
sta se to
field
a
C cen
e z
u le li
s q b
The integration
e Vobjectfeisrarepresented by "ListOf". The integration components and
i p s
Fel n-tran
integration component fields are represented by name tags.

no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 6
Siebel XML

Siebel XML
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

XML tags used to render a SiebelMessage are defined as


part of the integration object
Names satisfy XML rules regarding spaces and special
characters

s a
h a
l c l)
e nte uide
e z @ nt G
Integration objects have s q u tude
XML tag names
beginning with ListOf ( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 7
EAI XML Converter Methods

EAI XML Converter Methods


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

IntObjHierToXMLDoc Method
XMLDocToIntObjHier Method

s a
h a
l c l)
e nte uide
e z @ nt G
s q u tude
( f cva this S
e da use More

a sta se to
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 8
IntObjHierToXMLDoc Method

IntObjHierToXMLDoc Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Converts a property set hierarchy to an XML string


SiebelMessage is a property set hierarchy representation of
integration object instances

Input Arguments Output Arguments


SiebelMessage Outputstring containing the resulting
s a
Various formatting flags, including: XML document
h a
UseSiebelMessageEnvelope
l c l)
Tags on separate lines
e nte uide
XMLHeaderText
e z @ nt G
s q u tude
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
V ferab
Input Arguments:
e
ip rans
lSiebelMessage
e
F Various
n -t formatting flags such as UseSiebelMessageEnvelope.
n o
Output Arguments:
Output string containing the resulting XML document.

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 9
XMLDocToIntObjHier Method

XMLDocToIntObjHier Method
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Converts an XML string to a property set hierarchy

Input Arguments Output Arguments


Input string containing the source XML SiebelMessage containing the integration
string object instances
Various formatting flags including:
GenerateProcessingInstructions s a
h a
Tags on separate lines
l c l)
nte uide
IntObjName: integration object to
use in the conversion if the SiebelMessage
envelope is absent e
@ nt G
e z
u tude
s q
( f cva this S
e da use
a sta se to
z C cen
q e
u le li
s
V ferab
Input Arguments:
e
ip string
elInput a n s
containing the source XML string
F Various
n r
-t formatting flags such as IntObjName.
n o
Output Arguments:
SiebelMessage containing the integration object instances.

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 10
XML Hierarchy Converter

XML Hierarchy Converter


Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is an EAI business service that converts:


An XML hierarchy to an XML document
An XML document to an XML hierarchy
XML hierarchy is a property set with Type = XMLHierarchy
Does not use integration object definitions
Converts data using simple rules, such as:
Make each XML element a property set with Type as thehtag a sa
l )
name
n t elc ide
e
Make each XML attribute a property in the elements
@ G u
t
property set uez tu
s fromSexternal
en q d
Is used to process XML documents
c v a i s sources
( f h
that do not conform to Siebel
ed o us et
a integration objects
a
a st se t
z C cen
q e
u le li
s
e V ferab
e l ip rans
F n-t
no

Copyright 2011, Oracle and/or it affiliates. All rights reserved.

Data Conversion
Chapter 6 - Page 11
XML Converter

XML Converter
Unauthorized reproduction or distribution prohibited Copyright 2016, Oracle and/or its affiliates

Is a business service that converts between a property set


hierarchy and an XML document
Does not use integration object definitions
Converts data using the same rules as XML Hierarchy
Converter except Type of property set:
Is not set to XMLHierarchy
s a
Is set to the root element of the XML document h a
Is used to: l c l)
Import and export hierarchical data e nte uide
e z @ nt G
Pass property set arguments to and u
s q t u de services
from business

( f cva this S
e da use
a sta se to