IBM FileNet P8, Versión 5.2            

Propiedades de redirección de contenidos

El archivo content_redir.properties configura los redireccionamientos a Java Server Pages (JSP) o servlets de Workplace XT, o a aplicaciones personalizadas o de proveedores, cuando un usuario intenta abrir un archivo desde el interior de Workplace XT. Las redirecciones se basan en el tipo MIME del contenido. En este tema se muestra cómo puede personalizar las redirecciones. En la siguiente sección se explica cómo la aplicación utiliza content_redir.properties. Para personalizar las redirecciones, consulte el apartado Modificar el archivo de propiedades de redirección.

Visión general de la redirección de contenido

El archivo content_redir.properties consiste en pares clave/valor, en los que la clave es un tipo MIME y el valor especifica el componente que se debe utilizar para abrir un archivo del tipo MIME asociado. La siguiente lista es para el Visor de imágenes y se utiliza aquí como ejemplo. El ejemplo puede aplicarse a otras aplicaciones. Al examinar el listado, observe los siguientes puntos:
  • El primer grupo de pares clave/valor correlaciona tipos MIME con el Visor de imágenes. Para aprovechar la característica de anotaciones del Visor de imágenes, puede editar este archivo para especificar qué tipos de archivo se abren en el Visor de imágenes. El listado muestra que los tipos MIME que se abren con el Visor de imágenes son los que tienen un valor de /WcmJavaViewer.jsp?{QUERY_STRING}. Consulte Trabajar con el Visor de imágenes para obtener más información sobre Image Viewer.
  • Las claves de content_redir.properties se basan en la propiedad mimeType definida en ciertas clases de Content Engine. Consulte Acerca de los tipos MIME para obtener más información.
  • Un valor puede incluir macros, como por ejemplo {QUERY_STRING}. Las macros disponibles se documentan en content_redir.properties.
  • Si no se define un tipo MIME en content_redir.properties, se invoca al servlet getContent y responde de acuerdo con el tipo de objeto seleccionado. Consulte el tema Comportamiento predeterminado del servlet getContent, a continuación.
  • Para los tipos de objeto de documento, el comportamiento de la redirección se define adicionalmente mediante ciertos valores, que debe tener en cuenta si modifica content_redir.properties. Consulte el tema Interacción con otros valores, a continuación.
# Comment the lines with MIME types to not be opened by the Image Viewer applet
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.jspcustomobject=/integrationWebBasedCommand?_commandId=3010showPropertiesCommand=/integrationWebBasedCommand?_commandId=3010application/x-filenet-search=/WcmObjectBookmark.jspapplication/x-filenet-searchtemplate=/WcmObjectBookmark.jspapplication/x-filenet-workflowdefinition=/eprocess/WcmDesigner.jspapplication/x-filenet-scenariodefinition=/eprocess/WcmSimDesigner.jsp...

Comportamiento predeterminado del servlet getContent

Si no se especifica un tipo MIME en content_redir.properties, la aplicación invoca al servlet getContent. El comportamiento del servlet viene determinado por el tipo de objeto seleccionado, como figura a continuación.
Carpeta
Redirecciona el cliente a una página que muestra la carpeta.
Documento
Si el documento tiene contenido, se devuelve el contenido al navegador.
Si el documento tiene una referencia externa, el servlet redirige al cliente de forma adecuada.
Si el documento no tiene contenido, se informa de un error.
Documento de definición de flujo de trabajo
Redirecciona el cliente al diseñador de flujos de trabajo.
Búsqueda almacenada
Redirecciona el cliente a una página que muestra la búsqueda almacenada.
Plantilla de búsqueda
Redirecciona el cliente a una página que muestra la plantilla de búsqueda.
Plantilla de publicación
El contenido de la plantilla de publicación se devuelve como XML.

Interacción con otros valores

Además de los valores del archivo content_redir.properties, una propiedad oculta en los objetos de tipo de documento, que incluyen las imágenes, afectan al comportamiento de redirección. Esta propiedad oculta, llamada "IgnoreRedirect" no se establece por omisión. Solamente puede establecerse programáticamente o a través de Enterprise Manager.

Al abrir objetos de tipo de documento, la aplicación mira la propiedad IgnoreRedirect y efectúa las siguientes acciones:
  • Si IgnoreRedirect se establece en True, envía el documento al navegador.
  • Si IgnoreRedirect se establece en False, envía el documento al componente especificado en content_redir.properties.
  • Si IgnoreRedirect no se ha establecido (NULL), envía el documento al componente especificado en content_redir.properties.

Para los documentos almacenados en una biblioteca externa, como por ejemplo Image Services, existe una preferencia de sitio de servicio externo llamada "Include Redirect". De forma predeterminada, esta preferencia se establece en "Yes". Si se establece en "Yes", se añade el URL al valor de la propiedad IgnoreRedirect en la imagen. Consulte Preferencias de servicios externos para obtener más información sobre esta preferencia.

Al abrir imágenes almacenadas en Image Services, la aplicación efectúa las siguientes acciones:
  • Si "Include Redirect" = Yes y la propiedad del documento IgnoreRedirect = true, la aplicación envía la imagen al navegador.
  • Si "Include Redirect" = Yes y la propiedad del documento IgnoreRedirect = false, la aplicación envía la imagen al destino especificado en content_redir.properties.
  • Si "Include Redirect" = No, el valor de la propiedad IgnoreRedirect no se incluye en el URL y la aplicación envía la imagen al destino especificado en content_redir.properties.

Modificación del archivo de propiedades de redirección

Puede personalizar las redirecciones modificando content_redir.properties. Por ejemplo, puede añadir redirecciones a aplicaciones de proveedor, o descomentar redirecciones existentes para permitir que el servlet getContent pueda manejar objetos del tipo MIME descomentado.

Nota: Antes de modificar content_redir.properties, compruebe la propiedad IgnoreRedirect y la preferencia de sitio Incluir redirección de los tipos MIME para los que desea definir las redirecciones.

Para modificar el archivo de propiedades de redirección

  1. Abra content_redir.properties con un editor de texto. Por omisión, el archivo se instala en la siguiente ubicación:
    Workplace XT: <ubicación_instalación>/FileNet/Config/WebClient
  2. Modifique las propiedades a su conveniencia.
    • Para eliminar una correlación de tipo MIME existente, comente el par clave/valor aplicable con un símbolo inicial de #; por ejemplo, #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • Para añadir una correlación de tipo MIME, entre un par clave/valor, con una clave que corresponda a un valor de propiedad mimeType definido en una clase de Content Engine. El valor debe especificar una vía de acceso a una página JSP o servlet de la aplicación, relativa al directorio de la aplicación.

      Utilizando macros, puede pasar la serie de consulta URL del objeto seleccionado al componente especificado en el par clave/valor. Por ejemplo, puede incluir la macro {QUERY_STRING} para pasar toda la serie de consulta. También puede pasar parámetros individuales de la serie de consulta con {OBJECT_TYPE}, {OBJECT_ID} y otras macros. Consulte el archivo content_redir.properties para obtener una lista completa de macros.

    • Para correlacionar un tipo MIME con un proveedor o aplicación personalizada, debe especificar un componente de la aplicación que redireccione a la aplicación externa. Por ejemplo, en el siguiente par clave y valor de Workplace, Workplace se redireccionaría a Workplace/redirect/customAppRedirect.jsp si un usuario seleccionara un archivo con un tipo MIME de "text/x-speech".
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      Para redirigira un aplicación externa, el código de redirección JSP puede ser tan sencillo como la siguiente línea.
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      No obstante, por lo general la lógica de redirección a una aplicación externa es más compleja y utiliza las mismas API base que Workplace XT para devolver los parámetros, la señal de seguridad y los demás valores necesarios para la aplicación externa.

  3. Guarde content_redir.properties.
  4. Reinicie el servidor web para que los nuevos valores entren en vigor.


Comentarios

Última actualización: Marzo de 2013
aeadm_config_file_content_redir.htm

© Copyright IBM Corp. 2013.
Este centro de información utiliza tecnología Eclipse. (http://www.eclipse.org)