There are generally two kinds of languages in the iPIM system: The UI language is the language that is used to localize the user interface elements. The locale is the language that is used to localize data (attributes respectively attribute values). In the “Language” area you can create new locales, edit existing locales or delete locales that are now longer needed.
Select locale

In order to select a locale, proceed as follows:
- Click on the “Select locale” field to call up the corresponding selection menu.
- Search for the locale. Possibly use the free-text search or the column header tools to filter the list of locales.
- Click on the locale to select it. Then the name and the ISO-Code of the selected locale are displayed in the selection field “Select locale”. Furthermore, any clients related to the selected locale are listed in the table of the “Clients” card.

Create locales
In order to create a new locale, proceed as follows:
- Click on the button to call up corresponding dialog box.
- Enter a valid ISO code* in the input field “ISO code”.
- Enter an export ISO code in the input field “Export ISO code”. The export ISO code uniquely identifies the locale when exporting data.
- Enter the names by which the locale is referenced in the individual locale levels:
- Click on the
button in the “Description” field. Then you will be directed to another slider that features individual input fields for the different locale levels. - Enter the multiligual names in the respective input fields.
- Click on the button to get back to the previous slider.
- Click on the

- Enter a positive truth value in the input field “Boolean value for Yes”.
- Enter a negative truth value in the input field “Boolean value for No”.
- Since 5.4.1: In the input field “Order”, possibly enter a sequence number for the sorting within the list of locales.
- Possibly tick the checkbox “Language package” to activate the use of a language package. If activated, this particular language will then be available as a UI language as long as it is implemented as such**.
**The sequence numbers effects that in tables across the board, locales are sorted according their sequence numbers. For example, localized attribute value names in a list of values are sorted according to the sequence number of their respective locale.
***Additionally the property ipim.web.ui.locales has to be maintained accordingly.
- Possibly specify a view right for the locale. Then any user that has the same right assigned to them will be able see the corresponding locale:
- Click on the
button in the “View right” field.
A slider showing the user right directory is shown. - Choose the right from the rights directory. Possibly use the text search to filter the list of rights by a search term.
- Click on the right to select it.
The previous slider is shown again.
- Click on the

- Possibly specify a edit right for the locale. Then any user that has the same right assigned to them will have edit rights in the corresponding locale:
- Click on the
button in the “Edit right” field.
A slider showing the user right directory is shown. - Choose the right from the rights directory. Possibly use the text search to filter the list of rights by a search term.
- Click on the right to select it.
The previous slider is shown again.
- Click on the
- In order to finish the process, click on the button.
A success message is shown. The new locale is now created and it appears in the list of locales. - In order to cancel the process, click on the button.

- Even if a user has the view right that is defined for the respective locale, they also need log in with a client that is related to the locale. Otherwise the user cannot see that particular locale.
- The behavior of edit rights is depending on the respective environment. If the environment is for viewing and editing as most tables are, the view turns read-only when switching the data locale to a locale where the user has the view right but not the edit right. In an environment that is for creating, such as the dialog box for creating texts, the drop-down menu for selecting a data locale only shows locales where the user has edit rights. And if the environment is for editing only, such as in the “Content Management” app, the respective “Save” buttons are disabled.
Edit a locale
In order to edit a locale, proceed as follows:
- Select the locale as described above.
- Click on the button to call up the corresponding dialog box.
- Make the desired changes.
- In order to save your changes, click on the button.
A success message is shown. - In order to cancel the process, click on the button.
Delete a locale
In order to delete a locale, proceed as follows:
- Select the locale as described above.
- Click on the
button.
The button is shown. - Click on the button to confirm the deletion.
A success message is shown and the locale vanishes from the list of locales.
Clients
Locales can be related to clients. Users that are logged in with a related client can then see the corresponding locale levels, as long as that they have the corresponding view rights at the same time. Here you can relate additional clients to the selected locale and you can resolve relations to clients.
Relate clients
In order to relate the selected locale to a client, proceed as follows:
- Select the locale as described above.
- Click on the button in the footer to call up the corresponding dialog box.
- Possibly enter a search term in the search field
to filter the list of clients by a search term. - Select a client. You can also select multiple clients:
- In order to select a client, transfer it from the left column
to the right column
. To do so, click on the client
. - In order to deselect a client, transfer it from the right column back to the left column. To do this, click on the client.
- In order to select a client, transfer it from the left column

- In order to finalise the selection of the client, click on the button
.
The dialog box closes and the client is shown in the table. The client is now related. - In order to cancel cancel the selection of the client, click on the button
.
Remove clients
In order to undo the relation between the selected locale and a related client you need to remove it from the table in the “Clients” card. To do so, proceed as follows:
- Select the locale as described above.
- In the table, tick the client you want to remove. You can also tick multiple clients.
- Click on the button in the footer.
The button is shown. - Click on the button to confirm the removal.
A success message is shown. The relation is now resolved.
) icon in the respective table row to delete resp. remove individual entries.
FAQ
What kinds of languages are there in the iPIM system?
There are generally two kinds of languages in the iPIM system. The UI language is the language that is used to localize the user interface elements. The locale is the language that is used to localize data, i.e. attributes respectively attribute values.
How is the ISO code of a locale structured?
The required ISO code consists of a language code in lower case letters and a country code in upper case letters, e. g. “deDE” for German or “enGB” for English.
What is the “Order” field used for when creating a locale?
The sequence number entered in the “Order” field determines the position of the locale within the list of locales. The sequence numbers effect that in tables across the board, locales are sorted according to their sequence numbers. For example, localized attribute value names in a list of values are sorted according to the sequence number of their respective locale.
What happens if I tick the “Language package” checkbox for a locale?
If the locale is created as a UI language, it will then be available as a UI language and can be selected via the corresponding menu. Additionally, the property ipim.web.ui.locales has to be maintained accordingly.
What is the view right of a locale used for?
Any user that has the same view right assigned to them will be able to see data on the corresponding locale.
What is the edit right of a locale used for?
Any user that has the same edit right assigned to them will have edit rights in the corresponding locale.
Why can a user not see a locale despite having the assigned view right?
Even if a user has the view right that is defined for the respective locale, they also need to log in with a client that is related to the locale. Otherwise the user cannot see that particular locale.
How do the edit rights of a locale behave in different environments?
The behavior of edit rights is depending on the respective environment. If the environment is for viewing and editing as most tables are, the view turns read-only when switching the data locale to a locale where the user has the view right but not the edit right. In an environment that is for creating, such as the dialog box for creating texts, the drop-down menu for selecting a data locale only shows locales where the user has edit rights. And if the environment is for editing only, such as in the “Content Management” app, the respective “Save” buttons are disabled.
What happens if no view and edit rights are defined for a locale?
If you do not assign view and edit rights for a locale, any user can see and edit data on this particular locale level.
What can I relate a locale to a client for?
Locales can be related to clients. Users that are logged in with a related client can then see the corresponding locale levels, as long as they have the corresponding view rights at the same time.
“`Rights
Apart from the basic rights listed here, a user needs the rights that are shown in the table.
| Key | Identifier | Description |
| ipim-cc.login | iPIM CC – Login | Login right for iPIM CC. The right is also required to access iPIM CC via the corresponding tile on the dashboard of iPIM Portal. |
| ipim-cc.system-setup.languages | iPIM CC – System Setup – Languages | Right to use the “Languages” area in the “System setup” section of iPIM CC |
| ipim-cc.system-setup.languages.create-and-save | iPIM CC – System Setup – Languages – Create and Save | Right to create new locales and to edit existing locales. This also includes the right to assign clients to locales. |
| ipim-cc.system-setup.languages.delete | iPIM CC – System Setup – Languages – Delete | Right to delete existing locales. This also includes the right to revoke assigned clients from locales. |