Tag Group Editor

-Mike Kirk

 

All you need to know to install the Tag Group Editor is found at:

http://www.intellution.com/products/fixdynamics/tge_details.asp

To fully utilize Tag Groups you need to create an actual tag group, call the tag group from a control picture and receive the tag group in the picture you want to open. It's easiest to create the Tag Groups first.

To open a Tag Group Editor file, click on the right button in the Tag Group toolbox. In my case I wanted to use the same picture of a power supply for multiple identical power supplies. Thus I created a SEPERATE tag group for each power supply (PS1_taggroup.tge, PS2_taggroup.tge, PS3_taggroup.tge ...). In each of these tag groups use the SAME symbols:

file = PS#_taggroup.tge

Symbol Substitution Description

-----------------------------------------------------------------------

1.| Voltage#1

2.| Voltage#2

3.| Voltage#3

| .

| .

| .

For each tag group add the specific tagname into the substitution column. For example, for the PS1_taggroup.tge tag group file above, add the tags that correspond to PowerSuppply#1.

file = PS1_taggroup.tge

Symbol Substitution Description

-----------------------------------------------------------------------

1.| Voltage#1 PS#1_Voltage#1.F_CV

2.| Voltage#2 PS#1_Voltage#2.F_CV

3.| Voltage#3 PS#1_Voltage#3.F_CV

| .

| .

| .

You do not have to type in the entire tagname (i.e. Node.Tag.Field). Just type the tagname and click the 'Get Full Name' button to the right of the 'substitution' column. The entire path to the tag should appear. Repeat this for each Tag Group (The only difference in these files is the tag, which is substituted).

file = PS2_taggroup.tge

Symbol Substitution Description

------------------------------------------------------------------------

1.| Voltage#1 PS#2_Voltage#1.F_CV

2.| Voltage#2 PS#2_Voltage#2.F_CV

3.| Voltage#3 PS#2_Voltage#3.F_CV

Once the tag groups are created, open the picture (ControlPicture.grf) you will use as the 'control' picture. For example, this picture might contain shapes corresponding to each power supply mentioned above. When one of these shapes is clicked a new picture (NewPicture.grf) will open with the corresponding tag group substitution.

Insert a button or shape onto the picture (ControlPicture.grf) and edit the script of that object. The general syntax of the script for opening a new picture or replacing the current picture with a tag group substitution is:

Private Sub OpenNewPicture_Click()

OpenTgePicture "NewPicture.grf", "", "", "", "TagGroup.tge" End Sub

*****Note: You do not need to specify the control picture when using

the 'OpenTgePicture' command.

and

Private Sub ReplacewithNewPicture_Click()

ReplaceTgePicture "NewPicture.grf", "TagGroup.tge", "ControlPicture.grf" End Sub

These commands will be repeated for every shape you add, but the TagGroup.tge file name will change corresponding to the tags you want to substitute.

These subroutines do not have to be typed in explicitly. It's easiest to use the Tag Group Editor Toolbox. The left button will write the ReplaceTgePicture routine and the middle button will write the OpenNewPicture routine. You will be prompted for the picture to open, the picture to replace and the Tag group to apply.

To complete the setup of the Tag Group editor, open the picture that you will apply the Tag Group file to ('NewPicture.grf' in the above syntax). You can enter tag group symbols in a picture for various data sources. Such as Datalinks, Text Object captions and Pen data sources. You must precede the symbol used with a '@' and follow the symbol with a '@'. For example, to use the Voltage#1 symbol above, type @Voltage#1@ in the data source.

For more specific on possible data sources and partial substitution see the Tag Group Editor Help files.

------------------------------------------------------------------------------

Mike Kirk : Brandeis University MS 318 CDF/Brandeis

Office Phone : 630-840-4341 PO Box 500, Fermilab

Office # : 145 Batavia, IL 60510

------------------------------------------------------------------------------