Internationalization

All apps built with Appfarm Create support internationalization by default. By using the built-in UI components you ensure that your apps can be easily translated and maintained in different languages.

The default language for a solution, as well as the calendar locale and date and number formatting is set to English (US). We recommend using English as the base language when creating your UI as it makes it easier to provide support and it's often a preferred source language if you choose to translate the UI.

If you do choose to build your UI using a language other than English (US), you can set that language as the default under Internationalization > Languages by changing the Base Language of the default language.

Customize date and number formatting

The default date and number formatting settings can be changed under Internationalization > Languages > English (default). These can also be configured for each new language you add.

Calendar locale

The locale used when formatting dates and displaying Datetime related strings, for example "Monday" and "February".

Date format

The default amount of detail that will be included when displaying a Datetime value. This can also be set per value using the Value processor.

• Short date

• Date

• Long date

Below is an example of how calendar locale and date format work together to format dates:

Calendar Locale	Short Date	Date	Long Date
English - Great Britain	07/02/2022	7 February 2022	7 February 2022, 00:00 CET
English - United States	2/7/2022	February 7, 2022	February 7, 2022, 12:00 AM GMT+1
Norsk bokmål	7.2.2022	7. februar 2022	7. februar 2022, 00:00 CET

Number format

The locale used when applying number formatting using the Value processor or UI components that support number formatting such as Table.

Currency

The currency to display when applying number formatting using the Value processor.

Add a new language

To add a new language to your solution, click the + under Internationalization > Languages. Then, select the desired Base Language. You can also can set the date and number formatting you'd like to apply when this language is set as the active language in the Appfarm Client.

If you need a language that is not currently available, please get in touch.

Once you have added a new language, you need to add translations and enable language switching in your apps.

Translate your apps

Adding and editing translations

Translations can be added and edited in two places in Appfarm Create.

• Directly within the UI designer.

• Under Internationalization > Translations.

To add translations directly within the UI designer, look for any property with a globe icon. Click the icon to view and edit all translations for that property. A button to translate all using Google Translate is available. Existing translations will not be affected.

Translate

All default language strings and translations are listed under Internationalization > Translations.

Translations are saved instantly as you type. For UI components that support line breaks, you can add a line break by typing Shift + Return/Enter.

Each row includes a context reference, identifying which component and property the string is located in. Click on the reference to be taken directly to that property in the UI designer.

It's also possible to run Google Translate individually for each row. Empty translation values will be replaced with a translation. Existing translations will not be affected. This can be a useful starting point for translations. A human can then review the text and correct translations as required. You will see the best results when you have English as a base language.

Sorting and filtering

By default all strings are displayed and are sorted by app. Strings used in enums are sorted to the bottom. You can also sort alphabetically.

The strings can be filtered down to specific apps and enums.

To search for a specific value, use the Find functionality in your browser Ctrl/Cmd + F.

Import and export

User interface strings and all stored translations can be exported to a CSV file for translation and review. The file is comma delimited. The contents of the file is determined by any sorting and filtering you have applied. The CSV file is structured as follows:

• The first value is a unique ID (key) referencing the location of the string in the solution.

• The second value contains the source (default language) string.

• Any additional values contain the translations, if any, stored for that string. These values follow the same order that the languages are listed in Appfarm Create.

A translated CSV file can be imported back into Appfarm Create. The two first header rows will be skipped. The import loops through all lines and values, and updates translations where the value (trimmed of whitespace) is not empty or is different from the existing trimmed translation value stored in Appfarm Create. Both comma and semicolon delimited files are accepted.

Functions

If you have text in your app that is returned by a function, it will not be shown under Translations. For example, return `Hello ${firstName}` won't be included in the list of strings. To translate such text you can add if statements to check the active language and return the appropriately translated string.

Translate functions