Quelltext der Seite Einen Subreport dynamisch in einen Report einbinden

In diesem vertiefenden Beispiel wird ein '''Schulkopf''' in einen bestehenden Report eingebunden.  
Hierzu wird ein '''Subreport''' verwendet, der sich im Ordner '''Header_Footer''' befindet.

Ein '''Subreport''' ist ein eigener Report, der in einen anderen Report eingebunden wird.  
Dies ermöglicht es, wiederkehrende Elemente wie Briefköpfe, Schulköpfe oder Fußzeilen zentral zu pflegen.

==Arten von Subreports==

[[Datei:SchILD_Report_Anpassen_17.png|thumb|hochkant=1.5|"Dynamische Subreports" (links) und "statische Subreports" (rechts).]]

Es gibt zwei Arten von Subreports:

* '''Statischer Subreport'''  
  Ein statischer Subreport wird einmalig in den Hauptreport eingefügt und dort gespeichert.  
  Änderungen am Subreport wirken sich auf den Hauptreport nur aus, wenn dieser manuell angepasst wird.  
  (Im Bild links.)

* '''Dynamisch ladbarer Subreport'''  
  Ein dynamischer Subreport wird nicht eingebettet, sondern verknüpft.  
  Beim Erzeugen des Hauptreports wird der Subreport jedes Mal neu geladen.  
  Änderungen im Subreport wirken daher automatisch in allen Reports, die ihn verwenden.  
  Dies eignet sich besonders für einheitliche oder institutionell gepflegte Elemente wie Schulköpfe.  
  (Im Bild rechts.)

{{Info/Achtung|1=Wird ein dynamischer Subreport in seiner Höhe verändert, kann dies in anderen Reports zu unerwünschten Layoutverschiebungen führen.  
Ein dynamischer Subreport sollte nach der Erstkonfiguration nur vorsichtig in seinen Abmessungen verändert werden.}}

<br clear=all>

[[Datei:SchILD_Report_Anpassen_18.png|thumb|hochkant=1.5|Nutzen eines ''dynamischen Subreports''.]]
Im Beispiel wird ein '''dynamischer Subreport''' im '''Kopf''' des aktuellen Reports platziert.

Dazu wird das entsprechende Werkzeug aus der Werkzeugleiste gewählt und an die gewünschte Stelle gesetzt.  
Über einen Rechtsklick wird anschließend das Kontextmenü geöffnet und die Option  
'''Subreport-Datei wählen…''' aufgerufen.

{{Info/Hinweis|1=Im Kontextmenü sollte '''Dehnen''' aktiviert sein.  
Dies bedeutet, dass sich das Feld des Subreports automatisch an die Größe des Inhalts anpasst.}}

[[Datei:SchILD_Report_Anpassen_19.png|thumb|hochkant=1.2|Wahl des zu verwendenden Subreports als Kopf.]]

Im Ordner '''Header_Footer''' wird nun der passende Kopf gewählt.

<br clear=all>

[[Datei:SchILD_Report_Anpassen_20.png|thumb|hochkant=1.5|Der Kopf erscheint über der Klassenliste.]]

Der Schulkopf erscheint nun über dem aktuellen Report.  
Da er als '''dynamischer Subreport''' eingebunden ist, werden zukünftige Änderungen automatisch übernommen.  
So lassen sich Layout- oder Informationsanpassungen zentral pflegen, ohne jeden Report einzeln ändern zu müssen.

Dies ist insbesondere bei einheitlich zu haltenden Reports (z. B. Listen, Serienbriefe, Zeugnisse) sinnvoll.

[[Kategorie: SchILD-NRW]] [[Kategorie: Reportdesigner]]