Columns

This module is not available in the current version. It will be available in a future version. Use this page for reference only.

Columns (Column Definitions) controls the human-readable column names shown in the Angular Console for a given columnKey. Each column definition is a key plus one or more localizations (locale and localized name). Many screens use these labels. Change one key at a time and check the result in the UI before you continue.

Where to find parameter descriptions: The create page and the edit page show a subtitle for each section. The Column Key field has a hint. Other fields show labels only.

When to use it

Use Columns to do the following:

  • Add a new columnKey with a correct label in the UI.

  • Fix a wrong or unclear column label.

  • Add a missing translation for a locale, for example EN or RU.

  • Review the locales of a column key.

  • Delete an old column definition, if you have permission.

Before you start

  1. Open Angular Console → Columns.

  2. Check if you are in the correct environment. Column definitions change the labels of many screens.

  3. Check your role.

Columns does not depend on the Client type.

Roles for this module:

  • VIEWER: browse only.

  • EDITOR or ADMIN: create, edit, and delete.

If you do not see New column, Edit column, or Delete column, your role does not allow it.

Fields

A column definition has these parts:

Column key (columnKey)

The unique identifier of the column. Required. Maximum 50 characters. It starts with a Latin letter. It can contain Latin letters, digits, dots (.), underscores (_), and hyphens (-). Example: user_country.

Localizations

A list of translations for the same column key. Each localization has two fields. Each column definition can have only one localization for each locale.

  • Locale: a code such as en, ru, en-US, or ru-RU. The format is xx or xx-YY.

  • Localized name: the UI label for the locale. Required. Maximum 255 characters.

Audit times

Read-only. The details view shows the created and updated times. The times come from the latest localization data.

Find a column definition

  1. Open Columns.

  2. Enter text in the search field (Search columns…​). The search filters by Column key.

  3. Optional: to focus the search field, press /, Ctrl+K, or Cmd+K.

  4. Optional: sort the columns with a table header menu (Asc or Desc).

  5. Click a row, or use View details, to open Column Details.

Expected result:

  • You see a table with Column key, Locales, and Last updated.

  • Locale badges, for example EN and RU, show the existing translations.

  • The details dialog lets you review and manage localizations.

The Filters button is disabled on this page. Use the search to narrow the list.

Add a column definition

Required role: EDITOR or ADMIN.

  1. Click New column.

  2. Enter Column Key.

  3. Under Localizations, add at least one localization.

  4. Select a Locale, for example en.

  5. Enter Localized Name, for example Country.

  6. Click Create column.

  7. Return to the list and open Column Details.

Expected result: the details show the localizations.

You cannot change the column key after you create it. The field is disabled in edit mode. Choose a stable key.

Change localizations

Required role: EDITOR or ADMIN.

You can manage localizations in two places:

  • Column Details, with Add Localization. You add, edit, and delete one locale at a time.

  • Edit column. This form adds and changes many localizations.

Add a localization

  1. Open Column Details.

  2. Click Add Localization.

  3. Select a Locale and enter a Localized Name.

  4. Click Add, or Save when you edit.

Edit a localization

  1. Open Column Details.

  2. Click the edit action of a localization.

  3. Change the Locale, the Localized Name, or both.

  4. Click Save.

Delete a localization

  1. Open Column Details.

  2. Click the delete action of a localization.

  3. Confirm the deletion.

Delete a column definition

Required role: EDITOR or ADMIN.

  1. In the table, click Delete column for the columnKey.

  2. Confirm the deletion.

You cannot undo the deletion of a column definition. Other screens can use the columnKey. If they do, the UI can show the raw key or an empty label.

Export a snapshot

The Columns module has no Export in the UI.

If your process needs a backup or an audit trail, use your organization’s standard method. For example, add a note to the ticket and attach screenshots. Keep the safety order in mind: Export a Snapshot.

Import with dry-run

The Columns module has no Import in the UI. It has no dry-run for bulk changes.

If you make bulk changes with external tools, use the same safety rules and terms: Import with Dry-run.

Import safety checklist

  1. Check the environment name.

  2. Check the selected client type. It must match the file.

  3. Export a snapshot before you change data.

  4. Run Dry-run and review:

    • the errors: you must fix them,

    • the warnings: you must understand them,

    • the create, update, and delete counts.

  5. If you use REPLACE, review the deletions in the dry-run plan. Continue only if you accept them.

  6. Apply the import.

  7. Refresh the page and open the changed entries to check them.

Check the result

  1. Check if the new or changed localization shows as a locale badge in the list.

  2. Open Column Details and check the Locale and Localized Name values.

  3. Open a screen with this columnKey and check the label. Reload the page if needed.

  4. After you delete a localization, check if Column Details no longer lists it.

  5. After you delete a column definition, check if the Columns list no longer shows it.

Troubleshooting

You do not see New, Edit, or Delete

You are probably signed in as VIEWER. Ask an administrator for EDITOR or ADMIN access.

The search does not find the entry

The search filters by Column key. Search by the columnKey, not by the localized name.

Column key validation error

Column Key is required. It can have 50 characters at most. It must start with a Latin letter. It can contain only letters, digits, ., _, and -.

You cannot add a locale, or the locale is disabled

A localization with this locale already exists for the column. Each locale can appear only once.

You do not see your new label in the UI

Reload the page, or open the screen with the label again. Then check if you changed the correct columnKey and locale.

Delete fails

The backend can reject the action. Open the column again and check its state, then try again. If the problem remains, send the UI error message to an administrator.

Related pages

Columns: list and editor (placeholder)