CI/CD för organisationsappar i Fabric (förhandsversion)

2025-06-06

Den här artikeln beskriver hur Git-integrering och distributionspipelines fungerar för organisationsappar i Microsoft Fabric. Lär dig hur du konfigurerar en anslutning till lagringsplatsen, hanterar din organisationsapp via Git och distribuerar den i olika miljöer.

Organisationsappar och Git-integrering

Ansluta till en Git-lagringsplats

Från arbetsytans inställningar konfigurerar du en anslutning till ditt kodförråd för att utföra en commit och synkronisera ändringar. Information om hur du konfigurerar anslutningen finns i artikeln Kom igång med Git-integrering.

När du har anslutit visar arbetsytan information om källkontroll som gör att du kan visa den anslutna grenen, status för varje objekt i grenen och tidpunkten för den senaste synkroniseringen.

Representation av organisationsappar i Git

När du checkar in organisationsappobjektet på Git-lagringsplatsen skapas en mapp för varje objekt med namnet {display name}.OrgApp. Den innehåller två filer:

.platform fil som genereras automatiskt av systemet. Läs mer om systemfil.
definition.json fil som är definitionen av organisationsappobjektet.

Definitionsfilen är uppdelad i två avsnitt:

Statiska inställningar: Beskriv appens externa utseende, till exempel tema, logotyp och upplevelseinställningar.
Element: beskriva appens interna struktur.
- Sektionselement: Containerelement som har en egen samling av Org-appar
- Objektelement: Power BI-objekt.

Följande diagram visar organisationsappens struktur.

Definitionsfilen innehåller:

Inställningar
- Logotyp
- Tema
  - Bakgrund
  - Förgrund
  - BackgroundHover
  - BakgrundVald
  - BakgrundTryckt
- Upplevelseinställningar
  - Navigeringsfönster
    - IsHidden
    - ÄrKomprimerad
    - IndependentPageNavigation
- Inställningar för objekt-typ
- Rapport
  - Dölj Sidopanel
Elementen
- ElementType (kan vara: översikt, avsnitt, objekteller länk)
- ElementId
- ItemType (endast för ElementType: objekt)
- ItemLogicalId (endast för ElementType: objekt)
- isHidden (inte när ElementType: översikt)
- Visningsnamn
- Rubrik (endast för ElementType: översikt)
  - Titel
  - Kropp
  - Visa tema
- Element (endast för ElementType: sektion)
- Url (endast för ElementType: länk)
- LinkType (endast för ElementType: länk. Värden är inbäddad eller ny flik)

Följande JSON-kod är ett exempel på definition.json-filen för ett organisationsappobjekt:

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/orgapp/definition/orgAppDefinition/1.0.0/schema.json",
  "settings": {
    "theme": {
      "background": "#2fb136",
      "foreground": "#000000",
      "backgroundHover": "#59c15e",
      "backgroundSelected": "#82d086",
      "backgroundPressed": "#ace0af"
    }
  },
  "elements": [
    {
      "elementType": "item",
      "elementId": "08e649a9-0fe6-40bd-b0c3-7fc900b7550f",
      "itemType": "Report",
      "itemLogicalId": "e0fa7df4-5528-4c37-bf2c-9ec02ffef18d",
      "isHidden": false,
      "displayName": "Daily Dashboard"
    },
    {
      "elementType": "item",
      "elementId": "410f87ee-8402-49b0-abbb-31cb69dc1ebc",
      "itemType": "SemanticModel",
      "itemLogicalId": "8f633535-6fb4-467f-a668-6bc55c5735b8",
      "isHidden": false,
      "displayName": "410f87ee-8402-49b0-abbb-31cb69dc1ebc"
    }
  ]
}

Organisationsappar i implementeringspipelines

Du kan använda Fabric-distributionspipeline för att distribuera din organisations app i olika miljöer, till exempel utveckling, test och produktion. Och du kan använda distributionsregler för att anpassa organisationsappen.

Information om hur du använder distributionspipelines finns i Introduktion till distributionspipelines.

Anmärkning

Begränsning: Organisationsappar (förhandsversion) kan inte distribueras över olika steg med hjälp av tjänstehuvudprinciper.

Feedback

Var den här sidan till hjälp?