Creating Your Web Application

You view and manage the applications in your identity domain from the Home page. Use the tools on the Home page to open applications, manage the publishing lifecycle of your applications and create new applications.

About Your Application Management Tools

The Home page is the primary console for managing your applications and for creating new applications.

The Home page is the main entry point and the first page that you see each time that you log in to Oracle Visual Builder Cloud Service. On the Home page you can see the status of each version of your applications and select the application that you want to open. The Home page also contains tools for managing the publishing lifecycle of each application.

Managing Applications

Each tile on the Home page represents a version of one of your applications. The identity domain might contain many applications, but your Home page will only display the applications that you created or where you are included as a team member.

Each tile contains an Application Options menu with commands for managing the application.


Description of homepage-tilemenu-menu-oic.png follows
Description of the illustration homepage-tilemenu-menu-oic.png

The following table describes the commands that you might see in the menu.

Menu Item Description
Open Opens the development version of the application.
Duplicate Creates a clone of this version of the application, including the content of the database
Rename Opens a dialog box where you can change the name of the application.
Export Creates a zip archive of the project that can be imported as a new application.
New Version Creates a new version of the same application. By default the new version is a development version. Version numbers are automatically increased incrementally.
Push to Environment Opens a dialog box where you can send a request to push the application to an associated environment. If you have access to multiple associated environments, you can select the target environment in the dialog. The push is performed when the administrator of the target environment accepts the request.

This command is only available after an application has been staged. You can only push the staged version of an application to another environment.

Cancel Push to <ENVIRONMENT_NAME> Enables you to cancel your request to push the application to an associated environment. This command is available only before the push request is accepted.
Stage Opens a dialog box where you can specify the database option for the staged application. When an application is staged a link to the staged version is displayed in the tile.
Publish Opens a dialog box where you can specify the database option and publish the staged version of your application.
Publish as Template Opens a dialog box where can add an image that is used to represent the template in the Create Application wizard. The application becomes read-only after you publish it as a template.
Lock / Unlock Enables you to lock a live application to prevent any users from using the application. You would usually use this command when you are going to update the live application with a newer version. The Unlock option is displayed only when the live application is locked.
Rollback Rolls back the live version to the previous live version. This is only available for the current live version.
Delete Deletes the application from the Identity Domain. You cannot undo this action.

Application Status

Each tile displays the current status of the application. The default status for new applications is Development. The tile displays a link to the current staged and live versions of the application. See About Staging and Publishing an Application.


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

The following table describes the application status.

Status Description
Development

This status is the default for all new versions of applications and is used if the version has not been staged or published. You can make changes to the development version at any time.

Staging

This status indicates that you recently staged this version of the application. The tile contains a link that will open the staged version in your browser.

Live

This status indicates that this version of the application was published and is now read-only. An application can no longer be modified after it is published. The link in the tile will open the live version in your browser.

Live Locked

This status indicates that this version of the application was published but is currently locked and it cannot be opened in your browser. Use the Application Options menu to lock and unlock a live application. You should lock an application when you want to export the live database prior to publishing a new version.

Pending Push Request

This status indicates that a request was submitted to push the staged version of the application to an associated environment and the request is pending a response. You can make changes to your application while you are waiting for a response but the request must be accepted or denied before you can stage a new version.

Template

This status indicates that the application was published as a template and is now available to developers in the tenant space as a template for creating applications. Application templates are read-only.

Obsolete

This status indicates that this version was published but has been superseded by a newer version. Obsolete applications are read-only.

Tip:

You can filter the list of applications displayed on the page by name, status and type. Click the Filter toggle at the top of the page to open the filter options drawer and select the filters you want to apply. You can use the Sort By dropdown list to organize the order that the tiles are listed on the page.

Creating a New Web Application

You create applications from the Oracle Visual Builder Cloud Service Home page.

The Home page provides several tools for creating applications. You use the Create Application wizard to create new applications from application templates. When you select either the Alta or Fuse template that are available to all users by default, the new application will use the theme provided by the template. New applications created from custom application templates might include different themes, and have some pages, business objects and other resources already defined in the template.

To create a new application:

  1. Open the main menu and click Home.
    After you create your first application from the Landing page, you create all subsequent applications from the Home page.
    Description of homepage-newwebapp.png follows
    Description of the illustration homepage-newwebapp.png
  2. Click New Application and select Web in the menu to open the Create Application wizard.
  3. Enter a name and description of the application. Click Next.
    The name of the application is used to generate the Application ID for the application. You can modify the Application ID if you wish. The Application ID forms part of the context path for the application and will be visible in the URI of the application.
  4. Select an Application Template. Click Next.
    The Application Template page displays the three default application templates and any other application templates that are available in your tenant space.
    Description of homepage-newapp-template2.png follows
    Description of the illustration homepage-newapp-template2.png
  5. Type a name for each navigation tab that you want to create in the new application.
    The default application templates have one default tab. Other templates might define additional tabs that you can move or remove in this page of the wizard. You can click Add Tab to create additional tabs. You can also modify the tabs and navigation later in the Page Designer.
  6. Click Finish.
When you click Finish the application is created and the landing page of the application opens in the Page Designer. The new application is automatically designated version 1.0. The new application is provisioned with an empty development database. If the application is based on a custom application template, the new application might already contain some business objects.

Creating a New Version of an Application

You can create versions of applications to enable parallel, independent development of an application.

Each version of an application is an independent branch with its own copy of the resources and database schema. Using multiple versions enables you to work on one version, for example, to fix an issue, without disrupting ongoing development on another branch. You can stage and publish any version of your application. You can have multiple versions of your application staged simultaneously, but you can only have one live version. Each staged version has a unique URI to help you identify the version, but all versions will have the same URI when published. After you publish a version of your application it is locked as “read-only”. To make any changes to your application after it is published, for example, to fix an issue, you need to create a new version and fix the issue in the new version.

Note:

If you make a change in one version, for example, to fix an issue, you will also need to manually make those changes to any other versions of your application that you want to include that change.

To create a new version of an application:

  1. On the Home page, locate the application that you want to update.
    You can create a new version from any version, in any stage of the development lifecycle.
  2. Open the Application Options menu for the version and click New Version.
  3. Specify the new version number and enter a comment in the New Application Version dialog box. Click Create.
    You can number your versions according to your versioning scheme, but each version number must be unique.
    Description of homepage-newversion-dialog.png follows
    Description of the illustration homepage-newversion-dialog.png
When you click Create the new version is created and the application opens in the Page Designer. The new version has Development status.

Creating a Copy of an Application

You can create copies of an application using the copy option in the Application Options menu or by importing an application archive.

A copy of an application contains all the resources and the database schema of the source, but will have a different name, application ID and URI. You can use the copy option if the application you want to copy is visible on your Home page.

To create a copy of an application:

  1. On the Home page, locate the version of the application that you want to copy.
  2. Open the Application Options menu and choose Copy.
  3. Type the Application Name and Application ID in the Copy Application dialog box. Click Copy.
    The Application ID is used in the URI for the new application.
    Description of homepage-copy-dialog.png follows
    Description of the illustration homepage-copy-dialog.png

Importing and Exporting Applications

You can download archives of applications to your local system and create copies of applications by importing application archives.

Applications can be exported as archives that can be imported to create copies of the application. An application is downloaded as a zip archive to your local system when you select Export in the Application Options menu. The archive can be shared with other users or imported as a new application. 

To import an application:

  1. On the Home page, click Import.
    Use the Import Application dialog box to upload the archive of the application.
    Description of homepage-importapp-dialog.png follows
    Description of the illustration homepage-importapp-dialog.png
  2. Upload the application archive from your local system.
    You can drag the archive from your local system into the dialog box or click Upload a file to navigate to the location of the archive.
  3. Type the Application Name and Application ID. Click Import.
    The Application Name and ID are automatically populated based on the archive, but you might need to modify the name and ID because they must be unique in your identity domain.

Creating Application Templates

When creating a new application you use application templates to provide the themes that determine the look and feel of the application.

Application templates are created by converting an application to a template, and the template includes all the resources in the application, including any custom themes and UI components, as well as pages and business objects. When you create an application from the template in the Create Application wizard, the new application contains all the resources in the template. Application templates are available in the Create Application wizard to all users in the tenant space.

Note:

An application becomes read-only after it is converted to a template.

To create an application template:

  1. On the Home page, locate the version of the application that you want to publish as a template.
  2. Choose Publish as Template in the Application Options menu.
  3. Upload an image for the template.
    The image is used to represent the template in the Create Application wizard.
    Description of homepage-publish-template2.png follows
    Description of the illustration homepage-publish-template2.png
  4. Click Publish.
The published template will be available to all users in the tenant space.

Adding Team Members

Add team members to an application to enable other members of the identity domain to contribute to development.

Each application can have multiple members who can work on the application at the same time.

Note:

You will see a notification in your browser if you try to make changes to the application while another member is actively working on it.

To add a team member to an application:

  1. On the Home page, locate the version of the application.
  2. Click the Flip button to flip the tile.
    For each version of an application you can “flip” the tile to see the Team and History tabs for the application.
    Description of homepage-flip.png follows
    Description of the illustration homepage-flip.png
  3. Open the Team tab (if not already open) and select a team member email from the dropdown list. Click the Add Team Member button.
    The dropdown list displays the email addresses of all the members in your identity domain who can be added to the application as developers.
    Description of homepage-flip-team.png follows
    Description of the illustration homepage-flip-team.png