dnug35 ak-dev.071111-cookbook

DNUG Konferenz: Wie werden wir morgen arbeiten? Social Business becomes real.

Wie werden wir morgen arbeiten? The Lotus Code Cookbook

7. bis 9. November 2011 Welcome Kongresshotel Bamberg

Ulrich Krause, is@web, industrial services AG

35. DNUG Konferenz

Mit freundlicher Unterstützung von:

DNUG Konferenz: Wie werden wir morgen arbeiten?

Lotus Notes / Domino Administrator & Entwickler seit 1993 Business Application Developer

bei is@web, Niederlassung Ratingen OpenNTF http://openntf.org

• !!HELP!!, Cebulon, Trigger Happy• diverse XPages Custom Controls

IBM Champion 2011• https://www-304.ibm.com/connections/blogs/socialbusiness/entry/

announcing_the_2011_ibm_champions_for_collaboration_solutions4?lang=de

Blog http://www.eknori.de Notes Forum (http://www.atnotes.de)

About: Ulrich Krause


Allgemeines Optionen des Designers Tools @Formeln LotusScript Bearbeitung von Richtext ( C-Api / LS2CAPI ) Javascript (Frameworks) XPages

Agenda


Alle Sprachen verwenden die gleichen Kernfunktionen Bei gleicher Funktionalität sind Formeln performanter Nicht alle Formeln können in XPages verwendet werden.

• Nur 97 der insgesamt 274 Formeln• http://www-10.lotus.com/ldd/ddwiki.nsf/dx/List_of_Formula_Not_Supported_In_XPages

Warum @Formeln verwenden ?

LotusScript Java @Formula

ByteCode Interpreter FormulaEngine

Notes Core API


Wichtigste Codezeile in LotusScript Option Declare “zwingt” zum Deklarieren aller Variablen und

erspart das Beseitigen von schwer auffindbaren Fehlern Alle Fehler sind runtime Fehler

Option Declare


Ohne Option Declare

Mit Option Declare

Option Declare


Der wichtigste Grund, warum wir „Option Declare“ verwenden MÜSSEN, ist …

Option Declare


Every time you don‘t use „Option Declare“, God will kill a kitten !!

Option Declare


Erstellt eine Referenz zu einem Objekt, ohne das Objekt zu erstellen

Achtung : Dim i, j, k As Integer

Dim i As Integer, j As Integer, k As Integer

Dim Statement


Ausführungszeiten messen mit Getthreadinfo Wird z.B. ein Integerwert in einem Variant gespeichert, so

muss Notes intern eine Typumwandlung vornehmen. Das kostet Zeit !!

Dim Statement und Performance


16.260 Dokumente 10 Testläufe / Methode Tabelle zeigt die Durchschnittswerte

GetNextDocument vs. GetNthDocument


113.610 Dokumente 4 Testläufe / Methode Tabelle zeigt die Durchschnittswerte

GetNextDocument vs. GetNthDocument


Script / Comment Templates


Fonts / Colors

Individuelle Einstellungen für bessere Lesbarkeit

http://web.nickshanks.com/fonts/microsoft-core-web-fonts


Zeilennummern einblenden


One of the worst traps in LotusScript is using hard-coded field names.

LotusScript makes it simple to hard code field names, because of its support for extended attributes of the NotesDocument class.

The LotusScript documentation even describes this as a feature, though you should avoid it like the plague.

Soft-Coded Field Names


Kein Code ist absolut fehlerfrei! Auch wenn momentan keine Fehler erkennbar sind, werden

Fehler auftauchen. Fehler erkennen, die von Usern nicht immer gemeldet

werden. Es gibt Tools, die ein aussagekräftiges Logging mit nur

wenigen Codezeilen ermöglichen. Julian Robichaux: OpenLog

– http://www.openntf.org/internal/home.nsf/project.xsp?action=openDocument&name=OpenLog

Logging


OpenLog


Domino Designer extension Sucht in einer oder meheren Anwendungen Unterstützt

• Java, • Javascript, • Lotusscript,• @Formula,• Xpages

Source Sniffer

http://www.openntf.org/internal/home.nsf/project.xsp?action=openDocument&name=Source%20Sniffer


NotesHound

http://domino-80.prominic.net/A55BE4/NotesHoundWeb.nsf/webpages/index.html


Performancegewinn, da die Ansicht nicht kontinuierlich aktualisiert wird.

• Zu den technischen Hintergründen; Bob Balaban, http://bobzblog.com/tuxedoguy.nsf/dx/geek-o-terica-10-autoupdating-in-views

• http://www-10.lotus.com/ldd/ddwiki.nsf/dx/View.AutoUpdate_

Bei der Verwendung von NotesViewNavigator können Fehler auftreten, wenn AutoUpdate = true („Entry not found in Index“)

• Andre Guirard, http://www-10.lotus.com/ldd/bpmpblog.nsf/dx/autoupdate-false

NotesView.AutoUpdate = false


Neu ab 8.5.1 Nur in Ansichtsspalten zu verwenden Option „Maintain folder unread

information“ muß aktiviert sein Option „ Don't maintain

Unread marks“ darf nicht aktiviert sein“

@WhichFolders


db.FolderReferencesEnabled = True $FolderInfo und $FolderRefInfo

– Ansichten können aus der Mailschablone kopiert werden

@WhichFolders in LotusScript I


CreateViewNavFrom Keine zusätzlichen Designelemente erforderlich Aber langsam bei einer großen Ordneranzahl

@WhichFolders in LotusScript II


Wie @WhichFolders mit zusätzlichen Möglichkeiten, um die Ordnereigenschaften eines Dokuments zu ändern.

Uncheck „Don‘t maintain unread marks“

@Command( [DiscoverFolders];title)


Seit Version 6 Entspricht LotusScript statement ForAll x in Liste Führt eine Formel für jedes Element der Liste aus. @Transform( list ; variableName ; formula ) Rückgabewert ist die durch die Formel modifizierte Liste Kann in Ansichtenspalten verwendet werden

@Transform


Names.nsf - People\By Client Version Unübersichtlich, da alle

Versionen dargestellt werden.

@Transform (Sample)


Mit wenigen Handgriffen Ordnung schaffen

People\By Client Version (new)


@Transform + @DocFields

http://www.eknori.de/2011-07-23/formula-magic/


Seit Version 6 Lt. Designer Hilfe nur mit @Transform zu verwendbar ( „not

valid in other context“ ) Funktioniert aber z.B auch in View Selection

@Nothing


Sortiert eine Liste– [ACCENTSENSITIVE]– [ACCENTINSENSITIVE]– [ASCENDING]– [CASESENSITIVE]– [CASEINSENSITIVE]– [CUSTOMSORT]– [DESCENDING]– [PITCHSENSITIVE]– [PITCHINSENSITiVE]

Dies lässt sich auch kombinieren– [ASCENDING]:[CASESENSITIVE]

@Sort


@Sort kann aber noch mehr – [CustomSort]

@Sort


Ändert den Kontext einer Formel Nachfolgende Befehle werden

im neuen Kontext ausgeführt

@UpdateFormulaContext


@LocationGetInfo• @LocationGetInfo([HomeServer])• @LocationGetInfo([InternetMailAddress])• @LocationGetInfo([NamePreference])• @LocationGetInfo([BookmarksFilename])• @LocationGetInfo([SametimeServer])

@LocationGetInfo([UNID])• http://www.thenorth.com/apblog4.nsf/0/60C5A5C6540A2D648525719F0012BDE

Get the current location name


@LocationGetInfo([FullName])• @LocationGetInfo([AbbreviatedName])

Damit erhalten wir Zugriff auf JEDES beliebige Feld in der aktuellen Arbeitsumgebung

Get the current location name


New @Function to support Machine Specific Policy Settings as of Notes / Domino 8.5.3

@GetMachineInfo (8.5.3)


@GetMachineInfo([EnvVariable];"Location");• Liefert den gewünschten Wert für alle Variablen in der notes.ini

zurück• Egal ob mit „$“ oder ohne• Kann keine Werte setzen

@Environment(„Location“)• Liefert nur Variablen mit „$“ zurück ($DDM_SERVER)• Kann auch Werte in der notes.ini setzen

@GetMachineInfo vs. @Environment


Überprüft Formeln

@CheckFormulaSyntax


@CheckFormulaSyntax (LotusScript)

Verwendet LotusScript EVALUATE


Schade

Und was macht IBM?


Ermittelt die Anzahl von Werktagen in einem Datumsbereich• Bestimmte Tage können als Werktage ausgeschlossen werden• Ebenso lassen sich Feiertage als Werktage ausschließen

@BusinessDays

Beispiel: Der Wert eines Items soll auf einen Wert @Today + 3 Tage gesetzt werden.Dabei sollen die Wochenenden und bestimmte Datumswerte nicht als Werktage gelten.

@BusinessDays wird in XPages nicht unterstützt


Evaluate zur Einbindung von @BusinessDays in LS

@BusinessDays (LS)


Keine Fehlermeldung, wenn keine Entsprechung in der Ansicht gefunden wird

@DbLookup(""; ""; "All"; Source; 2;[FailSilent])

@DbLookup + [FailSilent]


Gibt die DocumentUNID eines @DBLookup Ergebnisses zurück

@DbLookup(""; ""; "All"; “test”; 1; [FailSilent]:[ReturnDocumentUniqueID]);

Macht eine zusätzliche Ansicht mit einer Spaltenformel @Text(@DocumentUniqueID) überflüssig

[ReturnDocumentUniqueID]


Wo ist die notes.ini? • @Prompt([OK];“notes.ini path“;@configfile)

Notes.ini bearbeiten• @Command([Execute];"

@ConfigFile


Wozu ist die Eigenschaft „Programmatic Use“ da?

Keine Redundanz komplizierterSpaltenformeln. Das Ergebnis einer Berechnung kann in einer anderen Spalte verwendet werden

Programmatic Use


Element nicht anzeigen, wenn User nicht mindestens eine der Rollen hat.

• @IsNotMember("[GloAdmin]"; @UserRoles) & @IsNotMember("[GloEditor]"; @UserRoles)

Läßt sich kürzen auf:• @IsNotMember("[GloAdmin]" : "[GloEditor]"; @UserRoles)

Noch kürzer

•!("[GloAdmin]" : "[GloEditor]" *= @UserRoles)

Permutation Comparison In Hide Formulas


Regeln haben starre, vorgegebene Bedingungen

Mail Rules Extended


Der Client speichert die Regeln im Kalenderprofil Auf dem Server werden die Regeln in “mailrule”

Dokumenten gespeichert

Mail Rules Extended


Mehr Möglichkeiten bei der Regelerstellung Erfordert Änderung an names.nsf Kein grosser Aufwand beim Upgrade

Mail Rules Extended


Einfache Erweiterung in names.nsf• Create a new subform• Create a new field on the subform ( SelectionCriteria,Text, Editable)

• Give it the name Custom and an alias starting with $AutoPopulate followed by a number of your choice ( i.e. 9999)

• Save the subform

• http://www.eknori.de/2008-06-10/tweak-the-auto-populated-groups-feature-in-domino-85

Tweak Auto-Populated Groups

UPDATE 8.5.3 :http://bodek.uwindsor.ca/users/b/bodek/bodekblog.nsf/d6plinks/BFRK-8MRPWN


Unter Umständen sollen die Bearbeiter eines Dokuments nicht sichtbar sein.

How to get rid of $UpdatedBy?


Fehlende Funktionen hinzufügen• Z.B. : User aus Gruppe entfernen

Verlagerung administrativer Aufgaben in den Servicedesk NotesAdministrationProcess class Seit Release 6 AddGroupMembers method aber keine RemoveGroupMembers method

Custom Administration Process

LotusScript Gold Collection (1.3):[*] NotesGroupManager: makes it easy to scan and manage group memberships in public and private address books, including groups with subgroups.

http://www.openntf.org/projects/pmt.nsf/ProjectLookup/LotusScript%20Gold%20Collection


admin4.nsf anpassen

• Neue Ansicht erstellen oder• Spalte „Action“ anpassen


http://www.eknori.de/2007-12-15/delete-group-members-using-the-administration-process/


Verwendung von ZIP/UNZIP mit LotusScript Kostenlos

Zip / UnZip

http://www.vcode.no/vcode.nsf/downloads/VCZIPSUP


Anhänge werden beim Versenden automatisch gepackt Genaue Beschreibung der Anpassungen

im Lotus Notes & Domino Wiki

• http://www-10.lotus.com/ldd/dominowiki.nsf/page.xsp?documentId=7963EB58BAD528FB852577AE0062A72A&action=openDocument&mode=original

Auto-Zip Mail Attachments


Reports sollen auf einem Server erstellt werden, auf dem kein Excel installiert ist. ( Linux )

http://jxls.sourceforge.net/index.html• Support for Excel 2007 OOXML (.xlsx) file format

XLS ohne Excel erstellen


XLS ohne Excel erstellen


%Include "symphonylsx.lss„ OpenNTF.org Contacts Experience

– http://www.openntf.org/internal/home.nsf/project.xsp?action=openDocument&name=OpenNTF.org%20Contacts%20Experience

MailMerge Letter Export Contacts

• Symphony• MS Office

Lotus Symphony Toolkit


doc.GetRead([username])• Ab Release 8.5• Gibt „true“ zurück, wenn das Dokument vom aktuellen User gelesen

wurde• Wird ein Username angegeben, wird der Lesestatus dieses Users

zurückgegeben

Wurde das Dokument gelesen?


Ben Langhinrichs ( genii software ) Auslesen von Daten aus RichText Syntax wie @DBColumn und @DBLookup

@Midas Lookups

Free download: http://www.geniisoft.com/showcase.nsf/MidasLookups


Erweiterte Möglichkeiten Beispiel: Sortierte Ausgabe aller Listenpunkte

@Midas Lookups


@Length(@Text(body))-1

@Attachments

rtitem.ValueLength

rtitem.EmbeddedObjects• Attachments OK• Aber: Doclinks, Inline Images, Hotspots (Button)

Ist RichText Item leer??


Ist RichText Item leer?


C/C++ API oder LS2CAPI Normunds Kalbernzin

• LotusScript to Lotus C API Programming Guide ( ls2capi.com )

Lee Powell• LotusScriptor's Plain Simple Guide to the

Lotus Notes C++ API • Download :

http://www.eknori.de/downloads/capibook.pdf

Ethann Castell• Getting started with the C-API• Control rich text content with precision using the C-API• The View, 09 / 11 , 2007

Arbeiten mit RichText


Einordnung der C-API

Betriebssystem

Notes Object Interface (NOI)

Lotus Script

C++ API

Notes Core ( C API )

Visual Basic (COM)JAVA

JNI


LS2CAPI to the rescue!• Leeres RTI besitzt nur einen CDRecord von Typ Text

Ist RichText Item leer?


Erstellen / Ändern• Anwendungseigenschaften ( global )• Dokumenteneigenschaften

Keine Möglichkeit über @Formel oder LotusScript

Header / Footer


Informationen sind in RichText item gespeichert

Header / Footer


LotusScript Library / LS2CAPI

Header / Footer


Auf Inline Images kann nicht über die embedded objects Eigenschaft zugegriffen werden

Inline Images werden z.B. nicht bei DAOS berücksichtigt. Es gibt keine Methoden, um Inline Images mit LotusScript

so umzuwandeln, daß sie als Anhang im Dokument gespeichert werden.

Inline Images


Wie ist ein Inline Image gespeichert ?

Inline Images


Inline Images

Andre Guirard

http://www.openntf.org/internal/home.nsf/project.xsp?action=openDocument&name=LotusScript%20Gold%20Collection


rtLib: framework of LotusScript classes to work with Notes Rich Text on 32-bit versions of Domino on AIX, Solaris (SPARC), Linux, MacOS, OS X (currently PowerPC only) and Windows.

Inline Images

Normunds Kalnberzins http://www.rtlib.com/


Bilder, die aus der Zwischenablage in ein Dokument eingefügt werden, werden bei DAOS nicht berücksichtigt.

Methoden zum Umwandeln in ein Attachment gibt es in Lotus Notes nicht.

Funktion muss folgende Voraussetzungen erfüllen• Umwandeln des inline image in ein Attachment• Ersetzen des inline image durch das Attachment• Beibehalten der Position

Replace Inline Image


Replace Inline Image

Das Attachment wird an die Position des Inline Image gesetzt.


notesRichTextRange.FindAndReplace( target$ , replacement$ , [ options& ] )

Damit lässt sich aber nur Text innerhalb von RichText finden und ersetzen

Für das Einfügen eines kompletten RichText Items oder Teile davon an eine definierte Stelle in einem anderen RichText Item gibt es keine Methode.

Insert Richtext into Richtext


Insert Richtext into Richtext


JW Player: Ein paar Zeilen Code für einen Mediaplayer für Flash und HTML5 support

Skins

JW Player - Mediaplayer

http://www.longtailvideo.com/players/


JW Player - Mediaplayer


freie, umfangreiche JavaScript-Klassenbibliothek, welche komfortable Funktionen zur DOM-Manipulation und -Navigation zur Verfügung stellt

jQuery

http://www.reizkraft.com/content/die-43-sch%C3%B6nsten-jquery-plugins-f%C3%BCr-webdesignAnimated gif created with http://picasion.com/


Nur 97 der 274 @Formeln können in SSJS verwendet werden

– http://www-10.lotus.com/ldd/ddwiki.nsf/dx/List_of_Formula_Not_Supported_In_XPages

Michael Gollmick hat ein paar Formeln umgesetzt• @WebDBName

– http://blog.gollmick.de/mgoblog.nsf/40f2c735481f54dd80256d650047636c/0687660450ad65bdc125754a008357ce?OpenDocument

• @URLEncode, @URLDecode– http://blog.gollmick.de/mgoblog.nsf/dx/some-more-Functions-for-XPages-

URLEncode-URLDecode.htm

Xpages und @Formula

• Mail: [email protected]• Blog: http://www.eknori.de• Sametime: bleedyellow.com• Twitter: eknori

Q + A

dnug35 ak-dev.071111-cookbook

Documents