AL Report Creator
Häufige Fragen
Was Dir AL Report Creator im Alltag abnimmt – und was Du für den Einstieg brauchst.
Wozu brauche ich AL Report Creator?
Mit AL Report Creator erstellst Du Business-Central-Berichte direkt in VS Code – einschließlich der passenden RDLC- und Word-Layouts. Der Wizard liefert einen vollständig ausgestalteten Ausgangsbericht statt eines bloßen AL-Gerüsts. DataItems, Gruppierungen, Summen und Layoutstruktur werden gemeinsam aufgebaut.
Eigene Templates bestimmen das grundlegende Erscheinungsbild. Danach kannst Du AL-Logik und Layouts regulär weiterbearbeiten, mit Styles vereinheitlichen und das Ergebnis direkt in der Live-Daten-Vorschau prüfen. Business Central rendert den Bericht mit den Daten Deines Entwicklungssystems; die Vorschau erscheint direkt in VS Code.
Kann ich die Vorschau auf einen zweiten Bildschirm verschieben?
Ja. Die Vorschau ist ein VS-Code-Dokument. Du kannst sie in ein separates Fenster verschieben und auf einem zweiten Bildschirm geöffnet lassen. Sobald Du Layoutänderungen speicherst, wird sie automatisch aktualisiert. Das Layout muss dafür nicht jedes Mal veröffentlicht werden.
Berücksichtigt die Vorschau meine regionalen Einstellungen?
Ja. Die Vorschau kann Deine lokale Formatregion verwenden. Du kannst auch eine andere unterstützte Region auswählen und kontrollieren, wie Zahlen, Datumswerte und weitere regionale Formate dargestellt werden.
Was ist, wenn der Bericht Filter oder Optionen benötigt?
Über das Filtersymbol öffnest Du die Request Page des Berichts. Die dort gewählten Filter und Optionen werden beim Rendern verwendet. So prüfst Du den Bericht unter den Bedingungen, die für Deinen konkreten Fall relevant sind.
Muss ich in Business Central eine App installieren?
Für Live-Vorschau und Dataset Viewer benötigst Du die Preview Service App auf Deinem Business-Central-Entwicklungssystem. AL Report Creator stellt diese Begleit-App direkt bereit; sie wird nicht über AppSource bezogen.
Der Installationswizard lässt Dich den Objektnummernbereich festlegen. Du kannst die App automatisch installieren lassen oder den AL-Quellcode als Workspace öffnen, prüfen, anpassen und selbst veröffentlichen. Bei mehreren Launch-Konfigurationen wählst Du das Zielsystem aus. Anschließend legst Du den verwendeten Mandanten fest.
Kann ich AL Report Creator auf anderen Betriebssystemen nutzen?
Ja. AL Report Creator ist nicht auf die Arbeit unter Windows beschränkt. Für die Bearbeitung in externen Layoutdesignern benötigst Du weiterhin einen passenden Editor für Dein Betriebssystem. Live-Vorschau und Dataset-Abruf benötigen die Verbindung zu Deinem Business-Central-System und die Begleit-App.
Kann ich Berichte auch mit Word-Layouts erzeugen?
Ja. Der Wizard erzeugt RDLC-Layouts, Word-Layouts oder beide Formate. Für beide gibt es eigene Templates und passende Style-Funktionen.
RDLC ist besonders für tabellarische Berichte, Gruppierungen, Summen und ein präzises Druckbild geeignet. Word ergänzt das dort, wo Fließtext, Anpassungen durch Endanwender oder eine spätere Bearbeitung des erzeugten Dokuments gefragt sind. Welche Styles verfügbar sind, hängt vom Layoutformat ab.
Wie hilft mir AL Report Creator bei der Fehlersuche?
Drei Ansichten helfen Dir, die Ursache systematisch einzugrenzen:
- Live-Daten-Vorschau: Du siehst das von Business Central gerenderte Ergebnis direkt in VS Code und kannst gespeicherte Layoutänderungen unmittelbar überprüfen.
- RDLC-Compilerdiagnose: Wenn Business Central beim Rendern nur einen wenig hilfreichen
RequestMinimum-Fehler meldet, kann AL Report Creator die eigentliche Compilerdiagnose mit Fehlertext und Position beziehungsweise betroffenem Control anzeigen. - Dataset Viewer: Du untersuchst das tatsächlich übergebene Dataset als flaches ResultSet, in seiner DataItem-Struktur oder als XML. So erkennst Du, ob Werte, Zeilen, Verknüpfungen und Formatangaben schon im AL-Dataset falsch sind oder ob Du im Layout weitersuchen solltest.
Sind die erzeugten Berichte performant?
Die Performance hängt auch bei generierten Berichten von Datenmenge, Struktur und fachlicher Logik ab. AL Report Creator berücksichtigt bekannte Optimierungen an Dataset und Layout und bietet Werkzeuge für gezielte weitere Verbesserungen.
Ein Beispiel sind generierte Fremdschlüssel-Lesepuffer: Eine temporäre Tabelle speichert nur die ausgewählten Felder und bedient wiederholte Zugriffe auf denselben Schlüssel aus dem Puffer. Die erzeugte AL-Logik bleibt sichtbar und anpassbar. Ein pauschales Performanceversprechen ersetzt das nicht – die Wirkung prüfst Du mit Deinen Daten.
Ist AL Report Creator kostenlos?
Viele Funktionen sind kostenlos. Dazu gehört auch die Erzeugung des AL-Codes vollständiger Reports mit komplexen und verschachtelten DataItem-Strukturen.
Für die Erstellung oder Bearbeitung von Layouts werden abhängig von Verarbeitung und Komplexität Credits benötigt. Dein Unternehmen erhält diese über sein Abonnement; das monatliche Kontingent wird regelmäßig erneuert. Es gibt auch ein kostenloses Abonnement. Die verfügbaren Modelle und die für Dein Konto geltenden Konditionen findest Du im Kundenportal.
Du kannst ein passendes Abonnement wählen und Änderungen an Deinem Bedarf über Upgrades oder Downgrades abbilden. Konkrete Preise und Wechseltermine stehen im Portal, damit diese Angaben aktuell bleiben.
Muss ich mich registrieren?
Wichtig: Die kostenlose Registrierung darf nur einmal pro Unternehmen erfolgen – nicht einmal pro Entwickler.
Registriere Dein Unternehmen daher nur, wenn es noch nicht bei AL Report Creator registriert ist. Anschließend lädt der Unternehmensadministrator alle weiteren Entwickler in das bestehende Unternehmenskonto ein. Jeder eingeladene Entwickler erhält einen eigenen API-Key für die Verbindung seiner Extension.
Ist Dein Unternehmen bereits registriert, registriere Dich bitte nicht erneut. Lass Dich stattdessen vom Unternehmensadministrator einladen. So verwendet Ihr gemeinsame Vorlagen, Styles, Presets und Gestaltungsvorgaben.
Zur Registrierung gehört eine Credit-Gutschrift zum Ausprobieren. Die für Dein Unternehmen verfügbaren Credits und Funktionen siehst Du anschließend im Kundenportal.
Benötigen die erzeugten Berichte Laufzeitlizenzen?
Für AL Report Creator und die damit erzeugten und bearbeiteten Berichte benötigst Du keine zusätzliche Laufzeitlizenz, um die erzeugten Berichte auszuführen. Die Dateien bestehen aus regulärem AL, RDLC und Word und haben auch keine Laufzeitabhängigkeit von AL Report Creator.
Kann ich auch bestehende Berichte bearbeiten?
Ja. Du kannst vorhandene Reports auf verschiedene Weise weiterverwenden:
- Als Ausgangspunkt: Lade einen vorhandenen Bericht in den Wizard und erzeuge darauf basierend einen neuen.
- Kopieren: Übernimm ausgewählte Layouts sowie Übersetzungen und passe Objekt-ID, Namen und Layoutreferenzen gemeinsam an.
- Layouts überarbeiten: Wende Templates und Styles nachträglich an, ändere Seitenausrichtung und Abmessungen oder vereinheitliche Schriften, Farben und Formate.
- AL strukturieren: Fasse Spalten und Trigger in Regions zusammen, um die DataItem-Struktur leichter zu überblicken.
- Spalten umbenennen: Vereinheitliche Dataset-Spaltennamen und aktualisiere zugleich die Referenzen in RDLC- und Word-Layouts.
- Überträge ergänzen: Ein Wizard unterstützt Zwischensummen und Überträge für geeignete RDLC-Tablixe und passt dafür AL und Layout gemeinsam an. Diese Funktion ist für RDLC vorgesehen.
Welche Styles gibt es und was können sie?
Styles arbeiten auf dem aktuell in der Vorschau ausgewählten Layout. Du kannst die Wirkung vorab analysieren und nach der Anwendung im gerenderten Bericht prüfen. Je nach Format stehen unterschiedliche Funktionen zur Verfügung:
- Apply template: Übernimmt ausgewählte Template-Bestandteile, etwa Seiteneinstellungen, Kopfkonfiguration, Filteranzeige und Tablix-Formatierung.
- Page layout: Ändert Papierformat, Ausrichtung, Ränder und Abmessungen; Inhalte können passend skaliert, Einheiten vereinheitlicht und Maße gerundet werden.
- Normalize layout: Vereinheitlicht Größen, Abstände und Formatierungen anhand konfigurierbarer und semantischer Regeln.
- Add tablix header separator line: Ergänzt Trennlinie und Abstandzeilen im Tablix-Kopf; vorhandene Ergänzungen werden erkannt.
- Tablix grouping columns: Fügt Gruppierungsspalten ein oder entfernt sie aus einem bestehenden Tablix.
- Trailing comments: Schützt RDLC-Ausdrücke mit Kommentaren vor unerwünschten Änderungen beim Kopieren im Designer.
- Replace fonts: Ersetzt Schriftarten, Größen und Stile gezielt nach den bisherigen Formatierungen.
- Replace colors: Ersetzt statische Farben und Farbangaben innerhalb von Ausdrücken.
- Alternating row colors: Hinterlegt Detailzeilen abwechselnd mit unterschiedlichen Farben.
- Format text / Format text by value: Formatiert ausgewählte Controls beziehungsweise deren Darstellung abhängig vom gerenderten Wert, beispielsweise negative Zahlen in Rot.
- Blank numeric values: Blendet bestimmte Zahlenwerte mit Funktionen wie
BlankZerooderBlankPosaus.
Flexible Filter begrenzen den Wirkungsbereich auf bestimmte Controls, Eigenschaften oder semantische Rollen, beispielsweise Betragsfelder. Mehrere Style-Schritte kannst Du mitsamt Filtern und Reihenfolge als Preset speichern und auf weitere Berichte anwenden. Details, Screenshots und Videos findest Du in der Dokumentation.