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:

# Kommentieren Sie die Zeilen mit MIME-Typen, 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.

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 dem Namen "IgnoreRedirect" wird nicht standardmäßig 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:

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. Ist sie auf "Ja" gesetzt, wird der URL die Eigenschaftseinstellung 'IgnoreRedirect' für die Abbildung angehängt. Weitere Informationen zu dieser Vorgabe, finden Sie in Externe Sitevorgaben.

Beim Öffnen von Abbildungen, die in Image Services gespeichert sind, führt die Anwendung die folgenden Aktionen aus:

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 auskommentieren und es dem Servlet getContent ermöglichen, Objekte des auskommentierten MIME-Typs auszuführen.

HINWEIS  Bevor Sie die Datei content_redir.properties ändern, müssen Sie die Eigenschaft 'IgnoreRedirect' und die Sitevorgabe "Umleitung einbeziehen" für die MIME-Typen prüfen, 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. So leitet im folgenden Schlüssel/Wert-Paar Workplace an Workplace/redirect/customAppRedirect.jsp um, wenn ein Benutzer eine Datei mit dem MIME-Typ "text/x-speech" auswählt.

      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.