documentation

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

Author: pgajek2

force-app/main/default/classes/main/standard-soql/SOQL.cls

@@ -101,9 +101,9 @@ public virtual inherited sharing class SOQL implements Queryable {
         Queryable havingConditionLogic(String havingConditionsOrder);
         Queryable anyHavingConditionMatching();
         // ORDER BY
+        Queryable orderBy(SObjectField field);
         Queryable orderBy(String field);
         Queryable orderBy(String field, String direction);
-        Queryable orderBy(SObjectField field);
         Queryable orderBy(String relationshipName, SObjectField field);
         Queryable sortDesc();
         Queryable nullsLast();

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

@@ -24,6 +24,8 @@ The following are methods for `FilterGroup`.
 - [`add(FilterGroup filterGroup)`](#add)
 - [`add(Filter filter)`](#add)
 - [`add(String dynamicCondition)`](#add)
+- [`add(List<Filter> filters)`](#add)
+- [`add(List<String> dynamicConditions)`](#add)
 
 [**ORDER**](#order)
 
@@ -46,6 +48,8 @@ Add a [`SOQL.Filter`](soql-filter.md) or [`SOQL.FilterGroup`](soql-filters-group
 FilterGroup add(FilterGroup filterGroup)
 FilterGroup add(Filter filter)
 FilterGroup add(String dynamicCondition)
+FilterGroup add(List<Filter> filters)
+FilterGroup add(List<String> dynamicConditions)
 ```
 
 **Example**
@@ -90,6 +94,30 @@ SOQL.of(Account.SObjectType)
     ).toList();
 ```
 
+```apex
+// SELECT Id FROM Account WHERE (Name = 'Test' AND BillingCity = 'Krakow')
+
+SOQL.of(Account.SObjectType)
+    .whereAre(SOQL.FilterGroup
+        .add(new List<SOQL.Filter> {
+            SOQL.Filter.with(Account.Name).equal('Test'),
+            SOQL.Filter.with(Account.BillingCity).equal('Krakow')
+        })
+    ).toList();
+```
+
+```apex
+// SELECT Id FROM Account WHERE (Name = 'Test' AND BillingCity = 'Krakow')
+
+SOQL.of(Account.SObjectType)
+    .whereAre(SOQL.FilterGroup
+        .add(new List<String> {
+            'Name = \'Test\'',
+            'BillingCity = \'Krakow\''
+        })
+    ).toList();
+```
+
 ## ORDER
 ### conditionLogic
 

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

@@ -31,6 +31,7 @@ The following are methods for `SubQuery`.
 - [`with(SObjectField field1, SObjectField field2, SObjectField field3, SObjectField field4, SObjectField field5)`](#with-field1---field5)
 - [`with(List<SObjectField> fields)`](#with-fields)
 - [`with(String relationshipName, Iterable<SObjectField> fields)`](#with-related-fields)
+- [`with(String fields)`](#with-string-fields)
 
 [**SUBQUERY**](#sub-query)
 
@@ -44,6 +45,8 @@ The following are methods for `SubQuery`.
 [**ORDER BY**](#order-by)
 
 - [`orderBy(SObjectField field)`](#order-by)
+- [`orderBy(String field)`](#order-by-string-fields)
+- [`orderBy(String field, String direction)`](#orderby-string-fields-with-direction)
 - [`orderBy(String relationshipName, SObjectField field)`](#orderby-related)
 - [`sortDesc()`](#sortdesc)
 - [`nullsLast()`](#nullslast)
@@ -165,7 +168,6 @@ SOQL.of(Account.SObjectType)
 SubQuery with(String relationshipName, Iterable<SObjectField> fields)
 ```
 
-
 **Example**
 
 ```sql
@@ -184,6 +186,30 @@ SOQL.of(Account.SObjectType)
     .toList();
 ```
 
+### with string fields
+
+**Signature**
+
+```apex
+SubQuery with(String fields)
+```
+
+**Example**
+
+```sql
+SELECT Id, (
+    SELECT Id, Name, Phone, RecordTypeId, Title, Salutation
+    FROM Contacts
+) FROM Account
+```
+```apex
+SOQL.of(Account.SObjectType)
+    .with(SOQL.SubQuery.of('Contacts')
+        .with('Id, Name, Phone, RecordTypeId, Title, Salutation)
+    )
+    .toList();
+```
+
 ## SUB-QUERY
 ### with subquery
 
@@ -274,6 +300,56 @@ SOQL.of(Account.SObjectType)
     .toList();
 ```
 
+### orderBy string field
+
+**Signature**
+
+```apex
+SubQuery orderBy(String field)
+```
+
+**Example**
+
+```sql
+SELECT Id, (
+    SELECT Id
+    FROM Contacts
+    ORDER BY Name
+) FROM Account
+```
+```apex
+SOQL.of(Account.SObjectType)
+    .with(SOQL.SubQuery.of('Contacts')
+        .orderBy('Name')
+    )
+    .toList();
+```
+
+### orderBy string field with direction
+
+**Signature**
+
+```apex
+SubQuery orderBy(String field, String direction)
+```
+
+**Example**
+
+```sql
+SELECT Id, (
+    SELECT Id
+    FROM Contacts
+    ORDER BY Name DESC
+) FROM Account
+```
+```apex
+SOQL.of(Account.SObjectType)
+    .with(SOQL.SubQuery.of('Contacts')
+        .orderBy('Name', 'DESC')
+    )
+    .toList();
+```
+
 ### orderBy related
 
 Order SOQL query by parent field.