ActionsVersion: 4.56On this pageActions Actions represent user interactions with the application or what to do after triggering an event. They can be added to almost any layer to make it clickable and are then triggered by the user's touch. The actions added to a layer are executed one after the other in the order in which they were added. You can also specify how the app handles the result of another action. To this end, some actions can define an onSuccess and onError field in which an event can be named that is triggered after the action is completed. Depending on the action (e.g. the action request), the result data is added to the event as an event parameter. The type field of an action defines the type of the action and can also be referred to as its "name". The parameters of the action are entered in the params field of the JSON object. While most actions require parameters in order to be configured correctly, this is not the case for some. Exampleโ Example configuration of a showMessage action. { "actions": [ { "type": "showMessage", "params": { "text": "This will be displayed as a toast." } } ]} Index of all action typesโ Below is a complete list of all actions: ๐๏ธaddCalendarOpens the default calendar of the user's device and shows a pre-filled "add new event" view with the provided data. Depending on the operating system and its version, this could manifest as just an in-app overlay or a complete switch to the calendar app.๐๏ธaddContactOpens the contacts of the user's device and shows a pre-filled "add new contact" view with the provided data. Depending on the operating system and its version, this could manifest as just an in-app overlay or a complete switch to the contacts app.๐๏ธaddDataSourceThe addDataSource action enables you to add a new database (or just its source) to your application. This is used often if the desired source is not available at a previous point in you configuration or certain parts of the source are depending on not yet available data, i.e. before the user is logged in or got its credentials.๐๏ธaddGeofencesAdds a geofence too look for.๐๏ธalertThis action triggers an alert in the form of the device's vibration and/or default notification sound.๐๏ธaskUserShows a modal pop-up with buttons in the style of the operating system. The lists of buttons and events or actions reference each other so that the button with a specific index will trigger the corresponding event or action with the same index.๐๏ธbackInHistoryThis action triggers the back navigation of your view stack. As long as there is a view on your stack, the view is popped and the previous view is displayed.๐๏ธbeginNFCReadingStarts listening to NFC tags.๐๏ธcalibrateAccelerometerCalibrates the accelerometer (acceleration sensor).๐๏ธcallOpens the device's default phone app with the provided number pre-filled to be dialed.๐๏ธcancelRequestCancels a request with a name. This will only guarantee, that the result of the request will be an error. If the request gets already processed by the server, a change on the server side may still occur.๐๏ธcancelTimeoutCancels a previously set timeout action with the specified name.๐๏ธcheckBiometryOpens the device's system prompt for biometric authentication. Depending on the hardware capabilities, this can be (not limited to) fingerprint or face recognition, for example.๐๏ธcheckForInactivityFires an event after a specified period of inactivity. The counter is reset to the specified time with each interaction. Inactivity is considered to be no touch or other interaction by the user. Automatic changes (e.g. a gallery auto-swipe) do not interrupt the inactivity counter.๐๏ธcleanGeofencesCleans all existing geofences.๐๏ธclearCacheClears the cache of the app. The cached content primarily includes media files such as images, videos, or PDFs.๐๏ธclearCustomStartResets the start configuration for the app, which then uses the default configuration for the next launch. This resets a previously set custom start point for the user, for example.๐๏ธclearDatabaseResets the database data. By default, the data is retrieved again immediately.๐๏ธclearFormValueDeletes a specific value from a form field/entry.๐๏ธclearVariableResets the value of a previously defined variable to null.๐๏ธclosePopUpCloses the currently open pop-up on the view stack. If no pop-up is present, nothing happens.๐๏ธcloseViewCloses a previously created, named view.๐๏ธcloseWebSocketCloses a previously opened WebSocket connection with the specified name.๐๏ธcopyToClipboardCopies the specified text to the clipboard of the user's device.๐๏ธdecodeJWTDecodes a JSON Web Token (JWT).๐๏ธdecryptSettingsWithBiometryDecrypts a value that was previously encrypted with personal biometric information. Uses the options available on the users device and operating system.๐๏ธdeleteAllLocalImagesDeletes all locally saved images of this application.๐๏ธdeleteLocalImageDeletes a locally saved image with the specified name from the apps image folder on the device.๐๏ธdeleteUserSettingDeletes the user setting with the specified name (key). This removes the key and its value.๐๏ธdisableCrashlyticsDisables the collection of crash and similar data by Google Firebase Crashlytics.๐๏ธdisableTrackingTurns off tracking of user interactions for analytical purposes.๐๏ธdownloadFileDownloads a file to the device's local storage.๐๏ธdownloadImageToGalleryDownloads an image to the device's local storage.๐๏ธenableCrashlyticsEnables the collection of crash and similar data by Google Firebase Crashlytics.๐๏ธenableTrackingActivates tracking of user interactions for analytical purposes.๐๏ธencryptSettingsWithBiometryEncrypts a value with personal biometric information. Uses the options available on the users device and operating system.๐๏ธexecutePushPayloadExecutes a push notification payload by using it's ID.๐๏ธexecuteQuerySQLExecutes an SQL query in the local database and makes the queried fields available in the parameters of the onSuccess action.๐๏ธexecuteSQLExecutes an SQL command in the local database.๐๏ธexportTableExports one or multiple tables from the app as a JSON file that can be reimported later using the importTable action.๐๏ธfireEventFires the specified event.๐๏ธforEachA for each expression to loop through a list. Elements can be items of an array or keyed objects of a list.๐๏ธgetLocationGets the current location or address by reverse geocoding if necessary.๐๏ธhideLoadingOverlayHides the loading overlay within the app once.๐๏ธifAn if expression to call different actions depending on whether the condition is met or not.๐๏ธimportTableImports one or multiple tables to the app that have beed previously save as a JSON file using the exportTable action.๐๏ธinsertFromParamsInserts data given via event parameters into the SQLite database of the application.๐๏ธinsertFromRequestCombines the functionality of the request and insertFromParams actions into one, therefore requesting data which is then inserted into a database table of the application.๐๏ธlayerActionPerforms an action on another layer.๐๏ธlogLogs a message with the desired log level. This message can then be used for debug purposes within the debug menu of the application.๐๏ธmailToOpens the device's default e-mail app and pre-fills the inputs with the provided data to send an e-mail.๐๏ธnoActionCan be used to prevent a touch interaction to be propagated through the layers, e.g. to disable a button.๐๏ธopenAppSettingsOpens the system settings page of this specific app.๐๏ธopenBrowserOpens a website with the specified URL. Can be either within an internal browser overlaying the app or jumping out of the app context and using the user's default browser.๐๏ธopenWebSocketOpens a WebSocket connection to a service in order to receive messages from it and react to them.๐๏ธopenWifiSettingsOpens the WiFi system settings.๐๏ธpauseAudioPauses the current audio playback triggerd by the playAudio action.๐๏ธplayAudioPlays the audio file specified by the URL.๐๏ธplayNotificationSoundPlays the default notification sound set by the user within the operating system.๐๏ธpreloadLoads data to be stored within the system storage of the app to ensure functionality or data access without a data connection. Ususally this includes files like media files (images, videos), PDFs or web content.๐๏ธratingPrompts the user to rate the application using the system's native default rating overlay without leaving the app itself.๐๏ธregisterPushRegisters the app with FCM (Android) or APNS (iOS) for push messages. A system prompt may appear for the user to confirm receiving notifications from this app before the actual registration concludes.๐๏ธreloadDatabaseTableRequest the data source of the specified database table manually and inserts the received data.๐๏ธremoveDataSourceRemoves data source from a database table with the specified name.๐๏ธremoveGeofencesField Configurations๐๏ธremoveLocalReminderField Configurations๐๏ธreplaceGeofencesField Configurations๐๏ธrequestPerforms an HTTP request.๐๏ธrequestPermissionRequests desired permissions to access guarded system resources like camera, position, etc. Depending on the operating system and version, this can result in a system prompt asking the user to accept or prevent this access.๐๏ธresetFormResets the form with the specified name. All form values of this form will be removed.๐๏ธrestartManually restarts the app. Non-volatile data will be kept.๐๏ธresumeAudioContinues the audio playback of a previously paused playback by pauseAudio.๐๏ธreturnThe return action breaks all following actions in the same action block.๐๏ธrevokePushDeletes the pushenabled userSetting and unregisters the app from FCM (Google) and APNS (Apple).๐๏ธrouteDisplays a route in the default navigation app of the device. If an address exists, longitude and latitude will be ignored. If there is no address, both latitude and longitude is required.๐๏ธsaveImageLocallySaves an image to the local storage of the app.๐๏ธsendFormMailOpens the device's default e-mail app with predefined subject, body, and recipients addresses. form data of the current view can be used to construct the email body.๐๏ธsetCustomStartOverwrites the start configuration for the app. The app will use the provided configuration during the next launch. This primarly intended, for example, to display an onboarding or tutorial the first time the app is started, but to prevent another showing the next time the app is started.๐๏ธsetDataFromResultSets content to the given form from the form parameter or the current view's form.๐๏ธsetDelimitersSets the delimiters for the current list of actions.๐๏ธsetFormValueSets a specified value to a form layer with the specified name (key).๐๏ธsetLocalReminderSets a reminder with the specified title and text to be displayed at the specified time.๐๏ธsetParamsSets values to the event parameters.๐๏ธsetTablePollingStateChanges the polling state of a database source to the duration of the specified name.๐๏ธsetTimeoutStarts a timer with the specified name to execute an action in the specified seconds from the time of start. Can be repeated with the same interval and keep running in the background.๐๏ธsetValueToUserSettingStores the provided value to a userSetting storage of the application.๐๏ธsetVariableStores the given value to a variable of the specified name.๐๏ธshareUses the operating system's share functionality to share different data like text, photos, files or links.๐๏ธshowBarcodeScannerOpens a camera view with custom overlay for barcode reading functionality. Depending on the configuration, different options are available through the overlay's interface.๐๏ธshowDebugViewOpens the mos. applications included debug menu which displays various information and developer options.๐๏ธshowLayoutDisplays the specified content on the specified layout.๐๏ธshowLoadingOverlayField Configurations๐๏ธshowMessageDisplays a message.๐๏ธshowViewDisplays the specified content on the specified layout.๐๏ธstartBeaconScanningStarts scanning for beacons.๐๏ธstartLocationTrackingStarts the location tracking of a device๐๏ธstopAudioStops any audio that the app may be playing.๐๏ธstopLocationTrackingTerminates the position determination with the specified keys.๐๏ธstopNFCReadingStops listening to NFC tags.๐๏ธsubmitFormSubmits the content of a form via HTTP request.๐๏ธswitchA switch expression. If none of the defined cases match _default case is executed.๐๏ธswitchStateChanges the state of a layer.๐๏ธswitchTabField Configurations๐๏ธtrackEventTracks an event in Firebase Analytics or Matomo.๐๏ธvalidateFormValidates the fields of the specified form according to its defined validationExpression.
๐๏ธaddCalendarOpens the default calendar of the user's device and shows a pre-filled "add new event" view with the provided data. Depending on the operating system and its version, this could manifest as just an in-app overlay or a complete switch to the calendar app.
๐๏ธaddContactOpens the contacts of the user's device and shows a pre-filled "add new contact" view with the provided data. Depending on the operating system and its version, this could manifest as just an in-app overlay or a complete switch to the contacts app.
๐๏ธaddDataSourceThe addDataSource action enables you to add a new database (or just its source) to your application. This is used often if the desired source is not available at a previous point in you configuration or certain parts of the source are depending on not yet available data, i.e. before the user is logged in or got its credentials.
๐๏ธalertThis action triggers an alert in the form of the device's vibration and/or default notification sound.
๐๏ธaskUserShows a modal pop-up with buttons in the style of the operating system. The lists of buttons and events or actions reference each other so that the button with a specific index will trigger the corresponding event or action with the same index.
๐๏ธbackInHistoryThis action triggers the back navigation of your view stack. As long as there is a view on your stack, the view is popped and the previous view is displayed.
๐๏ธcancelRequestCancels a request with a name. This will only guarantee, that the result of the request will be an error. If the request gets already processed by the server, a change on the server side may still occur.
๐๏ธcheckBiometryOpens the device's system prompt for biometric authentication. Depending on the hardware capabilities, this can be (not limited to) fingerprint or face recognition, for example.
๐๏ธcheckForInactivityFires an event after a specified period of inactivity. The counter is reset to the specified time with each interaction. Inactivity is considered to be no touch or other interaction by the user. Automatic changes (e.g. a gallery auto-swipe) do not interrupt the inactivity counter.
๐๏ธclearCacheClears the cache of the app. The cached content primarily includes media files such as images, videos, or PDFs.
๐๏ธclearCustomStartResets the start configuration for the app, which then uses the default configuration for the next launch. This resets a previously set custom start point for the user, for example.
๐๏ธclosePopUpCloses the currently open pop-up on the view stack. If no pop-up is present, nothing happens.
๐๏ธdecryptSettingsWithBiometryDecrypts a value that was previously encrypted with personal biometric information. Uses the options available on the users device and operating system.
๐๏ธdeleteLocalImageDeletes a locally saved image with the specified name from the apps image folder on the device.
๐๏ธdeleteUserSettingDeletes the user setting with the specified name (key). This removes the key and its value.
๐๏ธdisableCrashlyticsDisables the collection of crash and similar data by Google Firebase Crashlytics.
๐๏ธenableCrashlyticsEnables the collection of crash and similar data by Google Firebase Crashlytics.
๐๏ธencryptSettingsWithBiometryEncrypts a value with personal biometric information. Uses the options available on the users device and operating system.
๐๏ธexecuteQuerySQLExecutes an SQL query in the local database and makes the queried fields available in the parameters of the onSuccess action.
๐๏ธexportTableExports one or multiple tables from the app as a JSON file that can be reimported later using the importTable action.
๐๏ธforEachA for each expression to loop through a list. Elements can be items of an array or keyed objects of a list.
๐๏ธifAn if expression to call different actions depending on whether the condition is met or not.
๐๏ธimportTableImports one or multiple tables to the app that have beed previously save as a JSON file using the exportTable action.
๐๏ธinsertFromParamsInserts data given via event parameters into the SQLite database of the application.
๐๏ธinsertFromRequestCombines the functionality of the request and insertFromParams actions into one, therefore requesting data which is then inserted into a database table of the application.
๐๏ธlogLogs a message with the desired log level. This message can then be used for debug purposes within the debug menu of the application.
๐๏ธmailToOpens the device's default e-mail app and pre-fills the inputs with the provided data to send an e-mail.
๐๏ธnoActionCan be used to prevent a touch interaction to be propagated through the layers, e.g. to disable a button.
๐๏ธopenBrowserOpens a website with the specified URL. Can be either within an internal browser overlaying the app or jumping out of the app context and using the user's default browser.
๐๏ธopenWebSocketOpens a WebSocket connection to a service in order to receive messages from it and react to them.
๐๏ธplayNotificationSoundPlays the default notification sound set by the user within the operating system.
๐๏ธpreloadLoads data to be stored within the system storage of the app to ensure functionality or data access without a data connection. Ususally this includes files like media files (images, videos), PDFs or web content.
๐๏ธratingPrompts the user to rate the application using the system's native default rating overlay without leaving the app itself.
๐๏ธregisterPushRegisters the app with FCM (Android) or APNS (iOS) for push messages. A system prompt may appear for the user to confirm receiving notifications from this app before the actual registration concludes.
๐๏ธreloadDatabaseTableRequest the data source of the specified database table manually and inserts the received data.
๐๏ธrequestPermissionRequests desired permissions to access guarded system resources like camera, position, etc. Depending on the operating system and version, this can result in a system prompt asking the user to accept or prevent this access.
๐๏ธresetFormResets the form with the specified name. All form values of this form will be removed.
๐๏ธrevokePushDeletes the pushenabled userSetting and unregisters the app from FCM (Google) and APNS (Apple).
๐๏ธrouteDisplays a route in the default navigation app of the device. If an address exists, longitude and latitude will be ignored. If there is no address, both latitude and longitude is required.
๐๏ธsendFormMailOpens the device's default e-mail app with predefined subject, body, and recipients addresses. form data of the current view can be used to construct the email body.
๐๏ธsetCustomStartOverwrites the start configuration for the app. The app will use the provided configuration during the next launch. This primarly intended, for example, to display an onboarding or tutorial the first time the app is started, but to prevent another showing the next time the app is started.
๐๏ธsetDataFromResultSets content to the given form from the form parameter or the current view's form.
๐๏ธsetLocalReminderSets a reminder with the specified title and text to be displayed at the specified time.
๐๏ธsetTablePollingStateChanges the polling state of a database source to the duration of the specified name.
๐๏ธsetTimeoutStarts a timer with the specified name to execute an action in the specified seconds from the time of start. Can be repeated with the same interval and keep running in the background.
๐๏ธshareUses the operating system's share functionality to share different data like text, photos, files or links.
๐๏ธshowBarcodeScannerOpens a camera view with custom overlay for barcode reading functionality. Depending on the configuration, different options are available through the overlay's interface.
๐๏ธshowDebugViewOpens the mos. applications included debug menu which displays various information and developer options.
๐๏ธvalidateFormValidates the fields of the specified form according to its defined validationExpression.