Merge remote-tracking branch 'origin/main' into submit/microflow-inheritance-split-cast

# Conflicts:
#	mdl/grammar/parser/MDLParser.interp
#	mdl/grammar/parser/mdl_parser.go

Author: hjothamendix

.claude/skills/mendix/java-actions.md

@@ -123,7 +123,7 @@ public IMendixObject executeAction() throws Exception
 | `Core.delete(context, object)` | Delete object |
 | `Core.rollback(context, object)` | Discard uncommitted changes |
 | `Core.retrieveId(context, id)` | Retrieve by GUID |
-| `Core.retrieveXPathQuery(context, xpath)` | Query with XPath |
+| `Core.createXPathQuery(xpath).execute(context)` | Query with XPath |
 | `Core.microflowCall(name).execute(context)` | Call microflow |
 
 ### Reading and Writing Attributes
@@ -146,8 +146,8 @@ order.setValue(context, "ProcessedDate", new java.util.Date());
 
 ```java
 // set association (reference)
-IMendixObject customer = Core.retrieveXPathQuery(context,
-    "//Sales.Customer[CustomerCode = 'CUST001']").get(0);
+IMendixObject customer = Core.createXPathQuery("//Sales.Customer[CustomerCode = 'CUST001']")
+    .execute(context).get(0);
 order.setValue(context, "Sales.Order_Customer", customer.getId());
 
 // get associated object
@@ -162,8 +162,8 @@ if (customerId != null) {
 
 ```java
 // retrieve list
-list<IMendixObject> orders = Core.retrieveXPathQuery(context,
-    "//Sales.Order[status = 'Pending']");
+list<IMendixObject> orders = Core.createXPathQuery("//Sales.Order[status = 'Pending']")
+    .execute(context);
 
 // Process list
 java.math.BigDecimal total = java.math.BigDecimal.ZERO;
@@ -1068,7 +1068,7 @@ int offset = 0;
 int batchSize = 1000;
 list<IMendixObject> batch;
 do {
-    batch = Core.retrieveXPathQuery(context, xpath, batchSize, offset, null);
+    batch = Core.createXPathQuery(xpath).setAmount(batchSize).setOffset(offset).execute(context);
     // Process batch
     offset += batchSize;
 } while (batch.size() == batchSize);
@@ -1187,7 +1187,7 @@ Core.commit(context, obj);
 Core.delete(context, obj);
 
 // query
-list<IMendixObject> results = Core.retrieveXPathQuery(context, "//Module.Entity[attr = 'value']");
+list<IMendixObject> results = Core.createXPathQuery("//Module.Entity[attr = 'value']").execute(context);
 
 // log
 Core.getLogger("ModuleName").info("message");

.claude/skills/mendix/write-microflows.md

@@ -749,6 +749,35 @@ retrieve $Items from Module.Entity where Active = true;
 
 **Note**: `returns type as $Var` in the microflow signature does NOT create an activity variable — it only names the return value. So `$Var = call java action ...` after `returns as $Var` is fine (one creation).
 
+## Legacy SOAP Web Service Calls
+
+`call web service` preserves legacy Mendix SOAP activities. Prefer REST clients
+for new integrations; this syntax exists mainly so existing projects can
+round-trip without dropping SOAP actions.
+
+```mdl
+-- Structured form. Resolved SOAP references use normal qualified names.
+$Root = call web service SampleSOAP.OrderService
+operation FetchSampleItems
+send mapping SampleSOAP.OrderRequest
+receive mapping SampleSOAP.OrderResponse
+timeout 30
+on error rollback;
+
+-- Quoted raw IDs are accepted when old project references are dangling or unavailable.
+$Root = call web service 'sample-service-id'
+operation FetchSampleItems
+send mapping 'sample-send-mapping-id'
+receive mapping 'sample-receive-mapping-id';
+
+-- Raw escape hatch emitted for unsupported SOAP fields.
+$Root = call web service raw 'AQID';
+```
+
+**Design note:** the raw payload is base64-encoded BSON for the complete action
+and is authoritative on re-exec. Treat this as round-trip support, not a
+recommended authoring format for new integrations.
+
 ## REST Service Calls
 
 MDL supports two patterns for calling REST APIs from microflows: