Freigeben über

CI/CD für Organisations-Apps in Fabric (Vorschau)

In diesem Artikel wird erläutert, wie die Git-Integration und Bereitstellungspipelines für Organisations-Apps in Microsoft Fabric funktionieren. Erfahren Sie, wie Sie eine Verbindung mit Ihrem Repository einrichten, Ihre Organisations-App über Git verwalten und in verschiedenen Umgebungen bereitstellen.

Organisations-Apps und Git-Integration

Herstellen einer Verbindung mit einem Git-Repository

Richten Sie in ihren Arbeitsbereichseinstellungen eine Verbindung mit Ihrem Repository ein, um Änderungen zu übernehmen und zu synchronisieren. Informationen zum Einrichten der Verbindung finden Sie im Artikel Erste Schritte mit der Git-Integration Artikel.

Nachdem Sie eine Verbindung hergestellt haben, zeigt der Arbeitsbereich Informationen zur Quellcodeverwaltung an, mit der Sie die verbundene Verzweigung, den Status der einzelnen Elemente in der Verzweigung und die Uhrzeit der letzten Synchronisierung anzeigen können.

Darstellung von Organisations-Apps in Git

Wenn Sie das Organisations-App-Element auf das Git-Repository übernehmen, wird für jedes Element ein Ordner mit dem Namen {display name}.OrgApperstellt. Sie enthält zwei Dateien:

  • .platform Datei, die automatisch vom System generiert wird. Erfahren Sie mehr über die Systemdatei .
  • definition.json-Datei, die das Organisations-App-Element definiert.

Die Definitionsdatei ist in zwei Abschnitte unterteilt:

  • Statische Einstellungen: Beschreiben sie die externe Darstellung der App, z. B. das Design, das Logo und die Erfahrungseinstellungen.
  • Elemente: Beschreiben der internen Struktur der App.
    • Abschnittselemente: Containerelemente, die über eine eigene Sammlung von Organisations-Apps verfügen
    • Artikelelemente: Power BI-Elemente.

Das folgende Diagramm zeigt die Struktur der Organisations-App.

Diagramm mit der Struktur eines Organisations-App-Elements. Die statischen Einstellungen werden oberhalb der Organisations-App angezeigt, und die Elementelemente folgen ihr.

Die Definitionsdatei enthält:

  • Einstellungen
    • Logo
    • Design
      • Hintergrund
      • Vordergrund
      • BackgroundHover
      • HintergrundAusgewählt
      • HintergrundGedrückt
    • Erlebnis-Einstellungen
      • NavigationPane
        • IstVerborgen
        • IsCollapsed
        • Unabhängige Seitennavigation
    • Elementtyp-Einstellungen
    • Bericht
      • HidePagePane
  • Elemente
    • ElementType (kann sein: Übersicht, Abschnitt, Elementoder Link)
    • ElementId
    • ItemType (nur für ElementType: Element)
    • ItemLogicalId (nur für Elementtyp: Element)
    • isHidden (nicht wenn für ElementType: Übersicht)
    • Anzeigename
    • Kopfzeile (nur für Elementtyp: Übersicht)
      • Titel
      • Körper
      • Thema anzeigen
    • Elemente (nur für ElementType: Abschnitt)
    • URL (nur für ElementType: Link)
    • LinkType (nur für ElementType: Link. Werte sind embedded oder newtab)

Der folgende JSON-Code ist ein Beispiel für die definition.json-Datei für ein Organisations-App-Element:

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

Organisations-Apps in Bereitstellungspipelines

Sie können die Fabric-Bereitstellungspipeline verwenden, um Ihre Organisations-App in verschiedenen Umgebungen bereitzustellen, z. B. Entwicklung, Test und Produktion. Und Sie können Bereitstellungsregeln verwenden, um die Organisations-App anzupassen.

Informationen zur Verwendung von Bereitstellungspipelines finden Sie unter Einführung in Bereitstellungspipelines.

Hinweis

Einschränkung: Org-Apps (Vorschau) können nicht über Phasen hinweg mithilfe von Dienstprinzipalen bereitgestellt werden.

Verwandte Inhalte