Creating a Simple Application in Oracle Visual Builder Cloud Service

Oracle by Example brandingCreating a Simple Application in Oracle Visual Builder Cloud Service

section 0Before You Begin

This is the first tutorial in the Visualizing Data module. It takes approximately 15 minutes to complete.

Background

Oracle Visual Builder Cloud Service is a visual development tool for creating web and mobile applications by simply dragging and dropping UI components onto a page. You don't need any programming experience to develop an application.

In this tutorial, you'll create a simple application and import data. You'll use this application to as the basis for learning about charts and gauges.

The images in this tutorial sequence show the standalone version of Oracle Visual Builder Cloud Service. If you are using the Oracle Integration Cloud version, you will see an additional menu at the top of each page that lets you switch between Visual Builder and Integration Cloud.

Top menu
Description of the illustration vbcs_oic_menu.png

What Do You Need?

  • Access to Oracle Visual Builder Cloud Service
  • A supported browser (see Known Issues for Oracle Visual Builder Cloud Service for more information)

section 1Create an Application

In this step, you will create a simple application with three pages.

  1. In the web browser, log in to Oracle Visual Builder Cloud Service.
  2. On the Home page, click New Application and select Web.
  3. In the Application Name page of the Create Application wizard, enter the following values:
    • Application Name: Charts Application
    • Description: Charts and gauges tutorial application
    The Application ID text field is automatically populated based on the Application Name.
    Application Name page in Create Application wizard
    Description of the illustration vbcs_s1_1_createapplication.png
    Click Next.
  4. In the Application Template page of the Create Application wizard, select the Oracle Applications Cloud UI template (the default) and click Next.
    Application Template page in Create Application wizard
    Description of the illustration vbcs_s1_2_template.png
  5. In the Application Navigation page of the Create Application wizard, create the application tabs. By default, one tab with Home as its label is available. Replace the Home text in the Label field with Summary to rename the tab label. Click + Tab to create another label field and enter Sales Regions as the label.  Click + Tab to create a third label field and enter Sales Objectives as the label.
    Application Navigation page in Create Application wizard
    Description of the illustration vbcs_s1_3_navigation.png
  6. Click Finish. Your Charts Application is now created and opens in the Page Designer.

section 2Add Business Objects

In this step, you'll use Data Palette of the Data Designer to create three business objects. These will be used by the charts and gauges you create in the other tutorials in this module.

  1. If necessary, click the Main menu Main Menu icon in the top-left corner and select Page Designer.
    Main menu
    Description of the illustration vbcs_s2_1_page_designer.png
  2. In the Page Designer, click the Data palette.
    Data palette
    Description of the illustration vbcs_s2_2_datapalette.png
  3. Click + New Business Object.
    Create new business object
    Description of the illustration vbcs_s2_3_newobject.png
  4. In the pop-up box, enter Region.
    New business object pop-up
    Description of the illustration vbcs_s2_4_newobject_popup.png
  5. Click the OK icon. The Region business object is created with some fields.
    New Region business object
    Description of the illustration vbcs_s2_5_newobject_region.png
  6. Click + New Field. In the pop-up box, enter the following details:
    • Default Display Label: Name
    • Field ID: name (automatically populated)
    • Field Data Type: Text Text (selected by default)
    Name field pop-up box
    Description of the illustration vbcs_s2_6_region_name.png
    Click the OK icon to create the field.
  7. Click + New Field. In the pop-up box, enter or select the following details:
    • Default Display Label: Population
    • Field ID: population (automatically populated)
    • Field Data Type: Number Number
    Population field pop-up box
    Description of the illustration vbcs_s2_7_region_population.png
    Click the OK icon to create the field.
  8. Click + New Business Object and create a Sales business object in the same way you created the Region business object (steps 3-5).
  9. Click + New Field. In the pop-up box, enter the following details:
    • Default Display Label: Region
    • Field Data Type: Reference Reference
    • Field ID: ref2Region (automatically populated)
    • Reference Business Object: Region (automatically populated)
    • Default Displayed Field: Name
    Region field pop-up box
    Description of the illustration vbcs_s2_8_sales_refregion.png
    Click the OK icon to create the field.
  10. Click + New Field. In the pop-up box, enter the following details:
    • Default Display Label: Year
    • Field ID: year (automatically populated)
    • Field Data Type: Number Number
    Name field pop-up box
    Description of the illustration vbcs_s2_9_sales_year.png
    Click the OK icon to create the field.
  11. Click + New Field. In the pop-up box, enter the following details:
    • Default Display Label: Sales
    • Field ID: sales (automatically populated)
    • Field Data Type: Currency Currency
    Sales field pop-up box
    Description of the illustration vbcs_s2_10_sales_sales.png
    Click the OK icon to create the field.
  12. Click + New Business Object and create a Summary business object in the same way you created the Region business object (steps 3-5).
  13. Click + New Field. In the pop-up box, enter the following details:
    • Default Display Label: Region
    • Field Data Type: Reference Reference
    • Field ID: ref2Region (automatically populated)
    • Reference Business Object: Region (automatically populated)
    • Default Displayed Field: Name
    Region field pop-up box
    Description of the illustration vbcs_s2_11_summary_refregion.png
    Click the OK icon to create the field.
  14. Click + New Field. In the pop-up box, enter the following details:
    • Default Display Label: Year
    • Field ID: year (automatically populated)
    • Field Data Type: Text Text (selected by default)
    Year field pop-up box
    Description of the illustration vbcs_s2_12_summary_year.png
    Click the OK icon to create the field.
  15. Click + New Field. In the pop-up box, enter the following details:
    • Default Display Label: Sales
    • Field ID: sales (automatically populated)
    • Field Data Type: Currency Currency
    Sales field pop-up box
    Description of the illustration vbcs_s2_13_summary_sales.png
    Click the OK icon to create the field. You have now created the business objects and can import data.

section 3Import Data

In this step, you will import data from a zip file to all business objects of the application.

Before you start, download the chart_cpplication.zip file to your machine. Right-click this link and choose Save As to download the zip file. The zip file contains CSV files for the business objects of the Charts Application. Feel free to review the contents of the zip file.

Note: You cannot add new fields to a schema or edit their properties by importing data from a file. The names and data types of columns in the imported data must match the names and data types of columns in the schema.

  1. Click the Main Menu icon Main Menu in the top-left corner and click Data Designer.
    Data designer
    Description of the illustration vbcs_s3_1_datadesigner.png
  2. Click the Data Manager tile.
    Data Manager
    Description of the illustration vbcs_s3_2_datamanager.png
  3. Ensure that Development is selected in the Database menu.
    Data Manager
    Description of the illustration vbcs_s3_3_development.png
  4. Click Import from File.
    Import from CSV Files
    Description of the illustration vbcs_s3_4_import.png
  5. In the Confirm Import Data dialog, click Upload a file, browse, and select the chart_application.zip file.
    Confirm Import Data dialog
    Description of the illustration vbcs_s3_5_importconfirm.png
  6. Click Import.
  7. In the Import from File dialog, click OK.
    Import from File dialog
    Description of the illustration vbcs_s3_6_importok.png
  8. You have now imported data to the application, and can create charts and gauges that display that data.