Datasets untersuchen und Fehler finden

Mit dem DataSet Viewer arbeiten

Der DataSet Viewer zeigt das von Business Central erzeugte ResultSet und hilft, Fehler eindeutig dem AL-Report oder dem Layout zuzuordnen. Er sollte vor der Layoutbearbeitung und nach jeder strukturellen Änderung des Datasets verwendet werden.

Allgemein

Das Dataset kann über die Request Page mit realen Filtern erzeugt oder aus einer gespeicherten XML-Datei geladen werden. Neben der flachen Ansicht stehen Dataset Structure, Labels, Information und XML Structure zur Verfügung. Mit Refresh oder F5 lädst Du die Daten erneut.

Die flache ResultSet-Ansicht verstehen

Die Ansicht Dataset stellt die verschachtelten DataItems als flache Zeilen dar. Werte übergeordneter DataItems werden in den Zeilen ihrer untergeordneten DataItems wiederholt. ∅ kennzeichnet einen nicht vorhandenen Wert (NULL); eine leere Zelle enthält dagegen einen tatsächlich übertragenen Leerwert.

Zeilenmetadaten, Zeilenumbruch, optimale Spaltenbreiten und festklebende Join-Spalten können ein- oder ausgeschaltet werden. Damit lassen sich Zeilenanzahl, Wiederholungen, Feldwerte und verfügbare Formatinformationen unmittelbar prüfen.

Unions und Joins

Zueinander eingerückte DataItems bilden Parent-Child-Beziehungen. Jeder Child-Datensatz wiederholt im flachen ResultSet die Werte seines Parent-Datensatzes. Die Anzahl der ResultSet-Zeilen ergibt sich deshalb aus der Kardinalität dieser Beziehung.

Aufeinanderfolgende DataItems derselben Einrückungsebene bilden dagegen jeweils einen Join beziehungsweise einen neuen Datenzweig. Im flachen ResultSet wirkt der Übergang wie eine Treppenstufe: Die Spalten des vorherigen Zweigs enden, die Spalten des nächsten Zweigs werden befüllt. Spalten, die zum jeweils anderen Zweig gehören, enthalten NULL.

Der DataSet Viewer visualisiert diese Unions und Joins durch Zeilenbänder, Parent-Kontexte und hervorgehobene Verknüpfungsspalten. Dadurch wird sichtbar, aus welchem DataItem-Pfad eine Zeile stammt und welche Beziehung zu Wiederholungen geführt hat.

Bedeutung der festklebenden Spalten

Der Viewer ermittelt Verknüpfungsspalten aus DataItemLink, Sortierfeldern und Schlüsselinformationen und hält sie beim horizontalen Scrollen links sichtbar. So bleiben die Schlüssel des Parent- und Child-Kontexts auch bei breiten ResultSets erkennbar.

Prüfe bei unerwarteten Wiederholungen zuerst diese Werte. Stimmen die Schlüssel oder ihre Reihenfolge nicht mit der geplanten Beziehung überein, liegt die Ursache im AL-Dataset und nicht im Layout.

Die Strukturansicht verstehen

Dataset Structure zeigt die DataItems in verschachtelten, ein- und ausklappbaren Tabellen und bewahrt damit die ursprüngliche Hierarchie. XML Structure zeigt den rohen XML-Aufbau für technische Prüfungen. Verwende die flache Ansicht zur Kontrolle des späteren ResultSets und die Strukturansicht zur Analyse von DataItems und Scopes.

Import und Export des Result Sets

Über das Dateimenü kannst Du rohe Dataset-XML-Dateien laden und speichern sowie flache Dataset-XML-Dateien importieren und exportieren. Beim Import prüft die Extension Format und Dataset-Spalten gegen den aktiven Report.

Gespeicherte ResultSets ermöglichen reproduzierbare Layouttests, ohne die Daten erneut aus Business Central abzurufen. Enthaltene Geschäftsdaten sollten vor einer Ablage im Repository vollständig anonymisiert werden.

ALRC: Show Dataset

ALRC: Show Dataset zeigt das von Business Central erzeugte Dataset als flaches ResultSet und in der ursprünglichen DataItem-Struktur. Zusätzlich stehen Labels, technische Informationen und die XML-Struktur zur Verfügung.

Beim Debuggen eines Reports sollte zuerst geklärt werden, ob der Fehler im AL-Teil oder im Layout liegt. Im DataSet Viewer prüfst Du, ob AL das ResultSet so bereitstellt, wie Du es geplant hast. Sind Werte, Zeilenanzahl, Verknüpfungen und Formatangaben korrekt, kann die Fehlersuche auf das Layout eingegrenzt werden. Andernfalls wird der Fehler unmittelbar im AL-Report gesucht.

Dataset oder RDLC-Layout? Compilerfehler gezielt eingrenzen

Prüfe im Dataset Viewer zunächst, ob Werte, Zeilen, Verknüpfungen und DataItem-Struktur stimmen. So erkennst Du, ob die Ursache bereits im AL-Dataset liegt oder ob Du im Layout weitersuchen solltest. Ein korrektes Dataset allein bestätigt jedoch noch nicht, dass sich das RDLC-Layout kompilieren lässt.

Beim Rendern von fehlerhaften RDLC-Layouts liefert Business Central teilweise nur eine wenig hilfreiche Meldung mit RequestMinimum [...]. AL Report Creator kann in diesem Fall die eigentliche RDLC-Compilerdiagnose mit Fehlertext und Position anzeigen. Damit lässt sich die konkrete Ursache korrigieren, ohne alle seit dem letzten funktionierenden Stand vorgenommenen Layoutänderungen schrittweise zurücknehmen zu müssen. Das ist besonders wichtig, weil das immer wieder erforderliche Neuladen des Layout-Designers dessen Undo-Puffer löscht.

Die RDLC-Compilerdiagnose ergänzt die Datenprüfung; sie findet beim Prüfen des RDLC-Layouts statt, nicht beim bloßen Öffnen einer Dataset-Ansicht. Weitere Hinweise findest Du unter Berichte mit Live-Daten prüfen.