Ansicht
Dokumentation
SIMG_OHAX408 - Set Up Line Layout in Window
rdisp/max_wprun_time - Maximum work process run time Addresses (Business Address Services)This documentation is copyright by SAP AG.
This IMG activity explains how to set up the line layout in the window.
The layout of individual lines in a window can be identical. This means, for example, that a window could contain several lines in which the wage type text and then the wage type amount are displayed as of exactly the same columns. Print specifications such as column length and output length are not made for pieces of data individually, but layouts are defined to determine the structure of the lines within the window. The layouts are assigned to individual wage types using an identifier in the activity "Set up wage types in window".
By setting up line layouts, you can avoid making numerous redundant entries for different infotypes (e.g. wage type amounts, texts, and numbers), columns, the output length, and sometimes for conversions and field offsets as well. Such repetitions can be avoided because layouts can be used over and over, which means that you can assign them to all the wage types that are printed in accordance with one specific schema.
General procedure
A layout is always line-oriented, i.e. it determines the schema according to which a line is printed. One or more entries are required for a layout, depending on whether the layout in question allows only one piece of wage type data (for example, "XRT-BETRG" for the wage type amount, "XRT-BETPE" for the wage type rate, and "T512T-LGTXT" for the wage type text) or more than one to be printed per line. Each entry always refers to a specific piece of wage type data, i.e. the entry determines how the wage type data is printed on each line. This means that it is possible for a layout to consist of one single entry. However, it is more usual that it consists of more than one entry.
The following must be specified for each entry:
- Line type
- Column type
- Offset
- Output length
- Field name
You can also specify the following for each entry:
- Conversion
- Field offset for printout
- Rule for form editing
Those specifications which are not self- explanatory are explained below.
Line type and column type
The combination of line type and column type identifies a layout.
The line type is a two-character numeric value which can be chosen freely (01-99). All entries for one layout must ALWAYS have the same line type.
The column type consists of one character and can be made up as follows:
- "X"
- You must use column type "X" if you want to print data on just one wage type in a line.
- "1", "2", "3", "4", "5", "6", "7", "8", "9"
- You must ALWAYS use numeric values for superlines, i.e. if you want to print information for different wage types in a line.
- Definition:
- By "different" wage types we refer to the following cases:
| a) | Two entirely different wage types are printed. |
| Example: | |
| Wage type /101 | |
| Wage type /106 | |
| b) | Information from different internal payroll tables are |
| printed for the same wage type. | |
| Example: | |
| Wage type /101 from internal payroll table "RT" | |
| Wage type /101 from internal payroll table "CRT" |
- Please note the following with regard to superlines:
- All data for the first wage type or for the wage type from the first table must be stored under column type "1"; all information for the second wage type or for the wage type from the second table must be stored under column type "2"; and so on.
- "T"
- You must use column type "T" for control level start and end texts (see "Control level start and end texts" at the end of this activity).
Please note that every line type can be combined with column type "x", column type "T" and numeric column types ("1", "2" and so on). This means, for example, that you can enter the following line and column types for a particular form:
| Line type | Column type |
|---|---|
| 01 | X |
| 01 | 1 |
| 01 | 2 |
| 01 | 3 |
| 01 | T |
Examples
- Example 1:
- You want to print the monthly value of wage type /101 in a line.
- To do this, you must enter a numeric value (such as "01") as the line type and the value "X" as the column type.
- Example 2:
- You want to print the monthly value of wage type /101 first and then the monthly value of wage type /106 in the same line. In this example, both entries must have the same numeric value (such as "01") as the line type. The column type must have the value "1" for the first wage type (/101) and the value "2" for the second wage type (/106).
Field name
The data is stored in the Field field. The entry in this field can be either a constant, a text module identifier or a table field.
- Constant
- A constant is printed on a remuneration statement in exactly the same way as it is specified in the Field field. Each constant must be preceded by an apostrophe, which identifies it as a constant.
- Example:
- You want to enter "/" in the Field field as a constant (only example in standard form "DF01"). To do this, you must enter the following:
- '/
- NB Every piece of data that can be defined as a constant can also be defined as a text module. You MUST do this if the length of the piece of data exceeds 10 and/or it is required in several languages (see "Set up text modules").
- Text module identifier
- You can specify a text module identifier which you have already set up in the IMG activity "Set up text modules" as a field name (eg. "TEXT01"). There must always be a hyphen between the character string "TEXT" and the corresponding text module number.
- Example:
- You want to specify a text module with the identifier "TEXT05" in the Field field. To do this, please enter the following:
- TEXT-05
- Table field
- You can also specify a table field as a field name. You must ALWAYS specify a table field if the data being set up is variable.
- In the "Allowed tables" overview, all the tables flagged in the column "T512D" contain fields which can be specified in the Field field. The specific table fields which can actually be used are listed under the table names in the "Allowed field names" overview.
- Table fields are specified in the Field field by listing the table in which the field is stored, then a hyphen, and finally the field name itself.
- Example:
- You want to enter the total amount of a wage type. This is stored in field "BETRG" in table "XRT". To do this you must make the following entry in the Field field:
- XRT-BETRG
- Fields from table "SCHLW" are an exception. They must always be entered in the Field field without a hyphen and without the name of the table.
- Example:
- You want to enter the payroll period. This is stored in field "PERIODE" in table "SCHLW". To do this you must make the following entry in the Field field:
- PERIODE
- If you do not know which table contains the piece of information required, you can find out by noting the following:
- Wage type data (including that on cumulation wage types), with the exception of the wage type text, always comes from internal payroll table "XRT".
- The wage type text comes from table "T512T" unless it was stored as a text module.
- Initial and final group texts always come from table "T512G" (see "Initial and final group texts" at the end of this IMG activity).
- Additional data (such as bank code, cost center) may be read from different internal payroll tables (such as "WPBP", "XBT"). The link between a wage type and a table is formed by the split indicator in the payroll results. If a wage type has split indicator "WP" in the payroll results, for example, additional information is read from internal payroll table "WPBP". Please note that additional data from internal payroll tables can only be printed for wage types that have their corresponding split indicator.
- You can determine the required fields of the named tables by following the instructions in "Set up data as fixed layout items" under the heading "Layout of data: Table Field".
Output length and conversion
You can choose the output length of the field name as follows:
- Constant
- For constants, the output length of the field name is the same as the number of characters in the constant. (The apostrophe in front of the constant is not included).
- Example:
- "'/" has been specified as a constant in the Field name field. In this instance, the output length of the field name is "01".
- Text module identifier
- For text module identifiers, the output length of the field name is the same as the number of characters in the text module represented by the identifier.
- Example:
- The text module "total gross amount" is specified by the identifier "TEXT05" in the Field field. In this instance, the output length of the field name is "18".
- Field name
- You can determine the output length of a field name using the overview "Allowed field names". This overview includes the field Output length which contains a default length for every listed field which you can then copy as the output length.
- You can always decide to choose an output length that is shorter or longer than the specified default length. If you choose the former you risk cutting off data at the right hand side. If you choose the latter, you must ensure that the data can be output in full within the predefined field length.
- Conversion
- With regard to field names, it is possible to specify a conversion for the information output.
- The "Allowed field names" overview contains a list of default conversions for certain fields. These conversions are included in the default length of the fields. If you choose a conversion which is not defined as a default, you must include it yourself in the output length of the field.
- Conversions that are allowed for information in windows are flagged in column "T512D" in the "Allowed conversions" overview. You can display explanations on the individual conversions by positioning the cursor on the number of the conversion within this overview and pressing F1 for Help.
Field offset (part of a character string)
In certain instances, you may wish to have the system print a field from a specific character rather than from the very beginning. By making an appropriate entry in the field Field offset for printout, you can specify the character as of which the field is printed.
- Example:
- The Account number field has a default output length of 18 characters. The first three characters always consist of leading zeros which should not be printed. Therefore, you must enter "03" in the field Field offset for printout to ensure that the field is only printed as of the 4th character. You must also replace the 18 with 15 in the Output length field.
Please take careful note of the following when specifying the field offset:
- The field offset always starts with "00". Therefore, offset "01" means that a field is only printed starting from the second character.
- The field offset is directly linked to the output length of the field.
- The field offset and the output length must always be less than or equal to the predefined field length.
- An entry can only be made in the Offset field if the field being dealt with is a character field.
If no entry is made in the field Offset, the default value "00" is set automatically by the system. This means that the field is always printed in full, i.e. as of the first character.
Rule for form editing
If data is printed on a remuneration statement according to certain conditions, you can specify a rule identifier in this field which has already been set in the activity "Set up special processing rules". The rule controls data output.
Examples
A list of the abbreviations used in these examples can be found under the heading "Abbreviations used" at the end of this activity.
Example 1:
You want to set up the following line layout in the window:
- The wage type text is to be printed as of column "000".
- The monthly wage type value is to be printed as of column "043".
To do this you must make the following entries:
| LType | CType | Offs | Length | Field | FOffs | Conv | Rule | |
|---|---|---|---|---|---|---|---|---|
| 01 | X | 000 | 25 | T512T-LGTXT | ||||
| 01 | X | 043 | 16 | XRT-BETRG |
The same line type must always be chosen for all of the entries in a line layout. Line type "01" was chosen in this example. Column type "X" determines that information on just one wage type is printed in this line. A field from table T512T is always specified as a field name for wage type texts. A wage type long text was chosen in this example. The total wage type amount (monthly value) is stored in the field "BETRG" in internal payroll table "XRT". The default length of each field in the overview "Allowed field names" was chosen as the output length.
Example 2:
You want to set up the following line layout in the window:
- The wage type text is to be printed as of column "000".
- The monthly wage type value is to be printed as of column "043".
- The annual wage type value is to be printed as of column "057".
To do this you must make the following entries:
| LType | CType | Offs | Length | Field | FOffs | Conv | Rule |
|---|---|---|---|---|---|---|---|
| 01 | 1 | 000 | 25 | T512T-LGTXT | |||
| 01 | 1 | 043 | 16 | XRT-BETRG | |||
| 01 | 2 | 000 | 25 | T512T-LGTXT | |||
| 01 | 2 | 057 | 16 | XRT-BETRG |
The same line type must always be chosen for all of the entries in a line layout. Line type "01" was chosen in this example. Since this is a superline (in this particular example, wage type information (monthly and annual values) from different internal payroll tables are to be printed in one line), column type "01" must be chosen for all wage type entries from the first table and column type "02" for all wage type entries from the second table. A field from table T512T is always specified as a field name for wage type texts. A wage type long text was chosen in this example. An entry was made under column type "01" and column type "02" to ensure that the wage type text is printed even if only one of the two values, ie. only the monthly value or the annual value, exists for a particular personnel number. The total wage type amount (monthly value and annual value) is stored in the field "BETRG" in internal payroll table "XRT". The default length of each field in the overview "Allowed field names" was chosen as the output length.
Example 3:
You want to set up the following line layout in the window:
- The wage type text is to be printed as of column "000".
- The wage type number is to be printed as of column "027".
- The wage type rate is to be printed as of column "034".
- The total wage type amount is to be printed as of column "043".
The last three pieces of data must all be printed without leading zeros. You must make the following entries:
| LType | CType | Offs | Length | Field | FOffs | Conv | Rule |
|---|---|---|---|---|---|---|---|
| 02 | X | 000 | 25 | T512T-LGTXT | |||
| 02 | X | 027 | 06 | XRT-ANZHL | 10 | ||
| 02 | X | 034 | 08 | XRT-BETPE | 10 | ||
| 02 | X | 043 | 16 | XRT-BETRG | 10 |
The same line type must always be chosen for all of the entries in a line layout. Line type "02" was chosen because line type "01" has already been assigned to the line layouts in examples 1 and 2. Column type "X" determines that information on just one wage type is printed in this line. A field from table T512T is always specified as a field name for wage type texts. A wage type long text was chosen in this example. All remaining wage type information is stored in internal payroll table "XRT". As the output length for the text and the total wage type amount, the default length for these fields was chosen from the overview "Allowed field names". For the wage type number and rate, an output length shorter than the default length was chosen to avoid that different pieces of information may be printed on top of each other due to the chosen offset. By specifying conversion "10", the pieces of information "number", "rate" and "total amount" are printed without leading zeros.
Initial and final group texts
An appropriate layout must be set up for each initial or final group text defined in the IMG activity "Set up initial and final group texts in window". Please note the following:
- A layout for a group heading always consists of just one entry.
- The line type for this entry must be identical to the line type of the first piece of information of the respective group.
- The column type for this entry is always "T" (see line type and column type).
- "T512G-TEXT" must always be chosen as the field name for this entry.
- The default length ("99") can be chosen from the "Allowed field names" overview as the output length for this field name.
- The offset is always "000".
- Example:
- You want to set up a layout for a control level start text. The line type for the first piece of data in the group is "01". You must make the following entries:
| LType | CType | Offs | Length | Field | FOffs | Conv | Rule |
|---|---|---|---|---|---|---|---|
| 01 | T | 000 | 99 | T512G-TEXT |
- The line type for the initial group text must always be the same as the line type for the first piece of data in the group. The fixed values explained above must be entered in the remaining fields.
If you have performed the individual activities for the remuneration statement in the specified sequence, you will not as yet have determined any initial or final group texts. We therefore recommend that you execute the instructions in one of the following activities to set up the layout of initial and final group texts:
- You must first perform the activities
- "Set up wage types in window" and "Set up control level start and end texts in window" and then return to this activity to determine the layout for the initial and final group texts used.
- This is the preferred procedure if you only need initial and final group texts for a few groups in the window or if you do not as yet have any experience of using initial and final group texts in a window.
- You set up one initial and final group texts for every line type used.
- This is the best procedure to use if you need initial and final group texts for a large number of groups in the window.
Note
If you discover, when performing the activity "Set up wage types in window", that a particular line layout which you need to assign to a wage type has not been defined, you can return at any time to the IMG activity "Set up line layout in window" and then set up the line layout required.
Abbreviations used
The following abbreviations were used in the above examples:
| LType | Line type |
| CType | Column type |
| Offs | Offset |
| Length | Output length |
| Field | Field name |
| FOffs | Field offset for printout |
| Conv | Conversion |
| Rule | Rule for form editing |
Activities
Set up the line layout in the window.
General Material Data RFUMSV00 - Advance Return for Tax on Sales/Purchases
This documentation is copyright by SAP AG.
Length: 29506 Date: 20240523 Time: 205937 sap01-206 ( 398 ms )
