| 1.6.13. Function Search-List: | | List functions tend to have a final digit number as 3 but this is not mandatory and where multiple search lists are provided into the same data object, then any web page reference number may be used, but always treat the search and list as a pair of functions. |
| List Result: | | Each search function places its dynamic results in a list as the contents of a search container. In this context, a list function is not a full web page, but only the result of a search that are placed by AJAX into a container on the web page. This means that list contents may not be directly viewable in a web page source code - press F12 and all the contents can be seen. |
| Containers: | | A list may be assigned to a container by number - typically a long web page may consist of 9 containers. Container numbers enable many forms to be active for real-time field value changes at the same time. From a user point of view, a web page may consist of a vertical collection of web forms to navigate a hierarchy. |
| Web Page Navigation: | | The web page number is shown as 4 digits with a "p" prefix in square brackets. Where key field values are to be passed, an "=" symbol followed by a code such as "c04". "c04" means field values 03 to 04 are provided to the web page where this would normally identify a unique site and client. "c08" means field values 03 to 08 are provided to the web page - this may incorporate a site, client, and assets such as vehicle keys. "c12" means field values 03 to 12 are provided to the web page - this may incorporate a complete hierarchy of data down to a claimants lawyer. | | A link such as "p6543=KEY" will pass the primary key of the selected data - this is normal with list selection. | | A link such as "p6543=NON" will not pass any keys and so all relevant records will be searched. | | Web page numbers in the range 3000 to 8999 are constrained by the current application code. "p3456" in the yachting application is very different to "p3456" in the motor application. |
| | | 4GL List Menu: | | LIST and SELECT declares the list record code and number of rows in the width field. The label declares a semi-colon separated list of field numbers to be used, the title shows the order by field number and the link may optionally add some selection constraint. | | LIST and IF declares a link to a change function when only one row exists in the list. | | MENU and ENDends the list menu. | | MENU and CLICK is a menu option using the Lable, title as popup tooltip and link as the web page number with optional keys to be passed. Any number of CLICK menu options may be declared, but more than eight may be unworkable. | | MENU and RESULT provides a Label to the list paging data. | | MENU and PAGING provides a Link for list paging - normally own web page reference with own key passing. | | MENU and CLOST is a special menu option using the Lable, title as popup tooltip and link as 1888 as the close tile. | | MENU and END ends the list menu. |
| 4GL List Architecture: | | LIST and TOPROW begins the FORM list with the container name in the Label and list selection web page in the link with optional key passing. | | FORM and any edit field value will identify a specific record code and field number with the Label shown as the column heading. Any number of FORM fields may be declared, but the width of a page has physical limits. The field number must be declared in the SELECT line or the field value will not be shown. The Edit field value is not too significant, but numeric fields will be right justified and LIST values will be decoded using the Link field option data. "CHANGED" is a reserved edit to mean a composite of date, time and user name who last changed the record. "CREATED" is a reserved edit to mean a composite of date, time and user name who created the record. | | LIST and ENDROW end the FORM list. | | EXIT and CONTENT ends the list contents. |
|