Transformations: Smart Application Migration to XPages

Tweet about this event

And mention us: @Teamstudio @TLCCLTD

@zeromancer1972

Apr. 21, 2015

@Teamstudio

teamstudio.com

@TLCCLTD

tlcc.com

Courtney CarterInbound Marketing Specialist

Teamstudio

Who We Are

• Teamstudio’s background is in creating tools for

collaborative computing in mid-size and large

enterprises, primarily for IBM Notes

• Easy-to-use tools for developers and administrators

• 1600+ active customers, 53 countries

• Offices in US, UK, and Japan

• Entered mobile space in 2010 with Unplugged: easy

mobilization of Notes apps to Blackberry, Android

and iOS

Teamstudio Unplugged

• Your mobile Domino server: take your IBM Notes

apps with you!

• End-users access Notes applications from mobile

devices whether online or offline

• Leverages the powerful technology of XPages

Unplugged Templates

• Continuity – Mobile offline access to BCM programs

• OneView Approvals – Expense approvals; anywhere, anytime

• CustomerView – lightweight CRM framework for field sales and field service teams• Contacts – customer information database

• Activities – customer activity log

• Media – mobile offline file storage and access

XControls

• Set of Controls for IBM Domino XPages developers

working on new XPages apps and on app

modernization projects

• Re-write of the Teamstudio Unplugged Controls

project, but adds full support for PC browser-based

user interfaces as well as mobile interfaces

• Enables XPages developers to create controls that

are responsive

• Learn more: teamstudio.com/solutions/xfoundations

Teamstudio Services

• Professional services for modernization, web

enablement, project management, development,

and administrationo Modernization Services

o Unplugged Developer Assistance Program

o Application Upgrade Analysis

o Application Complexity Analysis

o Application Usage Auditing

• http://www.teamstudio.com/solutions/services/

• Teamstudio Blog promotion:

o Subscribe to Teamstudio’s blog before May 31, 2015 and you’ll be automatically

entered to win an iPhone 6!

• DNUG: Jun. 10-11, 2015

o Come see us in Dortmund, Germany

1

#XPages

Your Hosts Today:

Howard GreenbergTLCC

@TLCCLtd

Transformations - Smart Application Migration to XPages

Paul DellaNebbiaTLCC

@PaulDN

How can TLCC Help YOU!

2

• Private classes at your location or virtual

•XPages Development

•Support Existing Apps

•Administration

• Let us help you become an expert XPages developer!

• Delivered via Notes

• XPages

• Development

• Admin

• UserSelf-

Paced Courses

Mentoring

Instructor-Led

Classes

Application Development

and Consulting

Free Demo

Courses!

Try a FREE XPages Course!!!

3

Introduction to XPages Development course

• Three Hour self paced course• Has Demonstrations and Activities• Requires Domino Designer• Both an 8.5 and 9.0 version• Perfect for beginners!

Register at www.tlcc.com/admin/tlccsite.nsf/pages/free+course

Great PriceIt’s FREE!!!

Upcoming and Recorded Webinars

4

• May 14th App.Next - The Future of Domino App. Development

• www.tlcc.com/xpages-webinar

View Previous Webinars(use url above)

New Extension Library Release

• New xe:mapValuePicker and xe:collectionValuePicker tags for the Value Picker Control– There are two new data providers for the Value Picker

• New inPlaceForm Simple Action– allows for displaying or hiding an inPlaceForm control

• New Responsive Web Design Functionality– There are three new controls to be used with the bootstrap theme.

• Carousel Control• Dashboard Control• Navbar Control

– New Application Layout configuration focused on a responsive design• Responsive Design Demonstration Application: ToDo.nsf• New xsp.properties “suppress” option for dataView control• New URL Parameters in the REST Calendar Service

5

Download the Extension Library at OpenNTF.org

Asking Questions – Q and A at the end

6

Use the Orange Arrow button to expand the GoToWebinar panel

Then ask your questions in the Questions pane!

We will answer your questions verbally at the end of the webinar

Your Presenter Today:

7

#XPages

Oliver BusseWe4IT

@zeromancer1972

Transformations

Smart Application Migration

A presentation of Oliver Busse @ Engage.UG in March 2015

Broadcasted in the TLCC & Teamstudio Webinar April 21, 2015

Agenda

•About me

•Overview

•Preamble

•Migrate database and user profiles• Legacy profile documents vs. Java Beans• Value lists made available over the whole application

•User and environment information• What can a user see and use?

•Extending Fulltext search to a facetted search• Filtering your data with meta tags

Oliver Busse

• „Bleeding Yellow“ since 2000• Working for We4IT Group• OpenNTF Board Member• IBM Champion for ICS in 2015• @zeromancer1972• www.oliverbusse.com

www.we4it.com

Overview

•What‘s this?• Transforming & re-using commonly used legacy patterns in

XPages• Don‘t fear Java • Avoid @Formulas in SSJS• Ideas for best practices

•What‘s it not?• An XPages Introduction• A Java beginner‘s guide• A complete application migration strategy

Preamble

•Why not to use SSJS „excessively“?• SSJS is interpreted at runtime• SSJS is compiled at runtime (every time you call it!)• Compiled SSJS is hard to debug while executed

6#engageug

Migrating database and user profiles

What we find in legacy apps: profile documents

Disadvantages• You cannot see them without

using tools• You can edit and create them

only programmatically• Sometimes replication issues• Unwanted Caching ;-)

Advantages• Quick access without using

lookup views• Caching

What we missed in many cases

DatabaseScript != Global Declarations

Encapsuled, no access from outside(except Database Events)

Performance-Killer

Numerous usage of those formulas slow down the app

one of many...

Transformation

Item1=Values1Item2=Values2Item3=Values3

...

NotesDocument

Key1=ValueMap1Key2=ValueMap2Key3=ValueMap3

...

HashMap

NSF-based, view lookup Memory-based, direct access

Ingredients

•Transformation of profile documents to „standard“ documents

1. Create a corresponding lookup view2. Optional: corresponding forms for maintenance3. Create the Java Bean classes4. Define those Bean classes in faces-config.xml

Preparation: Lookup Views

•Key for Database Profiles = dbprofile

•Key for User Profiles = Canonical User Name

•Key for Value Lists = free but unique

Preparation: Java Beans

• 3 Classes:• DatabaseProfileBean• AppConfigBean• UserProfileBean

• The DatabaseProfileBean initializes the document ifit doesn‘t exist

• The UserProfileBean initializes the document whenthe user saves it for the first time

faces-config.xml<faces-config>

<!-- Database Profile Bean --><managed-bean>

<managed-bean-name>dbprofile</managed-bean-name><managed-bean-class>com.icsug.DatabaseProfileBean</managed-bean-class><managed-bean-scope>application</managed-bean-scope>

</managed-bean><!-- User Profile Bean --><managed-bean>

<managed-bean-name>userprofile</managed-bean-name><managed-bean-class>com.icsug.UserProfileBean</managed-bean-class><managed-bean-scope>session</managed-bean-scope>

</managed-bean><!-- Application Configuration --><managed-bean>

<managed-bean-name>application</managed-bean-name><managed-bean-class>com.icsug.AppConfigBean</managed-bean-class><managed-bean-scope>application</managed-bean-scope>

</managed-bean></faces-config>

Digression: Bean Scopes & Lifecycles

•Request• Lives beginning with the request to creation of the response

•View• Within a page until changing the page, even during partial

refreshes

•Session• Per user session

•Application• During the life time of th application (after 30 minutes it is

dropped by default)

DEMO

17#engageug

User and Environment Information

User and Environment Information

Name variations

Access Level

ACL Options notes.ini variables

EnvironmentBean

faces-config.xml: EnvironmentBean

19#engageug

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

<!-- Environment Bean --><managed-bean>

<managed-bean-name>env</managed-bean-name><managed-bean-class>com.icsug.EnvironmentBean</managed-bean-class><managed-bean-scope>view</managed-bean-scope>

</managed-bean>

</faces-config>

Example: Username Variations

<p><xp:label

value="#{javascript:env.userName}"id="label1">

</xp:label></p><p>

<xp:labelvalue="#{javascript:env.commonUserName}"id="label2">

</xp:label></p><p>

<xp:labelvalue="#{javascript:env.abbreviatedUserName}"id="label3">

</xp:label></p>

Example: ACL Options

The delete button is only visible if the user can delete documents

Even in themes!

22#engageug

<themeextends="flatly"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:noNamespaceSchemaLocation="platform:/plugin/com.ibm.designer.domino.style

kits/schema/stylekit.xsd"><!--display a submit type button only if user can create documents via ACL--><control>

<name>Button.Submit</name><property

type="boolean"><name>rendered</name><value>#{env.createDocuments}</value>

</property></control>

</theme>

DEMO

24#engageug

Extending Fulltext-Search to a Facetted Search

Facetted Search

„Faceted search, also called faceted navigation or faceted browsing, is a technique for accessing information organized according to a faceted classification system, allowing users to explore a collection of information by applying multiple filters.“

http://en.wikipedia.org/wiki/Faceted_search

Facetted Search

„Well-known“ Examples

amazing.com cyberharbor

muse

Facetted Search with Domino?

1. Fulltext Search

2. Filtering result from extra meta data

1. Meta data search with facet selection

2. Fulltext Search in results

FacettedSearchBean (Session scoped)

FacetsSearch Term

FacettedSearchBean

DocumentCollection(ArrayList<SearchResultEntry>)

30#engageug

DEMO

Facetted Search: Outlook & Alternatives

•Using OpenNTF API‘s Graph-DB functions

•Using a 3rd party Graph-DB like Apache Solr

31#engageug

Want to get the DEMO?

Grab it from my Bitbucket repo (also contains an NTF):

https://bitbucket.org/zeromancer1972/icsug-2015-demo

It uses the following plugins available on OpenNTF:

XPages Extension Library (9.0.1.07+):

http://extlib.openntf.org/

Bootstrap 4 Xpages:

http://www.openntf.org/main.nsf/project.xsp?r=project/Bootstrap4XPages

OpenNTF Domino API:

http://www.openntf.org/main.nsf/project.xsp?r=project/OpenNTF%20Domino%20API

32#engageug

Other Resources

http://en.wikipedia.org/wiki/Faceted_search

http://lucene.apache.org/solr/

https://www.focul.net/focul-best-practice-faceted-filtering-xpages-using-java-beans/

Questions????

8

Use the Orange Arrow button to expand the GoToWebinar panel

Then ask your questions in the Questions panel!

Remember, we will answer your questions verbally

#XPages

@zeromancer1972

@TLCCLtd

@Teamstudio

@PaulDN

Upcoming Events:MWLug User Group Meeting, Aug. 19-21, Atlanta

Question and Answer Time!

9

Teamstudio Questions?contactus@teamstudio.com

978-712-0924

TLCC Questions?howardg@tlcc.com paul@tlcc.com

888-241-8522 or 561-953-0095

Howard GreenbergPaul Della-Nebbia Courtney CarterOliver Busse