OpenTagFile Function

Help Contents

Introduction

Displays a file associated with a tag.

Informal Syntax:

OpenTagFile( TagName, FileType )

Formal Syntax:

OpenTagFile( TagName:=Expression, FileType:=Expression )

Parameters

ParameterTypeDescription
TagName ANY_STRING The name of the tag to open the file for. The name can be the full name of the tag or a relative tag name.
FileType ANY_STRING The type of file to open.
The FileType parameter can be one of the following values:
  • "Graphic" - opens a graphic page
  • "Trend" - opens a trend

The OpenTagFile function displays the specified Tag File. The exact behaviour varies according to the context:

If the OpenTagFile call is made from a Graphic Page Tag you can specify a relative tag name for the TagName parameter. A relative tag name specifies a name relative to the host document. For more information on how relative names are resolved see Tag References.

A program or script will not execute any statements after the OpenTagFile call.

Return value

None.

Examples

Displays the trend page 'Storage.TankLevel':

OpenTagFile( "Storage.TankLevel" );

Further Information

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.