New version of the XPage Debug Toolbar: includes logging from Java beans
Wed, Feb 15th 2012 5:11a Mark Leusink I just released version 1.2.1. of the XPage Debug Toolbar on OpenNTF. Thanks to a contribution by Keith Strickland you now also have the option to log messages to the toolbar from Java beans (thanks Keith!).
Version 1.2.1 also includes a fix for an incorrect calculation of the refresh interval in the external console window.
Download the latest release now and start logging ! [read] Keywords: xpages bleedyellow
bleedyellow.com
java
openntf
547
Debugging XPages and SSJS just gotten a bit easier
Thu, Jan 12th 2012 5:11a Mark Leusink Since there isn't a way to debug SSJS (yet) I mostly resorted to using the print() statement throughout my code. One big disadvantage of this is that all statements are written to the server console. When developing with a team this can get messy (and won't make your administrators happy), so I looked for a different way to output debug messages. I already use OpenLog to log information to a database, but find it annoying to switch everytime between Designer client, Notes client and browser.
[read] Keywords: notes
notes client
script library
xpages application
bleedyellow
bleedyellow.com
database
openntf
server
194
HTML Mails from XPages - part 2: inline images
Thu, Dec 8th 2011 1:11p Mark Leusink I've updated the HTML mail SSJS library I wrote about yesterday and have added inline images support. This can come in handy when you want to create HTML newsletters.
Marking an image as "inline" can be done by adding an extra parameter to the addDocAttachment() / addFileAttachment() methods:
mail.addDocAttachment( "5203C670815BC8C4C12579270029C543", "header.gif", true );
The addDocAttachment/ addFileAttachment methods now return the Content ID of the image in the message. That ID [read] Keywords: xpages bleedyellow
bleedyellow.com
database
email
438
Send a HTML mail from an XPage with only 5 lines of code
Wed, Dec 7th 2011 5:11a Mark Leusink Sending an e-mail from an XPage (using SSJS) is not too difficult, especially if you've done it before in LotusScript:
var doc:NotesDocument = database.createDocument();
doc.replaceItemValue("form", "Memo");
doc.replaceItemValue("sendTo", "mark@domain.com");
doc.replaceItemValue("subject", "hi there!");
doc.replaceItemValue("body", "content here");
doc.send();
It gets a bit more difficult though if you want to send out HTML mails. To create those you need to work wi [read] Keywords: lotusscript
script library
application
bleedyellow
bleedyellow.com
database
email
server
360
The order of events in XPages
Wed, Nov 23rd 2011 5:12a Mark Leusink After reading another question on the XPages forum about which (serverside) events are triggered if you use the browsers "back" button on on XPage, I decided to run some tests.
First thing I did was to set up a simple test XPage (page1.xsp):
The order of events triggered when opening this XPage is as expected:
beforePageLoad
afterPageLoad
beforeRenderResponse
afterRenderResponse
Not [read] Keywords: ibm
ldd
lotus
xpages javascript
xml
170
Multi-page messages in XPages
Mon, Nov 21st 2011 5:09a Mark Leusink The JSF framework on which XPages are built has built-in functions to display messages to users. You can see this in use if you add a validator to a field and disable clientside validation in the application properties: if the validation fails, a message is added to the FacesContext object that can be displayed on screen by including a Display Errors () control.
It is also possible to add your own custom messages by using the facesContext.addMessage() method. This was described by Tommy Valand [read] Keywords: xpages application
bleedyellow
bleedyellow.com
consulting
database
java
properties
xml
XPages: server vs. client-side redirects
Wed, Jul 27th 2011 7:09a Mark Leusink If you want to redirect a user to another XPage you can use the redirectToPage function:
context.redirectToPage( "someXPage.xsp" );
context.redirectToPage( "someXPage" );
You can also add parameters to this call if you need to:
context.redirectToPage( "someXPage.xsp?action=openDocument" );
context.redirectToPage( "someXPage?action=openDocument" );
If you want to redirect the user to another site, you can use the redirect method:
facesContext.getExternalContext().redirect(" [read] Keywords: xpages server
233
Forget about the time when comparing dates in SSJS
Mon, Jun 20th 2011 6:13a Mark Leusink I needed to compare two dates in SSJS and determine if a date was on or before tomorrow. Sounds pretty easy but it took me a while to figure this out. The hard part was that I needed to remove the time part, I only wanted to compare the dates.
As always (or most of the times) the solution turned out to be pretty simple and involved using the @Date() function. So if you ever need to do the same, just use the following (note that all dates are java.util.Date instances, not NotesDateTime objects) [read] Keywords: xpages java
javascript
125
Error while using sessionAsSigner calls
Fri, May 27th 2011 6:09a Mark Leusink Yesterday, apparently for no reason, I started getting all errors in my XPage application. Investigating it more I found out that the root cause was a problem with the sessionAsSigner function. The error I was getting was:
'sessionAsSigner' not found
So I started thinking what changed in the last week and might have caused this error. I made no configuration changes and performed no updates. The only thing I changed was that I started using the server with another user ID. I looked i [read] Keywords: application
bleedyellow
bleedyellow.com
database
security
server
twitter
397
Getting SVN to work in Domino Designer 8.5.2
Tue, Apr 12th 2011 6:12a Mark Leusink As you might (or might not) know, I'm working together with Patrick Kwinten on Bildr. In the past we've exchanged NSF files containing changes we both made to the application. I was looking for an easier way to do this and thought about using a shared Domino server, when I read about the Source Control Enablement project on OpenNTF. The plugin adds SVN support to the Designer client. I've used version control using Subversion in the past and know it's a great option when working with multipl [read] Keywords: domino
ibm
application
eclipse
google
openntf
server
253
Using scheduled XPages
Thu, Feb 24th 2011 5:11a Mark Leusink When building a new XPage application from the ground up you store your code in script libraries and Java classes. You can also use XPages in "agent-style" that don't render anything. But then you require scheduled agents and come to the conclusion that you can't include any of the code you've already written in your scheduled agent or schedule an XPage. Unless... you use a scheduled agent to trigger the XPage. Here's how to do so.
Create a scheduled Java agent.
Set the runtime securit [read] Keywords: admin
agent
domino
ibm
ldd
lotus
xpages application
database
java
password
security
server
110
Quick tip: setting the alt and title attributes in an XPage Image control
Wed, Feb 23rd 2011 5:09a Mark Leusink If you set the "alternate text" property on an XPage Image control, a tooltip is shown in Internet Explorer when you hover your mouse pointer over the image. In Firefox however, nothing is shown. The cause of this is that setting the "alternate text" renders as the "alt" attribute which is only rendered as a tooltip in Internet Explorer. To show a tooltip in FireFox, you need to set the "title" attribute.
I'm not going to discuss what the correct browser behavior should be: that has be [read] Keywords: xpages firefox
google
properties
131
Disable automatic scrolling in an XPage
Wed, Feb 9th 2011 5:14a Mark Leusink Suppose you've created an XPage with a form on it. You've added a nice Save-button on the bottom and have included some server-side validation functions. The validation errors (if any) are shown at the top of the form using a "Display Errors" control.
On pressing that Save-button, the XPage automatically collects the position of the button and sends it along with the rest of the form to the server. This is done by the following row in xspClientDojo.js (called in the _doFireEvent function) [read] Keywords: xpages javascript
server
220
XPage vs form security: create-only access
Mon, Feb 7th 2011 6:12a Mark Leusink If I wanted to control who could create a document with a form I would add a role to the database's ACL (lets assume it's called [docCreator] ) and set the form property "Who can create documents with this form" to that role. Note that this doesn't control who can edit the document created with it or read a document using the form: that's controlled by the readers/authors field(s) on the document.
This form property doesn't have any effect on an XPage that uses that form as a data sour [read] Keywords: acl
xpages bleedyellow
bleedyellow.com
database
security
wiki
42
Bildr: getting better with every release (check out the new uploader!)
Wed, Dec 8th 2010 5:13a Mark Leusink div style=margin-top: 15px;
After reading his a href=http://www.openntf.org/Internal/home.nsf/helpwantedList.xsp target=_blankrequest for help/a on OpenNTF I teamed up with a href=http://quintessens.wordpress.com target=_blankPatrick Kwinten/a to help him in enhancing Bildr. One of the major improvements Ive worked on is implementing a web based uploader for images. Bildr 3, which includes the web uploader, was a href=http://quintessens.wordpress.com/2010/12/03/released-bildr-3-0/#comments targe [read] Keywords: agent
notes
notes client
xpages bug
css
dojo
firefox
google
java
javascript
openntf
server
111
Add some animation to your XPage sections
Fri, Nov 19th 2010 8:13a Mark Leusink style type=text/css
div.ml {
margin-top:15px;
margin-bottom:15px;
}
div.mlCode {
background: none repeat scroll 0% 0% rgb(255, 255, 198);
font-family: courier; font-size: 12px;
padding: 10px; margin: 15px; border: 1px solid silver; white-space:pre;
}
/style
div class=mlXPage sections (lt;xp:sectiongt;) are shown/ hidden by default using no animation at all. Personally I think that adding a wipe in/ wipe out effect looks much better. Try it on the sections next to this article./div
divAdding [read] Keywords: css
dojo
52
XPages: Multiple file upload custom control - documentation updated
Wed, Nov 10th 2010 8:17a Mark Leusink div style=margin-top: 15px; margin-bottom: 15px;I recently wrote an a href=http://www.bleedyellow.com/blogs/m.leusink/entry/xpages_multiple_file_upload_custom_control?lang=en target=_blankentry/a about the XPage Custom Control version of my file uploader and made a promise to update the documentation. I finally got around to doing it yesterday evening and have included a section on how to reuse the file uploader custom control in your own applications. It can be downloaded a href=http://www.blee [read] Keywords: xpages applications
bleedyellow
bleedyellow.com
openntf
223
XPages: Multiple file upload custom control
Wed, Nov 3rd 2010 9:27a Mark Leusink div style=margin-top: 15px;About two months ago I wrote a demo application for a a href=http://www.bleedyellow.com/blogs/m.leusink/entry/multiple_file_uploads_using_a_flash_component1?lang=en target=_blankmultiple file uploader/a. It allows you to do file uploads to a Domino server in a much more user friendly way than with the default browser controls. The uploads are done using an (open source) Flash component called a href=http://code.google.com/p/swfupload target=_blankSWFUpload/a. The demo [read] Keywords: domino
xpages ajax
application
bleedyellow
bleedyellow.com
css
google
javascript
server
432
XPages: Multiple file uploads using HTML5 with drag-n-drop and progress bar support
Wed, Nov 3rd 2010 9:27a Mark Leusink div style=margin-top: 15px;Using HTML5 it is possible to upload multiple files and use drag-n-drop in a browser natively. It also allows you to drag files from your computer into your browser. a href=http://www.plupload.com/ target=_blankPlupload/a is an open source upload handler that includes a number of different runtimes to do file uploads, including a HTML5 based uploader. The HTML5 based uploader includes drag-n-drop support. With the knowledge of my XPages based file upload custom control [read] Keywords: xpages application
bleedyellow
bleedyellow.com
firefox
google
201
Processing files uploaded to an XPage
Sun, Oct 24th 2010 4:34p Mark Leusink div style=margin-top: 15px;Recently I read a very interesting a href=http://www.bleedyellow.com/blogs/andyc/entry/intercepting_a_file_upload4?lang=en target=_blankblog entry/a from Andy Cunliffe. He discovered a way to get a handle on uploaded files to an XPage. Just like him I also discovered that parsing files from the HttpServletRequest.getInputStream() using Apache Commons didnt work, but he kept digging deaper. Based on his find I also experimented some more and completed a code example. Th [read] Keywords: domino
ibm
lotus
notes
rich text
xpages bleedyellow
bleedyellow.com
java
javascript
server
187
Serving binary files through XPages (including a Save As dialog if you want to)
Thu, Oct 21st 2010 4:30a Mark Leusink div style=margin-top: 15px;Ever wanted to track the number of downloads for a file? Log that a specific user has downloaded a file? Or showing users the quot;Save asquot; dialog instead of opening an image or PDF directly in his browser? Heres how to do so using XPages./div
div style=margin-top: 15px;In his article a href=http://www.wissel.net/blog/d6plinks/SHWL-7MGFBN target=_blankquot;Web Agents XPages stylequot;/a, Stephen Wissel describes a method to generate your own output for an XPage. H [read] Keywords: ibm
xpages application
database
java
209
Dojo-style confirm dialogs in Xpages
Wed, Oct 13th 2010 10:27a Mark Leusink div style=margin-top: 15px;The Dojo toolkit doesnt have a widget for confirm dialogs (yet). Since dialogs like this:br /
img src=/blogs/m.leusink/resource/confirm_dialog/confirm.png style=margin: 20px; clear: both; /br /
kind-of stand out in any modern application, Ive created a custom confirm dialog so you can confirm actions a bit more fashionable. It also allows you to style a confirm action the way you want to:br /
img src=/blogs/m.leusink/resource/confirm_dialog/confirm-dojo.png style=margi [read] Keywords: xpages application
database
dojo
javascript
widget
Please cache this XPage
Fri, Oct 1st 2010 7:27a Mark Leusink div style=margin-top: 15px;When you use an XPage to completely render your own response as described a href=http://www.wissel.net/blog/d6plinks/SHWL-7MGFBN target=_blankhere/a, you can add a bCache-Control/b header with a bno-cache/b value to prevent the response from being cached. But what if you do want the response to be cached? I needed this to serve a page containing a set of javascript configuration settings that (almost) never change./div
div style=margin-top: 15px;Turns out to be pretty [read] Keywords: application
javascript
oracle
server
88
Debugging client side JavaScript libraries in Xpages
Mon, Sep 27th 2010 5:30a Mark Leusink div style=margin-top: 15pxA number of JavaScript libraries are loaded if you open an XPage. These include the Dojo libraries, but a set of custom libraries as well. More information about these client side libraries can be found in a href=http://www-10.lotus.com/ldd/ddwiki.nsf/page.xsp?documentId=FC629E5603DB150A852574F900569592amp;action=openDocument target=_blankthis/a Domino Designer wiki article./div
div style=margin-top: 15pxBy default the server serves a compressed version of these files [read] Keywords: domino
ibm
ldd
lotus
xpages dojo
firefox
javascript
server
wiki
128
Putting your Xpage to sleep
Thu, Sep 23rd 2010 5:30a Mark Leusink div style=margin-top: 10px;Im currently working on rewriting my a href=../../m.leusink/entry/multiple_file_uploads_using_a_flash_component1?lang=enmultiple-file uploader/a using Xpages/ custom controls. I encountered a problem when embedding the control on an Xpage based form. When the quot;savequot; button on the form is called, the uploads are started but I needed the Xpage to wait until all files had been uploaded./div
div style=margin-top: 10px;My first try was to implement a sleep function [read] Keywords: xpages java
javascript
oracle
294
Xpages: hiding your forms and use of the Display XPage instead option
Fri, Sep 17th 2010 10:02a Mark Leusink div style=margin-top: 15px;If you want your web users to always use an XPage instead of a form, you enable the option quot;Display XPage insteadquot; on the form properties and select the XPage to use when opening documents based on that form. When a user now opens a document from a standard view (e.g. a link like db.nsf/view/key?openDocument), the XPage is shown. It even detects if the user wants to view (?openDocument) or edit (?editDocument) the document.
/div
div style=margin-top: 15px;If y [read] Keywords: acl
domino
notes
notes client
xpages applications
properties
security
306
Xpages: Sort the results of a full-text query (server side and by any column)
Wed, Sep 15th 2010 8:30a Mark Leusink pWhen performing a full text search on a view or database the results are returned by relevance. But relevance isnt always the best way to show the results. You or your users are probably more interested in the order the documents were shown in the view or sorted by some other column./p
pBeing able to resort the search results requires some coding in your XPage. a href=http://www.juliusbuss.de/web/youatnotes/blog-jb.nsf/dx/follow-up-to-sorted-ftsearch-results-in-xpages-with-code.htm?opendocument [read] Keywords: agent
xpages bleedyellow
bleedyellow.com
database
java
javascript
properties
server
152
Multiple-file uploads to Domino (and a progress bar)
Fri, Sep 10th 2010 4:40a Mark Leusink divBeing able to upload multiple-files to a Domino server from a browser in an easy way is a subject that has always interested me, and with me probably lots of others. Since it might be a while until the a href=https://developer.mozilla.org/en/using_files_from_web_applicationsmultiple-files upload/a option in HTML5 is supported in all of my users browsers, I decided to try to implement one of the open source Flash uploaders. The Flash uploaders use a (semi)hidden Flash component that handles th [read] Keywords: domino
notes
ajax
application
bleedyellow
bleedyellow.com
css
database
dojo
javascript
openntf
server
Human Readable Dates in XPages
Thu, Aug 26th 2010 7:43a Mark Leusink divIf I display a date/time in a view I can enable the option quot;show today if appropriatequot;. This will replace todays (or yesterdays) date with the text quot;Todayquot; (or quot;Yesterdayquot;). I wanted to have the same functionality in an Xpage-based application Im creating, but couldnt find the XPage equivalent./divdiv style=margin-top: 10px;After some searching on the web I found an article written by Matt White (a href=http://mattwhite.me/blog/2009/6/28/human-readable-dates-in-xpages. [read] Keywords: script library
xpages application
bleedyellow
bleedyellow.com
javascript
231
Beware of what getColumnValue is returning
Mon, Aug 16th 2010 9:03a Mark Leusink When working with view columns that might contain multiple values, remember that the return value of the getColumnValue(quot;columnquot;) method from the NotesXspViewEntry object is different depending on the number of values in the column of a specific view entry:br /divul style=margin-top:10pxliIf the view entry contains a single value, a bstring/b is returned./liliIf the view entry contains multiple values, it returns a bVector/b. /li/ul/divdiv style=margin-top: 10pxIf you always want to have [read] Keywords: xpages java
172
Using OpenLog for logging/ debugging Xpages
Wed, Aug 11th 2010 10:04a Mark Leusink pIt probably wont make your admins happy if you constantly use print(quot;thisquot;) in you Server-Side Javascript code to print debug or error messages to the servers console. Luckily there is a good alternative: use OpenNTFs a href=http://www.openntf.org/internal/home.nsf/project.xsp?action=openDocumentamp;name=OpenLogOpenLog/a project to log everything to a central database. The only problem is that the database doesnt contain a library for Xpages (yet)./p
pAfter some digging I found out that [read] Keywords: script library
xpages application
database
ideajam
javascript
openntf
server
