Formato del codice sorgente dell'integrazione Git

Gli elementi in Microsoft Fabric vengono archiviati in una cartella. La cartella contenente l'elemento può trovarsi nella directory radice o in una sottodirectory. Quando si connette l'area di lavoro a Git, connettersi alla cartella contenente gli elementi. Ogni elemento nella cartella è rappresentato nella propria sottodirectory. Queste directory di elementi hanno lo stesso nome dell'elemento seguito dal tipo di elemento.

Importante

Questa funzionalità è disponibile in anteprima.

Ogni directory di elementi contiene i file di definizione dell'elemento e uno o due file di sistema generati automaticamente.

File di definizione dell'elemento

La directory di ogni elemento include file obbligatori specifici che definiscono tale elemento.

Gli elementi seguenti sono attualmente supportati in Microsoft Fabric:

• Notebook
• Report impaginato
• - Report
• Modello semantico

File di notebook

Le cartelle del notebook contengono un file .py :

Per istruzioni sull'uso dell'integrazione di Git con i notebook, vedere Controllo del codice sorgente e distribuzione del notebook.

File di report impaginati

Le cartelle di report impaginate contengono un file con estensione rdl che definisce il report impaginato. RDL (Report Definition Language) è una rappresentazione XML di una definizione di report impaginata.

Per altre informazioni o RDL, vedere Report Definition Language (RDL). Per istruzioni sull'uso dell'integrazione di Git con i report impaginati, vedere Integrazione git con report impaginati.

File di report

Le cartelle del report contengono i file seguenti:

• definition.pbir
• report.json

Per altre informazioni sulle cartelle di report e un elenco completo dei relativi contenuti, vedere Cartella del report di progetto di Power BI Desktop.

File di modello semantico

Le cartelle del modello semantico contengono i file seguenti:

• definition.pbidataset
• file model.bim (formato TMSL) OR \definition folder (formato TMDL)

Per altre informazioni sulle cartelle dei modelli semantici e un elenco completo dei relativi contenuti, vedere Cartella del modello semantico del progetto di Power BI Desktop.

File di sistema generati automaticamente

Oltre ai file di definizione dell'elemento, ogni directory di elementi contiene uno o due file di sistema generati automaticamente, a seconda della versione in uso:

• Una directory versione 1 contiene item.metadata.json e item.config.json. Quando si usa V1, entrambi i file devono trovarsi nella directory .
• Una directory versione 2 contiene .platform. Questo file include il contenuto dei file item.metadata.json e item.config.json. Se si dispone di questo file, non è possibile avere gli altri due file. Se si usa la versione 1 e si esegue il commit delle modifiche, i file di sistema vengono aggiornati automaticamente a questa versione.

Nota

La directory deve contenere i item.metadata.json file e item.config.json o il .platform file . Non è possibile avere tutti e tre i file.

Versione 2

File della piattaforma

Nella versione 2, invece di avere due file di origine in ogni directory di elementi, il file con estensione platform combina tutte le informazioni in un unico file insieme a una proprietà $schema . Se si dispone di questo file, non è possibile avere gli altri due file.

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

Il .platform file contiene gli attributi seguenti:

• version: numero di versione dei file di sistema. Questo numero viene usato per abilitare la compatibilità con le versioni precedenti. Il numero di versione dell'elemento potrebbe essere diverso.
• logicalId: identificatore dell'area di lavoro incrociata generato automaticamente che rappresenta un elemento e la relativa rappresentazione del controllo del codice sorgente.
• type: (stringa) Tipo dell'elemento (modello semantico, report e così via)
• displayName: (stringa) Nome dell'elemento.
• description: (stringa facoltativa) Descrizione dell'elemento.

Versione 1

Se si usa la versione 1, sono presenti due file in ogni directory di elementi:

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

File di metadati

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

Il file item.metadata.json contiene gli attributi seguenti:

• type: (stringa) Tipo dell'elemento (modello semantico, report e così via)
• displayName: (stringa) Nome dell'elemento
• description: (stringa facoltativa) Descrizione dell'elemento

Per rinominare un elemento, modificare nel displayName file "item.metadata.json". La modifica del nome della cartella non modifica il nome visualizzato dell'elemento nell'area di lavoro.

File di configurazione

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

Il item.config.json file contiene gli attributi seguenti:

• version: numero di versione dei file di sistema. Questo numero viene usato per abilitare la compatibilità con le versioni precedenti. Il numero di versione dell'elemento potrebbe essere diverso.
• logicalId: identificatore dell'area di lavoro incrociata generato automaticamente che rappresenta un elemento e la relativa rappresentazione del controllo del codice sorgente.

LogicalId connette un elemento in un'area di lavoro con l'elemento corrispondente in un ramo Git. Si presuppone che gli elementi con gli stessi logicalId siano uguali. LogicalId mantiene il collegamento anche se il nome o la directory cambia. Poiché un ramo può essere sincronizzato con più aree di lavoro, è possibile avere elementi in aree di lavoro diverse con lo stesso logicalId, ma una singola area di lavoro non può avere due elementi con lo stesso logicalId. L'elemento logicalId viene creato quando l'area di lavoro è connessa a un ramo Git o viene sincronizzato un nuovo elemento. LogicalId è necessario per il corretto funzionamento dell'integrazione git. Pertanto, è essenziale non modificarlo in alcun modo.

Nota

Quando si esegue il commit delle modifiche in Git nella versione 1, i file di sistema vengono aggiornati automaticamente alla versione 2 insieme alle modifiche. Inoltre, tutti i nuovi file esportati dalla modalità sviluppatore di Power BI Desktop verranno salvati nel formato di file versione 2.

Nota

• Il campo di tipo fa distinzione tra maiuscole e minuscole. Non modificare il modo in cui viene generato automaticamente o potrebbe non riuscire.
• Anche se in genere non è consigliabile modificare il valore logicalId o il nome visualizzato di un elemento, è possibile che si verifichi un'eccezione se si sta creando un nuovo elemento copiando una directory di elementi esistente. In tal caso, è necessario modificare logicalId e il nome visualizzato in qualcosa di univoco nel repository.

Contenuto correlato

Introduzione all'integrazione con Git.