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.
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:
/WcmJavaViewer.jsp?{QUERY_STRING}
an. Weitere Informationen zu Image Viewer finden Sie in Mit Image Viewer arbeiten.{QUERY_STRING}
, enthalten. Die verfügbaren Makros sind in
content_redir.properties dokumentiert.
# 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
...
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.
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:
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:
#
aus, beispielsweise #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
.Ü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.
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.