Add Localization to a Managed Association with Core Data Services

Add a reference for the title annotation to the i18n file in your db/model.cds file. Use category as key in the i18n reference.

category: Association to Categories @(
    title: '{i18n>category}',
    Common: {
        Text: {$value: category.name, "@UI.TextArrangement": #TextOnly},
        ValueList: {entity: 'Categories', type: #fixed},
        FieldControl: #Mandatory
    }
);

This makes the builder look into i18n.properties files for a string, which in our case is the title. You can reference that string from any file in your project, so it’s kind of single-sourcing, and it enables translation workflows.

What is the key used as reference for the title annotation? Enter it in the box below.

The CDS builder checks specific places in your project for localized files. They can either be next to your modelling .cds file or in a parent folder. In this project the files are located in the _i18n folder, that is one of the default folders. If you have the need to deviate from the default, you can add the following code to the package.json in the root directory of your project and specify the folders as needed.

"cds":{"i18n":{
  "folders": [ "_i18n", "i18n", "assets/i18n" ]
}}

In this step, you add the key category to the i18n files. We’ve included three i18n files for you.

• _i18n/i18n.properties

  This is the fallback if no language-specific file is in place.

• _i18n/i18n_en.properties

  The language-specific file for the English locale.

• _i18n/i18n_de.properties

  The language-specific file for the German locale.

If you can’t see the language-specific files, select Show Hidden Files at the top of your Files view.

1. Go to _i18n/i18n.properties and add this code:

   #XTIT: Category
   category=Category
   

2. Go to _i18n/i18n_en.properties and add this code:

   #XTIT: Category
   category=Category
   

3. Go to _i18n/i18n_de.properties and add this code:

   #XTIT: Category
   category=Kategorie
   

This reference can now be resolved by the builder, and the value for the key, in our case category, is used during the build process.

What does XTIT stand for? Copy the description from an i18n.properties file and paste it in the box below: