It is something that happens with an Object. Can be anything, from application launch to file attached. Each object can have MANY Events.
Technically an Event is the record in the Event's Table. It can be created on the following actions:
Button / Link / Image click
App Launch
API request
This new record can contain any data you wish to be stored in it.
How to create a click Event in Custructor
Select "Actions" in the Properties of the Single Button / Link / Image
Click "Create Event"
Fill in the table: "Key" is the name of the field and "Value" is the parameter. The Parameter can be a static string or Hashtag reference.
Click "Save"
Events are located in the APP DATA section of APP's menu
The following options are available:
The following System Fields are available for Events, which you can view in the table by pressing Setup up table (BLUE MARK):
Click on Event to open up its details.
The pop-up displays data saved to event during creation and app state snapshot data for that moment.
Event pop-up contains following info:
The current Status of the event. The status can be tracked by using filters. To learn more on - Statuses.
Location of the of the device when the event was created ( if available)
The info on the current event. It contains all the information that was passed to the Event in the form of Key (left) and Value (right) pairs.
Files if any file was attached event using the file element.
The metadata on the Object like which browser he used to access the app, which version of operating system, etc.
The information about the Object that this event applies to. This is used for convenience purposes to avoid the need to navigate back and forth between Backend and the Objects tabs.
In order to Create / Update / Delete an Event using API Request you should do the following:
Get Access token - https://documenter.getpostman.com/view/4564343/S11LscyP#8cdbe179-7e2d-6218-9273-0df0bc8edfdf
Create / Update / Delete the Event - https://documenter.getpostman.com/view/4564343/S11LscyP#cfffad1b-9646-94a2-e74a-7eb03235caf3
Events are mostly used when you want to submit some dynamic data or track user actions, not once, but periodically.
Good Use | Not such a good use |
You have a "a complain form" to submit a problem. Since one AppUser can submit multiple complains and at different times, it's is good idea to use "Create an event" action for each time, by assigning such Action to a button submitting the form. | You have a "Enter your personal info form" asking the AppUser for the name. Creating an Event makes no sense, as this is entered just once. You are better off just recording this data into Object's column using "Save to Object Column" action. |
Events can be tracked by filters and automatic actions can be performed based on data in Events. Using filters combined with triggers allows to set up the rules to perform actions on the Events. Please refer to Triggers article for more info.
|