Git-integrációs forráskód formátuma

A Microsoft Fabric elemei egy mappában vannak tárolva. Az elemet tartalmazó mappa lehet a gyökérkönyvtárban vagy egy alkönyvtárban. Amikor a munkaterületet a githez csatlakoztatja, csatlakozzon az elemeket tartalmazó mappához. A mappa minden eleme saját alkönyvtárában jelenik meg. Ezek az elemkönyvtárak neve megegyezik az elem nevével, amelyet az elem típusa követ.

Fontos

Ez a funkció előzetes verzióban érhető el.

Minden elemkönyvtár tartalmazza az elemdefiníciós fájlokat és egy vagy két automatikusan létrehozott rendszerfájlt.

Elemdefiníciós fájlok

Minden elem könyvtárában vannak olyan kötelező fájlok, amelyek meghatározzák az adott elemet.

A Microsoft Fabric jelenleg a következő elemeket támogatja:

• Jegyzetfüzet
• Többoldalas jelentés
• Jelentés
• Szemantikai modell

Jegyzetfüzetfájlok

A jegyzetfüzetmappák .py fájlt tartalmaznak:

A Git-integráció jegyzetfüzetekkel való használatával kapcsolatos utasításokért lásd a jegyzetfüzet forráskezelését és üzembe helyezését.

Többoldalas jelentésfájlok

A lapszámozott jelentésmappák egy .rdl fájlt tartalmaznak, amely meghatározza a lapszámozott jelentést. Az RDL (jelentésdefiníció nyelve) egy többoldalas jelentésdefiníció XML-reprezentációja.

Az RDL-ről további információt a jelentésdefiníciós nyelv (RDL) című témakörben talál. A Git-integráció lapszámozott jelentésekkel való használatával kapcsolatos utasításokért lásd : Git-integráció lapszámozott jelentésekkel.

Jelentésfájlok

A jelentésmappák a következő fájlokat tartalmazzák:

• definition.pbir
• report.json

A jelentésmappákról és azok teljes listájáról további információt a Power BI Desktop projektjelentési mappájában talál.

Szemantikai modellfájlok

A szemantikai modellmappák a következő fájlokat tartalmazzák:

• definition.pbidataset
• model.bim fájl (TMSL formátum) VAGY \definition mappa (TMDL formátum)

A szemantikai modellmappákról és azok teljes listájáról további információt a Power BI Desktop projekt szemantikai modellmappájában talál.

Automatikusan létrehozott rendszerfájlok

Az elemdefiníciós fájlok mellett minden elemkönyvtár tartalmaz egy vagy két automatikusan létrehozott rendszerfájlt attól függően, hogy melyik verziót használja:

• Az 1-es verziójú címtár item.metadata.json és item.config.json tartalmaz. V1 használatakor mindkét fájlnak a könyvtárban kell lennie.
• A 2-es verziójú címtár .platformot tartalmaz. Ez a fájl item.metadata.json és item.config.json fájlok tartalmát is tartalmazza. Ha rendelkezik ezzel a fájllal, nem rendelkezhet a másik két fájllal. Ha az 1-es verziót használja, és módosításokat véglegesítenek, a rendszer fájljai automatikusan erre a verzióra frissülnek.

Feljegyzés

A címtárnak tartalmaznia kell a fájlokat és a item.metadata.json fájlokat .platform.item.config.json Nem lehet mind a három fájl.

2-es verzió

Platformfájl

A 2. verzióban a .platform fájl ahelyett, hogy minden elemkönyvtárban két forrásfájlt tartalmaz, az összes információt egyetlen fájlba egyesíti egy $schema tulajdonsággal. Ha rendelkezik ezzel a fájllal, nem rendelkezhet a másik két fájllal.

{
    "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"
    }
}

A .platform fájl a következő attribútumokat tartalmazza:

• version: A rendszerfájlok verziószáma. Ez a szám a visszamenőleges kompatibilitás engedélyezésére szolgál. Az elem verziószáma eltérő lehet.
• logicalId: Egy elem és a forrásvezérlő ábrázolása automatikusan létrehozott munkaterületközi azonosító.
• type: (sztring) Az elem típusa (szemantikai modell, jelentés stb.)
• displayName: (karakterlánc) Az elem neve.
• description: (nem kötelező sztring) Az elem leírása.

1-es verzió

Ha az 1-es verziót használja, minden elemkönyvtárban két fájl található:

• 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", 
} 

Metaadatfájl

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

A item.metadata.json fájl a következő attribútumokat tartalmazza:

• type: (sztring) Az elem típusa (szemantikai modell, jelentés stb.)
• displayName: (karakterlánc) Az elem neve
• description: (nem kötelező sztring) Az elem leírása

Egy elem átnevezéséhez módosítsa a displayName "item.metadata.json" fájlban lévő elemet. A mappa nevének módosítása nem változtatja meg a munkaterületen lévő elem megjelenítendő nevét.

Konfigurációs fájl

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

A item.config.json fájl a következő attribútumokat tartalmazza:

• version: A rendszerfájlok verziószáma. Ez a szám a visszamenőleges kompatibilitás engedélyezésére szolgál. Az elem verziószáma eltérő lehet.
• logicalId: Egy elem és a forrásvezérlő ábrázolása automatikusan létrehozott munkaterületközi azonosító.

A logikai azonosító összekapcsolja a munkaterület egy elemét egy Git-ág megfelelő elemével. Az azonos logikai azonosítókkal rendelkező elemeket a rendszer azonosnak tekinti. A logikai azonosító akkor is megőrzi a hivatkozást, ha a név vagy a könyvtár megváltozik. Mivel egy ág több munkaterületre is szinkronizálható, lehetséges, hogy a különböző munkaterületeken lévő elemek azonos logikai azonosítóval rendelkeznek, de egyetlen munkaterületen nem lehet két azonos logikai azonosítójú elem. A logikai azonosító akkor jön létre, ha a munkaterület egy Git-ághoz csatlakozik, vagy egy új elem szinkronizálása történik. A logikai azonosító szükséges ahhoz, hogy a Git-integráció megfelelően működjön. Ezért alapvető fontosságú, hogy semmilyen módon ne változtassa meg.

Feljegyzés

Amikor az 1. verzióban véglegesíti a Git módosításait, a rendszerfájlok automatikusan frissülnek a 2- es verzióra a módosításokkal együtt. Emellett a Power BI Desktop fejlesztői módban exportált új fájlok a 2- es verziójú fájlformátumban lesznek mentve.

Feljegyzés

• A típusmező megkülönbözteti a kis- és nagybetűk értékét. Ne módosítsa az automatikus létrehozás módját, vagy sikertelen lehet.
• Bár általában nem szabad módosítania egy elem logikai azonosítóját vagy megjelenítendő nevét , egy kivétel lehet, ha egy meglévő elemkönyvtár másolásával hoz létre új elemet. Ebben az esetben a logikai azonosítót és a megjelenítendő nevet az adattárban egyedire kell módosítania.

Kapcsolódó tartalom

Ismerkedés a Git-integrációval.