Adjust OpenAPI Files for Discovery Service Profiles #229
Conversation
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
BirgitBoss
reviewed
Feb 20, 2024
BirgitBoss
reviewed
Feb 20, 2024
BirgitBoss
reviewed
Feb 20, 2024
BirgitBoss
reviewed
Feb 20, 2024
BirgitBoss
requested changes
Feb 20, 2024
|
We need to check versions of API-operations: will version increase to V3.1 if payload changed due to changes in Part 1? We need to check this. |
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
Yes, this is an unavoidable consequence: If Part 1 V3.1 is published, the SwaggerHub Domain Part 1 Version 3.1 will be created. As all SwaggerHub APIs, e.g., DiscoveryServiceSpecification V3.0.1, explicitly link to one and only one version of a Domain (for now Part 2 V3.0.1, which referencers Part 1 V3.0.1), we need to release a equivalent version (V3.1.0) for each API, too. |
It should, or am I missing anything? See also my comment above. |
|
Can you please add the milestone this PR belongs to? |
BirgitBoss
reviewed
Mar 4, 2024
| - url: 'https://admin-shell.io/api/v3.1' | ||
| - url: 'https://example.com/' | ||
|
|
||
| - url: '{protocol}://{host_name}:{port}/api/{version_prefix}' |
There was a problem hiding this comment.
Didn't we decide to support very flexible URL, just {protocol}://{base-url}. + Text: We recommend to use major version of API version only. After version it is still possible that there is a tenant-ID or a different order...
There was a problem hiding this comment.
This is 3.0.1 but 3.0.1 is already released: I am getting confused…
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Mar 4, 2024
| - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/AssetIds' | ||
| - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Limit' | ||
| - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.0#/components/parameters/Cursor' | ||
| - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.0.1#/components/parameters/AssetIds' |
There was a problem hiding this comment.
this is not parameter any longer but part of the request body
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Mar 4, 2024
BirgitBoss
reviewed
Apr 9, 2024
| @@ -11,83 +11,62 @@ info: | |||
| license: | |||
| name: CC BY 4.0 | |||
| url: https://creativecommons.org/licenses/by/4.0/ | |||
| version: V3.1.0_SSP-001 | |||
| x-profile-identifier: https://admin-shell.io/aas/API/3/1/DiscoveryServiceSpecification/SSP-001 | |||
| version: V3.0.1_SSP-001 | |||
There was a problem hiding this comment.
Suggested change
| version: V3.0.1_SSP-001 | |
| version: V3.1.0_SSP-001 |
There was a problem hiding this comment.
It is now V3.1, no? But all changes are for V3.0.1 but you want to merge it to branch of V3.1?
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
…min-shell-io/aas-specs-api into SeBa-rename-discovery-openapi
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com>
I haven't done this yet as long as the operation had no changes compared to the V3.0.3 version (apart of the reference links to the Part 1 and Part 2 domains...). |
That's fixing an error in the current IDTA-01002-3-1_preparation branch: The profile file was already there for a long time, but the filename was wrong (was: V3.0_SSP-002.yaml but actually will be introduced with V3.1 for the first time). |
|
@BirgitBoss I think I have incorporated your requests so far. For the x-semanticIds |
BirgitBoss
removed request for
g1zzm0,
waltersve,
getag,
mjacoby,
aorzelskiGH,
zrgt,
alexgordtop and
danielporta
BirgitBoss
approved these changes
Jan 4, 2025
juileetikekar
added a commit
that referenced
this pull request
May 27, 2025
* Add "\" to avoid ref confusion * Remove unused .emf images * Remove unused images * Remove unused images * Remove unused images * Set descriptive names to images * Fix figure refs in UML doc * Fix figure refs * Fix figure refs between docs * Fix figure refs between docs * change ProtocolInformation/subprotocol from IdShortType to ShortIdType * Fix clause refs where possible Fixed clause refs, where no deeper text adaptation was required * Add metainfo in index.adoc similar to part 1 documentation * Rename puml diagramms acc. to images * Remove "IDTA-01002"-Prefix in filenames The prefix is already included in parent dir name * Set version tag to 'in progress'; remove "DRAFT" in title * Minor change * Add display_version See: https://docs.antora.org/antora/latest/component-display-version/ * Set prerelease to true * Fix name * remove design decision for ReferenceParent and sync the v3.0.2 major changelog section * Adapt changelog to Identifier 2000->2048 + AssetLink (#283) * Adapt changelog to changes of PR #271 Identifier 2000 -> 2048 + AssetLink added as new class * adjust identifiable/id also in openapi files --------- Co-authored-by: Sebastian Bader <s.bader@sap.com> * Apply one-sentence-per-line rule in all docs * Fix small typos * Revert splits in illustration infos * add issue number to changes made for V3.1 * one sentence per line, should fix that there was no space behing ".The * add link: to Part 1 data types * added xref and tags used in xref * Extend the Description of the AssetLink Request (#293) * extend the description of the asset link post * Update DiscoveryServiceSpecification/V3.0_SSP-001.yaml Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Integrate PUMLs + small fixes - Add new PUMLs - Small fix of existing PUMLs - Use PUMLs in docs instead of images - Use raw JSON examples in docs instead of images * Small fix * Visual fix * Add idta puml theme * Add pumls for concept images * Make assetKind and assetType optional in the Specification Table (#307) * make assetKind and assetType optional for GetAllAssetAdministrationShellDescriptors * add changelog entry * add link to the github issue * fix typo in the changelog sentence * Remove puml and use original image See #310 (comment) * Add PUMLs for uml annex + adapt texts * add bugfix 3.0.3 changes into the 3.1.0 documents (#322) * Fix type names * Small fix * Add use of pumls to changelog * Update CONTRIBUTING.md "Details of AAS" is deprecated. It is "Specifications of the AAS" (or in short "Specs of AAS" now * Update CONTRIBUTING.md change Details of AAS to Specification of the Asset Administration Shell within Work Group Open Technology * Correct version in changelog (#332) Copy/paste error * Remove footnote about Enterprise Architect * Remove idta theme from puml files We use idta theme in the Antora Configuration repository (aas-specs-antora), so we do not need anymore to define idta theme in PUML files. * add CODEOWNERS * Add details on behavior when query parameters are present multiple times (#336) * add details on behavior when query parameters are present multiple times * update changelog * editorial corrections (#326) * latest version 3.0.3 * added subchapter "History" like in Part 1 updated History (bugfixes not mentioned) added numbers to spec parts * correct note Update service-specifications-and-profiles.adoc: not of SMT Profile was split incorrectly * Use "idShortPath" consistently throughout document * seq-sm-endpoints-http: add /aas/submodels/<submodel-id> fix typos * Fix unresolved xrefs * Fixed `PutAASXPackageById` and `DeleteAASXPackageById` Fixes #352 * Fix xrefs of `SerializationModifier` * Fix small naming error (#353) I believe there was an error made as the Interface mentioned is Repository not the Registry of AAS * Fix Mandatory and Cardinality fields (#359) Findings from hofermo * Update cardinality for Discovery Interface (#356) reported by hofermo * Introduce the IDTA Query Language (#292) Co-authored-by: Sven Walter <waltersven@gmx.de> Co-authored-by: Igor Garmaev <56840636+zrgt@users.noreply.github.com> Co-authored-by: aorzelskiGH <48956800+aorzelskiGH@users.noreply.github.com> Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * remove "submodelElements" from SubmodelValue (#253) * remove "submodelElements" from SubmodelValue * improve language of the valueonly description --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * make assetIds optional for GetAllAssetAdministrationShellIdsByAssetLink (#308) * adding note to explain the desired behavior (#275) * editorial changes (#361) * added xref correct GetDescription to GetSelfDescription renamed id to ID Clause 4.5 substitutet with ref. to AASd-116 * add more xref: * remove deprecated reference to Plattform I4.0 corrected some links do not reference Glossary Plattform I4.0 directly only via Terms and Definitions * added puml to partials, directly link puml, not .png * Adjust OpenAPI Files for Discovery Service Profiles (#229) * add Discovery Service Specification V3.1_SSP-001 as own YAML file * adjust name of Discovery Service Specification SSP-002 * correct links from v3.0.1 to v3.1.0 * Update DiscoveryServiceSpecification/V3.1_SSP-001.yaml --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * complete changelog and editorial changes (#362) * made consistent: no API-operation in interface change table + added missing new operations + renamed query operations (new patterns Query... instead of ByQuery) + added some comments for changes in tables + fix xref name (editorial) * added API-Operations xref to interfaces * reduced columns in change tables + correct formatting errors * fix typo * add [[]] for referencing to chapter ServiceDescription because used * Bug fix missing $ * Change Query and AllAccessRules back to properties Schema changed back Missing $ added * examples for endpoints changed: no OPC examples but two different versions + Catena-X example with DSP + increase 3.0 examples to 3.1 + reformulate and use shall/should etc. * no new interfaces, just new operations for existing interfaces + distinguish between changed and extended * consistency with commas * Add conformance and versioning subchapters conformant to Part 1 (only bib-xref is different) * formatting corrected https metamodel semantic IDs + changes column width (now automatically) + correct formatting in changelog for profiles + formatting cursive for interface names * formatting: added links to Part 1 formatting: added links to Part 2 added labels for referencing [[]] * correct: ServiceSpecificationProfileEnum ist version /3/1 because there are /3/1 profiles in there + added links to figures, tables, chapters (also corrected hard coded one to old .pdf- version) * Update interfaces-payload.adoc - Fix example mapping two different versions of interface on same endpoint - Remove redundant example * correct addresses in endpoint examples * - added tags for referencing - substituted fixed Clause ref with xref * corrected tags for chapters + added json listing formatting to query results * correct link to MultiLanguageNameType + correct hh in table * formatting and correcting (remove + from json code) from Query Results * increase version for classes and operations using types with /3/1 to /3/1 * increase ID for payload class or operation if types used within increased to /3/1 * added links to types + correct data type String to string * formatting * correct xref .(html --> .adoc) * add profiles as new major change in changelog Co-authored-by: Michael Jacoby <michael.jacoby@iosb.fraunhofer.de> * Add source to `interface` term Fixes #340 * Clause 4.5 substituted with ref. to AASd-116 Was partly done in 98a9aea Fixes #305 * Fixes #197 * Fix PutAASXPackageById * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces-payload.adoc * marked parameter 'level' as deprecated for all URLs ending with '/' * remove outdated and duplicate file /DiscoveryServiceSpecification/V3.1_SSP-001.yaml * Updated aas-api-versioning-url-scheme images and text Fixes #317 * Fixes #339 * Fixes #117 * Fixes #323 * Revise pagination explanation * issue 220 - fix ServiceDescription as it was already fixed in v3.0.3 * Replace refs to moved chapters with refs to Part 1 Fixes #284 * minor typo * Fix Cardinality for Response Payloads of PUTs and PATCH (#263) * make payload optional for put and patch * Category deprecated, semanticId only ExternalReference * removed Category from example since deprecated * change ConceptDescription to GlobalReference since only external references allowed for semanticId with V3.1 * fix remaining merge conflicts --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Co-authored-by: Michael Jacoby <michael.jacoby@iosb.fraunhofer.de> * Add the reworked API Versioning chapter (#273) --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Deprecate GetAllAssetAdministrationShellIdsByAssetLink (#376) * Deprecate GetAllAssetAdministrationShellIdsByAssetLink * Deprecate GetAllAssetAdministrationShellIdsByAssetLink in interface definition * Add SearchAllAssetAdministrationShellIdsByAssetLink in interface definition * Added AssetLink class * Update link for AssetLink --------- Co-authored-by: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> * add http mapping entries for bulk endpoints * fix operationIds and x-semanticIds for bulk operations * change automatically generated pattern to real constants + fixing outdated regex pattern for strings (#377) * resolve wrong include for the json query schema * Simplifying Bulk OpenAPI Files (#380) * referencing the part 2 domain classes instead of keeping the whole content * Update SubmodelRegistryServiceSpecification/V3.1_SSP-003.yaml Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * fix url where to find the specification --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * editorial changes (#385) * fix formatting * imrpove description * fix formatting * adding missing methods conformant to grammar + removed "SET": seems not to be used (from text and grammar) + SetInvoke does not exist, was probalby Set | Invoke * fix footnote (needs to be footnote:[ instead of footnote[ some formatting * formatting of `$xx` * fix link * move json query schema to partials to test the include statement * test again with old path to not break incoming links * fix antora inclusion error * attempt to fix the last include error * undo include test attempt * fix outdated swagger links * Change ProtocolInformation/securityAttributes from mandatory to optional (#383) * change cardinality of ProtocolInformation/securityAttributes from 1..* to 0..* * add missing references * Update EntireAPI V3.1 plus minor fixes in other OpenAPI Files (#381) * change automatically generated pattern to real constants + fixing outdated regex pattern for strings * referencing the part 2 domain classes instead of keeping the whole content in bulk profiles * use latest content from the aas service full profile * use latest content from the submodel service full profile * use latest content from the aas repository service full profile * add the aas repository query endpoints * use latest content from the submodel repository service full profile * correct minor inconsistencies in the aas repository full profile * fix outdated parts for the submodel repository full profile * add the submodel repository query endpoint * remove incorrect x-semanticId from the aas repo query profile * remove incorrect x-semanticId from the submodel repo query profile and simplify the server examples * remove incorrect x-semanticId from the aas repo query profile * add the conceptdescription repository query endpoints * add the aas registry bulk endpoints * add the aas registry query endpoint * add the submodel registry bulk endpoints * add the submodel registry query endpoint * use latest content from the discovery service full profile * use latest content from the aasx file service full profile * adjusting server examples and api version declarations * rename the entire api file from 3.0 to 3.1 * Update SubmodelRegistryServiceSpecification/V3.1_SSP-003.yaml * remove the attributeItem which is not part of the query language * fix incorrect stringValue fields of the query * fix query endpoint for aas registry * rename all profile files from 3.0 to 3.1 * change publication year for all profiles to 2025 * add changelog entry for new profiles * add change log entry for "servers" in openapi files --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * fix import of the query language overview picture * Fix Regex for modelStringPattern (#386) * fix regex pattern for modelStringPattern * fix condition -> $condition in query examples * Grammar for JSON * Add editorial notes to TOC (#387) This change is required to set line numbers in the generated PDF document from the first page. The code for setting line numbers works based on nav.adoc. It starts with the first dodument referenced in nav.adoc and sets line numbers there. * fix wrong operationId for GetSelfDescription (#388) * use correct operationId, and * use correct x-semanticId * Updated swagger links in http-rest-api.adoc (#389) Links to metamodel and part2 api pointed to v3.1 instead v3.1.0 * editorial changes (#390) * remove Figure, will be automatically added * fix, was redundant add section tag * conformant to other parts: handling of constraints + editorial changes * dotted lines for dependencies formatting enums inherit from enums * formatting, path * formatting * editorial * add: update of interactions diagrams + editorial * subsittuted by " * fix example url in OpenAPI conform to recommendation * change the profile identifiers to /3/1/ * fix reference to wrong clause * Fix unresolved refs * Improve some styling * add cursor and limit query parameters to query endpoints (#393) * correct typo * fix swaggerhub urls and profile identifiers * remove rejected QueryXyzIds profiles * remove rejected QueryXyzIds profiles * remove reference to non-existing API Operation GetAllSubmodelsBySupplementalSemanticId * Update README.md - correct links to releases - add V3.03 release * Correct and UPDATE README.md (#402) * Update README.md - correct links to releases - add V3.0.3 * Update README.md * Split General from Query + update preamble (#403) * split General to General and Query Language update preamble with structure of the document: add links to Query Language and more detailed Annex description * correct links due to split query-language * add "Role" and "NotApplicable" to locations with relation to AssetKind * remove level in metadata operations (#404) * remove note from picture (finding bo-#4) * remove not visible comments from query text * remove the class and enum icons from the query language overview * extend comment about pagination and sorting for queries * fix link for the security demo server * replace se-hierarchy picture with self-drawn, incl. fixed sme-struct * extended description for the "includeConceptDescriptions" parameter * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Extend Interface Values (#415) * add option for value and mateadata interfaces * add option for value and mateadata interfaces * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces-payload.adoc Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces-payload.adoc Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces-payload.adoc Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * add path and metadata to interface parameters --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * clarify PostSubmodelElementByPath behavior (#418) * add notes for base64url Encodings (#416) * add notes to clarify the behavior for base64url encoded values. * improve first note on encoding * Add Qodana to GitHub Actions It will check all changed files on PR * add note for metadata and value-only representations of Asset Administration Shells * removal of chapter Security + editorial changes (#428) * update bilbliography DIN EN IEC 61406-1, now IEC * fix xef to xref * add / update copyright header * correct formatting * Querying now already part of version * add overview of constraints * fix link to figure 1 * cursive for consistency * add Header for Enumeration * fix footnote * fix {} * add xref to modifiers + add subheader for modifiers * typo * add xref and link * remove empty note at the bottom * Content and Metadata start with capital letter * formatting * substitute " + formatting * add link to pagination chapter * add link to chapter serialization modifier * removal of chapter "Security" * close footnote --------- Co-authored-by: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> * Fix typos and add note block * Adjust table entries and text intro * improve text * improve text * Clarify base64url and padding (#425) * explain base64url and padding * add link * Update documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/http-rest-api.adoc Co-authored-by: Sebastian Bader <sebastian.r.bader@web.de> --------- Co-authored-by: Michael Jacoby <michael.jacoby@iosb.fraunhofer.de> Co-authored-by: Sebastian Bader <sebastian.r.bader@web.de> * Fix wrong Name of ConceptDescriptionServiceSpecification to ConceptDescriptionRepositoryServiceSpecification (#419) * rename conceptdescriptionservicespecification to conceptdescriptionRrepositoryservicespecification for all in v3.1 * rename conceptdescriptionservicespecification to conceptdescriptionRrepositoryservicespecification for all in v3.1 * bugfix Constraint AASa-004 und editorial changes (#430) * remove security link: chapter was removed * fix link to modifier constraint make consistent Content="xx" and not Content=xxx + Capitalb letter (small letter in http-REST) * bugfix: it is SubmodelRepositoryServiceSpecification/SSP-004 Constraint fixed links added to constraints minor editorial changes * add links to submodel repository service * add links * add links * add content * add links + fix underline * bufix Constraint AASa-003 is also about submodel repository + bufix profile identifier * missing comma --------- Co-authored-by: Sebastian Bader <s.bader@sap.com> * Fix AASQL grammar bugs #433, #434, #435 (#436) * Use partials for bnf Before the bnf grammar was in an .adoc file. In this commit we place it in .bnf file in partials similar as in aas-specs-security repo. * Small fix * Add missing $ for ends-with Fixes #435 * Set brackets mandatory for items in iterables Fixes #433 * Remove redundancy in `stringComparison` --------- Co-authored-by: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> * Fix Cardinality for Whitespaces in Query Grammar (#437) * Use partials for bnf Before the bnf grammar was in an .adoc file. In this commit we place it in .bnf file in partials similar as in aas-specs-security repo. * Small fix * Add missing $ for ends-with Fixes #435 * Set brackets mandatory for items in iterables Fixes #433 * Remove redundancy in `stringComparison` Fixes #434 * undo changes in stringComparison clause * correct cardinality for whitespaces in the query grammar --------- Co-authored-by: zrgt <garmaev@gmx.de> * Extend Note for PostAllAssetLinksById (#422) * extend note for PostAllAssetLinksById * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * fix for #251 * New AAS Registry Profile "Minimal Read" (SSP-005) (#420) * add new minimal read profile for the ass registry * Update AssetAdministrationShellRegistryServiceSpecification/V3.1_SSP-005.yaml Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Update AssetAdministrationShellRegistryServiceSpecification/V3.1_SSP-005.yaml Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * fix typo in operation name * Update AssetAdministrationShellRegistryServiceSpecification/V3.1_SSP-005.yaml Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * rename new ssp from registry to asset administration shell registry --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * import updates from https://github.com/admin-shell-io/aas-specs/blob/SeHe/IDTA-01001-3-1_schemas/schemas/json/aas.json (#438) * update readme * [Review] Incorporate Findings affecting OpenAPI (#411) * add comment about the oneOf rendering problem and fixing outdated query result declarations * sync idShort patterns and minLength * add comment about the oneOf rendering problem and fixing outdated query result declarations * Update Part 1 Classes (#413) * incorporate the latest aas json schema changes from part 1 * incorporate valueonly adjustments from part 1 * make the 409 description more generice * make paging_metadata mandatory to match definition in the spec * Update Part2-API-Schemas/openapi.yaml Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * Update Part1-MetaModel-Schemas/openapi.yaml Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> --------- Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> * sync aasx file server ssp with swaggerhub * Explain different SSP Versions (#439) * add sentences explaining implicit support of service specification versions * add add sentences explaining implicit support of service specification versions * fix missing '|' in query grammar * Add OperationResultValueOnly and OperationRequestValueOnly Classes (#440) * add OperationResultValueOnly and OperationRequestValueOnly classes * OperationResultValueOnly inherits from BaseOperationResult & using SubmodelElementValue as the data type * extend the explanation how to discover endpoints (#443) * make ProductClassifications an SML as in the latest version of Technical Data (#442) * make consistent to Part 1, Part 3a and Part 5: no navigation to eidtorial notes (#446) * add DOI * Change image and its size * #445: Relaxed api to not throw 404 when element was not found on PUT * Add DOI * add missing api path for PutAssetAdministrationShell * adding missing path to PutAssetAdministrationShell to the changelog * fix anchor for mapping_of_operations section * Fix image * Delete .gitignore As requested * correct url (antora) + editoral changes (#457) * editorial * change url with "antora" * change url to new url (no antora) * #445: Updated interfaces * fix outdated github links (#458) * Correct absolute GitHub links due to renaming of the repos * Revert "Correct absolute GitHub links" This reverts commit 0282740. * Correct absolute GH links due to renaming of the repos * Delete .gitignore * Correct absolute links with new domain * Change Publisher to Copyright (#459) * #445: Introduced 201s, removed "create" for PUT on identifiable services * Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc * #445: Introduced 201s, removed "create" for PUT on identifiable services * #445: Editorial - shortened and grammar * add xrefs for all api operations in profiles use latest link for the part 2 http location fix inconsistently used x-semanticIds and operationIds * fix length of subprotocolbody * subprotocolBody has length 2048 according to spec (#460) * subprotocolBody has length 2048 according to spec * update changelog table * Revert "update changelog table" This reverts commit 2800f50. * fix length contenttype from 100 to 128 * fix inconsistency between swagger and text spec by changing LabelType to NameType * sync last changes to patterns coming from the json schema for v3.1 * Add release date under Notice (#462) --------- Co-authored-by: zrgt <garmaev@gmx.de> Co-authored-by: Igor Garmaev <56840636+zrgt@users.noreply.github.com> Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Co-authored-by: Birgit Boss <Birgit.Boss@de.bosch.com> Co-authored-by: Michael Jacoby <michael.jacoby@iosb.fraunhofer.de> Co-authored-by: Moritz Hofer <84278634+hofermo@users.noreply.github.com> Co-authored-by: Sven Walter <waltersven@gmx.de> Co-authored-by: aorzelskiGH <48956800+aorzelskiGH@users.noreply.github.com> Co-authored-by: juileetikekar <99317579+juileetikekar@users.noreply.github.com> Co-authored-by: Alexander Gordt <100141498+alexgordtop@users.noreply.github.com> Co-authored-by: Sebastian Bader <sebastian.r.bader@web.de> Co-authored-by: juileetikekar <juilee.tikekar@idtwin.org> Co-authored-by: Alexander Gordt <alexander.gordt@objective-partner.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
The names of the files did not match to the version (v3.1) in which they are going to be published.