TagDirectWriteString Function

Help Contents

Introduction

Writes a string value directly to an address in a data source. Uses the DirectWriteString Tag Command.

Functions and Function Blocks

The TagDirectWriteString Function is intended for use in an Operator Action. Operator Actions run in response to user input gestures in the Operator Interface. In an Operator Action, code execution is suspended until the function completes.

If you want to write a value from a Program Tag, running on the SCADA Server, use the TagDirectWriteStringFB Function Block.

Syntax

Informal Syntax:

TagDirectWriteString( TagName, DataAddress, Value )

Formal Syntax:

TagDirectWriteString( 
        TagName:=Expression, 
        DataAddress:=Expression, 
        Value:=Expression )

Parameters

Parameter Type Description
TagName ANY_STRING The full name of the tag that represents the data source.
DataAddress ANY_STRING The "Address" of the data within the data source. See Data Address Format to understand how to set the "Address".
Value ANY_STRING The value to write to the data source.

Remarks

The TagDirectWriteString Function sends the DirectWriteString Tag Command to the database tag.

Return Value

None.

Examples

Sends the DirectWriteString Tag Command to the tag "MQTT Connection" to write a string value to address "TopicPath/ControlItem".

TagDirectWriteString( "MQTT Connection", "TopicPath/ControlItem", "{ $"State$" : $"On$" }" );

Further Information

DirectWriteString Tag Command

To learn about the DirectWriteString Tag Command.

TagDirectWriteStringFB Function Block

To learn how to write a bit directly to a data source from a Program Tag.

Operator Actions

To learn where you can use this function.

Structured Text Function Call

To learn about calling a function from IEC 61131-3 structured text.

IEC 61131-3 Expressions

To learn about the different types of expression to use as function parameters.

Glossary

For the meaning of terms used in Fernhill SCADA.