Oracle Mobile Self-Service Human Resources

Technical
&
Debugging
Reference Document

Author: Rajesh Mannai

Creation Date: 29-Sep-2018

Last Updated: 06-Oct-2018

Document Ref:

Version: 1.0

Organization: Oracle India Private Limited

Document Control

Change Record

Date Author Version Change Reference

29-Sep-18 Rajesh Mannai 1.0 Initial Version

Reviewers

Name Position

Prasanna Athota Development Manager

Siddesha Pujar Principal Software Engineer
Aneesh Nair Senior Principal Software Engineer

Audience

Name Position

12.1 & 12.2 Implementation Team

12.1 & 12.2 Customers

Disclaimer

In the images below and/or the attached document, user details / company name / address
email / telephone number represent a fictitious sample (based upon made up data used in
the Oracle Demo Vision instance). Any similarity to actual persons, living or dead, is /
purely coincidental and not intended in any manner.
Contents

Document Control ............................................................................................................................. 2

Objective ........................................................................................................................................... 4

Flow Chart ......................................................................................................................................... 4

Concurrent Requests ......................................................................................................................... 5

HR Data Full Sync for Mobile App ............................................................................................... 5

Populate Shared Tables for Person Search ................................................................................. 7

Populate Person Absence Details for Mobile .............................................................................. 8

Mobile SSHR Address Structure Synch........................................................................................ 9

My Information ............................................................................................................................... 10

Edit My Profile................................................................................................................................. 11

Organization Chart .......................................................................................................................... 12

My Directs and My Team ................................................................................................................. 13

Pending Approval and Approvals ..................................................................................................... 14

Pending Approval .................................................................................................................... 14

Approvals ................................................................................................................................ 14

Primary Address .............................................................................................................................. 15

Assignment History ......................................................................................................................... 16

Salary History .................................................................................................................................. 16

Absences ......................................................................................................................................... 17

Document of Records ...................................................................................................................... 18

Update Assignment ......................................................................................................................... 19

Business events ............................................................................................................................... 20

Subscribing to Business Events to Automatically – Synchronize Person Data ............................ 20

Subscribing to Business Events to Automatically - Synchronize Absences Data ......................... 21

Steps to Subscribe to Business Events ...................................................................................... 21

 Objective

The main objective of this document is to provide an overview of Technical Information about
the Oracle Mobile Self Service Human Resource App. This document provides an overview of each task
that needs to be completed in order to use the SSHR Mobile App.

This exclusive paper will help the users and the implementation partners to understand in
detail, the total app functionality. Also this will help in debugging whenever an issue raises.

Flow Chart

Install the Mobile Patches

Configure Menus and Functions

Configure Business Events

Configure Security Profile

Create / Grant Mobile App

Access Roles

Schedule / Run Mobile App

Concurrent Requests

Install the Mobile App

Login through App to Access

The detailed steps to perform the above is described in the below notes.

Oracle Mobile Self-Service Human Resources for Oracle E-Business Suite Release Notes(Doc
ID 2105189.1)
Technical Brief on Oracle Mobile Self-Service Human Resources App for Oracle E-Business SuiteDoc ID
2318231.1)
Concurrent Requests
There are Four Concurrent requests that need to be scheduled and executed in desired frequency
based on your business needs. This will populate to the light weight tables for Mobile Apps.

1. HR Data Full Sync for Mobile App

2. Populate Shared Tables for Person Search

3. Populate Person Absence Details for Mobile

4. Mobile SSHR Address Structure Synch (This is available from Version 7.0)

Note: 'HR Data Full Sync for Mobile App' should be run only after 'Mobile SSHR Address Structure
Synch'.

HR Data Full Sync for Mobile App

Program HR Data Full Sync for Mobile App

Short Name PER_DATA_FULL_SYNC_FOR_PER_DIR

Application Human Resources

Description Concurrent Program to Syn data for HR Mobile App

Executable Name PER_MOBILE_FULL_SYNCH_EXEC

Method PL/SQL Stored Procedure

Parameters No Parameters

Package per_mobile_utils.person_data_full_synch

Tables gets populated in this request:

PER_PERSON_DIRECTORY
PER_PERSON_DIRECTORY_TL

Tables used to get data

PER_ALL_PEOPLE_F
PER_PERSON_TYPE_USAGES_F
PER_ALL_ASSIGNMENTS_F
PER_PERIODS_OF_SERVICE
PER_PERIODS_OF_PLACEMENT
HR_LOCATIONS_ALL

PER_PEOPLE_EXTRA_INFO – Against the information type PER_MOB_DIR_SOCIAL_MEDIA

PER_PAY_PROPOSALS
PER_PAY_BASES
PER_ADDRESSES
PER_IMAGES
PER_PHONES

Overview of the Request

 This is the Core request for the Mobile App. The tables gets populated based on the below
conditions

o A Valid Person Data as of Current Date

o System Person Type for Persons in ‘EMP’ & ‘CWK’

o Assignment Type for Persons in ‘E’ & ‘C’

 With above conditions core table PER_PERSON_DIRECTORY & PER_PERSON_DIRECTORY_TL

will be populated.

 Top of these additional details like phone, address, images, social information, notes, tags
etc.. will be populated from their appropriate tables
Populate Shared Tables for Person Search

Program Populate Shared Tables For Person Search

Short Name PERSONSEARCH

Application Human Resources

Description Populates Person Search Security person list

Executable Name PERSEARCH

Method PL/SQL Stored Procedure

Parameters Concurrent Program Run Mode

Package HR_ENDECA_SECURITY.SUBMIT

Tables gets populated in this request:

PER_SHARED_PERSON_LIST
PER_SHARED_PERSON_LIST_STAGE

Tables used to get data:

PER_SECURITY_PROFILES
PER_SEC_PROFILE_ASSIGNMENTS
FND_USER
HR_ALL_ORGANIZATION_UNITS

Overview of the Request

1. Clears Shared Person List stage table.

2. First the request Populates PER_SHARED_PERSON_LIST_STAGE based on Static security profiles

with View All Flag as No

3. Then the request populates Static security profiles with View All Flag as Yes

4. Next the request populates data based on Dynamic Security in the Security Profiles

5. Finally, the request Populate to Main Table PER_SHARED_PERSON_LIST

Populate Person Absence Details for Mobile

Program Populate Person Absence Details For Mobile

Short Name HRMOBABS

Application Human Resources

Description Populate Person Absence Details For Mobile

Executable Name HRMOBABS

Method PL/SQL Stored Procedure

Parameters None

Package per_mobile_utils.sync_absence_data

Tables gets populated in this request:

PER_MOB_ABSENCE_DTLS
PER_MOB_ABS_ATTENDANCE_DTLS

Tables used to get data:

PER_ABSENCE_ATTENDANCES
HR_API_TRANSACTIONS (transaction_ref_table = 'PER_ABSENCE_ATTENDANCES')
HR_API_TRANSACTION_STEPS

Overview of the Request

1. This request initially clears all the data in lightweight tables related to Absences.
PER_MOB_ABSENCE_DTLS & PER_MOB_ABS_ATTENDANCE_DTLS

2. Now the request, fetches and populates Absences with Accruals and Without Accruals from Core
Tables into PER_MOB_ABS_ATTENDANCE_DTLS

3. With addition to that, the request populates data for absences already Taken, Planned and Not
Approved from HR_API_TRANSACTIONS table.

4. Finally, Total Values against each absence type is calculated and populated in
PER_MOB_ABSENCE_DTLS which is used to display as Dashboard against each employee
Mobile SSHR Address Structure Synch

Program Mobile SSHR Address Structure Synch

Short Name MOBILE_SSHR_ADDRESS_STRCT_EXEC

Application Human Resources

Description

Executable Name MOBILE_SSHR_ADDRESS_STRCT_EXEC

Method PL/SQL Stored Procedure

Parameters None

Package per_mobile_utils.POPULATE_ADDR_DDF_INFO

Tables gets populated in this request:

PER_MOB_ADDR_DDF_COL_DTLS

Tables used to get data:

FND_DESCR_FLEX_CONTEXTS for DESCRIPTIVE_FLEXFIELD_NAME='Address Structure'

FND_FLEX_VALUE_SETS
FND_DESCRIPTIVE_FLEXS_VL
FND_DESCR_FLEX_COL_USAGE_VL

Overview of the Request

1. This request populates PER_MOB_ADDR_DDF_COL_DTLS based on complete structure from

DFF for DESCRIPTIVE_FLEXFIELD_NAME='Address Structure'

2. This table will have complete structure of DFF like Segments Name, Value Set, Conditions
associated to it.

3. Based on this table details, Address Form in the App will be loaded dynamically.
My Information

This Feature loads complete detail about the logged in User. The Details that are available in
the system will be loaded here by default. Logged in user can go and Add / Update few of his own
details in ‘Edit My Profile’ page.

Tables used to fetch the above data

PER_PERSON_DIRECTORY
PER_PERSON_DIRECTORY_TL

TABLE NAME COLUMN NAME FIELD IN THE APP

PER_PERSON_DIRECTORY FULL_NAME NAME

PER_PERSON_DIRECTORY IMAGE PICTURE

PER_PERSON_DIRECTORY WORK_PHONE PHONE NUMBER

PER_PERSON_DIRECTORY EMAIL_ADDRESS EMAIL ADDRESS

PER_PERSON_DIRECTORY_TL LOCATION LOCATION

PER_PERSON_DIRECTORY_TL ORGANIZATION HEADER REGION

PER_PERSON_DIRECTORY_TL TITLE HEADER REGION

PER_PERSON_DIRECTORY_TL POSITION_TITLE HEADER REGION

PER_PERSON_DIRECTORY_TL GRADE_TITLE HEADER REGION

PER_PERSON_DIRECTORY_TL JOB_TITLE HEADER REGION

PER_PERSON_DIRECTORY_TL PEOPLE_GROUP_NAME HEADER REGION

PER_PERSON_DIRECTORY_TL LOCATION_ADDRESS LOCATION DETAIL

PER_PERSON_DIRECTORY SUPERVISOR_ID MANAGER

PER_PERSON_DIRECTORY SM1_ID / SM1_URL SOCIAL MEDIA DETAILS 1

PER_PERSON_DIRECTORY SM2_ID / SM2_URL SOCIAL MEDIA DETAILS 2

PER_PERSON_DIRECTORY SM3_ID / SM3_URL SOCIAL MEDIA DETAILS 3

Edit My Profile

The Update Icon will be available only against the My Information of the Logged in User. For
other Employees, you will be only able to View and not update.
Tables used to save the above data

PER_PERSON_DIRECTORY
PER_PHONES
PER_PEOPLE_EXTRA_INFO (INFORMATION_TYPE='PER_MOB_DIR_SOCIAL_MEDIA')
PER_IMAGES

Organization Chart

Organization Chart from the My Information Page will take to the Hierarchy Diagram. Directs and
Total at each level will be displayed in the Person Card...

 Directs – No.of Immediate Reportees ( 1 Level )

 Total – No.of Reportees ( nth Level )

You can keep drill down and view their information

Tables used to fetch the above data

PER_PERSON_DIRECTORY
PER_PERSON_DIRECTORY_TL
Directs and counts are calculated based on the supervisor id against each person id

My Directs and My Team

This Functionality is generally applicable for Supervisor/Manager. Tapping on My Team You can see
My Directs with a Hierarchy icon. This will be displaying immediate reportees of the logged in Person.
Tapping on that Hierarchy icon will change to My Team. This will be displaying the list of Employees
whom the logged in person can access based on the Security Profile Mapped.

My Directs : Direct Reportees of the Logged in Person

My Team : Employee List based on the Security Profile with Mobile Extension
Tables used to fetch the above data

PER_SHARED_PERSON_LIST
PER_PERSON_DIRECTORY
PER_PERSON_DIRECTORY_TL

Pending Approval and Approvals

Pending Approval

This will be listing the Pending Approval Transactions for the Logged in Person along with Errored
Transactions. No actions can be taken from this Function.

Approvals

This will be listing all the Pending for Approval Transactions that need to be / can be actioned by the
logged in Person.
Tables used to fetch the above data

HR_API_TRANSACTIONS
HR_API_TRANSACTION_STEPS
HR_API_TRANSACTION_VALUES

Primary Address

The Logged in Person can Add, View, Update his Primary Address through this Function. With the
Options of Update and Create, you can use similar to Correct or Update options available in the
Address PUI Forms.

Tables used to save the above data

PER_PERSON_DIRECTORY
PER_ADDRESSES
Assignment History

The Logged in Employee can see his/her Assignment History. From Employee Self Service
Responsibility, we can configure in such a way that Employees can only able to View the Assignment.
Only through Manager Self Service, Employees’ Assignment and Salary can be updated.

Tables used to fetch the above data

PER_ALL_ASSIGNMENTS_F

Salary History

The Logged in Employee can see his/her Salary History which is

Recorded through Salary Basis Form. From Employee Self Service

Responsibility, we can configure in such a way that Employees can

Only able to View.

Tables used to fetch the above data
PER_PAY_PROPOSALS

Absences

As like Address Function, Absences can also be created only by the Employee. Manager cannot
create Absences through Mobile behalf of his reportees. Clicking on Absences from the Springboard
( Menu) will take to the Page which displays all Absence Types available or eligible for this Person .
Against Each Absence Types, It will be showing the Total Number of Available, Taken and Planned
Leaves. Below to that, the history of Recent Absences will be listed.

Employee can Create Absences either from the Absences Page by clicking on the + icon . Also,
Employees can go to the particular Absence type detail card and click on + icon, so that a new record
page will be opened for that particular Absence Type . The page will load the columns based on the
Leave Type. For absences which is day based it will be loading only From and To Dates. For the
Absences which is hour based, it will load From and To Times

Tables used to fetch the data

PER_MOB_ABSENCE_DTLS
PER_MOB_ABS_ATTENDANCE_DTLS
Tables used to save the data

PER_ABSENCE_ATTENDANCES
PER_MOB_ABSENCE_DTLS
PER_MOB_ABS_ATTENDANCE_DTLS

Document of Records
Employees can create, view, update, and delete documents of record. Attachments in SSHR
mobile app do not support Browse and Upload file from device. Only Take Photo, Choose Photo, Text,
and URL are supported.

Tables used to fetch above data

HR_DOCUMENT_EXTRA_INFO

Tables used to save above data

HR_DOCUMENT_EXTRA_INFO
Update Assignment
Once you have access over the selected Employee, you have an Icon at the Right Corner,
clicking on that you have option to choose Update Assignment. Similar to the Self Service Pages, You
can Fill all the Details like Job, Position, Grade, Organization, Location and Manager. You can either
Update the Assignment based on a Particular Effective Date or chose the option when the Assignment
gets approved.

Tables used to fetch the above data

PER_ALL_ASSIGNMENTS_F

Tables used to save the above data

PER_ALL_ASSIGNMENTS_F
PER_PERSON_DIRECTORY
PER_PERSON_DIRECTORY_TL
 Business events
Subscribing to Business Events to Automatically – Synchronize Person Data
To enable automatic synchronization of person data between the desktop Oracle HRMS application
and the Oracle Mobile Self-Service Human Resources app, you must subscribe to the following
business events. If you do not enable the subscription, then the synchronization does not occur
automatically whenever the person data is updated.

To subscribe to business events, log in to the Oracle E-Business Suite Workflow Administrator Web
Applications responsibility and navigate to the Events page using the Business Events link.

Business Event Name PL/SQL Rule Function

oracle.apps.per.a.employee.create_employee per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.contingent_worker.convert_to_cwk per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.contingent_worker.create_cwk per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.person.update_person per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.person.delete_person per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.person.image.post.update per_mobile_utils.update_person_img_a

oracle.apps.per.api.phone.create_phone per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.phone.update_phone per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.phone.delete_phone per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.activate_cwk_asg per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.actual_termination_cwk_asg per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.activate_emp_asg per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.actual_termination_emp_asg per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.update_cwk_asg_criteria per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.update_emp_asg_criteria per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.set_new_primary_asg per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.set_new_primary_cwk_asg per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.update_cwk_asg per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.assignment.update_emp_asg per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.person.tags.post.update per_mobile_utils.update_person_tag_a

oracle.apps.per.api.contingent_worker.create_cwk per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.contingent_worker.create_cwk per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.contingent_worker.reverse_terminate_placement per_mobile_utils.synch_person_data_auto
 oracle.apps.per.api.contingent_worker.terminate_placement per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.ex_employee.actual_termination_emp per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.ex_employee.reverse_terminate_employee per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.person_address.create_person_address per_mobile_utils.synch_person_data_auto

oracle.apps.per.api.person_address.update_pers_addr_with_style per_mobile_utils.synch_person_data_auto

Subscribing to Business Events to Automatically - Synchronize Absences Data

To enable automatic synchronization of absences data between the desktop Oracle HRMS
application and the Oracle Mobile Self-Service Human Resources for Oracle E-Business Suite app,
you must subscribe to the following business events:

Business Event Name PL/SQL Rule Function

oracle.apps.per.api.person_absence.create_person_absence per_mobile_utils.synch_appr_abs_data

oracle.apps.per.api.person_absence.update_person_absence per_mobile_utils.synch_appr_abs_data

oracle.apps.per.api.person_absence.delete_person_absence per_mobile_utils.synch_appr_abs_data

Steps to Subscribe to Business Events

1. Login with the Responsibility: Workflow Administrator Web Applications

2. Administrator Workflow -> Business Events - > Query the Event Name:

For example “oracle.apps.per.api.employee.create_employee”

3. Click the Subscription Icon on the right

4. Click Create Subscription
System : Your instance information (i.e. XX.US.ORACLE.COM)
Source Type : Local
Event Filter : oracle.apps.per.employee.create_employee
Phase : 100 (this is based on business requirements)
Status : Enabled
Rule Data : Message
Action Type : Custom
On Error : Stop and Rollback.
4. Then click Next and enter the PL/SQL Rule Function as per_mobile_utils.synch_person_data_auto
Owner Name : Human Resources
Owner Tag : PER

Repeat these steps for each business event listed above.