Adding Custom Actions to Find Screens

1 minute read time.
There is a previous article, "Action buttons on Custom Entity Find Screens"

This post explained how to recreate a find screen but I am now going to consider adding a new Action button to an existing system find screen. (See below)


For example you may have a requirement to add a new call to an ASP page to the actions buttons on the existing company find screen. You may want to have the new button call a particular action against each company on the list from the find results.

To do this we face several challenges.

1) We need to add the button to find screen actions
2) Have button call ASP page that will know what query parameters were used and therefore which records to carry out the action.

The first is not too difficult

Navigate to Administration -> Advanced Customisation -> System Menus

There is a TabGroup called SavedSearchButtons, add a Tab to this that calls your ASP page.

This will add a URL that looks like:

http://servername/installname/CustomPages/test.asp?SID=71153951769591 &F= &J=customaction.asp &Key0=19 &Key25=128

The second challenge is to pass the parameters used in the search so that the ASP page can carry out the task you need it to.

The default Company Find screen is made up from the CompanySearchBox and the CompanyGrid. The CompanyGrid in the default system will only display when a search has been carried out and therefore only when it is shown will the values in the CompanySearchBox used in the search be available and so can be collected.

We can now add a