IBM FileNet P8, Version 5.2            

Propriétés de réacheminement des contenus

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.

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


Commentaires

Dernière mise à jour : Mars 2013
aeadm_config_file_content_redir.htm

© Copyright IBM Corp. 2013.
Ce centre de documentation est doté de la technologie Eclipse. (http://www.eclipse.org)