SAP Vocabularies for semantic markup of structured data published via OData services.
This repository defines the following SAP vocabularies:
- Analytics: Analytical resources
- CodeList: Code Lists
- Common: Semantics common to all types of APIs
- Communication: Contact information based on vCard
- Graph: SAP Graph - experimental
- Hierarchy: Hierarchies - experimental
- ODM: One Domain Model - experimental
- PersonalData: Personal data / GDPR
- Session: Sticky Sessions
- UI: Representing data in user interfaces
- HTML5: Rendering directives for UI5
These vocabularies complement the OASIS OData Vocabularies published by the OASIS OData Technical Committee.
Check the annotation cheat-sheet to learn how to construct an annotation value from a term definition, or vice versa.
Each vocabulary in this repository is described by three files: the *.xml
source file, an auto-generated equivalent *.json
representation, and a *.md
Markdown description, also auto-generated from the *.xml
source.
No specific tools are needed to use these vocabulary files.
Contributors to this repository will need to run the generators, which require Node.js to be installed.
The tools in this repository are only needed by contributors to refresh the *.json
and *.md
files after changing the *.xml
source files. These tools require Node.js to be installed.
Clone or download this repository, go to its root folder, and type
npm install
Edit only the XML files, then refresh the JSON and Markdown files with
npm run build
No known issues.
See CONTRIBUTING.md.
See CONTRIBUTING.md.
Copyright (c) 2016 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache License Version 2.0, except as noted otherwise in the LICENSE file.