RUAL Core v14.0.1
Our platform operates on software, commonly known as core. This software can be run either locally within the cloud environment of Enterprise Customers or within our AWS cluster.
Modified or newly introduced blocks
In this release 46 blocks have been modified and 38 new blocks were introduced. You'll find a complete list of blocks at the bottom of this page.
Speed Improvement
This release delivers significant performance enhancements, improving block execution speed by 70% across all block types. Production blueprints now execute up to 150% faster, with performance gains scaling based on blueprint complexity and size.
Robot Automation - Dobot Integration
New Dobot Robot Control Blocks:
- Introduce
dobotconnection_openfor establishing robot connections. - Add
dobotconnection_get_statusanddobotconnection_get_serialfor robot monitoring. - Introduce movement controls with
dobotconnection_update_joganddobotconnection_move_joint. - Add coordinate system support with
dobotconnection_get_coordinate_system,dobotconnection_get_joints, anddobotconnection_get_joints_cartesian. - Introduce robot control with
dobotconnection_enableanddobotconnection_disable. - Add speed management with
dobotconnection_get_speedanddobotconnection_set_speed. - Introduce alarm handling with
dobotconnection_clear_alarms. - Add advanced tooling with
dobotconnection_tool_set_dh_gripper,dobotconnection_tool_set_dh_gripper_width, anddobotconnection_rel_move_joint_user. - Introduce
dobotconnection_set_digital_outputanddobotconnection_move_toolhead.
Data Types and Processing
Float Data Type Support:
- Introduce new "float" data type for enhanced numerical precision.
- Add
float_parsefloat,float_min, andfloat_plusblocks.
Number Processing Enhancements:
- Improve
number_to_hexfunctionality. - Introduce
number_pad_endfor number formatting.
Array Operations:
- Add
array_findfor array searching capabilities. - Add fallback support for
array_remove_at_indexandarray_remove_at_indexes.
Shipping and Logistics
PostNL Integration:
- Improve
postnlconnection_barcode_statusoutput with enhanced status reporting.
Business Validation
VAT and Company Information:
- Upgrade
function_validate_vatto include company name and address data.
File Processing
CSV and File Operations:
- Improve
file_parse_csvwith enhanced separator detection. - Add fallback support for
file_update_name.
State Management and UI
Advanced State Controls:
- Introduce
statedatatablefilter_query_dynamicfor dynamic filtering. - Introduce
state_inline_function_executefor inline function execution. - Add UI Event support for
state_div.
Component Improvements:
- Update file output pin for
state_form_get. - Add top pagination option to
state_advanced_datatable. - Add datatable column filter support.
- Add header filter onChange support to
state_advanced_datatable. - Add active sort class on page load for
component_datatable. - Add storage pin to
state_advanced_datatable.
System Improvements
Performance and Infrastructure:
- Introduce new cluster statistics and monitoring capabilities.
- Add bandwidth statistics reliability improvements.
- Improve VM statistics and disk/database statistics.
- Introduce upgrade service for updating nodes from within the UI.
- Expose RUAL as system service.
- Add block analytics for improved search functionality.
- Improve HTTP traffic logging with configurable retention.
- Add support for precompiled execute functions for faster execution.
- Significant speed improvements on function executions and state callbacks.
- Improve initial state page rendering speed.
Security and Package Updates:
- Security package upgrades and vulnerability fixes.
- Update GitHub and JSDOM packages for security compliance.
- Remove hardware ID dependency for improved security.
- Add timeout support for HTTP requests.
Deprecations
Deprecated Blocks and Features:
- Deprecate scraper blocks.
- Deprecate
condition_vat_valid(replaced by enhancedfunction_validate_vat). - Deprecate
function_chatgpt_completions(API can be used directly). - Deprecate SSH blocks.
- Deprecate
date_get_week_of_year_locale. - Deprecate old healthcheck APIs.
- Deprecate blueprint session APIs.
- Deprecate
date_out_pin_reference.
API Enhancements
New API Endpoints:
- Introduce new Blueprint Actions Multi GET API endpoint.
- Add new cache management APIs for memory inspection.
- Introduce new robot pose API for Visual Flow Editor.
- Add new cluster stats data API endpoint exposing raw statistics.
- Add v2 token support for enhanced authentication.
Blocks introduced
backend requeststate
Requests the backend for data that can be used in the state flow
clear alarms dobotconnection
Clears all the active alarms on the machine
close connection dobotconnection
closes the active connection with the machine, freeing up the occupied connection.
core version value
Returns the current RUAL Core version
define number float
Store this float as reference, which can later be used by "use reference"
disable dobotconnection
Disables the machine
dynamic query filter statedatatablefilter
Creates a dynamic filter using a query
enable dobotconnection
Enables the machine
enable dh gripper dobotconnection
Enables the end tool to be compatible with the DH Robotics Grippers
execute state
Executes the given funcion and waits for it to be executed.
find array
The first element in the array that satisfies the provided testing function.
get coordinate systems dobotconnection
grabs the current coordinate systems from the machine
get coordinates dobotconnection
grabs the current joints cartesian coordinates of the machine. When you're using a 4 joint machine, the last 2 joints will be ignored.
get serial dobotconnection
grabs the current serial of the machine.
get speed dobotconnection
grabs the current speed of the machine.
get status dobotconnection
grabs the current status of the machine.
line stop float
gives you the option to position lines better to have an nicer and a more cleanded up Blueprint.
local devices dobotconnection
Retrieves the local devices and their connection information
move to safe point dobotconnection
Moves the machine to the preconfigured safe home position at the current speed
on blur stateevents
Triggers the event everytime the blur event has been registered on the UI for the connected element
on change stateevents
Triggers the event everytime a change has been registered within the UI for the connected element. Primarily used with input elements.
on click stateevents
Triggers the event everytime a left click has been registered within the UI for the connected element
on focus stateevents
Triggers the event everytime the focus event has been registered on the UI for the connected element
on key enter stateevents
Triggers the event everytime the enter key has been registered within the UI for the connected element
on rightclick stateevents
Triggers the event everytime a right click has been registered within the UI for the connected element
open connection dobotconnection
Opens a new dobot connection, make sure to close it. A machine only allows a single active automation.
pad end number
Pads the given number with char. on the right to match the given length.
return state state
Returns a reactive state element from events
set coordinates dobotconnection
Moves the machine into the given coords using joint motion. When you're using a 4 joint machine, the last 2 joints will be ignored.
set digital output dobotconnection
Updates the machines digital output so the given status, can be queued by time range in milliseconds
set relative movement dobotconnection
Moves the machines joint motion relative to the current coords. When you're using a 4 joint machine, the last 2 joints will be ignored.
set speed dobotconnection
Updates the speed in percentage of your machine, some machines allow values in excess of 100%
set toolhead dobotconnection
Moves the machines toolhead into the given coords using joint motion, only works on 6 axis machines
set width dobotconnection
Updates the width of the DH Robotics gripper
start drag dobotconnection
enables drag mode on the robot arm, allowing you to move it by hand and recording or savings positions
stop drag dobotconnection
disables drag mode on the robot arm
update jog dobotconnection
Moves the machine in the given direction relative to the current position. When you're using a 4 joint machine, the last 2 joints will be ignored. JOG is updated in teaching mode, at slower speeds thus.
use number float
Use the float which was previously defined by a define reference
Blocks modified
advanced datatablestate
A pre-styled advanced table showing data using advanced tooling
button state
Generates a basic html button element with default styling.
button with text and icon state
Generates a basic html button element with default styling.
create twinfieldconnection
generates a new invoice in the twinfield classic invoicing.
create soap connection function
Builds a soap connection from the provided WSDL
create/update twinfieldconnection
creates a new journal transaction or updates existing ones. See Twinfield Docs for a full description.
decode value
takes a string representation of 1+ coordinate pairs and returns an array of lat, lon arrays.
difference to mutations mutations
generates an array of mutations of the different between two objects.
div state
Creates a dynamic and customizable div element on your web page.
download function
download a custom file
encode array
Takes an array of lat, lon arrays and returns an encoded string.
function write array to file soapconnection
Writes the incoming soap stream to a file. The selected key needs to be an array so the file can be streamed later on
generate shipment label postnlconnection
This block is used to request the status for a barcode.
get all twinfieldconnection
gets all the offices available within the current verified user.
get barcode status postnlconnection
This block is used to request the status for a barcode.
if twinfield
condition based splitting, in case of multiple twinfield connections are required in different situations.
input state
Generates a basic input. The field will be used as state key, prefixed with the form.
last request info soapconnection
Exposes extra information about the last function request on this WSDL, allow proper debugging
match twinfieldconnection
matches two twinfield transactions. See Twinfield Docs for a full description.
number input state
Generates a number input. The field will be used as state key.
oki file printer function
Sends print file to a local OKI printer for processing
open connection function
Connects using oAuth 2.0 with your secured Twinfield environment.
open connection androidconnection
Opens Android Push Notifications connection
pad end value
Pads the given value with char. on the right to match the given length.
pad start value
Pads the given value with char. on the left to match the given length.
pad start number
Pads the given number with char. on the left to match the given length.
parse csv file
Parse a CSV file into an array of objects.
read twinfieldconnection
reads a given journal transaction from twinfield.
read twinfieldconnection
reads the sales invoice of supplied invoice type and invoice number.
request: delete function
null
request: delete json function
null
request: get function
null
request: get json function
null
request: head function
The HEAD HTTP method requests the metadata of a resource in the form of headers that the server would have sent if the GET method was used instead.
request: patch json function
null
request: post form-data function
null
request: post json function
null
request: post value function
null
request: put json function
null
request: put value function
null
select state
Generates a basic select. The field will be used as state key.
send simple notification androidconnection
Sends simple notification with basic options
soap function soapconnection
Requests the given function from the original WSDL
soap function streaming soapconnection
Streams the output of the given function using the original WSDL
validate vat function
Request VAT code validation using the ec.europa.eu API, allowing you to validate VAT numbers of your customers
verify purchase androidconnection
Verifies an in app purchase
Blocks deprecated
autocomplete filterstatedatatablefilter
null
best match array
returns an array of best matching values in this array of values.
close connection function
close ssh connection
compare two number
Returns a score based of the similarity of two values.
completions function
Chat models take a list of messages as input and return a model-generated message as output.
define reference date
Allows you to define a reference for your date value, which can be used consistently throughout your blueprint.
exec sshconnection
null
get current user googleconnection
null
get location googleconnection
null
get real time data googleconnection
null
get review googleconnection
null
get shortest distance function
null
get shortest path function
null
get shortest visiting path function
null
inline css value
null
list accounts googleconnection
null
list attributes googleconnection
null
list media googleconnection
null
list reviews googleconnection
null
open connection function
null
open connection function
open ssh connection
range filter statedatatablefilter
null
remove review reply googleconnection
null
reply to a review googleconnection
null
select filter statedatatablefilter
null
set attributes googleconnection
null
upload media googleconnection
null
validate vat condition
Checks if a VAT is valid.
value filter statedatatablefilter
null