Berichte mit Live-Daten prüfen

Neue Berichte vor dem Preview veröffentlichen

Ein neuer Wizard-Bericht muss zunächst in Business Central veröffentlicht werden. Bestätigst Du die Veröffentlichung im Preview, wird die vollständige Extension veröffentlicht. Scheitert der Vorgang oder brichst Du ihn ab, bleibt die Veröffentlichung erforderlich. Auch bei fehlenden passenden RAD-Daten wird vollständig veröffentlicht. Prüfe bei Fehlern die Ausgabe von AL Report Creator und die AL-Veröffentlichungsmeldungen und starte den Preview nach erfolgreicher Veröffentlichung erneut.

Preview: Shortcuts und Seitennavigation

Die wichtigsten Handgriffe auf einen Blick. Fahre über ein Tastensymbol, um seine Bezeichnung zu sehen.

Die Reihenfolge der Mausrad-Symbole entspricht der Reihenfolge der Aktionen. Die Befehle zum Öffnen sind auch über die Befehlspalette erreichbar.

Klicke für die Navigation per Pfeil- oder Bildtaste zuerst in die PDF-Fläche. Die Tasten blättern nicht, solange ein Eingabefeld, eine Schaltfläche oder ein Dialog den Fokus hat. Für die Mausrad-Shortcuts muss sich der Mauszeiger über der Preview-Fläche befinden.

Die Navigation schwebt unten mittig im Preview und bietet auch die erste und letzte Seite. Einzel- und Doppelseitenansicht zeigen bei jedem Zoom die gewählte Seite beziehungsweise das gewählte Seitenpaar. Beim Blättern bleibt die relative horizontale und vertikale Scrollposition erhalten. Die Zoom-Prozentanzeige setzt per Klick auf 100 % zurück; die Ansichtsbuttons passen die ganze Seite oder die Seitenbreite ein.

Mit dem Preview arbeiten

Der Preview zeigt das von Business Central gerenderte PDF und überwacht gleichzeitig die beteiligten Dateien. Gespeicherte Layoutänderungen werden automatisch erkannt und ohne Deployment des Layouts neu gerendert. AL-Änderungen können vor dem Rendern automatisch gepublisht werden.

Für RDLC ist dies der kürzeste Weg, um Seitenumbrüche, Gruppierungen, Ausdrücke und Druckbild unter realen Rendering-Bedingungen zu prüfen. Bei Word-Layouts bleibt Word während reiner Layoutänderungen geöffnet; die gespeicherte Datei wird automatisch neu eingelesen.

Ansichtsoptionen

Der Viewer unterstützt freie Zoomstufen, Seite einpassen, Breite einpassen, Einzelseiten- und Doppelseitenansicht sowie die Auswahl von Sprache und Formatregion.

Die bevorzugten Startwerte können benutzerweit oder im Workspace in settings.json gespeichert werden:

{
  "al-report-creator.preview.defaultZoomMode": "fit-page",
  "al-report-creator.preview.defaultZoomLevel": 100,
  "al-report-creator.preview.defaultSpreadMode": "single",
  "al-report-creator.preview.defaultFormatRegion": "local"
}

defaultZoomLevel wird verwendet, wenn defaultZoomMode auf custom steht. Für defaultFormatRegion sind local, service oder ein IETF-Sprachcode wie de-DE zulässig. Über die Funktion zum Wiederherstellen der Viewer-Standards werden diese gespeicherten Werte erneut angewandt.

Navigationsoptionen

Rechts neben Tools stehen direkte Aktionen für den aktuellen Report zur Verfügung:

• Bericht in Business Central öffnen: Öffnet den Report in der verbundenen Business-Central-Umgebung. Falls AL oder Layout seit dem letzten vollständigen Deployment geändert wurden, fragt die Extension vorab nach dem erforderlichen Publish.
• Bericht als PDF speichern: Speichert das aktuell gerenderte Dokument als PDF-Datei.
• Layout im Designer öffnen: Öffnet das ausgewählte Layout extern; entspricht ALRC: Open Layout Externally.
• VB-Code bearbeiten: Öffnet den globalen <Code>-Bereich eines RDLC-Layouts in einem Editor mit Syntaxhervorhebung, Zeilennummern, Suche und Undo/Redo. Speichern ändert ausschließlich diesen Codebereich und aktualisiert den Preview.
• Zum AL-Code springen: Öffnet das zugehörige AL-Reportobjekt.
• Dataset öffnen: Öffnet den DataSet Viewer für den aktuellen Report; entspricht ALRC: Show Dataset.

Tools

Das Tools-Menü stellt Report-Operationen bereit, die auch separat über die Befehlspalette gestartet werden können. Es fasst häufig benötigte Änderungen im aktuellen Preview-Kontext zusammen.

Add regions to columns and triggers

Strukturiert Spalten und Trigger des AL-Reports in ein- und ausklappbaren Regions. Properties bleiben sichtbar. Weitere Einzelheiten findest Du unter ALRC: Add regions to columns and triggers.

Add data item filters

Ergänzt die AL-Logik zur Ausgabe ausgewählter DataItem-Filter im Report. Weitere Einzelheiten findest Du unter ALRC: Add data item filters to report.

Add Global Data Management

Richtet den Datentransport für wechselnde Inhalte in RDLC-Kopf- und Fußbereichen ein. Weitere Einzelheiten findest Du unter ALRC: Add Global Data Mgt. pattern to report.

Rename columns

Benennt Dataset-Spalten um und passt die Referenzen in den Layouts an. Weitere Einzelheiten findest Du unter ALRC: Rename Report Columns.

Rename labels

Benennt ausschließlich Labels aus der AL-Labels-Section gemeinsam mit ihren betroffenen RDLC- und Word-Referenzen um. Globale und lokale Label-Variablen sowie ihre Referenzen bleiben unverändert. Prüfe Namensvorschläge und Konflikte im Wizard vor dem Anwenden. Weitere Einzelheiten findest Du unter ALRC: Rename report labels.

Add carry overs

Ergänzt Überträge und Zwischensummen in AL und RDLC. Weitere Einzelheiten findest Du unter ALRC: Add carry overs to Report.

Copy report

Kopiert einen Report, ausgewählte Layouts und zugehörige Übersetzungen. Weitere Einzelheiten findest Du unter ALRC: Copy Report.

Create foreign key buffer table

Erzeugt eine speichereffiziente temporäre Puffertabelle für ausgewählte Fremdschlüsselfelder. Weitere Einzelheiten findest Du unter ALRC: Create foreign key buffer table.

ALRC: Preview Report

ALRC: Preview Report rendert das ausgewählte RDLC- oder Word-Layout über Business Central und zeigt das Ergebnis als PDF an. Der Befehl kann aus einer Layoutdatei oder dem zugehörigen AL-Report gestartet werden. Sind mehrere Layouts vorhanden, wähle das gewünschte Layout aus; das in DefaultRenderingLayout angegebene Layout wird als Standard gekennzeichnet.

Der Preview überwacht die beteiligten Dateien. Sobald Du ein Layout speicherst, wird die Vorschau automatisch aktualisiert. Das Layout muss dafür nicht gepublisht werden. Wird dagegen der AL-Teil des Reports geändert, kann die Extension den Report vor der Aktualisierung automatisch publishen.

Ein Word-Layout darf während der Layoutbearbeitung in Word geöffnet bleiben. Die Extension wartet beim Speichern, bis die Datei wieder konsistent gelesen werden kann. Nur wenn das zugehörige Berichtsobjekt neu gepublisht werden muss, kann es erforderlich sein, Word zu schließen – beim regulären Kompilieren gesperrter Word-Dateien wäre dies ohnehin notwendig.

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.