IBM FileNet P8, Version 5.1.+            

Inhaltsumleitungseigenschaften

Die Datei content_redir.properties konfiguriert Umleitungen zu Workplace XT Java Server Pages (JSP) oder Servlets oder an benutzer- oder herstellerdefinierte Anwendungen, wenn ein Benutzer versucht, eine Datei in Workplace XT zu öffnen. Die Umleitungen basieren auf dem Inhalts-MIME-Typ. Dieser Abschnitt erläutert, wie Sie die Umleitungen anpassen. Der folgende Abschnitt erläutert, wie die Anwendung content_redir.properties verwendet. Im Abschnitt Umleitungseigenschaftendatei ändern finden Sie Informationen zum Anpassen von Umleitungen.

Übersicht über die Inhaltsumleitung

content_redir.properties besteht aus Schlüssel/Wert-Paaren, wobei der Schlüssel ein MIME-Typ ist und der Wert die Komponente angibt, die zum Öffnen einer Datei des zugehörigen MIME-Typs verwendet wird. Die folgende Auflistung ist für Image Viewer und wird hier als Beispiel verwendet. Das Beispiel kann auf andere Anwendungen angewendet werden. Berücksichtigen Sie beim Prüfen der Auflistung folgende Punkte:
  • Die erste Gruppe der Schlüssel/Wert-Paare ordnet Image Viewer MIME-Typen zu. Sie können die Anmerkungsfunktion in Image Viewer nutzen und die Datei bearbeiten, um anzugeben, welche Imagetypen in Image Viewer geöffnet werden. Sie Auflistung zeigt die MIME-Typen, die von Image Viewer geöffnet werden, mit dem Wert /WcmJavaViewer.jsp?{QUERY_STRING} an. In Mit Image Viewer arbeiten finden Sie weitere Informationen zu Image Viewer.
  • Schlüssel in content_redir.properties basieren auf der Eigenschaft mimeType, die in bestimmten Content Engine-Klassen definiert ist. Weitere Informationen finden Sie in Informationen zu MIME-Typen.
  • Ein Wert kann Makros, wie {QUERY_STRING}, enthalten. Die verfügbaren Makros sind in content_redir.properties dokumentiert.
  • Ist ein MIME-Typ nicht in content_redir.properties definiert, wird das Servlet getContent aufgerufen, das entsprechend dem ausgewählten Objekttyp antwortet. Weitere Informationen finden Sie nachstehend in Standardverhalten des Servlets getContent.
  • Für Dokumentobjekttypen wird das Umleitungsverhalten zusätzlich durch bestimmte Einstellungen definiert, die Sie berücksichtigen müssen, wenn Sie content_redir.properties ändern. Weitere Informationen finden Sie nachstehend in Interaktion mit anderen Einstellungen.
# Setzen die Zeilen mit MIME-Typen auf Kommentar, die nicht über das Applet Image Viewer geöffnet werden sollen
image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/jpg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/jpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/bmp=/WcmJavaViewer.jsp?{QUERY_STRING}
image/tiff=/WcmJavaViewer.jsp?{QUERY_STRING}
image/gif=/WcmJavaViewer.jsp?{QUERY_STRING}
application/x-cold=/WcmJavaViewer.jsp?{QUERY_STRING}
application/x-visio=/redirect/customAppRedirect.jsp?vsId={VERSION_SERIES_ID}&objectStoreName={OBJECT_STORE_NAME}&id={OBJECT_ID}&objectType=document

application/vnd.filenet.im-image=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-cold=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-form=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-other=/WcmJavaViewer.jsp?{QUERY_STRING}

folder=/WcmObjectBookmark.jsp
customobject=/integrationWebBasedCommand?_commandId=3010
showPropertiesCommand=/integrationWebBasedCommand?_commandId=3010
application/x-filenet-search=/WcmObjectBookmark.jsp
application/x-filenet-searchtemplate=/WcmObjectBookmark.jsp
application/x-filenet-workflowdefinition=/eprocess/WcmDesigner.jsp
application/x-filenet-scenariodefinition=/eprocess/WcmSimDesigner.jsp
...

Standardverhalten des Servlets getContent

Ist ein MIME-Typ in content_redir.properties nicht angegeben, ruft die Anwendung das Servlet getContent auf. Das Verhalten des Servlets hängt, wie nachfolgende aufgelistet, vom Typ des ausgewählten Objekts ab.
Ordner
Leitet den Client an eine Seite um, die den Ordner anzeigt.
Dokument
Wenn das Dokument Inhalt enthält, wird der Inhalt an den Browser zurückgegeben.
Enthält das Dokument eine externe Referenz, leitet das Servlet den Client entsprechend um.
Hat das Dokument keinen Inhalt, wird ein Fehler zurückgegeben.
Workflowdefinitionsdokument
Leitet den Client an den Workflowersteller um.
Gespeicherte Suche
Leitet den Client an eine Seite um, die die gespeicherte Suche anzeigt.
Suchvorlage
Leitet den Client an eine Seite um, die die Suchvorlage anzeigt.
Veröffentlichungsvorlage
Der Inhalt der Veröffentlichungsvorlage wird im XML-Format zurückgegeben.

Interaktion mit anderen Einstellungen

Neben den Einstellungen der Datei content_redir.properties beeinflusst auch eine ausgeblendete Eigenschaft von Dokumenttypobjekten, die Abbildungen einschließt, das Umleitungsverhalten. Diese ausgeblendete Eigenschaft mit der Bezeichnung IgnoreRedirect ist standardmäßig nicht gesetzt. Sie kann nur über das Programm oder Enterprise Manager gesetzt werden.

Beim Öffnen von Dokumenttypobjekten sucht die Anwendung nach der Eigenschaft IgnoreRedirect und führt die folgenden Aktionen aus:
  • Ist IgnoreRedirect auf True gesetzt, wird das Dokument an den Browser gesendet.
  • Ist IgnoreRedirect auf False gesetzt, wird das Dokument an die Komponente gesendet, die in content_redir.properties angegeben ist.
  • Ist IgnoreRedirect nicht gesetzt (NULL), wird das Dokument an die Komponente gesendet, die in content_redir.properties angegeben ist.

Für Dokumente, die in einer externen Bibliothek, wie Image Services, gespeichert sind, gibt es eine externe Service-Sitevorgabe namens Umleitung einbeziehen. Standardmäßig ist diese Vorgabe auf Ja gesetzt. Wenn sie auf Ja gesetzt ist, wird die URL mit der Einstellung der Eigenschaft IgnoreRedirect im Image hinzufügt. In Vorgaben für externe Services finden Sie weitere Informationen zu dieser Vorgabe.

Beim Öffnen von Abbildungen, die in Image Services gespeichert sind, führt die Anwendung die folgenden Aktionen aus:
  • Wenn Umleitung einbeziehen auf Ja gesetzt ist und die Dokumenteigenschaft IgnoreRedirect auf True gesetzt ist, sendet die Anwendung das Image an den Browser.
  • Wenn Umleitung einbeziehen auf Ja gesetzt ist und die Dokumenteigenschaft IgnoreRedirect auf False gesetzt ist, sendet die Anwendung das Image an das in content_redir.properties angegebene Ziel.
  • Wenn Umleitung einbeziehen auf Nein gesetzt ist, wird die Einstellung der Eigenschaft IgnoreRedirect nicht in die URL aufgenommen und die Anwendung sendet das Image an das in content_redir.properties angegebene Ziel.

Umleitungseigenschaftendatei ändern

Sie können die Umleitungen anpassen, indem Sie die Datei content_redir.properties ändern. So können Sie beispielsweise herstellerdefinierten Anwendungen Umleitungen hinzufügen oder vorhandene Umleitungen auf Kommentar setzen und es dem Servlet getContent ermöglichen, Objekte des auskommentierten MIME-Typs auszuführen.

Anmerkung: Überprüfen Sie vor dem Ändern von content_redir.properties die Eigenschaft IgnoreRedirect und die Sitevorgabe Umleitung einbeziehen auf die MIME-Typen, für die Sie Umleitungen definieren wollen.

So ändern Sie die Umleitungseigenschaftendatei:

  1. Öffnen Sie content_redir.properties mit einem Texteditor. Die Datei wird standardmäßig an folgender Position installiert:
    Workplace XT: <Installationspfad>/FileNet/Config/WebClient
  2. Ändern Sie die Eigenschaften wie gewünscht.
    • Wenn Sie eine vorhandene MIME-Typ-Zuordnung entfernen wollen, kommentieren Sie das entsprechende Schlüssel/Wert-Paar mit dem vorangestellten Symbol # aus, beispielsweise #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • Wenn Sie eine MIME-Typ-Zuordnung hinzufügen wollen, geben Sie ein Schlüssel/Wert-Paar ein, wobei der Schlüssel einem Eigenschaftswert mimeType entsprechen muss, der in einer Content Engine-Klasse definiert ist. Der Wert muss einen Pfad zu einer JSP-Seite oder einem Servlet in der Anwendung, relativ zum Anwendungsverzeichnis, angeben.

      Über Makros können Sie die URL-Abfragezeichenfolge des ausgewählten Objekts an die im Schlüssel/Wert-Paar angegebene Komponente übergeben. So können Sie beispielsweise das Makro {QUERY_STRING} einschließen, um die gesamte Abfragezeichenfolge zu übergeben. Sie können aber auch einzelne Parameter aus der Abfragezeichenfolge über {OBJECT_TYPE}, {OBJECT_ID} und andere Makros übergeben. In der Datei content_redir.properties finden Sie eine vollständige Liste der Makros.

    • Wenn Sie einer hersteller- oder benutzerdefinierten Anwendung einen MIME-Typ zuordnen wollen, müssen Sie eine Komponente in der Anwendung angeben, die an die externe Anwendung umleitet. In der folgenden Kombination aus Workplace-Schlüssel und -Wert würde Workplace z. B. zu Workplace/redirect/customAppRedirect.jsp umleiten, wenn ein Benutzer eine Datei mit dem MIME-Typ "text/x-speech" ausgewählt hat.
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      Für die Umleitung an eine externe Anwendung kann der JSP-Umleitungscode so einfach wie in der folgenden Zeile aussehen.
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      In der Regel ist die Umleitungslogik an eine externe Anwendung jedoch komplexer und verwendet dieselben Basis-APIs wie Workplace XT, damit die URL, die Parameter, das Sicherheitstoken und alle anderen Werte zurückgegeben werden, die für die externe Anwendung erforderlich sind.

  3. Speichern Sie content_redir.properties.
  4. Starten Sie den Web-Server erneut, damit die neuen Einstellungen wirksam werden.


Feedback

Letzte Aktualisierung: Juli 2011


© Copyright IBM Corp. 2011.
Dieses Information Center basiert auf Eclipse-Technologie. (http://www.eclipse.org)