All blog posts, code samples and downloads licensed under Apache License 2.0.

Create option groups for XPages comboboxes

Oliver Busse on 03.10.2013 16:55:24 CEDT, filed under SSJS XSP Java 

After some fiddling around I finally got my solution for displaying option groups within a combobox. The code below turns a single categorized view into a source for a combobox.

It turns this


into this

Watch a live demo here

package com.olb;
import java.util.ArrayList;
import java.util.List;
import javax.faces.model.SelectItem;
import javax.faces.model.SelectItemGroup;
import lotus.domino.Document;
import lotus.domino.NotesException;
import lotus.domino.View;
import lotus.domino.ViewEntry;
import lotus.domino.ViewNavigator;
public class ControlHelper implements Serializable {
	private static final long serialVersionUID = 3502929052852261492L;
	public List<SelectItem> getOptions() {
		View view;
		ViewNavigator nav;
		ViewEntry ent;
		ViewEntry tmp;
		Document doc;
		SelectItemGroup group = null;
		List<SelectItem> list = new ArrayList<SelectItem>();
		List<SelectItem> items = null;
		try {
			view = ExtLibUtil.getCurrentDatabase().getView("theViewWithSingleCategory");
			nav = view.createViewNav();
			ent = nav.getFirst();
			while (ent != null) {
				tmp = nav.getNext();
				if (ent.isCategory()) {
					if (group != null) {
						SelectItem[] theList = items.toArray(new SelectItem[items.size()]);
					group = new SelectItemGroup(ent.getColumnValues().elementAt(0).toString().trim());
					items = new ArrayList<SelectItem>();
				} else if (ent.isDocument()) {
					doc = ent.getDocument();
					items.add(new SelectItem(doc.getUniversalID(), ent.getColumnValues().elementAt(1).toString().trim()));
				ent = tmp;
                        // finally place into last category
			SelectItem[] theList = items.toArray(new SelectItem[items.size()]);
		} catch (NotesException e) {
		return list;

This is the formula for your combox values:

var controlHelper = new com.olb.ControlHelper();
return controlHelper.getOptions();


define the class as managed bean, define a private field for the List and access it via EL:



Tagged with java combobox xpages