|
5 | 5 | **Document type:** `Rest$ConsumedRestService` |
6 | 6 | **Prevalence:** 2 in Evora project (not found in Enquiries or Lato) |
7 | 7 | **Priority:** Medium — newer Mendix feature (10.1.0+), growing in adoption |
8 | | -**Reference:** `mdl-examples/doctype-tests/06-rest-client-examples.test.mdl` (21 examples) |
| 8 | +**Reference:** `mdl-examples/doctype-tests/06-rest-client-examples.mdl` (21 examples) |
9 | 9 |
|
10 | 10 | Consumed REST Services define external REST API connections. Each service has a base URL, authentication scheme, and one or more operations with HTTP methods, paths, headers, parameters, and response handling. |
11 | 11 |
|
@@ -92,7 +92,7 @@ Rest$RestOperation |
92 | 92 |
|
93 | 93 | 1. **Roundtrip**: DESCRIBE output must be valid CREATE input |
94 | 94 | 2. **Consistency**: Follow existing CREATE REST CLIENT grammar structure (BEGIN...END blocks) |
95 | | -3. **Alignment**: Match the syntax in `06-rest-client-examples.test.mdl` |
| 95 | +3. **Alignment**: Match the syntax in `06-rest-client-examples.mdl` |
96 | 96 | 4. **Simplicity**: Use MDL-native types ($variables, data types) rather than exposing BSON internals |
97 | 97 |
|
98 | 98 | ### SHOW REST CLIENTS |
@@ -537,15 +537,15 @@ func (e *Executor) dropRestClient(s *ast.DropRestClientStmt) error |
537 | 537 |
|
538 | 538 | ### Phase 3: Test Enablement |
539 | 539 |
|
540 | | -Remove the `exit;` guard from `06-rest-client-examples.test.mdl` (line 34) and verify all 21 examples parse and execute correctly. |
| 540 | +Remove the `exit;` guard from `06-rest-client-examples.mdl` (line 34) and verify all 21 examples parse and execute correctly. |
541 | 541 |
|
542 | 542 | ## Complexity |
543 | 543 |
|
544 | 544 | **Medium-High** — Multiple polymorphic BSON types (method, body, response handling, authentication, parameter values), value templates with parameter interpolation, and header expression parsing. The OData implementation provides a proven template but REST has more polymorphic variance. |
545 | 545 |
|
546 | 546 | ## Testing |
547 | 547 |
|
548 | | -- Parse all 21 examples in `06-rest-client-examples.test.mdl` with `mxcli check` |
| 548 | +- Parse all 21 examples in `06-rest-client-examples.mdl` with `mxcli check` |
549 | 549 | - Roundtrip test: CREATE → DESCRIBE → re-parse must produce identical AST |
550 | 550 | - Verify BSON output against Evora project's existing consumed REST services |
551 | 551 | - **Important**: Before writing BSON, create a reference REST client in Studio Pro and compare the generated BSON structure field-by-field |
|
0 commit comments