Syntax

   FACTORY_DEF <ReaderKeyword> TestFactory
   [FACTORY_NAME <factory name>]
   [INPUT FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*
   [TEST <value> <operator> <value> [ENCODED]]+
   [STRING_TEST <value> <operator> <value> [ENCODED]]+
   [BOOLEAN_OPERATOR (AND|OR)]
   [OUTPUT(PASSED|FAILED) FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*

Overview

   This factory takes a feature and performs the tests defined by the TEST 
   clauses. If the result of the tests is true, then the feature will be output 
   using the PASSED tag. If the result is false, then the feature will be output 
   by the FAILED tag. 

   If the PASSED clause is not specified, then features that pass the test will 
   be destroyed. If the FAILED clause is not specified, then features that fail 
   the test will be destroyed. Either PASSED or FAILED must be present.

   The <operator> is one of <, >, =, ==, !=, >=, or <=.

   The <value> may be a literal constant, an attribute name preceded by the 
   value-of operator (&), or an attribute value function. If it is an attribute 
   value function, the function will be executed on the current feature and the 
   result will be used for the test.

   If the keyword ENCODED is included with any test, then that test's
   <value>s are expected to be WWJD-encoded, and will be decoded prior
   to test execution.

   Example TEST clauses include:

      TEST @Area() < 100
      TEST &numLanes > 2
      STRING_TEST "Joe" = "Jerry"

   At run-time the TestFactory decides to invoke numeric comparisons or string 
   comparisons, as greater than and less than, that have different meanings 
   depending on the type of operands. If both arguments may be converted to 
   numbers, then numeric comparisons will be used; otherwise, string comparisons 
   will be used.

   If multiple TEST or STRING_TEST clauses are present, the test will only pass 
   if all of the TESTs are true, unless the BOOLEAN_OPERATOR OR clause is 
   specified. (By default, the Boolean clause used between multiple tests is 
   AND.) The STRING_TEST clause forces string comparison of the equation, and 
   the TEST clause (which is the default) indicates that a basic evaluation of 
   the tests is performed.

      Note: You cannot directly test for the value of TEST. However, you can 
      perform the test by following the steps below: 

         In Workbench, use an AttributeCreator to add a new attribute, and set its 
         value to TEST. 
   
         Use the value of the new attribute to test against.

Output Tags

   The TestFactory supports the following output tags.
   
   PASSED   
   
      Applied to features where the TEST clause is true.

   FAILED   
   
      Applied to features where the TEST clause is false.