Professional Documents
Culture Documents
Console
This document is for informational purposes only and is intended solely to assist
you in planning for the implementation and upgrade of the product features
described. It is not a commitment to deliver any material, code, or functionality,
and should not be relied upon in making purchasing decisions. The
development, release, and timing of any features or functionality described in
this document remains at the sole discretion of Oracle. Due to the nature of the
product architecture, it may not be possible to safely include all features
described in this document without risking significant destabilization of the code.
OVERVIEW ........................................................................................................................................................................... 7
RESOURCES ....................................................................................................................................................................... 58
You can navigate from Tools — Transaction Console for below work areas:
1. Transaction Summary (a.k.a. Transaction Manager)
2. Analytics
3. Approval Rules
4. Archived Transaction Summary
1 Transaction Manager
A tabular display of the transaction details with following columns:
1.1 Checkbox
You can select a transaction or select from the header for all transactions so to take an action.
1.2 Name
Object Name of the transaction. This hyperlink can be:
2. The Person Name for Promotion, New Work Relationship processes etc.
3. The Grade Name, a business object.
4. Same as the Process Name, such as Approve Job Requisition.
5. When click, you will open the transaction detail page. See 7 Transaction Detail for more info.
1.3 Process Name
It is the Name of the flow to which the transaction belongs. See the paper The Basics of Approval Rules 2 Process
Name for details.
1.7 Submitted By
Name of the requestor.
In the Personalize Saved Search: Default Criteria popup, the default filters are checked. Those unchecked are
advanced filters, see 2.10 Advanced Filters. You can reorder, enable or disable filters and click Save when done.
See What’s New for How-to personalize saved searches, also 2.11 Saved Search.
2.6 Name
A text field where you can enter the string to find a match by scanning through the transaction summary.
2.8 Submitted By
Submitted By text field accepts full or partial Display Name, having all transactions from one user available at a
glance.
2.10.5 Assigned To
This filter accepts a partial name and returns the transactions based on the person to whom the transaction is
currently assigned to, and then populates the display name onto the Approver column in Transaction Manager.
2.10.6 Approver
This filter returns the transactions either completed or in progress status that have been approved or rejected by said
user. Note: This text field accepts username only, because display name will incur system performance issue.
2.10.7 Submitted By
2.10.8 Search Comments
Available to failed transactions, Admin user can click Actions for the Add Comments option. Thereafter you will
have the ability to search by service request or bug or helpdesk ticket number.
2.10.10 Transaction ID
The text field accepts multiple Transaction IDs, which are separated by a comma. There can be cases where users
are required to perform mass actions on bulk transactions.
Actions Withdraw Recover Reassign Add Terminate Approve Reject Override Resubmit
Status Comment Approval
AUTO see 3.6 Resubmit
RECOVERY
COMPLETED based on
status and
profile options
DRAFT
SUBMITTED
On multiple selection of checkboxes in the transaction table, the least common set of actions (applicable for the
selected transactions) are rendered. Be cautious when considering mass action, you should evaluate each transaction
individually for the most appropriate action.
Note: An error will be thrown for an action selected in TAC of which task level action is disabled in BPM task
configuration.
3.1 Reassign
To change the Assignee, the Reassign action is available for an inflight transaction. Two options you can choose:
3.2 Withdraw
The Withdraw option will pull out the transaction from current assignee and mark the transaction as completed
(equivalent to Cancel and End). The exact Withdraw action in BPM Worklist.
3.3 Recover
The Recover action is available to a failed transaction in case of a BPEL failure. When the transaction is recovered, its
status will change back to Pending. If recover is complete without correction, the transaction retains its failed status;
in this case the existing issue record is closed with a new issue record created for the transaction.
Add SOA operator Role (SOAOperator) or SOA Admin Role (SOAAdmin) to your user account or the SOA-operated
Recover action will not work.
By ending the transaction, the requestor can then resubmit a fresh one. In some cases, this action can unlock a page
in read only mode amid approval pending queue, such as Approve Performance Goal.
Post Terminate Process action, the transaction will be marked as completed. Hence this action is not available to a
transaction which is already in a completed status.
Add SOA operator Role (SOAOperator) or SOA Admin Role (SOAAdmin) to your user account.
From 21A onwards, Resubmit option is also available to transaction with either Withdrawn/Expired/Rejected status
providing that both profile options HCM_TAC_RESUBMIT_ACTION and
HCM_TAC_RESUBMIT_FOR_ALL_NON_APPROVED are enabled.
3.7 Download
You can export the transaction summary into csv file via the Download action. Either selectively check the
transactions or no checkbox selection for a full download. The csv file contains additional information that you will
need for troubleshooting:
Name|Header|Status|Process Name|Submitted On|Issue Assignee|Submitted By|Transaction ID|Approvers|Assigned
On|Issue Title|Issue Type|Issue Date|Issue Description|Resolution|Task|Rule|Comment
See 2 Process Name in The Basics of Approval Rules (Doc ID 2430452.1) for more details.
6 Refresh On Demand
Users can click once the Refresh icon to initiate the process on Transaction Summary landing page. New statuses will
automatically be shown, definitely no need to constantly press for refreshes.
Also see 8.1 Refresh Transaction Administrator Console Transaction Status and 8.1.1 Opt In Feature for more
details.
Status: status of the transaction, also see 1.3 Status for info.
Process Name: the process name to which the transaction belongs, also see Appendix A Process Names vs. BPM
Tasks in The Basics of Approval Rules.
To make Future Approvals invisible because of confidentiality reasons and system performance issue, create
profile option DISABLE_ADVANCED_TAC_FUTURE_APPROVALS_DISPLAY and set its value to true.
All the Comments and Attachments submitted by Initiator or Approver or both will be shown in "Comments and
Attachments" component regardless of which state the transaction is in. User's Display Name printed.
• Comments are stored in plain text format.
• URL attachment is a redirect link, which will open in a new tab.
• Document attachment displays as file attachment downloader link.
Note: Comments and Attachments component is not available to failed transactions.
Issue Comments: showing comments added by Admin User of the latest issue associated with the transaction.
Also see 2.10.8 Search Comments.
Note: The View Transaction History, available to non-bypass approvals, is disabled when the transaction has Bypass
Approvals enabled. Also see 7.3 Interaction with Events in Transaction History Timeline.
This timeline component captures and represents the following events as a part of transaction summary till date:
Submission: This event represents the date and time of the submission of the transaction. This is the first event
represented in the timeline.
Error: This event represents any fault that has been encountered in the transaction at any time during the flow of
it. This event in the timeline can be interacted with. Click an event to see the error details in the segment above the
timeline component. This will show all the relevant information regarding the error that occurred, along with the
link to download the diagnostic logs.
Assigned To: This event represents the tasks that are assigned to users as apart of approval rules.
Approved / Rejected: This event represents the approve/reject events on the transaction by the approvers.
Reassigned To: This event represents the reassign activity performed on the transaction. It shows the username
by whom it was reassigned and to whom it was reassigned along with the time of the event.
Withdraw By: This event represents any withdrawal action performed on the transaction. It shows the username
by whom the withdrawal was performed along with its date.
Terminated: This event represents any terminate action performed on the transaction. It shows the username by
whom the terminate action was performed along with its date.
Acquired: This event represents any tasks that were acquired by a particular user for a specific transaction.
Resubmitted: This event represents any resubmit action performed on the transaction along with the username
by whom the activity was performed.
Completed: This is a terminal event and is generated only for transactions that have moved to completed state
along with the date of completion.
7.2.1 Instructions
Each issue has a downloadable Diagnostic Log file which includes comprehensive information about the error for
debugging purposes.
Real-time data is generated via the Console Fault Details framework. To provide precise messages, the Fault Payload
is parsed and checked for useful information to supersede the seed messages:
Error Diagnostic Report (aka Diagnostic Log): downloadable for issue resolution.
Color Legend: problematic ruleset is printed in red for prompt attention; correct ruleset in green.
Following screen displays the page content on selection of an error event. Details of the corresponding error is
rendered in the section above transaction history, which includes the issue description, resolution along with the
diagnostic log:
This 22B new feature provides a way for Admin users to make guided corrections to TXN Cache in the front end. You
must first raise SR to work with Development for the exact fixes.
(Navigation) FSM > Search: Task: Manage Administrator Profile Values > Search
Profile Option Code Site Level
HCM_EDIT_DATA_CACHE_ENABLE TRUE or FALSE
b. Warning: You're trying to edit the data cache of this transaction again. The changes you make will
overwrite the pervious changes. Continue anyway?
d. Enter Xpath, corresponding info populates alongside Edit Node and Cancel buttons.
f. Click OK to close.
g. Scenario: Warning is raised when the Xpath or Node isn’t valid. Click Yes to proceed.
k. Scenario: When the Xpath contains PII, Current Value is concealed; New Value and Data Type are
protected from update.
l. Scenario: Error
You specified an incorrect path for the node. Try again after entering a valid path.
This process updates the status of a transaction in the Console and can be run on demand by clicking the Last
Refresh icon. It is now delivered with a default schedule to run every hour out of the box to update all transactions to
their current state and trigger Alert Initiator on Error, see the Approval Rules tab. Note: the new ESS job will cease
to run when an existing schedule is detected.
To enable the Refresh ESS job to update IN PROGRESS transactions to AUTO RECOVERY, create and disable the
profile option TAC_ESS_DISABLE_AUTORECOVERY; set to TRUE to disable Auto Recovery check of the
transactions.
To enable the logging of the details of transactions that has been processed, create and enable the Profile Option
TAC_ESS_DETAILED_LOG which needs to be set to true for enabling the detailed logging of the transactions.
The TAC Refresh process will move the underlying state of all transactions to their current state. Possible status
changes that are handled by the ESS job are as follows:
In the event of transactions getting faulted because of any reason such as invalid user, server errors etc., the
Refresh converts these pending transactions to ERRORED state.
When the faulted or ERRORED transactions are recovered or rectified, these transactions are then identified by
Refresh and the ESS job moves the state of the transactions back to IN PROGRESS.
In the event of any transaction getting approved or rejected or terminated or withdrawn or the transaction getting
completed, the Refresh identifies such transactions and moves their status to COMPLETED.
Once a transaction is submitted by user, the SOA server (which primarily checks and verifies the approvals)
processes the transaction. In event of any SOA server issue or any other issue due to which SOA server is not able
to process the transactions, the transactions then get STUCK. The Refresh identifies such transactions and moves
their states to STUCK.
When a transaction encounters a failure at SOA side and trying to recover from it, the Refresh identifies such
transactions and moves their states to AUTO RECOVERY.
Supported options:
Don't Archive: this option allows a process and all of its transactions to never be archived.
3 Months: this option is applied to a process and all of its transactions for which the completion date has aged
more or equal to 3 months, are eligible for the Archive/Purge process.
This ESS job is configured to archive and purge transactions based on:
Ageing: Completion date of a transaction has aged more than the Archive Period settings for that transaction
process (example, Promotion).
Task Criteria: All the tasks of a transaction have been purged via the Archive/Purge process, see How Workflow
Tasks Are Archived and Purged for more details.
Status: Transaction is in COMPLETED state.
The Archive Transactions Console Completed Transactions now includes a standard parameter where Admin
can check All or selective process names to be run on demand.
To render the additional Days option, create and enable profile option HRC_ARCHIVE_DAYS_SHOW.
Description Profile option to render Days parameter in Archive ESS Page scheduler
HRC_ARCHIVE_DAYS_SHOW True
Caution: Customers are strongly advised to schedule this process outside their peak hours on a daily basis.
Once the above defined conditions are met, transactions will be archived and will no longer be searchable in the
"Transaction Summary" Tab.
Note: The 20C What’s New Automatically Archive Workflow Tasks Once a Day ESS job (link) is a precursor of
the Archive Transaction Console Completed Transactions ESS job.
a. Log into OTBI (https://host:port/analytics), navigate to Catalog - Shared Folders - Custom - Human
Capital Management.
b. Create a new folder, in the Tasks container click Unarchive. Choose BPM_Worklist.catalog from your local
drive and click OK. On the uploaded BPM Worklist, click Expand. On HCM Dashboard, click Edit.
d. Just click Continue for a full report. See R13 Approval Notification Archive 13NOV17.xlsx from the same post
for sample output preview with setup data.
9.2 TAC_RESUBMIT_ALERT
Alert is sent to Initiator upon resubmission of a transaction. You can compose the Message Text using existing
tokens if required.
3. To change or duplicate the dashboard for different defaults and permissions, choose Copy.
5. Expand the folders for Transaction Summary. Click Open to verify that the dashboard continues to run.
6. To modify, return to the custom subfolder, locate the Transaction Summary and click Edit.
7. Select the Criteria tab for the subject area to proceed with changes.
15. Click Snippet for the Transaction Summary dashboard. Click E-Mail to share.
With audit support, this responsive Account Management page allows users manage delegations in addition to
security actions. See Role Delegation for further details. Note that Administrators can also set up approval
delegations for others.
You can download wftaskmetadata spreadsheet from Doc ID 2430452.1 and filter column R ‘Category’ to reveal the
default setting of tasks, see column C ‘Name’. Note: in current release there are 342 of 456 tasks without a category.
Users can select one of the predefined values, and click Save. The Delete option renders when the user clicks Edit.
Note: If multiple approval delegation rules on same category concurrently exist in the same time period but with
different delegate each, then the oldest relevant Approval Delegation Rule is to be executed.
The Category list of values are derived from the General tab of the Task in BPM Task Configuration.
If a task gets configured with a new category or a specific category in the table gets renamed, then a new category
would be visible to users.
Note: To remove a pre-existing category, it needs to be removed from every task it is associated to. One task can
only have one category, but one category can have multiple tasks grouped into it.
UI table view lists Object Name, Status, Process Name, Submitted On, Submitted By, Approvers, Completion Date and
Archive Date. You can download the CSV file in which you will find two additional columns:
Basic Details: This component appears at the top of details page with transaction's information of Status, Process
Name, Object Name with Transaction ID, Submitted On and Submitted By.
Approval History: This component not only shows the hierarchy approver(s) including the initiator's details, but
also when the transaction is configured to bypass approvals. For more info, see 7 Transaction Detail The
Approval History Component.
Comments and Attachment: This lists all comments and documents attached to a transaction by both
approver(s) and initiator. The physical copies are retained for inspection. For more info, see 7 Transaction Detail
Comments and Attachments.
Issue Comments: This lists all the comments that were attached to a failed transaction. For more info, see 7
Transaction Detail Issue Comments.
Timeline: As the name suggests, this component showcases all the transitions of a transaction through its
lifetime. For more info, see 7 Transaction Detail View Transaction History. Similar Example: see 7.1 Pending
and Completed Detail. Shown below is Bypass Approvals worked example.
You can create a transaction console security profile with name HCM Family Transaction Summary View All,
select HCM Family and ignore Category and Subcategory, or select Exclude Subcategory if necessary. See
hrc_arm_process_vl spreadsheet in Doc ID 2430452.1 for details.
13.2 Why am I not able to see all the status filters? Why am I not able to see the detailed Issue description and log files
on Transaction Details page for failed transactions?
Check your security access, whether Transaction Admin Console or Transaction Self-Service Console. For
Transaction Admin Console, your user account needs a data role for the delivered
ORA_HRC_HUMAN_CAPITAL_MANAGEMENT_APPLICATION_ADMINISTRATOR_JOB.
13.3 Why do I get this message: "The approval history is not available for this transaction"?
After the Terminate Process action, this message "The approval history is not available for this transaction"
appears in the transaction detail.
13.4 Why the Approver, Assigned To and Submitted By - Transaction Console Filters are not working as expected?
Submitted By filter: enter the parameter with either display name, first name, or last name.
13.5 Why we can get up to 500 transactions in the downloaded csv file?
It is a technical limitation that download action can only support up to a maximum of 500 transactions.
Streamline your download or use OTBI for reporting purpose.
13.7 Will the TAC Refresh process affects or holds or interrupts the inflight transactions?
The Refresh ESS job runs behind the scenes asynchronously, it neither interrupts any transaction from getting
created nor holds any TAC related processes from running.
13.8 Will the running of TAC Refresh process degrade system performance and impact user experience?
There should be no impact on TAC overall performance. Raise a service request for technical investigation if and
when necessary.
Transaction: a Record to represent a flow which transitions from initiation to termination states. Example, Hiring
an employee, Salary change etc.
BPM Task: a Task is a building block of a transaction which is created to handle the approval flow. A transaction
may have multiple tasks but a task will have only one transaction associated with it. In the case of parallel
participants, there will be a task associated with each participant.
Check Notification Mode, it is defaulted to All for enabling Bell and Email Notification types.
Note: Worklist Notification is always-on.
13.11 Why are Approval Notifications still pending in the Bell icon when already acted upon via email ?
Two types of notifications will populate onto the Bell icon: 1. Actionable, 2. FYI.
Only users open Bell then select either Approve or Reject action to complete transactions will automatically
dismiss and reduce the counts, else not. See How to Synchronize Bell Notifications to Email (Doc ID 2483741.1).
Users must select the Dismiss button on Bell or Show All option for Dismiss All button on Notifications page.
Also see 8.2.2 FYI Notifications Expiration Period.
13.13 What function privilege is needed to run ‘Synchronize Notifications in Global Header’ ESS job?
13.14 How often should 'Synchronize Notifications in Global Header' be scheduled to run?
Run this ESS job every 2 hours and it is restricted to process up to 500 records.
Implementation considerations:
None: user sees the task as many times as it is assigned to him or her.
Once per task: user only sees one time worklist task (or notification) in the task life cycle.
Note: Aggregation is available only when the assignees are from the same set. For example, if you assign a task
to user A and another to both user A and user B; then user A sees two separate tasks. The two assignments are
not aggregated because the assignees are not exactly the same.
13.16 Why we are seeing wrong approver in approval history when using ‘prohibit user self approval’ feature?
Approval history will display future approvers according to the defined approval rules. During task assignment,
it will evaluate the user against 'prohibit user self approval' to determine and skip sending approval notification.
Check Task Owner (non-configurable attribute), revert to 'FUSION_APPS_HCM_ADF_APPID' for HCM workflows.
1. SOA Purge Details of a Software as a Service (SaaS) Fusion Apps Environment (Doc ID 2175534.1)
3. Oracle HCM Cloud Configurable Notifications and Subject Lines (Doc ID 2331021.1)
7. Recruiting Cloud: How to Format a Date in Alert Composer Notifications (Doc ID 2661442.1)
9. Learning Cloud: How To Exclude Terminated Employees From Receiving Alert Notification (Doc ID 2727552.1)
10. Learning Cloud: Users Receive a Duplicate Resource Alert Email that Begins with FYI (Doc ID 2664565.1)
11. Oracle Talent Management Cloud List of Delivered Notifications (Doc ID 2234224.1)
Absence Management Approval Notifications with Preview in the Responsive Worklist Update 20A
Absence Management Area of Responsibility (AOR) Support for Absence, Update 20B
Disbursement and Donation Approvals
Absence Management Obtain Approval from the Line Managers of All Affected Update 20B
Assignments for an Absence
Absence Management Review Absence Plans, Future and In Progress Absences and Update 20B
Future Transactions Impacted Due to Local and Global
Transfers
Absence Management Route Work Schedule Assignment Approvals to the Update 21A
Appropriate Manager
Absence Management Plan Balances on Approval Notifications Update 22A
Applications Security Extending Regenerate Security Profiles for Transaction, Update 22A
Recruiting, and Payroll
Career Development Development Plan Approvals Request for Information Update 20D
Extended Request Feature
Career Development Configure Comments and Attachments for Development Plan Update 21A
Approval Transaction
Career Development Bypass Approvals for Specific Development Goal Conditions Update 21B
Career Development Define Expiration Policies for Development Goal Approvals Update 21B
Career Development Add Learning to a Development Goal When Approvals Are Update 21D
Enabled
Career Development Career Development Approval Transaction Aging Policy Update 21D
Career Development Simulate Development Goal Approval Rules Update 22B
Compensation Preview Salary, Individual Compensation Approval Information Update 20A
in the Worklist
Compensation Preview Worksheet Approval Information in the Worklist Update 20A
Compensation Individual Compensation Approval Notification Enhancements Update 20B
Compensation Individual Compensation Approval Notifications Can Show Update 20C
Input Values
Compensation Route Approvals Using Launching Assignment Hierarchy Update 20D
Compensation New Columns Added to Grade Step Progression Results Page Update 21B
and Transaction Report
Compensation Prevent New Individual Compensation Submission when Update 21B
Previous Submissions are Pending Approval
Compensation View Note Count In Approvals Task Update 21B
Compensation Update of Worksheet Approvals Task Update 22A
Compensation Change in Transaction Design Studio Show or Hide Regions Update 22B
Behavior for Change Salary
Call +1.800.ORACLE1 or visit oracle.com. Outside North America, find your local office at: oracle.com/contact.
Copyright © 2020, Oracle and/or its affiliates. All rights reserved. This document is Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be
provided for information purposes only, and the contents hereof are subject to change trademarks of their respective owners.
without notice. This document is not warranted to be error-free, nor subject to any other
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC
warranties or conditions, whether expressed orally or implied in law, including implied
trademarks are used under license and are trademarks or registered trademarks of SPARC
warranties and conditions of merchantability or fitness for a particular purpose. We
International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or
specifically disclaim any liability with respect to this document, and no contractual
registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open
obligations are formed either directly or indirectly by this document. This document
Group. 0120
may not be reproduced or transmitted in any form or by any means, electronic or
mechanical, for any purpose, without our prior written permission. Disclaimer: This document is for informational purposes. It is not a commitment to deliver any
material, code, or functionality, and should not be relied upon in making purchasing decisions.
This device has not been authorized as required by the rules of the Federal
The development, release, timing, and pricing of any features or functionality described in this
Communications Commission. This device is not, and may not be, offered for sale or
document may change and remains at the sole discretion of Oracle Corporation.
lease, or sold or leased, until authorization is obtained.