SAP OData missing __metadata property about odata-openapi

[ralfhandl]

One could argue that the purpose of the generated OAS is that clients don't need to know about OData. (Did I actually write this? In my opinion everyone should know about OData 😃)

I'd be willing to test and merge a pull request if you would want to add that feature. The __metadata property would only be needed for the "read" structure of an entity type, so to be added in template properties, and only if test="$odata-version='2.0' and not($suffix) and local-name($structuredType)='EntityType'".

[ralfhandl]

Added simple test script https://github.com/oasis-tcs/odata-openapi/blob/master/tools/test.cmd

Runs XSLTs for a bunch of test input files and uses git diff to show what has changed.

[ralfhandl]

That's standard OData V2, you can also see it in the public Northwind V2 service.

It is not reflected in $metadata because it is there by default in all V2 "Verbose JSON" responses.

It is currently also not reflected in the generated OAS because it always has the same structure, see OData V2 Specification, 2.2.6.3.3 Entity Type (as a JSON Object)

[snebjorn]

I see. It's good that it's not a special case, makes things a bit easier :)

It is currently also not reflected in the generated OAS because it always has the same structure

I'm using the OAS to generate a client (https://github.com/OpenAPITools/openapi-generator). When the property is missing I have to alter the generated model to include __metadata.
So in that scenario adding it has some value :)

I guess the counter argument is that the openapi-generator should know it's an OAS for an ODATA data source and include these default properties.

Not sure which is the better option.

[snebjorn]

I'll have a look

[snebjorn]

I need some help with this one. I'm bad at XSLT :(
Just needed to sleep on it