Notes/Domino XPages Development Forum - Application Layout Extension Library control

This forum is closed to new posts and responses. Individual names altered for privacy purposes. The information contained in this website is provided for informational purposes only and should not be construed as a forum for customer support requests. Any customer support requests should be directed to the official HCL customer support channels below:

HCL Software Customer Support Portal for U.S. Federal Government clients
HCL Software Customer Support Portal

~Kirk Cisponegenetsi

Aug 14, 2012, 2:24 PM

22 Posts

Resolved

Application Layout Extension Library control

Category: Extension Library
Platform: Windows
Release: 8.5.3
Role: Developer,Administrator
Tags: Application Layout CC
Replies: 3

I am quite new to XPages and, unfortunately, only do XPages development every 2 months - this leaves me always starting from scratch :o(

Anyway, I would like to use the extlib to quickly create a new application - it is not much at present - I have installed all the bits an pieces needed and the example xPagesExt.nsf work perfectly. I have spent the whole day today trying to get my very simple application using the Application Layout Custom Control to work - I have looked at a couple of videos on youtube (this one for example: http://www-10.lotus.com/ldd/ddwiki.nsf/dx/Demo_XPages_Extension_Library-Application_Layout__Page_Navigator_Controls) but they are either quite old or do not explain the creation in enough detail.

I have 2 custom controls (one for the application layout and one for the menu using a navigator) - ccLayout and ccMenu. ccMenu is embedded in ccLayout. I now want to use ccLayout on a couple of xPages. When testing the xPages I do not get the navigator / menu at all.

Are there any step-by-step examples of using the CURRENT extlib to create a simple application?

Here are the three elements as I currently have them:

ccLayout:

<?xml version="1.0" encoding="UTF-8"?>

<xp:view xmlns:xp="http://www.ibm.com/xsp/core" xmlns:xe="http://www.ibm.com/xsp/coreex"

xmlns:xc="http://www.ibm.com/xsp/custom">

<xe:applicationLayout id="applicationLayout1">

<xe:this.facets>

<xp:panel xp:key="LeftColumn">

<xc:ccMenu></xc:ccMenu>

<xp:callback facetName="LeftColumn" id="callback1"></xp:callback>

</xp:panel>

</xe:this.facets>

<xe:this.configuration>

<xe:oneuiApplication titleBarName="#{javascript:database.getTitle()}"

legalText="(c) Erne fittings GmbH" legalLogoStyle="text-align:right">

<xe:this.footerLinks>

<xe:basicContainerNode label="Container 1">

<xe:this.children>

<xe:basicLeafNode label="Homepage"

href="http://www.xxx.com" />

<xe:basicLeafNode href="https://webmail.xxx.com"

label="Webmail" />

</xe:this.children>

</xe:basicContainerNode>

</xe:this.footerLinks>

<xe:this.searchBar>

<xe:appSearchBar pageName="/main.xsp" />

</xe:this.searchBar>

</xe:oneuiApplication>

</xe:this.configuration>

<xp:callback id="OneUIMainAreaCallback" />

</xe:applicationLayout>

</xp:view>

now ccMenu:

<?xml version="1.0" encoding="UTF-8"?>

<xp:view xmlns:xp="http://www.ibm.com/xsp/core" xmlns:xe="http://www.ibm.com/xsp/coreex">

<xe:navigator id="navigator1">

<xe:this.treeNodes>

<xe:pageTreeNode label="Home" page="/xpMain.xsp"></xe:pageTreeNode>

<xe:separatorTreeNode></xe:separatorTreeNode>

<xe:pageTreeNode label="nach Datum" page="/xpNachDatum.xsp"></xe:pageTreeNode>

<xe:pageTreeNode label="nach Titel" page="/xpNachTitel.xsp"></xe:pageTreeNode>

</xe:this.treeNodes>

</xe:navigator>

</xp:view>

and finally one xPage where I would like to use ccLayout:

<?xml version="1.0" encoding="UTF-8"?>

<xp:view xmlns:xp="http://www.ibm.com/xsp/core" xmlns:xc="http://www.ibm.com/xsp/custom">

<xc:ccLayout></xc:ccLayout>

</xp:view>

Does anybody know what I have done incorrectly? I cannot seem to find anything!

Thank you in advance

Ursus

~Karl Kigerosterikle

Aug 14, 2012, 3:36 PM

122 Posts

Re: Application Layout Extension Library control

It looks like you're using the Custom Controls rather than the Application Layout control from the Extension Library. The Application Layout control is used in the TeamRoom, Discussion, and Extension Library demo databases available with the Extension Library. Those give examples.

For a "how to" guide on the Application Layout control, hopefully the best reference guide is the XPages Extension Library book - that's why myself and a number of others took the time to write it. Obviously because that chapter covers 20 pages, it's too big to cover here.

If you're new to XPages and do not have it already, the Mastering XPages book is also worth getting. The XPages Extension Library book expects an understanding of XPages programming techniques covered in the Mastering XPages book.

There is also a NotesIn9 video on the Application Layout control, but I don't think this goes into as much depth as the chapter in the book. http://notesin9.com/index.php/2012/01/31/notesin9-042-xpages-and-application-layout-control/

~Cheryl Elhipigenlen

Aug 15, 2012, 5:30 PM

366 Posts

Re: Application Layout Extension Library control

Make sure that in the application properties that you are using the oneuiv2 or oneuiv2.1 theme. If this theme is not set on the application the navigator will not be displayed.

~Kirk Cisponegenetsi

Aug 16, 2012, 7:00 AM

22 Posts

Re: Application Layout Extension Library control

Thank you both for taking the time to answer my questions.

It seems as if there was just some sort of problem with either my client or the fact that I worked on the Custom Controls for so long that I broke something. I deleted my workspace, bookmark.nsf, desktop8 and cache.ndk. I then deleted all my XPages and my custom controls. Finally I recreated the XPages and custom controls (the only difference was that I used different names so as to be sure that there was no caching going on on the server) and, low and behold, everything now works! Go figure!

Paul S. Withers: I have the Mastering XPages and the companion XPages Portable Command Guide book - I'll get a copy of the XPages Extension Library ASAP. I checked the link to NotesIn9 and must say that helped quite a lot.

Paul Calhoun: I have oneuiv2 setup in the properties - I also ticked the extlib in the Library section and set the "Minimum Supported Release" to 8.5.3.

Thank you both again for taking the time to anwer my question - sorry I only got back to you today but yesterday was a public holiday here in Austria :o)