Add support for WITH DATA_CATEGORY in SOQL and update sidebar positions for documentation

Signed-off-by: Piotr PG Gajek <[email protected]>

Author: pgajek2

website/docs/api/standard-soql/soql-data-category-filter.md

@@ -0,0 +1,232 @@
+---
+sidebar_position: 90
+---
+
+# DataCategoryFilter
+
+Specify and adjust single condition.
+
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .aboveOrBelow('Europe__c')
+    ).toList();
+```
+
+## Methods
+
+The following are methods for `DataCategory Filter`.
+
+[**FIELDS**](#fields)
+
+- [`with(String field)`](#with-string-field)
+
+[**COMPERATORS**](#comperators)
+
+- [`at()`](#at)
+- [`above()`](#above)
+- [`below()`](#below)
+- [`aboveOrBelow()`](#aboveorbelow)
+
+## FIELDS
+### with
+
+**Signature**
+
+```apex
+DataCategoryFilter with(String field);
+```
+
+**Example**
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c ABOVE_OR_BELOW Europe__c
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .aboveOrBelow('Europe__c')
+    ).toList();
+```
+
+## COMPERATORS
+
+### at
+
+- `WITH DATA CATEGORY Geography__c AT Europe__c`
+
+**Signature**
+
+```apex
+DataCategoryFilter at(String category);
+DataCategoryFilter at(Iterable<String> categories);
+```
+
+**Example**
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c AT Europe__c
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .at('Europe__c')
+    ).toList();
+```
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c AT (Europe__c, North_America__c)
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .at(new List<String>{ 'Europe__c', 'North_America__c' })
+    ).toList();
+```
+
+### above
+
+- `WITH DATA CATEGORY Geography__c ABOVE Europe__c`
+
+**Signature**
+
+```apex
+DataCategoryFilter above(String category);
+DataCategoryFilter above(Iterable<String> categories);
+```
+
+**Example**
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c ABOVE Europe__c
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .above('Europe__c')
+    ).toList();
+```
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c ABOVE (Europe__c, North_America__c)
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .above(new List<String>{ 'Europe__c', 'North_America__c' })
+    ).toList();
+```
+
+### below
+
+- `WITH DATA CATEGORY Geography__c BELOW Europe__c`
+
+**Signature**
+
+```apex
+DataCategoryFilter below(String category);
+DataCategoryFilter below(Iterable<String> categories);
+```
+
+**Example**
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c BELOW Europe__c
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .below('Europe__c')
+    ).toList();
+```
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c BELOW (Europe__c, North_America__c)
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .below(new List<String>{ 'Europe__c', 'North_America__c' })
+    ).toList();
+```
+
+### aboveOrBelow
+
+- `WITH DATA CATEGORY Geography__c ABOVE_OR_BELOW Europe__c`
+
+**Signature**
+
+```apex
+DataCategoryFilter aboveOrBelow(String category);
+DataCategoryFilter aboveOrBelow(Iterable<String> categories);
+```
+
+**Example**
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c ABOVE_OR_BELOW Europe__c
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .aboveOrBelow('Europe__c')
+    ).toList();
+```
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c ABOVE_OR_BELOW (Europe__c, North_America__c)
+```
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(
+        SOQL.DataCategoryFilter
+            .with('Geography__c')
+            .aboveOrBelow(new List<String>{ 'Europe__c', 'North_America__c' })
+    ).toList();
+```

website/docs/api/standard-soql/soql.md

@@ -115,6 +115,10 @@ The following are methods for using `SOQL`:
 - [`groupByCube(SObjectField field)`](#groupbycube)
 - [`groupByCube(String relationshipName, SObjectField field)`](#groupbycube-related)
 
+[**WITH DATA_CATEGORY**]
+
+- [`withDataCategory(DataCategoryFilter dataCategoryFilter)`](#with-data_category)
+
 [**HAVING**](#having)
 
 - [`have(HavingFilterGroup filterGroup)`](#have)
@@ -1475,6 +1479,31 @@ SOQL.of(Lead.SObjectType)
     .toAggregated();
 ```
 
+## WITH DATA_CATEGORY
+
+For more details check [SOQL.DataCategoryFilter](#soql-data-category-filter.md).
+
+**Signature**
+
+```apex
+ Queryable withDataCategory(DataCategoryFilter dataCategoryFilter);
+```
+
+**Example**
+
+```sql
+SELECT Id, Title
+FROM Knowledge__kav
+WITH DATA CATEGORY Geography__c AT (Europe__c, North_America__c)
+```
+
+```apex
+SOQL.of(Knowledge__kav.SObjectType)
+    .with(Knowledge__kav.Id, Knowledge__kav.Title)
+    .withDataCategory(SOQL.DataCategoryFilter.with('Geography__c').at(new List<String>{ 'Europe__c', 'North_America__c' }))
+    .toList();
+```
+
 ## HAVING
 
 ### have

website/docs/examples/standard-soql/aggregate-functions.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 30
 ---
 
 # AGGREGATE FUNCTIONS

website/docs/examples/standard-soql/debug.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 14
+sidebar_position: 140
 ---
 
 # DEBUGGING

website/docs/examples/standard-soql/fls.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 11
+sidebar_position: 110
 ---
 
 # FIELD-LEVEL SECURITY

website/docs/examples/standard-soql/group-by.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 7
+sidebar_position: 70
 ---
 
 # GROUP BY

website/docs/examples/standard-soql/limit.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 9
+sidebar_position: 90
 ---
 
 # LIMIT

website/docs/examples/standard-soql/mocking.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 13
+sidebar_position: 130
 ---
 
 # MOCKING

website/docs/examples/standard-soql/order-by.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 8
+sidebar_position: 80
 ---
 
 # ORDER BY

website/docs/examples/standard-soql/result.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 15
+sidebar_position: 150
 ---
 
 # RESULT