Das LotusScript-Entwicklerbuch für Notes/Domino 8 - Von den Grundlagen bis zu Composite Applications

Inhaltsübersicht

Inhaltsverzeichnis

1 Einleitung

1.1 Neues in Notes Version 8

1.2 Was Ihnen dieses Buch bietet

1.3 Wie Sie aus diesem Buch den größten Nutzen ziehen können

1.3.1 An wen richtet sich dieses Buch?

1.3.2 Aufbau

2 Konventionen in diesem Buch

Teil I Grundlagen

Kapitel 3 Einführung in die LotusScript-Programmierung

3.1 Das erste Programm

3.1.1 Neue Anwendung (Datenbank) anlegen

3.1.2 Anwendung (Datenbank) zur Programmierung öffnen

3.1.3 Unser erstes Programm: Einen Agenten erstellen

3.2 Die grundlegenden Schritte zur Erstellung von LotusScript-Programmen

3.3 Variablen – die temporären Speicherplätze

3.3.1 Variablen deklarieren

3.3.2 Einen Wert zuweisen

3.3.3 Auf eine Variable zugreifen

3.4 Ausdrücke erstellen und verwenden

3.4.1 Numerische Ausdrücke

3.4.2 Boolesche Ausdrücke

3.5 Eine eigene Prozedur schreiben

3.5.1 Die Prozedur anlegen

3.5.2 Die Prozedur aufrufen

3.5.3 Funktionen

3.5.4 Parameter und Programmverzweigungen

3.6 Den Debugger verwenden

3.7 Eingebaute Funktionen

3.7.1 Zwei Rückgabearten – Variant und String

3.8 Mit (Notes-)Objekten arbeiten

3.8.1 Daten aus der aktuellen Notes-Sitzung abfragen (Teil 1)

3.8.2 Etwas Theorie – Objekte, Methoden und Eigenschaften

3.8.3 Daten aus der aktuellen Notes-Sitzung abfragen (Teil 2)

3.8.4 Eine Methode des Arbeitsbereichs aufrufen

3.8.5 Eigenschaften ändern

3.9 Weitere Startpunkte für LotusScript-Programme

3.9.1 Aktionsschaltflächen

3.9.2 Masken, Teilmasken und Seiten

3.9.3 Ansichten und Ordner

3.9.4 Datenbanken

3.9.5 Gliederungen

3.10 Bibliotheken erstellen und einbinden

3.11 Eigene zusammengesetzte Datentypen erstellen

3.12 Eigene Klassen und Objekte erstellen

3.13 Gültigkeitsbereiche und Module

3.14 Wie geht es nun weiter?

Teil II Sprachbefehle nach Themen

Kapitel 4 Sprachbefehle – nach Themen

4.1 Variablen und Datentypen

4.1.1 Binärer Baum als Beispiel für selbst erstellte Datenstrukturen

4.1.2 Anweisungen zur Arbeit mit Variablen

4.1.3 Funktionen zur Typ-Abprüfung

4.1.4 Konstanten

4.1.5 Literale

4.1.6 Funktionen zur Typumwandlung

4.1.7 Arrays bearbeiten

4.1.8 Funktionen und Anweisungen zur Listen-Bearbeitung

4.1.9 Objekte erstellen und zerstören

4.2 Optionen und Voreinstellungen

4.3 String- und Zeichenbearbeitung

4.3.1 Groß- und Kleinschreibung beeinflussen

4.3.2 Zeichenketten vergleichen

4.3.3 Zeichenketten bearbeiten

4.3.4 Bearbeiten von Leerzeichen

4.3.5 Arbeit mit Zeichencodes

4.3.6 Die Funktionen im Einzelnen

4.4 Mathematische Funktionen

4.5 Funktionen zur Bearbeitung von Zeitwerten

4.6 Zahlenoperationen

4.6.1 Rechnen mit Zahlen

4.6.2 Zahlen vergleichen

4.6.3 Bitweise Operationen

4.7 Ablaufsteuerung – Verzweigungen und Schleifen

4.8 Anweisungen zur Fehlerbehandlung

4.9 Funktionen zur Dateibearbeitung

4.10 Funktionen zur Ausgabe und Eingabe

4.10.1 IME-Funktionen

4.11 Programmsperren verwalten

4.12 Anweisungen zum Einbinden und zum Aufrufen von Bibliotheken und anderem Code

4.13 Anweisungen zum Aufruf und zur Steuerung von anderen Anwendungen

4.14 Kommentarzeilen

4.15 Zufallszahlen erstellen

4.16 Verarbeitung von anderen Zahlensystemen

4.17 Sonstige

Teil III Arbeiten mit Notes-Klassen

Kapitel 5 Datenbanken

5.1 Öffnen von Datenbanken

5.1.1 Öffnen von Datenbanken allgemein

5.1.2 Auf die Datenbank zugreifen, in der das Script läuft

5.1.3 Öffnen von speziellen Datenbanken

5.1.4 Zugriff auf Clusterdatenbank

5.2 Datenbanken schließen

5.3 Datenbanken erstellen

5.3.1 Eine leere Datenbank erstellen

5.3.2 Eine Datenbank auf Basis einer vorhandenen Schablone erstellen

5.3.3 Eine Datenbankkopie erstellen

5.3.4 Erstellen einer Replik

Kapitel 6 Ansichten und Ordner

6.1 Gemeinsamkeiten und Unterschiede zwischen Ansichten und Ordnern

6.2 Auf Ansichten zugreifen

6.3 Durchlaufen und Analysieren von Ansichtszeilen

6.3.1 Navigation über Dokumente

6.3.2 Probleme durch aus der Ansicht herausfallende Dokumente vermeiden

6.3.3 Navigation über alle Zeilen (mit NotesViewNavigator)

6.3.4 Spezielle Informationen des NotesViewEntry-Objekts

6.3.5 Kategorien und Spaltensummen auswerten

6.3.6 Suche innerhalb einer bestimmten Kategorie

6.3.7 Ein umfassendes Beispiel

6.4 Suche mit Ansichten

6.4.1 Suche in einer Schleife

6.4.2 Suche per Volltextsuche

6.4.3 Suche per GetDocumentByKey und analog arbeitenden Methoden

6.4.4 Suche per @DbLookup

6.4.5 Suche durch Wahl geeigneter Selektionsformeln

6.4.6 Suchunterstützung durch CreateViewNav, CreateViewNavFrom usw.

6.5 Sortierung in Verbindung mit der Suche

6.5.1 Die nachträgliche Sortierung von Dokumenten

6.6 Ansichten bearbeiten

6.6.1 Eine neue Ansicht erstellen

6.6.2 Besonderheiten beim Erstellen von Ordnern

6.6.3 Auf eine Spalte zugreifen

6.6.4 Bearbeitung von Ansichtsspalten

6.6.5 Tabelle der änderbaren NotesViewColumn-Eigenschaften

6.6.6 Ändern der Auswahlformel

6.6.7 Änderungen speichern

6.6.8 Änderungen sichtbar machen

6.6.9 Ansicht löschen

Kapitel 7 Dokumente und Items

7.1 Dokumente erstellen und bearbeiten

7.1.1 Items erstellen und Dokument speichern

7.1.2 Mit Maske verbinden

7.1.3 Dokument bzw. Items auswerten und bearbeiten

7.1.4 Items löschen

7.2 Dokumente löschen

7.2.1 Wiederherstellbare Löschungen

7.2.2 Endgültige Löschungen

7.2.3 Keine Löschung möglich bei Zugriff über das User-Interface

7.3 Vereinfachter Zugriff auf Items – als Eigenschaften von NotesDocument

7.3.1 Vorteile des Extended-Class-Verfahrens

7.3.2 Zwei Nachteile des Extended-Class-Verfahrens

7.4 Items vergleichen

7.5 Dokumentlisten und Dokumentabbilder

7.5.1 Newsletter mit Dokument(link)liste erstellen

7.5.2 Newsletter mit dem Bild eines Dokuments erstellen

7.5.3 Zusammenfassung

Kapitel 8 Datumswerte und Zeitangaben

8.1 Vielfältige Erscheinungsformen

8.2 Der beste Weg, Stolperfallen zu vermeiden

8.3 DATE-Variant-Variablen und NotesDateTime – wo sollte man was verwenden?

8.4 Datumsformate, die Domino versteht

8.5 DATE-Variant-Variablen – die einfache Variante

8.5.1 Datums-/Zeitwerte erstellen

8.5.2 Zeitwertberechnung

8.5.3 Interne Darstellung

8.5.4 Verrückte Zeitberechnungen

8.5.5 Zeitdifferenzen berechnen

8.5.6 Gebrochene Zahl = Datums-/Zeitwert?

8.5.7 Zahlwerte in Datums-/Zeitwerte konvertieren

8.5.8 Strings in Datums-/Zeitwerte konvertieren

8.5.9 Formatierte Ausgabe

8.5.10 Nur-Datumswerte und Nur-Zeitwerte

8.5.11 Mängel bei DATE-Variant-Variablen

8.6 Das interne Domino-Format verstehen

8.6.1 Die Bedeutung der einzelnen Zeichen – rechte Hälfte

8.6.2 Die Bedeutung der linken Hälfte

8.6.3 Die Bedeutung des ersten Bytes ganz, ganz links

8.6.4 Die Teile wieder zusammenfügen

8.6.5 Noch etwas – reine Datumsangaben und reine Zeitwerte

8.7 Die NotesDateTime-Klasse

8.7.1 Anlegen eines NotesDateTime-Objekts und Bearbeitung der grundlegenden Werte

8.7.2 NotesDateTime-Objekte bei ihrer Erstellung initialisieren

8.7.3 Werte aus Items übernehmen

8.7.4 Datums-/Zeitwerte (relativ) verändern

8.7.5 Zeitzonen und Sommerzeiten

8.7.6 Die lokale Zeit in Zeiten anderer Zeitzonen umrechnen

8.7.7 Die Zeit einer anderen Zeitzone in lokale Zeit umwandeln

8.7.8 NotesDateTime-Objekte mit reinen Datums- oder reinen Zeitangaben

8.7.9 Zeitdifferenzen berechnen

8.7.10 Wie kommt man an die Hundertstelsekunden?

8.7.11 Grenzen

Kapitel 9 Notes- und Internetnamen

9.1 Aufbau von Notes- und Internetnamen

9.1.1 Hierarchische Notes-Namen

9.1.2 Flache Notes-Namen

9.1.3 Internetnamen

9.2 Namen mit NotesName auswerten

9.2.1 Notes-Namen

9.2.2 Internetadressen

9.2.3 Notes- und Internetnamen gemischt

9.3 Alle Eigenschaften von NotesName auf einen Blick

Kapitel 10 Dateien und Streams

10.1 Öffnen von Dateien – Zuordnung einer Dateinummer

10.2 Dateien schließen

10.3 Hinweis zum #-Zeichen

10.4 Dateien mit verschiedenen Zugriffsmodi lesen und bearbeiten

10.4.1 Sequenzieller Zugriff

10.4.2 Binärzugriff

10.4.3 Wahlfreier Zugriff

10.5 Dateisperren verwalten

10.5.1 Beabsichtigte Art des Zugriffs angeben

10.5.2 Beabsichtigte Operationen angeben (Lesen und/oder Schreiben)

10.5.3 Sperre setzen

10.5.4 Teilsperren errichten

10.6 Streams

Kapitel 11 Richtext

11.1 Notes-Klassen zur Richtext-Bearbeitung

11.2 Auf ein Richtext-Item zugreifen

11.3 Neuen Richtext erstellen

11.3.1 Text mit Stilmerkmalen in ein Richtext-Item einfügen

11.3.2 Dokumenten-, Ansichts- und Datenbankverknüpfungen erstellen

11.3.3 Abschnitte erstellen

11.3.4 Tabellen erstellen

11.4 Den internen Aufbau von Richtext verstehen

11.4.1 Richtext in Notes Peek betrachten

11.4.2 Richtext in der C-API

11.4.3 XML-Darstellung

11.5 Richtext analysieren und bearbeiten

11.5.1 Grundlagen zur Verwendung von NotesRichTextNavigator

11.5.2 In Tabelle navigieren und sie mit Inhalt versehen

11.5.3 Nachträgliche Bearbeitung eines Abschnitts

11.5.4 Grundlagen zur Verwendung von NotesRichTextRange

11.5.5 Texte mit NotesRichTextRange bearbeiten (1)

11.5.6 Texte mit NotesRichTextRange ausgeben

11.5.7 Texte mit NotesRichTextRange bearbeiten (2)

11.5.8 Innerhalb eines Bereichs navigieren

11.5.9 Elemente entfernen

11.5.10 Compact und Update

11.6 Fehler und ihre Ursachen

11.6.1 Fehler, die sich aus dem Programmablauf ergeben können

11.6.2 Fehler in NotesRichTextNavigator und NotesRichTextRange

11.6.3 Zusammenfassung

Kapitel 12 MIME

12.1 Struktur

12.1.1 Header und Content-Elemente

12.1.2 Hierarchischer Aufbau

12.1.3 Ein- und mehrteilige MIME-Dokumente

12.1.4 Inhaltstyp

12.1.5 Angabe der Kodierung

12.1.6 Offener Standard

12.2 MIME in Notes

12.2.1 Items mit MIME-Inhalten

12.2.2 Zugriff auf MIME-Inhalte als Richtext

12.2.3 Zugriff auf MIME-Inhalte als MIME

12.2.4 Klassen zur MIME-Bearbeitung

12.2.5 Eine Mail im (einteiligen) MIME-Format erstellen

12.2.6 Eine Mail mit Bilddatei im mehrteiligen (multipart) MIME-Format erstellen

12.2.7 Ein MIME-Dokument in Textform ausgeben

12.2.8 MIME ins Dokument zurückschreiben und speichern

12.3 Richtext ins MIME-Format überführen

12.3.1 Manuelles Verfahren

12.3.2 Nutzung der C-API

12.3.3 Verwendung von XML

12.4 Daten mithilfe von NotesMIMEEntity kodieren und dekodieren

12.4.1 Dekodieren

12.4.2 Umkodieren

12.4.3 Vereinfachung bei reiner Dekodierung

Kapitel 13 XML und DXL

13.1 Was ist eigentlich XML?

13.1.1 Unterschiede zwischen XML und HTML

13.1.2 DXL

13.1.3 XML-Verarbeitung

13.1.4 Weitere Informationen

13.2 Klassen zum Erzeugen und Bearbeiten von DXL

13.2.1 NotesXMLProcessor – das Herzstück der XML-Verarbeitung

13.2.2 Notes-Dokumente als XML ausgeben

13.2.3 Datenquelle festlegen

13.2.4 Datenziel festlegen

13.2.5 Die Verarbeitung anstoßen

13.2.6 XML-Bearbeitung in mehreren Schritten

13.2.7 Verkettung von XML-Objekten (Pipelining)

13.2.8 Nachteil des Verkettungsmechanismus

13.2.9 Protokollierung, Fehlerbehandlung

13.3 Besonderheit beim Einsatz von NotesStream als Quelle oder Ziel

13.4 Weitere Details zur Klasse NotesDXLExporter

13.5 XML-Bearbeitung mit DOM – Details

13.5.1 Die NotesDOMNode-Klasse

13.5.2 NotesDOMDocumentNode – oder: der rätselhafte Wurzelknoten

13.5.3 Die übrigen Knoten

13.5.4 Einen neuen DOM-Baum im Speicher erzeugen und bearbeiten

13.5.5 DOM-Baum »zu Fuß« aufbauen

13.5.6 Bearbeitung eines DOM-Baums

13.6 XML-Bearbeitung mit SAX – Details

13.6.1 Ausgaben mit NotesSAXParser erzeugen

13.6.2 Parsen und Inhalte ausgeben – Beispiel

13.6.3 Fehlerbehandlung

13.7 Typische Fehler und ihre Vermeidung

13.7.1 Expected whitespace

13.7.2 Invalid document structure

13.7.3 The XML or Text declaration must start at line/column 1/1

13.7.4 XML-Reformatter-Eingabezeichensatz nicht erkannt bzw. kann nicht geladen werden

Kapitel 14 Farben

14.1 Notes-Farben

14.2 NotesColorObject – für differenziertere Farben

14.2.1 RGB-Werte als Farbeinstellung zuweisen

14.2.2 Eine Notes-Farbe aus RGB-Werten berechnen und zuweisen

14.2.3 Warum stimmen die ermittelten Farbwerte nicht überein?

Kapitel 15 ACL verwalten

15.1 Eine ACL lesen

15.1.1 Abfrage über NotesDatabase-Objekt

15.1.2 Abfrage über NotesACL-Objekt

15.1.3 Wann welchen Weg nutzen – NotesDatabase und NoteACL?

15.1.4 Datenbankobjekt muss geöffnet sein

15.2 Die ACL bearbeiten

15.2.1 Erstellen und Entfernen von ACL-Einträgen

15.2.2 ACL-Einträge umbenennen

15.2.3 Bearbeitung von Rollen

15.2.4 Benutzertypen

15.3 Die Kontrolleure der Kontrolle kontrollieren – das Aktivitätenlog der ACL auswerten

15.4 Wie sicher ist »sicher« – wie sicher ist die ACL?

Kapitel 16 Verbundanwendungen

16.1 Technische Realisation – die einzelnen Schritte und Werkzeuge

16.1.1 Kommunikation per WSDL

16.1.2 Der Eigenschaftsbroker

16.1.3 Verbunddatenbank

16.2 Praktisches Beispiel (1) – Eingabeeigenschaft verbrauchen

16.2.1 Erster Schritt – Erstellung der Komponente »Weltzeituhr&ldquo

16.2.2 Zweiter Schritt – Erstellung der Ansichtskomponente

16.2.3 Dritter Schritt – Verbundanwendung zusammenfügen

16.3 Praktisches Beispiel (2) – Ausgabeeigenschaft veröffentlichen

16.4 Debuggen

Kapitel 17 Domino Verzeichnis – komfortable Abfragen

17.1 Die Reichweite der Unterstützung

17.2 Grundlegende Funktionsweise

17.2.1 Navigation über gefundene Daten

17.3 Eine Informationssuche mit NotesDirectory

17.3.1 Mehrere Treffer erzielen und auswerten

17.3.2 Nach mehreren Namen suchen

17.3.3 Fehlermöglichkeiten in Verbindung mit Items

17.4 Weitere Navigatoren verwenden

17.5 Sonderfall: Gezielte Suche nach Mailinformationen

17.6 Ausgewertete Verzeichnisse eingrenzen

17.7 Treffergenauigkeit festlegen

17.8 Pufferspeicher freigeben

17.9 AvailableItems, AvailableNames, AvailableView

17.10 Fehler in Verbindung mit gelöschten Dokumenten

Kapitel 18 Administrative Aufgaben – Registrieren und Zertifizieren

18.1 Parametrisierung – in zwei Stufen

18.2 Zu erwartende Schwierigkeiten

18.3 Protokolldatei angeben

18.4 Allgemeines zu Zertifizierungen

18.4.1 Zertifizierung mithilfe einer ID-Datei

18.4.2 Zertifizierung mithilfe einer Zertifizierungsstelle

18.4.3 Ablageort für die ID-Datei festlegen

18.5 Neuen Zertifizierer erstellen

18.5.1 Zertifizierer der obersten Ebene erstellen (Wurzelzertifikat)

18.5.2 Zertifizierer für tiefere Ebenen

18.5.3 Zusammenfassung

18.6 Benutzer anlegen

18.6.1 Web-Benutzer

18.6.2 Mail-Datei

18.6.3 Eindeutige Unterorganisation

18.6.4 Gruppenzugehörigkeiten

18.6.5 Kurznamen

Kapitel 19 Administrative Aufgaben – Lösungen mit dem Administrationsprozess

19.1 Grundsätzliches

19.2 Grundlegendes zum Administrationsprozess

19.3 NotesAdministrationProcess – Hilfe bei der Steuerung

19.4 Praktische Anwendung von NotesAdministrationProcess

19.4.1 Beispiel Personalabteilung

19.4.2 Anforderung erstellen

19.4.3 Referenz auf das Anforderungsdokument festhalten

19.4.4 Statusabfrage

19.4.5 Abschließende Bemerkungen und Codezusammenfassung

19.5 Bestätigungsanforderungen

19.6 Folgeanforderungen

Kapitel 20 Detailbetrachtung – Klasse für Klasse

20.1 Button

20.2 Field

20.3 Navigator

20.4 NotesACL

20.5 NotesACLEntry

20.6 NotesAdministrationProcess

20.7 NotesAgent

20.8 NotesColorObject

20.9 NotesDatabase

20.10 NotesDateRange

20.11 NotesDateTime

20.12 NotesDbDirectory

20.13 NotesDirectory

20.14 NotesDirectoryNavigator

20.15 NotesDocument

20.16 NotesDocumentCollection

20.17 NotesDOMAttributeNode

20.18 NotesDOMCDATASectionNode

20.19 NotesDOMCharacterDataNode

20.20 NotesDOMCommentNode

20.21 NotesDOMDocumentFragmentNode

20.22 NotesDOMDocumentNode

20.23 NotesDOMDocumentTypeNode

20.24 NotesDOMElementNode

20.25 NotesDOMEntityNode

20.26 NotesDOMEntityReferenceNode

20.27 NotesDOMNamedNodeMap

20.28 NotesDOMNode

20.29 NotesDOMNodeList

20.30 NotesDOMNotationNode

20.31 NotesDOMParser

20.32 NotesDOMProcessingInstructionNode

20.33 NotesDOMTextNode

20.34 NotesDOMXMLDeclNode

20.35 NotesDXLExporter

20.36 NotesDXLImporter

20.37 NotesEmbeddedObject

20.38 NotesForm

20.39 NotesInternational

20.40 NotesItem

20.41 NotesLog

20.42 NotesMIMEEntity

20.43 NotesMIMEHeader

20.44 NotesName

20.45 NotesNewsletter

20.46 NotesNoteCollection

20.47 NotesOutline

20.48 NotesOutlineEntry

20.49 NotesProperty

20.50 NotesPropertyBroker

20.51 NotesRegistration

20.52 NotesReplication

20.53 NotesReplicationEntry

20.54 NotesRichTextDocLink

20.55 NotesRichTextItem

20.56 NotesRichTextNavigator

20.57 NotesRichTextParagraphStyle

20.58 NotesRichTextRange

20.59 NotesRichTextSection

20.60 NotesRichTextStyle

20.61 NotesRichTextTab

20.62 NotesRichTextTable

20.63 NotesSAXAttributeList

20.64 NotesSAXException

20.65 NotesSAXParser

20.66 NotesSession

20.67 NotesStream

20.68 NotesTimer

20.69 NotesUIDatabase

20.70 NotesUIDocument

20.71 NotesUIScheduler

20.72 NotesUIView

20.73 NotesUIWorkspace

20.74 NotesView

20.75 NotesViewColumn

20.76 NotesViewEntry

20.77 NotesViewEntryCollection

20.78 NotesViewNavigator

20.79 NotesXMLProcessor

20.80 NotesXSLTransfomer

Abbildungsverzeichnis

Listingverzeichnis

Tabellenverzeichnis

Stichwortverzeichnis