Examples 86 and 87 apply an entity type as term

    • Hide

      Extend the example to

      <Annotations Target="org.example.Person">
        <Annotation Term="org.example.hcm.Employee">
          ...
      </Annotations>
      

      Explain that the term org.example.hcm.Employee is of structured type. Introduce notion of an entity-valued annotation.

      This may be less confusing because we use org.example.hcm as a term namespace in Example 5.

      Go all the way and give the definition of term org.example.hcm.Employee and its type in an additional code block within this example, maybe a subset of https://schema.org/Person.

      Align the two example representations: the JSON representation has the @type control information, but the XML representation lacks the Type attribute.

      Explain that this annotation can be used in term-cast expressions in requests and give examples.

      Show
      Extend the example to <Annotations Target= "org.example.Person" > <Annotation Term= "org.example.hcm.Employee" > ... </Annotations> Explain that the term org.example.hcm.Employee is of structured type. Introduce notion of an entity-valued annotation. This may be less confusing because we use org.example.hcm as a term namespace in Example 5. Go all the way and give the definition of term org.example.hcm.Employee and its type in an additional code block within this example, maybe a subset of https://schema.org/Person . Align the two example representations: the JSON representation has the  @type  control information, but the XML representation lacks the  Type attribute. Explain that this annotation can be used in term-cast expressions in requests and give examples.
    • Show
      https://github.com/oasis-tcs/odata-specs/pull/61

      Example 86 shows an annotation and uses an entity type as term:

      <Annotation Term="org.example.person.Employee">

      ...

      This is in conflict with 14.2 Annotation where the Term attribute is defined as a reference to a Term definition.

            Assignee:
            heiko.theissen
            Reporter:
            gerald.krause1
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: