> 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

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

Il supporto delle 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 Piattaforma \ Traduzioni nella Admin Console per definire le stringhe linguistiche.

![](/files/QF3Cnorp6yfHMwYWolGr)

Per definire una nuova lingua, clicchi su Crea nuova traduzione linguistica. L'ID della lingua deve essere l'[ID della lingua ](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)che il browser presenterà quando un utente accede all'API o alla dashboard (ad es. `en-US`)

![](/files/4gPZXsXcyJIpgoUwq1KZ)

Una volta creata la lingua, può iniziare ad aggiungervi stringhe cliccando su Modifica. La chiave sarà utilizzata all'interno dei suoi script e restituirà il valore. Il valore cambierà in base alla lingua.

![](/files/MOUUEyh0gGvIvz4iZxxT)

## Utilizzo delle stringhe

Per utilizzare una stringa, sfrutterà il nuovo provider `$tl:`. Utilizzando questo provider nei suoi script, la chiave verrà tradotta automaticamente 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`.

Le stringhe sono attualmente 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, le suggeriamo di utilizzare invece il provider `$tl:`. Il provider `$t:` verrà mappato sulle macchine 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 gli utenti visitano la pagina della dashboard o effettuano 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 es. `en-US`), PowerShell Universal tenterà di individuare la lingua migliore successiva. Ad esempio, cercherebbe quindi `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 Impostazioni \ Generale \ Piattaforma.

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

## File di lingua

I file di lingua 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 di lingua in questo modo per agevolare il copia e incolla delle chiavi tra i file di lingua.

![](/files/jFCHT8plVyRdlFEQr1d0)


---

# 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.