docs: add changelog entries for PRs #579-#590 #614
+12
−0
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -22,6 +22,18 @@ | |
|
|
||
| Minor Changes: | ||
|
|
||
| * fix: Harmonized `SecurityQueryFilter` between API and Security specifications and added missing `FILTERLIST` construct to the BNF grammar and JSON Schema. | ||
| * fix: Aligned `idShort` pattern in BNF grammar and JSON Schema with Metamodel Constraint AASd-002 to correctly enforce minimum two characters and prevent trailing hyphens. | ||
| * fix: Changed JSON Schema validation from `oneOf` to `anyOf` where BNF grammar allows mixed inline and named groups in concatenation scenarios. | ||
| * fix: Aligned date/time extraction functions (`$dayOfWeek`, `$dayOfMonth`, `$month`, `$year`) in JSON Schema to accept all `dateTimeOperand` types per BNF grammar, and widened `timeLiteralPattern` to support fractional seconds. | ||
| * docs: Aligned prose tables in Query Language specification with BNF grammar and JSON Schema patterns for cast operators, field identifiers, and submodel element limitations. | ||
| * docs: Added normative FieldIdentifier applicability table per profile to clarify which Query and Access Rule prefixes apply to specific service specification families. | ||
| * docs: Added normative Query Evaluation Semantics clause to standardize query behavior across implementations, including error handling, field resolution, and list-valued matching. | ||
| * docs: Added normative Operation-to-RIGHT mapping table documenting the correspondence between HTTP/REST API operations and IDTA-01004 rightsEnum values. | ||
|
Check warning on line 32 in documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc
|
||
|
sebbader-sap marked this conversation as resolved.
Dismissed
|
||
| * docs: Added cross-spec terminology matrix reference to align Metamodel classes, API path segments, and Query/Access-Rule prefixes across specifications. | ||
| * docs: Added cross-specification alignment matrix to document API compatibility with IDTA-01001 (Metamodel v3.2) and IDTA-01004 (Security v3.1). | ||
|
Check warning on line 34 in documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc
|
||
|
sebbader-sap marked this conversation as resolved.
Dismissed
Member
There was a problem hiding this comment. PR #588’s actual diff replaces the old dependency/version section with a broader alignment matrix covering IDTA-01001, IDTA-01003-a, IDTA-01003-b, IDTA-01004, and IDTA-01005, including changing IDTA-01005 from v3.1 to v3.2. This entry only mentions IDTA-01001 and IDTA-01004, so it undersells part of the actual changelog impact. Please mention the broader companion-spec alignment, or at least include the IDTA-01005 v3.2 alignment. |
||
| * docs: Established IDTA-01002 as authoritative source for formula grammar and JSON Schema shared between API and Security specifications. | ||
| * docs: Added informative Conformance Test Corpus annex providing technology-neutral test cases for Query Language, HTTP/REST API, and error handling. | ||
| * Added the `ServerNotImplemented` status code to the xref:specification/interfaces-payload.adoc#table-status-codes[Status Codes]. Note that the HTTP API mentioned this status code already, therefore, no change in OpenAPI or other related files. (https://github.com/admin-shell-io/aas-specs-api/issues/499[#499]) | ||
| * Removed the `GetAllAssetAdministrationShellDescriptorsByAssetType` operation from the OpenAPI files for the Asset Administration Shell Registry Service Specification, as it was not intended to be included in the first place and is not implemented by any known implementation. (https://github.com/admin-shell-io/aas-specs-api/issues/515[#515]) | ||
| * Changing the serialization format for AASX packages from "application/asset-administration-shell-package+xml" to "application/aas+zip" in the OpenAPI files for the Asset Administration Shell Repository Service Specification and the Submodel Repository Service Specification. This change is necessary to align with the actual content type used by implementations and to avoid confusion, as the previous content type was not registered and could be misinterpreted as an XML-based format. (https://github.com/admin-shell-io/aas-specs-api/issues/538[#538]) | ||
|
|
||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The referenced PR #580 also changes
Part2-API-Schemas/openapi.yaml, and its own PR body claimspages/schema.adocis touched, though the actual #580 diff does not include that file. The related backport #611 does include both OpenAPI andschema.adoc. Please make this changelog entry explicit about the OpenAPI schema update, and double-check whether #580 is missing the generatedschema.adocupdate.