Creating a Sandbox


This demonstration shows you how to create a sandbox for extending your application.

 

Creating a sandbox makes it possible for you to implement and test your changes without affecting the existing code or current users.

 

When using the Application Composer, you should always make your changes in a sandbox first.


Steps:

  1. Click the Administration menu.

    Step 1

  2. Click the Manage Sandboxes... list item.

    Step 2

  3. The Manage Sandboxes window appears.

     

    This window lists any available sandboxes in your environment. To use an existing sandbox, select it and click the Set as Active button. Or, create a new sandbox.

     

    After you have tested all your changes and are ready to share them with users, you can publish your sandbox from this window.

     

    In the next step, we will create a new sandbox.

    Step 3

  4. Click the Actions menu.

    Step 4

  5. Click the New list item.

    Step 5

  6. The Create Sandbox window appears.

    Step 6

  7.  

    Enter a short name for your sandbox. What you enter here is appended to the sandbox name created automatically by the application.

     

    For example, enter your initials, "MH", in the Sandbox Name field.

     

    Step 7

  8. Leave the Create Data Security Sandbox option unselected.

     

    Selecting this option creates a special security sandbox for editing security policies. You can use this feature later to customize security for the object you are creating.

    Step 8

  9. Click the Save and Close button.

    Step 9

  10. A confirmation window appears.

    Step 10

  11. Click the OK button.

    Step 11

  12. Your sandbox is now listed in the Manage Sandboxes window.

    Step 12

  13. Select the sandbox to activate it.

    Step 13

  14. Click the Set as Active button.

    Step 14

  15. The sandbox name displays at the top of the window indicating that you are now working in the sandbox.

     

    You can now customize your application. Only when you publish your sandbox can other users see what you have done.

    Step 15

  16. When you mouse over the name of your sandbox, you can see more details.

    Step 16

  17. If you sign out and sign in again as the same user, you will still be in the same sandbox. The sandbox you are working in is a part of your user profile information.

    Step 17

  18. Click the More Details link.

    Step 18

  19. The Sandbox Details window appears.

     

    The changes you make in the sandbox are not stored with application code but as XML files in a separate location, called the Oracle Metadata Services (MDS) repository. The XML files include the instructions that determine how your changes behave at runtime.

     

    Because we have just created our sandbox and not made any changes, there are no files listed on the MDS tab.

     

     

    Step 19

  20. Click the Close button.

    Step 20

  21. You can exit the sandbox from the details you get when you hover your mouse over the sandbox name.

    Step 21

  22. Click the Exit Sandbox link.

    Step 22

  23. The Exit Sandbox window appears.

    Step 23

  24. Click the Yes button.

    Step 24

  25. The sandbox name is no longer present, confirming that you are no longer in the sandbox session.

    Step 25

This concludes the demonstration of how to create a sandbox.

Table of Contents  Start Topic