Introducing the reworked steps for extending SAP SuccessFactors on SAP Business Technology Platform
Hello again and welcome to my blog post on the extensibility of SAP SuccessFactors. Our team has been hard at work to revise and ultimately simplify the way in which you can extend your SAP SuccessFactors functionality with extension applications on SAP BTP.
In this blog I will show you:
- The reworked Integration Tokens page when using SAP BTP, Neo environment
- The Systems page when using SAP BTP, Cloud Foundry and Kyma environment
- Changes to the Extension Management Configuration page in SAP SuccessFactors Provisioning
- Changes to the Extensions page in the Admin Center in SAP SuccessFactors
- The reworked Extension Center page in the Admin Center in SAP SuccessFactors
To prepare for the next steps, make sure you have the following:
- A subaccount in the SAP BTP, Neo environment, for which you either have the Administrator predefined role or a custom predefined role with the scopes needed to manage integrations – refer to the Prerequisites section in our official documentation for the full list.
- A global account for which you are an administrator
- A dedicated SAP SuccessFactors company and a user with permissions to access Extension Center in SAP SuccessFactors Admin Center that include the Manage Extensions on SAP BTP permissions. See:
Now that the stage is set, let’s dive into the changes.
Reworked Integration Tokens page when using SAP BTP, Neo environment
Perhaps you are already familiar with the Integration Tokens page in the SAP BTP cockpit which is the entry point for the extensibility scenario in the SAP BTP, Neo environment. What you might have missed is the brand new Integrated System section which displays information on the existing integration with a subaccount if there is one.
If you have no prior experience with the topic and you are wondering what I am talking about, just navigate to your subaccount in SAP BTP Neo cockpit and on the left-side navigation, choose Integration Tokens.
If you are just starting the extensibility scenario, then naturally you will not have an integrated system yet. You now have the option to create a new integration token with trusted identity provider configurations of your choice.
Once you have created your token, it’s time to see what has changed in SAP SuccessFactors Admin Center and how you can trigger the integration. But before we get to that, let’s quickly go through the integration token generation for SAP BTP, Cloud Foundry and Kyma environment.
Systems page when using SAP BTP, Cloud Foundry and Kyma environment
If your goal is to extend SAP SuccessFactors on the SAP BTP, Cloud Foundry and Kyma environment, then you need to navigate to your global account in the SAP BTP cockpit, and then open the Systems page under the System Landscape category.
Choose Register System, enter a system name of your choice, and then select the SAP SuccessFactors system type. Choose Register and you will get an integration token for your SAP SuccessFactors system.
Changes to the Extension Management Configuration page in the Admin Center in SAP SuccessFactors
So, you have generated an integration token for your SAP SuccessFactors system in the SAP BTP, Neo environment and SAP BTP, Cloud Foundry and Kyma environment. What do you do with them now, you would ask?
Well, previously you would have to access the Provisioning page of your SAP SuccessFactors company. Then, you would have to go to Extension Management Configuration page and enter the token there to trigger the integration.
We have revised this flow and decided to move out of Provisioning. That’s right – you will no longer need Provisioning access to trigger an integration. With SAP SuccessFactors, Second Half 2021 Release, you will get the following message if you go to the Extension Management Configuration page:
Changes to the Extensions page in the Admin Center in SAP SuccessFactors
Extension Management Configuration isn’t the only page that is moving.
Previously, when you had integrated your SAP SuccessFactors company with a subaccount in the SAP BTP, Neo environment, the Extensions page of SAP SuccessFactors showed the integrated subaccount and an Extension Directory link which redirected you to the SAP Cloud Portal service of the integrated subaccount.
With the SAP SuccessFactors, Second Half 2021 Release, the Extensions page would show a similar message to the one you get on the Extension Management Configuration page:
The reworked Extension Center page in SAP SuccessFactors
So, both the Extension Management Configuration and the Extensions pages are moving, but where? It is time to introduce the reworked Extension Center page in SAP SuccessFactors. When you open it and go to the Extensions on SAP BTP tab, you will see something very similar to the old Extension Management Configuration page:
Go ahead and enter the integration token you generated from the subaccount in the SAP BTP, Neo environment, and then choose Add.
In the Neo Environment section, you can see that the subaccount in SAP BTP, Neo environment, appears with status Integrating. There is also a button to check the status for that particular integration.
For a successfully integrated SAP SuccessFactors system in the SAP BTP, Neo environment, you will also see a link in the SAP Cloud Portal URL column. That is the same link that previously resided in the Extensions page and can be used to go to the SAP Cloud Portal service of the integrated subaccount.
Now, let’s also enter the integration token from the system you registered in your global account and again choose Add.
In the Multi-Cloud Environment section, you can see the system in Integrating state. Again, there is a button that can be used to check the status of the system.
In the end, you managed to integrate an SAP SuccessFactors system to both a subaccount in SAP BTP, Neo environment, and to a global account in SAP BTP.
But how do I refresh or remove my integration now?
In case you are using SAP BTP, Neo environment:
When you have integrated an SAP SuccessFactors system with a subaccount in the SAP BTP, Neo environment, you might have noticed that in the Extension Center the Refresh and Remove buttons previously available on the Extension Management Configuration are now missing. That is because those buttons have been moved to the SAP BTP cockpit.
Let’s open SAP BTP cockpit and go to the Integration Tokens page of the subaccount once again.
You can see that the New Token button is disabled, the Integration Tokens section is inactive since an integration is already present and the Integrated System section now contains information about the existing integration. On top of that, you also have the two buttons (Refresh and Remove) that used to be in Provisioning.
You can now trigger a refresh of the integration. This opens a confirmation dialog which explains all the things the refresh will actually do. Upon confirmation, the integration will go to REFRESHING status. After a short time, the integration should be successfully refreshed and back in the INTEGRATED status.
The Remove button could be used to remove the existing integration. Again, a confirmation dialog is displayed first. After choosing OK, the integration goes to REMOVING status. Shortly, the removal should finish and the integrated system will disappear from the SAP BTP cockpit. At this point, the New Token will be active again so that you can reintegrate your subaccount.
In case you are using SAP BTP, Cloud Foundry and Kyma environment:
To remove the registered system, go to the Systems view of the global account again. In the row with the system you want to remove, you will find a button to deregister a system. Once more, a confirmation window will appear and once you confirm, the system will go into the Deregistering status. Shortly after, the system will be deleted and will disappear from the page.
This blog walked you through the newest way to issue integration tokens in SAP BTP Neo environment, and SAP BTP Cloud Foundry and Kyma environment. It also reviewed some of the changes to the SAP SuccessFactors Extension Center and Provisioning. Now you know how you can use the reworked Extension Center to trigger your integration.
And last but not least, you now know how you can refresh your integration with a subaccount in the SAP BTP, Neo environment, and how you can remove integrations with a subaccount in the SAP BTP, Neo environment, and with a global account in SAP BTP.
Check our official documentation for more in-depth explanations: