Orbit allows you to reuse components within an application or between them. This brief tutorial will guide you step by step on how to take advantage of reusable components by copying a page.
Let's start by opening the Orbit development environment:
Sign into your Orbit suite and select the application TEMPLATE from the application drop down located on the Orbit left menu.
Type template_search in the filter field and press enter.
The PAGES LIST page will display on the right frame listing the results matching your search criteria. The query should return the record TEMPLATE_SEARCH, which satisfies your search.
TEMPLATE_SEARCH is a search/report page within the TEMPLATE application. Let's say you want to create another report following a similar format. To make things easier, we are going to copy the TEMPLATE_SEARCH page and name it "MY_REPORT". Follow these steps:
Click on the name of the page we are copying, in this case TEMPLATE_SEARCH, this will drilldown into the page itself and its components.
Now you should be in the Page Maintenance Screen, which displays the record TEMPLATE_SEARCH and all the sections that make up this particular page. Every page contains a header, body and a footer that most likely you will want to keep consistent throughout your application. By dividing the page into sections that contain snippets of code, you are able to take these common components and use them in all or some of the pages that make up your application. Adding, in this manner, consistency and readability throughout all pages.
Next, let's go ahead and simply click on the copy link. Notice the message on top of the page reads, "Record Copied but Not Saved". This alert indicates that a duplicate record is being created, but not yet saved to the Oracle table.
At this stage, all fields become editable to allow the user to make any changes to the copied record.
Saving your new page
Now is the time to finalize any changes before saving the new record. The input fields in blue are required fields, which must be filled out by the user before the record is saved. Each page code must be unique, trying to save the page without first changing the page code will result in an error alert. Before saving the page follow these simple steps:
Change the page code to MY_REPORT. You may also want to change the description field explaining the purpose of this new record; however this is not a unique field, so you may choose to leave it as is.
The required drop downs: application, page type and page status; may be left intact. Only if you were copying this page from one application to another, you would want to reselect the application code. For the purposes of this tutorial, we are only copying a page within the TEMPLATE application.
Note: when copying a page, section, or token across applications you do not need to change the page, section, or token code. Unless that same unique name is already in use in the TO application for the same type of record.
Finally, let's click on the SAVE link to replicate the TEMPLATE_SEARCH page. A new record named "MY_REPORT" is now inserted in the pages table containing the same components as the TEMPLATE_SEARCH page. Once the new record is created, you may change things around and customize the report to your needs. However the basic structure of the page is already in place for you.
End Result
To view your new report page click on the "PAGE PREVIEW ICON" located on top of the page maintenance between the code and description input fields. Your new search should look something similar to the image underneath.
located on top of the page maintenance between the code and description input fields. Your new search should look something similar to the image underneath.
