Power BI-Berichte zum Anzeigen von Dynamics 365 Business Central-Daten erstellen

Sie können Ihre Dynamics 365 Business Central-Daten zur Verfügung stellen als Datenquelle in Power BI Desktop und leistungsstarke Berichte über den Zustand Ihres Geschäftes erstellen.

Dieser Artikel beschreibt die ersten Schritte zur Verwendung von Power BI Desktop zur Erstellung von Berichten, die Dynamics 365 Business Central-Daten anzeigen. Nach dem Erstellen können Sie die Berichte in Ihrem Power BI-Dienst veröffentlichen oder sie mit allen Benutzenden in Ihrer Organisation teilen. Wenn sich diese Berichte im Power BI-Dienst befinden, können Sie von Benutzenden mit entsprechendem Zugriff in Dynamics 365 Business Central angezeigt werden.

Vorbereitung

Notiz

Mit den OData-Webdiensten könnten Sie die Daten verschiedener Unternehmen in einem einzigen Bericht abrufen. Ab Business Central Veröffentlichungszyklus 2 2021 wird jedoch nur ODataV4 unterstützt. ODataV4 exportiert keine Daten von mehreren Unternehmen. Die Funktion $erweitern in Power BI, die Sie vielleicht für eine alternative Möglichkeit halten, einen Mehrfirmenbericht zu erstellen, kann ebenfalls nicht verwendet werden. Es wird eine Spalte mit dem Firmennamen erstellt, aber nach einer Aktualisierung nicht mit den Firmendaten gefüllt.

Business Central als Datenquelle in Power BI Desktop hinzufügen

Die erste Aufgabe beim Erstellen von Berichten besteht darin, Business Central als Datenquelle in Power BI Desktop hinzuzufügen. Sobald die Verbindung hergestellt ist, können Sie mit der Erstellung des Berichts beginnen.

  1. Starten Sie Power BI Desktop.

  2. Wählen Sie Daten abrufen aus.

    Wenn Sie die Option Daten abrufen nicht sehen können, wählen Sie das Menü Datei und dann den Menüpunkt Daten abrufen aus.

  3. Wählen Sie auf der Seite Daten abrufen die Option Onlinedienste aus.

  4. Führen Sie im Bereich Onlinedienste einen der folgenden Schritte aus:

    • Zum Herstellen einer Verbindung mit Business Central Online wählen Sie Dynamics 365 Business Central und dann Verbinden aus.

  5. Melden Sie sich bei Business Central an (nur einmal).

    Wenn Sie sich nicht über Power BI Desktop bei Business Central angemeldet haben, werden Sie dazu aufgefordert.

    • Für Business Central Online wählen Sie Anmelden und dann das entsprechende Konto aus. Verwenden Sie dasselbe Konto, mit dem Sie sich bei Business Central anmelden. Wenn Sie fertig sind, wählen Sie Verbinden.

    Notiz

    Nachdem Sie eine Verbindung zu Business Central hergestellt haben, werden Sie nicht mehr aufgefordert, sich anzumelden. Wie ändere oder lösche ich das Konto, das ich derzeit für die Verbindung mit Business Central von Power BI Desktop verwende?

  6. Wenn die Verbindung hergestellt ist, stellt Power BI Kontakte zum Business Central-Dienst her. Das Fenster Navigator zeigt die verfügbaren Datenquellen für die Erstellung von Berichten an. Wählen Sie einen Ordner aus, um ihn zu erweitern und die verfügbaren Datenquellen anzuzeigen.

    Diese Datenquellen stellen alle für Business Central veröffentlichten Webdienste und API-Seiten nach Umgebungen und Unternehmen gruppiert dar. Wenn Business Central online ist, hat Navigator die folgende Struktur:

    • Umgebungsname
      • Firmenname

        • Erweiterte APIs

          In diesem Ordner sind erweiterte APIs aufgeführt, die von Microsoft veröffentlicht wurden, z. B. die Business Central-Automatisierungs-APIs und APIs, die von anderen Organisationen veröffentlicht wurden (diese APIs werden als benutzerdefinierte APIs bezeichnet). Benutzerdefinierte APIs sind weiter in Ordnern nach APIPublisher/APIGroup-Eigenschaften des API-Buchungsspurcodes gruppiert.

        • Standard-APIs v2.0

          Dieser Ordner listet die API-Daten auf, die von der Business Central API V2.0 bereitgestellt werden. Sie verwenden diese APIs, um Daten aus der Business Central-Datenbank zu lesen, z. B. Masterdaten (Debitor, Kreditor, Artikel usw.), Transaktionen (Fibuposten, Debitorenposten usw.) oder Einrichtungsdaten (Dimensionen, Zahlungsmethoden, Einheiten usw.).

        • Webdienste (Legacy)

          Dieser Ordner listet Seiten, Codeunits und Abfragen auf, die als Webdienste in Business Central veröffentlicht werden. Wir raten von der Verwendung dieser älteren Methoden zum Lesen von Daten aus Business Central dringend ab. Wir empfehlen stattdessen die Verwendung von APIs.

  7. Wählen Sie die Datenquelle(n) aus, die Sie zu Ihrem Datenmodell hinzufügen möchten, und wählen Sie dann die Schaltfläche Laden.

  8. Wenn Sie später weitere Business Central-Daten hinzufügen möchten, können Sie die vorherigen Schritte wiederholen.

Sobald die Daten geladen sind, können Sie sie in der rechten Navigation auf der Seite sehen. An diesem Punkt haben Sie eine Verbindung mit Ihren Business Central-Daten hergestellt und können mit der Erstellung Ihres Power BI-Berichts beginnen.

Trinkgeld

Weitere Informationen zur Verwendung von Power BI Desktop finden Sie unter Erste Schritte mit Power BI Desktop.

Erstellen von zugänglichen Berichten

Es ist wichtig, dass Ihre Berichte für so viele Personen wie möglich nutzbar sind. Versuchen Sie, die Berichte so zu gestalten, dass sie nicht speziell an die Bedürfnisse verschiedener Benutzender angepasst werden müssen. Stellen Sie sicher, dass das Design es den Anwendern ermöglicht, Standard-Hilfstechnologien, wie z.B. Bildschirmleser, zu nutzen. Power BI enthält verschiedene Funktionen, Tools und Richtlinien zur Barrierefreiheit als Hilfe. Um mehr zu erfahren, gehen Sie zu Gestalten Sie Power BI-Berichte für Barrierefreiheit in der Power BI-Dokumentation.

Berichte erstellen, um die DAten anzuzeigen, die einer Liste in Business Central zugeordnet sind

Sie können Berichte erstellen, die in einer Infobox auf einer Business Central-Listenseite angezeigt werden und sich ändern, wenn verschiedene Zeilen in der Liste ausgewählt werden. Das Erstellen dieser Berichte ist mit dem Erstellen anderer Berichte vergleichbar. Sie müssen jedoch einige Dinge beachten, um sicherzustellen, dass die Berichte wie erwartet angezeigt werden. Um mehr zu erfahren gehen Sie zu Erstellen von Power BI-Berichten zum Anzeigen von Listendaten in Business Central.

Verwenden des Business Central-Berichtsthemas (optional)

Bevor Sie Ihren Bericht erstellen, empfiehlt es sich, die Business Central-Designdatei herunterzuladen und zu importieren. Die Designdatei erstellt eine Farbpalette, damit Sie Berichte im Farbstil der Business Central-Anwendungen erstellen können, ohne benutzerdefinierte Farben für jede Grafik definieren zu müssen.

Notiz

Diese Aufgabe ist optional. Sie können Ihre Berichte jederzeit erstellen und die Stilvorlage später herunterladen und darauf anwenden.

Herunterladen des Themas

Die Themendatei ist als json-Datei in der Themengalerie der Microsoft Power BI-Community verfügbar. Gehen Sie folgendermassen vor, um die Themendatei herunterzuladen:

  1. Wechseln Sie zu Themengalerie der Microsoft Power BI Community für Microsoft Dynamics 365 Business Central.
  2. Wählen Sie den Anhang Microsoft Dynamics Business Central.json zum herunterladen aus.

Importieren des Themas in einen Bericht

Nachdem Sie das Business Central-Berichtsthema heruntergeladen haben, können Sie es in Ihre Berichte importieren. Um das Thema zu importieren, wählen Sie Ansicht>Themen>Nach Themen suchen aus. Weitere Informationen finden Sie unter Power BI Desktop – Importieren benutzerdefinierter Berichtsthemen.

Veröffentlichen von Berichten

Nachdem Sie einen Bericht erstellt oder geändert haben, können Sie den Bericht in Ihrem Power BI-Dienst veröffentlichen und sogar mit anderen Benutzern in Ihrer Organisation teilen. Nachdem Sie einen Bericht veröffentlicht haben, ist er in Business Central verfügbar. Der Bericht kann ausserdem in Business Central ausgewählt werden.

Um einen Bericht zu veröffentlichen, wählen Sie Veröffentlichen auf der Registerkarte Start im Menüband oder im Menü Datei aus. Wenn Sie beim Power BI-Dienst angemeldet sind, wird der Bericht für diesen Dienst veröffentlicht werden. Andernfalls werden Sie aufgefordert, sich anzumelden.

Verteilen oder Teilen eines Berichts

Es gibt mehrere Möglichkeiten, Berichte zu teilen:

  • Teilen Sie einen Berichtvüber Ihren Power BI-Dienst (empfohlen)

    Wenn Sie über eine Power BI Pro Lizenz verfügen oder Power BI Premium Capacity, können Sie den Bericht direkt über Ihren Power BI-Dienst mit anderen teilen. Um mehr zu erfahren, gehen Sie zu Power BI – Teilen von Dashboards oder Berichten.

  • Verteilen Sie Berichte als .pbix-Dateien.

    Berichte werden auf Ihrem Computer als .pbix-Dateien gespeichert. Sie können die .pbix-Berichtsdatei wie jede andere Datei an Benutzer verteilen. Anschliessend können die Personen, für die Sie die Datei freigegeben haben, sie in ihren Power BI-Dienst hochladen. Weitere Informationen finden Sie unter Bericht von Dateien hochladen.

    Notiz

    Werden die Berichte auf diese Art verteilt, werden die Daten für Berichte von jedem Benutzenden einzeln aktualisiert. Dieser Umstand könnte sich auf die Leistung von Business Central auswirken.

So entwickeln Sie unternehmens- und umgebungsübergreifende Power BI-Berichte

Die Business Central-API-Endpunkte haben alle das Präfix https://api.businesscentral.dynamics.com/v2.0/<environment_name>/api/v2.0 gefolgt von /companies({company_id})/accounts({id}) (hier verwenden wir die accounts-API als Beispiel). Sie können diese Struktur verwenden, um PowerQuery-Abfragen zu erstellen, die Daten für mehrere Unternehmen oder mehrere Umgebungen laden, wenn der Benutzer, der die Daten liest, darauf zugreifen kann.

Um eine Abfrage zum Laden von Daten für mehrere Unternehmen einzurichten, führen Sie die folgenden Schritte aus:

  1. Verwenden Sie die PowerQuery-Abfrage, die Daten für ein einzelnes Unternehmen lädt. Konvertieren Sie sie in eine benutzerdefinierte Power Query-Funktion, die die Firmen-ID (oder möglicherweise den Umgebungsnamen) als Parameter verwendet. Weitere Informationen finden Sie unter Verwenden von benutzerdefinierten Power Query-Funktionen.
  2. Verwenden Sie nun die neue benutzerdefinierte Funktion in einer PowerQuery-Abfrage, in der Sie die Funktion über eine Liste von Unternehmen zuordnen und dann die Datensätze mit der Table.Combine-Funktion von Power Query zusammenführen.

Passen Sie den Power Query-Code an, der eine Verbindung mit der Business Central-Datenquelle herstellt

In den meisten Fällen reicht die Verwendung der Navigationsoberfläche in der Power BI Desktop-Benutzeroberfläche aus, um mit dem Erstellen von Berichten auf der Grundlage von Business Central-Daten zu beginnen. In komplexeren Szenarien müssen Sie jedoch möglicherweise den Power Query-Code manuell bearbeiten, um Ihre Daten abzurufen.

Führen Sie dazu die folgenden Schritte aus:

  1. Starten Sie Power BI Desktop.

  2. Führen Sie die Schritte aus, die zu Ihrem Szenario passen:

    1. Wählen Sie Datei>Öffnen aus.
    2. Suchen Sie nach dem Bericht (PBIX-Datei) und wählen Sie ihn aus.
    3. Wählen Sie im Menüband Daten transformieren aus, um den Power Query-Editor zu öffnen.
  1. Wählen Sie im Power Query-Editor aus dem Menüband Erweiterter Editor.

Dadurch wird der Power Query-Code angezeigt, den das System automatisch generiert hat, als Sie Ihre Auswahl im Navigator getroffen haben. Angenommen, Sie haben die Business Central-Umgebung mit dem Namen Produktion, das Unternehmen CRONUS USA, Inc., den API-Ordner Standard-APIs v2.0 und die Tabelle customers ausgewählt. Wenn Sie zum erweiterten Editor navigieren, wird eine Abfrage ähnlich der folgenden angezeigt:

let
  Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),
  PRODUCTION = Source{[Name="PRODUCTION"]}[Data],
  #"CRONUS USA, Inc." = PRODUCTION{[Name="CRONUS USA, Inc."]}[Data],
  v2.0 = #"CRONUS USA, Inc."{[Name="v2.0"]}[Data],
  customers_table = v2.0{[Name="customers",Signature="table"]}[Data]
in
  customers_table

Sie können diese Abfrage nun manuell bearbeiten, um die Änderungen vorzunehmen, die Ihren Anforderungen passen.

Die Funktion Dynamics365BusinessCentral.ApiContentsWithOptions

In der obigen Abfrage ist die Funktion Dynamics365BusinessCentral.ApiContentsWithOptions für die Verbindung mit Business Central und das Abrufen der Daten verantwortlich. Diese Funktion verfügt über 4 optionale Parameter, die in der Standardabfrage nicht angegeben sind.

Hier ist eine Aufschlüsselung der verschiedenen Parameter:

Parameter Beispiele Description
Umgebung "Production" Mit diesem Parameter können Sie die Business Central-Umgebung angeben, mit der eine Verbindung hergestellt werden soll. Wenn nicht angegeben, gibt die Funktion eine Liste aller Umgebungen zurück, und Sie müssen die entsprechende Umgebung in den nachfolgenden Schritten des Power Query-Codes auswählen
Unternehmen "CRONUS USA, Inc." Mit diesem Parameter können Sie das Business Central-Unternehmen angeben, mit dem in der ausgewählten Umgebung eine Verbindung hergestellt werden soll. Dieser Parameter wird ignoriert, wenn der Umgebung-Parameter nicht angegeben ist. Wenn nicht angegeben, gibt die Funktion eine Liste aller Unternehmen in Ihrer ausgewählten Umgebung (oder ausgewählten Umgebungen) zurück, und Sie müssen das entsprechende Unternehmen in den nachfolgenden Schritten des Power Query-Codes auswählen
API-Kategorie (oder API-Route) "microsoft/runtime/beta", "v2.0" Mit diesem Parameter können Sie die API-Route angeben, mit der in Business Central eine Verbindung herzustellen ist, und zwar in Ihrer ausgewählten Umgebung und Ihrem Unternehmen. Dieser Parameter wird ignoriert, wenn der Umgebung- und der Unternehmen-Parameter nicht angegeben sind. Wenn nicht angegeben, gibt die Funktion eine Liste aller API-Kategorien (auch als API-Routen bezeichnet) in Ihrer/Ihren ausgewählten Umgebung/en und Unternehmen zurück, und Sie müssen die entsprechende API-Kategorie in den nachfolgenden Schritten des Power Query-Codes auswählen
Erweiterte Optionen Mit diesem Parameter können Sie einige erweiterte Optionen angeben, um eine Verbindung mit Ihrer Business Central-Datenquelle herzustellen. Beachten Sie, dass in den allermeisten Fällen die Standardwerte optimiert sind und nicht geändert werden müssen. Weitere Informationen zu diesen Parametern finden Sie im folgenden Abschnitt.

Die oben in diesem Abschnitt gezeigte Abfrage entspricht z. B. der folgenden Abfrage:

 let
   Source = Dynamics365BusinessCentral.ApiContentsWithOptions("PRODUCTION", "CRONUS USA, Inc.", "v2.0", null),
   customers_table = Source{[Name="customers",Signature="table"]}[Data]
 in
   customers_table

Erweitert: Sprache, Timeout, Datenbankreplik oder Seitengrösse für Ihre Business Central-Datenquelle anpassen

Der Power BI Connector für Business Central unterstützt mehrere erweiterte Eigenschaften für den Aufbau einer Verbindung mit einer Business Central-Datenquelle, die Sie in Ihren Power Query Abfragen festlegen können. Die Parameter sind in der folgenden Tabelle beschrieben.

Erweiterte Optionen Description Standard Weitere Informationen finden Sie unter
AcceptLanguage Mit diesem Parameter können Sie bevorzugte Sprachen für Antworten angeben, um sicherzustellen, dass Benutzende Nachrichten und übersetzbare Zeichenfolgen in der gewünschten Sprache erhalten. Er legt die Sprache fest, in der die Business Central-API-Sitzung ausgeführt wird. Er beeinflusst die Sprache von Fehlermeldungen, formatierte Werte in AL und andere Werte, die von Sprache oder Kultur abhängen.

Dieser Parameter verbessert die Benutzerzufriedenheit und macht die Daten zugänglicher und relevanter.		 nicht angegeben Gebietsschemawerte in mehrsprachigen Power BI-Berichten verwenden.
ODataMaxPageSize Dieser Parameter begrenzt die Anzahl der Entitäten pro Ergebnisseite, was die Flexibilität beim Herstellen einer Verbindung mit grossen Datasets oder bei der Verwendung komplexer Abfragen erhöht. Er legt die maximale Anzahl von Datensätzen fest, die beim Aufrufen einer API für jede Seite zurückgegeben werden sollen. Wenn Ihre Tabelle Debitoren beispielsweise 13.000 Datensätze enthält und ODataMaxPageSize auf 5.000 festgelegt ist, führt Power BI drei API-Aufrufe zum Abrufen Ihrer Debitoren durch. Der erste Aufruf erhält 5.000 Datensätze, der nächste weitere 5.000 und der letzte Aufruf die restlichen 3.000. Diese Option darf nicht höher als die von Business Central erzwungene maximale Seitengrösse, nämlich 20.000, sein.

Dieser Parameter sorgt für einen effizienten und reaktionsschnellen Datenabruf, sodass Erkenntnisse schneller bereitstehen und die Entscheidungsfindung beschleunigt wird. Sie dürfen die maximale Seitengrösse, die für den Dienst festgelegt ist, nicht überschreiten.		 5000 Die ODataPreferenceHeader.MaxPageSize-Eigenschaft
Zeitüberschreitung Dieser Parameter legt fest, wie lange die Anforderung maximal dauern darf, bevor sie abgebrochen wird. Er legt das Timeout für jeden einzelnen API-Aufruf an Business Central fest. Der Wert darf die für das Business Central-Dienst erzwungene Timeout nicht überschreiten, das derzeit bei 10 Minuten (00:10:00) liegt.

Dieser Parameter hilft bei der effektiven Verwaltung von Systemressourcen und verhindert, dass lang dauernde Abfragen die Gesamtleistung des Systems beeinträchtigen. Benutzende erleben minimale Verzögerungen und Unterbrechungen, sodass ein reibungsloserer Arbeitsablauf gegeben ist.		 00:08:00 OData.Feed
UseReadOnlyReplica Dieser Parameter bestimmt, ob Anforderungen auf die primäre Datenbank oder ein schreibgeschütztes Replikat abzielen. Das Auslagern von Lesevorgängen aus der primären Datenbank kann die Leistung erheblich steigern.

Diese Eigenschaft führt insbesondere während Spitzennutzungszeiten zu einem schnelleren Datenabruf und einer verbesserten Systemstabilität.		 true

Die erweiterten Optionen konfigurieren

  1. Befolgen Sie die Schritte, um den Power Query-Code im erweiterten Power BI-Editor anzuzeigen

  2. Suchen Sie im Erweiterten Editor die Zeile, die mit Source = beginnt:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),

  3. Ersetzen Sie in der Zeile den vierten Parameter von Dynamics365BusinessCentral.ApiContentsWithOptions durch einen Power Query-Datensatz von Eigenschaften und Werten, die Sie festlegen möchten, z. B.:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, [UseReadOnlyReplica = true, Timeout = Duration.From("00:07:00"), ODataMaxPageSize = 10000, AcceptLanguage = "it-it"])

  4. Wählen Sie Fertig, um den Erweiterten Editor zu schliessen.

  5. Wählen Sie Schliessen & Anwenden, um die Änderungen zu speichern und den Power Query-Editor zu schliessen.

Probleme beheben

„Expression.Error: Die Umgebung ‚Produktion‘ ist nicht vorhanden“ beim Angeben einer Business Central-Umgebung

GILT FÜR: Business Central Online

Wenn Sie von Power BI aus eine Verbindung zu Business Central Online aufbauen oder eine Power BI Desktop-App von Microsoft AppSource installieren, die Business Central-Daten verwendet, werden Sie möglicherweise aufgefordert, die Business Central-Umgebung anzugeben, mit der Sie eine Verbindung herstellen möchten.

Wenn Sie eine Fehlermeldung wie „Expression.Error: Die Umgebung ‚Produktion‘ ist nicht vorhanden“ erhalten, gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Stellen Sie sicher, dass Sie die richtigen Anmeldeinformationen für den Zugriff auf Business Central verwenden. Diese Anmeldeinformationen sind möglicherweise nicht die gleichen, die Sie für den Zugriff Power BI verwenden. Wie ändere oder lösche ich das Konto, das ich derzeit für die Verbindung mit Business Central von Power BI Desktop verwende?
  2. Wenn es sich bei Ihrer Umgebung um eine eingebettete ISV-Umgebung handelt, müssen Sie den Namen des eingebetteten ISV in Klammern zum Namen der Umgebung hinzufügen. Wenn Sie z. B. eine Verbindung mit einer Umgebung mit dem Namen „Produktion“ über den eingebetteten ISV mit dem Namen „Fabrikam“ herstellen möchten, müssen Sie als Umgebungsnamen „PRODUCTION (fabrikam)“ angeben.

„Ein Datensatz kann nicht eingefügt werden. Die aktuelle Verbindungsabsicht ist schreibgeschützt.“ Fehler beim Herstellen einer Verbindung mit der benutzerdefinierten API-Seite

GILT FÜR: Business Central Online

Berichte, die Business Central-Daten verwenden, werden standardmässig mit einem schreibgeschützten Replikat der Business Central-Datenbank verbunden. In seltenen Fällen, abhängig vom API-Design, erhalten Sie möglicherweise eine Fehlermeldung, wenn Sie versuchen, eine Verbindung zur Seite herzustellen und Daten von der API abzurufen. Der Fehler sieht wie folgt aus:

Dynamics365BusinessCentral: Request failed: The remote server returned an error: (400) Bad Request. (Can't insert a record. Current connection intent is Read-Only. CorrelationId: [...])".

Wenn Sie eine benutzerdefinierte API-Seite verwenden, sollten Sie den AL-Code überarbeiten, um sicherzustellen, dass sie keine Datenbankänderungen vornimmt, wenn sie nur Daten liest. Falls Ihr Szenario dies erfordert, können Sie den Connector jedoch so konfigurieren, dass er stattdessen eine Lese-/Schreibverbindung verwendet.

Aktivieren Sie Ihre Geschäftsdaten für Power BI
Business Intelligence
Vorbereitungen zum Tätigen von Geschäften
Geschäftsdaten aus anderen Finanzsystemen migrieren
Einrichten von Business Central
Finanzen
Schnellstart: Stellen Sie eine Verbindung zu Daten her in Power BI Desktop

Kostenlose E-Learning-Module für Business Central finden Sie hier

  • Last updated on