Lotus Domino Designer 8.5 Hilfe - Eine DAV erstellen

DB2-ZUGRIFFSANSICHTEN

Eine DAV erstellen
1. Öffnen Sie in IBM® Lotus® Domino(TM) Designer die IBM® Lotus® Notes® DB2-Datenbank, für die Sie eine DAV erstellen möchten.

2. Wählen Sie im Anwendungsnavigator "Daten - DB2-Zugriffsansichten".

3. Doppelklicken Sie auf das Gestaltungselement "DB2-Zugriffsansichten".

4. Klicken Sie auf "Neue DB2-Zugriffsansicht". Das Fenster "Neue DB2-Zugriffsansicht" wird angezeigt.

5. Geben Sie einen Namen für die Ansicht ein.

6. Wählen Sie die Maske und die Ansicht, die mit der DB2-Zugriffsansicht verknüpft werden soll, und klicken Sie auf "OK". Die InfoBox "DB2-Zugriffsansicht" wird angezeigt.

7. Geben Sie die in der DAV zu verwendenden Felder (Spalten) an. Wählen Sie eine der folgenden Optionen:

Feld wählen

- um ein Element aus den vorhandenen Gestaltungselementen auszuwählen.

Wählen Sie im Feld "Typ" das Gestaltungselement, das als Feldquelle verwendet werden soll, oder wählen Sie "Alle". Alle Instanzen der ausgewählten Feldquellen werden nun im Listenfeld auf der linken Seite angezeigt.

Hinweis

Als Neuerung in Version 8 gehören auch spezielle #-Felder zu den Feldtypen. Diese Kategorie schließt bereits früher verfügbare Metadaten ein, die im Register "Erweitert" der DAV-Eigenschaften ausgewählt wurden, sowie neue Lotus Notes- und DB2-Metadaten.

Wählen Sie die zur DAV hinzuzufügenden Felder aus, indem Sie eine Feldquelle markieren. Die Felder werden im Listenfeld auf der rechten Seite angezeigt.
Wählen Sie alle Felder, die in die DAV aufgenommen werden sollen.
Wiederholen Sie diese Schritte für alle erforderlichen Feldquellen.

Feld einfügen

- um in der DAV ein leeres Feld hinzuzufügen, in das Sie einen vorhandenen bzw. noch zu erstellenden Feldnamen aus einer mit der DAV verknüpften Maske eingeben können.

8. Legen Sie die Eigenschaften für die einzelnen Felder fest, indem Sie auf das Feld doppelklicken und im Dialogfeld "Eintrag in Zugriffsansicht" die folgenden Felder ausfüllen:

Feld	Aktion
Feldname	Geben Sie den Feldnamen an, wenn Sie ein neues Feld hinzufügen. Dies ist der Feldname, der mit der entsprechenden DB2-Spalte in der DAV übereinstimmt. Es muss daher der tatsächliche Name eines Feldes sein, das im Dokument angezeigt wird (anderenfalls würde kein übereinstimmendes Feld gefunden und die Spalte in der DB2-Ansicht wäre leer.) Hinweis Wenn Sie die Felder für die DAV mit der Option "Feld wählen" ausgewählt haben, können Sie die Feldnamen in den Eigenschaften ändern. Wenn Sie die Feldnamen jedoch ändern und diese nicht mehr mit dem Feldnamen im Dokument übereinstimmen, ist die entsprechende Spalte in der DB2-Ansicht leer.
Notes-Datentyp	Geben Sie den Notes-Datentyp für dieses Feld an Hinweis Formeln, Rich Text und Rich-Text-Light Notes-Datentypen werden für die Verwendung in DAVs nicht unterstützt.
DB2-Datentyp	Geben Sie den DB-Datentyp für dieses Feld an Notes zeigt einen Vorgabewert an, der dem ausgewählten Notes-Datentyp entspricht. Hinweis Wenn Sie in der DAV eine Ganzzahl definiert haben und aus DB2 eine reelle Zahl (mit einer Dezimalstelle) eingefügt wird, der Dezimalwert auf eine Ganzzahl gekürzt.
DB2-Indexfeld erstellen	Erstellt diese Spalte als DB2-Indexfeld, welches den Datenbankdatensatz für ein schnelles Abrufen mit einem Schlüssel versieht.
Kürzung von Notes-Daten zulassen	Legt fest, dass die DB2-Ansicht die Notes-Daten kürzen kann (und nur Zeichen der entsprechenden DB2-Spaltenlänge anzeigt)
Mehrfachwerte speichern als Hinweis: Diese Option ist nur für Mehrfachwertfelder aktiviert.	Wenn ein Notes-Feld mehrere Werte hat, können Sie Folgendes wählen: nur den ersten Wert im Feld getrennte Werte. Bei Mehrfachwertfeldern können alle Datenwerte als getrennter Text angezeigt werden.
DB2-Trennzeichen für Mehrfachwerte	Wenn Sie in diesem Feld getrennte Werte verwenden, müssen Sie das verwendete Trennzeichen angeben. Das Trennzeichen wird verwendet, um Mehrfachwerte in der DB2-Spalte und DB2-INSERT oder -UPDATES in einzelne Werte zu trennen. Es ist nicht mit dem Trennzeichen zu verwechseln, das in der vom Notes-Client verwendeten Maskengestaltung angegeben ist. Die Vorgabe ist ein Semikolon.
DB2-Spaltenlänge	In diesem Feld geben Sie die Spaltenlänge in DB2 an (tatsächliche Feldlänge in Notes). Dies ist nur für Spalten erforderlich, die dem DB2-Varchar-Datentyp zugeordnet werden (alle anderen Typen haben eine feste Länge). Der Vorgabewert für Varchar ist 100.

Hinweis

Sie können die Reihenfolge der Felder in der Ansicht ändern, indem Sie sie per Drag & Drop an die gewünschte Position ziehen. So können Sie beispielsweise Felder, auf die häufig zugegriffen wird, am Anfang der Ansicht positionieren.

9. Klicken Sie auf "Gestaltung - DB2-Zugriffsansichten", um die Eigenschaften für die DAV festzulegen. Füllen Sie im Dialogfeld "DB2-Zugriffsansicht" die folgenden Felder aus:

Feld	Aktion
Name	Geben Sie einen Namen für die DAV ein. Dies ist der tatsächliche Name der DB2-Ansicht, bei dem es sich um einen gültigen DB2-Ansichtsnamen handeln muss. Wenn der Name Leerzeichen enthält, werden diese in DB2 in Unterstriche konvertiert.
Kommentar	Geben Sie Informationen zur DAV ein.
Masken wählen, die mit dieser DB2-Zugriffsansicht verknüpft sind	Geben Sie die Zeilenauswahlkriterien an, indem Sie einen der folgenden Schritte ausführen: Wählen Sie "Alle Masken", wenn alle Masken in der Datenbank mit der DAV verknüpft werden sollen. Jedes Datendokument in der NSF-Datenbank entspricht einer Zeile in der Zugriffsansicht. Wählen Sie im Listenfeld die einzelnen Masken aus, die mit der DAV verknüpft werden sollen. DB2 ermittelt anhand dieser Liste die Daten, mit denen die DAV gefüllt wird. In der Ansicht werden nur Datendokumente angezeigt, die ein FORM-Element haben, das den ausgewählten Werten entspricht.

10. Legen Sie die Optionen für das Hinzufügen der DB2-Daten zur DAV fest:

Feld	Aktion
Maske berechnen bei DB2-Insert oder -Update	Aktivieren Sie diese Option, wenn die ausgewählten Masken berechnete Felder enthalten und die Formeln berechnet werden sollen, wenn das Dokument mit SQL erstellt oder aktualisiert wird.
Vorgabemaske für DB2-Insert-Anweisungen	DB2-Benutzer können, vorausgesetzt sie besitzen die dazu erforderlichen Berechtigungen, Daten in der DAV einfügen, aktualisieren und löschen. Sie können diese Operationen jedoch nur in einer Maske ausführen, die in der DAV-Definition angegeben ist. Dies gilt auch dann, wenn mehrere Masken ausgewählt sind. Geben Sie die Maske an, die für das Hinzufügen, Aktualisieren und Löschen von DB2-Daten verwendet werden soll.

11. Legen Sie die DAV-Optionen im Register "Erweitert" fest:

Feld

Aktion

Bei Zeitzonenkonvertierungen zu GMT normalisieren

Wählen Sie diese Option, um alle Datums- und Zeitangaben in der DB2-Ansicht standardmäßig in GMT anzuzeigen. Dies ist besonders hilfreich für verteilte DB2-Anwendungen, auf die Benutzer in unterschiedlichen Zeitzonen zugreifen.

Hinweis Diese Einstellung betrifft nur Spalten, die Datum-/Uhrzeitfeldern im Dokument zugeordnet sind. Spezielle Felder (z. B. #CREATED) werden in DB2 immer in GMT geschrieben.

Hinweis In Version 8 sind die Optionen zur Auswahl von #UNID, #OID und der Geändert-Uhrzeit keine erweiterten Optionen mehr. Sie werden als spezielle Felder ausgewählt, wenn andere Felder ausgewählt werden.

12. Speichern Sie die Ansicht.

13. (Optional - Empfohlen) Klicken Sie auf "Überprüfen". Das Überprüfen der DAV stellt sicher, dass die Definition die Mindestanforderungen einer gültigen DAV-Ansicht erfüllt, und bietet Ihnen eine Möglichkeit, die Gültigkeit der Zugriffsansichtsdefinition aus dem DAV-Designer heraus schnell zu überprüfen.

14. Schließen Sie die Ansicht.

15. Klicken Sie im DAV-Arbeitsfenster auf "In DB2 erstellen/aktualisieren".

16. Klicken Sie auf "Füllen in DB2". Die Ansicht wird mit den Felddaten gefüllt.

Hinweise:

Die Populate-Task ist eine asynchrone Server-Task. Der Fortschritt der Task-Verarbeitung wird nicht angezeigt. Klicken Sie auf "Liste aktualisieren", um den Task-Status zu überprüfen.

Das Füllen einer DAV mit umfangreichen Daten kann viel Zeit und Serverressourcen in Anspruch nehmen. Wenn Sie eine DAV für eine große Datenbank erstellt haben, sollten Sie die Ansicht außerhalb der Arbeitszeit füllen.

Das Füllen der DAV mit Daten ist ein einmaliges Ereignis. Wenn die Ansicht mit Daten gefüllt wurde, wird sie mithilfe normaler Dokument- und DB2-Aktualisierungen synchron gehalten.

Spezielle Felder für die DAV

Als Neuerung in Version 8 ist ein weiter Bereich von Metadaten über die Notes-Datenbank, die bisher nur über die Notes-Formelsprache zugänglich waren, auch für die DAV verfügbar. Metadaten über die DAV selbst sind ebenfalls verfügbar.

Feldname Beschreibung Typ Gespeichert

#ADDEDTOFILE Datum, an dem ein Dokument zu dieser Datenbank hinzugefügt wurde Zeitstempel Y

#CREATED Wie @Created Zeitstempel Y

#DATABASE NSF-Name Varchar N

#DBPATH Vollständiger Pfad und NSF-Name Varchar N

#MODIFIED Wie @Modified Zeitstempel Y

#OID Notes-OID für jedes Dokument Varchar Y

#PUBLICACCESS Notes für öffentlichen Zugriff aktivieren Varchar bit N

#REF Von $Ref Varchar bit Y

#REPLICAID Replik-ID Varchar bit N

#RESPINFO ID des übergeordnete Dokumentes, gefolgt von der Anzahl der untergeordneten Dokumente, gefolgt von einer Liste der IDs der untergeordneten Dokumente Long Varchar Y

#SEQUENCENUMBER OID-Folge Ganzzahl Y

#SERVER Server-CN Varchar N

#UNID Notes-UNID für jedes Feld Varchar Y

Die Werte für spezielle Felder, die auf individuelle Dokumente Anwendung finden, werden in der DAV-Tabelle gespeichert. Spezielle Felder, die auf die Datenbank oder die DAV als Ganzes Anwendung finden, werden nicht in der DAV-Tabelle gespeichert. Statt dessen werden ihre Werte in der Ansichtsdefinition codiert. Ungespeicherte Spalten können aus der Ansicht abgefragt und als Teil einer SELECT-Anweisung in der SQL-Formel der Abfrageansicht aufgenommen werden. Ungespeicherte Spalten sind nicht verfügbar, wenn auf die Zugriffstabelle direkt zugegriffen wird.

Einige der speziellen Felder führen zusätzliche Modifikationen an den zugrunde liegenden Dokumenten durch.

SELECT #NOTEID in der SQL-Formel der Abfrageansicht ermöglicht das Öffnen eines Dokuments durch Doppelklick auf den Ansichtseintrag.

Geben Sie das spezielle Feld #OID in der DAV-Definition und SELECT #OID in der SQL-Formel der Abfrageansicht an, um Folgendes zu aktivieren.

Dokumentlink für Dokumente in der Abfrageansicht aktivieren.
Kopieren als Tabelle aktivieren.
"Pfeilsymbole" aktivieren (gemeinsam mit #REF).

#REF in der DAV-Formel erstellt ein $REF-Element auf das Dokument.

#RESPINFO in der DAV-Formel legt Informationen zum Haupt- und Antwortdokument fest.

Geben Sie das spezielle Feld #PUBLICACCESS in der DAV-Definition und SELECT #PUBLICACCESS in der SQL-Formel der Abfrageansicht an, um den öffentlichen Notes-Zugriff in Abfrageansichten zu aktivieren.

Zeitstempel werden einheitlich in GMT angezeigt.

Hinweise zur Versionskompatibilität:

In 7.0 wird die Spalte #UNID als 16-Bit-Binärwert geschrieben. In 8.0 wird sie als 32-Bit-Zeichenfolge geschrieben, die direkt in Funktionen wie z. B. getDocumentByUNID() verwendet werden kann.
In 7.0 war die erweiterte Eigenschaft für #MODIFIED ein interner Wert, der nicht mit der Funktion @Modified gleichzusetzen war. In 8.0 wurde dieser interne Wert in #DB2MODIFIED umbenannt und kann nicht mehr in der Zugriffsansicht offengelegt werden. Das neue spezielle Feld #MODIFIED ist mit der Funktion @Modified gleichzusetzen.
Vorhandene DAV-Definitionen werden automatisch in den 8.0-Stil konvertiert (Version 3.1), wenn sie im 8.0-Designer geöffnet werden. Die alten erweiterten Eigenschaften für #OID und #UNID werden in das neue spezielle Feldformat konvertiert.
Vorhandene DB2-Zugriffsansichten werden weiterhin wie gehabt funktionieren. Sie werden nicht aktualisiert, bis die DAV in DB2 gelöscht und neu erstellt ist.
In Version 8.0 wurde die Beschränkung auf die Anzahl der DAV-Spalten aufgehoben. Domino verwendet einen zusätzlichen Pufferpool mit einer Seitengröße von 32 KB (genannt DOMINO_TMP32) und einen temporären Tabellenbereich (genant DOMINO_STMP32), wobei DOMINO der Name des Hauptschemas des Servers ist.

DAV-Status anzeigen

Die folgenden Symbole zeigen den Status der DAV, die Sie gerade erstellen:

DB2-Zugriffsansicht - Neue Ansicht : Ansichtssymbol mit einem Stern
DB2-Zugriffsansicht - Erstellt und leer: Normales Ansichtssymbol
DB2-Zugriffsansicht - Schreibgeschützt: Durchgestrichenes Symbol mit einem Stift
DB2-Zugriffsansicht - Warnnachrichten: Symbol mit gelben Dreieck und Ausrufezeichen
DB2-Zugriffsansicht - Erfolgreich erstellt und gefüllt: Symbol mit Häkchen

Siehe auch

DAVs verwalten

DB2-Zugriffsansichten

Glossar

Ihre Kommentare zur Hilfe oder zur Verwendbarkeit der Software?

Hilfe zur Hilfe

Inhalt der gesamten Hilfe

Glossar

Feldname	Beschreibung	Typ	Gespeichert
#ADDEDTOFILE	Datum, an dem ein Dokument zu dieser Datenbank hinzugefügt wurde	Zeitstempel	Y
#CREATED	Wie @Created	Zeitstempel	Y
#DATABASE	NSF-Name	Varchar	N
#DBPATH	Vollständiger Pfad und NSF-Name	Varchar	N
#MODIFIED	Wie @Modified	Zeitstempel	Y
#OID	Notes-OID für jedes Dokument	Varchar	Y
#PUBLICACCESS	Notes für öffentlichen Zugriff aktivieren	Varchar bit	N
#REF	Von $Ref	Varchar bit	Y
#REPLICAID	Replik-ID	Varchar bit	N
#RESPINFO	ID des übergeordnete Dokumentes, gefolgt von der Anzahl der untergeordneten Dokumente, gefolgt von einer Liste der IDs der untergeordneten Dokumente	Long Varchar	Y
#SEQUENCENUMBER	OID-Folge	Ganzzahl	Y
#SERVER	Server-CN	Varchar	N
#UNID	Notes-UNID für jedes Feld	Varchar	Y