Condividi tramite

CI/CD per le app dell'organizzazione in Fabric (Anteprima)

Questo articolo spiega come funziona l'integrazione Git e le pipeline di distribuzione per le app dell'organizzazione in Microsoft Fabric. Informazioni su come configurare una connessione al repository, gestire l'app dell'organizzazione tramite Git e distribuirla in ambienti diversi.

App aziendali e integrazione Git

Connettersi a un repository Git

Dalle impostazioni dell'area di lavoro configurare una connessione al repository per eseguire il commit e la sincronizzazione delle modifiche. Per configurare la connessione, vedere articolo Introduzione all'integrazione di Git.

Dopo la connessione, l'area di lavoro visualizza informazioni sul controllo del codice sorgente che consente di visualizzare il ramo connesso, lo stato di ogni elemento nel ramo e l'ora dell'ultima sincronizzazione.

Rappresentazione delle app dell'organizzazione in Git

Quando si esegue il commit dell'elemento dell'app dell'organizzazione nel repository Git, viene creata una cartella per ogni elemento e denominata {display name}.OrgApp. Contiene due file:

  • .platform file generato automaticamente dal sistema. Scopri di più dal file di sistema .
  • definition.json file che rappresenta la definizione dell'elemento dell'app dell'organizzazione.

Il file di definizione è suddiviso in due sezioni:

  • Impostazioni statiche: descrivere l'aspetto esterno dell'app, ad esempio il tema, il logo e le impostazioni dell'esperienza.
  • Elementi: descrivere la struttura interna dell'app.
    • Elementi della sezione: elementi contenitore che dispongono di una propria raccolta di app dell'organizzazione
    • Elementi dell'articolo: articoli di Power BI.

Il diagramma seguente illustra la struttura dell'app dell'organizzazione.

Diagramma che mostra la struttura di un elemento dell'app Org. Le impostazioni statiche vengono visualizzate sopra l'app Org e gli elementi seguono.

Il file di definizione contiene:

  • Impostazioni
    • Logo
    • Tema
      • Sfondo
      • Primo piano
      • BackgroundHover
      • Sfondo Selezionato
      • SfondoPremuto
    • Impostazioni Esperienza
      • Riquadro di navigazione
        • ÈNascosto
        • ÈCollassato
        • NavigazioneIndipendenteDellaPagina
    • ImpostazioniTipoDiElemento
    • Rapporto
      • HidePagePane
  • Elementi
    • ElementType (può essere: panoramica, sezione, elementoo collegamento)
    • ElementId
    • ItemType (solo per ElementType: elemento)
    • ItemLogicalId (solo per ElementType: elemento)
    • isHidden (non quando l'ElementoTipo è panoramica)
    • Nome visualizzato
    • Intestazione (solo per ElementType: panoramica )
      • Titolo
      • Corpo
      • MostraTema
    • Elementi (solo per ElementType: sezione )
    • URL (solo per ElementType: collegamento)
    • LinkType (solo per ElementType: collegamento. I valori sono embedded o newtab)

Il codice JSON seguente è un esempio del file definition.json per un elemento dell'app dell'organizzazione:

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

App dell'organizzazione nelle pipeline di distribuzione

È possibile usare la pipeline di distribuzione di Fabric per distribuire l'app dell'organizzazione in ambienti diversi, ad esempio sviluppo, test e produzione. È anche possibile usare le regole di distribuzione per personalizzare l'app dell'organizzazione.

Per informazioni su come usare le pipeline di distribuzione, vedere Introduzione alle pipeline di distribuzione.

Annotazioni

Limitazione: le app dell'organizzazione (anteprima) non possono essere distribuite nelle diverse fasi usando i principali di servizio.

Contenuto correlato