Tags Assets and Templates

Built-in Tag Types

FactoryStudio provides 13 built-in tag types, most of which are based directly on .NET datatypes. These are summarized in the following table. 

Decimal

The Decimal type allows calculation with higher precision than Double. However, math operations using Decimal can be 40 times slower than using Double. So the Decimal type should only be used when Double precision is not enough.

Timer

Timer is a built-in integer type that can be used to generate precise timing signals. Timers have the following varieties: 

• SquareWave:  the value toggles between 0 and 1.
• Pulse: the the tag changes to 0, then changes immediately to 1. 
• DelayOff: the tag behaves as a PLC Timer Off . During the runtime, if you set the tag with some value other than the StartValue, the tag will hold that value for the period specified in the Interval. The tag goes back to its StartValue after the period of time (Interval) 

• Comparer: the tag is set to 1 after the specified comparer Interval, and then goes back to zero at midnight . 

For the SquareWave, Pulse and Comparer, If you set the tag StartValue, the tag toggles between 0 and StartValue (instead of 0 and 1) . 

Reference

Reference Tags allows dynamic addressing of the variables. 

The concept is closer to the concept of References in .NET programming, more than the old C++ pointers. This is because Reference Tags, like .NET references, are typed; that means that when creating a Reference Tag, you need to define the type of the object the reference will be pointing to. Like .NET References and unlike C++ pointers, a Reference Tag cannot be defined to point to invalid memory areas that would cause errors in the application.

The target Type for Reference types is defined in the Parameters columns.

The use of typed references brings advantages both in Engineering and Runtime. In Engineering it allows Intellisense to directly browse the members of the template, when the reference is pointing to a template; In the runtime it allows string data validation.

All Reference Tags have an additional runtime attribute, the link, which specifies the tag that the reference will be linked to during execution.

Essentially the Link property is a string property that should receive the target tag name before using the reference tag. You can assign a string directly or by using a string expression, but the best way to set the Link property is to use the Method GetName(), which will create the string based on the current tag name. This way, you can rename the tag without having to search the strings. This also shows the tag names linked on the cross-reference utility. 

An example project (ReferenceTags) ships with FactoryStudio.

The reason for using the GetName() method instead of using strings directly, is that with GetName() you retain the benefits of Cross-Reference and Refactoring. 

Creating and Editing Tags

To create and edit tags:

• Go to Edit > Tags > Objects.
• To create a new tag, enter its name and other applicable properties in the blank top row (Insertion Row). To edit an existing row, select any item in the row and make the desired changes. Here is a complete table of available tag properties. Note that many of these properties are optional and only apply to specific kinds of tags.

The columns above are visible by default. To add or remove a column, right-click the column heading area and check or uncheck the columns that will be visible.

Continue adding as many tags as you need. 

Notes

You can also create a tag from anywhere in FactoryStudio by clicking New Tag in the toolbar.

Like any other configuration table, you can also import CSV files or copy/paste contents directly from an Excel spreadsheet or other applications. 

With FactoryStudio you can replace names at any time, so an easy way to create a tag is to click with the mouse on the Name column of the insertion row, then press space and enter. Each time, the system will create a Tag of the same type as the last one created. You can use the mouse on the insertion row to select the Type, then click with the mouse in the header or any other part of that grid. That will also create a tag with a default name. Also, you can configure more than one row at the same time, just select the rows with Shift button then right-click and select "Edit Combined Rows". A new popup will open with the rows' information. All settings changed in this window will change all rows selected. If a column has , it shows that this column has more than one configuration. 

Tag Formats

The format property defines the display format for tag values. These formats follow the specifications provided in Microsoft .NET. For valid numeric formats, refer to Standard Numeric Format Strings (http://msdn.microsoft.com/en-us/library/dwhawy9k%28v=VS.90%29.aspx). For example: N1 (number with 1 decimal place).

For valid date and time formats, refer to Standard Date and Time Format Strings (http://msdn.microsoft.com/en-us/library/az4se3k1%28v=VS.90%29.aspx). For example: d (short date).

For a more in-depth discussion of format strings, refer to Formatting Types (http://msdn.microsoft.com/en-us/library/fbxft59x%28v=VS.90%29.aspx).

Creating Templates

Templates let you create new tag types based on existing built-in types.

To create a tag template:

• Go to Edit > Tags > Templates.
• Click New.
• The Create New Tag Template dialog shows.
• In the New Type Name field, enter a name for the tag type. In the Description, enter a description of the tag. Click OK. The Templates tab displays with the name of the new template at the top of the tab.
• Click the insertion row to create a new attribute for this tag template.

• Enter or select information, as needed, all the properties are the same as in Tags  (see Creating and Editing Tags).

• To delete a template, select it from the User Custom Type drop-down list, then click Del.
• On the Objects tab, for new tags or existing ones, you can now use this new template in the Type column.

Assets and Categories

Assets

If you have the Enterprise version of FactoryStudio, assets let you configure additional metadata for your project. For example, you can organize objects in your project, such as tags, devices, and alarms, into a hierarchy. This lets you group tags that are related to each other. The hierarchy may reflect such things as areas of your manufacturing floor or the location of your machinery.

To create assets:

• Go to Edit > Tags > Assets.
• Right-click "Elements" and select New Level.
• Enter a name for the level.
• Right-click the new level and select Insert Asset.
• The Select Object window displays, with all objects, by type, on the left side.
• Select the object type from the left side and the object you want from the right side.
• Click OK.
• The object becomes a child of the selected level.
• Continue adding child or sibling levels and inserting assets, as needed.
• If needed, right-click a level to rename or delete, or right-click an asset to delete it.
• On the Objects tab, for new or existing tags, select the new level in the Level column.

Categories

If you have the Enterprise version of FactoryStudio, you can create user-defined categories of data that you can use as metadata for tags. Categories are useful for filtering, both when creating the project and during runtime.

To create categories:

• Go to Run > Dictionaries > Categories.
• Enter or edit the name and description for the category.
• Continue adding as many categories as you need.
• On the Tag -> Objects tab, for new or existing tags, select the new category in the Category column. Other Project elements can also use categories for project organization.

The Tag Namespace

All project tags are available to the runtime modules as .NET objects at the Tag Namespace. 

All Built-in Tag Types share a common set of properties and methods defined in the base class TagObj. The Tags created from user defined templates are implemented by the base class UserType. 

See "Namespaces" for the complete programming reference on runtime objects.