4 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 can view your business objects, create new ones, and open pages where you can edit object details. You can also create diagrams to visually represent business objects and their relationships (see Work with the Business Object Diagrammer).

Use the + button on the Business Objects pane to create business objects and business object diagrams. Use the Menu option to open the Data Manager, where you can work with business object data (see Work with the Data Manager).

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 it in the Business Objects pane to view and edit details such as fields and data, related objects, and security settings. The following table describes the tabs in a business object's editor:

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 includes the following options:

  • 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 and Stage and Publish Visual Applications.

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


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. See View a Business Object's Endpoints.

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

To define a caching strategy that safely stores the business object's data, see Control Data Caching for Business Objects.

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.


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.