Actions provide all of the functionality in Rapid. When added to your page, they provide your app with that extra level of depth to really bring your application to life.

It is also possible to create bespoke actions. These are especially useful for integration with other, third party systems. Some examples include retrieving and displaying documents, booking appointments, and copying files from one network location to another.


Control action

This action runs common jQuery methods against specific controls. There is a wide variety of actions to choose from, such as toggling whether the control is visible or not, sliding things into view and creating your own custom action using jQuery.

Properties

Name Description
Control Selects a control on the page to apply the action to.
Action Sets a specified action to be carried out. Useful for validation and page load events.
Duration (milliseconds) Sets a total time for the action to be carried out in.
Class Dropdown list of currently available classes.
Command Allows you to create customised actions using jQuery. Recommended for advanced programmers.

Custom action

This action allows you to enter customised Javascript for complete flexibility. If you find your page becomes blank when viewing it could be that an error in your code has occurred here.

Properties

Name Description
JavaScript Allows you to create customised actions using JavaScript. Recommended for advanced programmers.

Database action

This action enables manual input for SQL. In order for this to function correctly a database connection must be established. Testing the SQL can display any errors you may have in your code. Input fields are controls present on the page and can be represented by a ?, one in your code for each input. The output field acts as the destination for your data. More options can be set as well, such as displaying a loading animation during execution and success actions.

Properties

Name Description
Query Enables you to define a database query. SQL can be entered within the text area and selected inputs and outputs can be chosen. There is also a capability to test your SQL against a specified database connection.
Loading animation Displays a loading animation whilst the database query executes.
Child actions Enables for further database queries to be defined for child databases.
Success actions Sets what events occur upon a successful query to the database.
Error actions Sets what events occur upon an unsuccessful query to the database.

Data copy action

This action allows you to copy almost any source into any destination control on your page. There are multiple options available to choose from when data copying, such as bulk and row merge, and each is capable of powerful things. If you find your data copies are not working as expected there is likely an issue with how it was set up initially.

Properties

Name Description
Copy type This powerful control moves data around your application. The following differnt types of data copy are supported: - replace, will empty the destination controls of data beore copying in the source data - append, will add the source data as a new row in the destination data. Any existing fields will be used, new fields will be added - row merge, will keep all destination data and add the source data in the same row. New fields will be added if required - child merge, will uses fields in common between the source and destination to match rows in the source to rows in the destination where matching rows in the source will be added to child datastores in the destination. Use this for parent/child relationships - bulk, provides a dialogue where a number of realted datacopies can easily be specified - search, allows a source to be searched against a term and matching rows placed into the destination - transpose, converts a source with lots of columns to one with lots of rows and vice versa. Key fields will appear on every row, igore fields will not be used in the transposition
Source Dropdown list containing all page controls to be used as a source. System values can also be used.
Source field Optionally specify a field or property that holds the data within the source control. An example of this is a specific cloumn's field name in a table or grid.
Search term The control holding the value you are looking for.
Search term field Optionally specify a field or property from the term dropdown, like the source field.
Search fields Fields or properties in the source to search for matches against the search term.
Maximum rows Caps the amount of data that is to be returned upon searching.
Destinations Sets the destination controls and optional fields for your copied data.
Child field Optionally specify a field or property that holds the data within the parent control. An example of this is a specific cloumn's field name in a table or grid.
Key fields Sets the fields to appear in every row or column when transposing data.
Ignore fields Sets the fields that will not be included in the transposing of data.
Bulk data copies Enables the use of mass data copying. Useful for when large quantities of data needs to be transferred from one location to another within your Rapid application. Similar to normal data copies, it is possible to select a source and source field, a destination and destination field, and the type of copying that is to be carried out.
Trigger change events Causes a change event to occur when the data is copied. Useful for validation.

Event action

This action offers a complete list of all available events on the page. Selecting any event from this action will trigger all of the associated actions on that particular event.

Properties

Name Description
Event Selects a set of actions to be carried out as a single event, all at once.

Existing action

Enables you to call an existing event on that specific page. If the event being referenced here is removed then it will display as a blank event, meaning you are free to delete or change the event target as the previous one is no longer present.

Properties

Name Description
Action Allows the reuse of other, existing actions on other controls, including the page.

Form action

Only available for Rapid forms, this action will allow you to carry out a specific form action, such as logically progressing from one page to the next on your form.

Properties

Name Description
Action Sets the action to be performed when the condition is met. The options include moving forward or backwards a page in your form, copying a form id and copying a form value.
Source Sets the source control for where the form value is being copied from.
Destination Sets the destination for where the form value is being copied to.

Group action

Enables multiple action calls in a single event. This is useful for when you want to trigger many events without taking up a lot of space. Related actions can be recalled, be formed in logical groups and can be reused in a single step. Grouped actions are also useful for page reuse events.

Properties

Name Description
Description A description of the actions in this group.
Actions Add actions to this group to tidy your application, or re-use all actions in the group.

Logic action

This action allows you to contest certain outcomes and have different success or fail actions occur as a result. Multiple success and failure actions can be stacked inside one another and a variety of different conditions can be tested against, making this action a very powerful and flexible tool to use in a variety of different ways, such as only displaying a page if visibility rules are met.

Properties

Name Description
Conditions Sets the conditions for the logic to be carried out. This can be particularly useful for setting controls to appear on the page, or checking for correct details on the page.
Actions if true Defines the actions to be carried out if the above condition is true.
Actions if false Defines the actions to be carried out if the above condition is false.

Mobile action

Unique for Rapid Mobile applications, this action allows you to perform a multitude of mobile actions, such as dialing a number, sending a text, taking a picture, or scanning a barcode or QR code.

Properties

Name Description
Type Defines the type of mobile action that will be carried out, such as dialing a number, scanning a barcode or sending a GPS location.
Phone number source Sets where the phone number is coming from on the page.
Phone number source field Defines a more specific field for the phone number source. An example of use would be getting the phone number from a table cell within a table, where the cell is the field and the table is the source.
Email address source Sets where the email address is coming from on the page.
Email address source field Defines a more specific field for the email address source. An example of use would be getting the email address from a table cell within a table, where the cell is the field and the table is the source.
Subject source Sets where the email subject is coming from on the page.
Email source field Defines a more specific field for the email subject source. An example of use would be getting the email subject from a table cell within a table, where the cell is the field and the table is the source.
Phone number source Sets where the phone number is coming from on the page.
Phone number source field Defines a more specific field for the phone number source. An example of use would be getting the phone number from a table cell within a table, where the cell is the field and the table is the source.
Message source Sets where the message is coming from on the page.
Message source field Defines a more specific field for the message source. An example of use would be getting the message from a table cell within a table, where the cell is the field and the table is the source.
URL source Sets where the URL is coming from on the page.
URL source field Defines a more specific field for the URL source. An example of use would be getting the URL from a table cell within a table, where the cell is the field and the table is the source.
Gallery control Selects which gallery control to use on the page. You will need to have a gallery control on the page in order to use this.
Max width/height (px) Sets the maximum height and width of the gallery. By default it sets to 500 pixels in length and width.
Quality (%) Sets the quality of the image, in percentages. By default it sets the quality to 50% of that of the original.
Controls Sets the gallery or signature control on the page to put the image in to.
Destinations Sets the destination for where to place the barcode data on the page.
Success actions Allows you to set a success action for when the image is successfully imported into the control specified.
Error actions Allows you to set an error action for when the image is not successfully imported into the control specified.
Navigate to source The control that holds the data of where we want to navigate to.
Navigate to source field Defines a more specific field for the source of where we want to navigate to. An example of use would be from a table cell within a table, where the cell is the field and the table is the source.
Navigate to search fields Fields in the navigate to source control to use to search for the location to navigate to.
Navigation mode Sets the type of transport being used to navigate, such as public transport.
Message Sets a message to display in the status bar.
Destinations Sets which control on the page will hold the GPS location sent.
Update frequency (seconds) Sets how long it takes for the GPS position to be updated.
Check GPS enabled Sets whether to check if the mobile device has GPS enabled or not.
Actions Allows you to define actions to be carried out if the mobile device has an established Internet connection.
Working dialogue Sets a page to appear as dialogue if the mobile device is connected online.
Offline dialogue Sets a page to appear as dialogue if the mobile device is not connected to the Internet.

Navigate action

This action allows you to traverse to different pages on your application. Pages can also be shown as a dialogue box, meaning they can display over your current page. This is particularly useful for displaying pages where you do not want to navigate away from your current page whilst wishing to take data from another.

Properties

Name Description
Page Sets the page to navigate to.
Page variables Allows you to choose which page variables can be set upon leaving this page to the next. This is particularly useful for path conditions on a form.
Show as dialogue Sets whether to show the new page as a dialogue. Dialogue pages will appear in front of the currently selected page.
Stop further actions Sets whether to halt further actions on the current page whilst the dialogue is in view.

Timer action

This action adds a delay to other actions, making them occur after a pre-determined period of time, defaulting to 1 second. This can also be set to repeat. This can be useful for making users wait whilst a back-end change takes place.

Properties

Name Description
Duration (milliseconds) Sets how long the timer will last.
Repeat Allows you to define whether to repeat the timer action after the ellapsed time has passed.
Actions Defines the actions to be carried out after the set duration of time has ellapsed.

Validation action

This action lets you set benchmarks for carrying out operations. Similar to the Logic action, this action will actively stop further actions from executing until an action is met. A pass action will resume the given action if it is met, such as moving to the next page of a form, and a fail action will keep the user on the same page and trigger some kind of change, such as displaying a validation error.

Properties

Name Description
Controls Sets the control/s on the page to validate against.
Apply styling Sets whether to apply a validation style to the selected controls.
Stop further actions Sets whether to prevent further actions from being carried out on the page or not, such as progressing to the next page on a form.
Pass actions Sets actions to be carried out for when validation has passed.
Fail actions Sets actions to be carried out for when validation has failed

Webservice action

Used for computer to computer communication, the webservice action allows you to set the request type to SOAP, restful XML or JSON. SOAP follows a strict set of rules which must be met in order for a request to go through, restful XML is less strict, and JSON has no set of rules but will block the request if it is unsuccessful..

Properties

Name Description
Request Enables you to define a webservice request. The request can be entered within the text area and can be of the type SOAP, JSON or XML/Restful. Selected inputs and outputs can be chosen for the request.
Loading animation Sets whether to display a loading animation or not whilst the request is taking place.
Success actions Sets actions to be carried out for when the webservice has completed successfully.
Error actions Sets actions to be carried out for when the webservice has not been successful.