Configure an Oracle Cloud Application

You can configure an Oracle Cloud Application to hide or rearrange fields in a dynamic form or table, introduce new behavior based on a variable’s value, add your own content to a page, and much, much more. The easiest way to start is by viewing your page in Oracle Cloud Applications:

Enter the URL for your Visual Builder Studio instance. (If you don't have it, you can navigate to VB Studio from your Oracle Cloud Application's Navigator. Select Configuration, then Visual Builder.)

Note:
Before continuing, make sure you or someone else in your organization has completed the steps in Essential Set-Up Tasks .
In your Oracle Cloud Application, navigate to the page you want to modify, hover over Ask Oracle, then click Edit Page in Visual Builder Studio:

Description of the illustration editpagenew.png
Note:
If you don't see the pencil in the lower right corner, click your user name at the top-right corner to open the Settings and Actions menu, then select Edit Page in Visual Builder Studio:

Description of the illustration fa-edit-page-link.png
If you don’t see the Edit Page in Visual Builder Studio option in your Oracle Cloud Application, it could be because:
- You don't have the right privileges to access VB Studio. Check with your Oracle Cloud Application administrator if you're not sure.
- You may not be working in an environment that has an instance of VB Studio associated with it, such as a TEST environment. Again, check with your Oracle Cloud Application administrator to see if this is the case.
- Your Oracle Cloud Application has not yet adopted Oracle’s new Redwood design pattern, so this page is not extensible using VB Studio. In that case, refer to Configuring and Extending Applications for instructions on how to customize your Oracle Cloud Applications with App Composer to meet your business needs.
To edit the page in VB Studio, you must belong to a project; that is, a project that has been set up to configure this particular Oracle Cloud Application in this environment. If this is your first time to VB Studio, decide how you want to proceed:
- When you don't have access to a project, you'll be prompted to create one. Enter a Project Name in the New App Extension Project dialog. If you know others may work with you in this project, optionally select their names in the Add Members list. Click Create. (Make sure someone has enabled these users to access VB Studio by following the instructions in Set Up VB Studio Users.)
  
  Note:
  Projects created this way use default settings to get you started right away. Once the project is created, you can access its properties to explore all the options available to you (click Go to project page in the header, then look for Properties under Project Administration in the main navigation menu). As someone who creates the project, you automatically become the project owner, with rights to manage it. At this point, you may want to set merge restrictions on the main branch in the project's Git repository to control who pushes commits to it and how. See Set Merge Restrictions on the main Branch.
- When you have access to a project, select the project. If you belong to more than one project, you might have to choose. The projects that are based on the same Oracle Cloud Application you want to work with will be badged as . If a project is recommended but you're not a member, select the project and click Request Membership to contact the project owner and get yourself added. You'll be notified by email when your request is approved, at which point you can try editing the page again.
  
  You also have the option to create a new project—but that's not recommended. Best practice dictates that all team members work on a single extension dedicated to a particular Oracle Cloud Application. If you still want to, click + Create and follow the prompts.
Whether you create a new project or select an existing one, you'll need a workspace, which we'll create for you if you don't have one. Here's what you see when a workspace is created as part of the new project workflow:

Description of the illustration workflow.png
- If you already have a workspace in the project for the page you're editing, VB Studio will automatically open that workspace for you. If you have more than one workspace for the same page in that project, you'll be prompted to select one. If you have a workspace for a different page, but it belongs to the same product family (known as pillar in the Oracle Cloud Application ecosystem), you can use the existing workspace. Essentially, when you have a workspace in a project—instead of a new workspace and Git repo being created whenever you edit a page for the first time in the project—you can re-use the existing one, even if it wasn't originally created for the page you're currently editing.
- If you have a workspace for a page from a different pillar, you have options: you can reuse the existing workspace, even if it wasn't created for the page you're editing, or you can create a new one. For example, if you're editing an HCM page but have a workspace with a CX extension (indicated by the badge next to the workspace name), you can choose to edit the HCM page in the CX workspace. Alternatively, you can create a new workspace (with a new repo) for editing the HCM page.
  
  Tip:
  It's helpful to isolate your extensions in separate workspaces and repositories by pillar (for example, one workspace/repo for editing all HCM pages and another workspace/repo for editing SCM pages). This is the recommended approach—but it's possible to edit all of your pages in the same workspace/repository, if that's what you want.
- If you don't have a workspace for the page you're editing but someone else does, your new workspace will be based on a clone of your teammate's existing Git repository. If you do have workspaces but they aren't associated with the page you're trying to edit, and again, someone else is already working on that page, you should clone that teammate's repository when prompted. In this case, a new workspace that's based on a clone of your teammate's repository is created for you, allowing both of you to use the same repo and collaboratively make edits on that page. You have the option to use workspaces unrelated to the page (or create a new repo)—but this means you cannot collaborate with your teammate because your changes will be in different repositories.
Note:
The default workspace name generated when you jump over to VB Studio typically uses the pillar of the page you're trying to extend, in the format Workspace PILLAR, for example, Workspace HCM. If that name already exists, a number is added to the name and incremented as needed, for example, Workspace HCM 1, Workspace HCM 2, and so on.

Once you access a project, you'll see your page open in the Designer, with the extensible areas highlighted, like this dynamic container:

Description of the illustration extendableareasingreen.png
Select an extensible area by clicking it, then selecting a component or rule set in the Properties pane on the right. You’ll then be placed in one of VB Studio’s editors, where the real work begins.
Use Configure an App UI to help you configure your Oracle Cloud Application to meet your organization’s requirements.
When you're done making your changes, there are several ways you can test and prepare your configurations for publication. See Preview, Share, and Publish Your Extension for more information.