Document new OQL feature: INSERT ... VALUES

Author: passalaqua

content/en/docs/refguide/modeling/domain-model/oql/oql-statements.md

@@ -157,13 +157,16 @@ SET
 ## `INSERT` Statement {#oql-insert}
 
 {{% alert color="info" %}}
-Available from Mendix version 11.6.0
+Available from Mendix version 11.6.0 when sourcing data from an oql query.
+Available from Mendix version 11.13.0 when using `VALUES` to specify rows directly.
 {{% /alert %}}
 
-The syntax of `INSERT` statements is:
+`INSERT` statements can be written with values or queries.
+
+### `INSERT` with query
 
 ```sql
-INSERT INTO <entity> ( <attribute | <association> [ , …n ] ) <oql-query>
+INSERT INTO <entity> ( <attribute> | <association> [ , …n ] ) <oql-query>
 ```
 
 * `entity` is the entity for which new objects will be created.
@@ -182,6 +185,27 @@ INSERT INTO Module.Order ( OrderNumber, CustomerNumber, Module.Order_Customer )
 SELECT NewOrderNumber, Loader.TemporaryData_Customer/Loader.Customer/Number, Loader.TemporaryData_Customer FROM Loader.TemporaryData
 ```
 
+### `INSERT` with `VALUES`
+
+```sql
+INSERT INTO <entity> ( <attribute> [ , …n ] ) VALUES (<expression 1> [, …<expression n>]) [ …, (<expression 1> [, …<expression n>])]
+```
+
+* `entity` is the entity for which new objects will be created.
+
+* `attribute` is an attribute of the entity that will be inserted.
+
+* `expression n` is any valid OQL expression with literals or OQL parameters.
+Every row must contain the same number of values of compatible types.
+This query can *not* select data from any entities.
+
+Example:
+
+```sql
+INSERT INTO Module.Order ( OrderNumber, CustomerNumber )
+VALUES ( 1, 32 ), ( 2, 33 ), ( $LastOrderNumber + 1, $CustomerNumber )
+```
+
 ### OQL `INSERT` Limitations
 
 * Only a single value can be specified per association.