Record Definition

Field Number

Number for each field:

1:

Field Name

Field Name inserted between quotation marks " ". This is the word that appears between the percentage marks in the Genie. For example, %Tag%.

1: "Tag"

Field Size

Variable tags may be up to 79 characters in length. However, for display purposes it may be desirable to display fewer characters on the form field.

1: "Tag", 32

Write Access

The two options for this are readwrite and readonly.

1: "Tag", 32, readwrite

List Form

The next field identifies the project database name, as defined in BIN\citect.frm, which contains the options to go into the list. The name of the list form needs to have quotation marks.

1: "Tag", 32, readwrite, "Variable Tags"

List Field

This field contains the values that will appear in the dropdown list. It also needs to be specified within quotation marks.

1: "Tag", 32, readwrite, "Variable Tags", "NAME"

List Filter

This is the format of the List Filter

<field> = <filtertext>, where:

<field> is the field name to filter by. This defaults to the field name specified as the List Field, so <field> = may be left out if filtering by the List Field.

<filtertext> is the text to search for in the field. Only records that have the specified filter text in the specified field will be added to the dropdown list.

A Type filter could be used for a Genie that is an on/off switch and will only apply to digital tags. If this is the case, the filter would be TYPE=DIGITAL.

1: "Tag", 32, readwrite, "Variable Tags", "NAME", "TYPE=DIGITAL";

If the list is going to be filtered on an extension, a wildcard (*) is used. For example, to list only the _CMD tags:

1: "Tag", 32, readwrite, "Variable Tags", "NAME", "*_CMD";

When a list is filtered this way, the dropdown list will remove the filter characters, that is, _CMD, from the end of the tag name. This is desirable when using structured tag names as the Genie will probably add the extension.

It is also possible to filter for both type and extension.The following example shows a list that filters for an INTEGER type and a _CMD extension :

1: "Tag", 32, readwrite, "Variable Tags", "NAME", "TYPE=INT, NAME=*_CMD";