Le fichier content_redir.properties configure les réacheminements vers les pages Workplace XT JSP (Java Server Pages) ou les servlets, ou vers les applications personnalisées ou du fournisseur, lorsqu'un utilisateur tente d'ouvrir un fichier depuis Workplace XT. Les réacheminements sont basés sur le type MIME du contenu. La présente rubrique indique comment personnaliser les réacheminements. La section suivante explique l'utilisation de content_redir.properties par l'application. Pour personnaliser les réacheminements, voir Modification du fichier de propriétés de réacheminement.
Le fichier content_redir.properties comprend des paires clé/valeur, où la clé est un type MIME et la valeur indique le composant à utiliser pour ouvrir un fichier du type MIME associé. La liste ci-dessous s'applique à Image Viewer et est fournie ici à titre d'exemple. Cet exemple peut être utilisé pour d'autres applications. En examinant la liste, prenez note des points suivants :
/WcmJavaViewer.jsp?{QUERY_STRING}
. Pour plus d'informations sur Image Viewer, voir Utilisation d'Image Viewer.{QUERY_STRING}
. Les macros disponibles sont indiquées dans content_redir.properties.
# Indiquez en commentaire que les lignes avec les types MIME ne doivent pas être ouvertes avec l'applet Image Viewer
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
...
Si aucun type MIME n'est défini dans content_redir.properties, l'application appelle le servlet getContent. Le comportement du servlet est déterminé par le type d'objet sélectionné, comme indiqué ci-dessous.
En plus des paramètres du fichier content_redir.properties, une propriété masquée sur les objets de type document et incluant des images affecte le comportement de la fonction de réacheminement. Cette propriété masquée appelée "IgnoreRedirect" n'est pas définie par défaut. Elle peut être définie uniquement à l'aide d'un programme ou d'Enterprise Manager.
Lors de l'ouverture d'objets de type document, l'application surveille la propriété IgnoreRedirect et effectue les actions suivantes :
Pour les documents stockés dans une bibliothèque externe, comme Image Services, il existe une préférence de site de service externe appelée "Include Redirect". Par défaut, cette préférence est définie sur "Oui". Si elle est définie sur "Oui", l'URL est ajoutée avec le paramètre de la propriété IgnoreRedirect sur l'image. Pour plus d'informations sur cette préférence, consultez la rubrique sur les préférence de site externes.
Lors de l'ouverture d'images stockées dans Image Services, l'application effectue les actions suivantes :
Vous pouvez personnaliser les réacheminements en modifiant content_redir.properties. Par exemple, vous pouvez ajouter des réacheminements à des applications du fournisseur ou mettre en commentaire les réacheminements existants et autoriser le servlet getContent à gérer les objets du type MIME mis en commentaire.
REMARQUE :contenu Avant de modifier content_redir.properties, recherchez dans la propriété IgnoreRedirect et la préférence de site "Include Redirect" les types MIME pour lesquels vous souhaitez définir les réacheminements.
Modification du fichier de propriétés de réacheminement
#
, par exemple, #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
.A l'aide de macros, vous pouvez transmettre la chaîne de requête d'URL de l'objet sélectionné au composant spécifié dans la paire clé et valeur. Par exemple, vous pouvez inclure la macro {QUERY_STRING}
pour transmettre toute la chaîne de requête. Vous pouvez également transmettre des paramètres pris séparément de la chaîne de requête avec {OBJECT_TYPE}
, {OBJECT_ID}
et d'autres macros. Consultez le fichier content_redir.properties pour connaître la liste complète de macros.
text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
Pour le réacheminement vers une application externe, le code de réacheminement JSP peut être aussi simple que la ligne suivante.
<%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>
Cependant, la logique de réacheminement vers une application externe est plus impliquée, optimisant les mêmes API de base que Workplace XT, pour renvoyer l'URL, les paramètres, le jeton de sécurité et les autres valeurs requises par l'application externe.