Show App Settings
|
Object
|
Details
|
Additional Information
|
[App Selection]
|
Click the Select button to display the Select an App dialog. Here you can choose from any of your private or shared published apps to determine which app will be launched when the behavior is activated.
Once the app is selected, the app name will display in the read-only field to the left of the Select button on the Properties panel.
|
|
New Instance
|
Select this radio button to create a new app instance when the Show App command is run. It should be noted that this does not create a relationship between the two app instances.
|
Linking Apps and Using Parent-Child Relationships
Creating and Managing Child Instances
|
Existing Instance
|
Select this radio button to display an existing instance of the app when the Show App command is run. The existing instance ID is stored in the field specified in the 'Field to Hold the App Instance ID' property.
|
Linking Apps and Using Parent-Child Relationships
Creating and Managing Child Instances
Finding and Viewing Related Apps Instances
|
New Child Instance
|
Select this radio button to launch a new child app instance when the Show App command is run. The child instance ID is stored in the field specified in the 'Field to Hold the App Instance ID' property.
|
Linking Apps and Using Parent-Child Relationships
Creating and Managing Child Instances
|
Single Child Instance
|
Select this radio button to launch a new child instance when the Show App command is run.
|
Linking Apps and Using Parent-Child Relationships
Creating and Managing Child Instances
|
|
You should ensure that the field to 'Hold App Instance ID' property is empty if you choose to use this 'Single Child Instance' option. If it is not empty, it will launch the child instance ID that is stored within that field instead.
|
|
Existing Child Instance
|
Select this radio button to display a list of child apps when the Show App command is run.
|
Linking Apps and Using Parent-Child Relationships
Finding and Viewing Related Apps Instances
|
Parent Instance
|
Select this radio button to open the parent instance for the current app instance ID when the Show App command is run.
|
Linking Apps and Using Parent-Child Relationships
Finding and Viewing Related Apps Instances
|
New Window
|
Select this check box to launch the app in a new pop-up window when the Show App command runs.
|
|
Show Error Messages
|
Select this check box to have PerfectApps show all errors. If you clear this check box, then you will need to manage your own error handling.
You can inspect the error code after the command has run. Check for problems with the connection using a Branch command and inspecting the Special Value Last Command Was Successful and last command's error code.
•No error (Error Code 0) •Generates a general connection error (Error Code 200) •Returns no data although the connection worked fine (Error Code 201) |
Connection Error Handling
|
Hold App Instance ID
|
Field
|
Click Select to choose the field on the current app that will hold the app instance ID of the app to be opened.
To select the desired field, click the Select button, then navigate to the object you want to choose. Once a selection has been made, the value will be shown in the read-only text box to the left of the Select button.
This property is required if you selected any of the Existing Instance, Child Instance or Single Child Instance options.
|
Linking Apps and Using Parent-Child Relationships
Finding and Viewing Related Apps Instances
|
|
Each time a new child app instance is generated, it will overwrite the ID previously stored in this property. In most cases, it makes more sense to use the Show App button object as this will store the child instance ID as a property of that button.
|
|
Custom Parameters
|
Name
|
Click in the cell to enter a name for the parameter.
|
|
Source
|
Click a cell in this column to select the source of the parameter to be passed. Options include an app field, object or a formula (if the Formula check box is selected).
|
|
|
Data passed cannot exceed 250 characters.
|
|
Formula
|
Select this check box to enable formula editing for the selected parameter. Once selected, you can click in the Source column to launch the Formula and Conditions Editor.
|
Using the Formula and Condition Editor
|
Add button
|
Click the Add button to add a custom parameter to the list.
|
Setting Up Custom Parameters
|
Remove button
|
Click the Remove button to remove a custom parameter from the list.
|
|
