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 <script> into the Custom Content of the CompanyGrid. The script will need to collect all the name value pairs of the fields used in the form (only where a value had been entered). After these name value pairs have been collected then they can be added to the QueryString of the ASP URL that sits in the hyperlink of the button.