Hinweis Ein Domino-URL-Befehl ist nicht dasselbe wie ein IBM® Lotus® Notes®-URL-Befehl. Domino-URL-Befehle nutzen eine Web-Browser-Schnittstelle zur Bedienung von Anwendungen. Notes-URL-Befehle hingegen verwenden die URL-Befehle zum Zugriff auf und zur Navigation in Anwendungen innerhalb eines Notes-Clients.

Die Domino-URL-Befehlssyntax

Domino-URL-Befehle verwenden folgende Syntax:

http://Host/DominoObject?Aktion&Argumente

wobei

• Host einem DNS-Eintrag oder einer IP-Adresse entspricht
• DominoObject einem Domino-Element (beispielsweise einer Datenbank, Ansicht, einem Dokument, einer Maske, einem Navigator, einem Agent usw.) entspricht. URL-Befehle für den Zugriff auf DominoObjects verwenden folgende Syntax: http://Host/Datenbank/DominoObject?Aktion&Argumente, wobei Datenbank der Datenbank entspricht, in der sich das DominoObject befindet.
• Aktion = die gewünschte Operation für das angegebene DominoObject (beispielsweise ?OpenDatabase, ?OpenView, ?OpenDocument, ?EditDocument, ?OpenForm usw.)
• Argumente = Ein Qualifizierer der Aktion (z. B. Count=10 in Kombination mit der Aktion ?OpenView begrenzt die in einer Ansicht angezeigten Zeilen auf 10).

• Domino-URLs verwenden nicht den Servernamen. Host bezeichnet den Server.
• Sie können die maximale Größe und andere Begrenzungen eines URL-Befehls im Serverdokument in Feldern des Registers "Internetprotokolle - HTTP" festlegen.
• Spezielle in Domino-URL-Befehlen verwendete Bezeichner sind: $defaultView, $defaultForm, $searchForm, $file, $icon, $help, $about und $first.
• DominoObject kann Folgendes sein: bei einer Datenbank der Datenbankname oder die Replik-ID; bei anderen Objekten der Name des DominoObject, die universelle ID oder ein spezieller Bezeichner. Um zum Beispiel eine Ansicht in einer URL anzugeben, können Sie Folgendes verwenden: den Namen der Ansicht, die Universal-ID der Ansicht oder $defaultView.
• Eine IBM® Lotus® Notes®-Datenbank kann durch ihren Dateinamen angegeben werden, z. B. "Diskussionen.nsf", oder durch Einfügen eines doppelten Unterstrichs vor und Hinzufügen der Erweiterung ".nsf" am Ende der Replik-ID. Zum Beispiel: __852562F3007ABFD6.nsf
• Der Name eines DominoObject und die Universal-ID sind in allen Repliken einer Datenbank identisch. Ein Name oder Alias kann auf zwei Objekte verweisen, zum Beispiel zwei Masken mit demselben Namen, wobei eine vor Notes-Benutzern und eine vor Webbenutzern verborgen ist.
• Aktion kann explizit oder implizit sein. Beispiele expliziter Aktionen sind ?OpenDatabase, ?OpenView, ?OpenDocument, ?OpenForm und ?EditDocument. Beispiele impliziter Aktionen sind ?Open, ?Edit und ?Delete. Wenn Sie keine Aktion angeben, verwendet Domino die Aktion ?Open.
• Um eine Benutzer-Authentifizierung anzufordern, hängen Sie das Login-Argument an eine beliebige Domino-URL an.
• Da URLs keine Leerzeichen enthalten dürfen, verwenden Sie das Pluszeichen(+) oder den Hex-Wert %20, um ein Leerzeichen darzustellen. Beispiel:

  http://www.mercury.com/diskussion.nsf/Nach+Autor

  http://www.mercury.com/diskussion.nsf/Nach%20Autor

• Wenn ein Name eine Mischung aus Leerzeichen und dem Pluszeichen "+" enthält, kann es erforderlich sein, %20 als Darstellung des Leerzeichens zu verwenden. Wenn der Schlüssel des Dokuments beispielsweise "Smith + Jones" lautet, dann funktionieren

  http://www.mercury.com/leads.nsf/ByCompany/Smith%20%2B%20Jones?OpenDocument

  und

  http://www.mercury.com/leads.nsf/ByCompany/Smith%20+%20Jones?OpenDocument

  aber

  http://www.mercury.com/leads.nsf/ByCompany/Smith+++Jones?OpenDocument

  nicht.

• Wenn ein Name oder ein Argument ein Symbol enthält, das nicht Teil der URL-Syntax ist und in Konflikt mit der URL-Syntax steht, beispielsweise Pluszeichen (+), Schrägstriche (\ oder /) oder Et-Zeichen (&), setzen Sie als Symbol %xx (wobei xx für den Hex-Ascii-Wert steht) ein. Beispielsweise öffnet die folgende URL das Dokument, das den Schlüsselwert "Smith&Jones, Inc." enthält:

  Http://www.mercury.com/leads.nsf/By%20Company/Smith%26Jones,%20Inc.?OpenDocument

• Schrägstriche und umgekehrte Schrägstriche in URL-Pfadkomponenten werden auch bei Verwendung eines Escape-Zeichens nicht unterschieden. (Dies liegt daran, weil beim ersten Schritt bei der URL-Verarbeitung alle Escape-Zeichen aufgelöst und '\' in '/' geändert werden.) Dies hat zur Folge, dass einige Namen mehrdeutig oder nicht adressierbar sind. Beispielsweise können die beiden Ansichten"a/b\c/d" und "a\b/c\d", die im Designer unterschiedlich sind, nicht eindeutig über eine URL adressiert werden.
• Dokumentschlüssel, die Schrägstriche und/oder umgekehrte Schrägstriche enthalten, sind mit folgenden Einschränkungen adressierbar:
  • Sie müssen die ?OpenDocument-Befehlsoption in die URL einfügen. Wenn der Dokumentschlüssel beispielsweise "Smith/Jones" lautet, wird das Dokument mit der folgenden URL gefunden:
  
  http://www.mercury.com/leads.nsf/ByCompany/Smith/Jones?OpenDocument

  Folgende URL führt aber zu dem Fehler "Fehler 404 - Eintrag im Index nicht gefunden":

  http://www.mercury.com/leads.nsf/ByCompany/Smith/Jones

  • Der Titel des in der Datenbank gespeicherten Dokuments muss entweder nur "/" oder nur "\" enthalten. Wenn er eine Mischung aus beiden Zeichen enthält, wird er nicht gefunden.
  • Das Verwenden von Schrägstrichen (beider Art) in Ansichtsnamen zusammen mit Schrägstrichen in Dokumenttiteln kann zu Mehrdeutigkeiten und somit zu "unerreichbaren" Dokumenten führen. Wenn eine Ansicht namens "a" vorhanden ist, die ein Dokument namens "b/c" enthält, und eine Ansicht namens "a\b" vorhanden ist, die das Dokument "c" enthält, öffnet die URL "/database.nsf/a/b/c?OpenDocument" das Dokument in der Ansicht "a/b".
  • Dokumenttitel, die mit dem Zeichen "/" oder "\" beginnen oder enden, werden nicht gefunden.
• Das Prozentzeichen ("%") ist auch bei Verwendung von Escape-Zeichen in einer URL nicht zulässig. Dies hilft, Angriffe zu verhindern, bei denen versucht wird, die Angriffsabsicht durch verschachtelte Escape-Zeichen zu verschleiern.
• Trennen Sie Argumente mit dem Et-Zeichen (&). Beispiel:

  http://www.mercury.com/projekt.nsf/Nach+Vertreter?OpenView&ExpandView

• Trennen Sie hierarchische Namen mit einem Schrägstrich (/). Um zum Beispiel eine Ansicht namens "Docs\Nach Autor" in einer Datenbank namens "Diskussion" zu öffnen, geben Sie Folgendes ein:

  http://www.mercury.com/diskussion.nsf/Docs/Nach+Autor

• Wenn Sie für Teile einer Anwendung Ihre eigene URL generieren, verwenden Sie so oft wie möglich einfache Aliasnamen, um URLs mit nicht unterstützten Zeichen zu vermeiden.
• URL-Befehle können auch auf Datenbanken mit den Suffixen .nsf4, nsf5, .nsf6 oder .box verweisen. Sie können auch auf Schablonendateien (.ntf) verweisen, diese Datenbanken können jedoch nur im Vorschaumodus geöffnet werden.
• Wenn Sie die Option "Webzugriff: JavaScript beim Erstellen von Seiten verwenden" in der InfoBox "Eigenschaften: Anwendung" auswählen, können Sie beim Klickereignis URLs berechnen, die an Schaltflächen und Hotspots angehängt sind. Ist diese Option deaktiviert, werden URLs, die an Schaltflächen und Hotspots angehängt sind, berechnet, wenn die Seite generiert wird. Das Aktivieren dieser Eigenschaft kann dann nützlich sein, wenn Sie bearbeitbare Felder in einer Maske verwenden.

URL-Befehle zum Öffnen von Server, Datenbanken und Ansichten
URL-Befehle zum Öffnen von Rahmengruppen
URL-Befehle zum Öffnen von Agenten, Masken und Navigatoren
URL-Befehle zum Erstellen, Löschen, Bearbeiten, Öffnen und Speichern von Dokumenten
URL-Befehle zum Öffnen von Dokumenten über Schlüssel
URL-Befehle zum Öffnen von Seiten
URL-Befehle zum Öffnen von Anhängen, Bilddateien und OLE-Objekten
URL-Befehle zur Suche nach Text
Schaltflächen "Weiter" und "Zurück" oder Hotspots mit Start- und Count-Parameter verwenden
URL-Befehle für erforderliche Authentifizierungen
URL-Befehle zur Verarbeitung von SSL-Zertifikaten

Glossar