Traductions dans les modèles tabulaires

  • Article

S’applique à : SQL Server 2017 et versions ultérieures Analysis Services Azure Analysis Services Fabric/Power BI Premium

Dans les modèles tabulaires, un objet peut avoir plusieurs traductions d’un nom ou d’une description, ce qui permet de prendre en charge des versions multilingues dans la définition du modèle.

Les chaînes traduites sont destinées aux métadonnées d’objet uniquement (noms et descriptions des tables et colonnes) qui s’affichent dans un outil client tel qu’une liste de tableau croisé dynamique Excel. Pour utiliser des chaînes traduites, la connexion cliente spécifie la culture. Dans la fonctionnalité Analyse dans Excel , vous pouvez choisir la langue dans la liste déroulante. Pour d’autres outils, vous devrez peut-être spécifier la culture dans la chaîne de connexion.

Cette fonctionnalité n’est pas prévue pour charger les données traduites dans un modèle. Si vous souhaitez charger les valeurs des données traduites, vous devez développer une stratégie de traitement qui inclut l’extraction des chaînes traduites à partir de la source de données qui les fournit.

Voici un flux de travail typique pour l’ajout de métadonnées traduites :

  • Générer un fichier JSON de traduction vide qui contient des espaces réservés pour chaque traduction de chaîne

  • Ajouter des traductions de chaîne dans le fichier JSON

  • Réimporter les traductions dans le modèle

  • Générer, traiter ou déployer le modèle

  • Se connecter au modèle à l’aide d’une application cliente qui accepte un LCID dans la chaîne de connexion

Créer un fichier de traduction vide

Utilisez Visual Studio pour ajouter des traductions au projet de modèle.

  1. Cliquez sur Extensions>Model>Translations Manage>Translations( Gérer les traductions).

  2. Sélectionnez les langues pour lesquelles vous fournissez des traductions, puis cliquez sur Ajouter.

  3. Choisissez une ou plusieurs langues dans la liste, en fonction de la façon dont vous souhaitez importer les chaînes ultérieurement.

    Votre fichier de traduction peut inclure plusieurs langues, mais la gestion des traductions est plus facile si vous créez un fichier de traduction par langue. Le fichier de traduction que vous créez maintenant sera importé dans son intégralité ultérieurement. Pour modifier les options d’importation par langue, chaque langue doit avoir son propre fichier.

  4. Cliquez sur Exporter le fichier de langue. Indiquez un nom de fichier et un emplacement.

    Capture d’écran de la boîte de dialogue Gérer les traductions avec chacune des étapes numérotées de cette section indiquées.

Ajouter des traductions

Un fichier de traduction JSON vide inclut des métadonnées pour les traductions propres à une langue. Les espaces réservés aux traductions pour les noms d’objets et les descriptions sont spécifiés dans la section Culture à la fin de la définition du modèle. Des traductions peuvent être ajoutées pour les éléments suivants :

Propriété Description
translatedCaption Titre de table ou de colonne qui s’affiche dans les applications clientes prenant en charge les visualisations d’un modèle tabulaire.
translatedDescription Moins fréquentes que les légendes. Une description s’affiche en tant qu’informations de modèle dans un outil de modélisation comme SSDT.

Ne supprimez pas de métadonnées non spécifiées du fichier. Elles doivent correspondre au fichier sur lequel elles sont basées. Ajoutez simplement les chaînes de votre choix, puis enregistrez le fichier.

Bien qu’elle puisse ressembler à quelque chose que vous devez modifier, la section referenceCulture contient les métadonnées dans la culture par défaut du modèle. Les modifications apportées à la section referenceCulture ne sont pas lues pendant l’importation et sont ignorées.

L’exemple suivant montre des légendes et une description traduites pour les tables DimProduct et DimCustomer .

Capture d’écran du json de traduction.

Conseil

Vous pouvez utiliser n’importe quel éditeur JSON pour ouvrir le fichier, mais nous vous recommandons d’utiliser l’éditeur JSON dans Visual Studio. Utilisez la commande Afficher le code dans l’Explorateur de solutions pour afficher la définition de modèle tabulaire.

Importer un fichier de traduction

Les chaînes de traduction que vous importez deviennent partie intégrante de la définition du modèle. Une fois que les chaînes sont importées, le fichier de traduction n’est plus référencé.

  1. Cliquez sur Extensions>Model>Translations Importer>des traductions.

  2. Recherchez le fichier de traduction, puis cliquez sur Ouvrir.

  3. Vous pouvez également spécifier des options d’importation.

    Option d’importation Description
    Remplacer les traductions existantes Remplace toutes les légendes ou descriptions existantes de la même langue que le fichier importé.
    Ignorer les objets non valides Spécifie si les différences de métadonnées doivent être ignorées ou marquées comme erreur.
    Écrire les résultats d’importation dans un fichier journal Par défaut, les fichiers journaux sont enregistrés dans le dossier du projet. Le chemin d’accès exact du fichier est fourni une fois l’importation terminée. Le nom du fichier journal est SSDT_Translations_Log_<timestamp>.
    Sauvegarder les traductions dans un fichier JSON avant l’importation Sauvegarde une traduction existante qui correspond à la culture des chaînes importées. Si la culture en cours d’importation n’est pas présente dans le modèle, la sauvegarde est vide.

    Si vous devez restaurer ce fichier ultérieurement, vous pouvez remplacer le contenu de model.bim par ce fichier JSON.

  4. Cliquez sur Importer.

  5. Si vous avez généré un fichier journal ou une sauvegarde, vous pouvez éventuellement trouver les fichiers dans le dossier du projet.

  6. Pour vérifier l’importation, procédez comme suit :

    • Cliquez avec le bouton droit sur le fichier model.bim dans l’Explorateur de solutions et choisissez Afficher le code. Cliquez sur Oui pour fermer le mode de création et rouvrir model.bim en mode Code. Si vous avez installé une version complète de Visual Studio, notamment l’édition Community gratuite, le fichier s’ouvre dans l’éditeur JSON intégré.

    • Recherchez Culture ou une chaîne traduite spécifique pour vérifier que les chaînes apparaissent bien comme vous le souhaitez.

Se connecter à l’aide d’un identificateur de paramètres régionaux

Cette section décrit une approche qui permet de valider les chaînes renvoyées à partir du modèle.

  1. Dans Excel, connectez-vous au modèle tabulaire. Cette étape suppose que le modèle a été déployé. Si le modèle n’existe que dans l’espace de travail, déployez-le sur une instance Analysis Services pour effectuer le contrôle de validation.

    Vous pouvez également utiliser la fonctionnalité Analyser dans Excel pour vous connecter au modèle.

  2. Dans la boîte de dialogue Connexion Excel, choisissez la culture pour laquelle des traductions de chaîne existent dans votre modèle. Excel détecte les cultures définies dans le modèle et remplit la liste déroulante en conséquence.

    Capture d’écran de la boîte de dialogue avec les langues valides répertoriées dans la liste déroulante.

    Lorsque vous créez un tableau croisé dynamique, vous devez voir le tableau et les noms de colonnes traduits.

Voir aussi

Scénarios de globalisation pour Analysis Services
Analyser dans Excel