Show TOC

Creating a Service Builder ProjectLocate this document in the navigation structure

To develop a service using SAP Gateway Service Builder, you have to create a project. Service Builder uses projects to bundle all the artifacts to develop a service in one central place and thereby helps you to organize service development and modeling process. You can use projects to organize the transport of objects from one system environment to another, so that all the artifacts remain together at all times. Three types of projects can be created in Service Builder:
  • Choose Service with SAP Annotations if you want to annotate data model artifacts using standard SAP annotations. SAP annotations include Creatable, Updatable, Label,, UnitProperty, for example. Available annotations can differ according to the data model artifact you want to annotate. You can also define the facets: Nullable, Default, MaxLength, FixedLength, Precision, Scale, for example. The ABAP type information available includes ABAP field name and ABAP Type Editor.
  • Choose Service with Vocabulary-Based Annotations if you want to annotate data model artifacts using terms to provide additional information about the artifact. Standard SAP annotations are not available for this project type. In this case, terms can be consolidated in a vocabulary and uploaded into the Vocabulary Repository. The Vocabulary Repository includes a set of vocabulary files such as Org.OData.Atom.V1 and Org.OData.Capabilities.V1.
  • Choose Annotation Model for Referenced Service if you want to annotate an artifact of an existing service without modifying the service and provide additional information about the artifacts. Unlike in project type Service with Vocabulary-Based Annotations, in this project type you can import another service as a reference in read-only mode and then create annotations.
Procedure
To create a Service Builder project, proceed as follows:
  1. Click Project from the main menu, and select Create, and then enter a name for the new project. The project name must be unique and must not contain any spaces or special characters, however, it may contain underscores. Input help is available so that you can check the project names already in use.
  2. Enter a description for your new project. This is a mandatory field and you cannot create a new project without defining a description. The description is displayed in the Service Builder along with the project name. It can be used to provide additional context information about your project. The short description must not exceed 60 characters.
  3. Under Attributes select the project type you want to create. The project type you select when creating a project cannot be changed later.
    • Select Service with SAP Annotations if the OData service in your project is to use standard SAP annotations.
    • Select Service with Vocabulary-Based Annotations if the OData service in your project is to use vocabulary-based annotations.
    • Select Annotation Model for Referenced Service if the OData service has to be annotated externally without modifying the service. You can create and upload customer-specific vocabularies into the Vocabulary Repository. The uploading of vocabulary files is an optional preparatory step as there are standard delivered vocabularies available.
  4. Under Attributes, specify the generation strategy that is to be used. The standard generation strategy is used as default, but other generation strategies are feasible. If no customer-specific generation strategies have been defined in the system, enter Standard as default to indicate that the standard generation strategy is used.
  5. Under Object Directory Entry, enter the name of the package in which you want to create new project and click Enter.
Note If you do not want to create the project in a package that is transported from one system to another in system landscape, enter $TMP or choose Local Object. This ensures that the object is created locally.
Result
The Service Builder creates the new project together with an empty folder structure. You can see the newly-created project structure in the tree view in the left-hand screen area. The project structure comprises the following folders and subfolders:
  • Data Model
    • Entity Types
    • Associations
    • Entity Sets
  • Service Implementation
  • Runtime Artifacts
  • Service Maintenance
Note Service Implementation node is not created for projects of type Annotation Model for Referenced Service.
After creating the project you can also set schema namespace for the Data Model. Schema Namespace can be explicitly set for the projects of type Service with SAP Annotation and Service with Vocabulary Based Annotation. The name can be further modified. For the projects of type Annotation Model for Referenced Service, schema namespace is same as that of the referenced service. For more information, see Schema Namespace.

To save the newly-created project in Service Builder, click Save. Your project is saved and you can subsequently return to the Service Builder at any time, open this project, and continue service development and modeling process. If you do not save your project, a warning message appears prompting you to save the project.

Related Information