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

Code Examples

Code Snippet

#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)