You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: tutorials/odata-dd-5-annotations/odata-dd-5-annotations.md
+68-2Lines changed: 68 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,6 +24,72 @@ The members of the OData Technical Committee have worked hard on OData as a robu
24
24
25
25
---
26
26
27
-
### Step 1
27
+
### Examine the rest of the entity model wrapper
28
28
29
-
...
29
+
In the previous [Metadata](https://developers.sap.com/tutorials/odata-dd-4-metadata.html) tutorial we saw how the schema was presented within a context. That context is called the [entity model wrapper](https://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html#_Toc453752500). We left the examination of part of that wrapper - the references to vocabularies, to this tutorial. Let's start by digging into those now.
30
+
31
+
Here's what the relevant section of the wrapper looks like (with a little bit of whitespace to help readability):
What are these references? Well, section [3.3 Element edmx:Reference](https://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html#_Toc453752504) of the CSDL standards document is helpful here (after section [3.1 Element edmx:Edmx](https://docs.oasis-open.org/odata/odata/v4.0/errata03/os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html#_Toc453752504) tells us that there can be zero or more of them).
53
+
54
+
Basically, `edmx:Reference` elements point to external CSDL documents, specific content from which (indicated by the `edmx:Include` elements within) is then added to the overall scope of the referring (OData metadata) document. Think of it like an "include" as found in various programming languages.
55
+
56
+
Note that each of the referenced external documents in our OData metadata document are resources in GitHub repositories:
57
+
58
+
- two belonging to OASIS in <https://oasis-tcs.github.io/odata-vocabularies/>
59
+
- one belongint to SAP in <https://sap.github.io/odata-vocabularies/>
60
+
61
+
Taking the first of the three `<edmx:Reference>` elements here, we see that:
62
+
63
+
- the reference points to an [XML representation](https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Capabilities.V1.xml) of a CSDL document "Org.OData.Capabilities.V1"
64
+
- moving one level up from the document resource's location, there is an [overview page](https://oasis-tcs.github.io/odata-vocabularies/vocabularies/) listing each of the OASIS Technical Committee vocabularies (including this "Capabilities" one), and for each of these resources there are HTML, XML and JSON representations
65
+
- the HTML representation is especially useful for us as it describes the vocabulary's purpose in general, and gives details for each of the terms and types contained within it
0 commit comments