Full Posts from Articles Thu, 7 May 2009 10:06:20 -0400 http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-CstomControls-TipDomino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-CstomControls-Tiphttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-CstomControls-TipWhen building Custom Controls for XPages, the ultimate goal is to make the Custom Control plug-n-play.  You want to be able to drop the custom control on any XPage and have it interact with the XPage seamlessly.

Being a Design Partner, I have been working with XPages since the pre-beta versions.  Prior to that I was Design Partner for the Lotus Component Designer.  So to come across a new feature is exciting....  

I recently wanted to make a custom control completely independent of the XPage it was on (see this custom control).  Yet I still needed to grab some values from the datasource for the XPage the control is placed on.  The issue is that the XPage datasource name is set by the developer and I could not see a way to determine the datasource name without requiring the end developer to place additional code on their XPage to support my custom control.

Looking through the Request Scope variables on the page at runtime, I found that there is a variable present on every XPage called currentDocument.  Sure enough, it was of NotesXSPDocument type and was set to the current document for the XPage.  So I could now have access to any data on the document I needed without knowing the datasource name.  

For example, if I wanted to find out what the Form name for the document opened in the XPage that my custom control was on, I could use the following code:
theForm=currentDocument.getForm();

or to get the backend NotesDocument and determine the Document unique ID:

doc=currentDocument.getDocument();
docUNID=doc.getUniversalID();

I checked with the XPages Chief Architect, Phil Riand, and this object will be supported in future releases and will be documented.  So it is safe to use this feature in your applications.

Enjoy....

-John
]]>Thu, 7 May 2009 10:06:20 -04005http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=010C184758D07B48882575AF004D7DABhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=010C184758D07B48882575AF004D7DABhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-MultiFile-Download-ControlDomino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-MultiFile-Download-Controlhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-MultiFile-Download-ControlI updated my sample Multi Attachment custom control to now accept configuration parameters so it is easier to reuse the control in different applications.  The updated application can be downloaded from OpenNTF.org by clicking here.  

I decided to make the control easy to drag and drop onto any XPage after speaking with Niklas Heidloff from IBM.  He was filling me in on all the changes coming soon to OpenNTF.org and I felt it was important to contribute to the efforts that are underway.  

About the Multi Attachment Custom Control
This custom control uses a central attachment repository db for all the attachments for your application.  It allows the user to add as many attachments to a document as they want by clicking the "Add New Upload" button .  Each attachment is a separate document in the attachment repository and is linked back to the document using the document's universalID.  The custom control uses a repeat control to repeat a description and download control for each attachment.

The parameters I added allow you to specify the location and name of the repository database as well as control the various features of the file download control.  The repository contains a single view and form.  You can place that view and form into any database to create the repository.

Here's a screen shot of the custom control being used on an XPage that tracks Project information:



Here's a screen shot showing the parameters:



Descriptions of the available parameters

Parameter	Description	Type
fileUploadDbName	The db name that will store the attachments.  Include the full path from the Notes data directory.	string
hideIfNoAttachments	Controls the visibility of the download control if there are no attachments	boolean
showCreatedDate	Controls the visibility of the column for Creation date	boolean
showModifiedDate	Controls the visibility of the column for Modified date	boolean
showSize	Controls the visibility of the column for Attachment size	boolean
showType	Controls the visibility of the column for Attachment tyope	boolean

You can download the control here: http://www.openntf.org/Projects/pmt.nsf/ProjectLookup/XPages%20Multi%20Attachment%20Custom%20Control.

You can read more about how the control was built by clicking here: http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7G3GF7

Please feel free to contact me if you have any issues or questions.....

-John
]]>Wed, 6 May 2009 09:10:52 -04004http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=A5F0C26E039884D3852575AE004867FAhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=A5F0C26E039884D3852575AE004867FAhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-File-Download-ControlDomino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-File-Download-Controlhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-File-Download-ControlMany people have been asking for my help with a problem with the 8.5 Discussion template's File Download control.  The reason is that I have an example of a Custom Control for storing file attachments in a central database which uses the File Download control and has the same issue.

The issue with the File Download control in XPages is that it does not launch Microsoft attachments properly when using Internet Explorer.  The secondary issue is that it throws an exception if your database is in a subdirectory.  You can read the details here in the 8.5 Discussion forum.  

Last week Irina Kojevnikova posted a solution to the problem.  Her solution overrides the File Download control's HREF for each attachment.  

Here is a description of the solution:

On the All Properties tab for the File Download control, there is a property fileNameHrefValue which is computable.




The JavaScript for the value computes the url for each attachment by referencing the current row using the data->var property value rowData.  As the control loops through the attachments, we can get the name of each attachment by using rowData.getName(). Now we can use the filename to build a new url for each attachment.




The data var property is set on the All properties tab under the data section.


The end result is a url similar to: http://localhost/TestDiscussion.nsf/0/A8364817576EF43F852575A30043E76D/%24FILE/JohnExcel.xls

One issue I could not completely resolve was that if the user attaches files and the document has not been saved yet, the new url will not work since it is using the universalID.  Most likely the person that uploads a file will not try and launch it immediately, though they might want to delete it.  So I replaced the href with "#" if it is a new document so there will not be an error message if the user clicks on the file...it will do nothing.  If anyone has a suggestion on a different approach, please let me know.

I updated the discussion8.ntf template with the fix and you can download that here: discussion8.ntf.  You will need to sign the database with a production id for use on your server, or sign the 3 custom controls I updated: mainTopic, response, and viewTopic.  I also updated my Custom Control for storing file attachments in a central database with the fix.

Thank you to Irina for putting together a solution!  Also, a special thanks to Richard Cotrim who spent some time this weekend testing the solution.

-John ]]>Tue, 28 Apr 2009 10:49:36 -04002http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=6751142C3D5DE802882575A600516231http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=6751142C3D5DE802882575A600516231http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Extend-Dojo-EditorDomino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Extend-Dojo-Editorhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Extend-Dojo-EditorA number of folks, including myself, have been looking to extend the XPages/Domino 8.5 Dojo Rich Text Editor toolbar.  The Dojo Editor toolbar usually has other features available such as the create link or insert image.  The issue in adding the additional plugins is that Domino 8.5 has it's own flavor of the Dojo Editor.

Steve Leland has just published a Wiki article describing how to extend the "ibm.domino.widget.layout.DominoRichText class" to add in some additional features to the toolbar.  

He points out that the plugins for the following are shipped with Designer and Domino Server but are not implemented:

• formatBlock - assigns css defined formats
• createLink - constructs an anchor tag with a user supplied URL
• insertImage - constructs an image tag with a user supplied URL

In this article Steve show's how to extend the Editor for both XPages and the Domino classic web server.  

Here's a snippet from the article describing how to extend the toolbar for XPages:

XPages
Let's create a JavaScript class in data\domino\js\dojo-1.1.1\test\widget\layout\TestRichText.js to encapsulate the LinkDialog dependency - using the dojo.require() statement.   Here's the file contents:
/* ******************************************************************/
/*                                                                                                                      */
/* Sample Rich Text Toolbar extension                                                                      */
/*                                                                        &a mp;am p;nbs p;                                             */
/* ******************************************************************/
dojo.provide("test.widget.layout.TestRichText");

dojo.require("ibm.domino.widget.layout.DominoRichText");
dojo.require("dijit._editor.plugins.LinkDialog");
dojo.declare("test.widget.layout.TestRichText", ibm.domino.widget.layout.DominoRichText, {
    constructor: function() {
        if(dojo.isArray(this.extraPlugins)) {
            this.extraPlugins.push("|", "formatBlock", "createLink","insertImage", "|");
        } else {
            this.extraPlugins = [ "formatBlock", "createLink", "insertImage","|" ];
        }
    }//,
}
);

Save that to the TestRichText.js file.

Now we need to have the XPage which uses our rich text control instruct Dojo runtime to load our class into the browser - with a dojo.requires('test.widget.layout.TestRichText') statement.  This is done using our XPage's Properties tab, and selecting 'All Properties'.  We are interested in the 'resources' property - clicking on the plus image lets us identify our resource as a Dojo Module, and we give it our class as a value:



Then we need to put a rich text control on our XPage, exactly as if it were an ordinary rich text control, and on its Properties tab, select 'All Properties' and set the dojoType with a value of our class:


Here is the link to the full article: http://www-10.lotus.com/ldd/ddwiki.nsf/dx/04022009010354PMWEBMZZ.htm

Nice work Steve!

-John ]]>Mon, 6 Apr 2009 10:04:26 -04001http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=C89E7FC716C5F51085257590004D4F9Chttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=C89E7FC716C5F51085257590004D4F9Chttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7Q7KT7Domino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7Q7KT7http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7Q7KT7The folks over at TLCC, The Learning Continuum Company,  have just released two new distance learning courses.  They are:

• Notes and Domino 8.5 Application Development Update
• Notes Domino 8.5 System Administration Update

In addition, there will be a full XPages course available in April.

I have had the opportunity to review the 8.5 application development update course.  It's packed with content, demonstrations, and hands on examples covering all the new features of Domino Designer on Eclipse.  This includes XPages, DOJO rich text editor, and the use of CSS and Themes, the new Java and LotusScript programming interfaces, as well as what's new in Composite Applications.

The 8.5 system administration update course covers the Domino Configuration Tuner, Domino Attachment and Object Services (DAOS), Dynamic Policies, and the new ID Vault....to name a few of the topics.

If you want to update your skills, or are looking to take your certification update exams, #951 or #956, then take a look at the the TLCC site for more details and cost info: http://www.tlcc.com/admin/tlccsite.nsf/pages/dom85courses

-John
]]>Mon, 16 Mar 2009 11:10:36 -04001http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=21F4D101305C62ED8825757B00535EFBhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=21F4D101305C62ED8825757B00535EFBhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-RDB-IntegrationDomino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-RDB-Integrationhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-RDB-IntegrationJo Grant and Craig Wolpert from the IBM ISV Development Enablement team, have published a new Wiki article titled Using XPages to Integrate Between Notes Applications with Relational Databases.  These guys are on a roll over there and have produced 10 great Wiki examples over the last 2 weeks.  (I believe they have secretively developed an XPage vitamin they are taking that allows them to work around the clock....but I can't prove it...)

In this example they show how you can use connectivity to a MySQL database to:

1 - Create a Repeat based view of our data
2 - Create a form to view a single record
3 - Use that form to update the data

Here's a snippet from the article:

You can easily direct XPage elements to surface data from different Notes applications. It turns out not to be much harder to surface data from different back end data sources with XPages.
The key to integrating different data technologies is by binding them together with Javascript. Almost any XPage control that surfaces data has the option to surface that data from a Javascript source. So any data repository you can get to from Javascript can be used by XPages.

Relational databases (RDB) are a very widely used technology for storing data. Many relational databases are accessible through Java Database Connectivity (JDBC). And this Java interface can be called from Javascript. This is our key to surfacing RDB data in an XPage. For our example here we will show connectivity to the MySQL relational database.

Here's a link to the article: http://www-10.lotus.com/ldd/ddwiki.nsf/dx/xpage_integration_rdb.htm

Great article and nice work guys!

John ]]>Mon, 2 Mar 2009 18:15:21 -04000http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=F7C41DBD0A8C07C08525756D007FBF75http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=F7C41DBD0A8C07C08525756D007FBF75http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Lead-Mgr-SampleDomino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Lead-Mgr-Samplehttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Lead-Mgr-SampleThere was a new article posted today in the Lotus Domino Designer Wiki titled Lead Manager XPage Sample Overview authored by Jo Grant and Craig Wolpert.  The corresponding sample application is distributed on OpenNTF.org.

This application is a great way to learn XPages. It's an example of taking a Notes client application and providing a modern web interface by using XPages.  The application itself consists of 4 databases.

Here is a screen shot of the 4 databases in the Notes client:



And here is a screen shot of the application with the new XPage design:


The full link to the article: http://www-10.lotus.com/ldd/ddwiki.nsf/dx/lead_manager_x_overview.htm

and the sample download can be found here: http://www.openntf.org/Projects/pmt.nsf/ProjectLookup/Lead%20Manager%20X

John ]]>Mon, 23 Feb 2009 12:10:45 -04001http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=C603A30FC22B652B85257566005E5E5Ehttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=C603A30FC22B652B85257566005E5E5Ehttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Wiki-Bus-LogicDomino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Wiki-Bus-Logichttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/XPages-Wiki-Bus-LogicThere is a really interesting series of articles posted today over in the Lotus Designer Wiki.  The 4 articles were published today by Jo Grant and Craig Wolpert from IBM.

The series is titled:  Using existing business logic in an Xpage.  It discusses how you can use your existing business logic that is in Lotusscript, Java, or Web Services from within your new XPage applications.  I've heard many people ask questions and voice concerns around this topic, so I think this series will be a great help to those folks who want to go forward with XPages without having to rewrite lots of code for their applications.

The 1st article is an overview containing links to the other 3 articles.  Here's the direct link:
- http://www-10.lotus.com/ldd/ddwiki.nsf/dx/reuse_business_logic_xpage.htm

Thanks Jo and Craig for your hard work....I look forward to reading the series and working with the techniques this weekend!

John ]]>Fri, 20 Feb 2009 16:29:21 -04000http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=C4AC4BB3C9F83E0B8525756300760B6Bhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=C4AC4BB3C9F83E0B8525756300760B6Bhttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7NYQW8Domino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7NYQW8http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7NYQW8Paul Hannan's and Azadeh Salehi's Lotsuphere SHOW106 presentation and example downloads were posted to the Lotus Designer Wiki today.   Here's the description:


Using Lotus Domino Designer 8.5, we will create a Lotus Domino XPage web application that utilizes advanced Web 2.0 technology, and explain what we are doing it along the way.  This step by step demonstration will highlight many of the application development improvements for Lotus Domino 8.5.  See how you can develop with Domino Designer and XPages.  We will explore AJAX, Script Libraries, DoJo and custom controls.

Download SHOW106_Updated20090203.pdf  (or for a faster download that this zip file) to get started. This is a 172 page presentation that is a step-by-step guide on how to build this cool application with XPages. It demonstrates in three parts how you can rapidly put this application together. The application (see screenshot) itself is a profiles type application similar in many ways to a contacts list. It'll allow the user to create a new profile document, search for existing profiles aided by Ajax type ahead and view filtering, add 'friends' to their own profile, as well as many other features.


Looks like a great XPage tutorial.  The url to the article is: http://www-10.lotus.com/ldd/ddwiki.nsf/dx/LS09_SHOW106.htm

John ]]>Thu, 5 Feb 2009 14:31:30 -04000http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=DB67DD3176B2A75985257554006B4135http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=DB67DD3176B2A75985257554006B4135http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7NUMR9Domino 8.5groupwareinchttp://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7NUMR9http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/d6plinks/GROC-7NUMR9Most of my XPage examples that are posted on my site were created with the 8.5 Beta 1 or Beta 2 releases.  I found out recently that some folks were having problems running the examples on 8.5 Gold.  The solution for most of the issues was to recompile the application within the 8.5 Gold designer.  To do this, you can "Clean" the project from the Project menu:

- From the Project menu select Clean:


- You will then will be prompted to select the projects you want to Clean:


That's it.  The Project  is now recompiled.

I did find a couple of issues where I addressed the results of an @DbLookup() directly as an array.  For example:
docID=@DbLookup(@DbName(),"vCustomers",customerName,5);

I accessed docID[0] for the first element.  The @DbLookup() function has changed in the Gold release.  If multiple results are returned from an @DbLookup, an array is returned.  If a single result is returned the result is the type, such as "string". So if you expect only 1 matching document, then the result would be "docID" instead of "docID[0]".

All the samples have been updated now, so if you have had any issues with any example from my site since the Gold release, please download a new copy.

John
]]>Sun, 1 Feb 2009 11:49:56 -04004http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/CommentsRSS?Open&id=A5FB8301674A628885257550005C7696http://www.jmackey.net/groupwareinc/johnblog/johnblog.nsf/PostComment?RunAgent&id=A5FB8301674A628885257550005C7696