Professional Documents
Culture Documents
The Oracle PeopleSoft Connector is built on the Web Services Connector. Please refer to the TechNet
documentation for the Web Services Connector for additional information.
Summary
Features Supported variants
Connected data source versions Oracle PeopleSoft 9.1
Scenarios Object Lifecycle Management
Password Management
Operations Full import
Delta import (With custom code)
Export
Password Management
Schema Person/Employee
User
1. Permissions
HCSPNAVHP
HCPPALL
HCSPPRFL
HCDPALL
2. Roles
EOPP_USER
Employee
HCM Security Administrator
HR Administrator
PAPP_USER
PeopleSoft User
PeopleTools
Portal Administrator
Security Administrator
b. Next license agreement screen appears; click Yes to accept the terms and conditions.
c. The next screen prompts to specify the location for installing the default project. Specify the location:
%FIM_INSTALL_DIR\2010\Synchronization Service\Extensions and click OK.
d. The installation starts and the successful completion is reported. Click OK to exit setup wizard.
CI_USER_PROFILE_UP
CI_USER_PROFILE_UD
CI_USER_PROFILE_G
CI_USER_PROFILE_C
CI_ROLE_MAINT_UP
CI_ROLE_MAINT_UD
CI_ROLE_MAINT_G
CI_ROLE_MAINT_F
CI_ROLE_MAINT_C
CI_DELETE_USER_PROFILE_UD
CI_DELETE_USER_PROFILE_F
CI_CI_PERSONAL_DATA_UP
CI_CI_PERSONAL_DATA_UD
CI_CI_PERSONAL_DATA_G
CI_CI_PERSONAL_DATA_F
CI_CI_PERSONAL_DATA_C
CI_CI_JOB_DATA_UP
CI_CI_JOB_DATA_UD
CI_CI_JOB_DATA_G
CI_CI_JOB_DATA_F
CI_CI_JOB_DATA_EMP_C
Important:
There are few attributes that are defined for the default projects of each of the supported data source
These are mandatory for calling the BAPIs/CIs/APIs successfully.
Below is the list of these mandatory attributes:
Functions Attributes
CI_JOB_DATA taxLocationCode
CI_JOB_DATA_EMP
Workflows
A native CI in PeopleSoft is used to perform a single task. There are certain operations for which native
CIs are not available and hence the default project does not support them. But they can be configured
with the help of custom CIs by including them in the web service and then configuring the required
workflow. Following are the workflows that are supported for:
User Object
FIM Operation Implemented through native web service (CI) operation
Full Import Yes
Delta Import No
Export Add Yes (user can only be created without a password)
Export Delete Yes
Export Replace Yes
Set Password No
Change Password Not supported
Employee Object
FIM Operation Implemented through native web service (CI) operation
Full Import Yes
Delta Import No
Export Add Yes (Employee ID is provided by provisioning code)
Export Delete Yes
Export Replace Yes
Set Password N/A
Change Password N/A
Exposing Web Service in Oracle PeopleSoft HCM 9.1
Web Service Configuration Tool discovers the Web service through a WSDL (Web Services Description
Language) and retrieves its services, endpoints and operations (CIs) it provides. Services, endpoints and
operations (CIs) are used by the Web Service Connector to access the Oracle PeopleSoft server and
synchronize identities with Forefront Identity Manager (FIM) 2010.
For a web service to be discovered, it is first required to be exposed at the Oracle PeopleSoft 9.1. This
topic describes the process of exposing the web service from Oracle PeopleSoft 9.1 UI. You must
perform following activities to expose the web service at Oracle PeopleSoft server:
1. Checking the connectivity and status of LOCAL Gateway
2. Checking the configuration of PeopleSoft delivered Nodes
3. Checking the Service Configuration Setup
4. Checking Service Operation GETWSDL and Domain are Active
5. Provide permissions to Component Interfaces (CIs) in PeopleSoft
6. Creating CI Based Web Service
7. Creating Single Web Service
8. Exposing / Providing the Web Service
Click Advanced Properties Page, to review the LOCAL Gateway advanced properties. You can
choose to provide the encrypted password for the Application server and LOCAL Node and set
the flags for the Integration Broker log. You can encrypt the password in Password Encryption
utility just below the advanced properties file.
You must check the following things in the advance properties file:
1. Encrypted password: When you have encrypted the password you must then you must
enter the encrypted password in the section
ig.isc.serverURL=//<Host IP>:<Port>
ig.isc.userid=PS
ig.isc.password={V1.1}6O5vpwGxd5o=
ig.isc.toolsRel=8.51
ig.isc.PSFT_HR.serverURL=//<Host IP>:<Port>
ig.isc.PSFT_HR.userid=PS
ig.isc.PSFT_HR.password={V1.1}6O5vpwGxd5o=
ig.isc.PSFT_HR.toolsRel=8.51
In this example both the password for the application server and the Local Node are same
and encrypted.
2. Logging: In the Logging section of advance properties file you must check the logging level
is set to 2.
ig.log.level=2
3. Name and location of file used to output the message logs: It can be set to the same or
different file as error logs location. For ex:
ig.messageLog.filename=<drive>:/PSHOME/webserv/HRMS91/applications/peoplesoft/
PSIGW.war/msgLog.html
4. Name and location of file used to output error logs: It can be set to the same or different
file as message logs location. For ex:
ig.errorLog.filename=<drive>:/PSHOME/webserv/HRMS91/applications/peoplesoft/PSI
GW.war/errorLog.html
Open the node PSFT_HR by searching with Node Name. Enter Authentication Option as
Password, Node Password and Default UserID as PS. In the properties there is an application
server password PS, you can choose to encrypt this password using Password Encryption
utility.
Note: Default User ID, PS is the PeopleSoft User and must have access to permission list PTPT1200 to
invoke the web service operations.
You can confirm whether the logged on user (PS) has the permission list PTPT1200 assigned, by
following below steps:
Navigate through the path Main Menu >PeopleTools>Security> User Profiles > User Profiles
Search the User Id you have used to logon to PeopleSoft server and go to Roles tab. The list of Roles
must display the PeopleTools permission.
2. Go to Connectors Tab on the path Main Menu > PeopleTools > Integration Broker > Integration
Setup > Nodes and check the details.
3. Click Portal tab, and check the details.
4. Click WS Security tab and check the details.
Checking the PeopleSoft delivered Receiver Node
1. The receiver node in PeopleSoft is ANONYMOUS. It serves as the External node and is already
configured. You must check the configuration to confirm if there are any deviation from the
standard details, if yes then revert them back to the data in below shown example screens.
Navigate the path Main Menu > PeopleTools > Integration Broker > Integration Setup >
Nodes and open the node ANONYMOUS by searching with Node Name.
2. Enter Authentication Option as None and Default User ID as PS. ANONYMOUS is a PS delivered
external node.
Note: Default User ID PS is the PeopleSoft User and must have access to permission list PTPT1200 to
invoke the web service operations.
6. Go back to the Node Definitions tab and then enter values for External User ID and External
Password. Press enter and confirm password. In the end click Save.
Checking the Service Configuration Setup
1. Next step is to check the setup of service configuration. It is used to define the target Location
where the web service will be exposed.
Navigate the path
Main Menu >PeopleTools> Integration Broker > Configuration > Service Configuration
You must specify the target location as
http://<HostName>:<PortName>/PSIGW/PeopleSoftServiceListeningConnector
Main Menu > PeopleTools > Integration Broker > Integration Setup > Service Operations
2. Go to the Routings tab. You must specify the sender and receiver node. The Third Party System
(FIM) sends request to the server with the help of sender node i.e. ANY, representing below the
ANONYMOUS node.
3. In addition, you must also confirm that the PeopleSoft Application Server Domain Status is
Active. Navigate the path Main Menu > PeopleTools > Integration Broker > Configuration >
Quick Configuration
4. Click Domain Status on the above screen. The Status String will show ACT implies that the
Domain is active.
Provide permissions to Component Interfaces (CIs) in PeopleSoft
PeopleSoft Component Interfaces are defined to accomplish particular tasks utilized for managing the
User and Employee data. These pre-configured CIs are assigned to the user to whom a particular
permission is to be granted. Later these are packaged together in a web service and then exposed.
The User Id (PS) used to logon to the PeopleSoft Internet Architecture (PIA) must have access to all the
CIs. The steps to grant permissions to CIs are
1. Open the permission list associated with the User PS
2. Add the CI and provide Full Access to all the methods.
Main Menu > PeopleTools > Security > Permissions & Roles > Permission List
Open the desired Component Interface to grant the Permissions as “Full Access” for all the methods as
mentioned in the below screen examples. The same CIs must be opened.
USER_PROFILE
DELETE_USER_PROFILE
CI_PERSONAL_DATA
CI_JOB_DATA
CI_JOB_DATA_EMP
ROLE_MAINT
Creating CI Based Web Service
You must create a web service for each CI encapsulating the operations that web service is required to
accomplish.
1. Navigate the path
Main Menu > PeopleTools > Integration Broker > Web Services > CI-Based Services and choose the
CI to create web service.
USER_PROFILE
2. Select the CI and click Review CI Status.
3. Select the operations you wish to create and click Display Selected Actions.
4. Click Perform Selected Actions.
DELETE_USER_PROFILE
Select the CI and Press “Review CI Status”.
Select the operations which needs to created and press Display Selected Actions.
There can be cases where for particular CI, service already exists in the system. You can check the same
by clicking Review CI status.
Status shows Service exists.
In case service does not exist, follow the wizard steps as shown above for the User Profile CIs.
CI_JOB_DATA
Status shows Service exists.
CI_JOB_DATA_EMP
Click Review CI Status.
ROLE_MAINT
4. Look out for the required existing Service operation and then click Search:
Select the operation and Save.
5. Again click Link Existing Operations” for adding next operation. Add all the operations you want to
link in the service.
Save the service.
Inside the web service, open each service operation by clicking the service operation link one by
one:
Check and follow the following 3 steps:
1> Operation is Active and User/Password Required check box is checked. User/Password
Required is used to implement the Basic Authentication.
2> Routings are Active
3> Provide Service operation Security
All the web operations must be provided the security permission list of PTPT1200, in order the
User PS to access/invoke all the web operations successfully.
New Pop Up window will get open, add Permission List “PTPT1200” and give “Full Access”.
Save.
Return to the web service from the service operation by clicking the link “Return to Service”.
Follow the above 3 steps for all the service operations present inside the web service you
created one by one.
You can verify that all the operations have permission list PTPT1200 by opening the same:
Open “Web Services” link:
You can see the name of your web service. Open “Edit”: All the service operations should be
there with Full Access.
Press OK and save the Permission List.
Create the output record of Type, SQL Table in the Application designer.
As per the requirement, you need to load view with the EMPLID along with the last updated Date
Time (the EMPLID gets updated if there is change in Job data, personal details, name, address etc.).
d. Press, Click to open SQL Editor and paste the following SQL code snippet to load the view. This
view will retrieve the last updated dat-time and emp id from all the employee related tables.
Code:
b. Enter the input message name created in application designer, by entering the Type as Rowset
and Message Name. Click Add.
c. Click Add Record to Root link and specify input record you created.
d. Click OK. The system will redirect you to previous page.
e. Click Save.
Creating the Response message in PeopleSoft / Pure Internet Architecture (PIA)
a. Logon to PIA and navigate the path Main Menu > PeopleTools > Integration Broker >
Integration Setup > Messages. Click Add a New Value.
b. Enter the output message name created in application designer, by entering the Type as Rowset
and Message Name. Click Add.
c. Click Add Record to Root link and specify output record you created.
Specify:
Operation Description, Version description and tick the check box for “Generate Any-to-Local”. Also
provide with the Request and Response message name. Save the service operation.
“Return to service” and save the service.
HANDLER/CUSTOM CODE
In the Application designer, create the Application package for writing the custom code for processing
according to i/p received and generate the o/p:
importPS_PT:Integration:IRequestHandler;
class CUST_EMP_CLASS1 implements PS_PT:Integration:IRequestHandler
method CUST_EMP_CLASS1();
methodOnRequest(&message As Message) Returns Message;
end-class;
/* constructor */
method CUST_EMP_CLASS1
%Super = create PS_PT:Integration:IRequestHandler();
end-method;
methodOnRequest
/+ &message as Message +/
/+ Returns Message +/
/+ Extends/implements PS_PT:Integration:IRequestHandler.OnRequest +/
Local Rowset&rs;
Local Message &MSG;
Local string &RES_EMP, &STR;
&rs = &message.GetRowset();
Local string &UPD = &rs.GetRow(1).GetRecord(Record.CUST_EMP_IN1).LASTUPDDTTM.Value;
Local SQL &sql = CreateSQL("Select EMPLID from PS_CUST_EMP_VW1 where (JOB_UPD > :1)
OR (PER_UPD > :2) OR (NAME_UPD > :3) OR (ADDRESS_UPD > :4) OR (PERSONAL_UPD > :5)
order by EMPLID", &UPD, &UPD, &UPD, &UPD, &UPD);
While &sql.Fetch(&RES_EMP)
&BOTH.Push(&RES_EMP);
End-While;
Specify any name for Handler; provide the Type, Implementation & status as shown above.
Click “Details” link and on the page specify the handler description, package name, path, class ID &
method as shown below:
importPS_PT:Integration:IRequestHandler;
/* constructor */
method CUST_USE_CLASS1
%Super = create PS_PT:Integration:IRequestHandler();
end-method;
methodOnRequest
/+ &message as Message +/
/+ Returns Message +/
/+ Extends/implements PS_PT:Integration:IRequestHandler.OnRequest +/
Local Rowset&rs;
Local Message &MSG;
Local string &RES_EMP, &STR;
&rs = &message.GetRowset();
Local string &UPD = &rs.GetRow(1).GetRecord(Record.CUST_USE_IN1).LASTUPDDTTM.Value;
Local SQL &sql = CreateSQL("SELECT OPRID FROM PSOPRDEFN WHERE LASTUPDDTTM >= :1
ORDER BY OPRID", &UPD);
While &sql.Fetch(&RES_EMP)
&BOTH.Push(&RES_EMP);
End-While;
For a web service to be discovered, it is first required to be exposed at the Oracle PeopleSoft 9.1. To
perform the complete process of exposing web service in Oracle PeopleSoft server, see Exposing Web
Service in Oracle PeopleSoft 9.1
Performance Testing
Scale Topology Hardware
10,000 User Two servers FIM Server Hardware Configuration:
objects data
FIM Synchronization Service and 2-gigabyte (GB) SDRAM
10,000 Person FIM Synchronization database
objects data collocated on one server (FIM Intel® Xeron® 2.27GHz
Server). Processor
o Single volume
Note: The server hardware used is not representative for a large organization. The numbers presented
should be used to understand the difference between different operations. You are encouraged and
expected to configure your own test environments to more accurately estimate capacity and performance.
Microsoft cannot guarantee that organizations will experience the same capacity or performance
characteristics, even if the FIM Synchronization service components are deployed and configured
identically to the components that are described in this guide,
The tests and results shown in the following table were performed using scripted provisioning code.
Elapsed time
Operation Statistics Rate
(minutes: seconds)
PeopleSoft 58:21 Total Imported users: 2.85 objects read/
Connector 10,000 second
Full Import
(User Object)
PeopleSoft 312:07 Total Imported Persons: 0.53 objects read/
Connector 10,000 second
Full Import
(Person
Object)
PeopleSoft 255:37 Update: 10,000 Users .65 objects updated/
Connector second
Delta Import
(User Object)
PeopleSoft 305:49 Update: 10,000 Persons 0.55 Objects updated/
Connector second
Delta Import
(Person
Object)
PeopleSoft a) 436:18 a) Adds: 10,000 Users a) 0.38 Objects
Connector b) 255:37 b) Update: 10,000 exported /
Export (User c) 2730:27 Users second
Object) c) Delete: 10,000 b) .65 Objects
Users updated/
second
c) .06 Objects
deleted /
second
PeopleSoft a) 268:49 a) Adds: 10,000 a) 0.62 Objects
Connector b) 305:49 Persons exported/
Export c) 464:15 b) Update: 10,000 second
(Person Persons d) 0.55 Objects
Object) c) Delete:10,000 updated/
Persons second
b) .36 Objects
deleted /
second
Reference information