CodX Reporting  CxReport-Designer

Berichtselemente

Im Berichts-Designer wird ein Bericht aus Steuerelementen (Textbeschriftungen, Bilder, Diagramme usw.) erstellt, die über Berichtsabschnitte verteilt sind, die als Bänder bezeichnet werden (verschiedene Kopf- und Fußzeilen sowie Inhaltsabschnitte).

Berichtssteuerelemente

Mit Hilfe von Berichtssteuerelementen können Sie in Ihren statischen und dynamischen Berichten verschiedene Arten von Informationen darstellen (z. B. einfachen oder formatierten Text, Bilder, Tabellen usw.) und das Layout Ihres Berichts anpassen (indem Sie die Steuerelemente in Bereichen anordnen und Seitenumbrüche an den gewünschten Stellen einfügen).

In der folgenden Tabelle sind die verfügbaren Steuerelemente aufgelistet (in der gleichen Reihenfolge wie in der Toolbox).

Symbol Beschreibung
Das Steuerelement Text ist für die Anzeige von statischem oder dynamischem Text oder beidem in Ihrem Bericht vorgesehen. Darüber hinaus kann es zur Berechnung von Standard-Summierungsfunktionen für ein Datenfeld verwendet werden.
Das Steuerelement Kontrollkästchen dient dazu, die Zustände Wahr/Falsch oder Angekreuzt/Unangekreuzt/Unbestimmt in einem Bericht anzuzeigen, indem ein Häkchen angezeigt wird (oder nicht), das von einer Textbeschreibung begleitet werden kann.
Das Steuerelement Rich Text ermöglicht es Ihnen, formatierten Text in Ihrem Bericht anzuzeigen. Es kann statischen oder dynamischen Text oder beides anzeigen. Sie können auch Inhalte aus einer externen TXT- oder RTF-Datei (die auch Bilder enthalten kann) in den Rich Text laden.
Das Steuerelement Bild ist für die Anzeige von Bildern zahlreicher Formate in einem Bericht vorgesehen. Ein Bild kann aus einer externen Datei, aus einer gebundenen Datenquelle oder von einem Web-Speicherort unter Verwendung der angegebenen URL geladen werden.
Das Rahmenelement ist ein Container, der einzelne Berichtssteuerelemente einrahmt, damit sie leicht verschoben, kopiert und eingefügt werden können, und sie in der Berichtsvorschau visuell vereint (mit Rahmen oder einem einheitlichen farbigen Hintergrund).
Das Steuerelement Tabellen dient dazu, Informationen in einem tabellarischen Layout anzuordnen. Es kann eine beliebige Anzahl von Zeilen enthalten, die aus einzelnen Zellen bestehen. Sowohl Zeilen als auch Zellen können ausgewählt und individuell angepasst werden. In den meisten Fällen ähnelt eine Zelle einem Text-Steuerelemment, kann aber auch andere Steuerelemente enthalten (z. B. Bild oder Rich Text).
Das Steuerelement Charakterkamm zeigt den Text so an, dass jedes Zeichen in einer einzelnen Zelle gedruckt wird.
Das Steuerelement Linie zeichnet eine Linie mit einer bestimmten Richtung, einem bestimmten Stil, einer bestimmten Breite und einer bestimmten Farbe. Es kann sowohl zur Dekoration als auch zur visuellen Trennung von Berichtsabschnitten verwendet werden. Das Steuerelement Linie kann im Gegensatz zum Steuerelement Bereichübergreifende Linie keine Berichtsbänder kreuzen.
Mit dem Steuerelement Figur können Sie einfache grafische Objekte in Ihren Bericht einbetten. Sie können eine der zahlreichen vordefinierten Formen auswählen (z. B. Rechtecke, Ellipsen, Pfeile, Polygone, Kreuze und Klammern verschiedener Art).
Das Steuerelement Barcode wandelt seinen Inhalt in einen Barcode des angegebenen Typs um. Es werden mehrere Standard-Strichcode-Typen unterstützt.
Das Diagramm ist ein ausgeklügeltes Steuerelement, mit dem Sie Diagramme in Ihren Bericht einbetten können. Es stellt eine Reihe von Punkten mit Hilfe zahlreicher 2D- oder 3D-Diagrammtypen grafisch dar. Ein Diagramm kann sowohl manuell (durch Angabe von Argumenten und Werten für jeden Punkt) als auch dynamisch (durch Verbindung mit der Datenquelle des Berichts oder durch Bindung an eine separate Datenquelle) mit Daten gefüllt werden. Weitere Informationen finden Sie unter Diagramm mit statischen Reihen und Diagramm mit dynamischen Reihen.
Mit dem Steuerelement Messgerät können Sie grafische Messgeräte in Ihren Bericht einbetten.
Das Steuerelement Sparkline zeigt ein kompaktes Diagramm an, das in der Regel verwendet wird, um den Datenfluss für jede Zeile in einem Bericht darzustellen.
Mit dem Steuerelement Unterbericht können Sie andere Berichte in Ihren aktuellen Bericht aufnehmen.
Das Steuerelement Inhaltsverzeichnis erzeugt ein Inhaltsverzeichnis auf der Grundlage von Lesezeichen, die für Berichtselemente angegeben wurden.
Das Steuerelement Seiteninformation dient dazu, Seitenzahlen und Systeminformationen zu einem Bericht (das aktuelle Datum und Uhrzeit oder den aktuellen Benutzernamen) in Ihren Bericht einzufügen. Wie bei vielen anderen Steuerelementen auch, können Sie den Inhalt dieses Steuerelements formatieren.
Der einzige Zweck des Steuerelements Seitenumbruch ist das Einfügen eines Seitentrennzeichens an einer beliebigen Stelle innerhalb eines Berichts.
Mit dem Steuerelement Bereichübergreifende Linie können Sie eine Linie durch mehrere Berichtsbänder ziehen. Dies kann nützlich sein, wenn Sie einen aus mehreren Bereichbereichen bestehenden Abschnitt visuell hervorheben möchten. In anderen Aspekten ähnelt sie einer normalen Linie.
Mit dem Steuerelement Bereichübergreifende Kasten können Sie ein Rechteck durch mehrere Berichtsbänder ziehen. Dies kann nützlich sein, wenn Sie einen Abschnitt, der aus mehreren Bereichbereichen besteht, visuell umschließen müssen.

Berichtsbereiche

Ein Berichtsbereich (Band) ist ein bestimmter Bereich auf einer Berichtsseite, in dem festgelegt wird, wie die zugehörigen Berichtssteuerelemente gerendert werden sollen, in welcher Reihenfolge und wie oft sie gerendert werden sollen. Im Berichtsdesigner besteht jeder Bericht aus einer Reihe von Bereichen, jedes von einem anderen Typ.

Verfügbare Bereiche

In der folgenden Tabelle sind alle verfügbaren Bereichstypen aufgeführt.

Bereich Beschreibung
Oberer Randbereich Befindet sich am oberen Rand jeder Seite, über dem Seitenkopf und dem Berichtskopf. Dieser Bereich ist für die Anzeige von Seitenzahlen oder bestimmte Zusatzinformationen (z.B. aktuelle Systemzeit oder Benutzername) vorgesehen.
Berichtskopfbereich Befindet sich am Anfang eines Berichts. Dieser Bereich soll einige einleitende Informationen anzeigen, z. B. den Namen des Berichts, das Firmenlogo, Erstellungsdatum, Benutzername, usw.
Seitenkopfbereich Befindet sich oben auf jeder Seite, unterhalb des oberer Randbereichs und des Berichtskopfes. Dieser Bereich ist der beste Platz für Informationen, die auf jeder Seite gedruckt werden sollen. Verwenden Sie ihn zum Beispiel, um die Kopfzeile einer Tabelle anzuzeigen, die von der vorherigen Seite fortgesetzt wird.
Gruppenkopfbereich Befindet sich am Anfang jeder Gruppe oder am Anfang der Seite, falls sie auf mehrere Seiten aufgeteilt ist. Dieser Bereich gibt die Gruppierungskriterien an und wird verwendet, um Informationen am Anfang einer Gruppe von Datensätzen anzuzeigen.
Detailbereich Befindet sich im zentralen Teil eines Berichts zwischen allen anderen Bändern. Dieser Bereich kann nicht gelöscht werden, da die derzeitige Berichtsstruktur das Detailbereich in seinem Kern enthält. Dieser Bereich zeigt jeweils einen einzelnen Datensatz aus der gebundenen Datenquelle an oder enthält einfach ungebundene Steuerelemente, wenn einem Bericht keine Datenquelle zugewiesen ist.
Detailbericht Bereich Befindet sich unterhalb des Detailbereiches und wird verwendet, um einen Bericht in einen anderen Master-Detail-Bericht einzubinden. Es unterscheidet sich vom Detailbereich, da es den gesamten Detailbericht in einem Master-Detail-Berichtslayout enthält und daher auch andere Arten von Bändern enthalten kann.
Gruppenfußbereich Befindet sich am Ende jeder Gruppe oder am unteren Ende der Seite, falls die Gruppe auf mehrere Seiten verteilt ist. Dieser Bereich dient in erster Linie dazut, zusammenfassende Informationen für eine Gruppe anzuzeigen.
Berichtsfußbereich Befindet sich am Ende des Berichts, oberhalb des Seitenfußbereiches und des Unteren Randbereichs auf der letzten Seite des Berichts. Dieser Bereich ist für die Anzeige einiger abschließender Informationen vorgesehen, z. B. der Berichtssummen.
Seitenfußbereich Befindet sich am unteren Rand auf jeder Seite, unterhalb des Berichtsfußbereiches und oberhalb des Unteren Randbereichs. Dieser Bereich ist für die Anzeige von Seitenzahlen oder einer Tabellenfußzeile vorgesehen, die auf der Folgeseite fortgesetzt wird.
Unterer Randbereich Befindet sich am unteren Rand auf jeder Seite, unterhalb des Seitenfußbereiches. Dieser Bereich ist für die Anzeige von Seitenzahlen oder bestimmte Zusatzinformationen (z.B. aktuelle Systemzeit oder Benutzername) vorgesehen.
Unterbereich Dieser Bereich stellt eine funktionale Kopie des Quellbereichs dar, unter dem es sich befindet. Das Verhalten eines Unterbereichs sowie seine Position innerhalb der Berichtsbereichhierarchie wird durch den Quellbereichtyp bestimmt. Mit Ausnahme der Bereiche Oberer Randbereich und Unterer Randbereich sowie des Unterbereiches selbst können beliebig viele Unterbereiche zu einem Berichtsbereich beliebigen Typs hinzugefügt werden. Mit Hilfe von Unterbereichen ist es möglich, mehrere Versionen eines Bereiches innerhalb eines einzigen Berichts zu erstellen und später eine geeignete Version auf der Grundlage einer bestimmten Bedingung auszuwählen.

Bereichpositionen

Die folgende Abbildung veranschaulicht die relative Position der verschiedener Bereichtypen und wie oft sie in einem Bericht gerendert werden.

Die Bereiche Seitenkopf, Seitenfuß, Oberer Randbereich und Unterer Randbereich werden in der Berichtsvorschau auf jeder Seite angezeigt.

Die Bereiche für den Berichtskopf und den Berichtsfuß werden nur einmal in der Berichtsvorschau angezeigt.

Die Bereiche für den Gruppenkopf und den Gruppenfuß werden für jede Gruppe von Datensätzen in einem Bericht angezeigt.

Wie oft der Detailbereich in einem Bericht angezeigt wird, hängt von der Anzahl der Datensätze ab, die von der gebundenen Datenquelle zurückgegeben werden – ein Bereich pro Datensatz.

Bearbeiten von Bereichen

Die folgende Abbildung zeigt das Standard-Layout des Berichts. Es ist in drei grundlegende Bereichen unterteilt (oberer Rand, Detail und unterer Rand), die Platz zum Platzieren verschiedener Berichtssteuerelemente bieten.

Um ein neuer Bereich eines bestimmten Typs hinzuzufügen, verwenden Sie das Kontextmenü des Berichts oder der Bereiche. Klicken Sie mit der rechten Maustaste auf einen Bericht in der Entwurfsoberfläche oder im Berichtsexplorer und wählen Sie einen Bereich aus, das in den Bericht eingefügt werden soll.

Elemente der Benutzeroberfläche

Die Themen in diesem Abschnitt beschreiben die Hauptelemente der Benutzeroberfläche des Berichts-Designers.

Werkzeugleiste

Die Werkzeugleiste ermöglicht Ihnen die einfache Ausführung verschiedener Berichtsbefehle.

Startseite Befehle

Verwenden Sie die folgenden Befehle, um die ausgewählten Berichtselemente zu bearbeiten.

Symbol Befehl Beschreibung
Speichern Speichert den aktuellen Berichtin die Standarddatei.
Ausschneiden Schneidet die ausgewählten Berichtselemente in die Zwischenablage aus.
Kopieren Kopiert die ausgewählten Berichtselemente in die Zwischenablage.
Einfügen Fügt den Inhalt der Zwischenablage in das ausgewählte Berichtsbereich ein.
Rückgängig Macht die letzte am Bericht vorgenommene Änderung rückgängig.
Wiederholen Macht die Ergebnisse der letzten Rückgängig-Aktion rückgängig.
Schriftartenname Gibt den Schriftartnamen der ausgewählten Elemente an.
Schriftgröße Legt die Schriftgröße der ausgewählten Elemente fest.
Schriftfarbe Legt die Schriftfarbe der ausgewählten Elemente fest.
Hintergrundfarbe Legt die Hintergrundfarbe der ausgewählten Elemente fest.
Fett, Kursiv, Unterstrichen, Durchgestrichen Wendet Fettformatierung, Kursivformatierung, Unterstreichung und Durchstreichung auf/von den ausgewählten Elementen an/entfernt sie.
Links, Mitte, Rechts, Blocksatz Legt die horizontale Textausrichtung der ausgewählten Elemente fest.
Oben, Mitte, unten Legt die vertikale Textausrichtung der ausgewählten Elemente fest.

Anordnen Befehle

Mit diesen Befehlen können Sie die Reihenfolge gestapelter Elemente ändern.

Symbol Befehl Beschreibung
In den Vordergrund Bringt die ausgewählten Elemente in den Vordergrund einer Gruppe gestapelter Elemente oder verschiebt die ausgewählten Elemente einen Schritt weiter nach vorne.
In den Hintergrund Verschiebt die ausgewählten Elemente hinter eine Gruppe gestapelter Elemente oder verschiebt die ausgewählten Elemente einen Schritt nach hinten.

Aussehen Befehle

Verwenden Sie die folgenden Befehle, um das Dialogfeld Seitenfarbe oder Wasserzeichen aufzurufen .

Symbol Befehl Beschreibung
Seitenfarbe Damit können Sie einem Bericht die Hintergrundfarbe der Berichtsseiten auswählen.
Wasserzeichen Ruft den Wasserzeichendialog auf. Damit können Sie einem Bericht ein Textwasserzeichen hinzufügen oder ein Bild in den Hintergrund eines Berichts verwandeln.

Hinzufügen von Steuerelementen zu einem Bericht

Um ein Steuerelement aus der Toolbox zu einem Bericht hinzuzufügen, führen Sie einen der folgenden Schritte aus.

  • Doppelklicken Sie auf ein Element in der Toolbox, um das entsprechende Steuerelement an der Standardposition zu erstellen.

  • Ziehen Sie ein Element aus der Werkzeugleiste per Drag & Drop an die gewünschte Position im Bericht.

  • Wählen Sie ein Element in der Toolbox aus und markieren Sie dann das Begrenzungsrechteck, indem Sie die linke Maustaste gedrückt halten.

Wenn Sie Auswahl-, Anordnungs- oder Größenänderungsvorgänge durchführen müssen, wählen Sie das Zeigerelement ().

Feldliste

Der Bereich Feldliste soll die Struktur der Datenquelle anzeigen, an die ein Bericht derzeit gebunden ist. Dieses Bedienfeld kann auch verwendet werden, um neue gebundene Berichtssteuerelemente zu erstellen.

Gebundene Berichtselemente erstellen

Nach dem Binden eines Berichts an Daten zeigt die Feldliste die Struktur der Datenquelle des Berichts an, die der Eigenschaft Datenquelle zugewiesen ist. Anschließend kann die Feldliste verwendet werden, um neue gebundene Steuerelemente hinzuzufügen.

Um ein neues gebundenes Berichtselement hinzuzufügen, klicken Sie auf ein gewünschtes Feldelement in der Feldliste und ziehen Sie es dann per Drag & Drop auf den Berichtsbereich. Dadurch wird ein entsprechendes Steuerelement erstellt, das an das ausgewählte Datenfeld gebunden ist.

Report Explorer

Der Report Explorer spiegelt die Struktur eines Berichts in einer baumartigen Form wider und bietet einfachen Zugriff auf Berichtselemente. Darüber hinaus enthält der Report Explorer den Knoten Komponenten, der nicht sichtbare Berichtskomponenten wie Datenobjekte anzeigt, die beim Binden eines Berichts an eine Datenquelle erstellt werden. Sie können den Report Explorer auch verwenden, um Stile und Formatierungsregeln zu verwalten, die für einen Bericht verfügbar sind.

Um auf die Einstellungen eines Berichtselements oder einer Komponente zuzugreifen und diese zu bearbeiten, wählen Sie sie im Report Explorer aus und wechseln Sie zum Eigenschaften-Fenster. Sie können auch mit der rechten Maustaste auf Elemente und Komponenten klicken, um deren Kontextmenü aufzurufen.

Im Report Explorer sind datenabhängige Steuerelemente mit einem speziellen Datenbanksymbol gekennzeichnet.

Sie können Stile und Formatierungsregeln mit Hilfe von Befehlen verwalten, die in Kontextmenüs verfügbar sind. Um ein Kontextmenü aufzurufen, klicken Sie mit der rechten Maustaste auf den entsprechenden Stammknoten oder seinen Unterknoten.

Gruppen- und Sortierfeld

Mit dem Gruppen- und Sortierfeld können Sie Berichtsdaten schnell gruppieren und sortieren.

WICHTIG

Wenn ein Bericht nicht an eine Datenquelle gebunden ist, ist das Gruppen- und Sortierfeld inaktiv.

Um ein neues Sortier- oder Gruppierungskriterium zu erstellen, klicken Sie auf die Schaltfläche Sortierung hinzufügen bzw. Gruppe hinzufügen. Wählen Sie dann das gewünschte Datenquellenfeld in der aufgerufenen Dropdown-Liste aus.

Nach dem Hinzufügen des Gruppierungskriteriums wird der Bereich Gruppenkopf automatisch erstellt. Sie können manuell festlegen, ob die entsprechende Gruppenkopfzeile und Gruppenfußzeile angezeigt werden sollen, indem Sie die Kontrollkästchen Kopfzeile anzeigen und Fußzeile anzeigen aktivieren.

Sie können den Sortiermodus (aufsteigend oder absteigend) auswählen oder die Sortierung in der Dropdown-Liste Sortierreihenfolge deaktivieren.

Im Gruppen- und Sortierfeld können Sie auch die Rangfolge mehrerer Gruppierungs- und Sortierkriterien ändern, indem Sie die Schaltflächen Nach oben und Nach unten verschieben verwenden.

Um ein Gruppierungs- oder Sortierkriterium zu entfernen, wählen Sie es aus und klicken Sie auf die Schaltfläche Entfernen.

Eigenschaften-Fenster

Verwenden Sie das Fenster Eigenschaften, um die Eigenschaften ausgewählter Berichtselemente anzuzeigen, zu ermitteln und zu ändern.

Wechseln Sie zur Registerkarte Ansicht des Menübands, erweitern Sie die Gruppe Fenster und klicken Sie auf Eigenschaften, um das Eigenschaftenfenster anzuzeigen oder auszublenden.

Ein Berichtselement auswählen

Führen Sie einen der folgenden Schritte aus, um ein Berichtselement auszuwählen und seine Eigenschaften im Fenster Eigenschaften anzuzeigen:

  • Wählen Sie ein Berichtselement aus der Dropdown-Liste oberen Rand im Eigenschaftenfenster aus.

  • Klicken Sie auf der Entwurfsoberfläche auf ein Berichtselement.

  • Wählen Sie im Report Explorer ein Berichtselement aus.

Kategorie Reiter

Im Eigenschaftenfenster sind die Eigenschaften in Kategorie-Registerkarten aufgeteilt und alphabetisch sortiert.

Bevorzugte Eigenschaften

Die Registerkarte Favoriten enthält die am häufigsten verwendeten (oder „bevorzugten“) Eigenschaften.

Verwenden Sie den Favoriteneigenschaften-Editor, um der Registerkarte Favoriten Eigenschaften hinzuzufügen. Klicken Sie auf das Menüelement Favoriteneigenschaften bearbeiten..., um den Favoriteneigenschaften-Editor zu öffnen, in dem die Berichtssteuerelemente aufgelistet sind. Aktivieren/deaktivieren Sie Eigenschaften, um die Listen der bevorzugten Eigenschaften dieser Steuerelemente zu ändern.

Eigenschaftswerte ändern

Eine Markierung neben jeder Eigenschaft zeigt an, ob ein Eigenschaftswert von seinem Standardwert abweicht.

Klicken Sie mit der rechten Maustaste auf den Editor einer Eigenschaft, um den Wert zurückzusetzen.

Ausdrücke spezifizieren

Im Eigenschaftenfenster können Sie Ausdrücke (Expressions) festlegen, die Eigenschaftswerte spezifizieren. Klicken Sie auf die Schaltfläche f, um einen Ausdruck im aufgerufenen Ausdruckseditor anzugeben.

Suchen nach Eigenschaften

Mit dem integrierten Suchfeld können Sie nach Eigenschaften suchen. Wenn Sie etwas in das Suchfeld eingeben, filtert das Eigenschaftenfenster die Liste und zeigt Eigenschaften an, die mit dem eingegebenen Text übereinstimmen.

Wenn Sie zwei Teilzeichenfolgen eingeben, die durch ein Leerzeichen getrennt sind, werden diese Teilzeichenfolgen als einzelne Suchkriterien betrachtet. Das Eigenschaftenfenster werden die Eigenschaften angezeigt, die mit einer dieser Teilzeichenketten übereinstimmen. Um Eigenschaften zu finden, die beide Teilzeichenketten enthalten, schließen Sie die eingegebene Zeichenkette in Anführungszeichen ein oder geben „+“ vor der zweiten Teilzeichenfolge ein (z. B. Vordergrund + Farbe).

Geben Sie „-“ ein, um Eigenschaften auszuschließen, die eine bestimmte Teilzeichenkette enthalten (z. B. Rahmenfarbe).

Entwurfsoberfläche

Die Entwurfsoberfläche zeigt einen Bericht an, der derzeit im Report-Designer bearbeitet wird.

Lineale

Die horizontalen und vertikalen Lineale zeigen Markierungen in den für einen Bericht angegebenen Maßeinheiten an. Klicken Sie auf ein Element, um seine Größe und Position mithilfe der Lineale zu ermitteln.

Mit dem vertikalen Lineal können Sie auch die Bereichshöhe ändern, indem Sie den oberen und unteren Schieberegler bewegen.

Bereich Beschriftungen

Im Report Designer trägt jeder Berichtsbereich eine Beschriftung, einen Registertitel und eine Farbe, die von der Art des Bereiches abhängen. Diese Beschriftungen werden im resultierenden Berichtsdokument nicht gedruckt und sind nur zur Entwurfszeit sichtbar.

Um auf die Bereich-Eigenschaften zuzugreifen, wählen Sie den Bereich aus, indem Sie auf seine Beschriftung klicken, und wechseln Sie dann zum Eigenschaftenfenster.

Kontextmenüs

Das Kontextmenü bietet schnellen Zugriff auf die am häufigsten verwendeten Aktionen, die von dem Element abhängen, für das es aufgerufen wird. So können Sie z. B. neue Bereiche einfügen, Berichtssteuerelemente ausschneiden/kopieren/einfügen/löschen usw. Für bestimmte Berichtssteuerelemente enthält das Kontextmenü auch die Option Bearbeiten..., die den Dialog mit komplexen Einstellungen aufruft (z Datenbindungseinstellungen, Formatierung usw.) Klicken Sie zum Aufrufen dieses Menüs mit der rechten Maustaste auf ein Berichtselement oder die Entwurfsoberfläche.

In-place Editoren

Ein In-Place-Editor ermöglicht es Ihnen, den Inhalt eines textorientierten Steuerelements (Barcode, Kontrollkästchen, Etikett oder Tabellenzelle) durch Doppelklick zu bearbeiten.

Abfrage-Generator

Der Abfrage-Generator bietet eine visuelle Schnittstelle für die Erstellung von SQL-Abfragen und ermöglicht es Ihnen, eine Vielzahl von Aufgaben zu lösen.

WICHTIG

Der Abfrage-Generator ist für Objekt-, Entity Framework- und Excel-Datenquellen nicht verfügbar.

Datenquelle hinzufügen

Um eine Datenquelle zu einem Bericht hinzuzufügen, klicken sie im Menu unter Startseite auf die Schaltfläche Datenquelle hinzufügen.

Sie können den Query Builder auch verwenden, um Abfragen zu einer bestehenden SQL-Datenquelle hinzuzufügen oder um bestehende Abfragen zu bearbeiten. Klicken Sie dazu mit der rechten Maustaste auf die Datenquelle im Berichtsexplorer und wählen Sie im Kontextmenü Abfragen verwalten.

Klicken Sie in dem aufgerufenen Dialogfeld Abfragen verwalten auf Hinzufügen, um eine neue Abfrage hinzuzufügen. Um eine bestehende Abfrage zu bearbeiten, klicken Sie auf die Schaltfläche mit der Ellipse.

Tabellen auswählen

Um eine bestimmte Datentabelle oder Ansicht zu einer Abfrage hinzuzufügen, ziehen Sie das entsprechende Element aus der Liste der verfügbaren Tabellen und legen Sie es in der Liste der zu verwendenden Datentabellen ab.

Aktivieren Sie die Kontrollkästchen für die Tabellenfelder, die Sie in die Abfrageergebnismenge aufnehmen möchten.

Für jede Tabelle gibt es ein Kontextmenü, mit dem Sie die Tabelle umbenennen oder aus der Abfrage entfernen können.

Um nach einer bestimmten Tabelle oder Ansicht zu suchen, klicken Sie auf die Liste der verfügbaren Tabellen auf der linken Seite und beginnen Sie mit der Eingabe des Suchnamens.

Tabellen verknüpfen

Sie können mehrere Tabellen in derselben Abfrage verknüpfen. Der Abfrage-Generator hebt automatisch die Tabellen hervor, die mit einer der zuvor hinzugefügten Tabellen verbunden sind. Ziehen Sie eine untergeordnete Tabelle auf die gleiche Weise wie eine Haupttabelle, um sie in eine Abfrage einzubeziehen und automatisch eine innere Verknüpfungsbeziehung auf der Grundlage einer Schlüsselspalte zu erstellen.

Eine andere Möglichkeit, Tabellen zu verbinden, besteht darin, in einer Zeile, die einer Schlüsselspalte entspricht, auf die Schaltfläche zu klicken.

Um die Beziehung anzupassen, klicken Sie auf die entsprechende Schaltfläche mit der Ellipse. Verwenden Sie den Verknüpfungseditor, um den Verknüpfungstyp (Left Outer oder Inner), den angewandten logischen Operator (ist gleich, ist kleiner als, etc.) und die Spaltenschlüsselfelder auszuwählen.

Eine linke äußere Verknüpfung gibt alle Werte aus einer inneren Verknüpfung zusammen mit allen Werten in der "linken" Tabelle zurück, die nicht mit der "rechten" Tabelle übereinstimmen, einschließlich Zeilen mit NULL (leeren) Werten im Schlüsselfeld.

Wenn die Tabellen keine Beziehung auf Datenbankebene haben, können Sie die Tabellen manuell verbinden. Wenn Sie in diesem Fall die gewünschte Tabelle per Drag & Drop auf die Liste der zu verwendenden Tabellen ziehen, wird automatisch der Join-Editor aufgerufen, mit dem Sie eine benutzerdefinierte Join-Beziehung konstruieren können.

Nach der Ausführung der Abfrage wird eine "flache" Tabelle zurückgegeben, die aus Datensätzen besteht, die auf der Grundlage der angegebenen Verknüpfungsoptionen ausgewählt wurden.

WICHTIG

Obwohl die Verknüpfung verschiedener Tabellen innerhalb einer einzigen Abfrage in einigen Szenarien erforderlich sein kann, führt die Erstellung hierarchischer Datenquellen im Allgemeinen zu einer besseren Leistung (im Allgemeinen werden Master-Detail-Berichte schneller erstellt als ähnlich aussehende Berichte, die durch Gruppierung "flacher" Datenquellen erstellt werden).

Parameter bearbeiten

Klicken Sie auf die Schaltfläche Parameter bearbeiten, um das Dialogfeld Abfrageparameter aufzurufen, in dem Sie Abfrageparameter hinzufügen und entfernen sowie Parametereinstellungen festlegen können.

Für jeden Abfrageparameter sind die folgenden Eigenschaften verfügbar.

  • Name - gibt den Namen an, mit dem ein Parameter bezeichnet wird.

  • Typ - gibt den Datentyp des Wertes des Parameters an.

  • Ausdruck - bestimmt, ob der aktuelle Parameterwert statisch ist oder dynamisch generiert wird.

  • Wert - gibt den tatsächlichen Wert eines Abfrageparameters an. Wenn die Option Ausdruck aktiviert ist, wird der tatsächliche Parameterwert dynamisch durch Berechnung eines zugehörigen Ausdrucks erzeugt, was besonders nützlich ist, wenn Sie den Abfrageparameterwert dem Wert eines Berichtsparameters zuordnen müssen.

Die erstellten Parameter sind dann auf der Seite Abfrageparameter konfigurieren des Assistenten verfügbar.

Allgemeine Informationen zu Abfrageparametern finden Sie unter Abfrageparameter.

Daten filtern

Um Filterkriterien festzulegen, klicken Sie auf die Schaltfläche Filter... im Query Builder. Dadurch wird der Filter-Editor aufgerufen, der die folgenden Möglichkeiten bietet.

  • Registerkarte Filter

    Der Editor enthält die Registerkarte Filter, auf der Sie Filterbedingungen für die Ergebnisdaten festlegen können. Filterkriterien können Abfrageparameter zugewiesen oder an Berichtsparameter gebunden werden.

  • Registerkarte Gruppenfilter

    Auf der Registerkarte Gruppenfilter können Sie Filterbedingungen für gruppierte und aggregierte Daten festlegen. Wenn die Daten nicht gruppiert sind, ist die zweite Registerkarte deaktiviert.

  • Andere Optionen

    Mit diesem Editor können Sie die Anzahl der resultierenden Datenzeilen begrenzen. Wenn die Daten sortiert sind, können Sie angeben, wie viele Zeilen übersprungen werden sollen, bevor die angegebene Anzahl von Zeilen abgerufen wird.

    WICHTIG

    Je nach ausgewähltem Datenanbieter kann es unmöglich sein, die Skip-Einstellung im anbieterspezifischen SQL-String zu berücksichtigen.

    Eine weitere Option ermöglicht es Ihnen, nur eindeutige Werte in die Ergebnismenge aufzunehmen.

Daten gestalten

Der Abfrage-Generator zeigt die Spaltenliste unter dem Datenquelleneditor an, der verschiedene Gestaltungsmöglichkeiten bietet.

Die folgenden Optionen sind verfügbar.

  • Spalte

    Gibt die ausgewählte Spalte an.

    Sie können eine gewünschte Spalte aus der Dropdown-Liste auswählen oder einen Spaltenausdruck erstellen, indem Sie auf die Ellipsenschaltfläche für die entsprechende Spalte klicken.

  • Tabelle

    Gibt die Tabelle an, die die ausgewählte Spalte enthält.

    Diese Option zeigt an (Alle Tabellen), wenn ein Ausdruck für die entsprechende Spalte angegeben ist.

  • Alias

    Gibt an, ob die Spalte in die Ergebnismenge der Abfrage aufgenommen wird oder nicht.

  • Ausgabe

    Gibt einen benutzerdefinierten Spaltennamen (Alias) an.

    Diese Option ist nur für Spalten verfügbar, die in einer Abfrage enthalten sind.

  • Sortierung Art

    Gibt an, ob die ursprüngliche Reihenfolge der Datensätze innerhalb der Spalte beibehalten oder sortiert werden soll (in aufsteigender oder absteigender Reihenfolge).

    WICHTIG

    Beim Binden an XML-Dateien unterstützt der Abfrage-Generator keine Sortierung nach Aggregatfunktionen, DISTINCT- und SELECT ALL-Anweisungen sowie benutzerdefiniertes SQL.

  • Sortierreihenfolge

    Diese Option wird verfügbar, nachdem die Datenspalten sortiert wurden.

    Sie legt die Priorität fest, mit der die Sortierung auf mehrere Spalten angewendet wird (je kleiner diese Zahl ist, desto höher ist die Priorität).

    Wenn zum Beispiel für Spalte A die Sortierreihenfolge auf 1 und für Spalte B auf 2 eingestellt ist, wird die Abfrage zuerst nach Spalte A und dann nach Spalte B sortiert.

    Wenn Sie diese Einstellung für eine Spalte ändern, wird die Sortierreihenfolge der anderen Spalten automatisch aktualisiert, um einen Prioritätskonflikt zu vermeiden.

  • Gruppiert nach

    Gibt an, ob die Ergebnismenge der Abfrage nach dieser Spalte gruppiert werden soll oder nicht.

  • Aggregieren

    Gibt an, ob die Datensätze der Spalte aggregiert werden sollen oder nicht.

    Die folgenden Aggregatfunktionen werden unterstützt.

    • Count

    • Max

    • Min

    • Avg

    • Sum

    • Count Distinct

    • Avg Distinct

    • Sum Distinct

      Wenn Sie eine dieser Funktionen auf eine Spalte anwenden, werden einzelne Datensätze aus der Ergebnismenge der Abfrage entfernt, die nur das Ergebnis der Aggregatfunktion enthält.

WICHTIG

Sie sollten die Aggregation/Gruppierung entweder auf alle Spalten oder auf keine der Spalten anwenden.

Aktivieren der benutzerdefinierten SQL-Bearbeitung

Wenn die benutzerdefinierte SQL-Bearbeitung von Ihrem Softwareanbieter aktiviert wurde, enthält der Query Builder das Kontrollkästchen SQL-Bearbeitung zulassen. Wenn Sie diese Option aktivieren, werden die visuellen Funktionen des Abfragegenerators deaktiviert und die Benutzer können die benutzerdefinierte SQL-Zeichenfolge manuell eingeben.

Vorschau

Sie können das Ergebnis der Abfrageausführung in Form einer tabellarischen Datenprobe anzeigen, indem Sie auf die Schaltfläche Ergebnisvorschau klicken.

Dadurch wird das Fenster Datenvorschau geöffnet, in dem die Ergebnismenge der Abfrage, begrenzt auf die ersten 1000 Datensätze, angezeigt wird.



CodX Software CodX Software AG
Sinserstrasse 47
6330 Cham
Switzerland
Support
http://support.codx.ch
CxSpickel