SOL009 issueshttps://forge.etsi.org/rep/nfv/SOL009/-/issues2022-01-19T11:54:19Zhttps://forge.etsi.org/rep/nfv/SOL009/-/issues/4Query params should not be defined as global parameters in SOL009_params.yaml.2022-01-19T11:54:19ZVlademir BrusseQuery params should not be defined as global parameters in SOL009_params.yaml.SOL009 is using the same parameters in the file SOL009_params.yaml of the GET methods for all interfaces, but the query parameters can be different for each GET method.
Giacomo answered the following:
“The only open point remains the u...SOL009 is using the same parameters in the file SOL009_params.yaml of the GET methods for all interfaces, but the query parameters can be different for each GET method.
Giacomo answered the following:
“The only open point remains the use of query parameters, for which you are right in some cases they should not be defined as global parameters in SOL009_params.yaml.
Given the fact this issue requires a thorough review of all the OpenAPIs, and most of all that the misalignment with the spec only involves the description field of the query parameters for the various operations, I'd suggest to implement this work for next version of OpenAPIs (i.e. ed361).”Giacomo BerniniGiacomo Berninihttps://forge.etsi.org/rep/nfv/SOL009/-/issues/3OpenAPI wiki page - NFVManoConfigurationAndInformationManagement-API of v3.5....2022-01-31T11:10:58ZVlademir BrusseOpenAPI wiki page - NFVManoConfigurationAndInformationManagement-API of v3.5.1 showing several errors on "Editor" page.In the "NFVManoConfigurationAndInformationManagement-API" of SOL009 v3.5.1 it is showing several errors when rendering the swagger "Editor" page on Chrome browser.
The use of "oneOf" should be investigated here since in v3.3.1 does not ...In the "NFVManoConfigurationAndInformationManagement-API" of SOL009 v3.5.1 it is showing several errors when rendering the swagger "Editor" page on Chrome browser.
The use of "oneOf" should be investigated here since in v3.3.1 does not have this issue. If so, we need a solution for that.
Structural error at paths./peer_entities.post.requestBody
should have required property '$ref'
missingProperty: $ref
Jump to line 18171
Structural error at paths./peer_entities.post.requestBody
should match exactly one schema in oneOf
Jump to line 18171
...
Giacomo answered that "this is because some data types inside this API have "type" as attribute names, which is also an OpenAPI keyword. So it is a kind of warning that the editor page tool gives to signal it. Not sure how to be avoided to be honest, as we cannot change the attribute name "type" otherwise it will not be compliant with SOL specs."Giacomo BerniniGiacomo Berninihttps://forge.etsi.org/rep/nfv/SOL009/-/issues/2OpenAPI wiki page - "models" session in "UI" links and "schemas" session in "...2022-05-28T07:54:10ZVlademir BrusseOpenAPI wiki page - "models" session in "UI" links and "schemas" session in "Editor" links.All APIs in the OpenAPIs wiki page have:
- UI links – there is a “models” section in OpenAPIs swagger UI pages, this section does not exist in other APIs
- Editor links – there is a “schemas” section in OpenAPIS swagger Editor pages,...All APIs in the OpenAPIs wiki page have:
- UI links – there is a “models” section in OpenAPIs swagger UI pages, this section does not exist in other APIs
- Editor links – there is a “schemas” section in OpenAPIS swagger Editor pages, this section does not exist in other APIs
These issues were reported before, I think in v3.3.1, as these sections are not showed in other APIs there is a need to make them as a standard, the sections need to be removed in SOL009 or included in the other APIs.Giacomo BerniniGiacomo Bernini