====== Actions ======

An //action// is a task to be performed by the ComfileHMI.  For example, when a button is pressed an action can be performed to store a value to a specific address in an attached PLC.  This is a single action.

A Multi-action performs multiple actions in sequence.  For example, when a button is pressed, a value can be written to a PLC, a record of the event can be written to a file, and the sound can be played.

The various types of actions available are shown below.

{{ :comfilehmi:multiaction:multiaction.png?nolink |}}

----

===== Write Directly =====

Literal values or variables can be written to a memory location in an attached external device ((A PLC or MCU connected to the ComfileHMI hardware)) or internal variable / internal memory.

{{ :comfilehmi:multiaction:multiaction1.png?nolink |}}

----

===== Read from Device =====

Data can be read from a memory location on an attached device and stored to a variable.

{{ :comfilehmi:multiaction:multiaction2.png?nolink |}}

----

===== Log to File =====

Information can be written to a log file. The following example illustrates writing a variable, //CurrentTemperature// to a log file named //log.txt// on the ComfileHMI's mciroSD card.

  * Be sure to specify the //Storage Card// folder.  The files will be stored on the ComfileHMI's microSD card.

{{ :comfilehmi:multiaction:multiaction3.png?nolink |}}

Text can be concatenated to form a single line in the log file.

{{ :comfilehmi:multiaction:multiaction4.png?nolink |}}

{{ :comfilehmi:multiaction:multiaction4_1.png?nolink |}}

The //Log to File// feature can also be used to make screen captures.

{{ :comfilehmi:multiaction:screen_capture.png |}}

==== Destination: Remote PC ====

Select this option to have the log data send to any Supervisory Remote Control clients that may be connected to the panel PC.  

{{ :comfilehmi:multiaction:sendtoremote.png?nolink |}}

==== Destination: Communication Channel ====

Select this option to have the log data transmitted out a serial port.  The serial port must be configured for the //USER > SERIAL TX// protocol in the //Project Properties//.

{{ :comfilehmi:multiaction:sendtoserial.png?nolink |}}

----

===== Manage Files =====

For creating, modifying or deleting files.

{{ :comfilehmi:multiaction:multiaction5.png?nolink |}}

----

===== Bulk Load/Store Variables =====

Variables can be loaded from or stored to a files on the ComfileHMI's mciroSD card.

{{ :comfilehmi:multiaction:multiaction6.png?nolink |}}

{{ :comfilehmi:multiaction:multiaction7.png?nolink |}}


----

===== Run Action Group =====

First, an action group must be registered and given a unique name.  In the illustration below the variable //ABC// will be initialized with the value 0.

{{ :comfilehmi:multiaction:makeactiongroup.mp4?900x542 |}}

Then the event can be used in a multi-action list.

{{ :comfilehmi:multiaction:userevent_define.png?nolink |}}

{{ :comfilehmi:multiaction:usereventrun.png?nolink |}}

Use the //Advanced Options// to configure repetition.

{{ :comfilehmi:multiaction:userevent3.png?nolink |}}

----

===== Stop Iterating Action Group =====

This action can be used to stop an action group that was specified to execute repeatedly.

{{ :comfilehmi:multiaction:usereventstop.png?nolink |}}

----

=====Sound Audio/Buzzer=====

Waterproof front-panel models can output audio in .wav file format. 

{{ :comfilehmi:multiaction:soundoutput.png?nolink |}}

Open-frame models have a piezo buzzer for sounding beeps.

{{ :comfilehmi:multiaction:buzzoutput.png?nolink |}}

----

===== Run Script =====

The //Run Script// action can be used to write a small script to be executed when a button is pressed.  These scripts can contain complex logic and expressions for reading and/or writing variables.  Expressions should be separated by semicolons.

{{ :comfilehmi:multiaction:scriptaction.png?nolink |}}

----

===== Open Dynamic Keypad =====

The //Keypad// action will display a keypad so an operator to enter numeric input.

{{ :comfilehmi:multiaction:keypadpopup.png?nolink |}}



----

===== Internal String Variable Control =====

This software provides various tools to edit Internal string variable.

{{ :comfilehmi:multiaction:stringcontrol.png?nolink |}}
----

===== HTTP Request =====

The HTTP Request action can be used to query the [[comfilehmi:web_api:index|Web API]] of another ComfileHMI panel PC.

{{ :comfilehmi:multiaction:httprequest.png }}

1.  HTTP query (URL)

2.  Action to be executed when a response to the query is received.

----

===== Special Feature : System Settings =====

For modifying the date and time, or running a touchscreen calibration.

{{ :comfilehmi:multiaction:multiaction7_1.png?nolink |}}

===== Special Feature : Alarm History Viewer =====

Various tools are provided to edit alarm-history-viewer.

{{ :comfilehmi:multiaction:alramcontrol.png?nolink |}}

----

====== Multi-action Conditional Activation =======

An action can be activated dynamically by specifying a conditional expression.

{{ :comfilehmi:multiaction:actioncondition.png?nolink |}}

So, this action is only executed if the condition is satisfied.

{{ :comfilehmi:multiaction:actioncondition2.png?nolink |}}


[[comfilehmi:index#widgets| Back to ComfileHMI]]