Common Elements Used in This Section

Field or Control Description

Description

Displays a description of the data source parameter.

Usage Type

Select the type of end-user accessibility that you want to grant for the Data Source Parameter field when it appears on the pagelet. Options are:

  • Not Used: Select if it will not be used on the pagelet.

  • Fixed: Select to enter a fixed value for the data source parameter that the pagelet end user cannot modify.

  • System Variable: Select to assign a system variable as the data source parameter value. The value of the system variable is automatically inserted into the parameter when the pagelet appears. When you select this option, the pagelet end user cannot modify the data source parameter.

    For example, suppose that you specify %UserId as the system variable for a User data source parameter field. When the pagelet appears on a user’s homepage, the User field is populated by the %UserId system variable, which is the user ID used to access the pagelet.

  • User Specified: Select to enable end users to specify a data source parameter value for this field. When a pagelet contains a user-specified field, the Customize button appears on the pagelet title bar.

    End users can click this button to access a personalization page, where they can select a data source parameter value that they want to appear by default on the pagelet when they access it. They can select a value from a prompt, or they can manually enter their own value if no prompt values are available.

    If you change the usage type from or to User Specified for a data source parameter on a published homepage pagelet, you must unpublish and republish the pagelet.

  • Admin Specified: Enables users with administrative privileges to specify variables for this field as well as access the Configure link on the published pagelet and select from those parameters for users.

  • Context Sensitive: Enables users to specify context sensitivity for activity guide, OBIEE, and embedded pagelets.

Default Value

If you select User Specified or Admin Specified as the usage type and the data source parameter is a required value, you must enter the default value that should appear before a user enters a value. If the data source parameter is not a required value, you do not have to enter a default value.

If you select a default value when defining available user-specified values on the Specify Data Source Parameter Values page, this field is populated with that default value.

If you select User Specified as the usage type, you can enter a system variable as the default value. For example, to make the current date the default value for a user-specified parameter, enter a default value of %Date.

If you select System Variable as the usage type, you must enter the system variable to use as the data source parameter value.

See Understanding System Variables Supported as Data Source Parameters.

If you select Fixed as the usage type, you must enter the fixed value.

You can enter a value that includes the % and * wildcards at the beginning or end of a value in the Default Value field.

Magnifying glass icon

If you select Fixed as the usage type and the data source parameter has associated prompt values, you can use the Look up Value button to search for available data source parameter values.

If you select System Variable as the usage type, you can use the Look up Value button to access a list of valid system variables.

If you select User Specified as the usage type, this button does not appear.

User Values

If you select User Specified as the usage type, click to access the Specify Data Source Parameter Values page.

See Step 3: Specifying Pagelet Data Source Parameters.