Version 4.2.6
 —  Leitfaden zur Programmierung  —

Spaltenüberschriften

Dieses Dokument beschreibt verschiedene Möglichkeiten, wie Sie die Anzeige der von einem DISPLAY-Statement erzeugten Spaltenüberschriften beeinflussen können.

Folgende Themen werden behandelt:


Standard-Spaltenüberschriften

Standardmäßig wird jedes mit einem DISPLAY-Statement ausgegebene Datenbankfeld mit einer (für das Feld im DDM definierten) Standard-Spaltenüberschrift ausgegeben.

** Example 'DISPLX01': DISPLAY
************************************************************************
DEFINE DATA LOCAL
1 VIEWEMP VIEW OF EMPLOYEES
  2 PERSONNEL-ID
  2 NAME
  2 BIRTH
  2 JOB-TITLE
END-DEFINE
*
READ (3) VIEWEMP BY BIRTH
  DISPLAY PERSONNEL-ID NAME JOB-TITLE
END-READ
END

Ausgabe des Programms DISPLX01:

Das obige Beispielprogramm verwendet Standard-Spaltenüberschriften und erzeugt folgende Ausgabe:

Page      1                                                  04-11-11  14:15:54
 
PERSONNEL         NAME                  CURRENT
   ID                                  POSITION
--------- -------------------- -------------------------
 
30020013  GARRET               TYPIST
30016112  TAILOR               WAREHOUSEMAN
20017600  PIETSCH              SECRETARY

Seitenanfang

Standard-Spaltenüberschriften unterdrücken — die NOHDR-Option

Wünschen Sie in Ihrem Report keine Spaltenüberschriften, geben Sie im DISPLAY-Statement das Schlüsselwort NOHDR an, zum Beispiel:

DISPLAY NOHDR PERSONNEL-ID NAME JOB-TITLE

Seitenanfang

Eigene Spaltenüberschriften definieren

Wenn Sie statt der Standard-Spaltenüberschriften eigene Spaltenüberschriften ausgeben möchten, geben Sie unmittelbar vor dem jeweiligen Feld einen Text in Apostrophen (') an, wobei 'text' die für das Feld zu verwendende Spaltenüberschrift ist.

** Example 'DISPLX08': DISPLAY  (with column title in 'text')
************************************************************************
DEFINE DATA LOCAL
1 VIEWEMP VIEW OF EMPLOYEES
  2 PERSONNEL-ID
  2 NAME
  2 BIRTH
  2 JOB-TITLE
END-DEFINE
*
READ (3) VIEWEMP BY BIRTH
  DISPLAY PERSONNEL-ID
         'EMPLOYEE' NAME
         'POSITION' JOB-TITLE
END-READ
END

Ausgabe des Programms DISPLX08:

Das obige Programm enthält für das Feld NAME die Spaltenüberschrift EMPLOYEE und für das Feld JOB-TITLE die Spaltenüberschrift POSITION; für das Feld PERSONNEL-ID wird die Standard-Spaltenüberschrift verwendet. Das Programm erzeugt folgende Ausgabe:

Page      1                                                  04-11-11  14:15:54
 
PERSONNEL       EMPLOYEE               POSITION
   ID
--------- -------------------- -------------------------
 
30020013  GARRET               TYPIST
30016112  TAILOR               WAREHOUSEMAN
20017600  PIETSCH              SECRETARY

Seitenanfang

NOTITLE und NOHDR kombinieren

Zur Ausgabe eines Reports ohne Kopfzeilen und Spaltenüberschriften geben Sie die Optionen NOTITLE und NOHDR gleichzeitig an, und zwar in der folgenden Reihenfolge:

DISPLAY NOTITLE NOHDR PERSONNEL-ID NAME JOB-TITLE

Seitenanfang

Spaltenüberschriften zentrieren — der HC-Parameter

Standardmäßig werden Spaltenüberschriften zentriert über den Spalten ausgegeben. Mit dem Session-Parameter HC (Header Centering) können Sie die Ausrichtung der Spaltenüberschriften beeinflussen:

HC=L Spaltenüberschriften werden linksbündig ausgerichtet.
HC=R Spaltenüberschriften werden rechtsbündig ausgerichtet.
HC=C Spaltenüberschriften werden zentriert. Dies ist die Standardeinstellung.

Sie können den HC-Parameter in einem FORMAT-Statement angeben; er gilt dann für den gesamten Report. Sie können ihn auch in einem DISPLAY-Statement angeben, und zwar sowohl auf Statement- wie auf Elementebene.

Beispiel für die Angabe des HC-Parameters auf Statement-Ebene, d.h. für die linksbündige Ausrichtung aller Spaltenüberschriften:

DISPLAY (HC=L) PERSONNEL-ID NAME JOB-TITLE

Seitenanfang

Breite von Spaltenüberschriften — der HW-Parameter

Mit dem Session-Parameter HW (Header Width) bestimmen Sie die Breite einer von einem DISPLAY-Statement erzeugten Spalte.

HW=ON Die Breite einer DISPLAY-Spalte wird entweder durch die Länge des Feldes oder durch die Länge der Spaltenüberschrift bestimmt, je nachdem was länger ist. Dies ist die Standardeinstellung.
HW=OFF Wenn Sie HW=OFF angeben, wird die Breite einer DISPLAY-Spalte allein durch die Länge des Feldes bestimmt.

Bitte beachten Sie, dass HW=OFF nur bei DISPLAY-Statements, die keine Spaltenüberschriften erzeugen, wirkt; d.h. bei einem ersten DISPLAY-Statement mit NOHDR-Option, oder bei einem nachfolgenden DISPLAY-Statement.

Sie können den HW-Parameter in einem FORMAT-Statement verwenden; er gilt dann für den gesamten Report. Sie können ihn auch in einem DISPLAY-Statement angeben, und zwar sowohl auf Statement- wie auf Elementebene.

Seitenanfang

Füllzeichen für Überschriften — die Parameter FC und GC

Mit dem Session-Parameter FC (Filler Character) bestimmen Sie das Füllzeichen, das auf beiden Seiten der von einem DISPLAY-Statement erzeugten Überschrift über die gesamte Breite der Spalte erscheint. Voraussetzung ist, dass die Spaltenbreite durch die Feldlänge und nicht durch die Überschrift bestimmt wird (vgl. HW-Parameter und Beschreibung oben), sonst hat der FC-Parameter keine Wirkung.

Wenn eine Feldgruppe oder eine Periodengruppe mit einem DISPLAY-Statement ausgegeben wird, wird eine Gruppenüberschrift über den Überschriften der einzelnen Felder der Gruppe ausgegeben. Mit dem Session-Parameter GC (Group Filler Character) bestimmen Sie das Füllzeichen, das auf beiden Seiten der Gruppenüberschrift erscheinen soll.

Während der FC-Parameter für Überschriften einzelner Felder gilt, bezieht sich der GC-Parameter auf Überschriften für Feldgruppen.

Sie können die Parameter FC und GC in einem FORMAT-Statement verwenden; sie gelten dann für den gesamten Report. Sie können sie auch in einem DISPLAY-Statement angeben, und zwar sowohl auf Statement- wie auf Elementebene.

** Example 'FORMAX01': FORMAT (with parameters FC, GC)
************************************************************************
DEFINE DATA LOCAL
1 VIEWEMP VIEW OF EMPLOYEES
  2 NAME
  2 INCOME (1:1)
    3 CURR-CODE
    3 SALARY
    3 BONUS (1:1)
END-DEFINE
*
FORMAT FC=* GC=$
*
READ (3) VIEWEMP BY NAME
  DISPLAY NAME (FC==) INCOME (1)
END-READ
END

Ausgabe des Programms FORMAX01:

Page      1                                                  04-11-11  14:15:54
                                                                               
========NAME======== $$$$$$$$$$$$INCOME$$$$$$$$$$$$                            
                                                                               
                     CURRENCY **ANNUAL** **BONUS***                            
                         CODE     SALARY                                       
-------------------- -------- ---------- ----------                            
                                                                               
ABELLAN              PTA         1450000          0                            
ACHIESON             UKL           10500          0                            
ADAM                 FRA          159980      23000

Seitenanfang

Unterstreichungszeichen für Überschriften — der UC-Parameter

Standardmäßig werden Kopfzeilen und Überschriften mit einem Bindestrich (-) unterstrichen.

Mit dem Session-Parameter UC (Underlining Character) können Sie ein anderes Zeichen bestimmen, das als Unterstreichungszeichen verwendet werden soll.

Sie können den UC-Parameter in einem FORMAT-Statement verwenden; er gilt dann für den gesamten Report. Sie können ihn auch in einem DISPLAY-Statement angeben, und zwar sowohl auf Statement- wie auf Elementebene.

** Example 'FORMAX02': FORMAT (with parameter UC)
************************************************************************
DEFINE DATA LOCAL
1 VIEWEMP VIEW OF EMPLOYEES
  2 PERSONNEL-ID
  2 NAME
  2 BIRTH
  2 JOB-TITLE
END-DEFINE
*
FORMAT UC==
*
WRITE TITLE LEFT JUSTIFIED UNDERLINED 'EMPLOYEES REPORT' 
SKIP 1 
READ (3) VIEWEMP BY BIRTH
  DISPLAY PERSONNEL-ID (UC=*) NAME JOB-TITLE
END-READ
END

Im obigen Programm ist der UC-Parameter auf Programmebene und auf Feldebene gesetzt: das im FORMAT-Statement angegebene Unterstreichungszeichen (=) gilt für den ganzen Report außer für das Feld PERSONNEL-ID, für das ein anderes Unterstreichungszeichen (*) angegeben ist.

Ausgabe des Programms FORMAX02:

EMPLOYEES REPORT 
===============================================================================
 
PERSONNEL         NAME                  CURRENT
   ID                                  POSITION
********* ==================== =========================

30020013  GARRET               TYPIST
30016112  TAILOR               WAREHOUSEMAN
20017600  PIETSCH              SECRETARY

Seitenanfang

Spaltenüberschriften unterdrücken — die Schrägstrich-Notation (’/’)

Mit der Notation Apostroph-Schrägstrich-Apostroph ('/') können Sie die Ausgabe von Standard-Spaltenüberschriften für einzelne Felder in einem DISPLAY-Statement unterdrücken.

Im Gegensatz zur NOHDR-Option, mit der Sie die Ausgabe von Standard-Spaltenüberschriften für alle Spalten unterdrücken können, können Sie mit der '/'-Notation die Überschrift für eine einzelne Spalte unterdrücken.

Dazu geben Sie die Notation '/' in einem DISPLAY-Statement jeweils unmittelbar vor dem Namen des Feldes an, dessen Spaltenüberschrift unterdrückt werden soll.

Zwei Beispiele zum Vergleich:

Beispiel 1:

DISPLAY NAME PERSONNEL-ID JOB-TITLE

In diesem Beispiel werden die Standardüberschriften aller drei Spalten ausgegeben:

Page      1                                                  04-11-11  14:15:54
                                                                               
        NAME         PERSONNEL          CURRENT                                
                          ID             POSITION                          
-------------------- --------- -------------------------                 
                                                                               
ABELLAN              60008339  MAQUINISTA               
ACHIESON             30000231  DATA BASE ADMINISTRATOR                   
ADAM                 50005800  CHEF DE SERVICE                           
ADKINSON             20008800  PROGRAMMER                                
ADKINSON             20009800  DBA                                       
ADKINSON             20011000  SALES PERSON          

Beispiel 2:

DISPLAY '/' NAME PERSONNEL-ID JOB-TITLE

In diesem Beispiel wird mit der Notation '/' die Spaltenüberschrift für das Feld NAME unterdrückt:

Page      1                                                  04-11-11  14:15:54
                                                                               
                     PERSONNEL          CURRENT                          
                        ID             POSITION                          
                     --------- -------------------------                 
                                                                               
ABELLAN              60008339  MAQUINISTA                                
ACHIESON             30000231  DATA BASE ADMINISTRATOR                   
ADAM                 50005800  CHEF DE SERVICE                           
ADKINSON             20008800  PROGRAMMER                                
ADKINSON             20009800  DBA                                       
ADKINSON             20011000  SALES PERSON     

Seitenanfang

Weitere Beispiele für Spaltenüberschriften

Siehe die folgenden Beispiel-Programme:

Seitenanfang