• Objectifs : scripter des objets du modèle en TMDL ; les modifier puis appliquer le script avec Aperçu et Appliquer ; créer des objets sans interface (perspectives, traductions, lignes de détail) ; garder et restaurer des versions du modèle.
• Prérequis : pages précédentes de la partie ; mesures DAX.
• Niveau : avancé.

TMDL - La vue TMDL▶ Présenter

1234567891011

createOrReplace

    ref table Ventes
        measure 'CA HT' = SUM(Ventes[Montant HT])
            formatString: #,##0.00 €
            displayFolder: Chiffre d'affaires

• createOrReplace crée l'objet s'il n'existe pas, et le remplace entièrement, avec ses descendants, s'il existe.
• ref table Ventes désigne la table sans la redéfinir : seule la mesure est créée ou remplacée.
• L'indentation par tabulations porte la structure ; un seul verbe de commande par script. Source

• Saisie semi-automatique (Ctrl + Espace), info-bulles, actions de code (ampoule).
• Mise en forme : Maj + Alt + F ; rechercher : Ctrl + F (expressions régulières acceptées) ; remplacer : Ctrl + H.
• Volet Problèmes pour les erreurs de syntaxe, volet Sortie pour les messages d'exécution.
• Plusieurs onglets de script, renommables.

createOrReplace

    perspective 'Vue commerciale'
        perspectiveTable Ventes
            perspectiveMeasure 'CA HT'
            perspectiveMeasure 'Quantité vendue'
            perspectiveColumn Date
        perspectiveTable Produit
            perspectiveColumn Catégorie
            perspectiveColumn Produit

createOrReplace

    cultureInfo en-US
        translations

            model Model

                table Ventes
                    caption: Sales
                    measure 'CA HT'
                        caption: Sales excl. VAT
                        description: Sum of sales amounts excluding VAT

createOrReplace

    ref table Ventes

        measure 'CA HT' = SUM ( Ventes[Montant HT] )
            formatString: #,##0.00 €
            displayFolder: Chiffre d'affaires

            detailRowsDefinition =
                    SELECTCOLUMNS (
                        Ventes,
                        "Date", Ventes[Date],
                        "Produit", RELATED ( Produit[Produit] ),
                        "Quantité", Ventes[Quantité],
                        "Montant HT", Ventes[Montant HT]
                    )

EVALUATE INFO.PERSPECTIVES ()
EVALUATE INFO.OBJECTTRANSLATIONS ()
EVALUATE INFO.DETAILROWSDEFINITIONS ()

• Passez toujours par Aperçu avant Appliquer, et gardez une version de référence avant une modification importante.
• sourceColumn (nom dans Power Query) et le nom de la colonne du modèle sont indépendants : renommer en TMDL n'ajoute pas d'étape dans Power Query.
• La méthode manuelle repose sur la discipline : pas d'historique partagé ni de fusion entre développeurs. Dans le service, l'historique des versions du modèle sémantique conserve jusqu'à cinq versions. Source
• Pour un suivi collaboratif, passez au projet PBIP avec Git (annexe Développeurs). Source

• La vue TMDL scripte, modifie et applique la définition du modèle sous forme de texte.
• Le cycle est toujours : scripter, modifier, Aperçu, Appliquer.
• Perspectives, traductions, lignes de détail et rôles OLS s'y créent en quelques lignes.
• Un onglet de script nommé sert de version restaurable du modèle.

• Utiliser la vue TMDL dans Power BI Desktop. Source (Microsoft Learn)
• Vue d'ensemble du langage TMDL. Source (Microsoft Learn)
• Projet Power BI Desktop : dossier du modèle sémantique. Source (Microsoft Learn)
• Extension TMDL pour Visual Studio Code. Source (Visual Studio Marketplace)

1. Ouvrez le fichier du fil rouge, scriptez le modèle entier et renommez l'onglet v01 | date | état initial.
2. Dans un nouvel onglet, scriptez la table de faits et ajoutez deux mesures avec leur formatString et leur displayFolder ; Aperçu, puis Appliquer.
3. Renommez en masse les colonnes d'une table (rechercher et remplacer) et constatez l'effet sur un visuel.
4. Créez la perspective « Vue commerciale » et vérifiez-la avec INFO.PERSPECTIVES.
5. Revenez à l'onglet v01, faites un Aperçu pour lister les écarts, puis Appliquer pour restaurer l'état initial.