Reports verändern (Einführung in SchILD-NRW): Unterschied zwischen den Versionen

__TOC__

Wird ein existierender Report genutzt, können viele Details relativ einfach angepasst werden. Zum Beispiel lassen sich Schriftgrößen- und arten verändern, es lassen sich Layoutelemente verschieben oder neue feste Textfelder oder Datenbankfelder für weitere Informationen hinzufügen. Sollen Informationen nicht erscheinen, können Datenbankfelder gelöscht werden.  

==Struktur und wichtige Elemente eines Reports==

{{Tipp|Wird auf einen existierenden Report geklickt, kann dieser mit '''Report bearbeiten''' im Editor geöffnet und bearbeitet werden.}}

<br clear=all>

Der Report selbst, hier grün markiert, besteht zuerst einmal aus einem '''Kopf'''. Dieser wird immer über einem Report generiert, z.B. der Schulkopf über einem Anschreiben oder die unveränderliche Kopfzeile über einer Liste.  

Der hier lila markierte '''Berichtsbaum''' zeigt die Struktur eines Reports übersichtlich an und gerade bei komplexen Reports wird der Berichtsbaum hilfreich. Hier im Beispiel ist zu sehen, dass ein ''"Label"'', also ein festes Textfeld, und ein "DBText", also irgendein Inhalt aus der Datenbank, in den ''Detailbereich'' gelegt wurde. ''Kopf'' und ''Fuß'' sind leer, daher zeigt sich hier auch nichts im ''Berichtsbaum''.

{{Tipp|Der Berichtsbaum wird besonders relevant, wenn Reports eventuell mehrfach geschachtelte ''Unterberichte'' verwenden. Schauen Sie als Beispiel in einen Zeugnis-Report.}}

===Beispiel zu unveränderlichen und Datenbank-Textfeldern===

Im Beispiel hier wurde zum einen in Rot hervorgehoben, wie ein festes Textfeld gesetzt wird. Um ein Feld zu setzen, wird das Werkzeug angeklickt, dann wird im Report an die Stelle geklickt, an der das Feld erscheinen soll. Im Anschluss kann das Feld noch verschoben werden.

Ein Label kann mit Text befüllt werden, indem es doppelt angeklickt wird oder indem es mit einem Klick aktiviert und dann über die Werkzeugleiste editiert wird.

<br clear=all>

Jedoch ist der Eintrag hier nur so breit, wie das DBText-Feld in unserem Report und so sind längere Namen abgeschnitten. Diesen Fehler gilt es nun zu korrigieren.

====Beispiel: Konfiguration von Feldern über das Rechtsklick-Kontextmenü====

Ein erneuter Klick auf '''Vorschau'''...  

<br clear=all>

... erzeugt ein zufriedenstellendes Ergebnis, mit dem sich weiterarbeiten lässt.

<br clear=all>

Der Report kann wie von normalen Textverarbeitungsprogrammen gewohnt über ''Datei'' ➜ ''Speichern'' beziehungsweise ➜ ''Speichern unter...'' gespeichert werden.

{{Hinweis|Es wird hierbei der Report, also der gerade erstellte "Bauplan" gespeichert, nicht das fertige Ergebnis eines konkret erzeugen Reports.}}

{{Achtung|Achten Sie darauf, dass Reports nur verwendet werden können, wenn sie im SchILD-Reportverzeichnis - oder Unterordnern darin - abgelegt werden.}}

===Schriftgröße und Schriftart anpassen===

Im Modus '''Entwurf''' des Editors klicken wir ein Textfeld an. Nun erscheinen zwei Dropdownmenüs oben in Werkzeugbereich, in denen ''Schriftart'' und ''Schriftgröße'' angewählt werden können.

<br clear=all>

Das Alter soll nun hinter dem Geburtsdatum erscheinen. Hierzu wird ein DBText-Feld hinzugefügt, es sollte nicht direkt neben dem Geburtsdatum legen, damit sich die Felder bei langen Geburtsdaten nicht überlappen.

<br clear=all>

===Erstellung des Reports===

Alternativ kann die Tastenkombination ''"Strg + N"'' verwendet werden.

Dann ist "Berichtsassistent" zu wählen und mit "Ok" zu bestätigen.

<br clear=all>

In dieser Maske ist zuerst eine ''Datenquelle'' zu wählen. Da eine Liste voller Schülerdaten erzeugt werden soll, wird die Datenquelle ''"Schueler"'' gewählt.

<br clear=all>

Mit einem Doppelklick wurde das Datenfeld ''"Klasse"'' nach unten in '''Gruppen''' verschoben. Dies bedeutet nun, dass alle Schüler, bei denen dieses Merkmal gleich ist, zu einer Gruppe zusammengefasst sind. Durch die Wahl des Feldes "Klasse" erzeugen wir nun eine nach Klassen sortierte Liste.

<br clear=all>

Im nächsten Fenster wird ein Layout gewählt, hier wäre einfach zu schauen, was für den gewünschten Report sinnvoll erscheint. Hier im Beispiel wurde einfach '''Links ausrichten''' angewählt.

<br clear=all>

Im nächsten Fenster ist ein Stil zu wählen. Hier wurde ''sachlich'' angewählt.

<br clear=all>

In diesem abschließenden Fenster wird gewählt, ob der Report im '''Editor''' oder in der '''Vorschau''' geöffnet wird. Ein Wechsel ist nach dem Abschluss des Assistenten möglich.

<br clear=all>

Im fertig generierten Report wurde viel Arbeit schon erledigt: die Felder sind vorhanden, es wird ordentlich nach der Klasse gruppiert und die Schüler sind sauber in einer Liste. Weiterhin finden sich im Fuß das Datum des Drucks und eine Seitenzahl.

====Einfache Anpassungen zu Layout, Linien und Schriften====

Folgende Aspekte sollen verbessert werden:  

* Es fällt auf, dass im Report ein ''Titel'' vorhanden ist. Dieser Titel wird nur auf die erste Seite des Reports gedruckt, was Sinn machen kann, bei Klassenlisten aber nicht. Hier hätte etwa die Liste der 5a als erste Klasse einen Titel, alle anderen Klassen nicht.

<br clear=all>

Der Titel kann über '''Bericht''' deaktiviert werden. Ein ''Titel'' steht nur auf der ersten Seite, die ''Zusammenfassung'' findet sich auf der letzten, während ''Kopf'' und ''Fuß'' auf jeder Seite über und unter dem ''Detailbereich'' generiert werden. Hat man einen Report, in dem ''Kopf'' und ''Fuß'' nicht benötigt werden lassen sich diese hier deaktivieren.  

<br clear=all>

Wieder werden mit ''Shift + Klickklickklick'' alle gewünschten Felder angewählt, bei denen "blaue Farbe" identifiziert wurde. Dies betrifft die Kopfzeilentextfelder, ''Klasse'' und das Druckdatum im Gruppenfuß. Mit einem Klick auf das ''Schriftfarbenwerkzeug'' lassen sich die Schriften in Schwarz umfärben.

Das letzte Detail, das angepasst wird, ist das Textfeld im Gruppenkopf für das Geschlecht. Da das Datenbankfeld "GeschlechtMW" heißt, wird auch genau diese Bezeichnung in der Kopfzeile übernommen. Diese Bezeichnung sieht nicht gut aus und wird in "Geschlecht" geändert - das Datenbankfeld darunter im Detailbereich heißt natürlich weiterhin "GeschlechtMW".

Um Eintragungen von Hand in der Liste vorzunehmen, wären einige Trennlinien wünschenswert.

<br clear=all>

Der Report sieht nun wie folgt im Editormodus aus...

<br clear=all>

... und hier als das vorläufig fertige Ergebnis:

<br clear=all>

=====Gruppen für Seitenwechsel=====

[[Datei:SchILD_Report_Anpassen_7.png|thumb|Aufrufen der Gruppeneinstellungen.]]

<br clear=all>

Hier sind nun alle eingestellten Gruppen zu sehen, in diesem Fall ist dies nur die eine.

====Systemvariablen====

Eine ''Systemvariable'' wurde schon vom Berichtsassistenten gesetzt: Das ''Druckdatum'' im Fuß des Reports.

====Zeilennummerierung per Zähler====

Um einen Zähler zu Beginn einer Zeile hinzuzufügen, muss der erste Eintrag etwas nach rechts verschoben werden. Hierzu werden NameVorname und das erste Datenbankfeld markiert und nach rechts geschoben.

<br clear=all>

Mit einem Rechtsklick öffnet sich das Kontextmenü von ''DBCalc''. Es gibt die Möglichkeit, über Felder eine ''Summe'', das ''Maximum'', das ''Minimum'', den ''Mittelwert'' oder die jeweils laufende Position von '''Laufender Zähler'' auszugeben. Diese Wahlmöglichkeit wird für den Zähler hier eingestellt.  

<br clear=all>

Da bei der hier erstellten Klassenliste nicht die komplette Schülermenge laufend durchgezählt werden soll, wird die Gruppe ''Klasse'' genutzt, den Zähler - wie bei den Seitenzahlen auch schon - bei einem Gruppenwechsel zurückzusetzen.

<br clear=all>

{{Hinweis|Zuerst einmal wird festgestellt, dass die Zeilen zu hoch sind. Dies liegt daran, dass nach der Justierung des Zählerfeldes vergessen wurde, den für die Arbeit vergrößerten Detailbereich wieder klein zu schieben. Dies wird nun nachgeholt.}}

<br clear=all>

Hierzu wird wieder mit einem Rechtsklick das Kontextmenü aufgerufen, dann wird '''Anzeigeformat'' ausgewählt.

<br clear=all>

Das Anzeigeformat lässt sich frei wählen, der Zähler hier soll z.B. "5." ausgeben. Daher wird die Zeilenfolge '''#'.'''' eingetippt. "#" steht hier für die aktuelle Zahl des Zählers, und '.' bedeutet, dass dahinter der Punkt gesetzt wird.

<br clear=all>

Das Ergebnis der Arbeit sieht nun sehr brauchbar aus. Aus der Spalte auf der linken Seite geht hervor, dass jede Klasse nun auf einer eigenen Seite dargestellt wird.  

Exemplarisch wird nun noch ein Schulkopf eingebunden werden. Hierzu verwenden wir einen ''Subreport'', der sich im Ordner ''Header_Footer'' befindet, da es sich um einen Kopf handelt.

Es gibt zwei Arten von ''Subreports''

* Ein normaler '''Subreport:''' Ein solcher Subreport wird einmal bei der Erstellung des Hauptreports entweder von Hand angelegt oder aus einem existierenden Report geladen. Dann ist dieser mit im Hauptreport gespeichert und muss auch in diesem verändert werden. Im Screenshot ist dies das linke markierte Werkzeug.

<br clear=all>

Zuerst wird ein Feld für einen '''dynamisch ladbaren Subreport''' über die Werkzeugleiste im Kopf des aktuellen Reports abgelegt.

{{Hinweis|Achten Sie  im Kontextmenü auch darauf, dass '''Dehnen''' aktiviert ist. Dieser Schalter bedeutet, dass sich die Felder - hier das Feld des ''dynamischen Subreports'' an die Größe des Inhalts anpassen.}}

Dann wird eine passender Kopf gewählt, der sich im Ordner ''Header_Footer'' befindet.

<br clear=all>

Nun erscheint dieser Kopf über dem hier erstellten Report. Da es sich bei dem Kopf um einen dynamischen Subreport handelt, werden auch alle in Zukunft erzeugten Listen eventuelle Veränderungen an diesem aktuell noch sehr rudimentären Kopf enthalten.

<br clear=all>

==Reports programmieren==

Da sich der folgende Abschnitt an ein Fachpublikum richtet, fällt er mitunter weniger detailliert aus, als der Rest des Wikis.}}

{{Hinweis|Bitte achten Sie darauf, ob etwas tatsächlich programmiert werden muss oder ob nicht Datenbankfunktionen die gleiche Funktionalität schon mit Bordmitteln bereitstellen. Es empfiehlt sich bei aller technischen Begeisterung die Reports einfach zu halten.}}

Für dieses Beispiel soll die Klassenliste noch ein neues Feature enthalten: Wenn die Datenweitergabe für einen Schüler gesperrt ist, im SchILD wird dies in den Individualdaten I als ''"Keine Auskunft an Dritte'' markiert, wird das Geburtsdatum in der Liste unterdrückt. Denkbar wäre es, auch in Telefon- und Adressenlisten eben Telefonnummern und die Anschrift nicht auszugeben.

Damit können wir nun programmieren:

Die Programmierung ist dann Pascal-Standard.

Unterhalb des Programmierfeldes findet sich eine Zeile, die über Syntaxfehler berichtet.  

<br clear=all>

[[Datei:SchILD_Reports_Programmieren_4.png|thumb|Das (soweit) fertige Ergebnis.]]

{{Tipp|Schauen Sie zur Orientierung in der Programmierung in eines der Zeugnisformulare.}}

<br clear=all>

[[Kategorie: SchILD-NRW]] [[Kategorie: Report]]