> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/it/piattaforma/translations.md).

# Traduzioni

Configuri le traduzioni delle lingue in PowerShell Universal per fornire stringhe localizzate nelle API e nelle dashboard in base alle impostazioni locali del browser di ogni utente.

{% hint style="info" %}
Le traduzioni richiedono una [licenza](https://store.devolutions.net/package#psu).
{% endhint %}

Il supporto per le traduzioni offre la possibilità di utilizzare un provider speciale per restituire stringhe in base alla lingua dell'utente che accede all'API o alla dashboard.

## Definizione delle stringhe

Vada su **Ingranaggio Impostazioni > Traduzioni** nella Admin Console per definire le stringhe della lingua.

Per definire una nuova lingua, faccia clic su Create New Language Translation. L'ID della lingua deve corrispondere all'ID della lingua che il browser presenterà quando un utente accede all'API o alla dashboard (ad esempio `en-US`).

Dopo aver creato la lingua, può iniziare ad aggiungere stringhe facendo clic su Edit. La chiave verrà utilizzata all'interno degli script e restituirà il valore. Il valore cambierà in base alla lingua.

## Utilizzo delle stringhe

Per utilizzare una stringa, sfrutterà il nuovo provider `$tl:`. L'utilizzo di questo provider negli script tradurrà automaticamente la chiave nella stringa corrispondente alla lingua dell'utente.

Ad esempio, utilizzerebbe la variabile in questo modo.

```powershell
$tl:String1
```

Il valore restituito, quando le impostazioni locali dell'utente sono en, sarà `USA`.

Attualmente le stringhe sono disponibili automaticamente nelle API e nelle dashboard e negli script quando si imposta la variabile `LanguageID`.

{% hint style="warning" %}
Tenga presente che è disponibile anche il provider `$t:`, ma a causa di conflitti con il provider FileSystem e le unità T: mappate, suggeriamo di utilizzare invece il provider `$tl:`. Il provider `$t:` verrà mappato sui computer che non hanno già un'unità T: mappata.
{% endhint %}

## Selezione di una lingua

PowerShell Universal seleziona la lingua dell'utente esaminando l'intestazione `Accept-Language` nella richiesta HTTP quando l'utente visita la pagina della dashboard o effettua una chiamata API. Se desidera impostare una lingua durante l'esecuzione di uno script, dovrà impostare la variabile `$LanguageID` sulla lingua che desidera restituire.

### Logica di fallback

Se non è definita una lingua per l'ID lingua specifico (ad esempio `en-US`), PowerShell Universal tenterà di individuare la lingua più adatta successiva. Ad esempio, in questo caso cercherebbe `en`.

Se non è possibile trovare alcuna lingua, verrà utilizzata la lingua di fallback definita a livello di server. Se non è stata definita, verrà utilizzata `en`. Può specificare la lingua di fallback in **Ingranaggio Impostazioni > General**.

Se non è possibile trovare alcuna lingua per la chiave specificata, verrà restituita la chiave.

## File delle lingue

I file delle lingue vengono generati nella cartella translations all'interno del repository. Ogni lingua avrà un file `.ps1` denominato in base all'ID della lingua. `New-PSUTranslation` viene utilizzato per definire la lingua e impostare le stringhe.

Potrebbe essere preferibile modificare i file delle lingue in questo modo per agevolare il copia e incolla delle chiavi tra i file delle lingue.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/it/piattaforma/translations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.