Is there a comprehensive UI5 Annotation Reference and Guide somewhere?

[martinc_mb]

Something I am struggling to understand is the concept of local annotations to OData service metadata in UI5 apps (specifically for OData v4, I think...).

I have managed to do little things like make an input multi-line, or hide and element, by using examples gleaned from here or there, but I cannot find any comprehensive reference on annotations, and especially a good guide that explains the basic concepts, and how annotations are structured (For example, when and how do you use Collection and Record and Propertypath elements, etc).

There are little bits of documentations and blogs that show how to do one thing all over the place, so it's really a lot of trial and error (and mostly error!) and little to no success.

If anyone knows of a comprehensive body of documentation that covers this topic, please share!

[Marian_Zeis]

Best way is to create annotation in your Backend System and not locally (CAP or RAP).

You can find showcases here:

RAP: https://github.com/SAP-samples/abap-platform-fiori-feature-showcase 
CAP: https://github.com/SAP-samples/fiori-elements-feature-showcase 

More information about the annotions in this blog post:
https://community.sap.com/t5/technology-blogs-by-sap/vocabulary-based-annotations/ba-p/13046984 

[martinc_mb]

Hello Marian, thanks for the reply.

However, in situations where you should or need to make use of local UI5 annotations, there must surely be a comprehensive guide from SAP on how to use it; after all, they show it here and there in the SDK documentation as a viable options, so it's reasonable to expect there should be some better documentation for it. 

[PeterSpielvogel]

These resources might help.

https://ui5.sap.com/#/topic/83c89ccef12f48ab98f6c3811bd025b3

https://ui5.sap.com/#/topic/03265b0408e2432c9571d6b3feb6b1fd 

[martinc_mb]

Hello Peter, thanks, I've looked through all of that as well, but that is far from comprehensive! It really only touches lightly on the subject and in the SDK. Moreover, the first link expressly says that it has not been updated for OData v4.

Surely SAP must have detailed documentation on this internally. How about making that available to the community?