TQL name: Difference between revisions

From Tygron Support wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{stub}}
A [[TQL]] name is a name which fits a specific set of restrictions, allowing it to be used unambiguously in [[TQL|TQL queries]]. [[Attribute]]s and [[Global]]s must always have a name conforming to those restrictions, because queries use those names verbatim.
A [[TQL]] name is a name which fits a specific set of restrictions, allowing it to be used unambiguously in [[TQL|TQL queries]]. [[Attribute]]s and [[Global]]s must always have a name conforming to those restrictions, because queries use those names verbatim.


Line 6: Line 4:
The following restrictions apply:
The following restrictions apply:
* Must be entirely capitalized, to avoid ambiguity.
* Must be entirely capitalized, to avoid ambiguity.
* May only consist of letters, numbers, and underscores, to avoid issues with special characters
* May only consist of letters, numbers, and underscores, to avoid issues with special characters.
* May not contain the word AND or WHERE, with an underscore directly before or after it, to avoid ambiguity when determining discrete clauses. The following examples are not allowed:
* Must begin with a letter. Explicitly not a number or underscore.
** _AND
* Must be at least 1 and at most 100 characters long.
** AND_
* May not contain any of the following _AND, _WHERE
** FOO_ANDS
* May not start with any of the following XML, AND_, WHERE_
** WHERE_
* May not end with an underscore.
** WHERE_FOO
 
==Forbidden Examples==
The following examples are not allowed:
* AND
* _AND
* AND_
* FOO_ANDS
* WHERE_
* WHERE_FOO
 
{{article end
|api=
* [[Update global attribute (TQL)]]
* [[Select global (TQL)]]
}}

Latest revision as of 11:12, 15 July 2026

A TQL name is a name which fits a specific set of restrictions, allowing it to be used unambiguously in TQL queries. Attributes and Globals must always have a name conforming to those restrictions, because queries use those names verbatim.

Restrictions

The following restrictions apply:

  • Must be entirely capitalized, to avoid ambiguity.
  • May only consist of letters, numbers, and underscores, to avoid issues with special characters.
  • Must begin with a letter. Explicitly not a number or underscore.
  • Must be at least 1 and at most 100 characters long.
  • May not contain any of the following _AND, _WHERE
  • May not start with any of the following XML, AND_, WHERE_
  • May not end with an underscore.

Forbidden Examples

The following examples are not allowed:

  • AND
  • _AND
  • AND_
  • FOO_ANDS
  • WHERE_
  • WHERE_FOO