P4 Software / activoHQ English

Translations (languages)

Translations (languages)

Overview

The Translations screen lets system administrators manage ActivoHQ's dictionary of labels and interface text in Spanish and English. From here you can add new translation keys, edit the existing text directly in the table, and import or export the whole catalog as CSV. Changes take effect immediately across the platform.

How to get there

Settings > Translations

URL: /Settings/translations

Key concepts

Term Definition
Key The unique identifier of a piece of interface text (usually in English), for example "Asset" or "Depreciation Book".
Translation The text the user sees in the selected language, for example "Activo" or "Libro de depreciación".
Language Which catalog you are managing: Español (es) or English (en).
Upsert An insert-or-update operation: if the key already exists its value is updated; if not, it is created.
Translations CSV A text file with two columns (Key,Value) that can be imported or exported for bulk editing outside the platform.

How to use it

Switch the working language

  1. In the Language field, choose Español (es) or English (en) for the catalog you want to edit.
  2. The table refreshes automatically and shows the selected language's translations.

Edit an existing translation

  1. Find the key you want in the Key column (you can use the column filter or sorting).
  2. Click the editable field in that row's Translation column.
  3. Type or correct the text, then move focus out of the field (Tab, Enter, or click elsewhere).
  4. The system saves the change automatically and shows the Saved notification.

The change takes effect immediately across the platform, with no restart needed.

Add a new translation key

  1. In the New key field, enter the key's English identifier (for example, "Custom Report") - the field's placeholder reads English key.
  2. In the Translation field, enter the matching text in the selected language.
  3. Click Add.
  4. The system shows the Added notification and the new key appears in the table.

The Add button stays disabled while the New key field is empty.

Import translations from a CSV file

  1. Click Import.
  2. Your operating system's file picker opens. Select a .csv file.
  3. The system processes the file and applies an upsert per valid row (inserting if the key does not exist, updating if it does).
  4. When it finishes, the notification N translations imported appears, where N is the number of rows processed.

Export the catalog to CSV

  1. Click Export, at the top of the screen.
  2. The browser automatically downloads a file named translations-es.csv (or translations-en.csv, per the active language).
  3. That file can be opened in a spreadsheet for bulk editing and reimported afterwards.

Refresh the table

Click the Refresh icon button (the reload icon) to reload the data from the server without refreshing the whole browser page.

Fields

Quick actions panel (the card's top bar)

Field Type Required Description Validation
Language Drop-down Yes Selects the catalog language to manage: Español (es) or English (en). Default: Español (es). Only the two available values are accepted.
New key Text field Yes (to add) The new translation key's identifier. Use the English text exactly as it appears in the source code. Cannot be empty when you click Add.
Translation Text field No The translated text the user will see in the selected language. It can be left empty and completed later from the table. No format restrictions. Line breaks are not supported.

Translations table

Column Type Editable Description
Key Text (read-only) No The translation key's unique identifier, shown in bold. It supports sorting and Excel-style filtering.
Translation Inline text field Yes The text's value for the selected language. It saves automatically when you leave the field. It does not support column filtering.

The table shows 25 rows per page by default. You can switch to 50 or 100 rows per page with the paging control at the bottom.

Empty state

If no translations exist for the selected language, the table shows:

No translations found Add a key or import a CSV to get started.

CSV file format

The translations CSV file has these characteristics:

  • Encoding: UTF-8
  • Delimiter: comma (,)
  • Header row: Key,Value (required on export; on import, if the first row starts with Key, it is skipped automatically)
  • Quoting: fields are delimited with double quotes; embedded quotes are doubled (RFC-4180 style)
  • Line breaks inside a field: not supported
  • Maximum import size: 5 MB

An example of valid content:

Key,Value
"Asset","Activo"
"Depreciation Book","Libro de depreciación"
"Save","Guardar"

Permissions

Available to users with access to the Settings module, as configured by your administrator.

Notes

  • Translations are stored in a catalog shared at the platform level. Changes made on this screen affect every user's interface immediately, whatever language is active in their session.
  • If you edit a key in the language currently in use, the system updates the dictionary in real time with no need to sign out.
  • The CSV import is additive (upsert): it does not delete existing keys that are absent from the imported file; it only inserts new ones and updates those matched by key.
  • The base catalog holds roughly 365 keys covering every ActivoHQ module. Exporting the catalog before making bulk changes is recommended as a backup.

Troubleshooting

Symptom Likely cause Resolution
The Add button is disabled The New key field is empty or contains only spaces. Enter a valid key identifier before clicking Add.
The notification shows Error: ... when editing inline A connection or validation error while saving. Read the error message. Retry the edit, or use Refresh to reload the table.
The CSV file will not import correctly The file is over 5 MB, does not have a .csv extension, or the format does not follow RFC-4180. Check that the file is under 5 MB, has the right extension and uses a comma as the delimiter.
Changes are not reflected in the interface immediately The browser may be using a cached version of the translations. Click Refresh or reload the browser page (F5).
No translations show in the table The selected language has no keys registered yet. Import a CSV file, or add keys by hand using the form at the top.

Related

Was this page helpful?

Previous Report designer Next Developer API