Show TOC

Creating Data ObjectsLocate this document in the navigation structure

Use

To create data objects for your data model, proceed as follows.

Procedure

  1. If you are using the OData Channel,

    either right-click the root data object and choose Start of the navigation path Create Next navigation step Data Object End of the navigation path, or right-click the Object Structure folder and select Start of the navigation path Create Next navigation step Data Object End of the navigation path.

    If you are using the Generic Channel, either right-click the root data object and choose Start of the navigation path Create Next navigation step Data Object Next navigation step Standard End of the navigation path, or right-click the Object Structure folder and select Start of the navigation path Create Next navigation step Data Object End of the navigation path

  2. The Create Data Object dialog box is displayed:

    Create Data Object

    Enter the name in the Data Object field and a Relation Name (both mandatory). You must enter a Relation Name, as the data object must connect to its parent. This internal relation is automatically created.

  3. The Inherit Key Fields checkbox is selected by default and means that the new data object will inherit key properties from its parent data object. Deselect this checkbox if you do not want key properties to be inherited.

  4. The Create From DDIC box is not selected by default and the following DDIC Structure Name and SAP System Alias fields are read-only.

    If you want to create the data model from an existing DDIC structure in the ABAP Dictionary, select the Create From DDIC checkbox and then enter the required DDIC Structure Name, for example, SFL_INFO. Search help is available for you to find a SAP System Alias, for example, LOCAL.

  5. Select the green checkmark to continue.

    The new data object then appears under the data model's root data object in the tree structure, and the new relation also displays, with a cardinality of 1. If you created the data model from a DDIC structure, the DDIC structure elements display as properties under the Object Structure folder, in alphabetical order.

    The Properties Editor opens for you to define the new data object. There are no mandatory fields. If you created the data model from a DDIC structure, values from the DDIC structure display in the appropriate Properties Editor fields.

  6. Save your entries.

The following fields are available for editing in the Properties Editor; the other fields are read-only.

Field

Description

Default

Entity Enabled

If selected, the data object is enabled in this data model and will be reflected at runtime. If not selected, the data object is ignored at runtime. Select this checkbox if you want to enable the data object in this data model.

Selected

Semantics

Controls how the data object is used.

  

External Name

Name of data object as represented in the external service, service document, and metadata document. For example, the data object's technical name could be 123ABC, with a more meaningful external name of Sales Order.

  

Subsc. Support

Select this checkbox to enable subscription at runtime to be notified of changes for this data object. If you do not select this checkbox, subscription for this data object cannot be enabled.

Not selected

Default Create

Select this checkbox to enable OData (Open Data Protocol) support for the Create operation at runtime. If you do not check this box, the Create operation is not supported at runtime.

Note

If you select this checkbox, you must also ensure that you include a Create operation in the data model.

Not selected

Default Update

Select this checkbox to enable OData support for the Update operation at runtime. If you do not select this checkbox, the Update operation is not supported at runtime

Note

If you select this checkbox, you must alsoy ensure that you include an Update operation in the data model.

Not selected

Default Delete

Select this checkbox to enable OData support for the Delete operation at runtime. If you do not select this checkbox, the Delete operation is not supported at runtime

Note

If you select this checkbox, you must also ensure that you include a Delete operation in the data model.

Not selected

Media Type

Select this checkbox if the entity has a related media resource stream. This is indicated in the data service metadata by the HasStream attribute applied to an entity type that is the media link entry.

Not selected

Requires Filter

Select this checkbox to indicate that this entity set cannot be queried without providing a $filter expression. If you do not select this checkbox and it is accessed without a $filter expression, an error message displays that explains in human-readable form which kinds of filter expressions are required as a minimum.

Note

This only works if at least one property in the data object has the Filterable checkbox selected in the Properties Editor (see Creating Properties).

Not selected

Addressable

Select this checkbox if you want to enable the data object to be addressed directly by a URL. If the data object cannot be addressed directly via a URL, it can only be accessed by navigating step-by-step starting from the parent node.

Not selected

Freetext Support

Select this checkbox if you want the data object to support a free-text search.

Not selected

Data Object Title

Enter a name (singular) for the data object as you want it to display in the service document. This field is used in conjunction with the Collection Title field, which defines the name (plural) of the collection to which the data object belongs. For example, the Data Object Title could be Customer. and the Collection Title could be Customers.

  

Collection Title

Enter a name (plural) for the data object collection as you want it to display in the service document. This field is used in conjunction with the Data Object Title field, which defines a name (singular) for each data object that will appear in this data object collection. For example, the Collection Title could be Customers and the Data Object Title could be Customer.