4D Doc Center : QR REPORT

Home

4D v14.3

QR REPORT


QR REPORT ( {Tabellenname ;} Dokumentname {; Hierarchisch {; Assistent {; Suchen {; Methodenname {; *}}}} )

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Zu druckende Tabelle, ohne Angabe Standardtabelle
Dokumentname	String	Zu ladendes Dokument Schnellbericht
Hierarchisch	Boolean	Wahr = Zeigt N verknüpfte Tabellen Falsch/ohne Angabe = Nicht anzeigen (Standard)
Assistent	Boolean	Wahr = Zeigt Schaltfläche Assistent an Falsch/ohne Angabe = Nicht anzeigen (Standard)
Suchen	Boolean	Wahr = Zeigt Suchwerkzeuge und Haupttabelle Falsch/ohne Angabe = Nicht anzeigen (Standard)
Methodenname	String	Name der aufzurufende Methode
*	Operator	Druckdialoge löschen

Beschreibung

QR REPORT druckt einen Bericht für Tabellenname, erstellt mit dem hier gezeigten Berichteditor.

Mit dem Berichteditor können Benutzer ihre eigenen Berichte erstellen. Weitere Informationen dazu finden Sie im Handbuch 4D Designmodus.

Hinweise:

Der Editor erscheint nicht, wenn Tabellenname als “Ausgeblendet” definiert ist.
Wird der Editor über den Befehl QR REPORT aufgerufen, wird die Option Alle Verknüpfungen auf automatisch zum Ändern des Status automatisch/manuell der Verknüpfungen ausgeblendet. So kann der Entwickler den Status über die Befehle SET AUTOMATIC RELATIONS und SET FIELD RELATION selbst steuern.
Der Editor wird in einem externen Fenster aufgerufen. In diesem Kontext kann der Befehl QR ON COMMAND nicht verwendet werden.

Dokumentname (String) ist ein mit dem Schnellberichteditor erstellter und gesicherter Bericht. Dabei werden die Formatierungen des Berichts gesichert, nicht die darin enthaltenen Datensätze.

Ist Dokumentname leer (""), öffnet QR REPORT das Standardfenster für die Dokumentenauswahl. Sie können nun das gewünschte Dokument zum Drucken auswählen.
Ist Dokumentname der Name eines bestehenden Dokumentes, lädt QR REPORT die Formatierung des Berichtes und druckt sie mit den Druckparametern aus, die bei der Definition des Berichtes angelegt wurden.

Gibt Dokumentname ein Dokument an, das nicht vorhanden ist, z.B. Char(1), wird der Berichteditor geöffnet.

Hierarchisch (Boolean) definiert, ob in der Auswahlliste für Felder N-Tabellen angezeigt werden. Der Parameter hat standardmäßig den Wert 0 (Null), d.h. es werden keine verknüpften Tabellen angezeigt.

Assistent (Boolean) gibt an, ob die Schaltfläche Öffne Assistent im Schnellberichteditor angezeigt wird. Der Parameter hat standardmäßig den Wert 0 (Null), d.h. der Assistent ist nicht verfügbar.

Suchen (Boolean) gibt an, ob die Schaltfläche Neue Suche und die DropDown-Liste Haupttabelle im Schnellberichteditor angezeigt werden, um die aktuellen Tabellen bzw. die aktuelle Haupttabelle zu verändern. Der Parameter hat standardmäßig den Wert 0 (Null), d.h. es ist kein Zugriff auf die Suchwerkzeuge und die Haupttabelle möglich.

Der Parameter Methodenname gibt eine 4D Projektmethode an, die ausgeführt wird, wenn ein Befehl des Schnellberichteditors durch Auswählen eines Menübefehls oder Anklicken einer Schaltfläche aufgerufen wird.
Dieser Parameter ist die Entsprechung zum Befehl QR ON COMMAND im Rahmen des Dialogfensters Schnellberichteditor (QR ON COMMAND funktioniert nur für eingebundene Bereiche). Der neue Parameter eignet sich besonders, um den vom Schnellbericht verwendeten Zeichensatz zu ändern.
Die Methode MethodenName empfängt zwei Parameter:

$1 enthält die Referenz des Bereichs (Lange Ganzzahl)
$2 enthält die Nummer des ausgewählten Befehls (Lange Ganzzahl). Sie können diesen Wert mit den Konstanten unter dem Thema QR Befehle vergleichen.

Hinweis: Wenn Sie Ihre Anwendung kompilieren, müssen Sie die Parameter $1 und $2 explizit als Lange Ganzzahl deklarieren, auch wenn Sie diese nicht benutzen.

Wollen Sie den anfangs vom Benutzer gewählten Befehl ausführen, verwenden Sie für die Methode MethodenName folgende Anweisung:

QR EXECUTE COMMAND($1;$2)

Ist der Parameter MethodenName ein leerer String ("") oder wird er weggelassen, wird keine Methode aufgerufen und die Standardoperation von QR REPORT angewandt.

Ist ein Bericht ausgewählt, erscheinen die Dialogfenster zum Drucken. Mit dem Parameter * unterdrücken Sie die Druckdialoge. 4D benutzt dann die Druckeinstellungen, die bei der Erstellung des Berichts angegeben wurden.

Ist der Schnellberichteditor nicht beteiligt, hat die Variable OK den Wert 1, wenn ein Bericht gedruckt wird; den Wert 0 (Null), wenn nicht gedruckt wird (der Benutzer hat z.B. im Druckdialog auf die Schaltfläche Abbrechen geklickt).

4D Server: Dieser Befehl lässt sich auf 4D Server im Rahmen einer Serverprozedur ausführen. In diesem Kontext müssen Sie folgendes beachten:

Stellen Sie sicher, dass auf dem Server Rechner kein Dialogfenster erscheint, außer für spezifische Anforderungen. Dazu müssen Sie den Befehl mit dem Parameter * oder > aufrufen.
Die Syntax zum Aufrufen des Berichteditors funktioniert nicht mit 4D Server. In diesem Fall wird die Systemvariable OK auf 0 (Null) gesetzt.
Bei einem Druckerproblem, z.B. kein Papier oder Drucker nicht verfügbar, erscheint keine Fehlermeldung.

Beispiel 1

Folgendes Beispiel lässt den Benutzer die Tabelle [People] suchen und druckt dann automatisch den Bericht “Detailliste”:

 QUERY([People])

 If(OK=1)

    QR REPORT([People];"Detailliste";*)

 End if

Beispiel 2

Folgendes Beispiel lässt den Benutzer die Tabelle [People] suchen und dann den Bericht für den Druck auswählen:

 QUERY([People])

 If(OK=1)

    QR REPORT([People];"")

 End if

Beispiel 3

Folgendes Beispiel lässt den Benutzer die Tabelle [People] suchen und zeigt dann den Berichteditor an, so dass der Benutzer – mit oder ohne Assistenten – einen beliebigen Bericht erstellen, sichern, laden und drucken kann:

 QUERY([People])

 If(OK=1)

    QR REPORT([People];Char(1);True)

 End if

Beispiel 4

Siehe Beispiel zum Befehl SET FIELD RELATION.

Beispiel 5

Sie wollen den Zeichensatz in einem Schnellbericht, der über QR REPORT aufgerufen wird, in Mac Roman ändern:

QR REPORT([MyTable];Char(1);False;False;False;"myCallbackMeth")

Die Methode myCallbackMeth konvertiert den Bericht, wenn er erzeugt wird:

 C_LONGINT($1;$2)

 If($2=qr cmd generate) //wurde ein Bericht generiert

    C_BLOB($myblob)

    C_TEXT($path;$text)

    QR EXECUTE COMMAND($1;$2) //den Befehl ausführen

    QR GET DESTINATION($1;$type;$path) //Ziel finden

    DOCUMENT TO BLOB($path;$myblob)

  //Mit UTF-8 in Text konvertieren

    $text:=Convert to text($myblob;"UTF-8")

    /Zeichensatz MacRoman verwenden

    CONVERT FROM TEXT($text;"MacRoman";$myblob)

  //Zum konvertierten Bericht zurückgehen

    BLOB TO DOCUMENT($path;$myblob)

 Else/andernfalls den Befehl ausführen

    QR EXECUTE COMMAND($1;$2)

 End if