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 kann aber noch mehr – [CustomSort]

Ä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

%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

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

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

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

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

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: eknori@eknori.de• Blog: http://www.eknori.de• Sametime: bleedyellow.com• Twitter: eknori

dnug35 ak-dev.071111-cookbook

Documents

edicion aragua 071111

unity cookbook 1

voudon gnostic cookbook

facebook cookbook

dominika bien cookbook

android cookbook

dnug35 ak-dev.071111-beyond

cookbook greek

unity cookbook 2

national cookbook

tagalog cookbook copy.indd

spanish cookbook-smoothies

unity cookbook 21

recipes cookbook

unity cookbook 9

unity cookbook 15

tmb cookbook

unity cookbook 18

unity cookbook 3

dnug35 ak-dev.071111-basic