Translations
Print test reports in other languages, such as English, Turkish or Russian, whatever language you use SmartLIMS in. This page shows how to choose the languages, translate your own texts and the report wording, and translate right on a report.
Who this is for: laboratory owners and the people who translate reports · You need: the "Translate reports" permission (any role can be given it)
The idea in short
A report has its own language, separate from the language of the app. A lab in Serbia can use SmartLIMS in Serbian and still print a report in Turkish.
What a report prints comes from two places:
| Text | Examples | Where you translate it |
|---|---|---|
| Lab content: texts you entered | parameter and group names, a group's legend, request and sample field names, report template footers, the degree, specialisation and position of each signer | Once per record. The translation follows the record onto every report. |
| Results in words: results written as text | "nije detektovano", "odsustvo", "ne sadrži" | Once per text, for all parameters and reports. |
| Report wording: texts the app prints | "TEST REPORT No.", column headings, "End of report" | Once per language, for all reports. You can also change the app's wording in your own language. |
A text is translated as a whole, the way it prints: a parameter's name, or a legend with all its paragraphs. If the same text is already translated somewhere else (for example the same legend on another group), it is offered as a suggestion from the translation memory.
A text that isn't translated yet prints in the language's fallback language (for example English for Turkish), or in the language the lab writes in. The report then shows a warning, so nothing goes out half-translated without anyone noticing. A machine translation doesn't need approval. It is marked as such, and you can correct it at any time.
How to set the report languages
- Open Settings → Forms & reports → Translations, tab Languages.
- Under The lab writes in, choose the language your parameters, groups and forms are entered in. Every other language is translated from it.
- Under Reports print in, click Add language and pick one. Any language works, even one the app itself isn't in.
- Optionally, choose where it falls back to: another enabled language that prints when a text is missing.
- Optionally, set its number mark of a translated report: what an issued report translated into this language adds to its number (see Translate an issued report). Left empty, English uses E and other languages their code.
- Choose the Default report language. It is used for a customer who has no preferred language.
- Click Save changes.
How far each language is shows, for each language, how much is translated, machine-translated, changed since translated, or missing.
A customer can have a preferred language: open the customer, choose its Report language, and save. Its reports print in that language unless a report picks another.
📷 Screenshot: the Languages tab with Turkish falling back to English
How to translate texts on the Translations page
- Open the Lab content tab for your own texts, or Report wording for the app's texts.
- Choose the kind of text (Parameters, Groups of parameters, Forms, …), the language and, if you like, a status such as Not translated.
- Type the translation next to the source. It is saved as soon as you leave the field.
- For a longer text with formatting (a legend, a footer), click it to open the editor. Suggest fills in a translation from the memory, or a machine translation when machine translation is set up (Machine translation).
Machine-translate missing translates every text of that kind that has no translation yet in the chosen language. Each one is marked Machine translation until someone saves it.
Results in words (in Lab content) lists every result your lab has written in words. Translate "nije detektovano" once and every report in that language prints "not detected", whatever the parameter. Numbers are never on the list: they print as entered, with your company's decimal mark, and so does a number with a unit or a note typed after it ("330 mg/l"). Each way of writing is a separate text: "Odsustvo" and "odsustvo" are translated separately.
In Report wording, Use the app's text removes your change and brings back the app's wording.
Wording keeps placeholders such as %number%. A translation must keep them, otherwise it isn't saved.
Statuses
| Status | What it means |
|---|---|
| Translated | Someone saved this translation. |
| Machine translation | Translated automatically; not checked yet. |
| Source changed | The original text changed after it was translated. The old translation still prints; check it and save. |
| From memory | Not translated here, but the same text is translated elsewhere. |
| App text | Report wording not changed; the app's own text prints. |
| Not translated | Prints in the fallback language. |
How to translate on the report itself
- Open the report. Pick its language in the language box above the pages.
- If texts are missing, the warning above the pages says how many. Click Translate them, or click Translate in the ⋯ menu at the top right.
- Each text that can be translated is outlined and coloured by its status. Click a text to translate it. Shift+click translates its whole block, for example a results table or a legend, in one window.
- Choose where the translation goes:
- All reports: saved with the record or the wording it comes from, so every report in this language uses it.
- This report only: kept on this report, for a one-off wording.
- Click Save changes, then Done.
Texts that exist on one report only, such as a sample's name or the expert opinion, are always translated on that report. An expert opinion you changed with Edit texts is already in the report's language, so it prints as you wrote it and has nothing to translate.
📷 Screenshot: translation mode with a legend open in the translation window
Machine translation
Machine translation fills in Suggest and Machine-translate missing. Whoever manages the company chooses what does it, under Settings → Company → Machine translation:
- AI key (above), the default: the AI key in force, a person's own, the company's or the server's (AI keys).
- A translation service on the company's own account. Paste its key and click Save; the key is checked with the service first, stored encrypted and never shown again.
| Service | What it costs | What it needs |
|---|---|---|
| DeepL | DeepL API Free: 500,000 characters a month at no cost. Pro is paid per character. | An API key (a Free key ends in :fx). DeepL doesn't translate every language. |
| Google Cloud Translation | The first 500,000 characters a month are free, then paid per character. | An API key of a Google Cloud project with billing and the Cloud Translation API on. |
| Microsoft Azure Translator | The free tier (F0): 2 million characters a month at no cost. | The key of a Translator resource, and its region if it is not global. |
| Amazon Translate | Free-tier use for new AWS accounts, then paid per character. | An IAM access key ID and secret, and the region. |
| LibreTranslate | Free and open source; runs on a server of your own, so nothing leaves it. | Only offered when the server is set up for it. An API key only if that server asks for one. |
Back to the AI key deletes the service's key. If a service turns down a language pair, its credit runs out or the key stops working, Suggest says so; translate by hand or switch back.
Changing a report's language
A draft report can switch language at any time. Texts edited with Edit texts and translations made for that report only belong to its old language and are dropped, after you confirm.
An issued report keeps its language.
When you change a group's note with Edit texts on a translated report, Use for all reports saves your text as that note's translation, so every report in this language prints it.
Tips
- Translate a language's Report wording once before its first report. It is the same on every report.
- Send texts to a translation agency from the Import and export tab: Download XLIFF, then import the translated file. A text whose source changed since the export only goes to the memory.
- Fix a typo in the source text first. Its translations then show Source changed so you can check them.
- The "Translate reports" permission is separate from approving and issuing reports, so you can give it to a translator who doesn't do anything else.