Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle Business Intelligence Mobile App Designer
11g Release 1 (11.1.1)

Part Number E40220-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

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

7 Configuring App Settings

This chapter describes how to update data sources and how to configure the app settings such as parameters, caching, and translations.

It includes the following sections:

7.1 Accessing App Settings

To access app settings, click the Setting menu and choose the setting to update.

Settings toolbar

See the following sections for tasks you can perform from the Setting menu:

7.2 Updating the Data Source

7.2.1 Add Multiple Subject Areas to a Data Source

You can add multiple subject areas to your app data source:

  1. On the Setting menu, select Update Data Source to launch the Select Subject Areas dialog.

    Adding multiple subject areas to a data source
  2. From the Available list, select one or more subject areas.

  3. Click Move to move the subject areas to the Selected list.

  4. Click Finish.

7.2.2 Update a BI Publisher Data Model

  1. On the Setting menu, select Update Data Source to launch the BI Publisher data model editor.

  2. Update the data model following the guidelines in the Oracle Fusion Middleware Data Modeling Guide for Oracle Business Intelligence Publisher.

  3. Click Return to return to the Mobile App Designer.

7.3 Configuring Parameters

How you configure parameters depends on whether your data source is a BI Publisher data model or a BI subject area.

7.3.1 Configure Parameters for a BI Subject Area Data Source

To add parameters to a subject area data source:

  1. On the Setting menu, select Parameters.

  2. In the Parameters dialog, click Add.

    Adding a parameter
  3. In the Select a Column to Define Parameter dialog, select the column to define the parameter and click OK. In this example, the Per Name Year column is chosen to create the parameter.

    Selecting a column to define a parameter
  4. Define the parameter settings in the Edit Parameter dialog.

    Defining parameter settings
  5. Enter the label to display for the parameter in the app.

  6. Select a parameter display option.

    Setting parameter display option
    • Calendar - Provides users with a field into which they can enter a specific date, as well as a calendar pop-up to select a date. This display option is only available for selection if the parameter has a date column type.

    • Choice List - Provides users with a collapsed list of all prompt values. This display option is useful for a long list of values where you want to provide the user with the ability to search for a specific value.

    • Checkboxes - Provides users with a visible list of all prompt values where a small, selectable box displays before each value item. This display option is suitable for a prompt that contains a smaller set of data.

    • Radio Buttons - Provides users with a visible list of all prompt values where a radio button is displayed before each prompt value. This display option is useful for short lists of values where the user is to select only one prompt value.

    • Text - Provides users with a field into which they can enter a specific prompt value. This display option cannot be used for multiple prompt values. Only the field and the field label are displayed for this option.

  7. Under Options, select Refresh other parameters on change to constrain the values available for other parameters based on the value selected for this parameter. For example, if you created a parameter for Brand and a parameter for Product Type, select Refresh other parameters on change so that after you select a value for Brand the Product Type selection list displays only those product types available for the selected Brand.

  8. Click OK.

  9. In the Parameters dialog, enter a default value for the parameter.

    Setting a default value
  10. Click OK.

7.3.2 Configure Parameters for a BI Publisher Data Model Data Source

Parameters are defined in the BI Publisher data model. To add a new parameter, see Section 7.2.2, "Update a BI Publisher Data Model.".

The app editor enables you to configure the parameter settings specifically for each app that uses the data model.

To configure the parameters for this app:

  1. On the Setting menu, select Parameters.

    Parameter settings dialog
  2. Customize the parameter settings for this app by making selections for the following display options:

Show

This property controls whether the parameter is displayed to the user. Disable the Show property if you do not want the user to see or change the parameter values that are passed to the data model.

Type

This property is customizable for menu type parameters only. For menu type parameters, the following display options are available:

  • Menu - Provides users with a collapsed list of all prompt values. This display option is useful for a long list of values where you want to provide the user with the ability to search for a specific value.

  • Checkboxes - Provides users with a visible list of all prompt values where a small, selectable box displays before each value item. This display option is suitable for a prompt that contains a smaller set of data.

  • Radio Buttons - Provides users with a visible list of all prompt values where a radio button is displayed before each prompt value. This display option is useful for short lists of values where the user is to select only one prompt value.

Multiple

This property indicates whether multiple values may be selected for a menu parameter. This property is defined in the BI Publisher data model and is display only here.

Display Label

Use this property to edit the display labels shown for each parameter. The default values are defined in the data model.

Default Value

Use this property to configure the default value. Choose "Default" to pass the default value defined in the data model.

Row Placement

Not used.

7.4 Setting App Caching Properties

When data caching is enabled, the data generated by the app is stored in the cache. Subsequent requests to view this app with the same parameter selections display the app using the data that is stored in the cache. This setting enhances performance by using stored data to generate the app rather than regenerating the data from the source. The data remains in the cache according to the time limit that is specified in the Cache Duration property.

When you enable caching you can choose between two types of caching:

To configure caching for your app:

  1. On the Setting menu select Data Cache.

    Select Data Cache
  2. On the App Properties dialog, select Enable Data Caching.

    Enable data caching
  3. Choose User Level or Document Caching and enter the length of time in minutes for the data to remain in the cache.

    Caching level options
  4. Click OK.

7.5 Adding Translations

This section describes translation support in the Mobile App Designer. It includes the following topics:

7.5.1 What Is App Translation?

App translation is a feature of Mobile App Designer that enables you to extract the translatable strings from an app layout into an industry-standard XLIFF translation file.

You can translate these strings within your organization or send the file to a localization provider. You then upload the translated XLIFF file back to the app and assign it the appropriate locale.

At run time, when a user's Locale preference is set to the locale of an available XLIFF translation file, the translated strings from the XLIFF are applied to the app and the user sees the translations of the text strings appropriate for his locale.

7.5.2 Downloading a Translation File

To generate and download the XLIFF file for an app:

  1. On the Setting menu select Translation.

    Selecting Translation
  2. In the Translations region, click Extract Translation.

    BI Mobile App Designer extracts the translatable strings from the template and exports them to an XLIFF (.xlf) file.

    Extract Translation
  3. When prompted, save the XLIFF file to a local directory.

7.5.3 Translating the XLIFF File

After downloading the XLIFF file, you can send it to a translation provider, or using a text editor, you can enter the translation for each string. For information about how to edit an XLIFF file, see the chapter "Translation Support Overview and Concepts" in the Oracle Fusion Middleware Report Designer's Guide for Oracle Business Intelligence Publisher.

A "translatable string" is any text in the app that is intended for display, such as table headers and field labels. Text supplied at run time from the data is not translatable.

You can translate the app XLIFF file into as many languages as desired and associate these translations to the original app for multiple language support in a single app.

7.5.4 Uploading the Translated File

To upload the translated XLIFF:

  1. Open the app for editing and select Translation from the Settings menu.

  2. In the Translations region, click the Upload toolbar button.

    Upload Translation
  3. In the Upload Translation File dialog locate the file in a local directory and select the Locale for this translation.

    Upload Translation File dialog
  4. Click OK to upload the file and view it in the Translations table.

    Uploaded translation file

Now users whose locale setting matches the locale assigned to this translation see the translated strings when viewing this app.