Customizing SAPFioriFlows FlowsLocalizedStrings

Introduction

With SAP BTP SDK for iOS v24.8, application developers can customize localized texts for any properties within FlowsLocalizedStrings. If no custom text is provided for a specific property, the default text from FlowsBundle will be used.

Previously, the localized texts within FlowsLocalizedStrings were internal and could not be modified by developers. With this update, the SDK offers greater flexibility, enabling full customization of all localized texts.

Use Case

Customizing the Confirmation Alert When Resetting Passcode During Restore

In previous versions, the confirmation alert displayed when a user attempted to reset the passcode during the restore process was not customizable. The default text for cancelRestoreAlertControllerTitleText in FlowsBundle was:

"Are you sure you want to cancel the restore process?"

With SAP BTP SDK for iOS 24.8, application developers can display a custom message instead of the default text from FlowsBundle. Follow the steps below to customize this alert:

Steps to Customize

1. Create or update a .strings file: Create a new .strings file (or use an existing one) in your application's main bundle. Add custom string values for the desired FlowsLocalizedStrings keys from the list provided below.
2. Configure the AppParameters.plist: In the AppParameters.plist file, set the value for the key "Localizable Strings File Name" to the name of your custom .strings file.

Customizable FlowsLocalizedStrings Keys

The keys listed below represent the texts that can be customized in FlowsLocalizedStrings. These texts cover a variety of user interactions, such as canceling actions, handling rejections, and managing feedback screens. Customize these keys according to the specific needs of your application:

Cancel Alert Controller Texts

cancelAlertControllerTitleText cancelRestoreAlertControllerTitleText cancelResetPasscodeAlertControllerTitleText cancelAuthenticationProcessAlertControllerTitleText resetPasscodeAlertControllerTitleText cancelPasscodeChangeControllerTitleText cancelPasscodeControllerTitleText yesButtonText noButtonText continueButtonText cancelButtonText

Reject Alert Controller Texts

rejectAlertControllerTitleText rejectYesButtonText rejectNoButtonText authenticationFailedMessage slsFillAllOfTheFieldsErrorMessage

Feedback Screen Texts when the Passcode Policy Is Changed

fuiFeedbackScreenTitleText fuiFeedbackScreenHeadlineText fuiFeedbackScreenDescriptionLabel fuiFeedbackScreenActionButtonText

Feedback Screen Texts when Touch ID Is Disabled From Policy

fuiFeedbackScreenDisableTouchIDTitleText fuiFeedbackScreenDisableTouchIDHeadlineDescription fuiFeedbackScreenDisableTouchIDDetailDescription fuiFeedbackDisableTouchIDButtonText

Feedback Screen Texts when Face ID Is Disabled From Policy

fuiFeedbackScreenDisableFaceIDTitleText fuiFeedbackScreenDisableFaceIDHeadlineDescription fuiFeedbackScreenDisableFaceIDDetailDescription fuiFeedbackDisableFaceIDButtonText

Feedback Screen Texts when Optic ID Is Disabled From Policy

fuiFeedbackScreenDisableOpticIDTitleText fuiFeedbackScreenDisableOpticIDHeadlineDescription fuiFeedbackScreenDisableOpticIDDetailDescription

Feedback Screen Texts when Passcode Is Turned Off From Policy

fuiFeedbackScreenTurnOffPasscodeTitleText fuiFeedbackScreenTurnOffPasscodeHeadlineDescription fuiFeedbackScreenTurnOffPasscodeDetailDescription fuiFeedbackScreenTurnOffPasscodeAndTouchIDDetailDescription fuiFeedbackScreenTurnOffPasscodeAndFaceIDDetailDescription fuiFeedbackScreenTurnOffPasscodeAndOpticIDDetailDescription fuiFeedbackScreenTurnOffPasscodeButtonText

Feedback Screen Texts for Migration

fuiFeedbackScreenHeadlineMigrationDescription fuiFeedbackScreenMigrationDescription fuiFeedbackScreenMigrationButtonText

Usage Collection Consent Texts

UsageCollectionConsentTitle UsageCollectionConsentBody usageOptOutAlertMessage usageOptInAlertMessage

Crash Report Collection Consent Texts

CrashReportCollectionConsentTitle CrashReportCollectionConsentBody

QR Digital Signature Verification Texts

qrDigitalSignatureVerficationFailedTitle
qrDigitalSignatureVerficationFailedMessage qrDigitalSignatureVerficationSucceededMessage

InfoScreenPresenter Texts

authenticationErrorTitle authenticationErrorMessage errorButtonText

Note

Not all onboarding-related texts can be customized using this method. For example, UI texts in WelcomeScreenStep cannot be customized directly through FlowsLocalizedStrings. In such cases, FioriFlows provides specific customization options, such as the welcomeScreenCustomizationHandler, which allows you to customize all texts defined in theWelcomeStepUI protocol.

---

Last update: August 26, 2024