Modify an Existing Application Using the CX Extension Generator

Once you have a working application extension in Oracle Visual Builder Studio (VBS), you can use the CX Extension Generator to add additional top-level custom objects and generate smart actions for them.. To use the tool, download your workspace as a .zip file from Visual Builder Studio and then import it into the CX Extension Generator.

Important: You can't use the CX Extension generator to edit the custom objects you've already created in it and exported to VBS. You must manually add panels and generate additional smart actions for custom objects you created in the CX Extension Generator. You can, however, come back and use the CX Extension Generator to add additional top-level custom objects and create panels and smart actions for them.

Prerequisites

In Application Composer:

  • Create the new custom objects and child objects that you want to add to your existing application.

Export Files from Visual Builder Studio

To update an existing application, you must first download the application from your Visual Builder Studio workspace.

In Visual Builder Studio, click the Menu icon at the top of the page, then click Export.

This screenshot illustrates how to export the .zip file.

Import the Files in to CX Extension Generator

After you downloaded your application as a .zip file, you can then import it into the CX Extension Generator.

  1. In a sandbox, navigate to Application Composer > CX Extension Generator.

  2. Click Import Extension.

    This screenshot illustrates the CX Extension Generator.

  3. In the Import Application drawer, select your .zip file and click Import.

    The existing objects in your application are now visible in the CX Extension Generator, but they are read only.

    This screenshot illustrates the list page after importing a .zip file.

  4. Click Actions > Add objects.

    This screenshot illustrates how to add objects to an existing application.

  5. In the Add objects drawer, select the objects that you want to add to your application, and then click Add.

    The selected objects display on the list page.

    This screenshot illustrates the list page of the CX Extension Generator.

  6. For each selected object, drill down to configure the object's detail page. On this page, you can configure the panels in the foldout.

    This screenshot illustrates where you can configure the panels in the foldout.

  7. After you've completed your changes, you can generate and download the .zip file.

Note: At any time, you can delete your configuration choices from the tool by clicking Actions > Start Over.

This screenshot illustrates how to start over.

Generate Files

When you're done with your application extension changes, navigate back to the CX Extension Generator list page and click Generate Files.

This screenshot illustrates the list page of the CX Extension Generator.

The CX Extension Generator generates and downloads a .zip file that includes the pages and layouts for your selected objects.

Import the Files into Visual Builder Studio

The CX Extension Generator generates a .zip file that you can import into Visual Builder Studio.

  1. Use the Navigator to navigate to Visual Builder Studio: Configuration > Visual Builder.

  2. In Visual Builder Studio, navigate to the workspace that contains your existing application.

  3. Click the Menu icon at the top of the page, then click Import.

    This screenshot illustrates how to import the .zip file.
  4. In the Import Resources dialog, add your .zip file and click Import.

    Your workspace is updated with the newly added objects and related artifacts, without disturbing the existing objects in the application.

  5. Click the Preview button to see the newly added objects in the application.

    This is a screenshot of the Preview button in Visual Builder Studio.
  6. The resulting preview link will be:

    https://<servername>/fscmUI/redwood/cx-custom/<object_name>_c

  7. Change the preview link as follows:

    https://<servername>/fscmUI/redwood/cx-custom/application/container/<object_name>_c

    Note: You must add /application/container to the preview link.
  8. You can now continue to make changes to your application extension, if needed.