cancel
Showing results for 
Search instead for 
Did you mean: 

How to automatically generate API documentation from OData service description

michał_badura
Participant
0 Kudos
1,284

Dear Community Members,

I'm trying to publish via API Portal / API Designer my OData service, which was designed using SAP Gateway. The point is – I want the documentation to be generated automatically, with no manual adjustments, if possible.

So I learned, I can retrive my OData service and generate an API proxy in API Portal. In order to achieve this, I choose the Create button:

In the new popup I select the API Provider and choose the Discover button, select the service and confirm my choice with the OK button. I can adjust some Attributes, and for Service Type ODATA I can even fetch advanced service documentation from service metadata. (Unfortunatelly I don't know, why the Description is in German: my logon language was English, but there was only German description for the service in my backend system.)

At this point I would expect that at least the labels are taken over (the purpose of that strange label with all German and Polish special characters will be explained later). But no:

On the other hand, when I use the API Designer and copy and paste the metadata XML file for my OData service, I get the descriptions. But where are my special characters? And why are all of the sudden the attributes id and notificationId marked as optional??

I would appreciate any clues or suggestions.

Best regards

Michał

Accepted Solutions (0)

Answers (0)