Professional Documents
Culture Documents
D64974GC20
Edition 2.0
September 2012
D78957
Richard Green
Disclaimer
Editor s
Rashmi Rajagopal
Vijayalakshmi Narasimhan
Aju Kumar Kumar
Gr aphic Designer s
Satish Bettegowda
Seema Bopaiah
Publisher s
Giri Venugopal
Sumesh Koshy
Srividya Rameshkumar
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Author
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Table of Contents
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 12
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practices Overview
In Practice 12-1, you use a temporary ODI interface for data transformation. In Practice 12-2,
you duplicate an existing knowledge module and modify the duplicate knowledge module to use
with an interface.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background:
In this practice, you perform the following steps:
1. Create a temporary interface, INT_12-1.
2.
Aggregate some of its columns by using the MIN, MAX, and AVG functions.
Create interface INT_12-1-2
3.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
1.
b.
In the Projects tab, expand: HandsOnLoads > HandsOn. Right-click Interfaces, and
then select New Interface. Name the new interface INT_12-1. In the Optimization
Context field, select Development. For Staging Area, select Hypersonic SQL:
HSQL_DEMO_SRC. Click the Mapping tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Your Tasks:
Open the Models tab. Expand the HSQL_SRC model, and drag SRC_ORDERS and
SRC_ORDER_LINES datastores from the model to the Source area.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
Select the CUST_ID column in the Source table and the CUSTID column in the Lookup
table, as shown in the screen, and then click Join. Click Finish.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
Now, you need to create a temporary target datastore. Drag the column CUST_ID from
the SRC_ORDERS table to the Target area. Click <Temporary Target DataStore>. In
the Temporary Target Properties, enter Name: TEMP_AGG_ORDERS, as shown in
the following screen:
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
Drag the column ORDER_ID from SRC_ORDERS to the Target area. Then click this
SRC_ORDERS column in the target data store. In the Mapping Properties panel at the
bottom of the window, edit the Implementation tab to read:
MIN(SRC_ORDERS.ORDER_ID). Scroll down to the Target Column Properties section
and rename this column to FIRST_ORDER_ID. Scroll back up the Property Inspector
and examine your results thus far.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
h.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Again, drag the column Order_ID from SRC_ORDERS to the Target area. In the
Mapping Properties panel at the bottom of the window, edit the Implementation tab to
read: MAX(SRC_ORDERS.ORDER_ID). Scroll down and rename this column
LAST_ORDER_ID.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
i.
Drag the column ORDER_DATE from SRC_ORDERS to the Target area. In the
Mapping Properties panel at the bottom of the window, edit the Implementation tab to
read: MIN(SRC_ORDERS.ORDER_DATE). Scroll down and rename this column
FIRST_ORDER_DATE.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
j.
Similarly, drag the column ORDER_DATE again from SRC_ORDERS to the Target
area. Edit the mapping properties to read MAX(SRC_ORDERS. ORDER_DATE). Scroll
down and rename this column LAST_ORDER_DATE.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
k.
In the Source area, expand the lookup datastore by clicking the plus sign in the upper
left corner of the lookup datastore, and then stretching the datastore longer until you
see all of its columns. Drag the FIRST_NAME column from the lookup table to the
Target area. In the Target area, click the FIRST_NAME column. Start the Expression
editor
, and then drag the LAST_NAME column from the left panel of the
Expression Editor to the expression area.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
l.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Scroll down, and in the Target Column Properties, rename this column CUST_NAME.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
n.
Drag the column QTY from the SRC_ORDER_LINES source datastore to the Target
area. Edit the mapping expression to read SUM(SRC_ORDER_LINES.QTY).
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
o.
Drag the column AMOUNT from the SRC_ORDER_LINES source datastore to the
Target area. Edit the mapping expression to read AVG(SRC_ORDER_LINES.AMOUNT).
In the Target Column Properties, rename this column AVG_AMOUNT.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
p.
Drag the column AMOUNT again from the SRC_ORDER_LINES source datastore to
the Target area. Edit the mapping expression to read
SUM(SRC_ORDER_LINES.AMOUNT). Rename this column SUM_AMOUNT.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
q.
s.
In the Target datastore, click the SUM_AMOUNT column. In the Execute on section,
select Staging Area. Repeat this step for the six other target columns in which you
defined a function in the mapping expression. Refer to the following table to verify the
execution location. Your Target datastore should now look as shown in the screen.
Click the Flow tab.
Column
Execution Location
SUM_AMOUNT
Staging Area
AVG_AMOUNT
Staging Area
CUST_ID
Source
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
r.
Source
FIRST_ORDER_DATE
Staging Area
FIRST_ORDER_ID
Staging Area
LAST_ORDER_DATE
Staging Area
LAST_ORDER_ID
Staging Area
PRODUCT_ID
Source
QTY
Staging Area
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
CUST_NAME
Verify the flow, and then save your temporary interface. Verify that your temporary
interface appeared in the tree view. Close your interface tab.
Note the yellow color of your newly created temporary interface in the Designer
Navigators Projects tree view.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
t.
Create a new interface, which uses the newly created temporary interface as a source.
a. In the HandsOnLoads project, create a new ODI interface, INT_12-1-2, as shown
next. In the Optimization Context field, select Development. Open the Mapping tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
2.
Drag the temporary interface, INT_12-1, from the Projects tab to the Source area.
c.
From the Models tab, drag the datastore TRG_SALES from the Oracle Sales
Application model to the Target Datastore area. Click Yes to perform automatic
mapping. Note that only three of the nine columns were automatically mapped.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Repeat the previous two-step process to map the remaining target columns to their
corresponding columns in the temporary interface in the Source area. Use the following
table and results screen as your guide:
1. First click this column in the Target
Datastore TRG_SALES:
FIRST_ORD_ID
FIRST_ORDER_ID
LAST_ORD_ID
LAST_ORDER_ID
LAST_ORD_DATE
LAST_ORDER_DATE
AMOUNT
SUM_AMOUNT
PROD_AVG_PRICE
AVG_AMOUNT
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
To view data derived from the temporary interface, right-click the temporary interface
and select Data. Close the Data Editor window.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Select the Flow tab, click Target datastore, and verify the flow of your interface. In the
Target Properties, set the DELETE_ALL option to true. Save the interface, and then
close the interface tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
h.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
Open ODI Operator Navigator and verify that the interface INT_12-1-2 executed
successfully. Scroll down and open the task Integration - INT_12-1-2 - Insert new rows.
Verify the number of inserts.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
In the Models tab in the Oracle Sales Application model, right-click the TRG_SALES
datastore, and select View Data. View the rows inserted in the target datastore.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background:
After the interface is created and tested, you may need to create a new knowledge module to
use with the interface.
In this practice, you duplicate an existing knowledge module, IKM SQL Incremental Update,
naming the new knowledge module IKM Oracle UI - Audit. You add two commands to the
knowledge module, Create Audit Table and Insert Audit Records, by using command syntax
provided in text files.
Next, you duplicate an existing interface, INT-Exp-FF-RT, naming the new interface INT-EXPFF-RT-AUDIT. You change the new interfaces IKM selection to use the new knowledge module
you just created, IKM Oracle UI - Audit.
Finally, you execute interface INT-EXP-FF-RT and examine the audit records inserted into the
audit table created by your knowledge module.
Your Tasks:
1.
Create the new knowledge module with new functionality to create an audit table and insert
audit records.
a. If not connected, connect to the DEV_ODI_REPO Work Repository (User:
SUPERVISOR, Password: SUNOPSIS). Click the Designer tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Open ODI Designer and click the Projects tab. Select Projects > Export-FF-RT >
Knowledge Modules > Integration (IKM). Right-click IKM SQL Incremental Update
and select Duplicate Selection. In the window that follows, click Yes.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
Double-click Copy of IKM SQL Incremental Update to edit it. Rename this KM IKM
Oracle UI Audit. Click the Details tab.
Note: If the message for Object Locking/Unlocking is displayed, click OK.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
On the Details screen, review the commands in the current KM. Select Insert new
rows and then click the Add
e.
Name this command Create Audit Table. Select the Ignore Errors check box. In
the Command on Target tab, set the Technology to Oracle. Enter the following
command to create the audit table. Verify that the check boxes in the Journalizing
section are not selected. If necessary, deselect them.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Note: You can find this command in the file 12-2.txt, provided in the following
location: c:\Labs\Text.
Click the Details tab. Scroll down and select the Create Audit Table command. Click
the
icon several times to move the command up and place it right after the Insert
new rows step, as shown below. Verify that the Ignore Errors check box is selected
for your new Create Audit Table command.
With the Create Audit Table command still selected, click the Add icon again
.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
Similarly, create the command that inserts audit records in the audit table, as shown in
the screen. Name this command Insert Audit Records. Select the Ignore Errors
check box. In the Command on Target tab, set the Technology to Oracle. Enter the
command provided below.
Copyright 2012, Oracle and/or its affiliates. All rights reserved.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Note: You can find this command in the file 12-2.txt, provided in the following
location: c:\Labs\Text.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
getColList:
Notice the PK parameter. If it is used, only the columns that are part of the
primary key are included.
`
Click the Details tab. Scroll down and select the Insert Audit Records command.
Click the
icon several times to move the command up and place it right after the
Create Audit Table step, as shown in the next screen. Click Save, and then close
the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
2.
After clicking Save, verify that your new knowledge module, IKM Oracle UI Audit,
appears in the Knowledge Modules tree.
You will create a modified copy of the interface INT-EXP-FF-RT, to execute with your newly
created knowledge module. You will need to duplicate the existing interface, rename it, and
then change the IKM entry to use your new IKM Oracle UI-Audit.
a. On the Projects tab, right-click the interface INT-EXP-FF-RT and select Duplicate
Selection. Click Yes on the Confirmation screen.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
h.
Double-click the interface Copy of INT-EXP-FF-RT. Change the name of the interface
to INT-EXP-FF-RT-Audit, as shown in the screenshot. Click the Flow tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
On the Flow tab, click Target (ODI_STAGE) in the diagram to open the Target Area
Property Inspector below the diagram. In the IKM Selector drop box, select IKM Oracle
UI - Audit. Ensure that in the Options list, FLOW_CONTROL and STATIC_CONTROL
options are set to false, as shown in the screenshot. Click the Save button, and then
close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
To execute your new interface, select the interface and click the Execute button
Click OK. Click OK again in the Information window to start the execution.
Click the Operator tab to open ODI Operator. Click to open the All Executions node. If
necessary, click the Refresh icon
session steps.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Scroll down and double-click the Create Audit Table step. View the content of the
Definition and Code tabs for this step. Close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
Similarly, view the Insert Audit Records step information. Refer to the following
screens. Click Close.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
Open Oracle SQL Developer and expand the ODI_STAGE connection (for the
password, enter ODI_STAGE). Select the Tables (Filtered) node and if necessary click
the Refresh button
. Click the Audit table TRG_SALES_PERSON_H, click the
Data tab, and verify that your Audit table was created and populated with audit records,
as shown next.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
In addition, you create an option for your new knowledge module to make your KM more
user friendly. This option will enable an end user to choose when to generate audits.
a. In Designer, click the Projects tab, right-click IKM Oracle UI Audit, and select New
Option. Name this option AUDIT_CHANGES, set Type to Check Box, and Default
Value to true. Click Save and close the AUDIT_CHANGES option tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
Now, you need to link this option to your steps in the KM. Double-click IKM Oracle UI Audit, and click the Details tab. Double-click your new step, Create Audit Table, to
edit it. Scroll to the bottom and click the Options plus sign [+] to show its contents.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Deselect the Always Execute check box. Select AUDIT_CHANGES. This will
condition the execution of these steps with the value set by the end user. Click Save.
Click the Details tab.
d.
Repeat the previous step for the Insert Audit Records command, as shown in the
following screens. Click Save to save your KM and close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Double-click INT-Exp-FF-RT-Audit to edit it. Click the Flow tab, click Target
(ODI_STAGE), and verify that the option AUDIT_CHANGES is set to true.
Execute the interface
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
If not opened, open ODI Operator, select All Executions, and then click the Refresh
button and view the execution results. Both Create Audit Table and Insert Audit
Records steps should be present.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
In Designer, edit the INT-Exp-FF-RT-Audit interface again. In the Flow tab, click
Target (ODI_STAGE) and set the option AUDIT_CHANGES to false. Save your
interface and then execute your interface again
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
In ODI Operator, click the Refresh button and view the execution results. The new KM
steps to create and populate an audit table are not executed.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
h.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 13
Chapter 13 - Page 1
Practices Overview
In this practice, you define an ODI procedure to create a relational table and populate it with
data.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background:
A common task that is performed by using ODI is creating and populating a relational table. This
practice walks you through the steps that are needed to create a project and a procedure that
will create and populate a relational table with data. You also execute the procedure and verify
the execution within ODI Operator.
In this practice, you use the same RDBMS schema, ODI dataserver, and ODI physical schema
all named ODI_STAGEwhich you created in Practice 10-1.
You create the project Procedure-CRT-TBL, and you create the procedure PRD-createpopulate-table.
Next, you add commands to drop, create, and populate a table, by using the syntax provided in
text files.
Finally, you execute the procedure and verify that the table was created and populated with
records.
1. Create the project Procedure-CRT-TBL.
2. Create the procedure PRD-create-populate-table.
3. Add commands to drop, create, and populate a table.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
1.
b.
Enter the name of the project: Procedure-CRT-TBL. Click the Save button to create
the project and close the tab. The project appears in the tree view. Expand the
Procedure-CRT-TBL project node.
Note: In this practice, you use the same RDBMS schema, ODI data server, and physical
schema named ODI_STAGE that you created in Practice10-1. If you have not performed
Practice 10-1, complete Practice 10-1, steps 5 and 7 to create the RDBMS schema, the
ODI source data server, and the physical schema for your new RDBMS model.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Your Tasks:
d.
Open ODI Designer. In the Projects tab, select Procedure-CRT-TBL > First Folder.
Right-click Procedures and select New Procedure.
e.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
In the command window, enter the parameters of the procedure and the command on
the target provided in the following table. You need this command to drop the table in
case a table with this name exists. Select the Ignore Errors check box.
Parameter
Value
Name
Drop Table
Technology
Oracle
Schema
ODI_STAGE
Ignore Errors
Selected
g.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
Parameter
Value
Name
Create Table
Technology
Oracle
Schema
ODI_STAGE
Ignore Errors
Unchecked
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Note: You can copy this command from the 13-1.txt file, which is provided in your
Lab folder in the following location: c:\Labs\Text.
In the command screen, click the Command on Target tab. Enter the parameters and
the command shown below. Click the Details tab to view your steps.
Note: You can copy this command from the file 13-1.txt, which is provided at the
following location: c:\Labs\ Text.
i.
Parameter
Value
Name
Populate Table
Technology
Oracle
Schema
ODI_STAGE
Ignore Errors
Deselected
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
h.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
begin
insert into ODI_STAGE.SRC_SALES_PERSON values
(11,'Andrew','Andersen','22/02/1999',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(12,'John','Galagers','20/04/2000',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(13,'Jeffrey','Jeferson','32422',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(20,'Jennie','Daumesnil','28/02/1988',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(21,'Steve','Barrot','24/09/1992',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(22,'Mary','Carlin','14/03/1995',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(30,'Paul','Moore','36467',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(31,'Paul','Edwood','18/03/2003',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(32,'Megan','Keegan','29/05/2001',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(40,'Rodolph','Bauman','29/05/2000',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(41,'Stanley','Fischer','37233',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(42,'Brian','Schmidt','25/08/1992',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(50,'Anish','Ishimoto','30/01/1992',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(51,'Cynthia','Nagata','28/02/1994',sysdate);
insert into ODI_STAGE.SRC_SALES_PERSON values
(52,'William','Kudo','28/03/1993',sysdate);
end;
2.
Select the Details tab and note the three steps. Click Save and close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
j.
Open ODI Operator. In ODI Operator, click the All Executions node, click the Refresh
icon, find your session, and verify that your procedure executed successfully.
c.
Open Oracle SQL Developer and expand the ODI_STAGE connection. Select the
Tables node and click the Refresh button
. Double-click the newly created table
SRC_SALES_PERSON, click the Data tab, and verify that your table
SRC_SALES_PERSON was successfully created and populated with records as
shown in the following screenshot.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
Additionally, you create an option to delete rows from the target audit table, which you
created in Practice 12-2. To delete rows, you add a command that uses the value of the
option in the code. If the value of this option is set to Y, the command to delete records
will be executed.
a. Right-click your procedure and select New Option. Name this option
DELETE_AUDIT_RECORDS, and set Type to Value. Add the description as shown on
the screen. Set the default value of this option to Y (no quotes). Click the Save icon.
4.
Open your procedure, PRD-create-populate-table, and then click the Details tab. Click the
Add icon to add a new command.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
6.
Add the new command on Target to delete records in the audit table
TRG_SALES_PERSON_H. Set the parameters as shown in the following table.
Note: You can copy this command from the file 13-1.txt, which is provided at the
following location: c:\Labs\Text.
Parameter
Value
Name
Technology
Oracle
Schema
ODI_STAGE
Ignore Errors
Checked
Click the Options tab and verify that the value of your newly created option is set to Y.
Click the Save icon.
Note: To view the inputs in the Options tab, you must click the Refresh button.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
5.
Execute your procedure. In Operator, verify that the procedure executed successfully.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
7.
Open SQL Developer and expand ODI_STAGE > Tables (Filtered). Open the Audit table
TRG_SALES_PERSON_H, click the Data tab, and verify that the rows were deleted from
the Audit table.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
8.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 13 - Page 16
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 14
Chapter 14 - Page 1
Practices Overview
In Practice 14-1, you create an ODI procedure and package to execute the sequence of
transformations for the Interfaces created in previous practices. In Practice 14-2, you modify a
package to use it with a variable and a user function that you define.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background:
A common task that is performed by using ODI is creating a package that executes a number of
objects (Interfaces, Procedures) in the flow. In this practice, you create an ODI procedure and
package to execute the sequence of transformations with the interfaces created in the previous
practices.
In this practice, you create a procedure, DELETE_TARGET, for deleting records from the
TRG_SALES, TRG_CUSTOMER, TRG_CITY, TRG_REGION, and TRG_COUNTRY tables.
Then, you create and execute a package, PKG_14-1. This package runs your new procedure,
and then runs four interfaces you defined earlier in Lessons 8 and 9, which will use these same
tables as targets:
The DELETE_TARGET procedure
Practice 8-1 interface
Practice 8-2 interface
Practice 8-3 interface
Practice 9-1 interface
Finally, you run this package and review its execution in ODI Operator.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
1.
b.
In the Designer tab, click the Projects tab, and then select the Procedures node from
the HandsOnLoads > HandsOn folder. Right-click the Procedures node and select the
New Procedure option.
c.
Enter DELETE_TARGET in the Name field, and select Oracle as the Target
Technology. Click the Details tab, and then click the Add icon
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Your Tasks:
In the Name Field, enter DELETE TRG_SALES. In the Schema field, select
ORACLE_ORCL_LOCAL_SALES. In the Context field, select Development. In the
Command field, enter the following code:
DELETE FROM <%=odiRef.getObjectName("L", "TRG_SALES",
"ORACLE_ORCL_LOCAL_SALES", "", "D") %>
This method returns the table name with run time-dependent information, such as the
Oracle schema name that may vary depending on the context and topology. Select the
Ignore Errors check box. Select the Details tab.
e.
Click the Add icon. In the Name Field, enter DELETE TRG_CUSTOMER. In the Schema
field, select ORACLE_ORCL_LOCAL_SALES. In the Context field, select
Development.
In the Command field, enter the following code:
DELETE FROM <%=odiRef.getObjectName("L", "TRG_CUSTOMER",
"ORACLE_ORCL_LOCAL_SALES", "", "D") %>
This method returns the table name with run time-dependent information, such as the
Oracle schema name that may vary depending on the context and topology. Select the
Ignore Errors check box. Select the Details tab
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Repeat the two previous steps to create the commands DELETE TRG_CITY, DELETE
TRG_REGION, and DELETE TRG_COUNTRY, which delete the tables TRG_CITY,
TRG_REGION, and TRG_COUNTRY, respectively, as shown in the following screen.
Note: To enter the commands, you may refer to the file 14-1.txt provided at the
following location: c:\Labs\Text.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 14 - Page 7
2.
Open the Details tab to view the commands. Click the Save button, and then close the
procedure tab.
b.
Enter PKG_14-1 in the Name field, and then click the Diagram tab. In the Designer
navigator tree view, expand the Interfaces node and Procedures node. Select the
DELETE_TARGET procedure from the tree view, and then drag it to the diagram
workbench. A DELETE_TARGET step appears in the package.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
Repeat the operation for the INT_8-1, INT_8-2, INT_8-3, and INT_9-1 interfaces. The
package should appear as follows.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
Rename your steps with the names of the tables loaded by the step. In the Diagram
window, click the step for the DELETE_TARGET procedure. Edit the Step name:
DELETE TARGET TABLES, as shown in the following screenshot. In the diagram,
click the empty space. The step is now renamed Delete Target Tables.
e.
Similarly edit the names of the other steps in the diagram, as follows:
Rename INT_8-1 as Countries, INT_8-2 as Regions, INT_8-3 as Cities, and INT_9-1
as Customers.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
g.
Click the Countries step. Press and hold the left mouse button and move the cursor
over the Regions step. Then, release the mouse button. A green arrow appears
between these steps. Repeat this operation to link the steps in the correct order:
Countries > Regions > Cities > Customers, as follows.
h.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
f.
In the Operator Navigator, click the Refresh icon. In the session list, expand the All
Executions node. The session called PKG_14-1 should appear as complete. You can
expand the nodes in the session to see the steps and tasks corresponding to your
procedure commands and the interfaces that have been executed.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
Close the PKG_14-1 tab.
Chapter 14 - Page 13
Background:
A common task that is performed by using ODI is using user functions and variables to add
more complexity to your workflows and mappings. This practice will explain how to use
variables, user functions, and the more advanced features in the packages.
1. In the HandsOnLoads project, define a user function group named Conversion,
containing a user function named DearConvert.
2. Use this function in the interface INT_9-1 to convert the values (0, 1, 2) to (Mr, Mrs,
Ms).
3. In ODI Designer, create a numeric variable DELETION_FLAG that counts the number of
lines in TRG_CUSTOMER.
4. Duplicate the PKG_14-1 package, naming the new package PKG_14-2.
5. Have the DELETE_TARGET procedure run only if the DELETION_FLAG variable is greater
than 0.
Your Tasks:
1.
Create a user function called DearConvert in a new user function group called
Conversion. This function converts the values (0, 1, 2) to (Mr, Mrs, Ms). Implement
this function for Oracle as linked technology with a CASE WHEN expression.
Note: Remember to use the dollar sign ($) when using the parameters.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practice 14-2: Using ODI Package with Variables and User Functions
Select the User Functions node in the HandsOnLoads project. Right-click this node
and select New User Function.
b.
Enter DearConvert in the Name field, enter Conversion in the Group field, and enter
the following in the Description field:
Converts the values (0, 1, 2) to (Mr, Mrs, Ms). In the Syntax
field, enter: DearConvert($1)
Note: $1 is the parameter name you use in the decision case structure shown in the
following screenshot.
Click the Implementations tab, and then click the Add button.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
a.
In the Implementation window, select Hypersonic SQL from the list of Linked
Technologies. Verify that Oracle technology is also selected. Enter the following code
in the Implementation syntax field. Click OK to save this implementation. Click the
Save icon, and then close the DearConvert user function tab.
Note
In Locking/Unlocking Object windows that may appear, click Yes.
To enter the commands, you may refer to the file 14-2.txt provided at the
following location: c:\Labs\Text.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 14 - Page 17
You use this function in the interface INT_9-1 to convert the source DEAR column into the
target DEAR column.
a. In the Projects tree view, expand Interfaces. Double-click the interface INT_9-1 to open
it. In the Locking window, click Yes. Click the Mapping tab.
b.
In the Target datastore, select the Dear column. Edit the implementation in the
Properties panel to have the following code:
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
2.
3.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Click the Operator tab. Select All Executions, and then click Refresh. Expand the All
Executions node. The session called INT_9-1 should appear as complete. Note that
the steps you see may not be identical to those shown below.
c.
In the Mapping tab, right-click the Target datastore and select Data. Verify that the
column DEAR was populated with Mr as shown below.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
Create a numeric variable called DELETION_FLAG that counts the number of lines in
TRG_CUSTOMER.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
4.
In the Designer, open the Projects tab, and select the Variables node in the
HandsOnLoads project. Right-click this node and then select New Variable.
b.
Enter DELETION_FLAG in the Name field, select Numeric as the Datatype, and enter
0 in the Default Value field. In the Keep History field, select All Values to enable
viewing the history of all values for this variable.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
a.
5.
Modify a package to have the Delete Target step running only if DELETION_FLAG is
greater than 0.
a. Duplicate the PKG_14-1 package. Open the package Copy of PKG_14-1 and rename
it PKG_14-2.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
Select the Diagram tab. In the project tree, expand the Variables node. Drag the
DELETION_FLAG variable from the tree view to the diagram. Click the
Deletion_FLAG step in the diagram. In the Properties > General tab beneath the
diagram, rename this step Refresh Customer Count. Ensure that the Type field is
set to the Refresh variable.
Note: You need to click the step in the diagram to view the new step name.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 14 - Page 25
Drag the DELETION_FLAG variable from the tree view to the diagram again. Rename
this step Flag > 0?, change the Type to Evaluate Variable. In the Operator field,
select > as the operator, and enter 0 in the Value field.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
Right-click the Refresh Customer Count step and select First Step. Click the
Next step on success tool
on the Package toolbar, and link the step Refresh
Customer Count to the step Flag >0? Using the same tool, link the step Flag >
0? to the step Delete Target tables. Click the Next step on failure tool
on
the Package toolbar, and link the step Flag > 0? to the Countries step, as shown
below. Click Save to save the package. Close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Run the new package and check if the Delete Target Tables step was executed.
a. Right-click the package PKG_14-2, and then select Execute. Click OK in the
Execution window, and then click OK when the Session started message appears.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
6.
In the Operator, verify that the latest session called PKG_14-2 appears as complete,
with a Delete Target Tables step executed.
c.
Open the Designer tab. Open the package PKG_14-2 again, and then select the
Diagram tab. To delete records from the target tables, select the Delete Target Tables
step, right-click, and select Execute Step. Click OK in the Execution window, and then
click OK when the Session started message appears.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
In the Operator, verify that the latest session called PKG_14-2 appears as complete,
with a Delete Target Tables step executed.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Now, with records from the target tables having been deleted, execute the entire
package PKG_14-2 again. Click OK in the Execution window, and then click OK when
the Session started message appears.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
Open the Operator and expand the latest session called INT_14-2. Verify that the
Delete Target Tables step is no longer executed.
Note: Because the Customers tables were emptied by the execution of the Delete
Target Tables step, the value of variable Flag >0? changes when refreshed, to
false, and the Delete Target Tables step is no longer executed. Close the
PKG_14-2 tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 15
Practices Overview
In this practice, you create an ODI scenario and schedule its execution with an ODI agent in
scheduling mode.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background:
A common task that is performed by using ODI is to create an ODI scenario and schedule its
execution. You already developed the ODI procedure that creates a relational table and
populates the relational table with data.
In this practice, you learn how to create and schedule an ODI scenario to run the procedure you
created in Practice 12-1.
First, in the Designer Navigators Projects tab, you generate a scenario for the PRD-createpopulate-table procedure.
Then, in Topology Navigator, you verify connection to ODI Agent.
Next, in Designer Navigator, you schedule the scenario with ODI Agent.
You switch back to Topology Navigator to review the scheduling of the agent.
Finally, in Operator Navigator, after the scheduled scenario execution time, you verify that the
scenario has executed.
Your Tasks:
1.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
In ODI Designer, click the Projects tab. On the Projects tab, expand the project:
Procedure-CRT-TBL > First Folder > Procedures. Right-click the PRD-createpopulate-table procedure and select Generate Scenario.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
d.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
Now, you need to schedule an ODI scenario with ODI Agent. To schedule the scenario,
perform the following steps:
a. In Topology Navigator, verify connection to ODI agent, as shown in the following
screen.
Note: If ODI Agent is not set up and running, you must perform the steps specified in
Practice 3-1 before continuing.
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
2.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Note: To schedule a scenario, an ODI Agent must be set up. If an ODI Agent is not set
up within the ODI Topology Navigator, perform Practice 3-1, Setting Up and Installing
an ODI Agent.
On the screen that follows, select the agent where the scheduled scenario will run:
localagent. Set Context as Development and log level to 5. Set Execution to Simple
and click the
button. Set the execution time to approximately five minutes from the
current system time, as shown in the following screenshot. Click the Save button.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
Expand Scheduling and verify that the DEVELOPMENT / localagent entry is now
inserted under Scheduling.
e.
Open Topology Navigator to review the scheduling of the Agent. In the Physical
architecture, expand the Agents node and double-click localagent. On the localagent
screen, click Update Schedule. On the screen that follows, click OK. Click OK again.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Click the View Schedule button. The screen that appears shows you the scheduling
information. Click OK to close the schedule. Close the tabs: Localagent tab and
Scenario Scheduling.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
To verify the execution of the scheduled scenario, perform the following steps:
a. Click the Operator tab to open ODI Operator. In ODI Operator, click the Session List
tab. Wait until the scheduled execution time to view the execution results, and then
click the Refresh icon.
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 16
Chapter 16 - Page 1
Practices Overview
In this practice, you will use the load plan editor to create a simple load plan with a set of
parallel and serial steps.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background:
When ODI is used to populate very large data warehouses, it is common to have thousands of
tables being populated by using hundreds of scenarios. The execution of these scenarios has to
be organized in such a way that the data throughput from the sources to the target is the most
efficient within the batch window. Load Plans help organize the execution of scenarios in a
hierarchy of sequential and parallel steps for these types of use cases.
Load Plans are objects that organize the execution of packages and scenarios at a high level.
Load Plans provide features for parallel, sequential, and conditional scenario execution,
restartability, and exception handling.
In this practice, you will use the load plan editor to create a very simple load plan with a set of
steps running in parallel, followed by a set of steps running sequentially.
First, define a load plan.
Then, add a node for independent steps to run in parallel. Create two procedures for loading
dimensions, and add them as steps to execute in parallel.
Next, add a node for interdependent steps to run in a specific sequence. Add several of your
previously defined objects as steps to run in the following order:
1. DELETE_TARGET procedure, which deletes records from the TRG_SALES,
TRG_CUSTOMER, TRG_CITY, TRG_REGION, and TRG_COUNTRY tables.
2. INT_8-1, which adds records to the TRG_COUNTRY table.
3. INT_8-2, which adds records to the TRG_REGION table.
4. INT_8-3, which adds records to the TRG_CITY table.
5. INT_9-1, which adds records to the TRG_CUSTOMER table.
Note: These five steps are the same set of operations you used in creating the PKG_14-1
package.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
1.
Create a simple load plan to execute two steps in parallel, and then five steps serially.
a. In the Designer Navigator, click the Load Plans and Scenarios tab. From the tabs
menu, select New Load Plan.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Your Tasks
Enter Data Warehouse Load Plan in the Name field, and click the Steps tab.
c.
The load plan editor opens with the root step node. Click the Add Step button, and
select Parallel Step.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
2.
The Parallel step node appears under the root step. You will define two new
procedures and place them under the parallel node so they will execute in parallel.
Note that the default restart type for parallel steps is Restart all children, and the restart
type for root_step is Restart from failure. Click Save to save your load plan.
Define two procedures to load PRODUCT and TIME dimensions, and add them to the load
plan Parallel step node.
a. In the Projects tab of the Designer navigator, expand the HandsOnLoads > HandsOn
folder. Right-click the Procedures node and select the New Procedure option.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
c.
d.
Return to the Data Warehouse Load Plan editor. With the Parallel step highlighted,
click the Add Step button and select Run Scenario Step.
e.
A load plan uses scenarios in its steps. You can select an existing scenario for a step,
or choose other objects (packages, interfaces, variables, and procedures), for which
ODI will automatically generate a scenario to run the step.
Copyright 2012, Oracle and/or its affiliates. All rights reserved.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
f.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
You now add the two procedures you just defined as steps under the Parallel node of
the load plan.
In the Add Run Scenario Step screen, click the Lookup Scenario button.
h.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
The first of your two parallel steps appears. Click the Parallel node of the Steps
Hierarchy, and click the Add Step button again. Select Run Scenario Step.
j.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
i.
Add ODI objects to the load plan as serial steps. These are the same objects you used
earlier to create the PKG_14-1 package.
a. Click root_step in the Steps Hierarchy. Click the Add Step button and select Serial
Step.
b.
The Serial node appears in the Steps Hierarchy. With Serial node selected, Click the
Add Step button and select Run Scenario Step.
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
Select Procedure as the executable object type. Select DELETE_TARGET. Click OK.
In the New Scenario window, accept the name DELETE_TARGET as the name of the
scenario that ODI will create to run this procedure, and click OK.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
ODI returns to the Add Run Scenario Step window. Click Finish.
f.
The first of your five serial steps appears. Click the Serial node of the Steps Hierarchy,
and click the Add Step button again. Select Run Scenario Step.
g.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
You will add four interfaces to the Serial node: INT_8-1, INT_8-2, INT_8-3, INT_9-1.
First, select INT_8-1 and click OK. In the New Scenario window, accept the name
INT_8-1 as the name of the scenario that ODI will create to run this interface, and click
OK. ODI returns to the Add Run Scenario Step window. Click Finish.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
h.
4.
Repeat steps f. through h. to add the remaining three interfaces: INT_8-2, INT_8-3,
and INT_9-1. Your results should look like the following screen. Note the default restart
values for the different types of steps. Click Save to save your load plan.
Now, execute the load plan and examine the list of executed steps in the Operator
Navigator.
a.
Click
to execute the Load plan. Click OK in the Start Load Plan window, and then
click OK when the Load Plan started message appears.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
i.
Open the Operator Navigator, click Refresh, and examine the results of executing the
load plan. The seven steps in the load plan appear as a grouping of seven executions.
For each load plan step, ODI generated a scenario for execution.
First, the procedures for loading the TIME and PRODUCT dimensions executed in
parallel. Then, the DELETE_TARGET procedure and the four interfaces executed in
the sequence you defined.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 17
Practices Overview
In this practice, you create multiple versions of individual ODI objects.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background:
In the previous practices, you learned how to create ODI Interfaces, which transform data from
one or more relational tables in the source to a relational table in the target.
In this practice, you take an interface and create a first version of it, version 1.0.0.0. Next, you
change some details of the interfaces mapping and create a second version of the interface,
version 1.0.0.1.
Then you use the ODI Version Browser and Version Comparison tool to compare these two
versions of the interface and to detect the differences between them.
Finally, you generate a PDF report of the versions, and then restore the original version.
1. Create an interface.
2. Create a new version 1.0.0.0 of the interface.
3. Change the interface flow and create another version of the interface, version 1.0.0.1.
4. Use the Version Browser to compare versions of the interface and create a version
comparison report.
Note: Completing this practice is critical for all the following practice sessions.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Password: SUNOPSIS.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Your Tasks:
1. Create a new Interface with Oracle Data Integrator.
a. If not connected, connect to the ODI Work Repository DEV_ODI_REPO. Log in with
the following details. Click OK.
In Designer navigator, click the Projects tab. Expand HandsOnLoads > HandsOn >
Interfaces, and select INT_9-1. Right-click this interface and select Duplicate
Selection. In the Confirmation window, click Yes.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
2.
Double-click Copy of INT_9-1. Name the new interface INT_17-1. Click Save to
save the interface. Close the INT_17-1 tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Double-click INT_17-1 to edit it. Click the Flow tab. On the flow tab, click Target
Datastore. Select the Distinct Rows check box. Click the Save button and close your
interface tab.
c.
To create another version of this modified Interface, right-click INT_17-1 and select
Version > Create Version.
On the screen that follows, note the previous (original) version of your interface.
Click the Hide/Unhide Previous Versions button
original version.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Optionally, enter the description of the new version in the Description field. Click OK to
save your new version.
Now, you explore your versions by using the Version Browser. Click ODI > Version
Browser. View your versions with all the necessary information.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
Select the two Modified filters and deselect all other check boxes. Now you have a
more compact view of your changes. Click the Print button.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
On the Report generation screen, select the New objects check box. Click the
button to specify the PDF file location.
d.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Use Windows Explorer to open the PDF file with your report. Scroll down to view the
report. Note the different values for Distinct Rows in the two versions of the interface.
Close the report.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
4.
In the Designer Navigator, double-click the INT_17-1 interface. Click the Version tab.
View your current restored version: 1.0.0.0. Close the INT_17-1 editor.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 18
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practices Overview
In this practice, you enforce data quality with an interface that you created in Practice 10-1, and
you perform error management.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background
In the previous practices, you learned how to create ODI Interfaces, which transform data from
one or more relational tables in the source to a relational table in the target and to export data
from a flat file to a relational table. In this practice, you perform data quality control for the
interface created in Practice 10-1.
First, for a certain datastore, you verify that the primary key constraint is marked static, and two
columns are marked mandatory with static control.
You then create an interface by using that datastore as a target.
On the interfaces Flow tab, you set STATIC_CONTROL to True. On the Controls tab, you
ensure that the knowledge module is set to CKM SQL (a knowledge module that you will import)
and you set maximum allowed errors to 5.
For two columns in the target datastore, you select the Check Not Null check box so that control
errors are generated if these columns are not loaded.
You run the interface with Flow Control set to FALSE. You verify that there are control errors on
three records, and that the three records with errors were loaded into the target datastore.
Finally, you rerun the interface with Flow Control set to TRUE and verify that errors are excluded
from the target datastore.
Note: Completing this practice is critical for all the following practice sessions.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
2.
Modify INT-Exp-FF-RT (created in Practice 10-1) to enable checking data quality in the
target table.
a. On the Projects tab, expand the Export-FF-RT project. Select Knowledge Modules >
Check (CKM). Right-click Check (CKM) and select Import Knowledge Modules.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Your Tasks
1. If not connected, connect to the Work Repository, WORKREP. To connect, click Connect
To Repository. Select DEV_ODI_REPO from the Login Name drop-down list. Enter
SUPERVISOR in the User field and SUNOPSIS in the Password field. Click OK to login.
In the File import directory field, select CKM SQL and click OK. Close the Import
Report window. Verify that CKM SQL was successfully imported and is shown in the
tree view.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
In the model Oracle_RDBMS1, expand TRG_SALES_PERSON > Columns, doubleclick the column LAST_NAME, and then click the Controls tab. Select Static to
enable static control. Select the Mandatory check box. Click the Save button. Repeat
the same step to enable Static control and Mandatory for the DATE_HIRED column.
Save your changes and close the tabs.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
On the Projects tab, expand the Export-FF-RT project, and then duplicate the interface
INT-EXP-FF-RT. Open the copy of the interface and rename it as INT-EXP-FF-RTQuality, and then click the Mapping tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
Delete the filter for the column SALES_PERSON_ID, as shown in the following
screenshot, and then click the Flow tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
On the Flow tab, click Target (ODI_STAGE) to open the Options section. Set the static
control option to true. Click the Controls tab.
h.
On the Controls tab, ensure that your KM is set to CKM SQL. Set the maximum
number of errors allowed to 5. Leave the other options with the default values. Click
the Mapping tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
In Target Datastore, select the LAST_NAME column, and then select the Check Not
Null check box. Repeat the same step for the DATE_HIRED column. Click the Save
button to save your changes.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
i.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
j.
On the Models tab, right-click the TRG_SALES_PERSON target datastore and select
Control > Errors. View the records with errors as shown in the following screenshot:
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
k.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
l.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
m. Click the INT-EXP-FF-RT-Quality tab. On the Interface screen, click the Flow tab.
Click Target (ODI_STAGE) to open the Options section. Set Flow Control to true.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
n.
Chapter 19
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practices Overview
In this practice, you implement Changed Data Capture to detect changes in the source
environment.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background
A common task that is performed by using ODI is to implement Changed Data Capture. In this
practice, students implement Changed Data Capture to detect changes in the source
environment for the interface that was created in Practice 8-1. You will capture data changes in
the SRC_CITY table in the Oracle Sales Application model. Then you modify the interface to
process changed records only.
In this practice, you perform changed data capture in an interface, using the JKM Oracle Simple
knowledge module.
First, you import this knowledge module and create a model by using this journalizing
knowledge module.
Then you create an interface by using the IKM Oracle Incremental Update knowledge module,
specifying capture of journalized (changed) data only.
1. Import the JKM Oracle Simple knowledge module.
2. Create a model, Oracle_RDBMS2, specifying this knowledge module on the Journalizing
tab.
3. Reverse-engineer the model, verifying the resulting structure.
4. Add the models SRC_SALES_PERSON table to CDC and start the Journal by using the
default subscriber SUNOPSIS.
5. Use Data Viewer to change data in the table and verify in Journal Data that the data change
was captured.
6. Create an interface to process only changed data.
Your Tasks
1. Import the appropriate JKM in the project.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
If it is not open, log in to the WORKREP Work Repository with the login name
DEV_ODI_REPO (enter SUPERVISOR for username and SUNOPSIS for password).
b.
c.
Select JKM Oracle Simple to import and click OK. Close Import Report.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
a.
On the Models tab, create a new model named Oracle _RDBMS2. For Technology,
enter Oracle. Select the logical schema ODI_STAGE. Click the Reverse Engineer tab
and set Context to Development. Verify the setting, as shown in the following
screenshot. Click the Journalizing tab.
Note: You created the SRC_SALES_PERSON table in the ODI_STAGE schema in
Practice 13-1.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
In the Knowledge Module menu, confirm that the JKM Oracle Simple.ProcedureCRT-TBL knowledge module is selected, as shown in the following screenshot. Click
the Save icon
to save your model, and then close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
2.
Set up the CDC Infrastructure. You will start the CDC on the SRC_SALES_PERSON table in
the Oracle_RDBMS2 model.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
From the Models tab of Designer Navigator, reverse-engineer the Oracle_RDBMS2 model (not
Oracle_RDBMS1). Expand this model and verify its structure as follows:
To add the table to CDC, expand the Oracle_RDBMS2 model, right-click the
SRC_SALES_PERSON table, and select Changed Data Capture > Add to CDC. Click
Yes to confirm.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
a.
c.
In this practice, you use the default subscriber SUNOPSIS. Consequently, you do not
have to add another subscriber. Click OK to confirm that your subscriber is
SUNOPSIS. In the Execution window, click OK. In the Information window, click OK
again. Wait several seconds, click Refresh
. This means
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
3.
Open Operator Navigator. Click Refresh. Select All Executions and verify that the
SRC_SALES_PERSON session executed successfully.
View the data, change some data, and confirm that the changed data is captured.
a. In Designer Navigator, click the Models tab. Right-click the SRC_SALES_PERSON
datastore and select Data.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Select the row with SALES_PERSON_ID = 11. In the LAST_NAME column, double-click
Andersen to edit that cell. Change the value from Andersen to Anderson. Similarly
select the row with SALES_PERSON_ID = 51 and change the value to Smith. Click the
Save changes icon
c.
Right-click the SRC_SALES_PERSON table again and select View Data. Scroll down
and verify that the rows are modified. Close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Create an interface that processes captured data changes. The interface loads the
TRG_SALES_PERSON_CDC datastore in the Oracle_RDBMS1 model with the content of the
SRC_SALES_PERSON table from the Oracle_RDBMS2 model. The purpose of this interface
is to process and load only changed data.
a. First you need to add one more knowledge module. In ODI Designer, click the
Projects tab, and then expand the Export-FF-RT project. Expand the Knowledge
Modules node. Right-click Integration (IKM) and select Import Knowledge Modules.
Import the new Knowledge Module: IKM Oracle Incremental Update. Close the report.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
4.
Now you need to create one more target datastore to store only changed data. On the
Models tab, expand Oracle_RDBMS1, duplicate the TRG_SALES_PERSON datastore,
and rename the copy as TRG_SALES_PERSON_CDC. Save the
TRG_SALES_PERSON_CDC datastore, and then close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
Open Data in the TRG_SALES_PERSON_CDC datastore, and then click the Delete
Current Row icon
the tab.
repeatedly to delete all the rows. Save your changes and close
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
On the Projects tab, expand Export-FF-RT > First Folder > Interfaces. Right-click
Interfaces and select New Interface.
e.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Click the Models tab. In the tree view, expand the Oracle_RDBMS1 model. Drag the
TRG_SALES_PERSON_CDC datastore from the tree view to the Target Datastore zone.
Expand the Oracle_RDBMS2 model and drag the SRC_SALES_PERSON datastore
from the model tree to the Sources zone of your diagram. Click Yes to perform
automatic mapping. Save your interface.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
Right-click the caption of the source datastore and select Data. Scroll down to preview
the current source data. Close the Data Editor window.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Click the Flow tab, click the Staging Area caption, and verify that the selected IKM is
IKM Oracle Incremental Update. Select Distinct Rows.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
h.
Now you modify this interface to process only the changed data. Click the Mapping
tab. Click the source datastore. In the Source Properties section of the Property
Inspector, select the Journalized Data only check box.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
i.
To check the new source data set, repeat step g. View your data again. Only the
changed data should be visible. Close the Data Editor window.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
j.
5.
Save your interface and close the tab. On the Projects tab, execute the interface to
process only journalized records. In the Execute and Information windows, click OK.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
k.
View the data in the TRG-SALES_PERSON_CDC datastore and verify that only the two
changed rows are inserted in the target datastore.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
6.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Chapter 20
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practices Overview
In Practice 20-1, you create a new user profile, assign authorization by the profile to objects,
and define a password policy. In Practice 20-2, you deploy Enterprise Manager and ODI
Enterprise Manager Plug-in to an existing WLS domain with the deployed and configured ODI
Java EE. You then use the Enterprise Manager and ODI Console to monitor and manage ODI
components, processes, and resources.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background
Using the ODI Security Manager module, you can manage security in Oracle Data Integrator.
In this practice, you explore the security features of ODI Security Manager. You create a profile,
grant three methods (actions) to the profile, and create a new ODI user to whom you assign that
profile.
You then assign the profile to your new user and grant a specific method (View) for a specific
object (Scheduling) to your new user. You also define user parameters that enable specific
functionality for your new user.
Finally, you define password policies that control the case-sensitivity and length of user-defined
passwords.
1. In ODI Security Navigator, expand the Profiles panel and duplicate the Repository
Explorer profile, naming the new profile REVIEWER. You grant three methods to the
REVIEWER profile: Compare with version, Duplicate, and Export from object Model.
Note: You may need to click the View menu and open Security Navigator.
2. Create a new ODI user, INT_PROJECT_REVIEWER.
3. Assign the new profile REVIEWER to your newly created user. To connect to ODI Master
and Work Repositories, assign the built-in profile, CONNECT, to the new user
INT_PROJECT_REVIEWER.
4.
5.
6.
Grant the View method for the Scheduling object to the INT_PROJECT_REVIEWER user.
Define user parameters to enable specific functionality for INT_PROJECT_REVIEWER.
Define password policies to enforce passwords to be uppercase and greater than eight
characters.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
From the View menu, open ODI Security Navigator. Click the Profiles tab. Right-click
the generic REPOSITORY EXPLORER profile and select Duplicate Selection. Click
Yes to confirm.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Your Tasks
1. To define an ODI security policy, you need to create an appropriate profile for the working
methods used in your project.
a. Start Oracle Data Integrator and connect to the Master Repository. For Login Name,
enter DEV_ODI_REPO. Enter SUPERVISOR for user and SUNOPSIS for password.
d.
Rename your new profile REVIEWER. Click the Save button to save this profile. The
profile REVIEWER appears in the Profiles tree structure.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
2.
On the Objects tab, expand Model and select the Compare with Version method.
Drag the Compare with Version method to the REVIEWER profile. In the Confirmation
window, click Yes.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
Repeat step b to add the methods Duplicate and Export... to the REVIEWER profile.
In Profiles, expand REVIEWER > Model, and verify that the methods Compare with
version, Duplicate, and Export... are added to the Model object, as shown in the
following screenshot. Save the REVIEWER profile and close the tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
c.
Enter the password (INTEGRATION), and then confirm this password. Do not select the
Allow expiration date check box. Click OK. Click the Save button
to save this new
user. The INT_PROJECT_REVIEWER user is now displayed in the Users tree structure.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
b.
In the Users panel, expand the INT_PROJECT REVIEWER > Profiles node and verify
that the profile REVIEWER was assigned to this user.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
4.
To connect to ODI Master and Work Repositories and other objects, assign the built-in
profile CONNECT to your new user. Select the CONNECT profile and drag it to the
INT_PROJECT_REVIEWER user. Click Yes to confirm granting CONNECT to your new
user.
d.
Verify that the profiles CONNECT and REVIEWER are added to your new user:
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
You can also grant privileges to use certain methods for objects directly to your user.
Ensure that the Objects and Users panels are open. In the Objects panel, scroll down,
and then expand the object Scheduling. Select View. Drag this method to
INT_PROJECT_REVIEWER.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
5.
Verify that authorization to the Scheduling object with the View method was added to
the INT_PROJECT_REVIEWER user, as shown in the following screenshot:
Connect your new user to the ODI Work Repository and verify your access to ODI artifacts.
a. From the ODI menu, select Disconnect DEV_ODI_REPO. Connect to your Work
Repository as the newly created user. Select DEV_ODI_REPO for the Login Name.
Enter INT_PROJECT_REVIEWER as the user and INTEGRATION as the password.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
On the Designer tab, click the Projects tab and Models tab. Expand your projects and
models to verify that you have access to view all your artifacts.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
Define user parameters so that the user can enable specific ODI functionality. Ensure that a
help message is displayed if an interface diagram is empty and objects remain unlocked
when they are opened. In addition, you may want to set a delay between two refreshes in
seconds and the number of elements displayed in a branch of the Operator tree view.
a. In ODI Security Manager, select ODI > User Parameters.
b.
Confirm or edit the user parameters as shown in the following table. Click OK. Click the
ODI menu and select Disconnect DEV_ODI_REPO to close this user connection.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
6.
Parameter
Value
Functionality
Inter-refresh delay
200
Open your connection with the SUPERVISOR user. Select Security Navigator. Define
Password Policies. These policies consist of a set of rules that will be checked when the
password is defined by the user.
a. Connect to DEV_ODI_REPO with the SUPERVISOR user. For the password, enter
SUNOPSIS. Open Security Navigator. Click the
policy. Click the Add a Policy icon.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
7.
Name this policy Policy 1. Enter the rule description as shown in the following
screenshot. Set Conditions to match to All. In the Rules section, click Text and select
is uppercase. Click the add rule button (the + sign).
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
d.
On the screen that follows, select the Active check box. Select the Passwords are
valid for check box and set it to 30 days. Click OK to save this Password policy. Click
OK again. Close the Security Navigator tab.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Background
In this practice, you perform the steps needed to deploy and configure the ODI Java EE Agent,
Enterprise Manager 11g, and ODI Console plug-in on an existing WLS domain. You use
Enterprise Manager 11g and ODI Console to access your ODI objects.
1. Deploy and configure the ODI Java EE agent, Enterprise Manager, and ODI Console on the
existing WebLogic domain.
2. Connect to the WebLogic Server and managed server, odi_server1.
3. Use Enterprise Manager to administer ODI.
4. Use ODI Console to explore the ODI environment.
Your Tasks
1.
Deploy and configure the ODI Java EE agent and Enterprise Manager on the existing
WebLogic domain, ODI-DOMAIN.
Note: This domain was pre-created for this practice.
a. In Topology Navigator, open Physical Architecture and then create a new ODI Agent.
Name this agent OracleDIAgent. Set the port to 8002 and Host to localhost. Verify that
the Web application context is set to oraclediagent, as shown in the following
screenshot. Save your new physical agent.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
In the Logical Architecture, create a new logical agent with the same name as your
new physical agent, OracleDIAgent. Link this logical agent to the physical agent
OracleDIAgent in all three contexts, as follows. Click Save to save your agent
definition.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Note: The agent name is case-sensitive. Use the exact name OracleDIAgent, as
shown in the following screenshot:
Extend the WebLogic server domain ODI-DOMAIN with the ODI agent application.
a. To deploy and configure domains with WLS, you start the config.bat file from the
ODI Home Install directory
C:\Oracle\Middleware\Oracle_ODI1\common\bin. Use Start > Run > CMD to
start the command shell and change directory to
C:\Oracle\Middleware\Oracle_ODI1\common\bin. Execute the command
config, which starts the Configuration Wizard.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
2.
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
In the screen that follows, select Oracle Data Integrator Agent 11.1.1.0 (Oracle
Oracle Data Integrator Agent Libraries 11.1.1.0 and Oracle JRF 11.1.1.0 will also
be selected; leave these options selected).
Select the Oracle Enterprise Manager Plugin For ODI 11.1.1.0, which will also
include the Oracle Enterprise Manager 11.1.1.0.
Also select Oracle Data Integrator Console - 11.1.1.0, which will include the Oracle
Data Integrator SDK Shared Library Template 11.1.1.0.
Click Next.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
On the next screen, accept the default application location. Click Next.
f.
The wizard will set up the ODI repository connection within the domain server. During
the wizard configuration, the repository connection information must be supplied.
Select the check boxes next to ODI Master Schema and ODI Work Schema. This will
cause most of the fields to be filled with relevant values.
Change the Host Name field on the upper-right to localhost. This will automatically add
localhost to the other two Host Name fields at the bottom of the screen. Fill the
Schema Password field below the Schema Owner field with oracle1. This will
automatically add the password to the two other password fields on the lower-right
corner of the screen.
Check the values filled in by the wizard, and the values you entered, against the
following table and screen.
Click Next.
Database Connection (Master Repository)
Parameter
Value
Vendor
Oracle
Driver
Schema Owner
DEV_ODI_REPO
Schema Password
oracle1
DBMS/Service
orcl
Host Name
Localhost
Port
1521
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Verify that the test was successful (if not, correct any connectivity settings). Click Next.
h.
On the next screen, select Managed Servers, Clusters and Machines. Click Next.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
g.
The Configure Managed Servers screen shows two managed servers: odi_server_1
and odi_server1. odi_server1 has been predefined specifically for this practice,
so use the Delete button to remove the first entry in the list, odi_server_1.
j.
Set Listen port to 8002 for odi_server1. This matches the port setting that you used
when defining the OracleDIAgent physical agent. Click Next.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
i.
l.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
k.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
m. The Assign Servers to Machines screen will already have odi_server1 assigned to
LocalODIMachine. Click Next.
Review the Configuration Summary, and then click Extend. When the domain is
created, click Done.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
n.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
d.
Execute the following command to add the correct credential store for ODI Supervisor:
createCred(map="oracle.odi.credmap", key="SUPERVISOR",
user="SUPERVISOR", password="SUNOPSIS", desc="ODI SUPERVISOR
Credential").
Also execute the command to add the correct credential store for the domain ODIDOMAIN:
createCred(map="oracle.odi.credmap", key="ODI-DOMAIN",
user="weblogic", password="welcome1", desc="ODI-DOMAIN
Credential").
To exit WLST, execute the command exit().
Note: All commands are case-sensitive. You can copy commands from the text file
20-2.txt, which is provided in the c:\Labs\Text folder.
Note: At run time, the Java EE Agent will access this credential store authentication.
When you exit WLST, you return to the Windows command shell.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
4.
Return to ODI Topology Navigator. Click the Physical Architecture tab and open the
OracleDIAgent definition tab. Click Test to test the connectivity of your configured ODI
Java EE agent. When you see the success message in the ODI Information window,
click OK.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
With Enterprise Manager, you can monitor and manage processes and resources. You
can explore the deployed application by clicking each link. You can see running
processes, workload, log file information, and more.
c.
Drill down into ODI objects by expanding ODI in the left panel. Expand the ODI node.
Then click MASTER REPOSITORY to view more details.
Note: Your information may differ from the information provided on these screens.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
Click the OracleDIAgent node in the left panel to see the Java EE agent information.
e.
Click the localagent node to see details for the stand-alone agent.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Expand the Application Deployments node, and then click oraclediagent. View
the WebLogic server application deployment information.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
In the left panel, click the Design Time tab. Expand Projects, Models, and Topology.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
5.
Select the Export-FF-RT project, and then click the View icon:
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
Scroll down and click the First Folder link. Click the Interfaces tab. Explore the
interfaces created in your Export-FF-RT project.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
f.
Similarly, explore models in your Work Repository. To explore the datastores, scroll
down and select the Global sub-model name. Scroll down and view the datastores.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
When you have finished exploring, log out of ODI Console and close the browser.
b.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
6.
Chapter 21
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 1
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practices Overview
In this practice, you create a new scenario, modify a Web service, and invoke the Web service
to execute the scenario.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 2
Background:
This practice has two aims: 1) to teach you how to execute a scenario through the ODI public
Web service and 2) to become familiar with the use of the OdiInvokeWebService tool.
Therefore, the OdiInvokeWebService tool will be used to invoke the ODI public Web service
that commands an agent to connect to a given Work Repository, and to start a specific scenario.
In this practice, you use the interface that was created in Practice 10-1.
1. Create and execute a new scenario, INT_EXP_FF_RT.
2. Create a new package, OdiInvokeWebService.
3. Select the OdiInvokeWebService tool from the toolbox and create the corresponding step
in the package.
4. Define parameters of the Web service by using the Advanced dialog box and the SOAP
Editor.
5. Invoke your Web service from the SOAP Editor to execute the scenario INT_EXP_FF_RT.
6. View the response and verify the execution results.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 3
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practice 21-1: Executing an ODI Scenario Through the ODI Public Web
Service
1.
If not connected, connect to the Work Repository, WORKREP. To connect, click Connect
To Repository. Select DEV_ODI_REPO from the Login Name drop-down list. Enter
SUPERVISOR in the User field and SUNOPSIS in the Password field. Click OK to log in.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Your Tasks
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 4
In Designer Navigator, expand the project Export-FF-RT > First Folder > Interfaces.
Right-click the INT-EXP-FF-RT interface and select Generate Scenario. Name the
new scenario: INT_EXP_FF_RT. Set the version to 001.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
a.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 5
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 6
In Designer Navigator, expand the INT-EXP-FF-RT interface and the Scenarios node.
Right-click the INT_EXP_FF_RT Version 001 scenario and execute your newly
created scenario, as follows. For Agent, select localagent. Click OK to confirm the
execution.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
c.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 7
View the results of the execution in Operator Navigator. Click Refresh. Expand the All
Executions node. The INT_EXP_FF_RT session should appear as complete.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 8
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
2.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 9
In the Toolbox panel, scroll down to the OdiInvokeWebService tool. Drag the
OdiInvokeWebService tool to the empty panel on the right. An OdiInvokeWebService
tool step appears in the package.
c.
In the Properties panel, retain the default name OdiInvokeWebService 1 for the Step
name field. Scroll down and define parameters in the Properties panel as follows:
Parameter
Value
WSDL URL
- Leave blank -
Port Type
- Leave blank -
Operation
- Leave blank -
XML Request
- Leave blank -
Request File
- Leave blank -
FILE APPEND
ISO8859_1
ISO-8859-1
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 10
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.
C:/TEMP/WebServiceToolStep
SOAP
HTTP User
- Leave blank -
HTTP Password
- Leave blank -
- Leave blank -
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 11
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
d.
Response File
Select the invokeStartScen operation from the panel on the left. Click the Editor tab at
the bottom of the middle panel. Widen the middle panel, if necessary, to see the Name
and Value columns. Enter the parameters in the request parameter fields as provided
in the following table. Your SOAP Editor panel should appear as follows.
Note: Press Enter each time to confirm your entries.
Parameter
Value
<OdiUser>
SUPERVISOR
<OdiPassword>
SUNOPSIS
<WorkRepository>
WORKREP
<ScenarioName>
INT_EXP_FF_RT
<ScenarioVersion>
001
<Context>
DEVELOPMENT
<Synchronous>
true
LogLevel
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 12
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
e.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 13
Click the Source tab to view the scenario request. Click the Remove Blank Optional
Elements icon
to remove all blank optional elements from the query. This is
necessary to construct a valid query. The request should be as follows.
Note: You can also select the Clean up before execution check box
. This option
automatically deletes the empty optional elements in the SOAP request.
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
f.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 14
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
3.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 15
c.
Click OK to close the Advanced Editor window. Click the Save button to save your
package and close the tab.
In ODI Operator, verify that the INT_EXP_FF_RT scenario successfully executed.
Practices for Lesson 21: Extending Oracle Data Integrator with SDK, Web Services, and SOA
Chapter 21 - Page 16
THESE eKIT MATERIALS ARE FOR YOUR USE IN THIS CLASSROOM ONLY. COPYING eKIT MATERIALS FROM THIS COMPUTER IS STRICTLY PROHIBITED
b.