Create New/Edit Business Object

To create or edit a business object:

1. In the Name field, enter a name for the business object.
   The name is displayed in lists when selecting a business object.

   Note:

   A business object name cannot include the reserved words Business Object.
2. (Optional) In the Description field, enter a description for the business object.

   The description is displayed below the name in the Assets page. Ensure that the description helps users determine if they want to use this particular business object.

3. On the Data Sources tab, define the data source to retrieve the data for the business object:

   Note:

   If you want to select an existing REST data source, but know that the underlying data has changed, you can exit the wizard and go to the Assets page of the portal to edit the data source, where you can select Refresh Schema to refresh the data source and business object with changes such as added, deleted, or renamed attributes. For more significant structural changes, you will need to re-create the data source, and any data visualizations where it is used.

   1. From the Type list, select the type of data source from which the business object will retrieve data (REST or SQL).
      The generated list shows all data sources that are portal assets of the selected type.
   2. From the generated list of data sources, select the required data source.
   3. From the Method list, select the method to be used to retrieve the data (for example, GET).
   4. In the generated list of methods, click the Expand icon on a method to view the attributes associated with the selected data source, then click the check boxes to select each attribute required by the business object. Click the UnSelect Children icon to deselect all check boxes.
4. On the Configuration tab:
   1. Click the Edit icon next to a method or attributes to modify a name or description for the Source retrieved from the data source.
   2. Click the Delete icon next to a method or attribute to remove it from the data to be retrieved by the business object.
5. On the Parameters tab, if parameters are present, click Edit to modify the name and/or value of a parameter.

   Parameters listed are those retrieved from the data source. For example, if you create a SQL data source using a query with bind variables, then all bind variables are exposed as parameters. Similarly, for a REST data source, parameters are specified in the Resource URL (for example, http://example.com/stocks?symbol=ORCL, where symbol is a parameter). Parameter names in a business object are formed using the syntax paramName_method. For example, using the REST data source example above, the default business object parameter name will be symbol_GET. You can change the name of the parameter as desired.

6. On the Preview tab, click Test to preview the data retrieved from the data source based on your selections.
7. Click Save.

   The newly created business object is listed on the Assets page. By default, the check box in the Available column is selected, indicating that the business object is published and available to users to bind to a data visualization.