Skip Headers
Oracle® Fusion Middleware Mobile Developer's Guide for Oracle Application Development Framework
11g Release 2 (11.1.2.4.0)

Part Number E24475-03
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

6 Creating ADF Mobile AMX Pages

This chapter describes how to create the ADF Mobile AMX application feature.

This chapter includes the following sections:

6.1 Introduction to the ADF Mobile AMX Application Feature

ADF Mobile AMX is a subframework within ADF Mobile that provides a set of UI components that enable you to create an application feature whose behavior is identical on all supported platforms. While ADF Mobile AMX maintains the same development experience as ADF Faces by allowing you to drag these components into an editor from the Component palette or from the Data Control palette, these components are not equivalents to their ADF Faces counterparts: ADF Mobile AMX components do not support every property and behavior of ADF Faces components.

Note:

When developing interfaces for mobile devices, always be aware of the fact that the screen space is very limited. In addition, touchscreen support is not available on some mobile devices.

For more information, see the following:

6.2 Creating Task Flows

Task flows allow you to define the navigation between ADF Mobile AMX pages. Using your application workspace in JDeveloper (see Section 4.2, "Creating an Application Workspace"), you can start creating the user interface for your ADF Mobile AMX application feature by designing task flows. As with any standard JSF application, ADF Mobile AMX uses navigation cases and rules to define the task flow. These definitions are stored in a file with the default name of ViewController-task-flow.xml (see Section 6.2.3, "What You May Need to Know About the ViewController-task-flow.xml File").

An ADF Mobile sample application called Navigation (located in the PublicSamples.zip file within the jdev_install/jdeveloper/jdev/extensions/oracle.adf.mobile/Samples directory on your development computer) demonstrates how to use various navigation techniques, such as circular navigation, routers, and so on.

ADF Mobile enables you to create ADF Mobile AMX application features that have both bounded and unbounded task flows. As described in the "Getting Started with ADF Task Flows" section of Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework, a bounded task flow is also known as a task flow definition and represents the reusable portion of an application. In ADF Mobile, bounded task flows have a single entry point and no exit points. They have their own collections of activities and control-flow rules, as well as their own memory scope and managed-bean life span.

You use the ADF Mobile AMX Task Flow Designer to create bounded task flows for your feature. When designing an ADF Mobile AMX task flow, JDeveloper maintains the same experience as designing an ADF task flow, as described in the "Creating a Task Flow" section of Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework. Like the overview editor for task flows, this tool includes a diagrammer (see Section 6.2.4, "What You May Need to Know About the ADF Mobile Task Flow Diagrammer") in which you build the task flow by dragging and dropping activities and control flows from the Components editor. You then define these activities and the transitions between them using the Property Inspector.

Unless a task flow has already been created, ADF Mobile automatically generates a default unbounded task flow (adfc-mobile-config.xml file) when a new ADF Mobile AMX page is created. For an example of the unbounded task flow, see the adfc-mobile-config.xml file from a sample application called Navigation located in the PublicSamples.zip file within the jdev_install/jdeveloper/jdev/extensions/oracle.adf.mobile/Samples directory on your development computer.

For more information, see the "Creating ADF Task Flows" part of Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

6.2.1 How to Create a Task Flow

You use the navigation diagrammer to declaratively create a task flow for your ADF Mobile AMX application feature. When you use the diagrammer, JDeveloper creates the XML metadata needed for navigation to work in your feature in the ViewController-task-flow.xml file (default).

Before you begin:

To design a task flow, the ADF Mobile application must include a View Controller project file (see Chapter 4, "Getting Started with ADF Mobile Application Development").

There are two ways to create a task flow in ADF Mobile:

To create a task flow from the New Gallery:

  1. From the top-level menu in JDeveloper, click File, and then select New > From Gallery.

  2. In the New Gallery, expand the Client Tier node, select ADF Mobile, and then ADF Mobile Task Flow (see Figure 6-1). Click OK.

    Figure 6-1 Creating New ADF Mobile Task Flow

    New ADF Mobile Task Flow
  3. In the Create ADF Mobile Task Flow dialog (see Figure 6-2), specify the file name and location for your new task flow, and then click OK to open the new <Name>-flow.xml file in the navigation diagrammer that Figure 6-3 shows.

    Note:

    Task flows should be created within the View Controller project of your ADF Mobile application.

    Note:

    JDeveloper increments the number of the task flow according to the number of task flows that already exist in the same pattern.

    Figure 6-2 Create ADF Mobile Task Flow Dialog

    Create ADF Mobile Task Flow Dialog
  4. In the Component Palette, select ADF Mobile Task Flow (see Figure 6-3), and then select the component you wish to use and drag it onto the diagram.

    Tip:

    If the Component Palette is not displayed, choose View > Component Palette from the main menu. By default, the Component Palette is displayed in the upper right-hand corner of JDeveloper.

    Figure 6-3 New Blank Task Flow

    New Blank Task Flow

    JDeveloper creates a bounded task flow and redraws the diagram with the newly added component.

    You can also open the Overview tab and use the overview editor to create navigation rules and navigation cases. Press F1 for details on using the overview editor to create navigation.

    Using Overview editor

    Additionally, you can manually add elements to the task flow file by directly editing the page in the Source editor. To open the file in the Source editor, click the Source tab.

    Note:

    When manually editing the task flow file, keep in mind that all the document file names referring to ADF Mobile AMX pages, JavaScript files, and CSS files are case-sensitive.

    If special characters (such as an underscore, for example) are used in a file name, you should consult the mobile device specification to verify whether or not the usage of this character is supported.

    Once the navigation for your ADF Mobile AMX feature is defined, you can create the pages and add the components that will execute the navigation. For more information about using navigation components on a page, see Section 6.2.8, "How to Enable Page Navigation Using Control Flow Case."

    After you define the task flow for the ADF Mobile AMX application feature, you can double-click a view file to access the ADF Mobile AMX view. For more information, see Section 6.3, "Creating Views."

6.2.2 What You May Need to Know About Supported Activities and Control Flows

The ADF Mobile Task Flow designer supports a subset of ADF activities and control flows that are listed in Table 6-1.

Table 6-1 Supported Activities

Activity Description

Method Call

Invokes a method (typically a method on a managed bean). You can place a method call activity anywhere in the control flow of an ADF Mobile AMX application feature to invoke logic based on control flow rules. For additional information, see the "Using Method Call Activities" in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

You can also specify parameters that you pass into a method call that is included in a task flow. These include standard ADF parameters for a method call action in an ADF Mobile AMX task flow. When you use the designer to generate a method, it adds the required arguments and type. For more information, see the following sections of Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework:

At run time, you can define parameters for a method call in a task flow and pass parameters into the method call itself for its usage. For more information on passing method call parameters, see the following sections of Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework:

Router

Evaluates an Expression Language (EL) expression and returns an outcome based on the value of the expression. These outcomes can then be used to route control to other activities in the task flow. For more information, see the "Using Router Activities" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

View

Displays an ADF Mobile AMX page. For more information, see the "Using View Activities" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

Task Flow Call

Calls a bounded task flow from either an unbounded or bounded task flow. While a task flow call activity allows you to call a bounded task flow located within the same ADF Mobile AMX application feature, you can also call a bounded task flow from a different ADF Mobile AMX application feature or from a Feature Archive file (FAR) that has been added to an Oracle ADF library (see Section 5.13, "Working with Feature Archive Files").

The task flow call activity supports task flow input parameters and return values.

For more information, see the "Using Task Flow Call Activities" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

Task Flow Return

Identifies the point in an application's control flow where a bounded task flow completes and sends control flow back to the caller. You can use a task flow return only within a bounded task flow. For more information, see "Using Task Flow Return Activities" the section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.


6.2.3 What You May Need to Know About the ViewController-task-flow.xml File

The ViewController-task-flow.xml file is the ADF Mobile AMX counterpart to ADF's task-flow-definition.xml and enables you to design the interactions between views (ADF Mobile AMX pages) by dragging and dropping the ADF Mobile AMX task flow components from the Component Palette into the diagrammer.

Figure 6-4 shows a sample task flow file called Products-flow.xml. In this file, the control flow is directed from the products page to the productdetails page. To return to the products page from the productdetails page, the built-in __back navigation is used.

Figure 6-4 Task Flow File

ViewController-task-flow.xml File

6.2.4 What You May Need to Know About the ADF Mobile Task Flow Diagrammer

As illustrated in Figure 6-4, the task flow diagram and Component Palette display automatically after you create a task flow using the ADF Mobile Task Flow Creation utility. The task flow diagram is a visual editor onto which you can drag and drop activities and task flows from the Component Palette or from the Application navigator. For more information, see Section 6.2.5, "How to Add ADF Mobile Activities."

6.2.5 How to Add ADF Mobile Activities

As in ADF application development, you use the task flow diagrammer to drag and drop activities, views, and control flows.

Before you begin:

You must select ADF Mobile Task Flow from the Component Palette, as Figure 6-5 shows.

To add an activity to an ADF Mobile task flow:

  1. In the Application Navigator, double-click a task flow source file (such as ViewController-task-flow.xml) to display the task flow diagram and the Component Palette, as Figure 6-5 shows. The diagrammer displays the task flow editor. The Component Palette automatically displays the components available for an ADF Mobile task flow.

  2. Drag an activity from the Component Palette onto the diagram. If you drag a view activity onto the diagram, you can invoke the Create ADF Mobile AMX File wizard (see Section 6.2.6, "How to Add View Activities").

Figure 6-5 The Diagrammer for the Task Flow Editor

The Diagrammer for the Task Flow Editor

Note:

There is a default activity that is associated with each task flow.

6.2.6 How to Add View Activities

The view activity is associated in metadata with an actual ADF Mobile AMX page. You add a view activity by dragging and dropping it from the Component Palette. A view activity displays an ADF Mobile AMX page. You can create an actual ADF Mobile AMX page by double-clicking the view activity in the Diagram window. You can also create a view activity by dragging and dropping an ADF Mobile AMX file in the Application navigator into the overview editor's Diagram tab.

6.2.7 How to Add a Wildcard Control Flow Rule

ADF Mobile task flows support the wildcard control flow rule, which represents a control flow from-activity-id that contains a trailing wildcard (foo*) or a single wildcard character. You can add a wildcard control flow rule by dragging and dropping it from the Component Palette. To configure your wildcard control flow rule, use the Property Inspector.

6.2.8 How to Enable Page Navigation Using Control Flow Case

You can create navigation using the Control Flow Case component, which identifies how control passes from one activity to the next. To create a control flow, select Control Flow Case from the Component Palette. Next, connect the control flow case to the source activity, and then to the destination activity. JDeveloper creates the following after you connect a source and target activity:

  • control-flow-rule: Identifies the source activity using a from-activity-id.

  • control-flow-case: Identifies the destination activity using a to-activity-id.

To define a control flow case directly in the ADF Mobile task flow diagram:

  1. In the Application navigator, double-click a task flow source file to display the task flow diagram.

  2. Select Control Flow Case from the Component Palette.

  3. On the diagram, click a source activity and then a destination activity. JDeveloper adds the control flow case to the diagram. Each line that JDeveloper adds between an activity represents a control flow case. The from-outcome contains a value that can be matched against values specified in the action attribute of the UI components.

  4. To change the from-outcome, select the text next to the control flow in the diagram. By default, this is a wildcard character.

  5. To change the from-activity-id (the identifier of the source activity), or the to-activity-id (the identifier for the destination activity), drag either end of the arrow in the diagram to a new activity.

    For more information, see the "What Happens When You Create a Control Flow Rule" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

6.2.9 How to Specify Action Outcomes Using UI Components

Using the Property Inspector, you can specify an action outcome by setting the action attribute of one of the following UI components to the corresponding control flow case from-outcome leading to the next task flow activity:

You use the UI component's Action field (see Figure 6-6) to make a selection from a list of possible action outcomes defined in one or more task flow for a specific ADF Mobile AMX page.

Figure 6-6 Setting Actions

Setting Actions

A Back action (__back) is automatically added to every list to enable navigation to the previously visited page.

Note:

An ADF Mobile AMX page can be referenced in both bounded and unbounded task flows, in which case actions outcomes from both task flows are included in the Action selection list.

6.2.10 How to Create and Reference Managed Beans

You can create and use managed beans in your ADF Mobile application to store additional data or execute custom code. You can use JDeveloper's usual editing mechanism to reference managed beans and create references to them for applicable fields. For more information, see the "Using a Managed Bean in a Fusion Web Application" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

Figure 6-7 shows the Edit option for an action property in the Property Inspector. You click this option to invoke the Edit Property dialog that Figure 6-8 shows.

Figure 6-7 Edit Dialog

Managed bean edit dialog

Figure 6-8 Edit Property Dialog for Action

Edit Property Dialog for Action

Table 6-5 lists ADF Mobile AMX attributes for which the Edit option in the Property Inspector is available.

Table 6-2 Editable Attributes

Property Element

binding

actionListener

action

commandButton

actionListener

commandButton

action

commandLink

actionListener

commandLink

action

listItem

actionListener

listItem

valueChangeListener

inputDate

valueChangeListener

inputNumberSlider

valueChangeListener

inputText

valueChangeListener

selectBooleanCheckbox

valueChangeListener

selectBooleanSwitch

valueChangeListener

selectManyCheckbox

valueChangeListener

selectOneButton

valueChangeListener

selectOneChoice

valueChangeListener

selectOneRadio

rangeChangeListener

listView

selectionListener

listView


Clicking Edit for all other properties invokes a similar dialog, but without the Action Outcome option, as Figure 6-9 shows.

Figure 6-9 Edit Property Dialog for Action Listener

Edit Property Dialog for Action Listener

The preceding dialogs demonstrate that you can either create a managed bean, or select an available action outcome for the action property.

The Action Outcome list shown in Figure 6-8 contains the action outcomes from all task flows to which a specific ADF Mobile AMX page belongs. In addition, this list contains a __back navigation outcome to go back to the previously visited page (see Section 6.2.9, "How to Specify Action Outcomes Using UI Components" for more information). If a page is not part of any task flow, the only available outcome in the Action Outcome list is __back. When you select one of the available action outcomes and click OK, the action property value is updated with the appropriate EL expression, such as the following for a commandButton:

<amx:commandButton action="goHome"/>

The Method Binding option (see Figure 6-8) allows you to either create a new managed bean class, or select an existing one.

To create a new managed bean class:

  1. Click New next to the Managed Bean field to open the Create Managed Bean dialog that Figure 6-10 shows.

    Figure 6-10 Create Managed Bean Dialog

    Create Managed Bean Dialog

    ADF Mobile supports the following scopes:

    • application

    • view

    • pageFlow

    When you declare a managed bean to an ADF Mobile application or the ADF Mobile AMX application feature, the managed bean is instantiated and identified in the proper scope, and the bean's properties are resolved and its methods are called through EL. For more information, see Section 8.2, "Understanding EL Support."

  2. Provide the managed bean and class names, and then click OK.

    Example 6-1 shows the newly created managed bean class. The task flow that this ADF Mobile AMX page is part of is updated to reference the bean.

    Example 6-1 New Managed Bean Class

    <managed-bean id="__3">
       <managed-bean-name>MyBean</managed-bean-name>
       <managed-bean-class>mobile.MyBean</managed-bean-class>
       <managed-bean-scope>application</managed-bean-scope>
    </managed-bean>
    

    Note:

    If a given ADF Mobile AMX page is part of bounded as well as unbounded task flows, both of these task flows are updated with the managed bean entry.

  3. Click New next to the Method field (see Figure 6-8 and Figure 6-9) to open the Create Method dialog that Figure 6-11 shows. Use this dialog to provide the managed bean method name.

    Figure 6-11 Create Method Dialog

    Create Method Dialog

    Upon completion, the selected property value is updated with the appropriate EL expression, such as the following for a commandButton.:

    <amx:commandButton action="#{MyBean.getMeHome}"/>
    

    The managed bean class is also updated to contain the newly created method, as Example 6-2 shows.

    Example 6-2 New Method in Managed Bean Class

    package mobile;
    
    public class MyBean {
       public MyBean() {
       }
    
       public String getMeHome() {
          // Add event code here...
          return null;
       }
    }
    

To select an existing managed bean:

  1. Make a selection from the Managed Bean list that Figure 6-12 shows.

    Figure 6-12 Selecting Managed Bean

    Selecting Managed Bean

    Similar to the action outcomes, the Managed Bean list is populated with managed beans from all task flows that this ADF Mobile AMX page is part of.

    Note:

    If the ADF Mobile AMX page is not part of any task flow, you can still create a managed bean.

For more information, see the following:

  • Section 8.2.4.2, "ADF Managed Beans"

  • JavaDemo, an ADF Mobile sample application located in the PublicSamples.zip file within the jdev_install/jdeveloper/jdev/extensions/oracle.adf.mobile/Samples directory on your development computer.

6.2.11 How to Specify the Page Transition Style

By defining the page transition style on the task flow, you can specify how ADF Mobile AMX pages transition from one view to another. The behavior of your ADF Mobile AMX page at transition can be as follows:

  • fading in

  • sliding in from left

  • sliding in from right

  • sliding up from bottom

  • sliding down from top

  • sliding in from start

  • sliding in from end

  • flipping up from bottom

  • flipping down from top

  • flipping from left

  • flipping from right

  • flipping from start

  • flipping from end

  • none

Sliding in from start and end, as well as flipping from start and end are used on the iOS platform to accommodate the right-to-left text direction. It is generally recommended to use the start and end transition style as opposed to left and right.

Note:

You cannot enable flipping on the Android platform.

You set the transition style by modifying the transition attribute of the control-flow-case (Control Flow Case component), as Example 6-3 shows.

Example 6-3 Setting Transition Style

<control-flow-rule id="__1">
   <from-activity-id>products</from-activity-id>
   <control-flow-case id="__2">
      <from-outcome>details</from-outcome>
      <to-activity-id>productdetails</to-activity-id>
      <transition>fade</transition>
   </control-flow-case>
</control-flow-rule>

In the Property Inspector, the transition attribute is located under Behavior, as Figure 6-13 shows. The default transition style is slideLeft.

Figure 6-13 Setting Transition Style in Property Inspector

Transition style

6.3 Creating Views

You can start creating the ADF Mobile AMX view by doing the following:

6.3.1 How to Work with ADF Mobile AMX Pages

An ADF Mobile AMX page is represented by an XML file similar to a JSPX file in Oracle ADF Faces.

6.3.1.1 Interpreting the ADF Mobile AMX Page Structure

The following is a basic structure of the ADF Mobile AMX file:

<amx:view>
   <amx:panelPage id="pp1">
      <amx:facet name="header">
         <amx:outputText id="ot1" value="Welcome"/>
      …
      </amx:facet>
   </amx:panelPage>
</amx:view>

With the exception of data visualization components (see Section 7.5, "Providing Data Visualization"), UI elements are declared under the <amx> namespace.

For more information, see Section 6.3.1.3, "What Happens When You Create an ADF Mobile AMX Page."

6.3.1.2 Creating ADF Mobile AMX Pages

ADF Mobile AMX files are contained in the View Controller project of the ADF Mobile application. You create these files using the Create ADF Mobile AMX Page dialog.

ADF Mobile offers two alternative ways of creating an ADF Mobile AMX page:

  • From the New Gallery

  • From an existing task flow

Before you begin:

To create an ADF Mobile AMX page, the ADF Mobile application must include a View Controller project file (see Chapter 4, "Getting Started with ADF Mobile Application Development").

To create an ADF Mobile AMX page from the New Gallery:

  1. From the top-level menu in JDeveloper, click File, and then select New > From Gallery.

  2. In the New Gallery, expand the Client Tier node, select ADF Mobile, and then ADF Mobile AMX Page (see Figure 6-14). Click OK.

    Figure 6-14 Creating ADF Mobile AMX Page

    Creating a Local ADF Mobile XML Page
  3. In the Create ADF Mobile AMX Page dialog, enter a name and, if needed, a location for your new file, as Figure 6-15 shows.

  4. Optionally, you may select which facets your new ADF Mobile AMX page will include as a part of the page layout:

    • Header

    • Primary

    • Secondary

    • Footer

    For more information, see Section 6.3.1.3, "What Happens When You Create an ADF Mobile AMX Page" and Section 7.2.6, "How to Use a Facet Component."

    Note that when you select or deselect a facet, the image representing the page changes dynamically to reflect the changing appearance of the page.

    Figure 6-15 Create ADF Mobile AMX Page Dialog

    Create Local ADF Mobile XML Page Dialog

    Note:

    ADF Mobile persists your facet selection and applies it to each subsequent invocation of the Create ADF Mobile AMX Page dialog.

  5. Click OK on the Create ADF Mobile AMX Page dialog.

To create an ADF Mobile AMX page from a View Component of the Task Flow:

  1. Open a task flow file in the diagrammer (see Figure 6-5, "The Diagrammer for the Task Flow Editor", Section 6.2.1, "How to Create a Task Flow" and Section 6.2.4, "What You May Need to Know About the ADF Mobile Task Flow Diagrammer")

  2. Double-click a View component of the task flow to open the Create ADF Mobile AMX Page dialog that Figure 6-15 shows, and then enter a name and, if needed, a location for your new file. Click OK.

6.3.1.3 What Happens When You Create an ADF Mobile AMX Page

When you use the Create ADF Mobile AMX Page dialog to create an ADF Mobile AMX page, JDeveloper creates the physical file and adds it to the Web Content directory of the View Controller project.

In the Application navigator that Figure 6-16 shows, the Web Content node contains a newly created ADF Mobile AMX file called order.amx.

Figure 6-16 ADF Mobile AMX File in Application Navigator

The Local ADF Mobile XML File in Application Navigator

JDeveloper also adds the code necessary to import the component libraries and display a page. This code is illustrated in the Source editor shown in Figure 6-16.

Figure 6-17 shows how the Preview pane and the generated ADF Mobile AMX code would look like if you selected all facet types listed in the Page Facet section of the Create ADF Mobile AMX Page dialog when creating the page.

Figure 6-17 ADF Mobile AMX Page With All Facets

ADF Mobile AMX Page With All Facets

In the page created with all the facets selected (see Figure 6-17), note the following:

  • The header is created with an Output Text component because this component is typically used for the page title.

  • The primary and secondary actions are created with Button components because it is a typical pattern.

  • Since there is no single dominant pattern for the footer, it is created with an Output Text component by default because that component is used in some patterns and it prevents JDeveloper from generating the initial code with audit violation.

  • Adding either the primary or secondary action without adding the header facet still causes the header section to appear in the Page Facets section of Create ADF Mobile AMX Page dialog.

Figure 6-18 shows the Page Facet section of the Create ADF Mobile AMX Page dialog without any facets selected, the Preview pane, and the generated ADF Mobile AMX code (which is also shown in Figure 6-16).

Figure 6-18 ADF Mobile AMX Page Without Facets

ADF Mobile AMX Page Without Facets

6.3.1.4 Using UI Editors

When the page is first displayed in JDeveloper, it is displayed in the Source editor. To view the page in a WYSIWYG environment, use the Preview pane (accessed by clicking the Preview tab). Figure 6-19 shows the Preview tab selected for a newly created ADF Mobile AMX page called order.amx. This page is blank because it has not yet been populated with ADF Mobile AMX UI components or data controls.

Figure 6-19 The Preview Pane for Newly Created Page

The Preview Pane for Newly Created Page

Using the Preview pane's toolbar that Figure 6-19 shows, you can do the following:

  • Refresh the display of the ADF Mobile AMX page by clicking Refresh Page.

  • Stop loading of the page by clicking Stop Loading Page.

  • Modify the form factor for the page by selecting a different form factor from the dropdown list. For more information on form factors, see Section 3.3.1.1, "Configuring the Environment for Form Factors."

  • Modify the scaling of the display by selecting a different percentage value from the dropdown list. Since mobile device displays can be of various sizes and densities, the Preview pane allows you to see the effect of scaling on your ADF Mobile AMX pages.

    Note:

    Scaling is available for both Portrait and Landscape mode.

  • Change orientation for the display to portrait and landscape by selecting Show Portrait Orientation or Show Landscape Orientation respectively.

  • Select the feature content for your ADF Mobile AMX page form the dropdown list of available application features. By default, <No Feature Content Selected> is displayed.

To view the source for the page in the Source editor, click the Source tab that Figure 6-16, "ADF Mobile AMX File in Application Navigator" shows. The Structure window, located in the lower left-hand corner of JDeveloper (shown in Figure 6-16 and Figure 6-19), provides a hierarchical view of the page. For more information, see Section 6.3.2.2, "Using the Preview."

6.3.1.5 Accessing the Page Definition

ADF Mobile AMX supports JDeveloper's Go to Page Definition functionality that enables you to navigate to the page definition of an ADF Mobile AMX page by using a context menu that allows you to locate and edit the binding information quickly.

You can invoke the context menu that contains the Go to Page Definition option from the following:

  • Source editor, as Figure 6-20 shows.

    Figure 6-20 Go to Page Definition from Source Editor

    Go to Page Definition from Source Editor
  • Application navigator, as Figure 6-21 shows.

    Figure 6-21 Go to Page Definition from Application Navigator

    Go to Page Definition from Application Navigator
  • Structure pane, as Figure 6-22 shows.

    Figure 6-22 Go to Page Definition from Structure Pane

    Go to Page Definition from Structure Pane

In addition, you can open the Page Definition file using the Go to Page Definition shortcut key defined under Tools > Preferences on the main menu, as Figure 6-23 shows.

Figure 6-23 Opening Page Definition from Preferences

Opening Page Deninition from Preferences

6.3.2 How to Add UI Components and Data Controls to an ADF Mobile AMX Page

After you create an ADF Mobile AMX page, you can start adding ADF Mobile AMX UI components and data controls to your page.

6.3.2.1 Adding UI Components

You can use the Component Palette to drag and drop ADF Mobile AMX components onto the page. JDeveloper then adds the necessary declarative page code and sets certain values for component attributes.

The Component Palette displays ADF Mobile AMX components by categories (see Figure 6-24):

  • General Controls

  • Text and Selection

  • Data Views

  • Layout, with the following subcategories:

    • Interactive Containers and Headers

    • Secondary Windows

    • Core Structure

  • Operations, with the following subcategories:

    • Behavior

    • Listeners

    • Validators and Converters

For information on adding and using specific components, see Section 7.3, "Creating and Using UI Components."

Before you begin:

The ADF Mobile application must include a View Controller project, which may or may not contain an ADF Mobile AMX page or ADF Mobile AMX page task flow from which to create a page.

As described in Section 6.3.1.2, "Creating ADF Mobile AMX Pages," you can invoke the Create ADF Mobile AMX Page dialog by double-clicking a view icon in a task flow diagram or by selecting Client Tier > ADF Mobile > ADF Mobile AMX Page from the New Gallery.

To add UI components to a page:

  1. Open an ADF Mobile AMX page in the Source editor (default).

  2. In the Component Palette, use the menu to choose ADF Mobile AMX, as Figure 6-24 shows.

    Tip:

    If the Component Palette is not displayed, choose View > Component Palette from the main JDeveloper menu. By default, the Component Palette is displayed in the upper right-hand corner of JDeveloper.

    Figure 6-24 ADF Mobile AMX Component Palette

    Local ADF Mobile XML Component Palette
  3. Select the component you wish to use, and then drag and drop it onto the Source editor or Structure window. You cannot drop components onto the Preview pane.

    Note:

    When building an ADF Mobile AMX page, you can only drop UI components into UI containers such as, for example, a Panel Group Layout.

    JDeveloper redraws the page in the Preview pane with the newly added component.

6.3.2.2 Using the Preview

JDeveloper's preview provides WYSIWYG support for both the iOS and Android platforms when you build the user interface using ADF Mobile AMX files. As illustrated in Figure 6-25, splitting a view while adding the ADF Mobile AMX components to the ADF Mobile AMX file enables you to see both the code view through the Source editor and a UI view through the Preview pane. As a result, you can modify the source and get instant feedback in terms of the look and feel of that application on both the iOS and Android platforms.

Figure 6-25 Splitting Design and Source Views

Splitting Design and Source Views

In addition to being able to see the design and source views simultaneously, you can also open and work with multiple design views at the same time, as well as set each one to a different platform and screen size. By opening a combination of design views for different devices, you can develop applications simultaneously for different platforms and form factors using different orientation. Figure 6-26 shows a split screen with iPhone on the top and iPad with 50% scaling on the bottom. You can split the Preview pane using the default split functionality of JDeveloper.

Figure 6-26 Multiple Design Views

Split screen

Note:

An ADF Mobile AMX page is rendered even for an invalid ADF Mobile AMX file. Errors are indicated by the error icon on a component. By moving the mouse over the error icon, you can view the error details.

6.3.2.3 Configuring UI Components

Once you drop UI components onto a page, you can use the Property Inspector (displayed by default at the bottom right of JDeveloper) to set attribute values for each component.

Tip:

If the Property Inspector is not displayed, choose Window > Reset to Default Factory Settings from JDeveloper's main menu.

Figure 6-27 shows the Property Inspector displaying the attributes for an Output Text component.

Figure 6-27 The Property Inspector

The Property Inspector

To set component attributes:

  1. Select the component for which you want to set attributes. You can select the component in the Structure window or you can select its tag directly in the Source editor.

  2. In the Property Inspector, expand the section that contains the attribute you wish to set.

    Tip:

    Some attributes are displayed in more than one section. Entering or changing the value in one section will also change it in any other sections. You can search for an attribute by entering the attribute name in the search field at the top of the Property Inspector.

  3. In the Property Inspector, either enter values directly into the fields, or if the field contains a list, use that list to select a value. You can also use the list to the right of the field, which launches a popup containing tools you can use to set the value. These tools are either specific property editors (opened by choosing Edit) or the Expression Builder, which you can use to create EL expressions for the value (opened by choosing Expression Builder). For more information about using the Expression Builder, see the "Creating EL Expressions" section in Oracle Fusion Middleware Web User Interface Developer's Guide for Oracle Application Development Framework.

When you use the Property Inspector to set or change attribute values, JDeveloper automatically changes the page source for the attribute to match the entered value.

Tip:

You can always change attribute values by directly editing the page in the Source editor. To view the page in the Source editor, click the Source tab at the bottom of the page.

6.3.2.4 Adding Data Controls to the View

You can create databound UI components in an ADF Mobile AMX view by dragging data control elements from the Data Controls panel and dropping them into either the Structure window or the Source editor. When you drag an item from the Data Controls panel to either of these places, JDeveloper invokes a context menu of default UI components available for the item that you dropped. When you select the desired UI component, JDeveloper inserts it into an ADF Mobile AMX page. In addition, JDeveloper creates the binding information in the associated page definition file. If such file does not exist, then JDeveloper creates one. ADF Mobile provides a visual indicator for dropping data controls to inform you of the location of the new data control

Note:

A data control can only be dropped at a location allowed by the underlying XML schema.

Depending on the approach you take, you can insert different types of data controls into the Structure window of an ADF Mobile AMX page.

Dropping an attribute of a collection lets you create various input and output components. You can also create Button and Link components by dropping a data control operation on a page.

The respective action listener is added in the ADF Mobile AMX Button for each of these operations. The EL expression in the actionListener is the same as the one created on the drop of an operation into an Oracle ADF Faces application.

The data control attributes and operations can be dropped as one or more of the following ADF Mobile AMX UI components (see Section 7.3, "Creating and Using UI Components"):

  • Button

  • Link

  • Input Date

  • Input Date with Label

  • Input Text

  • Input Text with Label

  • Output Text

  • Output Text with Label

  • Iterator

  • List Item

  • List View

  • Select Boolean Checkbox

  • Select Boolean Switch

  • Select One Button

  • Select One Choice

  • Select One Radio

  • Select Many Checkbox

  • Select Many Choice

  • Convert Date Time

  • Convert Number

  • Form

  • Read Only Form

  • Parameter Form

The following Date and Number types are supported:

  • java.util.Date

  • java.sql.Timestamp

  • java.sql.Date

  • java.lang.Number

  • java.lang.Integer

  • java.lang.Long

  • java.lang.Float

  • java.lang.Double

For information on how to use the Data Controls panel in JDeveloper, see "Using the Data Controls Panel" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

6.3.2.4.1 Dragging and Dropping Attributes

If your ADF Mobile AMX page already contains a Panel Form Layout component or does not require to have all the fields added, you can drop individual attributes from a data control. Depending on the attributes types, different data binding menu options are provided, as follows:

  • Date: this category provides options for creating ADF Mobile Input Date and ADF Mobile Input Date with Label controls. Figure 6-28 shows the context menu for adding date controls that appears when you drag an attribute from the Data Controls panel into the Structure window of an ADF Mobile AMX page.

    Figure 6-28 Context Menu for Date Controls

    Context Menu for Date Controls
  • Single Selection: this category provides options for creating the following controls:.

    • ADF Mobile Select One Button

    • ADF Mobile Select One Choice

    • ADF Mobile Select One Radio

    • ADF Mobile Select Boolean Checkbox

    • ADF Mobile Select Boolean Switch

    Figure 6-29 shows the context menu for adding selection controls that appears when you drag an attribute from the Data Controls panel into the Structure window of an ADF Mobile AMX page.

    Figure 6-29 Context Menu for Selection Controls

    Context Menu for Selection Controls

    If you are working with an existing ADF Mobile AMX page and you select ADF Mobile Select One Button or ADF Mobile Select One Choice option, an appropriate version of the Edit List Binding dialog is displayed (see Figure 6-30). If you drop a control onto a completely new ADF Mobile AMX page, the Edit Action Binding dialog opens instead. After you click OK, the Edit List Binding dialog opens.

    Note:

    The Edit List Binding or Edit Boolean Binding dialog appears every time you drop any data control attributes as any of the single selection or boolean selection components, respectively.

    Figure 6-30 Edit List Binding Dialog for Select One Button and Choice Controls

    Edit List Binidng Dialog

    If you select ADF Mobile Select One Radio option, another version of the Edit List Binding dialog is displayed, as shown in Figure 6-31.

    Figure 6-31 Edit List Binding Dialog for Select One Radio Control

    Edit List Binidng Dialog for Select One Radio Control

    If you select ADF Mobile Select Boolean Checkbox or ADF Mobile Select Boolean Switch option, another version of the Edit List Binding dialog is displayed, as shown in Figure 6-32.

    Figure 6-32 Edit List Binding Dialog for Select Boolean Checkbox and Switch Controls

    Edit list binding dialog
  • Text: this category provides options for creating the following controls:

    • ADF Mobile Input Text

    • ADF Mobile Input Text with Label

    • ADF Mobile Output Text

    • ADF Mobile Output Text with Label

    Figure 6-29 shows the context menu for adding selection controls that appears when you drag an attribute from the Data Controls panel into the Structure window of a ADF Mobile AMX page.

    Figure 6-33 Context Menu for Text Controls

    Context Menu for Text Controls
6.3.2.4.2 Dragging and Dropping Operations

In addition to attributes, you can drag and drop operations or custom methods. Depending on the type of operation or method, different data binding menu options are provided, as follows:

  • Operation: this category is for data control operations. It provides the following options (see Figure 6-34):

    • ADF Mobile Button

    • ADF Mobile Link

    • ADF Mobile Parameter Form

    Figure 6-34 Context Menu for Operations

    Context Menu for Operations

    Note:

    If you drop an operation or a method as a child of the List View control, the context menu does not appear and the List Item is created automatically because no other valid control can be dropped as a direct child of the List View control. JDeveloper creates a binding similar to the following for the generated List Item:

    <amx:listItem actionListener="#{bindings.getLocation.execute}"/>
    
  • Method: this category is for custom methods. It provides the following options (see Figure 6-34):

    • ADF Mobile Button

    • ADF Mobile Link

    • ADF Mobile Parameter Form

    Figure 6-35 Context Menu for Methods

    Context Menu for Method

    The ADF Mobile Parameter Form option allows you to choose the method or operation arguments to be inserted in the form, as well as the respective controls for each of the arguments (see Figure 6-36).

    Figure 6-36 Edit Form Fields Dialog

    Edit Form Fields Dialog

    The following data bindings are generated after you select the appropriate options in the Edit Form Fields dialog:

    <amx:panelFormLayout id="pfl1">
       <amx:inputText id="it1"
                      value="#{bindings.actionEvent.inputValue}"
                      label="#{bindings.actionEvent.hints.label}"
                      required="#{bindings.actionEvent.hints.mandatory}"
                      maximumLength="#{bindings.actionEvent.hints.precision}"/>
    </amx:panelFormLayout>
    <amx:commandButton id="cb1"
                       actionListener="#{bindings.cleanInputParameter.execute}"
                       text="cleanInputParameter"
                       disabled="#{!bindings.cleanInputParameter.enabled}"/>
    

    For more information about generated bindings, see Section 6.3.2.4.4, "What You May Need to Know About Generated Bindings."

    The following are supported control types for the ADF Mobile Parameter Form:

    • ADF Mobile Input Date

    • ADF Mobile Input Date with Label

    • ADF Mobile Input Text

    • ADF Mobile Input Text with Label

    • ADF Mobile Output Text with Label

6.3.2.4.3 Dragging and Dropping Collections

You can drag and drop collections. Depending on the type of collection, different data binding menu options are provided, as follows:

  • Multiple Selection: this category provides options for creating multiple selection controls. The following controls can be created under this category (see Figure 6-37):

    • ADF Mobile Select Many Checkbox

    • ADF Mobile Select Many Choice

    Figure 6-37 Context Menu for Multiple Selection Controls

    Context Menu for Multiple Selection Controls
  • Form: this category is used to create the ADF Mobile AMX Panel Form controls. The following controls can be created under this category (see Figure 6-38):

    • ADF Mobile Form

    • ADF Mobile Read-only Form

    Figure 6-38 Context Menu for Form Controls

    Context Menu for Form Controls

    If you select ADF Mobile Form as the type of the form you want to create, a JDeveloper wizard is invoked that lets you choose the fields to be inserted in the form, as well as the respective controls for each of the fields (see Figure 6-39).

    Figure 6-39 Edit Form Fields Dialog for ADF Mobile Form

    Edit Form Fields Dialog

    The following data bindings are generated after you select the appropriate options in the Edit Form Fields dialog:

    <amx:panelFormLayout id="pfl1">
       <amx:inputDate id="id1"
                      value="#{bindings.timeStamp.inputValue}"
                      required="#{bindings.timeStamp.hints.mandatory}">
          <amx:convertDateTime pattern="#{bindings.timeStamp.format}"/>
       </amx:inputDate>
       <amx:inputText id="it1"
                      value="#{bindings.speed.inputValue}"
                      simple="true"
                      required="#{bindings.speed.hints.mandatory}"
                      maximumLength="#{bindings.speed.hints.precision}"/>
       <amx:inputText id="it2"
                      value="#{bindings.heading.inputValue}"
                      label="#{bindings.heading.hints.label}"
                      required="#{bindings.heading.hints.mandatory}"
                      maximumLength="#{bindings.heading.hints.precision}"/>
       <amx:panelLabelAndMessage id="plm1"
                                 label="#{bindings.latitude.hints.label}">
          <amx:outputText id="ot1" value="#{bindings.latitude.inputValue}"/>
       </amx:panelLabelAndMessage>
       <amx:inputDate id="it3"
                      value="#{bindings.timeStamp.inputValue}"
                      label="#{bindings.timeStamp.hints.label}"
                      required="#{bindings.timeStamp.hints.mandatory}">
          <amx:convertDateTime pattern="#{bindings.timeStamp.format}"/>
       </amx:inputDate>
    </amx:panelFormLayout>
    

    For more information about generated bindings, see Section 6.3.2.4.4, "What You May Need to Know About Generated Bindings."

    The following are supported controls for ADF Mobile Form:

    • ADF Mobile Input Date

    • ADF Mobile Input Date with Label

    • ADF Mobile Input Text

    • ADF Mobile Input Text with Label

    • ADF Mobile Output Text with Label

    Note:

    Since ADF Mobile Output Text is not a valid Panel Form Layout child element as defined by the ADF Mobile schema, it is not supported.

    If you select ADF Mobile Read-only Form as the type of the form you want to create, a JDeveloper wizard is invoked that lets you choose the fields to be inserted in the form, as well as the respective controls for each of the fields (see Figure 6-40).

    Figure 6-40 Edit Form Fields Dialog for ADF Mobile Read-only Form

    Edit Form Fields Dialog for ADF Mobile Read-only Form

    The following data bindings are generated after you select the appropriate options in the Edit Form Fields dialog:

    <amx:panelFormLayout id="pfl1">
       <amx:panelLabelAndMessage id="plm1" label="#{bindings.AssetNo.hints.label}">
          <amx:outputText id="ot1" value="#{bindings.AssetNo.inputValue}"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage id="plm2" label="#{bindings.Item.hints.label}">
          <amx:outputText id="ot2" value="#{bindings.Item.inputValue}"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage id="plm3"
                                 label="#{bindings.Description.hints.label}">
          <amx:outputText id="ot3" value="#{bindings.Description.inputValue}"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage id="plm4"
                                 label="#{bindings.Assignee.hints.label}">
          <amx:outputText id="ot4" value="#{bindings.Assignee.inputValue}"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage id="plm5"
                                 label="#{bindings.AssignedOn.hints.label}">
          <amx:outputText id="ot5" value="#{bindings.AssignedOn.inputValue}"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage id="plm6"
                                 label="#{bindings.SupplierId.hints.label}">
          <amx:outputText id="ot6" value="#{bindings.SupplierId.inputValue}"/>
       </amx:panelLabelAndMessage>
    </amx:panelFormLayout>
    

    For more information about generated bindings, see Section 6.3.2.4.4, "What You May Need to Know About Generated Bindings."

    The ADF Mobile Read-only Form only supports the ADF Mobile Output Text with Label control.

  • Iterator: this provides an option for creating the ADF Mobile AMX Iterator with child components (see Figure 6-41).

    Figure 6-41 Context Menu for Iterator Control

    Context Menu for Iterator Control

    If you select ADF Mobile Iterator as the type of the control to create, a JDeveloper wizard is invoked that lets you choose the fields to be inserted in the iterator, as well as the respective controls for each of the fields, with ADF Mobile Output Text w/Label being a default selection (see Figure 6-42).

    Figure 6-42 Edit Dialog for ADF Mobile Iterator

    Edit Iterator Fields Dialog for ADF Mobile Iterator

    The following data bindings are generated after you select the appropriate options in the Edit Iterator dialog:

    <amx:iterator var="row" 
                  value="#{bindings.addresses.collectionModel}"
                  id="iterator1">
       <amx:panelLabelAndMessage label="#{bindings.addresses.hints.type.label}"
                                 id="panelLabelAndMessage6">
          <amx:outputText value="#{row.type}" id="outputText6"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage label=
                                 "#{bindings.addresses.hints.formatted.label}"
                                 id="panelLabelAndMessage2">
          <amx:outputText value="#{row.formatted}"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage label=
                                 "#{bindings.addresses.hints.streetAddress.label}"
                                 id="panelLabelAndMessage5">
          <amx:outputText value="#{row.streetAddress}" id="outputText5"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage label="#{bindings.addresses.hints.locality.label}"
                                 id="panelLabelAndMessage4">
          <amx:outputText value="#{row.locality}" id="outputText4"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage label="#{bindings.addresses.hints.region.label}"
                                 id="panelLabelAndMessage7">
          <amx:outputText value="#{row.region}" id="outputText7"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage label=
                                 "#{bindings.addresses.hints.postalCode.label}"
                                 id="panelLabelAndMessage1">
          <amx:outputText value="#{row.postalCode}" id="outputText1"/>
       </amx:panelLabelAndMessage>
       <amx:panelLabelAndMessage label="#{bindings.addresses.hints.country.label}"
                                 id="panelLabelAndMessage3">
          <amx:outputText value="#{row.country}" id="outputText3"/>
       </amx:panelLabelAndMessage>
    </amx:iterator>
    

    For more information about generated bindings, see Section 6.3.2.4.4, "What You May Need to Know About Generated Bindings."

    The following are supported controls for ADF Mobile Iterator:

    • ADF Mobile Input Text

    • ADF Mobile Input Text with Label

    • ADF Mobile Output Text

    • ADF Mobile Output Text with Label

  • List View: this provides an option for creating the ADF Mobile AMX List View with child components (see Figure 6-43).

    Figure 6-43 Context Menu for List View Control

    Context Menu for List View Control

    If you select ADF Mobile List View as the type of the control to create, the ListView Gallery opens that allows you to choose a specific layout for the List View, as Figure 6-44 shows.

    Figure 6-44 ListView Gallery

    ListView Gallery

    Table 6-3 lists the supported List Formats that are displayed in the ListView Gallery.

    Table 6-3 List Formats

    Format Element Row Values

    Simple

    • Text

    Main-Sub Text

    • Main Text

    • Subordinate Text

    Start-End

    • Start Text

    • End Text

    Quadrant

    • Upper Start Text

    • Upper End Text

    • Lower Start Text

    • Lower End Text


    The Variations presented in the ListView Gallery (see Figure 6-44) for a selected list format consist of options to add either dividers, a leading image, or both:

    • Selecting a variation with a leading image adds an Image row to the List Item Content table (see Figure 6-45).

    • Selecting a variation with a divider defaults the Divider Attribute field to the first attribute in its list rather than the default No Divider value, and populates the Divider Mode field with its default value of All.

    The Styles options presented in the ListView Gallery (see Figure 6-44) allow you to suppress chevrons, use an inset style list, or both:

    • The selections do not modify any state in the Edit List View dialog (see Figure 6-45). They only affect the generated ADF Mobile AMX markup.

    • Selecting a style with the inset list sets the adfmf-listView-insetList style class on the listView element in the generated ADF Mobile AMX markup.

    • Selecting a style without chevrons sets the showLinkIcon attribute on the listItem element to false in the generated ADF Mobile AMX markup.

    The following is an example of the Simple format with the inset list and chevrons:

    <amx:listView var="row"
                  value="#{bindings.employees.collectionModel}"
                  fetchSize="#{bindings.employees.rangeSize}"
                  styleClass="adfmf-listView-insetList"
                  id="listView2">
       <amx:listItem id="li2">
          <amx:outputText value="#{row.employeename}" id="ot3"/>
       </amx:listItem>
    </amx:listView>
    

    The ListView Gallery's Description pane is updated based on the currently selected Variation. The format will include a brief description of the main style, followed by the details of the selected variation. Four main styles with four variations on each provide sixteen unique descriptions detailed in Table 6-4.

    Table 6-4 List View Variations and Styles

    List Format Variation Description

    Simple

    Basic

    A text field appears at the start side of the list item."

    Simple

    Dividers

    A text field appears at the start side of the list item, with items grouped by dividers."

    Simple

    Images

    A text field appears at the start side of the list item, following a leading image.

    Simple

    Dividers and Images

    A text field appears at the start side of the list item, following a leading image. The list items are grouped by dividers.

    Main-Sub Text

    Basic

    A prominent main text field appears at the start side of the list item with subordinate text below.

    Main-Sub Text

    Dividers

    A prominent main text field appears at the start side of the list item with subordinate text below. The list items are grouped by dividers.

    Main-Sub Text

    Images

    A prominent main text field appears at the start side of the list item with subordinate text below, following a leading image.

    Main-Sub Text

    Dividers and Images

    A prominent main text field appears at the start side of the list item with subordinate text below, following a leading image. The list items are grouped by dividers.

    Start-End

    Basic

    Text fields appear on each side of the list item

    Start-End

    Dividers

    Text fields appear on each side of the list item, with the items grouped by dividers.

    Start-End

    Images

    Text fields appear on each side of the list item, following a leading image.

    Start-End

    Dividers and Images

    Text fields appear on each side of the list item, following a leading image. The list items are grouped by dividers.

    Quadrant

    Basic

    Text fields appear in the four corners of the list item.

    Quadrant

    Dividers

    Text fields appear in the four corners of the list item, with items grouped by dividers.

    Quadrant

    Images

    Text fields appear in the four corners of the list item, following a leading image.

    Quadrant

    Dividers and Images

    Text fields appear in the four corners of the list item, following a leading image. The list items are grouped by dividers.


    After you make your selection from the ListView Gallery and click OK, the Edit List View wizard is invoked that lets you create the contents of a List Item by mapping binding attributes to the elements of the selected List View format, as Figure 6-45 shows.

    Figure 6-45 Edit Dialog for ADF Mobile List View

    Edit Dialog for ADF Mobile List View

    When completing the dialog that Figure 6-45 shows, consider the following:

    • The image at the start reflects the main content elements from the selected List View format and provides a mapping from the schematic representation to the named elements in the underlying table.

    • The read-only cells in the Element column derive from the selected List View format.

    • The editable cells in the Value Binding column are based on the data control node that was dropped.

    • The List Item is generated as either an Output Text or Image component, depending on whichever is appropriate for the particular element.

    • Since the number of elements (rows) is predetermined by the selected List View format, rows cannot be added or removed.

    • The order of elements cannot be modified.

    • The default value of the Divider Attribute field is No Divider, in which case the Divider Mode field is disabled. If you select value other than the default, then you need to specify Divider Mode parameters, as Figure 6-46 and Figure 6-47 show.

    Figure 6-46 Specifying Divider Attribute

    Specifying Divider Property

    Figure 6-47 Specifying Divider Mode

    Specifying Divider Mode

    For more information on List View dividers, see Section 7.2.7, "How to Use List View and List Item Components."

    The following ADF Mobile AMX markup and data bindings are generated after you select the appropriate options in the Edit List View dialog:

    <amx:listView var="row"
                  value="#{bindings.contacts.collectionModel}"
                  fetchSize="#{bindings.contacts.rangeSize}"
                  dividerAttribute="key"
                  dividerMode="all"
                  id="listView1">
       <amx:listItem showLinkIcon="false" id="listItem1" >
          <amx:panelGroupLayout layout="horizontal" 
                                id="panelGroupLayout1">
             <amx:image source="#{row.key}" id="image1"/>
             <amx:panelGroupLayout id="panelGroupLayout2">
                <amx:outputText value="#{row.id}"
                                styleClass="adfmf-listItem-maintext"
                                id="outputText2"/>
                <amx:outputText value="#{row.key}"
                                styleClass="adfmf-listItem-subtext" 
                                id="outputText1"/>
             </amx:panelGroupLayout>
          </amx:panelGroupLayout>
       </amx:listItem>
    </amx:listView>
    

    For more information about generated bindings, see Section 6.3.2.4.4, "What You May Need to Know About Generated Bindings."

    The following are supported controls for ADF Mobile List View:

    • ADF Mobile Output Text

    • ADF Mobile Image

6.3.2.4.4 What You May Need to Know About Generated Bindings

Table 6-5 shows sample bindings that are added to an ADF Mobile AMX page when components are dropped.

Table 6-5 Sample Data Bindings

Component Data Bindings

Button

actionListener="#{bindings.FindContacts.execute}"
text="FindContacts" disabled="#{!bindings.FindContacts.enabled}"

Link

actionListener="#{bindings.FindContacts.execute}"
text="FindContacts" disabled="#{!bindings.FindContacts.enabled}"

Input Date with Label

<amx:inputDate id="inputDate1" 
               value="#{bindings.timeStamp.inputValue}"
               label="#{bindings.timeStamp.hints.label}" 
               required="#{bindings.timeStamp.hints.mandatory}">
</amx:inputDate> 

Input Date

<amx:inputDate id="inputDate1"
               value="#{bindings.timeStamp.inputValue}"
               required="#{bindings.timeStamp.hints.mandatory}">
</amx:inputDate> 

Input Text with Label

value="#{bindings.contactData.inputValue}"
label="#{bindings.contactData.hints.label}"
required="#{bindings.contactData.hints.mandatory}"
maximumLength="#{bindings.contactData.hints.precision}" 

Input Text

value="#{bindings.contactData.inputValue}"
simple="true"
required="#{bindings.contactData.hints.mandatory}"
maximumLength="#{bindings.contactData.hints.precision}" 

Output Text

value="#{bindings.contactData.inputValue}" 

Output Text with Label

<amx:panelLabelAndMessage id="panelLabelAndMessage1"
          label="#{bindings.contactData.hints.label}">
   <amx:outputText value="#{bindings.contactData.inputValue}"/>
</amx:panelLabelAndMessage>

Select Boolean Checkbox

value="#{bindings.contactData.inputValue}"
label="#{bindings.contactData.label}" 

Select Boolean Switch

value="#{bindings.contactData.inputValue}"
label="#{bindings.contactData.label}" 

Select One Button

<amx:selectOneButton id="selectOneButton1"
           value="#{bindings.contactData.inputValue}"
           label="#{bindings.contactData.label}"
           required="#{bindings.contactData.hints.mandatory}">
   <amx:selectItems value="#{bindings.contactData.items}"/>
</amx:selectOneButton> 

Select One Choice

<amx:selectOneChoice id="selectOneChoice1"
                value="#{bindings.contactData.inputValue}"
                label="#{bindings.contactData.label}"
                required="#{bindings.contactData.hints.mandatory}">
   <amx:selectItems value="#{bindings.contactData.items}"/>
</amx:selectOneChoice> 

Select Many Checkbox

<amx:selectManyCheckbox id="selectManyCheckbox1"
                      value="#{bindings.AssetView.inputValue}"
                      label="#{bindings.AssetView.label}">
   <amx:selectItems value="#{bindings.AssetView.items}"/>
</amx:selectManyCheckbox> 

Select One Radio

<amx:selectOneRadio id="selectOneRadio1"
               value="#{bindings.contactData.inputValue}"
               label="#{bindings.contactData.label}"
               required="#{bindings.contactData.hints.mandatory}">
   <amx:selectItems value="#{bindings.contactData.items}"/>
</amx:selectOneRadio> 

Select Many Choice

<amx:selectManyChoice id="selectManyChoice1"
                      value="#{bindings.AssetView.inputValue}"
                      label="#{bindings.AssetView.label}">
   <amx:selectItems value="#{bindings.AssetView.items}"/>
</amx:selectManyChoice> 

6.3.2.4.5 What You May Need to Know About Generated Drag and Drop Artifacts

The first drag and drop event generates the following directories and files:

Drag and Drop directories

Figure 6-48 shows a sample DataBindings.cpx file generated upon drag and drop.

Figure 6-48 DataBindings.cpx File

DataBindings.cpx

For more information, see the "Working with the DataBindings.cpx File" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

Figure 6-49 shows a sample PageDef file generated upon drag and drop.

Figure 6-49 PageDef File

PageDef file

For more information, see the "Working with Page Definition Files" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.

6.3.2.4.6 Using the ADF Mobile AMX Editor Bindings Tab

JDeveloper's Bindings tab (see Figure 6-50) is available in the ADF Mobile AMX Editor. It displays the data bindings defined for a specific ADF Mobile AMX page. If you select a binding, its relationship to the underlying Data Control are shown and the link to the PageDef file is provided.

Figure 6-50 Bindings Tab

Bindings Tab
6.3.2.4.7 What You May Need to Know About Removal of Unused Bindings

When you delete or cut an ADF Mobile AMX component from the Structure pane, unused bindings are automatically removed from your page.

Note:

Deleting a component from the Source editor does not trigger the removal of bindings.

Figure 6-51 demonstrates the deletion of a List View component that references bindings. Upon deletion, the related binding entry is automatically removed from the corresponding PageDef.xml file.

Figure 6-51 Deleting Bound Components from Page

Deleting Bound Components

Figure 6-52 demonstrates the removal of the List View component by cutting it from the page.

Figure 6-52 Cutting Bound Components from Page

Cutting Bound Components

After clicking Cut, you are presented with the Confirm Removal of Bindings dialog that prompts you to choose whether or not to delete the corresponding bindings, as shown in Figure 6-53.

Figure 6-53 Confirm Removal of Bindings Dialog

Confirm Removal of Bindings Dialog

6.3.2.5 What You May Need to Know About Element Identifiers and Their Audit

ADF Mobile generates a unique element identifier (id) and automatically inserts it into the ADF Mobile AMX page when an element is added by dropping a component from the Component palette, or by dragging and dropping a data control. This results in a valid identifier in the ADF Mobile AMX page that differentiates each component from others, possibly similar components within the same page.

ADF Mobile provides an identifier audit utility that does the following:

  • Checks the presence and uniqueness of identifiers in an ADF Mobile AMX page.

  • If the identifier is not present or not unique:

    • for a required id attribute of an element, an error is reported;

    • for an optional id attribute of an element, a warning is reported.

  • Provides an automatic fix to generate a unique id for the element when a problem with the identifier is reported.

Figure 6-54 and Figure 6-55 show the identifier error reporting in the Source editor and Structure pane respectively.

Figure 6-54 Element Identifier Audit in Source Editor

Element Identifier Audit in Source Editor

Figure 6-55 Element Identifier Audit in Structure Pane

Element Identifier Audit in Structure Pane

In addition to the id, the audit utility checks the popupId and alignId attributes of the Show Popup Behavior operation (see Section 7.2.8, "How to Use a Popup Component").

Figure 6-56 and Figure 6-57 show the Show Popup Behavior's Popup Id and Align Id attributes error reporting in the Source Editor respectively.

Figure 6-56 Popup Id Attribute Audit in Source Editor

Popup Id Audit in Source Editor

Figure 6-57 Align Id Attribute Audit in Source Editor

Align Id Attribute Audit in Source Editor

For more information, see "Auditing and Profiling Applications" in Oracle Fusion Middleware User's Guide for Oracle JDeveloper.