Detail screen configuration

Selection screens (SELECT), input screens (INPUT) and the header section of list screens (LIST_HEADER) all reference the same definition for their screen controls. They will all be setup in configuration with the data type ‘D - Detail Screen Config’.

This ensures that that the following screen is available in app master data to allow the field definition and all the options setup:

Note

While the header section of LIST screens (LIST_HEADER) share the same definition as SELECT and INPUT screens, certain options are not relevant and these will be identified below for each app master data option.

Each column on the ‘Details Screen Configuration’ is represented by the options below:

Option	Usage	Comments
Application	Linking field to an SAP application code for barcode processing.	This field can be maintained with a ‘TCTM: Bar Code Type AI Application’ that will allow the app to determine which information should be read from a barcode and populated into the field on screen. See the ‘Base Framework – Configuration Setup’ to see how to set up the barcode configuration.
Class	Code that is used to prepare the data in the fields before display.	Can be used to implement custom code to control the value displayed in the field and is needed if a ‘FILTER’ option is being assigned to this field.
Conversion Exit	Converts the data in the field for display.	Controls how the field is displayed, e.g., setting as ALPHA will remove leading zeroes from a number. Note: you can develop your own conversion exits and assign here in the app master data. See ‘Conversion Exits’ section for more detail on available conversion exits. For a LIST_HEADER, the conversion exit should be left blank if the item is also defined in the LIST section, as the value (including conversion exit) will be taken from the LIST items and summarised in the header section. Adding a conversion exit in the header can result in a value being set that does not reflect the summarised values.
Drop Down blank		For fields with an Input Type maintained with ‘DRP’ (drop-down list), this configuration option (set to Toggle ON) provides a blank entry at the top of the list, which can be selected, rather than forcing selection of one of the values from the list. If the value is left blank, the selection field will not be used to affect the results. This option is not relevant for display only fields, so should always be left blank where an Input Type hasn’t been maintained.
Exact	Deactivates Input Help functionality and wildcard searches.	For those fields defined as being compatible with ‘Input Help’ screens, or fields that have been defined as ‘wildcard’ relevant in individual apps, this option will deactivate ‘Input Help’ functionality and wildcard searches and always expect the value entered to be an exact match with SAP table data. This option is not relevant for display only fields, so should always be left blank where an Input Type hasn’t been maintained.
Field	Field name of component from the available structure(s) related to the app/screen.	These structures are listed in the specific configuration guide for each app. Entries must not contain spaces and should be a single string, e.g., ST_TYPE. See Determine Available Fields/Components for more details. Using the F4 lookup one can see the list and select from all the possible structures and fields available as standard. The F4 lookup will only work if there is data in table /TCTM/WM_DU. Table will be populated in a system if someone has run through the transaction screens with their PID for /TCTM/WM_SAVE_DU switched on ("X").
Hint	Hint text that is displayed inside the field before anything is entered.	Allows hint text to be added to the field to give users an understanding of what needs to be entered into the field, e.g. Enter Material as shown in the field below: If left blank, the field will remain empty, except for fields with input type DAT or DTR. For date fields, the required date format will display, showing how the date should be entered: This option is not relevant for display only fields, so should always be left blank where an Input Type has not been maintained.
Initial Focus	Sets the cursor position on the screen.	This field can be set to blank, A or B. If set to blank, the focus will not be set on the field. If set to ‘A’ the focus will be set on the field and the device keypad launched. If set to ‘B’, the focus will be set in the field but the device keypad will not be launched. This can be useful for fields where it is expected a user will only scan data into the field. Note: this should only be set against one field per input screen. If multiple entries are found, the screen will place the cursor in the first entry found with focus activated and the other fields with a value are ignored, that is there is no subsequent focus. The permitted values will vary by ‘Input Type’. The following values are supported: · CHA – A or B · NUM – A or B · CMB – A only on a mobile device, A or B on desktop · CBM – A only on a mobile device, A or B on desktop Note: When using a mobile device and where the focus is set on a field with a drop-down (DRP, CMB or CBM), the user will only see the drop-down list and not the full screen that the drop-down relates to. See the screenshot below: To avoid this, an input field without a drop-down should have the focus set. This does not occur when a desktop is used to run PreBilt.
Initial Value	This is the default value that will be set for the field on the screen.	This can be either: · Fixed value, which needs to be entered in double quotes, i.e., “ ”. “BLANK” can be used where the initial value is a null value and “ “ doesn’t work. · Reference to a user Parameter ID (PID) in the format PID:xxx (where xxx is the parameter ID. For example, an entry of PID:WRK would display the value the user had defined for WRK – Plant. · Field from an object structure that is available in the app (see the specific Configuration Guide for each app), e.g. PO Item, storage location, etc. · Also fields in the ‘SY’ SAP structure can be used with the format SY:xxx where xxx is the field name. When an input type of ‘DTR’ is maintained, the fixed value can be entered as two numbers with a comma separating the values and no quotes before or after, to reflect that two input values are needed. For example, -2,5 would populate a value of today minus two days in the ‘From’ field, and a value of today plus 5 days in the ‘To’ field. This option is not relevant for display only fields, so should always be left blank where an Input Type has not been maintained.
Input Type	The input type for the field.	Valid entries for the input type are: · CHA – Character / Alphanumeric · CHK – Check Box · CMB – Combi (Drop down with input match option) · CBM – Combi Multi (Drop down with input match and multi select option) · DAT – Date / Calendar selection · DEC – Numeric (allows decimals to be entered) · DRP – Drop Down · DTR – Date Range · NUM – Numeric (whole numbers only) · SPA – Spacer · TXT,# – Text Fields with displayed rows, # denotes the number of rows deep ie size of the text box · <blank> - makes the field display only. Note: The input type for the field can be different from standard SAP. For example, a material field can be made numeric for customers who only have numeric materials. This will then control the keyboard type that is presented to the user. If an input type of CHA (Character) is entered against a field that can also be set up as a CBM (Combi Multi) field, multiple options can be entered by separating the entries with a comma. For example; to select multiple storage types in a CHA input field the user would enter HR1, MN1. When using commas for multiple entries, all entries must be an exact match, i.e. wildcards and input help functionality will not be available. If an input type of SPA (Spacer) is entered, this will add a line separating information within the screen, for example between header and input fields. If an input type of DTR (Date Range) is entered, this will display a ‘From’ and ‘To’ date field on the screen, rather than a single field that will be displayed with input type DAT. This option is not relevant for display only fields, so should always be left blank where an Input Type has not been maintained. If an input type of TXT (Text field) is entered, this will display all fields defined in an associated source list defined in the Source List option as a single text box. The size of the text field can also be configured by selecting the subsequent numeric value. TXT,6 displays a text field 6 rows tall.
Label	Field label description that will be displayed.	This label can be set as one of the following: · Standard data dictionary value, e.g. DDIC-LGNUM-S, where the middle component relates to the required field data option (accessed either via the F1 ‘Technical Information’ for a known field in the SAP GUI, or directly from a table in SE11/SE12) and the last character can be S, M or L (for short, medium or long label). Using the DDIC option means that if a user has maintained a language in their user profile, the SAP translation for that field will automatically be displayed to the user when using the app. · Text objects created under the Text Override section in configuration (transaction /TCTM/WM_CFG) for each transaction, e.g. TEXT-SCAN. This allows the value of the text to be maintained in one place, while also allowing translations to multiple languages. See section ‘Text Elements’ in the Base Framework – Configuration Setup for more detail. · Static text, e.g. the text required as the label can be typed and it will not change based on the language of the user. · Left blank, in which case no label will be displayed. Using the F4 lookup one can see the list and select either DDIC entries or text override entries defined in WM_CFG, by selecting the appropriate tab in the search popup and then selecting the DDIC item or text ID as appropriate. Using F1 will display the text description behind the DDIC or Text ID in the field.
Label Colour	Colour of text used for the Label.	Colours can be set using the hex format, e.g. #FF0000 is red.
Label Size	Size of text used for the Label.	This can be left blank, or set using typical CSS options such as pixels, e.g., 14px.
Label Style	Style of text used for the Label.	This can be left blank for default or set to: · 1 = bold · 2 = italics · 3 = bold italics
Length	Length of the field that appears on the screen.	Note: This will not restrict the number of characters that can be entered for the field object, which will be determined based on SAP field length. Any appropriate CSS unit of measure (both relative and absolute) can be used when entering a length value. For example 100px would fix the field space to 100 pixels wide, whereas 50% would fix the field space to half the width of the screen (whatever that may be). For more information on CSS units refer to the below link: https://www.w3schools.com/cssref/css_units.asp Note: If left blank, the app will fit to the width of the screen, or proportion if multiple fields are on one line.
Line	The line or row number of the screen that the field should be displayed on.	Gaps in the numbering are ignored and the lines are continued one after the other in sequence.
Position	Position on the line or row that the field should be displayed in.	Gaps in the numbering are ignored and the fields are displayed horizontally one after the other in sequence.
Read Only	Sets the field to ‘display only’ even if there is an ‘Input Type’.	This option can be set to enable input fields to be read only so the user cannot change the data in the field. It is expected that this configuration option is only flagged if an entry has been made in the ‘Initial Value Source’ column, with that value then being passed back to SAP as part of the validation / posting routine. This option will be overridden if ‘Visibility’ is set to ‘B’, as the field will be hidden from the screen. This option is not relevant for display only fields, so should always be left blank where an Input Type has not been maintained.
Required	Identifies that a field is mandatory.	This is usually denoted with an ‘X’, however a different character can be added to show this field is grouped with other fields having the same character. For example, if material and batch are both maintained with an ‘A’, at least one of the fields (but not necessarily both) must be entered. If material and batch are both maintained with an ‘A’ and plant with a ‘B’, then at least one of the material or batch fields (but not necessarily both) must be entered and plant must also be entered. This option is not relevant for display only fields, so should always be left blank where an Input Type has not been maintained.
Source List	Allows you to limit a selection or display a list of values.	Enter the reference to either a LIST or FILTER configuration option where the permitted values have been defined for the input fields, or what is displayed in the drop-down list. This allows values to be restricted to only those that are relevant (e.g. excluding interim storage types) or lists that would be otherwise too large based on standard SAP table entries (e.g. printers only relevant for the warehouse). This option is not relevant for display only fields, so should always be left blank where an Input Type hasn’t been maintained. When Input Type TXT is maintained, this option should be used to define the fields to be displayed in the field eg address fields. Using the F4 lookup one can see the available LIST and FILTER objects defined for the app transaction.
Value Colour	Colour of text used for the data in the field.	Colours can be set using the hex format, e.g. #FF0000 is red.
Value Size	Size of text used for the data in the field.	This can be left blank or set using typical CSS options such as in pixels, e.g., 14px.
Value Style	Style of text that is displayed in the field.	This can be left blank for default or set to: · 1 = bold, · 2 = italics, · 3 = bold italics.
Visibility	Sets whether a field is visible.	This field can be set to blank, A or B. · If set to blank, the field will only be displayed if there is relevant data for the field (e.g. if batch is configured, it will only be visible for batch managed materials). · If set to ‘A’, the field will always be displayed, even if the field is not determined as relevant (e.g. the batch field will always be displayed, even if the material is not batch managed). · If set to ‘B’, the field will be hidden from the screen. It is expected that ‘B’ will be used if an entry has been made in the ‘Initial Value’ field, with that value then being passed back to SAP as part of the validation / posting routine, but without the user seeing the information on the screen or if the field is not relevant to the transaction.