The list box for a selected function is defined on this page. It is necessary to specify an Internet page that is called whenever the List control is selected. This Internet page must always be opened in a window of its own as the aim is to convey the impression of a popup dialog.
Fig. 50: List control - General 1 page
z Function: The function for which the list box has been implemented is
selected from this list box. The ProTopas/Web-Extensions concept only allows list boxes to be created for those functions which have been stored in the application. Generally, the selected list item will need to be post-edited or initialized. This can only be done with list boxes that are known in the application.
The content of the list box shown here is read from the Registry under the Transaction key. All keys beneath that are displayed in the drop-down list box. HKEY_LOCAL_MACHINE SOFTWARE Wincor Nixdorf ProTopas CurrentVersion
The List control Controls
ActiveX PCList
Transaction
International remittance order ...
z Fieldname: All input fields which have been created for the function shown
in the Function list box are displayed in this list box. In other words, the actual list box is assigned to the List control here.
The content of the list box shown here is read from the Registry under the Transaction/(function) key. All keys beneath that are displayed in the drop- down list box.
HKEY_LOCAL_MACHINE/SOFTWARE/Wincor Nixdorf/ ProTopas/CurrentVersion/ActiveX/
PCList
Transaction
International remittance order Currency code
...
z Seq. No.: A unique number ranging from 0 to 999 must be assigned to each
List control in order to define the sequence of inputs. This sequence number must fit in the sequence numbers of the Edit controls on the current page. The List control can take on the appearance of an Edit control, and is integrated in the input field sequence control. The Contents (STD/ATM) control ensures that the input focus moves from field to field. An error is written to the error log, if two List controls or one Edit and one List control have the same sequence number.
z Softkey: The name of the softkey next to the screen to which this list box is
going to be assigned is specified in this list box. This applies to systems which do not have a touchscreen but do have softkeys next to the screen. The arrangement of softkeys next to the screen is given in Fig. 22: "Positions of the softkeys". See page 86. It is not possible to configure the numerical EPP Keys 1 - 0 as Softkeys, as it appears in the Button control.
z HTML page: The Internet page to be loaded automatically in its own window
when the list box is selected is specified here. Standard HTML resources, such as a database query, can be used on this page to display a list from which the customer has to make a choice.
Controls The List control
The value that is selected in the popup Internet page has to be entered in the VAR_PCLIST_VALUE_S variable. When the popup browser instance is closed, the value stored in this variable is entered in the input variable named Variable as a Registry parameter:
HKEY_LOCAL_MACHINE/SOFTWARE/Wincor Nixdorf/ ProTopas/CurrentVersion/ActiveX/
PCList
Transaction
International remittance order Currency code
Variable = VAR_CURRENCY_S
In this way the same Internet page can be used for different but similar choices in different functions.
If a different value has to be output in the List control’s output field from the one entered in the variable, the value in question can be assigned to any variable. Generally, the value selected by the customer on the popup Internet page should also be output in the List control’s output field. However, it may be necessary for an unformatted value to be stored in the input variable for further processing later (e.g. displaying the day of the week as Monday, Tuesday etc. and storing the data in input variables 1, 2 etc.). The following syntax must be used in the Output text box of the Output page: [& Name of PC variable ; Formatting of PC variable; Default value of PC variable &]
z Name of PC variable: The name of the variable to be displayed is entered here. Array variables are possible, too. To enter the index, the index must be surrounded by [ ] (example: MyArray[index]).
z Formatting of PC variable: (see "SNI_PC_VARIABLE WebBot" on page 284)
z Default value of PC variable: A default value for the field can be specified here. This default is displayed, if the variable does not exist.
The syntax is similar to the one for variables that are replaced by the HTML generator. The difference is that the identifiers begin with [& instead of [# (see "SNI_PC_VARIABLE WebBot" on page 284).
As soon as the choice page is closed, the List control updates the variable in the output field. This makes sure that the value selected by the customer is available directly in the List control.
The List control Controls
z in a new window check box: This check box is always activated because the
list box should always open the new page in a window of its own.
z Coordinates button: This opens a dialog to specify the coordinates for
Controls The List control