docs/8.0/ayanova/docs/ay-start-common-controls.md

@@ -28,3 +28,33 @@ todo: DATA TABLES
 	making equals or not equals useless for exact comparison.  In addition these types of fields always have a value even if it's zero so they don't work with Has value / no Value either
 	Greater than and less than can be used to match any value desired by using two filters one greater one less and use of the OR or AND option as appropriate
 
+	
+	## Data Table TAG filters
+	
+	All tags are lower case always, case is not relevant in Tag filters.
+
+	Order is not relevant in Tag filters, so {green, red} is no different than {red, green} when filtering is applied
+
+	### Filter types supported
+
+	#### Equality
+	Exactly equal compare entire search term array to tag array in db - all terms in search exactly present and no others in db record
+	e.g. {red,green,blue} will return records with tags {green,red,blue}  but *not* match {red,green,blue,orange}
+
+	#### Not equal
+	The opposite of Equality; specifically exclude rows that exactly match all the search terms
+	e.g. {red,green,blue} will return records with tags {red,green,blue,orange} but *not* match {green,red,blue}  
+
+	#### NO value
+	Will return records with no tags set at all
+
+	#### Has value
+	Will return records with any tag set
+
+	#### Contains
+	Returns records that contain the specified search tags. Records may have other additional tags but that's ok as long as it has the search term ones 
+	e.g. {red,green,blue} will return records with tags {green,red,blue} and also {red,green,blue,orange}
+
+	#### Not contains
+	All terms in search query *NOT* present in db record, don't care what else is in db record as long as it's not the search terms (order insensitive)
+	e.g. {red,green,blue} will not return records with tags {green,red,blue} and also not return {red,green,blue,orange} but would return {red,green,black}