Change Tenant Texts in SAP Cloud Platform Identity Authentication
This blog would explain steps to changing tenant text for your SAP Cloud Platform Identity Authentication.
SAP Cloud Platform Identity Authentication offers predefined text for Buttons, Field Labels, Title Groups, Links, Titles and Messages. Not all text can be changed, but a list of text that can be updated can be accessed from help : Standard Tenant Text
The best option is download the text list content in a spreadsheet and subdivided by areas (e.g. Buttons, Fields Labels, Title groups, etc). I found more useful the same tenant text list from this URL Standard Tenant Text Properties, as you can identify the text by the “#” name. After battling with the list, I figured the # meaning
# XBUT = Buttons
# XFLD: Fields
# XGRP: Group Titles
# XLNK: Links
# XTIT: Titles
# XTOL: Text information
# XMSG: Messages
# XLST: Dropdowns
Steps to Change Text:
Obtain Tenant Changed Text
- As explained in the help, you need to review your tenant changed text:
For some tenants some changed predefined changed texts may exist. If your tenant contains predefined changed texts, you can:
Use the GET method to obtain the texts that overwrote part of the predefined tenant texts when your custom tenant was created, change the texts that you want, add them to the POST request and upload them.
If there are no predefined changed texts for your tenant, the GET Tenant Texts returns the 404 Not Found code. In this case, proceed with the POST Tenant Texts method.
2. One important tip is that you require an user with “Administrator access”,as described by SAP Note: 2650614 – Identity Authentication Service – Cannot change logon screen labels – 403 Forbidden.
Create a new user under Users & Applications > Administrators. Create an “System Users” with the following minimum authorizations.
3. Use a program such as POSTMAN to use GET/POST API. Download postman from this link
4. Use GET API details to to review your tenant changed text
|GET||GET Tenant Texts||https://<tenant ID>.accounts.ondemand.com/service/resource?resourceType=RESOURCE_I18N_BUNDLE&locale=<value>|
5. Use your System Adminstration User created in SAP Identity Authentication Service. In Postman create a new GET method with authentication type = Basic Authorization.
Be careful with parameter “Locale” as is key sensitive. Use the language for the end user screen.
6. Press “Send” and after getting the result used button “Copied to clipboard” to save text changed in your tenant.
7. Save your text in a notepad.
Now to update your text tenant, there are some tricky steps.
First, identity the text that required to be updated. As indicated in previous section, by using # from the text file, is easier to identify the text. However, I’m not going to lie, you need to check your screen and then search your file to identify the right text. Here an example
Second, you don’t need to upload all text again, only text that you would like to change.
Your Post API only would contain the text you want to update. So, basically identify from the link Standard Tenant Text, only the text that you would like to update and merge with text downloaded from GET Method API (text that overwrote part of the predefined tenant texts when you custom tenant was created).
Ensure that you have removed the comment lines in your file. The comment lines are introduced by the # (number or hash) sign.
Now, the tricky part is that you require to edit your file and you should add \n at the end of each line in the data property content. Specifically you require to include the following ecape Sequences
|\b||Backspace (ascii code 08)|
|\f||Form feed (ascii code 0C)|
In this website press “Escape” button and get your new formatted text
Now, that you have your text ready to go, use the POST API to update your text tenant:
HTTP Method: POST
|POST||POST Tenant Texts||https://<tenant ID>.accounts.ondemand.com/service/resource/SAP_DEFAULT|
Remember to use your System Administration user for this API.
Use the API content example from help . Basically your content should look like this:
Ensure “ are included at the beginning and the end of data section, as below:
As final steps, be careful to have proper Escape Sequences, as any missing sequence would result of system fail to identify the right text. Specially the \r\n” at the end.
As you can see, you have a variety of text that could be updated. See my result updated text below. This include titles, labels and buttons.
Now you are ready to update your tenant text and adjust to your user requirements!!!…