Practice: Migrate

Application Development
Between Environments
Practice 1: Migrate Applications

Overview

In this lab, You will create Installation scripts and Data Packages to export Database objects
along with Data. Then you will export the DEMO PROJECTS Application along with supporting
objects and import it into another workspace.

Objectives

In this lab, you will:

• Create Installation Scripts

• Create Data Packages
Export application with supporting Objects.
•
Downloads
• Did you miss out on trying the previous labs? Don’t worry! You can download the
application from here and import it into your workspace. To run the app, please run
the steps described in Get Started with Oracle APEX and Using SQL
Workshop workshops.

Create Installation Scripts, Data packages, and Export Applications.

Before starting this lab, you need to provision a new APEX instance or Workspace.

In this hands-on lab, you will log in to a new, remote APEX workspace, create a table, and then
register schema with ORDS.

1. On the Workspace home page, click the App Builder icon.

Copyright © 2023, Oracle and/or its affiliates.

422 Practice: Managing Application Data

2. Select the Demo Projects application.

3. Click Supporting Objects. The Supporting Objects page appears.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 423

4. Under Installation, Select Installation Scripts.

5. Click Create.

Copyright © 2023, Oracle and/or its affiliates.

424 Practice: Managing Application Data

6. Select Create from Database Object under Create Script.

7. Under Script Attributes, select the below options and click Next.

a. For Name, Select Database Objects.

b. For Object Type, select Table**

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 425

8. Now set the following attributes and then click Next.

a. For Table Options, Select the Checkbox.

b. For Object, Select and Move the

tables DEMO_PROJECTS and EBA_DEMO_IR_EMP to the right side.

Copyright © 2023, Oracle and/or its affiliates.

426 Practice: Managing Application Data

 Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 427

9. You will now see the Scripts created. Click Create.

10. Now, you will see that the Scripts got created and Saved. You will need to include Data in
your Supporting Objects. Select Create Data Package under Tasks on the Right side of
your page.

11. Under Script Attributes, Select the following and click Next.

a. For Name, select data.sql

b. For Tables, ensure DEMO_PROJECTS and EBA_DEMO_IR_EMP are listed on

the right side, and if not, select and shuttle these two tables over there.

Copyright © 2023, Oracle and/or its affiliates.

428 Practice: Managing Application Data

12. For Create Script, accept the defaults and click Finish.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 429

13. The Scripts are now Created. Navigate back to the application and Select Export/Import.

14. Select Export and click Next.

Copyright © 2023, Oracle and/or its affiliates.

430 Practice: Managing Application Data

15. In the Export Application page, Under Export Preferences, select Yes and Install on
Import Automatically and Click Export.

16. You will now notice that the application is downloaded as fNNN.sql

Import Application into the Target Workspace and Verify Database Objects.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 431

1. Log in to the Target Workspace.

Copyright © 2023, Oracle and/or its affiliates.

432 Practice: Managing Application Data

2. Click App Builder and then select Import.

3. Under Import, click Drag and Drop.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 433

4. Choose the file we exported in the previous lab from your Local System and then
click Next.

5. Under Install, Set Build Status to Run and Build Application. Leave the remaining
settings to default and Click Install Application.

Copyright © 2023, Oracle and/or its affiliates.

434 Practice: Managing Application Data

6. For Supporting Objects, Set Install Supporting Objects to yes and then click Next.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 435

7. Click Install.

8. You will now see that Your application's supporting objects have been installed.
Click Edit Application to review the Database Objects.

Copyright © 2023, Oracle and/or its affiliates.

436 Practice: Managing Application Data

9. Click on the Arrow mark next to SQL Workshop and then click Object Browser.

10. Select DEMO_PROJECTS table and then click Data. Verify the Data in the
table DEMO_PROJECTS.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 437

Practice 2: Remote Deployment

Overview
In this lab, You will be using Remote Deployment to deploy your Application from
Development to UAT. The ORDS feature, REST Enabled SQL is not available
for apex.oracle.com users. Therefore, you will not be able to perform this lab in the
hosted instance apex.oracle.com. You should be using APEX Service or APEX on
Autonomous Database options for this lab.

Objectives

In this lab, you will:

• Export application with supporting Objects.

Use Remote Deployment to deploy your Application.
•
Downloads
• Did you miss out on trying the previous labs? Don’t worry! You can download the
application from here and import it into your workspace. To run the app, please run
the steps described in Get Started with Oracle APEX and Using SQL
Workshop workshops.

Import Sample Application

The ORDS feature, REST Enabled SQL is not available for apex.oracle.com users.
Therefore, you will not be able to perform this lab in the hosted instance
apex.oracle.com. You should be using APEX Service or APEX on Autonomous
Database options for this lab.

In this Lab, You will install a Sample Application in a new workspace you created
either on APEX Service or APEX on Autonomous Database. Please follow the steps
in Get Started with Oracle APEX workshop to provision an instance or to create
workspace on APEX Service or APEX on Autonomous Database.

Copyright © 2023, Oracle and/or its affiliates.

438 Practice: Managing Application Data

1. Log in to the new Workspace you created.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 439

2. Once you Navigate to Gallery, Click Sample Apps.

3. Now that you are in Sample Apps, search for apps by typing "Reporting" into the "Search
Apps" search box and navigate to Sample Reporting and click the Install Button.

Copyright © 2023, Oracle and/or its affiliates.

440 Practice: Managing Application Data

4. On the Install Application page, click the Install Application Button.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 441

5. You can now see that the application is installed. Run the application by
selecting Run Application.

6. Log in to the Sample Reporting application as an End User. Enter

your Username and Password (Same as your Workspace credentials) and click Sign In.

Copyright © 2023, Oracle and/or its affiliates.

442 Practice: Managing Application Data

7. You now see the Sample Reporting application home page. In your Runtime environment
under Developer Toolbar, click Home to return to the home page of the APEX

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 443

 development environment.

8. Click App Builder.

Copyright © 2023, Oracle and/or its affiliates.

444 Practice: Managing Application Data

9. Toggle between the View Icons and the View Reports buttons. You see that applications
are displayed along with their icons and report format.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 445

Configure the Target System

In this Lab, You will enable the Target System to ORDS, and then you will copy the
URL and paste it into your notepad.

Note: You need to provision a new APEX Service or APEX on Autonomous

Database and create a new workspace in order to perform this lab.

1. Log in to your Target System.

2. Navigate to SQL Workshop > RESTful Services.

3. Click Register Schema with ORDS.

Copyright © 2023, Oracle and/or its affiliates.

446 Practice: Managing Application Data

4. Review the ORDS Schema Attributes and click Save Schema Attributes. Now, you see a
message that the schema has been successfully registered.

5. Navigate to SQL Workshop > Restful Services. Expand RESTful Data Services >
Modules > oracle.example.hr > empinfo/ GET. Copy the Full URL and paste it into
your Clipboard or Notepad.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 447

6. Click Sign Out.

Copyright © 2023, Oracle and/or its affiliates.

448 Practice: Managing Application Data

Remote Deployment

Your application is now ready for deployment. Perform the following steps:

1. Log in to your development environment (WS_APEXDEV in this example)

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 449

2. Navigate to your application home page. select App Builder and then click Sample
Reporting.

3. Click Export / Import.

4. Select Remote Deployment and click Next.

Copyright © 2023, Oracle and/or its affiliates.

450 Practice: Managing Application Data

5. Choose an existing REST Enabled SQL Service or create a new one. In this example, click
the Add Deployment Server ( + ) icon next to the Deployment Server select list.

6. Enter the base URL for the REST Enabled SQL Service defined for your deployment
server (WS_APEXUAT in this example). The schema in your deployment server has
already been enabled for use with ORDS RESTful Data Services in prerequisites.
For Endpoint URL, paste the base URL copied from the deployment instance in the
previous step(Task 4). The base URL should include the ORDS context root and schema
URL prefix. For example, https://host:8096/ords/apexstage. Then, click Next.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 451

7. Enter UAT Cred for Credential Name, select Basic Authentication for Authentication
Type, and turn off the Store Credentials switch. Click Create.

8. Now you see a message that REST Enabled SQL Service has been created. From the
Deployment Server select list, choose the one that you just created. Enter the values
for Client ID and Client Secret and click Next. In this example, you use Basic
Authentication. Therefore, enter the Database user name (deployment schema) for
Client ID and the corresponding password for Client Secret. Then, Click Next.

9. The Remote Deployment Options page appears.

Copyright © 2023, Oracle and/or its affiliates.

452 Practice: Managing Application Data

 • Under Deploy Application: Set Build Status Override to Run and Build
Application.
• Under Export Preferences: For Export Supporting Object Definitions,
select Yes and Install on Import Automatically.
• Under Deployment Overrides: In this example, even though the application
does not yet exist on the target system, turn the Overwrite Existing
Application option On so that you can preserve the application ID, and enable
this application for future overwrites.
After making the above selections, click Deploy.

Copyright © 2023, Oracle and/or its affiliates.

Practice: Managing Application Data 453

10. You see the Remote Deployment Successful message. Your application has been
successfully deployed to the remote server.

11. Log in to your remote APEX instance. Make sure that the application is available and with
the same application id as in the source system.

Summary

You now know how to deploy your Application from Development to UAT.

Copyright © 2023, Oracle and/or its affiliates.

454 Practice: Managing Application Data