9.4 Managing Cards

A cards page features colorful boxes, which resemble index cards, laid out on a page.

You can create a faceted search page with the Create Application Wizard.

• Example Cards Page
  View an example cards page.
• Creating Cards Using the Create Application Wizard
  Run the Create Application Wizard to create a new application that contains a cards page.
• Editing a Cards Page
  Review the components that comprise a cards page by viewing attibutes in Page Designer.

See Also:

"Creating a Report Using the Create Page Wizard"

9.4.1 Example Cards Page

View an example cards page.

A cards page consists of colorful boxes, which resemble index cards, laid out on a page. Each card displays three pieces of information pulled from columns in the underlying table. First, you select a table or view on which to build the page. Second, you select the information to display on each card: Card Title, Description Column, and Additional Text Column. The Create Application Wizard supports the creation of cards pages.

The following is an example of a cards page built on the SAMPLE$PROJECTS table.

Description of the illustration cards.png

In this example, the information displayed on the card is from the NAME, DESCRIPTION, and STATIS_ID columns. Both the Create Application Wizard and Create Page Wizard support the creation of interactive grids.

See Also:

"Managing Cards"

9.4.2 Creating Cards Using the Create Application Wizard

Run the Create Application Wizard to create a new application that contains a cards page.

A cards page consists of individual boxes, which resemble index cards, laid out on a page. Each card displays three pieces of information.

To create an application that contains cards page:

1. On the Workspace home page, click the App Builder icon.
2. Click the Create button.
3. Click New Application.
4. For Name, enter the name used to identify the application to developers.
5. For Appearance, accept the default Theme Style and menu layout (Vita, Side Menu), or change it by clicking the Set Appearance icon adjacent to the Appearance field.
6. To add a cards page:
   1. Click Add Page.
   2. Select Cards.
7. On Add Card Page:
   1. Page Name - Enter a name for this page.
   2. Set Icon - Select an icon to display in the navigation menu for this page.
   3. Table or View - Select a table or view on which to build the page.

      Next select the columns to display as the Card Title, Description, and an additional Text columns.

   4. Select the information to display on each card:

      • Card Title

      • Description Column

      • Additional Text Column

   5. Advanced - Expand Advanced to configure these options:

      • Set as Home Page - Enable this to make this page the home page for the application.

      • Set as Administration Page - Enable this to have this page display under Administration.

      • Page Help - Enter text to be displayed when the user selects Page Help.

   6. Click Add Page.
8. Features - Select features to include with the application. Features provide application-level functionality and can only be added once per application. To learn more, click the Help icon adjacent to Features.
9. Settings - Specify settings used to generate this application. To learn more about an attribute, click the Help icon adjacent to Settings.
10. Click Create Application.

9.4.3 Editing a Cards Page

Review the components that comprise a cards page by viewing attibutes in Page Designer.

A cards page is actually a special type of classic report that uses special aliases in the SQL query.

To view the components of a cards page:

1. View the page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Select a page.
   Page Designer appears.
2. Find the report region.
   1. In the Rendering tab under Content Body, locate and select report region (for example, Projects).

      In Property Editor, note that the attributes indicate the report is a classic report.

3. Review the query that defines report region:
   1. In the Rendering tab, locate and select the report region (for example, Projects) region.

      In Property Editor, note that the attributes indicate the report is a classic report.

   2. Locate SQL Query and click the Code Editor: SQL Query icon.

      The Code Editor appears.

      The SQL query for a cards page includes special aliases such as CARD_MODIFIERS and CARD_LINK. To link a card to a new page, you must update CARD_LINK in the underlying SQL query to point to the appropriate target.

   Tip:

   To see an example of linking a cards region to another page, see "Linking Project Cards to Maintain Project Form" in Oracle Application Express Tutorial: Building an Application.