Peoplesoft Integration Reference

PeopleSoft Components Certified for Integration with Oracle Access Governance

The PeopleSoft components that you can integrate with, depend on which configuration mode you are running your Orchestrated System in.

Certified Components in Authoritative Source Configuration Mode

Certified Components in Authoritative Source Configuration Mode
Component Type Component
System The versions of PeopleSoft HCM, ELM, and FSCM you can use as an authoritative (trusted) source of identity information for Oracle Access Governance are:
  • PeopleSoft HCM, ELM, or FSCM 8.9 with PeopleTools 8.49
  • PeopleSoft HCM, ELM, or FSCM 8.9 with PeopleTools 8.50
  • PeopleSoft HCM, ELM, or FSCM 9.0 with PeopleTools 8.49
  • PeopleSoft HCM, ELM, or FSCM 9.0 with PeopleTools 8.50
  • PeopleSoft HCM, ELM, or FSCM 9.0 with PeopleTools 8.52
  • PeopleSoft HCM, ELM, or FSCM 9.1 with PeopleTools 8.50
  • PeopleSoft HCM, ELM, or FSCM 9.1 with PeopleTools 8.51
  • PeopleSoft HCM, ELM, or FSCM 9.1 with PeopleTools 8.52
  • PeopleSoft HCM, ELM, or FSCM 9.1 with PeopleTools 8.53
  • PeopleSoft HCM, ELM, or FSCM 9.2 with PeopleTools 8.53
  • PeopleSoft HCM, ELM, or FSCM 9.2 with PeopleTools 8.54
  • PeopleSoft HCM, ELM, or FSCM 9.2 with PeopleTools 8.55
  • PeopleSoft HCM, ELM, or FSCM 9.2 with PeopleTools 8.56
  • PeopleSoft HCM, ELM, or FSCM 9.2 with PeopleTools 8.57
  • PeopleSoft HCM, ELM, or FSCM 9.2 with PeopleTools 8.58
  • PeopleSoft HCM, ELM, or FSCM 9.2 with PeopleTools 8.59

Certified Components in Managed System Configuration Mode

Certified Components in Managed System Configuration Mode
Component Type Component
System The versions of PeopleSoft PeopleTools you can use to manage PeopleTools-based PSOPRDEFN user profile records in PeopleSoft applications are:
  • PeopleTools 8.53
  • PeopleTools 8.54
  • PeopleTools 8.55
  • PeopleTools 8.56
  • PeopleTools 8.57
  • PeopleTools 8.58
  • PeopleTools 8.59
  • PeopleTools 8.60.05
  • PeopleTools 8.61.03
Note

If you are using PeopleTools 8.54, full reconciliation operation may not work as expected. Apply PeopleSoft Patch 21109998 using the following URL for this operation to work successfully:

https://support.oracle.com/

Certified Components in both Modes

Certified Components in both Modes
Component Type Component
System The versions of PeopleSoft HCM, ELM, and FSCM you can use in either Authoritative Source or Managed System mode are:
  • PeopleSoft HCM, ELM, or FSCM 9.1
  • PeopleSoft HCM, ELM, or FSCM 9.2
Database Oracle

PeopleSoft Components Required For Integration with Oracle Access Governance

Integration of PeopleSoft with Oracle Access Governance requires a number of components to be present in your PeopleSoft environment.

Ensure the following components are installed in your PeopleSoft environment:
  • Tuxedo and Jolt (the application server)
  • PeopleSoft Internet Architecture (PIA)
  • PeopleSoft Application Designer (2-tier mode)

Configure Oracle Database Schema User Account

To access the PeopleSoft database schema you will need to create a service account on the Oracle database supporting PeopleSoft.

  1. Log in to the Oracle database as a database administrator using SQL*Plus or similar. Create a service account using the following statements:
    create user <DBService Schema user account name> identified by <password>;
    grant create session to <DBService Schema user account name>;
    grant create synonym to <DBService Schema user account name>;
    grant create view to <DBService Schema user account name>;

    For example:

    create user psftagsvc identified by mypw;
    grant create session to psftagsvc;
    grant create synonym to psftagsvc;
    grant create view to psftagsvc;
  2. Grant permission to PeopleSoft schema components to the service account you created, where <PSFT> is the name of the PeopleSoft schema for your environment. The list of schema components is different for each PeopleSoft component (HCM, ELM, and FSCM).

    For PeopleSoft HCM:

    grant select on <PSFT>.PSOPRDEFN to <DBService Schema user account name>;
    grant select on <PSFT>.PSROLEDEFN_SRCH to <DBService Schema user account name>;
    grant select on  <PSFT>.PSCLASSDEFN to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_CURRENCY_CD_TBL to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_PERSONAL_DATA to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_PERSONAL_PHONE to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_EMAIL_ADDRESSES to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_JOB to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_JOBCODE_TBL to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_LOCATION_TBL to <DBService Schema user account name>;

    For PeopleSoft ELM:

    grant select on <PSFT>.PSOPRDEFN to <DBService Schema user account name>;
    grant select on <PSFT>.PSROLEDEFN_SRCH to <DBService Schema user account name>;
    grant select on  <PSFT>.PSCLASSDEFN to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_CURRENCY_CD_TBL to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_LM_PERSON_JOB to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_LM_PERSON to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_LM_PERSON_NAME to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_LM_PERSON_PHONE to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_LM_PERSON_ADDR to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_LM_PERSON_EMAIL to <DBService Schema user account name>;

    For PeopleSoft FSCM:

    grant select on <PSFT>.PSOPRDEFN to <DBService Schema user account name>;
    grant select on <PSFT>.PSROLEDEFN_SRCH to <DBService Schema user account name>;
    grant select on  <PSFT>.PSCLASSDEFN to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_CURRENCY_CD_TBL to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_PERSONAL_DATA to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_PERSONAL_PHONE to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_EMAIL_ADDRESSES to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_JOB to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_JOBCODE_TBL to <DBService Schema user account name>;
    grant select on  <PSFT>.PS_LOCATION_TBL to <DBService Schema user account name>;
  3. Logout of the database and reconnect as the service account you created. Create synonyms for the schema components to which you granted access.

    For PeopleSoft HCM:

    create synonym PSOPRDEFN for <PSFT>.PSOPRDEFN;
    create synonym PSROLEDEFN_SRCH for <PSFT>.PSROLEDEFN_SRCH;
    create synonym PSCLASSDEFN for <PSFT>.PSCLASSDEFN;
    create synonym CURRENCY_CD_TBL for <PSFT>.PS_CURRENCY_CD_TBL;
    create synonym PS_PERSONAL_DATA for <PSFT>.PS_PERSONAL_DATA;
    create synonym PS_PERSONAL_PHONE for <PSFT>.PS_PERSONAL_PHONE;
    create synonym PS_EMAIL_ADDRESSES for <PSFT>.PS_EMAIL_ADDRESSES;
    create synonym PS_JOB for <PSFT>.PS_JOB;
    create synonym PS_JOBCODE_TBL for <PSFT>.PS_JOBCODE_TBL;
    create synonym <PSFT>.PS_LOCATION_TBL for <PSFT>.PS_JOBCODE_TBL;

    For PeopleSoft ELM:

    create synonym PSOPRDEFN for <PSFT>.PSOPRDEFN;
    create synonym PSROLEDEFN_SRCH for <PSFT>.PSROLEDEFN_SRCH;
    create synonym PSCLASSDEFN for <PSFT>.PSCLASSDEFN;
    create synonym CURRENCY_CD_TBL for <PSFT>.PS_CURRENCY_CD_TBL;
    create synonym PS_LM_PERSON_JOB for <PSFT>.PS_LM_PERSON_JOB;
    create synonym PS_LM_PERSON for <PSFT>.PS_LM_PERSON;
    create synonym PS_LM_PERSON_NAME for <PSFT>.PS_LM_PERSON_NAME;
    create synonym PS_LM_PERSON_PHONE for <PSFT>.PS_LM_PERSON_PHONE;
    create synonym PS_LM_PERSON_ADDR for <PSFT>.PS_LM_PERSON_ADDR;
    create synonym <PSFT>.PS_LM_PERSON_EMAIL for <PSFT>.PS_LM_PERSON_EMAIL;

    For PeopleSoft FSCM:

    create synonym PSOPRDEFN for <PSFT>.PSOPRDEFN;
    create synonym PSROLEDEFN_SRCH for <PSFT>.PSROLEDEFN_SRCH;
    create synonym PSCLASSDEFN for <PSFT>.PSCLASSDEFN;
    create synonym CURRENCY_CD_TBL for <PSFT>.PS_CURRENCY_CD_TBL;
    create synonym PS_PERSONAL_DATA for <PSFT>.PS_PERSONAL_DATA;
    create synonym PS_PERSONAL_PHONE for <PSFT>.PS_PERSONAL_PHONE;
    create synonym PS_EMAIL_ADDRESSES for <PSFT>.PS_EMAIL_ADDRESSES;
    create synonym PS_JOB for <PSFT>.PS_JOB;
    create synonym PS_JOBCODE_TBL for <PSFT>.PS_JOBCODE_TBL;
    create synonym <PSFT>.PS_LOCATION_TBL for <PSFT>.PS_JOBCODE_TBL;
  4. Remain connected as the service account and create views to allow Oracle Access Governance to retrieve employee and person of interest (POI) information. There are two views, Job_data_view.sql for job data, and Personal_data_view.sql for personal data. These support the following features:
    • Enables reconciliation of employee data, including those employees who do not have a user profile in PeopleSoft.
    • Enables reconciliation of persons of interest (POI) such as contractors, where no PeopleSoft user profile is present.
    • Supports attributes such as multiple job profiles, and manager department hierarchy.
    • Allows for complex customizations when applying transformations during attribute reconciliation, such as having different attributes for employees versus POIs.

    You can download the latest version of these scripts from GitHub at https://github.com/oracle/docker-images/tree/main/OracleIdentityGovernance/samples/scripts/PEOPLESOFT/1.0.

    Note

    If you have used a previous version of Oracle Access Governance where these views have not been created then you will see an error on the next data load. To rectify this, create the views as described and resubmit your data load.
    Note

    Where a select field is set to null, you are able to substitute this with a value of your choice, allowing for customization of the view results.

Configure PeopleSoft Service Account Using Peoplesoft PIA Web Interface

Integrating with PeopleSoft requires connecting to the PeopleSoft application using a service account.

You can create a service user to use for connecting to the PeopleSoft application by performing the following steps.

  1. Invoke the Peoplesoft PIA Web interface in a browser and navigate to Permission Lists.

    People Tools → Security → Permission Lists

  2. Add a new value: AGCS_PERMLIST
  3. In the permission list add and assign access to the following Component Interfaces according to the values given in the table.
    Note

    For PeopleSoft ELM and FSCM, CI_PERM_LIST is not available. Assign access for CI_PERM_LIST only to a PeopleSoft HCM configuration.
    Component Interface Permissions
    Component InterfaceMethodMethod Access
    USER_PROFILE
    CancelFull Access
    GetFull Access
    CreateFull Access
    SaveFull Access
    ResetPasswordFull Access
    ResetPassword_AlphaFull Access
    SetPasswordFull Access
    SetDescriptionFull Access
    DELETE_USER_PROFILE
    CancelFull Access
    FindFull Access
    GetFull Access
    SaveFull Access
    ROLE_MAINT
    CancelFull Access
    FindFull Access
    GetFull Access
    CreateNo Access
    SaveNo Access
    CURRENCY
    CancelFull Access
    FindFull Access
    GetFull Access
    CreateNo Access
    SaveNo Access
    CI_PERM_LIST (PeopleSoft HCM only)
    CancelFull Access
    FindFull Access
    GetFull Access
    CreateNo Access
    SaveNo Access
  4. Navigate to Roles.

    People Tools → Security → Roles

  5. Add a new value: AGCS_ROLE
  6. Add AGCS_PERMLIST to the Permission List.
  7. Navigate to User Profile

    People Tools → Security → User Profiles → User Profile

  8. Add a new value: AGCSSA
    • Add Symbolic ID as SYSADM1.
    • Set and confirm the password.
    • Set ID Type as NONE.
    • From Roles, select AGCS_ROLE.
    • Save your changes.

Supported Configuration Modes for PeopleSoft Integrations

Oracle Access Governance integrations can be setup in different configuration modes depending on your requirement for on-boarding identity data, and provisioning accounts.

Supported Modes

PeopleSoft Orchestrated System supports the following modes:

  • Authoritative Source

    You can use PeopleSoft HRMS as an authoritative (trusted) source of identity information for Oracle Access Governance.

  • Managed System

    You can manage PeopleTools-based PSOPRDEFN user profile records in PeopleSoft applications including Role and Permission List assignments to these records.

Supported Operations When Provisioning To PeopleSoft

When you provision an account from Oracle Access Governance to PeopleSoft certain operations are supported.

The PeopleSoft Orchestrated System supports the following account operations when provisioning a user:
  • Create User
  • Update User
  • Change Password
  • Add Roles
  • Remove Roles
Note

Partial Data Load is supported for PeopleSoft HCM, but is not supported for PeopleSoft ELM or FSCM.

Default Supported Attributes

Oracle Access Governance supports the following default PeopleSoft attributes. These attributes are mapped depending on the direction of the connection, for example:
  • Data being ingested by Oracle Access Governance from PeopleSoft: User.PROP_FIRST_NAME will map to Identity.firstName
  • Data being provisioned into PeopleSoft from Oracle Access Governance: account.lastName will map to User.PROP_LAST_NAME
PeopleSoft HCM Default Attributes - Authoritative Source
PeopleSoft Entity Attribute Name On PeopleSoft Managed System Oracle Access Governance Identity Attribute Name Oracle Access Governance Identity Attribute Display Name
User EMPL_ID uid Unique Id
EMPL_ID name Employee user name
EMPL_ID employeeNumber Employee number
FIRST_NAME firstName First name
LAST_NAME lastName Last name
MIDDLE_NAME middleName Middle name
PREF_FIRST_NAME PreferredFirstName Preferred first name
EMAIL email Email
PHONE phone Phone
NAME_TITLE title Title
ORGANIZATION_NAME organizationName Organization Name
addresses addresses as entitlement Addresses
COUNTRY country
CITY city
STATE state
ADDRESS1 address1
ADDRESS2 address2
ADDRESS3 address3
POSTAL postal
jobData
EMPL_RCD employeeRecord
EFF_DT startDate
EFF_SEQ employeeSequence
DEPTID department
JOBCODE jobCode
SETID_JOBCODE setIdJobCode
JOB_TYPE jobType
JOB_TITLE jobTitle
POSITION_NBR positionNBR
PER_ORG perOrg
POI_TYPE poiType
SUPERVISOR_ID supervisorUid
HR_STATUS hrStatus
EMPL_STATUS emplStatus
FULL_PART_TIME fullPartTime
ACTION action
ACTION_REASON actionReason
LOCATION_CODE location
POSTALADDRESS postalAddress
STREET street
ADDRESS2 address
CITY city
COUNTY county
STATE state
POSTALCODE postalCode
COMPANY company
EMPL_TYPE emplType
EMPL_CLASS emplClass
OFFICER_CODE officerCode
BUSINESS_UNIT businessUnit
TERMINATION_DT terminationDate
END_DATE endDate
REPORTS_TO reportsTo
MANAGER_DEPARTMENT_CODES managerDepartmentCodes
MANAGER_DEPARTMENT_LEVELS managerDepartmentLevels
MANAGER_DEPARTMENT_TITLES managerDepartmentTitles
DESCRIPTION description
LASTUPDDTTM lastUpdateTimestamp
PeopleSoft ELM and FSCM Default Attributes - Authoritative Source
PeopleSoft EntityAttribute Name On PeopleSoft Managed System Oracle Access Governance Identity Attribute Name Oracle Access Governance Identity Attribute Display NameEmployee/User/Both
UserEMPL_IDuidUnique IdBoth
EMPL_IDnameEmployee user nameBoth
EMPL_IDemployeeNumberEmployee numberBoth
FIRST_NAMEfirstNameFirst nameEmployee
LAST_NAMElastNameLast nameEmployee
MIDDLE_NAMEmiddleNameMiddle nameEmployee
PREF_FIRST_NAMEPreferredFirstNamePreferred first nameEmployee
EMAILemailEmailEmployee
PHONEphonePhoneEmployee
NAME_TITLEtitleTitleEmployee
addressesaddresses as entitlementAddressesEmployee
COUNTRYcountry
CITYcity
STATEstate
ADDRESS1address1
ADDRESS2address2
ADDRESS3address3
POSTALpostal
jobData
EMPL_RCDemployeeRecord
EFF_DTstartDate
EFF_SEQemployeeSequence
DEPTIDdepartment
JOBCODEjobCode
SETID_JOBCODEsetIdJobCode
JOB_TYPEjobType
JOB_TITLEjobTitle
POSITION_NBRpositionNBR
PER_ORGperOrg
SUPERVISOR_IDsupervisorUid
EMPL_STATUSemplStatus
FULL_PART_TIMEfullPartTime
ACTIONaction
ACTION_REASONactionReason
LOCATION_CODElocation
COMPANYcompany
EMPL_TYPEemplType
EMPL_CLASSemplClass
OFFICER_CODEofficerCode
BUSINESS_UNITbusinessUnit
END_DATEendDate
REPORTS_TOreportsTo
DESCRIPTIONdescription
LASTUPDDTTMlastUpdateTimestamp
PeopleSoft HCM Default Attributes - Managed System
PeopleSoft Entity Attribute Name On PeopleSoft Managed System Oracle Access Governance Account Attribute Name Oracle Access Governance Account Attribute Display Name
User UserID uid Unique Id
UserID name User login
__PASSWORD__ password Password
EmailAddresses~EmailAddress~PrimaryEmail email Email
IDTypes~EMP~Empl_ID employeeId Employee id
IDTypes~CST~Set_ID customerSetId Customer set id
IDTypes~CST~Customer_ID customerId Customer id
IDTypes~VND~Set_ID vendorSetId Vendor set id
IDTypes~VND~Vendor_ID vendorId Vendor id
NavigatorHomePermissionList navigatorHomePermission Navigator home permission
ProcessProfilePermissionList processProfilePermission Process profile permission
RowSecurityPermissionList rowSecurityPermission Row security permission
PrimaryPermissionList primaryPermission Primary permission
UserDescription description Description
MultiLanguageEnabled multiLanguageEnabled Multi language enabled
SymbolicID symbolicId Symbolic id
UserIDAlias userIdAlias User id alias
LanguageCode languageCode Language
CurrencyCode currencyCode Currency
AlternateUserID alternateUserId Alternate user id
EffectiveDateFrom startDate Start date
EffectiveDateTo endDate End date
WorklistUser worklistUser Work list user
EmailUser emailUser Email user
ReassignWork reassignWork Reassign work
ReassignUserID reassignUserId Reassign work to
SupervisingUserID supervisingUserId Supervising user id
AccountLocked status Status
PeopleSoft ELM and FSCM Default Attributes - Managed System
PeopleSoft EntityAttribute Name On PeopleSoft Managed System Oracle Access Governance Account Attribute Name Oracle Access Governance Account Attribute Display Name
UserUserIDuidUnique Id
UserIDnameUser login
__PASSWORD__passwordPassword
EmailAddresses~EmailAddress~PrimaryEmailemailEmail
IDTypes~EMP~Empl_IDemployeeIdEmployee id
IDTypes~CST~Set_IDcustomerSetIdCustomer set id
IDTypes~CST~Customer_IDcustomerIdCustomer id
IDTypes~VND~Set_IDvendorSetIdVendor set id
IDTypes~VND~Vendor_IDvendorIdVendor id
NavigatorHomePermissionListnavigatorHomePermissionNavigator home permission
ProcessProfilePermissionListprocessProfilePermissionProcess profile permission
RowSecurityPermissionListrowSecurityPermissionRow security permission
PrimaryPermissionListprimaryPermissionPrimary permission
UserDescriptiondescriptionDescription
MultiLanguageEnabledmultiLanguageEnabledMulti language enabled
SymbolicIDsymbolicIdSymbolic id
UserIDAliasuserIdAliasUser id alias
LanguageCodelanguageCodeLanguage
CurrencyCodecurrencyCodeCurrency
AlternateUserIDalternateUserIdAlternate user id
EffectiveDateFromstartDateStart date
EffectiveDateToendDateEnd date
WorklistUserworklistUserWork list user
EmailUseremailUserEmail user
ReassignWorkreassignWorkReassign work
ReassignUserIDreassignUserIdReassign work to
SupervisingUserIDsupervisingUserIdSupervising user id
AccountLockedstatusStatus
rolerole as entitlementRoles

Default Matching Rules

In order to map accounts to identities in Oracle Access Governance you need to have a matching rule for each Orchestrated System.

The default matching rule for PeopleSoft orchestrated system is:

Default Matching Rules
Mode Default Matching Rule
Authoritative Source

Identity matching checks if incoming identities match an existing identity or are new

Screen value:

Employee user name = Employee user name

Attribute name:

Identity.userName = Identity.userName

Managed System

Account matching checks if incoming accounts match with existing identities.

Screen value:

Employee id = Employee number

Attribute name:

Account.UserID = Identity.uid

.
Note

If you have an existing orchestrated system created prior to support for employees/POIs then the account matching rule will display as User login = Employee user name. This should be modified to the value shown above, that is, Employee id = Employee number. When you next run your data load the new matching rule will be re-evaluated. During re-evaluation the account will be linked to the identity it matches using the new rule, else will be unmatched.