Approvals experience reference
Summarize
Summary of Approvals Experience Reference
This reference provides essential information for configuring and optimizing the approval experience within ServiceNow, focusing on task configurations, role requirements, integration details, and mobile support. It is designed to help customers understand how to manage approvals efficiently across various modules and integrations, including Employee Center, SAP Concur, and Workday.
Show less
Default Task Configurations and Role Requirements
- Default approval tasks use sysapproval as the reference column with screquest and screqitem as reference tables.
- Configurations can be customized and extend the Employee Center To-do list.
- Users require the approvaluser or businessstakeholder roles to approve IT requests in Employee Center; this does not apply to HR approvals.
- Role validation is not enforced in Core UI16 due to broader platform implications.
- If approval To-dos are not visible, verify the user has the appropriate roles; the system filters approval tasks based on these roles.
- Task configurations fallback to parent tables or default configurations if child table settings are missing.
SAP Concur Integration
- Integration is supported via the snsapconcurspok plugin.
- A scheduled job runs daily to pull Concur reports, updating sync details and staging tables.
- Data transformation uses the Concur Report Transform Map.
- Approval records are created based on the Approver field and managed through the Pulled Integration To-do table.
Workday Integration
- Workday sends data via RAAS reports; only open requests appear on approvers' My Tasks.
- Approvals and rejections use an Integration System User (ISU) to protect approver credentials and sensitive data.
- Action comments reflect the approver's identity and action taken for audit and transparency.
- Limitations include handling delegation changes and potential duplicate entries in multi-level approvals due to ISU use.
- Attachments are limited to 12 MB maximum size.
- Several provided scripts allow customization and management of Workday approval records and purge processes.
- Proper user controls and privileges must be configured to secure sensitive data, especially for Compensation Change and Spend Authorization use cases.
- Data purge is recommended every 30 days to maintain data protection, with HR administrators having exclusive access to sensitive information.
Approvals on Mobile
- Only approvals in the sysapprovalapprover table appear in Now Mobile using the generic card UI.
- Mobile approval display can be disabled via the system property snmetodos.allapprovalsmobileenabled.
Out-of-the-Box (OOTB) Action Group
- Use the OOTB Approvals action group to enable standard approval actions like Approve and Reject.
- To display actions in the My Items widget, add the OOTB Approvals action group in To-dos Configuration under Employee Center Administration.
Additional Considerations
- Allows business units to include non-task tables in To-dos configurations via scripted extension points.
- Related forms and configurations support enhanced requests, activity setup, portal notifications, and user criteria management to further tailor the approval and request experience.
Use the following reference information for better approval experience.
Default task configurations
Use the following default task configurations available for approvals.- Request with sysapproval as reference column and sc_request as reference table.
- Requested item with sysapproval as reference column and sc_req_item as reference table.
Unable to see Approval todos
Ensure you have the approver_user or business_stakeholder roles to see the approval todos for the sc_request or sc_req_item items. In the _getClosureFunction() method of Script Include todoPageUtils:if (tableName == 'sysapproval_approver') {
if (!(gs.getUser().hasRole('approver_user') || gs.getUser().hasRole('business_stakeholder'))) {
var queryString = "sysapproval.sys_class_name!=sc_request^sysapproval.sys_class_name!=sc_req_item^NQsysapprovalISEMPTY";
grTask.addEncodedQuery(queryString);
}
} Fallback to parent table configuration
When the child table does not have task configuration, fallback is one level above its hierarchy and picks the task configuration of the parent table. When the task parent is not available, fallback is to the default configuration.
SAP Concur reference info
- All Concur actions are present in SAP Concur Spoke (sn_sap_concur_spok) plugin.
- Scheduled job Pull concur reports (sysauto_script) is triggered daily. This scheduled job internally calls the Concur Integration record from the Integration Source table (sn_hr_integr_fw_source) of the ESM framework.
- Schedule job runs and updates the record in the Concur Sync Details table (sn_ex_cnc_concur_sync_details) with latest timestamp.
- Concur reports from ServiceNow are synced in the Concur Expense Report Staging table (sn_ex_cnc_concur_report_staging).
- Reports from the Staging table are transformed in the Concur Expense Report table (sn_ex_cnc_concur_report) by the ESM framework. Use the transformation map Concur Report Transform Map in the Table Transform Map table (sys_transform_map).
- Approval record is created in the Pulled Integration To-do table (sn_hr_integr_fw_todo_inbound) based on the Approver field in the Concur Expense Report table.
Workday reference info
Use the following information for Workday integration.- Workday uses RAAS reports to send data to external system. For more information on RAAS and field-level info about leaves, timesheets, compensation, job change, job requisition, or leave of absence, see Workday HR Spoke.
- Only the open requests are displayed on the approvers My tasks page.
- Approval and rejection actions are performed using an Integration System User (ISU). ISU is a virtual user (and not an actual user) which helps in the safe-keeping of approver credentials. With the use
of ISU, approval and rejection records protect the sensitive data according to your configuration in Workday. For example,
- When John Doe, the approver enters time sheet approved as comment, the comment shown as
John Doe(john.doe@acme.com): Time sheet approved. - When John Doe performs the action Approve, a comment is added in Workday as
John Doe (john.doe@acme.com): Action – Approve. - When John Doe performs the action Reject, a comment is added in Workday as
John Doe john.doe@acme.com): Action – Reject. - When John Doe performs the action Reject with a comment-Request is not in compliance with company policy, two comments are added
John Doe (john.doe@acme.com): Action–RejectJohn Doe(john.doe@acme.com): Request is not in compliance with company policy.
- When John Doe, the approver enters time sheet approved as comment, the comment shown as
- Approve or reject actions are shipped out-of-the-box for all use cases.
- When an approval is delegated from one approver to another in Workday; report data source is not able to handle the delegation change such as delegated task and other delegation details.
- When a request requires a multi-level approval with level 1 approved in Workday and ServiceNow, you may see two entries for the same approval. This is a limitation with the ISU use.
- Attachments support a max limit of 12 MB. Ensure the attachment size is below 12 MB.
- Use the following scripts:
- WorkdayApprovalToDosClientUtilSNC: Retrieves records for the purge process in Workday approvals.
- WorkdayApprovalToDosHelperSNC: Contains constants related to Workday approvals.
- WorkdayApprovalToDosClientUtil: Extends WorkdayApprovalToDosClientUtilSNC and allows users to define custom code.
- WorkdayApprovalToDosHelperUtils: Extends WorkdayApprovalToDosHelperUtilsSNC and enables users to define custom code.
- WorkdayApprovalToDosHelperUtilsSNC: Provides functions for Workday approvals.
- Ensure you configure the right user controls and privileges for Compensation Change and Spend Authorization use cases. Only the authorized users can view the sensitive records and data from Workday.
- For data protection, use the default purge policy to delete data more often. By default, data purge happens after in 30 days.
- Ensure only the HR administrator [sn_hr_core.admin] has access to the sensitive information as explained in Remove HR Administrator role from IT System Administrators.
Approvals on mobile
Only approvals that are in sysapproval_approver table are shown using the generic card in Now Mobile.To disable the feature change the value of this sys_property: sn_me_todos.all_approvals_mobile_enabled to false.
OOTB action group use
Use the out-of-the-box Approvals action group to display the actions such as Approve and Reject. For more information, see Action framework.Additional information
- Click the URLs for additional information and context.
- Allow BUs to add non-task tables easily to the list in the To-dos or Task configuration reference tables by passing non-task tables as an array in the Scripted Extension Points. sn_hr_sp.TodoNonTaskTables, and sn_ex_sp.RefNonTaskTables.