5 Work with Business Objects

A business object is a resource, such as an invoice or purchase order, similar to a database table; it has fields that hold the data for your application. Like a database table, a business object provides the structure for data. Business objects are stored in a database. The apps in your visual application and other clients access the business objects via their REST endpoints.

About Working with Business Objects

The Business Objects pane in the Navigator lists all the business objects that are available for use in your application.

You use the Business Objects pane to browse your business objects, create new business objects and open pages where you can edit the business objects. The pane contains a button for creating business objects and an Options menu to open the Data Manager and business object Diagrammer. See Work with the Data Manager and Work with the Business Object Diagrammer.

Description of artifact-browser-business-objects.png follows
Description of the illustration artifact-browser-business-objects.png

After a business object is created, you can select the business object in the Business Objects pane to view and edit the business object’s details, including details about its fields and data, related objects and security settings. Selecting a business object in the pane opens the business object’s page in the editor. The following table describes the tabs in a business object’s page that you use to edit business objects.

Tab Description

The Overview tab displays the Id of the business object and contains fields for specifying the singular and plural forms for the label used to identify the business object. The Overview tab also contains the following items:

  • Relationships. Displays the relationships between the business object and other business objects in your application. See View, Create, and Edit Business Object Relationships.

  • Contains Application Setup Data. When enabled, the data in the business object is considered to be required for the application to function properly, for example, data used in a list of values (LOV) referenced by another business object. When enabled, the data in the business object will always be included when you export or publish the application. See Export a Visual Application.


The Fields tab contains a table displaying the fields defined for the business object. The tab contains a New Field button for defining new fields. You can select a field in the table to edit its properties in the editor. See Edit Fields of Business Objects.


The Security tab is used to enable role-based security for the business object, and, when enabled, to specify the operations that can be performed by users based on the user role they are assigned. See Secure Business Objects.

Business Rules

The Business Rules tab contains a visual editor for creating custom business rules that can perform functions, such as field validation, that can be triggered by object events and actions. See About Adding Business Rules.


The Endpoints tab contains a list of the endpoints that are available for the business object. It also contains the resource APIs, the URLs that can be used to access the metadata and data of the business object.

To edit endpoints and expose only those that your application requires, see Add or Remove Exposed Endpoints.

To allow other clients and applications access to the APIs using basic authentication, see Manage User Roles and Access and About Allowing Access to the Catalog API.

See View the Endpoints of Business Objects.


The Data tab contains a table that displays the data stored in the fields of the business object. The tab contains tools for adding and editing the data. See View and Edit Data in Business Objects.