dataProvider - Name Picker Data Provider

Provides selection data for a name picker.

Category

basics

Syntax

<xe:this.dataProvider>
	<xe:beanNamePicker attributes>content</xe:beanNamePicker> |
	<xe:dominoNABNamePicker attributes>content</xe:dominoNABNamePicker> |
	<xe:dominoViewNamePicker attributes>content</xe:dominoViewNamePicker> |
	<xe:namePickerAggregator attributes>content</xe:namePickerAggregator>
</xe:this.dataProvider>
Table 1. Properties for xe:beanNamePicker
Property Description
dataBean Name or class name of the managed bean.
loaded Whether the tag instance should be created when the page is loading. Defaults to true.
Table 2. Properties for xe:dominoNABNamePicker
Property Description
addressBookDb Name of database containing the address book if addressBookSel is db-name.
addressBookSel Databases containing address books: all, all-public, all-private, first, first-public, or db-name.
groups Whether to include group entries, if nameList is null. Defaults to true.
loaded Whether the tag instance should be created when the page is loading. Defaults to true.
nameList Entries to be returned: people, peopleByLastName, groups, or peopleAndGroups. Overrides groups and people.
people Whether to include people entries, if nameList is null. Defaults to true.
Table 3. Properties for xe:dominoViewNamePicker
Property Description
databaseName Name of the application containing the view.
label Uniquely identifies this data provider, if multiple data providers are used. Appears in the picker control dialog so users can choose which directory to search.
labelColumn Label of a column in the view.
loaded Whether the tag instance should be created when the page is loading. Defaults to true.
viewName Name of the view.
Table 4. Properties for namePickerAggregator
Property Description
dataProviders One or more of the following data providers: xe:beanNamePicker, xe:dominoNABNamePicker, xe:dominoViewNamePicker, or xe:namePickerAggregator.
loaded Whether the tag instance should be created when the page is loading. Defaults to true.

Usage

In Design mode, click All Properties and look for dataProvider under basics.

Examples

This name picker provides a choice of names for an input box from the local names.nsf database.
<xp:this.data>
	<xp:dominoDocument var="document1" formName="main"></xp:dominoDocument>
</xp:this.data>
<xp:inputText id="inputText3" value="#{document1.subject}"></xp:inputText>
<xe:namePicker id="namePicker1" for="inputText3">
	<xe:this.dataProvider>
		<xe:dominoNABNamePicker addressBookSel="db-name"
			addressBookDb="names.nsf">
		</xe:dominoNABNamePicker>
	</xe:this.dataProvider>
</xe:namePicker>