IPFDropdown formatter

Because the IPFDropdown formatter has many attribute options, they are grouped into tabs. For information about a specific option in the FDF Editor, click in the field to see the context-sensitive help.

There are three types of drop-down lists:

  • Collection: Items in the drop-down list come from a collection in a specified data source.
  • Inline Collection: Items in the list are specified manually.
  • Layout: Items in the drop-list come from a layout.

The tabs that are displayed, and the options on those tabs, depend on the type of drop-down list you select in the Type field.

Main Attributes tab

This tab is always displayed. Use this tab to specify general information such as the drop-down type. For type Collection, you also specify the collection whose properties are used to define the list. For type Layout, you also specify information about the layout whose properties are used to define the list.

Add Properties tab

This tab is displayed only for Inline Collection drop-downs. Use it to specify the attribute options that can be used to create a schema. You can add multiple properties and add data for these properties.

Display Properties tab

This tab is always displayed. Use this tab to add the properties to be displayed in the dropdown list.

Additional Properties

This tab is displayed only for Collection or Layout drop-downs. Use it to specify additional properties that can be returned or stored in layout components.

Ordering Attributes tab

This tab is displayed only for Collection or Layout drop-downs. Use it to add one or more properties to order the collection used by the layout.

Filtering Attributes tab

This tab is displayed only for Collection or Layout drop-downs. Use it to specify a Where clause and filters to apply to the collection used by the layout.

On the Filtering Attributes tab, the type of filter you specify determines what you specify in the Name field, as shown in this table:

Filter type Name
Incoming Filter Property Specifies the name of the property that contains the filter value
Outer Layout Property Specifies the name of the property in the parent layout that contains the filter value
Layout Variable Specifies the name of the layout variable that contains the filter value
Outer Layout Variable Specifies the name of the layout variable in the parent layout that contains the filter value
Session Variable Specifies the name of the session variable that contains the filter value
Literal Specifies the literal value that contains the filter value

All browsers support the functionality described here. There is no fallback functionality for specific browsers. This table shows how the field is displayed with and without formatting:

Before formatting After formatting
Editable text in a header:

Drop-down list using this formatter definition to display items and their translated descriptions:

DropdownCollection Name="SLCoitems"

Property Name="DerItem"

Property Name="DerDescription"

WhereClause: CoType != 'E' and CoStat in ('C','O')

Order By: DerItem Ascending

This displays a column of data from a layout. The header is Status and the value displayed is the raw data from the data source:

Drop-down list using this formatter definition to map 1 to Shipped and 0 to Ordered:

InlineCollection

Schema: name="Status", name="StatusDesc"

Data: row/col 1 sShipped

row/col 0 sOrdered

StringIds:

Property Name="StatusDesc"

Display: Property Name="StatusDesc"

ValueProperty: Name="Status"

DropdownProperty="StatusDesc"