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 el
tema
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.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
...
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.
Modificar el 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.