Traductions

Traduire des chaînes de caractères entre les langues.

Les traductions nécessitent une licence.

La prise en charge des traductions offre la possibilité d'utiliser un fournisseur spécial pour retourner des chaînes de caractères en fonction de la langue de l'utilisateur accédant à l'API ou au tableau de bord.

Définir des chaînes de caractères

Naviguez vers Platform \ Translations dans la console d'administration pour définir les chaînes de langue.

Pour définir une nouvelle langue, cliquez sur Create New Language Translation. L'identifiant de langue doit être l'identifiant de langue que le navigateur présentera lorsqu'un utilisateur accède à l'API ou au tableau de bord (ex. en-US)

Une fois la langue créée, vous pouvez commencer à y ajouter des chaînes de caractères en cliquant sur Modifier. La clé sera utilisée dans vos scripts et retournera la valeur. La valeur changera en fonction de la langue.

Utiliser des chaînes de caractères

Pour utiliser une chaîne de caractères, vous tirerez parti du nouveau fournisseur $tl:. L'utilisation de ce fournisseur dans vos scripts traduira automatiquement la clé vers la chaîne correspondant à la langue de l'utilisateur.

Par exemple, vous utiliseriez la variable de cette façon.

$tl:String1

La valeur retournée, lorsque la langue de l'utilisateur est en, sera USA.

Les chaînes de caractères sont actuellement disponibles automatiquement dans les API et les tableaux de bord, ainsi que dans les scripts lors de la définition de la variable LanguageID.

Notez que le fournisseur $t: est également disponible, mais en raison de conflits avec le fournisseur FileSystem et les lecteurs T: mappés, nous vous suggérons d'utiliser le fournisseur $tl: à la place. Le fournisseur $t: sera mappé sur les machines qui ne disposent pas déjà d'un lecteur T: mappé.

Sélectionner une langue

PowerShell Universal sélectionne la langue de l'utilisateur en examinant l'en-tête Accept-Language dans la requête HTTP lorsque les utilisateurs visitent la page du tableau de bord ou effectuent un appel API. Si vous souhaitez définir une langue lors de l'exécution d'un script, vous devrez définir la variable $LanguageID sur la langue que vous souhaitez retourner.

Logique de repli

Si une langue n'est pas définie pour l'identifiant de langue spécifique (ex. en-US), PowerShell Universal tentera de localiser la prochaine langue la plus appropriée. Par exemple, il rechercherait alors en.

Si aucune langue ne peut être trouvée, la langue de repli à l'échelle du serveur sera utilisée. Si celle-ci n'a pas été définie, en sera utilisé. Vous pouvez spécifier cette langue de repli dans Settings \ General \ Platform.

Si aucune langue ne peut être trouvée pour la clé spécifiée, la clé sera retournée.

Fichiers de langue

Les fichiers de langue sont générés dans le dossier translations au sein du référentiel. Chaque langue disposera d'un fichier .ps1 nommé d'après l'identifiant de langue. New-PSUTranslation est utilisé pour définir la langue et définir les chaînes de caractères.

Il peut être souhaitable de modifier les fichiers de langue de cette façon pour faciliter le copier-coller des clés entre les fichiers de langue.