SAP ABAP Data Element AQ_UEHEAD (SAP Query: Header line)
Hierarchy
SAP_BASIS (Software Component) SAP Basis Component
   BC-SRV-QUE (Application Component) SAP Query
     SQUE (Package) Application Development R/3 SAP Query
Basic Data
Data Element AQ_UEHEAD
Short Description SAP Query: Header line  
Data Type
Category of Dictionary Type D   Domain
Type of Object Referenced     No Information
Domain / Name of Reference Type AQS_C255K    
Data Type CHAR   Character String 
Length 255    
Decimal Places 0    
Output Length 255    
Value Table      
Further Characteristics
Search Help: Name    
Search Help: Parameters    
Parameter ID   
Default Component name    
Change document    
No Input History    
Basic direction is set to LTR    
No BIDI Filtering    
Field Label
  Length  Field Label  
Short  
Medium 15 Header 
Long  
Heading  
Documentation

Definition

Every query sub-list (basic list, statistic, ranked list) can have its own page header consisting of header lines.
Header lines contain text that appears at the top of each page. When you scroll the list horizontally, they do not move.

The number of header lines is unrestricted, but the number of page header and page footer lines must be smaller than number of lines per page. When printing or processing in the background, you should note that the number of lines is not determined until processing time and consequently cannot be checked when you define the query. If, in such a case, the number of lines chosen is too small, the query processing is terminated.

To insert or delete a header line, place the cursor on the appropriate line and select Insert line or Delete line in the Edit menu or press the appropriate function keys.

Blank header lines are not displayed. If you do not require any header lines for a list, just leave the header lines blank. With statistics and ranked lists, however, the first header line must not be blank, since it contains the title.

If you want header lines, set up the required number of lines and enter the texts you want to be displayed as the header. You can modify these texts at processing time by inserting the values of any of the query fields into the header.
To insert a field value, you choose the field on the Select Field screen and give it a short name. If the character sequence
&name
is then used in a header line (and name is the short name of the field), this sequence is replace by the field value when the query is processed.
In this way, it is easy to place the current country in the header when sorting data by country.
There are also special variables whose values you can insert in header lines. These include:
- %NAME Name of user executing the query
- N Name of user executing the query
- %DATE Current date when executing the query
- D Current date when executing the query
- %TIME Current time when executing the query
- T Current time when executing the query
- %PAGE Current page number (output 6 characters)
- %P Current page number (output 3 characters)
- P Current page number (output 3 characters)
You may also use these special variables in the headers of statistics and ranked lists.
Please note that, to replace the variable with the appropriate value at runtime, the character & must appear before the variable name even here. If, for example, you want to output the page number in a header line, you can specify the following character sequence:

Page:&%PAGE

As shown above, each special variable has a short form that does not begin with %. Thus, instead of %NAME for the name of the user, you can also use N. However, you should be aware when using short forms that query fields can have a short description that does not match one of these short forms. In this case, the field value from the query is used for replacement.

For information about maintaining column headers and footer lines, place the cursor on a column header (or a line in the line structure area) or on a footer line and use the Help function.

History
Last changed by/on SAP  20010130 
SAP Release Created in