OpenTagFile Function

Help Contents

Introduction

Displays a file associated with a tag.

Syntax

Informal Syntax:

OpenTagFile( TagName, FileType )

Formal Syntax:

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

Parameters

Parameter	Type	Description
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 a Tag File. The exact behavior varies according to the context:

In the Graphic Editor, the function opens the tag file in a new tab.
In the Operator Interface, the function changes the current page to the tag file.

If the OpenTagFile call is made from a Graphic Page Tag you can use a relative tag name for the TagName parameter. A relative tag name is 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 plot 'Storage.TankLevel':

OpenTagFile( "Storage.TankLevel", "Trend" );

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.