Button Event Page
In the properties for a control, the Button Event page appears only for a button control. The buttons that you place on forms can run user calculations, open files, navigate to URLs, or run executable or batch files. The following table describes the properties that can appear for a button control.
Property
Description
Run a user calculation
Indicates whether the button is to run user-defined calculation.
When this option is selected, Calculate specifies the records that you want to include in the calculations. Choices are:
All records. When selected, clicking the button runs the selected user-defined calculations for all records. All user-defined calculations are available for selection in the subsequent table. After results are calculated, results for all records are refreshed.
Only the selected record. When selected (default), clicking the button runs the selected user-defined calculations for the active record on the form. Only user-defined calculations that apply to the table type for the form are available for selection in the subsequent table. After results are calculated, results for this record are refreshed.
You can use the drag-and-drop technique to specify the order in which you want to run user-defined calculations.
Open a hyperlink
Indicates whether the button is to open a new browser window and attempt to navigate to a specified URL. When this option is selected, you enter a web address in the field that becomes available. The address can include the same special parameters as those for opening a file. Parameter values are then filled it at the time that the button is clicked.
For example, assume that you entered this:
http://www.mycompany.com/lookupManufacturer.aspx?name=@FieldName(Manufacturer)
When you clicked the button on the form, you could be taken here:
http://www.mycompany.com/lookupManufacturer.aspx?name=Motorola
For more information, see Special Button Parameters.
Open a file
Indicates whether the button is to open a file. In the Enterprise Edition, the web application cannot open a file on a local machine. However, Execute on server is shown in this edition. Available only to system administrators, this checkbox is selected to configure a button to run a batch or executable file on the Windchill Risk and Reliability application server. When this checkbox is selected, only system administrators can enter data in the options for configuring the button. Additionally, system administrators must modify the RiskAndReliability.Service.LongRunningTasks.exe.config file to indicate that the file specified is allowed to run on the server. For more information, see Configuration File Modifications.
The file to open or run is specified in the field below these options. Clicking the browse button opens the Windows standard Open window, where you can navigate to and select the file. To either open or run a file, you must have permissions to the directory where the file resides. If the action cannot be executed, an error is logged to the Event Log, which you can view in the Windows Event Viewer.
When opening a file, an attempt is made to open it in the default program associated with the file extension. If no default program is associated with the file type, you are prompted to select the program to use to open the file. A window opens while the file opens. Clicking Stop waiting in this window ends the wait for this action to be completed.
When running an executable file, the data to pass to the application is entered for Parameters. For example, if the button runs the executable for Microsoft Excel, you supply the data to pass to the default sheet in the newly open book.
Parameters
The data to pass to the executable file. In the Enterprise Edition, this property is available only to system administrators. It is used to pass plain text as well as text for any number of special parameters that are then filled it at the time that the button is clicked. For more information, see Special Button Parameters.
Update
Indicates whether data in the form’s table is refreshed when you click the button on the form.
Nothing. When selected (default), clicking the button does not refresh any records in the form’s table.
Selected Record. When selected, clicking the button refreshes the active record in the form’s table.
Entire System. When selected, clicking the button refreshes all records in the form’s table.
Caption
The name for the window that opens while the file is being opened.
When this field is left blank, the Running External Program window opens.
When you enter a caption, it displays as the window name. You can enter as many as 50 characters.