Die URL-Adressierbarkeitsfunktion erteilt Benutzern direkten Zugriff auf Objekte, ohne die Notwendigkeit, in der IBM FileNet P8-Clientbenutzeroberfläche zu navigieren. Nachdem sich der Benutzer bei einem a FileNet P8-Client wie Workplace XT angemeldet hat, gibt er einfach die Objekt-URL in die Adressleiste eines Browsers ein. (Ein Administrator kann Lesezeichen oder Favoriten erstellen, um einen Ordner oder ein Objekt mit Versionsangabe abzurufen.)
Folgende Aktionen werden mit URL-Adressierbarkeit durchgeführt:
Eine pfadbasierte URL verwendet den Einschlusspfad, um die Position eines Objekts in einem Objektspeicher anzugeben. Wenn Sie beispielsweise ein Dokument namens Current Works abrufen wollen, das sich im Ordner Projects des Objektspeichers Transportation befindet, würden Sie eine ähnliche URL wie im folgenden Beispiel eingeben:
http://P8-Clientservername/Anwendungsname:Port/getContent/Transportation/Projects/Current+Works
Wenn Sie Objekte unter Verwendung pfadbasierter URLs abrufen wollen, müssen Sie die Sitevorgabe Pfadbasierte URLs verwenden verwenden.
Eine ID-basierte URL verwendet einen Global Unique Identifier (GUID), um die Position eines Objekts in einem Objektspeicher anzugeben. Die Position des Dokuments wird über die GUID des Objektspeichers, in dem sich das Dokument befindet, und über die GUID des Dokuments angegeben. Wenn Sie beispielsweise ein Dokument abrufen wollen, geben Sie eine ähnliche URL wie im folgenden Beispiel ein:
http://P8-Clientservername/Anwendungsname:Port/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}
Eine ID-basierte Adresse ist in der Regel schneller als eine pfadbasierte, jedoch kann nur eine pfadbasierte URL relative Referenzen innerhalb eines Dokuments auflösen. Wenn Sie beispielsweise die Datei "example.html" mit einer pfadbasierten URL anfordern, wird die Datei abgerufen und der Browser löst alle zusätzlich in 'example.html' erforderlichen URLs auf (wie die Tags <script>, <img> und <link>). Alle Links (<a href=...>) werden vom Browser aufgelöst, wenn der Benutzer die Links anklickt.
Die folgende Tabelle listet die Standardantworten auf die verschiedenen Objekttypen auf, die Sie in einer URL angeben können.
Objekttyp | Antwort |
---|---|
Ordner | Gibt eine Seite zurück, die den Ordnernamen anzeigt. |
Dokument | Wenn das Dokument Inhalt enthält, wird der Inhalt zurückgegeben. Enthält das Dokument eine externe Referenz, leitet der FileNet P8-Client den Client erforderlichenfalls um. Enthält das Dokument keinen Inhalt, gibt der FileNet P8-Client einen Fehler zurück. |
Workflowdefinition | Öffnet das Applet Process Designer. |
Gespeicherte Suche | Gibt eine Seite zurück, die den Namen der gespeicherten Suche anzeigt. |
Suchvorlage | Gibt eine Seite zurück, die die Suchvorlage anzeigt. |
Veröffentlichungsvorlage | Gibt den Inhalt der Veröffentlichungsvorlage im XML-Format zurück. |
Für eine pfadbasierte URL sind eine Objektspeicher-ID und ein Einschlusspfadname erforderlich. Der Parameter mode=download ist optional. Beispiel:
http://Server/Webanwendung/getContent/Objektspeicher-ID/Pfadname?mode=download
Dabei gilt Folgendes:
HINWEIS Pfadbasierte URLs für die Objekte Dokument, gespeicherte Suche, Suchvorlage und Veröffentlichungsvorlage verweisen stets auf die aktuelle Version.
Mit dieser URL wird die Workplace XT-Seite mit der angegebenen Suchvorlage angezeigt. Der Objektspeicher wird über den Namen (Forms) angegeben:
http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download
Über diese URL wird der Objektspeicher 'Forms' über seinen Domänennamen 'Midwest' qualifiziert:
http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download
Eine ID-basierte URL verwendet drei erforderliche Parameter für Abfragezeichenfolge für das Ordnerobjekt: objectStoreName, objectType und id. Beispiel:
http://Server/Webanwendung/getContent?objectStoreName={Objektspeicher-GUID}&objectType=Typ&id={Objekt-GUID}
Für die Objekte Dokument, gespeicherte Suche, Suchvorlage, Veröffentlichungsvorlage und Workflowdefinition verwendet die URL die Parameter objectStoreName, objectType, id und fsld. Der Parameter mode=download ist optional. Beispiel:
http://Server/Webanwendung/getContent?objectStoreName={Objektspeicher-GUID}&objectType=Typ&id={Objekt-GUID}&mode=download
oder
http://Server/Webanwendung/getContent?objectStoreName={Objektspeicher-GUID}&objectType=Typ&vsId={Versionsserien-GUID}
oder
http://Server/Webanwendung/getContent?objectStoreName={Objektspeicher-GUID}&objectType=Typ&id={Objekt-GUID}&vsId={Versionsserien-GUID}&mode=download
Dabei gilt Folgendes:
Für: | objectType= |
---|---|
Dokument | document |
Ordner | folder |
Gespeicherte Suche | storedsearch |
Suchvorlage | searchtemplate |
Workflowdefinition | document |
Veröffentlichungsvorlage | publishtemplate |
HINWEIS Wenn sowohl ID als auch vsld in der URL vorhanden sind, verwendet die FileNet P8-Clientanwendung die ID, um die angegebene Version abzurufen. Wird die angegebene Version nicht gefunden, gibt die FileNet P8-Clientanwendung einen Fehler zurück und bietet dem Benutzer die Option, die letzte Version, die im Parameter vsld angegeben ist, abzurufen.
HINWEIS Sie können die FileNet P8-Clientanwendung für die Verwendung von pfadbasierten URLs für Dokumentanforderungen konfigurieren. Das heißt, wenn Sie eine ID-basierte URL eingeben, konvertiert die FileNet P8-Clientanwendung die ID-basierte URL in eine pfadbasierte URL, sofern dies möglich ist, um die Integrität eventuell eingebetteter relativer URL-Referenzen im Dokumentinhalt zu erhalten.