Propriétés de réacheminement des contenus

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.

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 :

# 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.

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 :

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 :

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 :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

  1. Ouvrez content_redir.properties avec un éditeur de texte. Par défaut, le fichier est installé dans l'emplacement suivant :
    Workplace XT : <emplacement_install>/FileNet/Config/WebClient
  2. Modifiez les propriétés selon vos désirs.
    • Pour supprimer un mappage de type MIME, mettez en commentaire la paire clé et valeur applicable en la faisant précéder du symbole #, par exemple, #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • Pour ajouter un mappage de type MIME, entrez une paire clé et valeur avec une clé correspondant à la valeur de propriété mimeType définie dans une classe de moteur de contenu Content Engine. La valeur doit indiquer un chemin d'accès à une page JSP ou à un servlet dans l'application, par rapport au répertoire d'applications.

      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.

    • Pour mapper un type MIME sur une application personnalisée ou du fournisseur, vous devez indiquer un composant avec une application assurant le réacheminement vers l'application externe. Par exemple, dans la paire de clé et valeur Workplace suivante, Workplace effectuera un réacheminement vers Workplace/redirect/customAppRedirect.jsp si un utilisateur a sélectionné un fichier avec le type MIME "text/x-speech".

      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.

  3. Sauvegardez content_redir.properties.
  4. Redémarrez le serveur Web pour que les nouveaux paramètres soient appliqués.