system.tag.write

Description

Writes a value to a tag. Note that this function writes asynchronously. This means that the function does not wait for the write to occur before returning - the write occurs sometime later on a different thread.

Syntax

system.tag.write(tagPath, value, suppressErrors)

Parameters

String tagPath - The path of the tag to write to.

Object value - The value to write.

Boolean suppressErrors - A flag indicating whether or not to suppress errors. (optional, client-only).

Returns

int - 0 if the write failed immediately, 1 if it succeeded immediately, and 2 if it is pending.

Scope

All

Examples

This code would go on a property change event for a numeric text field to calculate and write a value to a tag.

if event.propertyName == intValue:

 calcValue = event.newValue * 2.5

 system.tag.write("Tanks/tankHiSP",calcValue)