I'm not endorsing mixing beer and work with this post, not unless you work in a brewery (that and working in a chocolate factory would be my ideal jobs ;-). What I'd like to do is point you to a nice little XPages App posted last week by Paul Calhoun where he invites you to state what are your favourite 'Pubs of the World'. It's all purely for science - Paul is looking for sample data - so a good cause.

Go there and select the 'Add a Pub' button. This brings you into a new document to record a favourite Pub. And in here there is a nice XPages feature demonstrated - see the 'Available Beers' editbox. This is a multiple value editbox with Ajax typeahead.

You enter an available beer as suggested by the typeahead, add a comma as a separator, and then add another beer, and so on. Multiple values in an editbox. Simple stuff and it works well. It saves you from having to add a monster listbox in your UI where you would have to do what seems like endless scrolling just to find the items you wish to enter. And though Paul doesn't have this in his example, you can use the editbox to enter new values which are not on the list.

Here's what the above example might look like in XPages source...

    <xp:inputText id="inputText1" value="#{requestScope.r01}"
        multipleSeparator="," multipleTrim="true">
        <xp:typeAhead mode="full" minChars="1" ignoreCase="true"
            valueListSeparator=",">
            <xp:this.valueList><![CDATA[#{javascript:@Unique(@DbColumn(@DbName(),"xspFiltersView",1))}]]></xp:this.valueList>
        </xp:typeAhead>
    </xp:inputText>

All this should work fine and we've fixed a couple of issues in the multipleSeparator area in 852 namely the bug with multiple date and numeric values (EGLN7YMLYD) for example, though there are a few gotchas here to be aware of when using multi value editboxes.

Using convertors and validators can cause problems with multiple value editboxes.
When you set the editbox to display as a Number you are adding a number convertor to that field. This is fine but you may run into problems if the thousandth separator on the number is the same as the multipleSeparator - entering 2 values, for example '123' and '54321', could become 3 values, '123', '54', and '321', when the updates are made to the document. To workaround this, we set 'groupingUsed' to false - this stops the inclusion of the thousandth separator.

Another issue you might hit is if you have a validator on the editbox (who doesn't have validators on validators on editboxes) and you're entering the items using the typeahead only. Here you may see that the validation gets fired even though you have values already on the editbox (PHAN88ME87), that is if you've set the editbox as a require field for example. Here the workaround is to manually remove the trailing separator that was included by the typeahead. This is something we're looking to address in 853. You won't come across this problem if you enter a new value at the end of the list of items.

Given these drawbacks, multiple value editboxes are still a very useful feature. One that will becomes even handier when you bolt on Ajax typeahead, especially when you want to write up what is your favourite pub.

Hope this helps.

p.



Recent Blog Posts
78	Chris Toohey: Video - XPage Custom Controls for IBM Lotus Notes and Domino Sun, Jun 12th 2011 10:40p   Bruce Elgort [read] Keywords: domino ibm lotus notes
75	Tim Tripcony: What the heck is a bean? Sun, Jun 12th 2011 10:31p   Bruce Elgort For those of you who are wondering about what the heck managed beans are and how they related to all things XPages I highly recommend reading Tim Tripcony's blog entry entitled "What the Heck is a Bean" which he orginally posted on May 5, 2011. Also, the Mastering XPages book does a good job of explaining managed beans. I am very thankful for both Tim's article and the Mastering XPages book as both of these resources helped me out today preparing some material for my "Social Business Toolki [read] Keywords: xpages
58	Students using XPages video and more... Thu, Jun 9th 2011 9:59a   Bruce Elgort In the Fall of 2010 students in the ICT Technology cirriculum at ROC Mandriaan have developed a real-world relationship management system XPages application for the Round Texel Regatta with mentoring from "Lotus Loves People". Here is a video of the students talking about the app (English subtitles are supplied): Here is a copy of the slide deck showing the app that they build: XPages Project Mondriaan ROC View more presentations from Rob Bontekoe And also a blog entry by Rob Bontekoe. T [read] Keywords: ibm lotus xpages application google twitter
81	Steve Castledine: XPages Layout Framework Template (OneUI) Video Tue, Jun 7th 2011 4:08p   Bruce Elgort Steve Castledine demonstrates how to use the XPages Layout Framework Template which is available on OpenNTF.org [read] Keywords: xpages openntf
49	Video: Using the XPages Extension Library Dojo Grid and REST Services Controls Mon, Jun 6th 2011 10:46p   Bruce Elgort [read] Keywords: xpages dojo
30	The MWLUG 2011 XPrize Design Competition Mon, Jun 6th 2011 2:53p   Bruce Elgort Hot off the press: XPages brings Domino Web application development to an entirely a new level. It allows you to modernize your existing Domino applications and provide an incredible user experience and interface. XPages allows you to take advantage of the unique capabilities of the Domino platform and build powerful and dynamic applications that can easily beat out competitive solutions. As part of the Midwest Lotus User Group Conference 2011, MWLUG is sponsoring the MWLUG XPrize Design Compet [read] Keywords: domino lotus xpages application applications development interface
71	[Lotusphere 2011 Rewind] - XPages Extension Library: Making Application Development Even Easier Mon, Jun 6th 2011 8:22a   Bruce Elgort IBM's Paul Hannan and Maire Kehoe presented this excellent session at Lotusphere 2011 on the XPages Extension Library: AD116 XPages Extension Library: Making Application Development Even Easier View more presentations from pdhannan [read] Keywords: ibm lotusphere xpages application development
65	Intec Blog: Maximising the Benefits of XPages in 8.5.2 Whitepaper Sun, Jun 5th 2011 6:17p   Bruce Elgort Premier IBM Business Partner Intec has a fantastic updated whitepaper entitled "Maximising the Benefits of XPages in 8.5.2: Almost a year ago I wrote a whitepaper called "Maximising the Benefits of Lotus Domino 8.5.x with XPages". This was an open discussion of the pros and cons of XPages, based on Domino 8.5.1. I have updated the whitepaper to take into account the significant enhancements in XPages in 8.5.2 and a year's more experience of developing applications in XPages. XPages is stil [read] Keywords: domino ibm lotus xpages application applications
62	Tim Tripcony: Taking Themes to the Next Level Sun, Jun 5th 2011 12:58p   Bruce Elgort If you have not yet looked into the power of using themes in your XPages applications, may I suggest that you download and review a presentation given by Tim Tripcony of GBS at the BLUG and UKLUG conferences entitled "Taking Themes to the Next Level - Getting more out of XPages the easy way". The slide deck covers: What is a Theme? How are Themes typically used? How do Themes actually work? Going beyond the typical to... Keep your XPage markup clean Enhance application performance Maintain [read] Keywords: xpages application applications development
48	Mark Barton: Creating Barcodes with an XPage / Reading them with Flex Sat, Jun 4th 2011 11:26a   Bruce Elgort Mark Barton has a must read blog entry on generating barcodes with XPages: Due to the ability for an XPage to easily leverage Java code it is quite straightforward to integrate an existing Java library, so when the XPage is called a rendered barcode is returned. For this demo I have decided to use a commercial library – the code will operate in a demo mode and is reasonably priced if you decide to buy it. For this demo I am only interested in the Datamatrix barcode so I downloaded th [read] Keywords: xpages java