Uploading Vocabularies into the Vocabulary Repository

Instructions for uploading a vocabulary file into the Vocabulary Repository.

Context

If you want to use customer-specific annotations in addition to core attributes (SAP annotations) when defining data model artifacts in Service Builder projects, you can upload the annotations you require collectively in the form of a vocabulary file into the Vocabulary Repository. The Vocabulary Repository already includes a selection of standard vocabulary files and these are available in the /IWBEP/ namespace. You can import the annotations contained in a vocabulary file into Service Builder projects of type Service with Vocabulary-Based Annotations and Annotation Model for Referenced Service. After you have imported the relevant vocabulary files into your project, you can use vocabulary-based annotations to define additional information about the artifacts in your data model.

To upload a vocabulary file into the Vocabulary Repository in the Service Builder, proceed as follows:

Procedure

Start the Service Builder in transaction SEGW.
Choose Extras Vocabulary Repository. The central Vocabulary Repository opens and shows a table for displaying the vocabulary ID, version, namespace, and description. Any previously uploaded vocabulary files are displayed here, otherwise the table is empty.
Click (Display<-> Change) to change to edit mode and click (Insert Row) to add a new row to the table.
Enter a unique vocabulary ID for the vocabulary file you want to upload. Version 1 is assigned automatically to the first version of the vocabulary file you upload.
Click (Upload Content) in the Upload Vocabulary Content column to navigate to the vocabulary file you want to upload. The namespace of the vocabulary file is entered automatically.
Enter a description for the newly added vocabulary file.
Save the changes and click Enter.

Results

Subsequently, the uploaded vocabulary file can be imported into Service Builder projects of type Service with Vocabulary-Based Annotations and Annotation Model for Referenced Serviceso the terms defined in this file can be used to annotate data models.