Le fichier content_redir.properties configure les réacheminements vers les pages Workplace XT Java Server Pages (JSP) 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 la section Modification du fichier de propriétés de réacheminement.
Présentation du réacheminement de contenu
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 :
- Le premier groupe de paires clé/valeur mappe les types MIME sur Image Viewer. Pour bénéficier des fonctions d'annotation dans Image Viewer, vous pouvez éditer ce fichier pour indiquer les types d'image qui s'ouvrent dans Image Viewer. La liste répertorie les types MIME ouverts par Image Viewer, à savoir ceux avec la valeur /WcmJavaViewer.jsp?{QUERY_STRING}.
Pour plus d'informations sur Image Viewer, voir Utilisation d'Image Viewer.
- Les clés de content_redir.properties sont basées sur la propriété mimeType définie dans certaines classes de moteur de contenu.
Pour plus d'informations, consultez la rubrique à propos des types MIME.
- Une valeur peut inclure des macros, comme {QUERY_STRING}.
Les macros disponibles sont indiquées dans content_redir.properties.
- Si aucun type MIME n'est défini dans content_redir.properties, le servlet getContent est appelé et répond en fonction du type d'objet sélectionné. Voir la section Comportement par défaut du servlet getContent, ci-dessous.
- Pour les types d'objet document, le comportement de la fonction de réacheminement est en plus défini par certains paramètres à prendre en compte si vous modifiez content_redir.properties. Voir la section Interaction
avec les autres paramètres, ci-dessous.
# 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
...
Comportement par défaut du servlet getContent
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.
- Dossier
- Réachemine le client vers une page affichant le dossier.
- Document
- Si le document comporte un contenu, celui-ci est renvoyé au navigateur.
- Si le document contient une référence externe, le servlet réachemine le client de la manière appropriée.
- Si le document ne comporte pas de contenu, le système signale une erreur.
- Document de définition de flux de travaux
- Réachemine le client vers le concepteur de flux de travaux.
- recherche enregistrée
- Réachemine le client vers une page affichant la recherche enregistrée.
- Modèle de recherche
- Réachemine le client vers une page affichant le modèle de recherche.
- Modèle de publication
- Le contenu du modèle de publication est renvoyé au format XML.
Interaction avec les autres paramètres
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 :
- Si IgnoreRedirect est défini sur True, elle envoie le document au navigateur.
- Si IgnoreRedirect est défini sur False, elle envoie le document au composant spécifié dans content_redir.properties.
- Si IgnoreRedirect n'est pas défini (NULL), elle envoie le document au composant spécifié dans content_redir.properties.
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 "Yes". Si elle est définie sur "Yes", 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, voir Préférence Services externes.
Lors de l'ouverture d'images stockées dans Image Services, l'application effectue les actions suivantes :
- Si "Include Redirect = Yes" et la propriété de document IgnoreRedirect = true, l'application envoie l'image au navigateur.
- Si "Include Redirect = Yes" et la propriété de document IgnoreRedirect = false, l'application envoie l'image à la destination spécifiée dans content_redir.properties.
- Si "Include Redirect = No", le paramètre de propriété IgnoreRedirect n'est pas inclus dans l'URL et l'application envoie l'image à la destination spécifiée dans content_redir.properties.
Modification du fichier de propriétés de réacheminement
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 : 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.