Professional Documents
Culture Documents
10 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
10.1 Scenario 1: SAP Cloud for Customer stops responding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
10.2 Scenario 2: Employee not replicated to SAP Cloud for Customer or to SAP Jam. . . . . . . . . . . . . . . . 52
10.3 Scenario 3: SAP Cloud Platform stops responding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
14 Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
14.1 Creating an OAuth2 authorization between SAP Cloud Platform and BiZx. . . . . . . . . . . . . . . . . . . . 65
14.2 List of Data Center URLs for configuring BiZx oData Destination. . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Before you start looking for information in this guide, you need to be sure you're looking in the right place.
This is the implementation guide for Employee Central Service Center. This guide is to help you
implement and set up your HR Help Desk ("Ask HR") for your system.
● Integration with SuccessFactors Employee Central using SAP HANA Cloud Integration
Provides integration of SAP Cloud for Service with SuccessFactors Employee Central Service Center for
employee replication.
● Employee Central Service Center
Provides information on how to use Employee Central Service Center.
This document describes changes to the Employee Central Service Center Implementation Guide for the
recent releases.
Q4 2019
November 08
Updated topics to include To improve the performance of AskHR add: Enabling ASK HR applica
information on the param
1. skipUserAttributesResolution=true in Additional Properties of tion on SAP Cloud Plat
eters to be added to im
Bizx_Odata destination and save it. form [page 35]
prove the performace of
2. getProviderUserRoles=false at the end of the URL in
AskHR. Enabling ASK HR on Suc
Provisioning Company Settings Enable Service Center
cessFactors Employee
Add-On and save it.
Central home page [page
40]
Updated a topic to include You can now view the Ask HR application in Bulgarian, Russian, Enabling supported lo
information on supported and Polish locales. cales from Provisioning
locales. [page 47]
Q3 2019
June 23
Added steps on configur- The admin has an option to hide the Priority field for the employ Enabling ASK HR applica
ing the Priority field for the ees by configuring some settings on the Destination Configuration tion on SAP Cloud Plat
ASK HR application page. form [page 35]
Removed "Enabling New The steps of this section are automated and so we removed it N/A
Extension Manager (Fiori) from the handbook.
on Provisioning" section
form the handbook
Added a missing step in To download the X509 Certificate you must enter the Signature Generating OAuth X509
"Generating OAuth X509 Algorithm as SHA256WithRSA. Key in SAP SuccessFac
Key in SAP SuccessFac tors [page 59]
tors" section
Q2 2019
April 23
The ASK HR application is Your employees can access the ASK HR application on their mo Configuring ASK HR appli
now available on mobile cation on mobile devices
bile device by downloading and installing the SAP SuccessFactors
[page 58]
Mobile app from the app store. This will allow them to create and
modify a ticket from the application on their mobile.
Updated the Upgrading To get the latest updates for the ASK HR application you must up Upgrading ASK HR to SA
ASK HR to SAPUI5 version grade to SAPUI5 version 1.60. PUI5 version (1.60) [page
(1.60) section 49]
Updated Enabling sup If SAPUI5 version is '1.60' then you must select the theme as SAP Upgrading ASK HR to SA
ported theme for SAPUI5 Belize (light flavor). PUI5 version (1.60) [page
version from Theme Man 49]
ager section
Q1 2019
Feb 2
Updated the Enabling New Added a URL field validation for enabling Custom External Module
Extension Manager (Fiori) Integration.
on Provisioning section
Q4 2018
November 2
Updated the Configuring While creating a new HR ticket from the ASK HR application, any Configuring the Service
the Service Catalog sec unmapped Incident Type configured in SAP Hybris Cloud for Serv Catalog [page 22]
tion ice system will be listed by default under any Service Category
that you select.
Note
These changes are
applicable post
b1811p5 (07/12/2018)
Replicating employee data Previously you could only replicate employee data using SAP Replicating employee data
by integrating SAP Hybris HANA Cloud Integration. Now, you can also replicate employee by integrating SAP Cloud
Cloud for Service with data using SuccessFactors- Integration Center. for Customer with Suc
Success Factors Employee cess Factors Employee
Central Service Center us Central Service Center us
ing SuccessFactors- Inte ing SuccessFactors- Inte
gration Center gration Center [page 28]
Updated name for SAP Updated SAP Hybris Cloud for Service to SAP Cloud for Service. Scenario 1: SAP Cloud for
Hybris Cloud for Service
Customer stops respond
ing [page 52]
Required Knowledge
[page 11]
Implementation Sequence
[page 13]
Configuring attachment
Types [page 18]
Q3 2018
August 10
Updated the values for As Updated the Urls based on data center locations.
sertion consumer serv
ice, Logout URL, and Au
dience URL.
There are some UI en To enable the same you must upgrade your application to SAPUI5 Upgrading ASK HR to SA
hancements made to the version (1.44 or 1.52). PUI5 version (1.60) [page
ASK HR application 49]
Added a section on ena For the UI changes to be processed completely you must select Enabling supported theme
the corresponding theme from the Theme Manager.
bling supported theme for for SAPUI5 version from
SAPUI5 version from Theme Manager [page
Theme Manager 50]
Added a note for selecting If you enable the Arabic language as the locale preference then Enabling supported lo
the Arabic language as you must upgrade your SAPUI5 version.
cales from Provisioning
your locale preference
[page 47]
Added navigation steps to Some configuration scenarios are captured in the best practices Configuring Service Sce
access the best practices content for ASK HR application. narios [page 17]
content
Updated "Integrating SAP Added steps on creating a sub-account in SAP Cloud Platform
Cloud Platform with Suc Cockpit.
cessFactors Employee
Central through exten
sions" section
Created a new section The HR agent can add internal notes to a ticket to find more infor Adding internal notes to a
"Adding internal notes to a mation on it from a peer or supervisor. ticket in SAP Cloud for
ticket in SAP Hybris Cloud Customer system [page
for Service system" 34]
SuccessFactors Employee Central Service Center provides a comprehensive solution to HR service delivery.
The solution is designed for use by both employees and HR service delivery. Employee Service delivery is
provided via the ASK HR (Employee Workspace) link, employees get answers to their questions from anywhere
within the SuccessFactors HCM Suite. Guidance is also available to HR service representatives/agents to help
them give accurate, consistent and quick answers to questions that employees can’t answer on their own.
● It enables employees to create and manage tickets and to access further information such as Knowledge
Base content and service center hotline data that helps them find the desired information through ASK HR
(Employee Workspace).
● It supports optional Knowledge Base integration.
● It allows HR Service Delivery through HR Service Representative/Agent Workspace enabling HR Service
representatives to manage open requests, view reports and collaborate on requests.
With the ASK HR (Employee Workspace) view, employees have access to a searchable, context-sensitive
knowledge base (if configured) for getting answers to their questions. If they can’t find the answer in the
knowledge base, they can contact their HR directly by:
Creating a ticket, or
Sending an e-mail
The ticket management system offers the right tool set to HR Service Representatives, ‘the Service Work
Center' where they have access to ticket queue and thus employee tickets get assigned to them.
Note
Information from the HCM suite, including Employee Central, is built-in (i.e. without having to access
multiple systems) enabling HR Service Representatives to resolve requests effectively. The HR Service
Representative has access to employee data in SuccessFactors Employee Central based on role-based
permissions. This also ensures the security of sensitive employee data. Having this data available in a
unified Service Center with easy-to-read dashboards, also provides HR Operations Management visibility
into the issues that are impacting employees. It provides actionable insights and helps them report on their
group's performance criteria such as SLA compliance.
We recommend that the consultant performing the implementation has the following implementation and
configuration knowledge:
In this section you prepare your project beyond any standard software implementation projects parameter.
● Align with your HR team and define the business processes/ functional scope for your ticketing system.
● Create a blueprint of your system landscape as per Employee Center Service Center. We only provide
○ one test SAP Cloud for Customer tenant and
○ one productive SAP Cloud for Customer tenant.
There is a 1:1 relationship between each SuccessFactors Employee Central instance and each SAP
Cloud for Customer instance.
Note
In case you use a third SuccessFactors Employee Central instance for development purpose, then you
must set up a third environment. In this scenario, ensure that you take into account that this requires
extra cost for setting up a third SAP Cloud for Customer tenant.
Describes the tasks to be completed before setting up Employee Central Service Center.
To set up Employee Central Service Center, you must first have the following prerequisites enabled in your
system:
Prerequisites Description
SAP SuccessFactors Employee Central instance. Ensure that your Employee Central instance is in place be
fore you start implementing Employee Central Service Cen
ter.
The following SAP Cloud for Customer tenants: 1. After you have purchased the Employee Central Service
Center solution, SAP will trigger the process for you to
1. Test Tenant test the SAP Cloud for Customer tenant. You (custom
2. Productive tenant ers S-user and email contact stored at purchase re
quest) will get an email with the SAP Cloud for Cus
tomer test tenant URL and a separate email with the
Cloud for Customer user (the S-user entered on the
purchasing request form automatically receives these
emails).
2. In general, the Project Team will trigger the provisioning
of an additional SAP Cloud for Customer tenant (also
Productive Instance).
Note
For any additional tenant requirement, you can
reach out to your sales team.
You (purchase request contact) will get an email with the ac
cess information and the customer account information.
The following steps are required to implement Employee Central Service Center.
Let's now see a brief comparison between the old and the new Employee Central Service Center.
ASK HR application includes the following to cover the ticket SAP SuccessFactors offeres a new Service Desk HTML5 ap
screens such as Create ticket, Ticket overview, Ticket de plication and owns new up-to-date tickets screens.
tails:
Integration:
● Service Portal application
Integration related to ticket data through consumption of
Integration: SAP Cloud for Customer OData APIs.
Employee Central data replication to SAP Cloud for Cus Employee Central data replication to SAP Cloud for Cus
tomer via P2P (not available anymore for new customers as tomer based on HCI.
of Q4 2016).
Customer project based integration to SAP Jam based on Standard Integration to SAP Jam Advanced Plus
OpenSearch.
Note
The Employee Central Service Center package does not
cover the pricing for SAP Jam.
Implementation Checklist
To configure SuccessFactors Extensions, you must first integrate SAP Cloud Platform with SuccesFactors
Employee Central through extensions. After the integration is done, you must enable New Extension Manager
(Fiori) on provisioning and also enable your ASK HR extension in Extension Manager.
Follow the steps stated in the following sections to configure SuccessFactors Extensions.
Note
If SAP SuccessFactors has IP restrictions defined in the IP Restriction Management tool, then the IP
ranges of the respective SAP Cloud Platform region should be added as well. To convert the IP ranges
of the respective SAP Cloud Platform region to a format expected by the IP Restriction Management
tool, use an IP calculator.
Related Information
IP Restriction Management
IP Ranges of SAP Cloud Platform Regions
After the new Extension Manager (Fiori) is enabled on provisioning, you need to enable your ASK HR extension
in Extension Manager and also assign the corresponding SuccessFactors role to access the Extension package.
Context
Results
Now the added members are the administrators for the customer extension module (Extensions admin).
To configure SAP Cloud for Customer, you must define functional scope for the Ticketing System, replicate
Employee Central master data to your SAP Cloud for Customer system and configure service scenarios.
● Define functional scope for the Ticketing System, Ticket Processing, Ticket Routing.
● Replicate the following Employee Central master data to your SAP Cloud for Customer system.
○ Personal details like first-name, last-name, gender, form of address.
○ Business email (required used as key identifier to fetch employees ticket information).
○ Business address & phone -> Workplace address in SAP Cloud for Customer.
○ Job information used to calculate the employee’s validity.
● Configure Service scenarios:
○ Covering the functional scope for ticket handling.
○ Customizing the employee support scenario in SAP Cloud for Customer, for example "How to enable
HR Representatives to access their workspace".
○ (optional) Configuring mashup with Employee Central for enabling agents to access the
SuccessFactors Employee Central system within their agent workspace.
You must follow the detailed guidelines on both these steps as mentioned in document.
Related Information
You must configure service scenarios to configure SAP Cloud for Service.
Context
Ensure that your employees can only upload attachments that obey security standards. There may be certain
file types that contain java script which may pose a security risk for your company. In general SAP Cloud for
Service runs a virus checker for each and every file that gets into the system. Also, all APIs go through the
same functionality. SAP Cloud for Service also provides a customizing option to specify allowed mime types/
file type. We recommend you to take out at least document types with a high security risk such as ‘html’ in your
SAP Cloud for Service tenant.
Procedure
Note
If the activity is not found in the list, choose All Activities from the drop down and search for this
activity and choose Add to Project
With regards to the Ticket status you have to configure the Ticket status schema exactly how it is described
here.
We need this because the new ASK HR UI interacts with the ticket status. This is why we need to know the
corresponding technical key and thus status.
● Administration privileges
● In your project scope, selected employee support under Node Service
Tickets always were sent forth and back between an employee and an HR agent. With this solution, we intent to
fix a simple scenario where only HR Agents are involved in ticket processing and we do not differentiate that HR
agents are multiple processors.
Procedure
Example
9. Click Add Row and select milestone: Due Date for Completion
10. Select Flag for Alert when Overdue option and Recalculate.
12. In Operating Hours Section add the Occurrence and Time range for your service level.
13. Choose Save and Change Status to Active and Close.
14. In previous step, Select Determine Service Level.
15. Click Add Row.
16. Click * to select the Ticket type and Service Level.
17. Maintain below condition for Service level and choose OK.
18. Choose Save.
19. Choose Action and click on Activate Rule. You can define Service level for another field as well. Click on
Adapt Column to add more field to Define Service Level.
Context
Procedure
You cannot add any new custom status code and we support only the status codes mentioned below:
Sort Sequence Status Life Cycle Status Assignment Status Initial Status Status Visible
Field Value
Service Category
Service categories are used to capture consistent information, to allow reporting and benchmarking, and for
determining service level assignments.
1. To create and organize service categories and incident categories (subcategories) within service category
catalogs, go to Administrator Service and Social Service Categories .
Note
Note you can only use Service Category and its dependent child Incident Category.
Note
The category type Incident is the subcategory of the Service Category type.
Example
From the table given below, Medical Health Plans and Allowance are the subcategories of Benefits
& Health.
In a scenario where we have an Incident type not mapped to a Service Category, then on selecting any
Service Category on the ASK HR application you will see the unmapped Incident type along with the
mapped Incident types.
Example
From the table given below, Reward & Benefits and Pay & Deductions are Incident types not
mapped to any Service Category. On the ASK HR application if you select the Service Category as
Benefits & Health then the following Incident types will be listed:
○ Medical Health Plans
○ Allowance
○ Reward & Benefits
○ Pay & Deductions
Incident Allowance
○ Leave
Incident Leave
○ Special Leave
○ Payroll
Incident Payroll
How Agents/HR Representative access the Employee Support Workspace can be configured in the SAP Cloud
for Service system. The work center ‘Employee Support’ is available under work center ‘Service’.
Note
Depending on your needs, you can also configure access to the Agent Workspace ‘Employee Support’ as
work center.
The following screen example shows the Agent Workspace with the Employee Support View.
How to Set-up the Employee Support work center: Business Role for HR Manager
1. Log on to your SAP Cloud for Service system with administrative privileges, and navigate to the
‘ADMINISTRATOR’ work center in General settings view.
2. Under Users, select Business Roles.
Analysis->Dashboard
7. Go to Access Restrictions tab, search for Employee Support work center and add Organization
Restriction by Selecting Restriction Rule as Define Specific Restrictions.
8. Add Restricted in Read access and Write Access dropdown for Employee Support.
9. Select Action → Activate.
10. Click Save and Close.
How to Set-up the Employee Support work center: Business Role for HR Service Agents
1. Log on to your SAP Cloud for Service system with administrative privileges, and navigate to the
‘ADMINISTRATOR’ work center in General settings view.
2. Under Users, select Business Roles.
After the SAP Cloud Platform extension account is created, you must verify the permission settings for SF API.
Context
Procedure
This section describes the steps required to replicate employee data by integrating SAP Cloud for Customer
with SuccessFactors Employee Central Service Center using SAP HANA Cloud Integration.
You must follow the detailed guidelines on replicating employee data as mentioned in https://help.sap.com/
viewer/9d1cadae7882412983d3453e7f7abf8a/latest/en-US/6d3a9d0323834d2fb4eb5267b7057536.html.
You can replicate employee data by integrating SAP Cloud for Customer with Success Factors Employee
Central Service Center using SuccessFactors- Integration Center.
1. Assign the necessary role-based permissions to all admins so that they can access and configure various
business scenarios.
2. Configure the SAP Cloud for Customer system to be able to enter the configured details while configuring a
business scenario.
3. Access pre-defined integration scenarios.
4. Monitor a configured business scenario through Execution Manager and Web Service Message Monitoring.
Assign the necessary role-based permissions to all admins so that they can access and configure various
business scenarios.
Context
An admin must be able to assign the new permission to the role in the Role-based permissions to access the
Business Scenarios page. The access required is controlled by certain role-based permissions and must be
assigned to required users, like admins, managers, employees and so on.
Procedure
1. Go to Admin Center Manage Permission Roles that directs you to the Permission Role List page.
2. Select the Permission Role group you want to edit that directs you to the Permission Role Detail page.
3. Select Permissions that opens up the Permission settings page.
4. Under Administrator Permissions Manage Integration Tools , select the option Access to Business
Scenarios.
5. Select Done to save, which direct you back to the Permission Role Details page.
6. Select Save Changes to finish.
You must configure the SAP Cloud for Customer system to be able to enter the configured details while
configuring a business scenario.
All detailed instructions required in configuring the SAP Cloud for Customer system are listed in the
Configuration Phase: Configure Integration in Cloud Solution section of the Prepackaged Integration with
SuccesFactors Employee Central handbook.
Related Information
Pre-defined integration scenarios are available on the Business Scenarios page, where you can configure some
fields and the remaining are read-only fields that are fixed by SAP SuccessFactors.
Context
Once the permissions to access the Business Scenarios tool is enabled form the Admin Center, follow these
steps to access the pre-defined integration:
Procedure
1. Go to Admin Center Business Scenarios that directs you to the Business Scenarios page. On this
page, you will see a list of scenarios.
2. Click ON to activate the EC employee replication to C4C for askhr scenario. To configure the scenario,
click OK. You will see a settings page with the following four tabs:
○ Options
○ Configure Fields
○ Filter and Sort
○ Destination Settings
○ Scheduling
○ Review and Run
3. On the Options tab, you set general options for the scenario you are trying to configure. For the
Destination Page Size you must specify the maximum number of employee records per output batch/
page. To know more about the settings on the Options tab, see Integration Center on the SAP Help Portal.
4. On the Configure Fields tab, you can edit the layout and field transformations for the integration scenario
output.
The following two fields are mandatory and must be configured to proceed further:
1. Message Header SenderParty InternalID
You must map this field to the System Instance ID (ID) field value which is configured in the
Communication System that you setup previously in SAP Cloud for Customer.
2. Message Header RecipientParty InternalID
You must map this field to the My System field value which is configured in the Communication
Arrangements that you setup previously in SAP Cloud for Customer.
To know more about the settings on the Configure Fields tab, see Integration Center on the SAP Help
Portal.
5. On the Filter and Sort tab, you can add filters of your choice for the integration data query. To know more
about the settings on the Filter and Sort tab, see Integration Center on the SAP Help Portal.
SOAP API URL URL of the SOAP service server which is configured in the
Communication Arrangements that you setup previously
in SAP Cloud for Customer.
7. On the Scheduling tab, specify how often the job is to run and enter the start date and time and (optional)
end date. To know more about the settings on the Scheduling, see Integration Center on the SAP Help
Portal.
8. On the Review and Run tab review your settings before you save, run, or schedule your scenario. To know
more about the settings on the Review and Run tab, see Integration Center on the SAP Help Portal.
Next Steps
After the configuration settings are made to the scenario, you can monitor that scenario in the Execution
Manager.
Related Information
Assign the necessary role-based permissions to all admins so that they can monitor integration scenarios in
Execution Manager.
Context
Follow the steps below to enable Execution Manager from Admin Center.
Procedure
1. Go to Admin Center Manage Permission Roles that directs you to the Permission Role List page.
2. Select the Permission Role group you want to edit that directs you to the Permission Role Detail page.
3. Select Permissions that opens up the Permission settings page.
4. Under Administrator Permissions Admin Center Permissions , select the following permissions, Read
Execution Manager Events and Read Execution Manager Event Payload or Event Report .
5. Select Done to save, which direct you back to the Permission Role Details page.
6. Select Save Changes to finish.
In Execution manager, you can monitor the status of executed integrations and those in progress. You can also
view useful error/log messages in the Execution Manager.
Context
To see the status of the business scenario integration you have run, you must launch the Execution Manager
Dashboard.
1. Go to Admin Center Execution Manager Dashboard that directs you to the Business Scenarios
page. On this page, you will see a list of scenarios. On the Execution Manager page you can view the
scheduled jobs displaying information on the jobs:
The Web Service Message Monitoring view allows you to monitor and process asynchronous incoming and
outgoing messages.
To know about Web Service Message Monitoring you must refer the SAP Cloud for Customer Set Up Guide.
Related Information
The HR agent can configure attachment types for Employee Central Service Center by selecting the
appropriate one in the SAP Cloud for Customer system.
On the ASK HR application an employee/HR agent can upload attachments as part of any conversation that
are relevant to a particular HR ticket.
However on the SAP Cloud for Customer system, the HR agent has an option to classify attachments based on
it's type. On the SAP Cloud for Customer system, the following attachments types are available:
If the HR agent selects the attachment type as "Internal Attachment" then that attachment will not be
displayed on the Employee Central Service Center application and the same will not be visible to the employee.
If the HR agent selects the attachment type as "Standard Attachment" then that attachment will be displayed
on Employee Central Service Center application and the same will be visible to the employee.
The HR agent can add internal notes to a ticket to find more information on it from a peer or supervisor.
For every HR ticket raised by an employee the HR agent may or may not have a solution in hand. In some cases,
to provide the best solution for a ticket, he may need more information. In such a scenario he can add internal
notes for a ticket asking for more information from a peer/supervisor.
Internal notes for a ticket in SAP Cloud for Customer system can be added by browsing through Overview
Interactions . On clicking Add Note, the HR agent can post his query which will get saved under Interactions.
Note
The internal notes will not be displayed to the employee on the ASK HR application. They are confidential
and will only be visible to the HR agents on the SAP Cloud for Customer system.
After you have established the generic Extension between SAP Cloud Platform and your SAP SuccessFactors
instance you need to enable the employee workspace application/ ASK HR application on your onboarded SAP
Cloud Platform extension sub-account.
Prerequisites
● Ensure that your onboarded SAP Cloud Platform extension sub-account is subscribed to our provider
employee workspace applications.
Note
Our employee workspace applications/ ASK HR applications are multi-tenant. Cloud Platform
applications are available as provider accounts hosted by SAP. Consumers do not deploy applications
in their sub-accounts, but simply subscribe to provider applications. As a result, a subscription is
created in the consumer sub-account.
● Ensure that you have SuccessFactors Employee Center Service Center license.
● Create a ticket in the SAP Support portal ticket on component LOD-SF-EC-SRV.
Procedure
Note
A destination defines the back end connectivity and is a URL to which requests are forwarded.
4. To view all required and optional destinations for our employee workspace application you have to:
a. Logon to SAP Cloud Platform Cockpit.
b. Select your Extension Platform Account.
c. Navigate to Applications Subscriptions HTML5 Applications . Click askhr application.
5. You can view all required and optional possible destinations for our employee workspace / ASK HR
application. In column Mapped Subaccount Destination you can find some default names you can use
later when you create the corresponding destinations. We recommend that you use the default names for
your destinations later thus the destinations are automatically mapped without the need to adjust the
mapping.
6. To get the employee workspace / ASK HR application running you need to connect the application to your
SAP SuccessFactors instance destination and to your SAP Cloud for Service tenant.
a. Logon to your Global platform account to enter the SAP Cloud Platform Cockpit.
8. Create connectivity to your SAP SuccessFactors Instance. Creating destination ‘Bizx_Odata’ on extension
account level. Before you start you have to register your application as OAUTH2 client application in your
SAP SuccessFactors instance. To register:
a. Logon to your SuccessFactors instance as admin user.
b. Navigate to Admin Tools to Manage OAUTH2 client application.
c. Create an entry for your application.
Refer section Creating an OAuth2 authorization between SAP Cloud Platform and BiZx for more details.
1. Login to your Global platform account to enter the SAP Cloud Platform Cockpit.
2. Select your Extension platform account.
3. In the navigation panel select Connectivity Destinations .
4. Enter data as shown below:
○ Name = ‘Bizx_Odata’
○ URL = <https://api2.successfactors.eu/odata/v2 >
○ Client key = <choose the API key of your Manage OAUTH2 client application>
○ Token Service URL = https://api2.successfactors.eu:443/oauth/token
○ Additional Properties = <enter the same API key as under Client key, for example
'assertionIssuer’>
Note
Note
For more details, you can see the list of data centers and their corresponding URLs in the List of Data
Center URLs for configuring BiZx oData Destination section of this handbook.
Note
The text 'yes' or 'no' that you enter is case sensitive. Ensure that you use lower case letters. If you
enter any other text, then the application will not consider it and by default the Priority field will be
visible for the employees on the ASK HR user interface.
e. Click Save.
10. Create connectivity to your javaproxy.
○ Name = ‘javaproxy'
○ Type = 'HTTP'
○ Description = 'Describe the new destination configuration'
○ URL = <Paste the javaproxy URL you copied from Application URL>
○ Proxy Type = 'Internet'
○ Authentication = 'AppToAppSSO'
g. Click Save to save our changes.
11. <Optional>: Create connectivity to an open search compliant Knowledge base / SAP Jam collaboration.
You can also create the corresponding connectivity to any open search compliant knowledge base and SAP
Jam. To configure SAP Jam as the Knowledge Base, refer section Configuring Knowledge Base.
Note
OpenSearch destination should be added only after you configure Knowledge Base.
Related Information
List of Data Center URLs for configuring BiZx oData Destination [page 65]
Configuring Knowledge Base [page 44]
Note
To improve the performance of AskHR, add getProviderUserRoles=false at the end of the URL and save
it.
11. Login to SuccessFactors Employee Central, you will now be able to see the ASK HR option on the top. You
can now use this option to create a ticket using the ASK HR application.
Context
The application name 'ASK HR' is hard coded for all customers. You have an option to modify the standard
application name. To configure a name of your choice for the standard application, follow the steps mentioned
below:
Procedure
This section describes the steps you need to follow to have administrative privileges for your SuccessFactors
instance.
Context
Prerequisites
Ensure that you have administrator privileges to maintain service contact data.
1. Login to your SuccesFactors instance, search and click Manage Permission Roles.
2. On the Permission Role List page, click System admin.
3. On the Permission Role Detail page, click Permissions.
4. On the Permission settings page, click Miscellaneous Permissions. Enable the following in the Service
Center Contact Information Entity box, and click Done:
○ View
○ Edit
○ Import-Export
○ Field Level Overrides
On your SuccessFactors instance you can enable Contact HR on ASK HR application by applying some
permission settings.
Context
Prerequisites
Procedure
Context
Prerequisites
To hide the fields from the User Interface, you must follow the steps below:
Procedure
Note
The text 'yes' or 'no' that you enter is case sensitive. Ensure that you use lower case letters. If you enter
any other text, then the application will not consider it and by default the Contact HR tab will be visible
for the employees on the ASK HR user interface.
8. Click Save.
Note
After all the configurations are saved, on the landing page of the ASK HR application you will be able to
see the contact HR tile as grayed out.
Searching the Knowledge Base is quite a useful approach for an employee who is facing a commonly faced
issue, the solution for which may exist in the configured Knowledge Base. In such a scenario, the employee may
search the Knowledge Base with specific keyword(s) and if the solution exists, there is no need for the
employee to create an HR ticket. A Knowledge Base could be any one of these:
● SAP Jam
● MindTouch
Prerequisites
● Before you configure the Knowledge Base, ensure that your Jam instance is integrated with your BizX
instance.
Context
Prerequisites
Before you start configuring SAP Jam as your Knowledge Base, ensure that you have a:
Procedure
To configure SAP Jam account as destination in SAP Cloud Platform, follow the steps listed in Integrations
using SAP Jam API for applications on SAP Cloud Platform.
Context
Prerequisites
● Ensure that you have configured destination as sap_jam_odata for SAP Jam, or OpenSearch_Odata for
OpenSearch.
To hide the fields from the User Interface, you must follow the steps below:
Procedure
5. Enter the following hideField values separated by a comma (without space) for each hideField identifier.
Also, the hideField values are case-sensitive.
Table 8:
LastModifiedAt LastModifiedAt
Rating score
If you want to hide Description and Views Count fields on SAP Jam, then enter the hideField value as
shown below:
Note
By default, all the supported fields are visible on the User Interface if the hideField parameter is not
specified in the destination parameters. Display of the Title field is mandatory and you will not be able
to disable it from the User Interface.
6. Click Save.
To enable ASK HR application on SAP SuccessFactors modules you must edit the permission settings in Admin
Center.
Context
For existing customers, the ASK HR application is enabled on all SAP SuccessFactors modules. However, for
new customers the ASK HR application is disabled by default. To enable, you must follow the steps as stated
below:
Procedure
Results
The ASK HR application will now appear on all supported SAP SuccessFactors modules.
Context
The supported locales for Employee Central Service Center in Provisioning are as follows:
● English
● German
● French
● Dutch
● Swedish
● Spanish
● Italian
● Romanian
● Japanese
● Finnish
● Arabic
● French (Canadian)
● Portuguese (Brazil)
● Czech
● Turkish
● Hungarian
● Chinese (Simplified Chinese)
● Polish
● Bulgarian
● Russian
Note
If you select the language 'Arabic', ensure that you have upgraded the SAPUI5 version to 1.52.
Results
The selected locales will now appear in your Success Factors instance.
Related Information
After the supported languages appear on your SuccessFactors instance, you can switch from one locale to
another by applying some settings.
Context
Prerequisites
Ensure that the desired language (also supported by Employee Central Service Center) you want to switch to is
enabled in Provisioning.
Results
This will redirect you to the SuccessFactors homepage. When you re-launch the ASK HR application, it will
appear in the new locale.
Related Information
To upgrade your existing SAPUI5 version to 1.60 you must edit the settings in Admin Center.
Context
To get the latest UI changes of the application you must upgrade the version to 1.60. To upgrade the version you
must edit the permission settings in Admin Center as mentioned below.
Procedure
Next Steps
Follow the steps to enable the supported theme for the selected SAPUI5 version from Theme Manager.
Related Information
Enabling supported theme for SAPUI5 version from Theme Manager [page 50]
You must select the appropriate theme from the Theme Manager for the upgraded SAPUI5 version to be
processed completely.
Context
There are two themes available in the Admin Center Theme Manager corresponding to the SAPUI5
version. The table below shows the theme you must select corresponding to the SAPUI5 version.
Procedure
Next Steps
For the selected theme to reflect you must logout and login back to the system.
Description
If the SAP Cloud for Customer system stops responding we have a workaround for this.
Workaround
Description
You could face this issue where an employee is not replicated to SAP Cloud for Customer or SAP Jam. This may
occur in case the replication process fails due to data corruption, or the employee was created during the
interval when replication was not happening.
Workaround
● Wait for some time to have the replication handled by the system.
or
● Contact your system administrator.
Description
Workaround
Prerequisites
1. You must have a testuser account to validate if the ASK HR application is configured to use or not.
The following screen appears if the Knowledge Base as SAP Jam is configured.
The following screen appears if the Knowledge Base as SAP Jam is not configured.
Soon, you will be able to upgrade your Employee Central Service Center to the Fiori UI, we recommend that you
wait until we are able to provide a smooth and simple migration process that will minimize any effort on your
part, and ensure your specific configuration (such as ticket statuses and custom fields) are migrated.
Employees can access the ASK HR application on their mobile device by downloading and installing the SAP
SuccessFactors Mobile app from the app store.
The ASK HR application is available for Android and iOS mobile platforms. After the ASK HR application is
downloaded on your mobile device, employees can:
● Create tickets
● Check the status or update of an existing query
● Interact with the HR agent
● Contact HR for any HR related query
This enhances the employee experience by ensuring that employees have easier access to the tickets they
create. This also ensures that employees are able to receive the fastest response possible inline with local HR
expertise and processes. Additionally, the application available on mobile makes it simple for your employees
to find relevant HR information and allows them to easily contact their HR experts.
13.1 Prerequisites
Prerequisites
You need to have permissions for accessing the Integration Center application in the SAP SuccessFactors
system.
Context
You have to generate the X.509 certificate in the SAP SuccessFactors system. Later on, you will add this
certificate as a trusted identity provider in SAP Cloud Platform.
Procedure
Note
Next Steps
● Ensure that the name you specify for the Configuration Name field is used later in the name fields you
configure while
Context
You have to create an OAuth client in SAP Cloud Platform with ID and secret. Later on, you will add these client
ID and secret when creating the outbound OAuth configuration in SAP SuccessFactors system.
Procedure
1. Go to the SAP Cloud Platform cockpit and open the extension subaccount. For more information, see
related link.
Next Steps
● Ensure that ID created after registering a new client is used later as the Client ID field you configure while
creating Outbound OAuth Configuration in SAP SuccessFactors.
● Ensure that password you specify for the Secret field is also used later as the client name field you
configure while creating Outbound OAuth Configuration in SAP SuccessFactors.
Prerequisites
You have created an OAuth X509 key and have saved the X509 certificate on your local file system.
Context
Register the certificate you downloaded when generating the OAuth X509 key in the SAP Cloud Platform
cockpit.
Procedure
Note
If there is no single lout (SLO) end point specified, no request to the IDP SLO point will be sent, and only
the local session will be invalidated.
Prerequisites
Context
Based on the X509 certificate and OAuth client, you have to create an outbound OAuth configuration in the
SAP SuccessFactors system.
Procedure
8. In the Token URL field, paste the value of the Token URL from the Token Endpoint field in the SAP Cloud
Platform cockpit Security OAuth Branding OAuth URLs .
Note
Open the SAP Cloud Platform cockpit and go to Security Trust Local Service Provider Local
Provider Name .
11. In the Recipient field, enter the same value as the one in the Token URL field.
12. In the Issuer field, copy and paste the same value as the Name field of the trusted identity provider you
created in the SAP Cloud Platform cockpit.
13. In the X509 Keys, select the OAuth X509 key you created.
14. Choose Save.
Prerequisites
Context
Based on the X509 certificate and OAuth client, you have to create an outbound OAuth configuration in the
SAP SuccessFactors system.
Procedure
If the URL is https://abc.ondemand.com/javaproxy then the URL that you must enter here must be
https://abc.ondemand.com. You must not mention javaproxy.
To enable the ASK HR on mobile devices you must go to Admin Center to enable certain settings.
Context
Before you enable the ASK HR application on mobile ensure that ASK HR on the web is configured and turned
on.
Follow the steps below to enable ASK HR application on your mobile device.
Procedure
Go to Admin Center Mobile Settings Enable Mobile Features Modules Employee Central and select
the HR Service Center option.
Results
You can create and modify Ask HR tickets using the SAP SuccessFactors Mobile app.
You can search for the right set of URLs that must be used for configuring BiZx oData Destination in SAP Cloud
Platform.
Data Center Type of URL Production System URL SalesDemo System URL Preview System URL
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.