Action Components

Action Configuration View » Action Components

An action consists of one or more steps. Each step can be populated with action components and define inputs and outputs. This section describes the different components available and explains how to use them.

Available Variables in Actions

Action Configuration View » Available Variables in Actions

Think of the Action Steps as connectable parts that have an input and an output pipe. Each Step waits for incoming objects (in cv.Payload) it can then process and pass on through the output pipe to the next Step. Before processing the Step, you can Pre-Map and after…

Trigger Variables and Properties

Introduction » What is Gravio? » Hub Configuration View » Trigger Tab » Trigger Variables and Properties

Device / timer triggers allow you to pass trigger properties and trigger variables as arguments when performing an action. Trigger variable The trigger variable is a variable in tv., which is passed to the action as tv. In an event-driven trigger by receiving sensor…

Action Component Behavior

Action Configuration View » Action Component Behavior

The action component has two component variables (cv.): the input payload (cv.Payload) and the output payload (cv.Payload). You can use it as the input payload (cv.Payload) when used in Pre-Mapping and as the output payload (cv.Payload) when used in…

Writing an Action

Action Configuration View » Writing an Action

Double-clicking on your Action in the Actions Overview will open your Action Editor. This is where you put your actions together. Actions consist of separate steps which you can string together, create “decision trees” and create inputs and outputs. The…

Action Configuration View

Action Configuration View

The Gravio HubKits can trigger Actions. You can think of an Action like a small and simple computer program, that’s made up of Steps. Actions can be created in the Action Editor which can be opened by clicking on the Action Editor icon: You can find these…

Referring to the value of a Object variable in an Action

Action Configuration View » Referring to the value of a Object variable in an Action

If you like to refer to the value of a variable of type Object available in an action, you can access the element with a selector or square brackets connected to the variable with a dot. As an example of an Object type variable, if you use IVAR’s face…

How to write expressions in Pre Mappings / Post Mappings

Action Configuration View » How to write expressions in Pre Mappings / Post Mappings

Each action component in the Action Editor has a pre Pre Mappings / Post Mappings area on the right side of the screen: Press the “+” button to add a new line to either the Pre-Mappings or the Post-Mappings. Pre Mappings are executed before the main…

Template

Action Configuration View » Action Components » Template

The Template component is a component that generates a string (text) from a specified template using placeholders. The template syntax is a GoLang standard described on https://golang.org/pkg/text/template/ . tp. / tv. / ap. / av. / cp. / cv. are all referable to…

Debug Log

Action Configuration View » Debug Log

Press the button at the top left of the component to output the debug log. By nature, components run independently and in parallel, but when executing an action while outputting debug logs, they are synchronized within the action engine. The debug log outputs the…

Sensor Event Triggers

Introduction » What is Gravio? » Hub Configuration View » Trigger Tab » Sensor Event Triggers

Sensor Triggers Click on the icon on the top right with the plus in the square to create a sensor-based trigger: This will open the trigger popup: Give your trigger a sensible name, we recommend to name it after the condition that triggers the…

Mail Send

Action Configuration View » Action Components » Mail Send

The Mail Send Action Component is to send email via SMTP. The Mail Send component sends an input payload (cv.Payload) as the body of a mail. It converts the data received by the input payload into a string and sends it as the body of an email. After sending the mail,…

Environment Functions

Action Configuration View » Functions » Environment Functions

The following functions are available. Function Name Arguments Description Env Env(s) Return environment variables

MQTT Publish

Action Configuration View » Action Components » MQTT Publish

The MQTT Publish Action Component allows you to publish messages to topics within an MQTT PubSub system. Output Payload Explanation cv.Payload Outputs the output payload of the previous component as is. (Pass through) Component…

Split

Action Configuration View » Action Components » Split

The Split component is a component that splits the input Payload by line feed if it is a string, or by element if it is a JSON array, and passes it to the next component. The Split component provides the ability to filter whether the output data after the split is…

Filter

Action Configuration View » Action Components » Filter

The Filter component is a component that filters the data that passes the contents of the input payload to the next component and outputs it to the output payload. You can enter a conditional expression that allows you to pass a test if it’s true, or not. The…

Statistics

Action Configuration View » Action Components » Statistics

The Statistics component stores the statistics (Min, Max, Mean/Average, Median, Standard Deviation, Sum, Mode) in the component variables with the specified values. If the value specified is an improper value for a number, that value will be excluded from the…

File Read

Action Configuration View » Action Components » File Read

The File Read Action Component is to read a file. Component Properties Name Required Description Filename False Filename of the file to be read. The file has to be inside these folders: On Windows:…

File Delete

Action Configuration View » Action Components » File Delete

The File Delete Action Component is to delete a file. Component Properties Name Required Description Filename False Filename All True All. The value of cp.All can be either “true” or “false…

File Write

Action Configuration View » Action Components » File Write

The File Write Action Component is to write data to a file. Component Properties Name Required Description Filename False Filename to be written. Append True Append new data instead of replacing the file.…

Time Based Triggers

Introduction » What is Gravio? » Hub Configuration View » Trigger Tab » Time Based Triggers

You can create triggers that are based on times on time-related parameters such as intervals, weekdays, day-of-month, etc. To create a time-based trigger, open the +-icon with the clock on the trigger tab: You will see the following dialogue box: Give your…

Sleep

Action Configuration View » Action Components » Sleep

The Sleep Action Component is to insert a pause between the two steps of the action. Output Payload Description cv.Payload Outputs the output payload of the previous component as is. (Pass-through) Component…

Trigger Tab

Introduction » What is Gravio? » Hub Configuration View » Trigger Tab

In order to have a trigger, it makes sense to have an action first, that you want to trigger with your trigger. You can see how to make actions here. Once you have an action, you can start triggering it using sensor data. There are three types of…

Google Analytics Send Event

Action Configuration View » Action Components » Google Analytics Send Event

The Google AnalyticsSendEvent component sends events using the Google Analytics Measurement Protocol. For details of Measurement Protocol and parameters, please refer to this link. Checking “Debug Mode” puts you in debug mode. In debug mode, if…

Gravo File Path Handling

Appendix » Gravo File Path Handling

Some component properties like FileWrite or SlackFilesUpload are making references to folders and file paths. On this page, we describe how files can be referenced in Gravio. The Default Folder All paths referenced on Gravio refer to the below paths on the respective…

AWS S3 Download

Action Configuration View » Action Components » AWS S3 Download

The AWS S3 Download Action Component is to download content from Amazon AWS S3. Component Properties Name Required Description Output True Specify whether to keep the content in the Payload variable of the Action or as a file.…

GravioLight

Action Configuration View » Action Components » GravioLight

The Gravio Light Action Component is to control a Gravio Lights. For this component to work, you must have the Gravio Lights paired in advance. Output Payload Description cv.Payload Outputs the output payload of the previous component as…

Sound Effect

Action Configuration View » Action Components » Sound Effect

The Sound Effect Action Component is to play a sound effect. Output Payload Description cv.Payload Outputs the output payload of the previous component as is. (Pass-through) Component…

Join

Action Configuration View » Action Components » Join

The Join Action Component is to join multiple inputs into an array. Output Payload Description cv.Payload Combined array Component Properties Name Required Description Capacity False Specifies how…

AqaraSmartPlug

Action Configuration View » Action Components » AqaraSmartPlug

The Aqara Smart Plug Action Component is to control an Aqara smart plug device. To use this device, you must have the Aqara Smart Plugs paired in advance. Output Payload Description cv.Payload Outputs the output payload of the previous…

TwilioSMS

Action Configuration View » Action Components » TwilioSMS

The Twilio SMS Action Component is to send an SMS text message via Twilio. It is useful to notify people of information from sensors. Component Properties Name Required Description To True The number to send the message to, starting…

General Gravio Troubleshooting

Troubleshooting » General Gravio Troubleshooting

Symptom Explanation Remedy Comments Gravio Studio is not behaving as expected Gravio Server connection is unstable or Gravio Server is not running Ensure that there is a stable connection between Gravio Studio and the Server is…

MSTeamsPostMessage

Action Configuration View » Action Components » MSTeamsPostMessage

The MSTeamsPostMessage action component can use the Microsoft Teams API to post a message to the channel specified in the component’s properties. How to get the Incoming Webhook URL: Select “Connector” from the “More Options” menu in…

Trigger Parameter Examples

Introduction » What is Gravio? » Hub Configuration View » Trigger Tab » Sensor Event Triggers » Trigger Parameter Examples

Setting the valid time period for triggers Device triggers execute when data arrives, that matches the set conditions. You can specify an interval so that the next execution will not take place until this interval has elapsed from the previous execution time. This is…

HTTP Request

Action Configuration View » Action Components » HTTP Request

Using the HTTP Request component, you can send an HTTP request to a specified URL. The HTTP Request component executes the HTTP request with the input payload as the Body content of the HTTP request, depending on its properties, and writes the HTTP response Body to…

LINE Notify

Action Configuration View » Action Components » LINE Notify

The LINE Notify Action Component is to send a notification via the LINENotify service (https://notify-bot.line.me/). It’s useful to notify people of information from sensors. Component Properties Property Name Description Example…

PhilipsHue

Action Configuration View » Action Components » PhilipsHue

The Philips Hue Action Component is to send commands to a Philips Hue light device. You need to specify the color and opacity and set the IP address, user ID, and light ID. The IP address can be found by going to https://discovery.meethue.com/. With this…

AWS S3 Upload

Action Configuration View » Action Components » AWS S3 Upload

The AWS S3 Upload Action Component is to upload content to amazon aws s3. Component Properties Name Required Description Input True Upload a payload or a file. To set the value of cp.Input, use either “Payload” or…

Slack Files Upload

Action Configuration View » Action Components » Slack Files Upload

The Slack Files Upload action component can use the Slack API to post messages and files to a Slack channel. The authentication happens via the Slack authentication token, which you can retrieve from your Slack Admin console. The Slack Files Upload component can be…

Slack Post Message

Action Configuration View » Action Components » Slack Post Message

The Slack Post Message Action Component is to post a message to Slack using the Slack API. It can be useful to debug Actions or notifying people. It can be used for sending messages to #channels as well as @people . Component…

PATLITE

Action Configuration View » Action Components » PATLITE

The Patlite Action Component is to control a PATLITE network device including audio. The watchtower must support HTTP commands. For more information, please visit the Patlite website. https://www.patlite.co.jp/ PATLITEs are useful to control the display according to…

Service Architecture

Introduction » Service Architecture

Gravio consists of the following application modules: Gravio Studio, a Windows, macOS and iOS application to view, edit and configure the server infrastructure. Gravio HubKit, a server software installed on the edge device (Windows, macOS or Linux) to retrieve…

Amazon Polly Speech

Action Configuration View » Action Components » Amazon Polly Speech

The AWS Polly Speech Action Component is to read out text using AWS Polly text-to-speech. Amazon Polly converts input text into life-like speech. This functionality can also be useful for debugging purposes. Note that this functionality may not be available for…

JSONPath() Usage Examples

Action Configuration View » Functions » String Functions » JSONPath() Usage Examples

This section describes an example of using JSONPath(). If the sensor data (cv.Payload) or the argument of the action to be executed in the trigger condition (tv.Data) is in JSON format, you can use JSONPath() to refer to the value. Sample Data { "store": { …

GravioDistance

Action Configuration View » Action Components » GravioDistance

The Gravio Distance component allows you to retrieve distance measurements from the Gravio Laser Distance sensors. To use this component you must have paired the Gravio Laser Distance sensor beforehand. If the Device ID property is empty, the command will be sent to…

Using the File Viewer

Action Configuration View » Using the File Viewer

Some action components in HubKit are able to read files in the actmgr/data directory and save files in that directory. Files stored in this directory can be retrieved by Gravio Studio, and local files can be uploaded to the directory by Gravio Studio. Use the…

SensorDataDB

Action Configuration View » Action Components » SensorDataDB

The Sensor Data DB Action Component is to read from the Sensor Data DB. Each recorded piece of data gets stored in the Sensor Data DB. With this component, you can query that database. The SensorDataDB component queries data from the SensorDataDB stored in HubKit and…

Sensor Data DB If Zero

Action Configuration View » Action Components » Sensor Data DB If Zero

The SensorDataDBIfZero component outputs the input payload as the output payload if no rows are retrieved; if any rows are found, it outputs nothing. With the content specified in the property, it searches the sensor DB and executes a filter expression for each matched…

File List

Action Configuration View » Action Components » File List

The File List Action Component is to get a list of files that match the pattern. Output payload Description cv.Payload Outputs the contents of the read directory as individual JSON objects. The contents of the directory will have…

Software Sensors

Introduction » What is Gravio? » Hub Configuration View » Device Tab » Software Sensors

Gravio also supports software sensors. An example for a software sensor could be a camera that detects how many people are in a room and triggers certain Actions if certain thresholds are reached. These sensors are created using software and artificial intelligence…