Fix & fertig: Best Practises für "XPages-Migranten"

www.ics.ug #icsug
Fix & fertig:
Best Practises für "XPages-Migranten"
Oliver Busse, 26.03.2015

www.ics.ug #icsug
Oliver Busse
• „Bleeding Yellow“ seit R4.5
• Certified Lotus Instructor seit 2001
• IBM Champion for ICS in 2015
• OpenNTF Contributor &
Board Member
• XPages Advocate
• Framework-süchtig, vor allem
Bootstrap

www.ics.ug #icsug
• Worum geht's?
– Alltags-Anforderungen mit XPages umsetzen
– Keine Angst vor Java mit XPages 
– Vermeidung von @Formeln in SSJS
– Denkanstöße & Best Practises
• Worum geht es nicht?
– XPages Einführung
– Java für Einsteiger
– Komplette Anwendungsmigration
Übersicht

www.ics.ug #icsug
Warum kein ServerSide Javascript?
• SSJS wird zur Laufzeit interpretiert
• SSJS wird zur Laufzeit kompiliert
• SSJS-Kompilat wird ausgeführt, ist aber kaum zu
debuggen

www.ics.ug #icsug
• Datenbank- & Nutzerprofile migrieren
– „Klassische“ Profildokumente vs. Scoped Beans
– Wertelisten immer verfügbar machen
• Nutzer- & Umgebungsinformationen
– was darf und soll der Nutzer sehen & können
• Volltextsuche vs. Facettensuche
– Zusätzliche Datenfilterung mit Tags
Themen

www.ics.ug #icsug
Datenbank- & Nutzerprofile migrieren

www.ics.ug #icsug
Was wir häufig vorfinden: Profildokumente
Nachteile
• Man sieht sie ohne Hilfsmittel
nicht
• Man kann sie nur
programmatisch erzeugen und
bearbeiten
• Zum Teil Probleme mit der
Replikation
• Relativ viel Code nötig, um auf
Daten zuzugreifen
• Caching ;-)
Vorteile
• Schneller Zugriff auch ohne
Ansichten / Lookups
• Caching

www.ics.ug #icsug
Was wir häufig vermisst haben
DatabaseScript != Globale Deklarationen
Leider gekapselt, kein Zugriff von außen
(außer Database Events)

www.ics.ug #icsug
Performance-Killer
Viele dieser Formeln bremsen die Anwendung aus
eines von vielen...

www.ics.ug #icsug
Transformation
Item1=Values1
Item2=Values2
Item3=Values3
...
NotesDocument
Key1=ValueMap1
Key2=ValueMap2
Key3=ValueMap3
...
HashMap
NSF-basiert, Lookup nötig Speicher-basiert, direkter Zugriff

www.ics.ug #icsug
• Umwandlung von Profildokumenten in
„normale“ Dokumente
1. Erzeugen einer entsprechenden
Lookup-Ansicht
2. Optional: entsprechende Masken
3. Erstellen der Java Beans
4. Definition der Bean-Klassen in der
faces-config.xml
Zutaten

www.ics.ug #icsug
• Key für Database Profile = dbprofile
• Key für Nutzer Profile = Kanonischer Name
• Key für Wertlisten = frei definierbar, eindeutig
Lookup Ansicht

www.ics.ug #icsug
• 3 Klassen:
– DatabaseProfileBean
– AppConfigBean
– UserProfileBean
• Die DatabaseProfileBean initialisiert das
Dokument, falls es noch nicht vorhanden ist
• Die UserProfileBean initialisiert das
Dokument, wenn der Nutzer es speichert
Java Beans

www.ics.ug #icsug
faces-config.xml
<faces-config>

<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>

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

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

www.ics.ug #icsug
• Request
– kurzzeitig für die Dauer einer Anfrage bis zur Antwort (pro
Nutzer)
• View
– innerhalb einer Seite, auch bei partiellem Refresh (pro
Nutzer)
• Session
– Pro Nutzer für die Dauer der Anmeldung
• Application
– Anwendungsweit für die Dauer der Laufzeit (z.B. bis Server
Neustart bzw. Re-Initialisierung)
Exkurs: Bean Scopes

www.ics.ug #icsug
DEMO

www.ics.ug #icsug
Nutzer- und Umgebungsinformationen

www.ics.ug #icsug
Nutzer- & Umgebungsinformationen
Namensvariationen
Zugriffslevel
ACL Options notes.ini
Informationen
Environment
Bean

www.ics.ug #icsug
faces-config.xml: EnvironmentBean
<?xml version="1.0" encoding="UTF-8"?>
<faces-config>

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

www.ics.ug #icsug
Beispiel: Variationen des Nutzernamens

<xp:label
value="#{javascript:env.userName}"
id="label1">
</xp:label>


<xp:label
value="#{javascript:env.commonUserName}"
id="label2">
</xp:label>


<xp:label
value="#{javascript:env.abbreviatedUserName}"
id="label3">
</xp:label>

www.ics.ug #icsug
Beispiel: ACL Options
Der Löschen-Button ist nur
verfügbar, wenn der Nutzer dies
per ACL auch kann

www.ics.ug #icsug
Sogar in Themes nutzbar!
<theme
extends="flatly"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="platform:/plugin/com.ibm.designer.domino.style
kits/schema/stylekit.xsd">

<control>
<name>Button.Submit</name>
<property
type="boolean">
<name>rendered</name>
<value>#{env.createDocuments}</value>
</property>
</control>
</theme>

www.ics.ug #icsug
Volltextsuche vs. Facettensuche

www.ics.ug #icsug
Facetted Search
„Bei der Facettensuche oder Facettennavigation
werden anhand einer Facettenklassifikation
Suchtreffer eingegrenzt, beispielsweise in Produkt-
oder Bibliothekskatalogen. Die Facetten nutzen zur
Filterung Metadaten der jeweiligen Einträge.“
http://de.wikipedia.org/wiki/Facettensuche

www.ics.ug #icsug
Facetted Search

www.ics.ug #icsug
„Prominente“ Beispiele
amazing.com cyberharbor
muse

www.ics.ug #icsug
Facetted Search mit Domino?
1. Fulltext Search
2. Eingrenzen des Ergebnisses mit Metadaten-
Auswahl
1. Suche nach Metadaten-Auswahl
2. Durchsuchen des Ergebnisses mit Fulltext Search

www.ics.ug #icsug
FacettedSearchBean (Session scoped)
FacettenSuchbegriff
FacettedSearch
Bean
DocumentCollection
(ArrayList<SearchResultEntry>)

www.ics.ug #icsug
Code/DEMO

www.ics.ug #icsug
Facetted Search: Ausblick & Alternativen
• Graph-DB Funktionalität in der OpenNTF API
• 3rd party Graph-DB benutzen (z.B. Apache Solr)

www.ics.ug #icsug

www.ics.ug #icsug
Quellen
http://de.wikipedia.org/wiki/Facettensuche
http://lucene.apache.org/solr/
https://www.focul.net/focul-best-practice-faceted-filtering-xpages-using-java-beans/
https://bitbucket.org/zeromancer1972/icsug-2015-demo

Fix & fertig: Best Practises für "XPages-Migranten"

Weitere ähnliche Inhalte

Was ist angesagt?

Andere mochten auch

Mehr von Oliver Busse

Fix & fertig: Best Practises für "XPages-Migranten"