Basic Instance List Processing

Basic Instance List Processing

In the Framework, filters create lists of business objects such as customers, orders, etc. When the user clicks on a business object instance displayed in the instance list, a set of command handler tabs typically appear, indicating various details about the business object and various actions that users can take on it. For example: 

Programmatically this model is quite simple:

Typically a "Search" button in a filter works like this:

* Indicate start of list update and set the Framework to busy

Invoke Method(#avListManager.BeginListUpdate)

* Clear the list first

Invoke Method(#avListManager.ClearList)

* Select the business object(s) that match the search criteria, often from rows

* in a database table and then add them to the instance list

Select Fields() From_File() With_Key() Where()

     Invoke Method(#avListManager.AddtoList) .....

EndSelect

* Indicate the end of list update

Invoke Method(#avListManager.EndListUpdate)

Structurally, this logic reflects how most filters and instance lists work together.