Traduzioni
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.
Per definire una nuova lingua, clicchi su Crea nuova traduzione linguistica. L'ID della lingua deve essere l'ID della lingua che il browser presenterà quando un utente accede all'API o alla dashboard (ad es. en-US)
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.
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.
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.
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.
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.
Ultimo aggiornamento
È stato utile?