Direkt zum Hauptinhalt

Einen Bericht an eine Tabelle binden

Ziel​

Einen Bericht mit einer Tabelle einer modellgesteuerten App verbinden – zum Beispiel mit einer Tabelle Rechnung –, sodass der Bericht die Datensätze dieser Tabelle aus einer Umgebung liest und ihre Felder als Berichtsspalten anordnet.

Voraussetzungen​

  • Die Tabelle, über die Sie berichten möchten, existiert in der Umgebung, gegen die Sie berichten. Hinter einer Tabelle stehen ihre Daten ab dem Moment, in dem sie erstellt wird (siehe Was beim Speichern einer Tabelle passiert).
  • Sie verfügen über Anmeldeinformationen, die Lesezugriff für Berichte auf die Umgebung gewähren: entweder eine App-Registrierung für eine externe Anwendung, der der Bereich reporting.read (oder modelapps.read) gewährt wurde (siehe Eine externe App registrieren), oder Sie berichten aus der Plattform-Shell heraus, die denselben Zugriff für die App bereitstellt, in der Sie arbeiten.
  • Sie wissen, welche Umgebung die gewünschten Daten enthält (Berichte lesen immer die Daten genau einer Umgebung).

Schritte​

  1. Erstellen oder öffnen Sie im Berichtswerkzeug einen Bericht, und fügen Sie eine Parsware-Datenquelle hinzu.
  2. Richten Sie die Datenquelle auf die Berichtsadresse der Zielumgebung aus, und geben Sie die Anmeldeinformationen für Berichte aus den Voraussetzungen an.
  3. Wählen Sie die Tabelle, über die berichtet werden soll, aus der Liste der bindbaren Tabellen. Jede Tabelle dieser Umgebung erscheint dort – zum Beispiel Rechnung.
  4. Das Werkzeug lädt die bindbaren Spalten der Tabelle (Beschriftung und Datentyp jedes Felds, das Primärfeld der Tabelle zuerst). Wählen Sie die Spalten aus, die im Bericht stehen sollen.
  5. Fügen Sie optional Filter und Sortierungen für diese Spalten hinzu (zum Beispiel „Summe ist größer als 50“, neueste zuerst) sowie eine Seitengröße.
  6. Zeigen Sie eine Vorschau des Berichts an. Das Werkzeug fordert eine Seite mit Zeilen für die ausgewählten Spalten an und stellt sie dar. Speichern Sie den Bericht.

Was im Hintergrund passiert​

Das Binden eines Berichts erstellt eine schreibgeschützte Verbindung zu den Tabellendaten genau dieser einen Umgebung. Die Berichtsdatenquelle schreibt nie: Sie kann die Tabellen der Umgebung auflisten, die Spalten einer Tabelle beschreiben und Seiten mit Zeilen für die gewählten Spalten und Filter zurückgeben. Der Zugriff wird über den Lesebereich für Berichte in Ihren Anmeldeinformationen gewährt und nicht über eine Anwendungsrolle – deshalb braucht eine Berichtsintegration keine Schreibberechtigungen als Ersteller oder Administrator. Jede Anfrage liest nur die Umgebung, auf die Sie die Datenquelle ausgerichtet haben – die Daten einer Umgebung können nie in einem Bericht erscheinen, der an eine andere gebunden ist.

Fehlerbehebung​

  • „Reading reporting data requires the 'reporting.read' or 'modelapps.read' scope.“ – Die Anmeldeinformationen der Datenquelle gewähren keinen Lesezugriff für Berichte. Verwenden Sie eine App-Registrierung mit dem Bereich reporting.read (oder modelapps.read), oder berichten Sie aus der Shell heraus.
  • Die Tabelle fehlt in der Liste der bindbaren Tabellen. – Sie existiert in dieser Umgebung nicht; vermutlich haben Sie die Datenquelle auf eine andere ausgerichtet. Richten Sie sie auf die Umgebung aus, die die Tabelle enthält, oder importieren Sie die Lösung, die sie mitbringt.
  • Ein Filter oder eine Sortierung wird als unbekanntes Feld abgelehnt. – Filter bzw. Sortierung nennt ein Feld, das in der Tabelle nicht definiert ist. Wählen Sie eine Spalte aus der eigenen Feldliste der Tabelle.

Verwandte Szenarien​

  • Was beim Speichern einer Tabelle passiert.
  • Eine externe App registrieren.
  • Tabellendaten für Berichte abfragen (Entwickler).