From f1e69cbd3c6581dc52d652e37869b2c91c657e6f Mon Sep 17 00:00:00 2001 From: tomcdonnell Date: Tue, 25 Feb 2025 18:38:29 +1100 Subject: [PATCH 1/6] Show two options for items in folder array [SA-18729] --- openapi/paths/assessment.yaml | 41 ++++++++++++++++++++--------------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/openapi/paths/assessment.yaml b/openapi/paths/assessment.yaml index 1f30b0c..0168f4b 100644 --- a/openapi/paths/assessment.yaml +++ b/openapi/paths/assessment.yaml @@ -52,29 +52,36 @@ parameters: example: dueWork folder: oneOf: - - type: array - description: Array for folders to filter assessments on. - items: - type: object + - type: array + description: Array for folders to filter assessments on. + items: + oneOf: + - type: object + properties: + id: + description: ID of the folder containing the assessment. + type: integer + example: 80 + required: + - id + - type: object + properties: + code: + description: Code of the folder containing the assessment. + type: string + example: 9ENGA + required: + - code + - type: object description: | - Select either one of the following fields to filter on: + Select a folder ID to filter on: properties: id: type: integer description: ID of the folder containing the assessment. example: 80 - code: - type: string - description: Code of the folder containing the assessment. - example: 9ENGA - - type: object - description: | - Select a folder ID to filter on: - properties: - id: - type: integer - description: ID of the folder containing the assessment. - example: 80 + required: + - id subjectCode: type: array items: From 84491a344bca4891ccbead3a86f38513ed7a8654 Mon Sep 17 00:00:00 2001 From: tomcdonnell Date: Tue, 25 Feb 2025 18:38:57 +1100 Subject: [PATCH 2/6] Deprecate the non-array folder option [SA-18729] --- openapi/paths/assessment.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/openapi/paths/assessment.yaml b/openapi/paths/assessment.yaml index 0168f4b..94afe91 100644 --- a/openapi/paths/assessment.yaml +++ b/openapi/paths/assessment.yaml @@ -73,6 +73,7 @@ parameters: required: - code - type: object + deprecated: true description: | Select a folder ID to filter on: properties: From b978dd866372f0ba81c4ea2ea8695400caf02ff3 Mon Sep 17 00:00:00 2001 From: tomcdonnell Date: Tue, 25 Feb 2025 18:38:29 +1100 Subject: [PATCH 3/6] Show two options for items in folder array [SA-18729] From badd4755937cafb6aa6ecf124df08ca335fd9efc Mon Sep 17 00:00:00 2001 From: tomcdonnell Date: Tue, 25 Feb 2025 19:01:27 +1100 Subject: [PATCH 4/6] Replace deprecated option description with (Deprecated) [SA-18729] --- openapi/paths/assessment.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi/paths/assessment.yaml b/openapi/paths/assessment.yaml index 94afe91..2f37b40 100644 --- a/openapi/paths/assessment.yaml +++ b/openapi/paths/assessment.yaml @@ -75,7 +75,7 @@ parameters: - type: object deprecated: true description: | - Select a folder ID to filter on: + (Deprecated) properties: id: type: integer From 3c637d23754b09a672f7c1a67174fe237372be7c Mon Sep 17 00:00:00 2001 From: tomcdonnell Date: Tue, 25 Feb 2025 19:41:34 +1100 Subject: [PATCH 5/6] Fix JSON object filter example [SA-18729] --- openapi/paths/assessment.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/openapi/paths/assessment.yaml b/openapi/paths/assessment.yaml index 2f37b40..cac5b82 100644 --- a/openapi/paths/assessment.yaml +++ b/openapi/paths/assessment.yaml @@ -21,12 +21,12 @@ parameters: in: query required: true description: | - Json encoded object of fields and values to filter assessments on. \ + JSON encoded object of fields and values to filter assessments on. \ For example, to get assessment with ID 676: \ `filter=%7b%22assessmentId%22%3a676%7d` Filter string to filter on all the fields would look like: \ - `{"assessmentId": 256,"title": "English 3/4 [Final]","assessmentType": "dueWork","folder": {id: 80},"weighted": false,"workType": {"id": 1,"name": "Formative Assessment"},"dueDate": {"from": "2017-10-12T14:20:50+10:00","to": "2019-10-12T14:20:50+10:00"},"yearLevel": {"id": 6,"name": "Year 6"}}` + `{"assessmentId": 256,"title": "English 3/4 [Final]","assessmentType": "dueWork","folder": [{id: 80}],"weighted": false,"workType": {"id": 1,"name": "Formative Assessment"},"dueDate": {"from": "2017-10-12T14:20:50+10:00","to": "2019-10-12T14:20:50+10:00"},"yearLevel": {"id": 6,"name": "Year 6"}}` schema: type: object properties: From 508991e0a00dffeedddad847a1ffbfdfefc7cc9c Mon Sep 17 00:00:00 2001 From: tomcdonnell Date: Wed, 26 Feb 2025 12:02:50 +1100 Subject: [PATCH 6/6] Add description of folder array [SA-18729] --- openapi/paths/assessment.yaml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/openapi/paths/assessment.yaml b/openapi/paths/assessment.yaml index cac5b82..54b170f 100644 --- a/openapi/paths/assessment.yaml +++ b/openapi/paths/assessment.yaml @@ -53,7 +53,8 @@ parameters: folder: oneOf: - type: array - description: Array for folders to filter assessments on. + description: | + An array of objects, each of which specifies either an "id" or a "code". items: oneOf: - type: object