1 Getting Started with Visual Builder

To use Visual Builder you should be familiar with the tools available for building your applications.

About Visual Builder

Visual Builder provides a visual development tool and hosting environment for business users without programming experience who want to build custom enterprise applications. You create business objects and build the pages in your application using components that you place on a canvas. Visual Builder generates all the code for rendering the interface and associating pages with your business objects. No setup is required because the infrastructure for storing your data and publishing your applications are pre-configured for you.

Use Visual Builder to quickly build custom web and mobile applications that can integrate with Oracle SaaS and Paas using Fusion Applications REST services. You can create or import custom application extensions that access SaaS and other REST services, create business objects in your application from those services, and construct relationships between any of the business objects in your application. If your application is extending Oracle Sales Cloud you can embed it or create a link to the application and use Single Sign On to secure access.

Visual Builder provides the following tools for building and publishing applications:

  • A visual design tool for building pages using drag-and-drop components

  • Data management tools for managing business objects and importing and exporting data

  • Publishing tools for staging and publishing your applications

  • Integrated catalog of your REST services

About the Components of Visual Builder

Visual Builder provides all the necessary tools for building and publishing a modern web application as well as providing the infrastructure for securing access to your application, data and the Oracle Cloud services that your application consumes.

To help orient you, this summary describes some of the Visual Builder pages that you will see and use when you build your applications. Later chapters in this User’s Guide cover the pages and tools in greater detail.

Landing Page

You only see the Landing page if you log in to Visual Builder and you do not have any applications because you did not create any or you deleted all your applications. You can click New Application to open the Create Application wizard.

Description of landing-page.png follows
Description of the illustration landing-page.png

The Landing page provides links to a short video and to a tutorial that provide introductions to the Visual Builder tools and workflow for creating applications.

Main Menu

Click Main menu to toggle the main menu containing your Visual Builder tools. Some tools are grouped under headings in the menu.

Description of components-mainmenu1.png follows
Description of the illustration components-mainmenu1.png

Home Page

The Home page displays tiles that represent each of your applications and provides tools for managing the publishing lifecycle of your applications. Each tile contains an Application Options menu that contains tools for staging and publishing the application. You can open the Home page by clicking Home in the main menu.

Description of homepage-tiles-menu2.png follows
Description of the illustration homepage-tiles-menu2.png

Click New Application on the Home page to create new applications. To work on one of your applications, click the name of the application in the tile or open the Application Options menu for the application and choose Open. See About Your Application Management Tools.

Page Designer

The Page Designer has two modes that you use when building your pages and constructing business objects. Design mode enables you to build pages by dragging components from the palettes and positioning them on the canvas. Your application and all the pages are fully functional as you build them. Changes that you make to pages are immediately implemented in your application.

Description of page-designer-page1.png follows
Description of the illustration page-designer-page1.png

Live mode enables you to test the behavior of your application and enter data without leaving the Page Designer. You can switch between Live and Design modes with the toggle in the toolbar or by holding the Ctrl key (Cmd on Mac). See Using the Page Designer.

Data Designer

The Data Designer provides tools for managing your business objects and data.

Description of components-datadesigner1.png follows
Description of the illustration components-datadesigner1.png

Open the Business Objects page when you want to create business objects or modify the fields and data in your business objects.

Description of components-businessobjects.png follows
Description of the illustration components-businessobjects.png

Open the Services page to view details of the external REST services that are consumed by your application. For each service you can see details about the service’s resources that are mapped to business objects in your application.

Description of extensions-bop-addservice.png follows
Description of the illustration extensions-bop-addservice.png

You can also create business objects from the catalog of Oracle Cloud services that are associated with your Identity Domain. The connection details and security credentials for the services are already configured for you based on the role assigned to your login credentials. See Creating Business Objects.

Description of services-wizard-catalog.png follows
Description of the illustration services-wizard-catalog.png

The Data Manager page contains tools for copying data between your development, staging and live databases and for importing and exporting data files. See Managing Data During the Development Lifecycle.

Description of components-datamanager1.png follows
Description of the illustration components-datamanager1.png

Application Settings

The Application Settings page provides access to pages for configuring application settings, security and extensions.

Description of components-appsettings-all2.png follows
Description of the illustration components-appsettings-all2.png

Information About Cookies

When a user visits a published web application, a combination of cookies are used for storing authentication and session information.

Three cookies are used to store information about sessions, visits and authentication. The information we observe about visitor behavior is stored on our servers, not in the cookie placed on the browser. The cookies we use are usually an anonymous unique identifier, which provides a means of determining whether a visitor has visited the application before but does not provide any means of identifying the visitor. None of the cookies contain personally identifiable information, although, in accordance with standard HTTP protocol, the visitor’s IP address is passed to our servers as part of the HTTP request. All cookies are secured with encryption and sent over HTTPS. The following table describes the cookies that are saved to the browser of visitors visiting a published application.

Name Description

The JSESSIONID cookie is a transient cookie used for session management. This cookie only contains a session identifier. The cookie does not contain any personal details.


The OAMAuthnCookie cookie is generated by Oracle Access Manager for all clients using an Oracle Cloud service. A valid OAMAuthnCookie is required for a session.

  • Authenticated User Identity (User DN)

  • Authentication Level

  • IP Address

  • SessionID

  • Session Validity (Start Time, Refresh Time)

  • Session InActivity Timeouts (Global Inactivity, Max Inactivity)

  • Validation Hash

Removing the cookie will cause the user to be logged out. The user will need to re-authenticate the next time the user requests a protected resource.


The X-AppBuilder-SessionId cookie is a persistent cookie that expires 24 hours after it is created and contains a unique user ID (UUID) and time stamp. This cookie is only used to store visitor behavior information across sessions for billing purposes.

Removing the cookie might result in each new session being recorded as a new visit.