La característica de direccionabilidad URL ofrece a los usuarios acceso directo a los
objetos sin tener que navegar por la interfaz de usuario del cliente IBM® FileNet P8.
Después de iniciar la sesión en un cliente de FileNet P8, como por ejemplo Workplace XT, un usuario
simplemente especifica el URL del objeto en la barra de direcciones del navegador. (Un administrador puede crear marcadores o
favoritos para recuperar un carpeta o un objeto versionable).
Con la direccionabilidad de URL, puede:
- Recuperar documentos, búsquedas almacenadas, plantillas de búsqueda,
definiciones de flujo de trabajo y plantillas de publicación.
- Descargar los siguientes tipos de objeto y guardarlos en el PC local:
documento, búsqueda almacenada, plantilla de búsqueda, plantilla de publicación y
definición de flujo de trabajo.
- Entrar un URL basado en vía de acceso o basado en ID como se muestra a
continuación.
Un URL basado en vía de acceso utiliza la vía de acceso de contención para especificar
la ubicación de un objeto en un almacén de objetos. Por ejemplo, para recuperar el documento llamado
Current Works, que reside en la carpeta Projects del almacén de objetos Transportation, el usuario
entraría un URL similar al siguiente ejemplo:
http://nombre_servidor_cliente_P8/nombre_aplicación/getContent/Transportation/Projects/Current+Works
Para recuperar objetos utilizando los URL basados en vías de acceso, debe establecer la preferencia de
sitio Usar URL con ruta de acceso.
Un URL basado en ID utiliza
GUIDs
para especificar la ubicación de un objeto en el almacén de objetos.
La ubicación del documento se especifica mediante el GUID del almacén de objetos en el
que reside el documento, así como por el GUID del documento. Por ejemplo, para
recuperar un documento, un usuario entra un URL similar al del siguiente ejemplo:
http://nombre_servidor_cliente_P8/nombre_aplicación:puerto/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}
Una dirección basada en ID es generalmente más rápida que una dirección basada
en vía de acceso; no obstante, solamente un URL basado en vía de acceso resuelve
referencias relativas en un documento. Por ejemplo, si solicita el archivo
"example.html"
con un URL basado en vía de acceso, el archivo se recupera y el navegador resuelve cualquier
URL adicional necesario en example.html (como los códigos <script>, <img> y <link>). Los enlaces (<a href=...>) los resuelve el navegador cuando el
usuario pulsa los enlaces.
En la siguiente tabla figuran las respuestas predeterminadas a los distintos
tipos de objeto que puede especificar en un URL.
Tipo de objeto |
Respuesta |
Carpeta |
Devuelve una página que muestra el nombre de carpeta. |
Documento |
Si el documento tiene contenido, se devuelve el contenido. Si el documento tiene una referencia
externa, el cliente FileNet P8 redirecciona al cliente según sea necesario.
Si el documento no tiene contenido, el cliente FileNet P8 informa de un error. |
Definición de flujo de trabajo |
Abre el applet Diseñador de procesos. |
Búsqueda almacenada |
Devuelve una página que muestra el nombre de la búsqueda almacenada. |
Plantilla de búsqueda |
Devuelve una página que muestra la plantilla de búsqueda. |
Plantilla de publicación |
Devuelve el contenido de la plantilla de publicación como XML. |
Reglas de sintaxis del URL basado en vía de acceso
Un URL basado en vía de acceso requiere un ID de almacén de objetos y un nombre
de vía de acceso de contención. El parámetro
mode=download es opcional. Un ejemplo:
http://servidor/aplicación_web/getContent/objectStoreID/pathName?mode=download
donde:
- servidor es el nombre del servidor Application Engine o Workplace XT en el que
reside la aplicación cliente FileNet P8.
- aplicación_web es el nombre de la aplicación cliente de FileNet P8; por ejemplo,
Workplace XT.
- IDAlmacénObjetos es el ID del almacén de objetos, que puede ser el
GUID o el nombre del almacén de objetos. El nombre del almacén de objetos es exclusivo en
un dominio, pero no necesariamente en Active Directory. Cuando se utiliza el nombre
para referirse al almacén de objetos, se devuelve el primer almacén de objetos
coincidente en Active Directory. Si es posible que existan varios almacenes de objetos con el mismo
nombre en Active Directory, debe calificar el nombre del almacén de objetos con el nombre de dominio
utilizando el carácter "@"; por ejemplo, objectStoreName@domainName.
- NombreVíaAcceso es el nombre de vía de acceso de contención.
- El parámetro mode=download (opcional) le permite guardar
localmente el contenido.
Nota: Los URL basados en vía de acceso, para objetos documento, búsqueda almacenada, plantilla
de búsqueda y plantilla de publicación siempre hacen referencia a la versión más
reciente.
Ejemplo de URL basados en vía de acceso
Con este URL, se visualiza la página de Workplace XT con la plantilla de búsqueda
especificada. El almacén de objetos se identifica mediante el
nombre (Forms):
http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download
Con este URL, el almacén de objetos, Forms, se califica mediante su nombre de
dominio, Midwest:
http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download
Reglas de sintaxis de URL basado en ID
Un URL basado en ID acepta tres parámetros de serie de consulta necesarios para
el objeto de carpeta: objectStoreName, objectType e id. Por ejemplo:
http://servidor/aplicación_web/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}
Para los objetos de documento, búsqueda almacenada, plantilla de búsqueda,
plantilla de publicación y definición de flujo de trabajo, el URL toma los parámetros
objectStoreName, objectType, id y fsld. El parámetro
mode=download es opcional.
He aquí un ejemplo:
http://servidor/aplicación_web/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&mode=download
o,
http://servidor/aplicación_web/getContent?objectStoreName={objectStoreGUID}&objectType=type&vsId={versionSeriesGUID}
o,
http://servidor/aplicación_web/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&vsId={versionSeriesGUID}&mode=download
donde:
- servidor es el nombre del servidor Application Engine o Workplace XT en el que se
ejecuta la aplicación cliente FileNet P8.
- aplicación_web es el nombre de la aplicación cliente de FileNet P8.
- objectStoreName=objectStoreGUID es el GUID del almacén de objetos
en el que reside el objeto. Incluya las llaves.
- objectType=type es el tipo de objeto que se va a recuperar. Entre
el valor de objectType aplicable:
Para un: |
objectType= |
Documento |
document |
Carpeta |
folder |
Búsqueda almacenada |
storedsearch |
Plantilla de búsqueda |
searchtemplate |
Definición de flujo de trabajo |
document |
Plantilla de publicación |
publishtemplate |
- id=objectGUID es el GUID que identifica al objeto en el almacén de
objetos. Se trata de un parámetro necesario para el objeto de carpeta. Para objetos de
Menús de complementos para, búsqueda almacenada, plantilla de búsqueda, definición de
flujo de trabajo y plantilla de publicación, el id es opcional y se utiliza para
recuperar una versión específica. Incluya las llaves.
- vsId=versionSeriesGUID es el GUID para recuperar la versión más
reciente en la serie de versión de los siguientes objetos: documento, búsqueda
almacenada, plantilla de búsqueda, definición de flujo de trabajo y plantilla de
publicación.
Nota: Cuando en el URL están presentes tanto el ID como el vsld, la aplicación cliente de FileNet P8
utiliza el ID para recuperar la versión especificada. Si no se puede encontrar la versión especificada,
la aplicación cliente de FileNet P8 informa de un error y ofrece al usuario la opción de recuperar la
versión más reciente tal como se especifica en el parámetro vsld.
- El parámetro mode=download es opcional y le permite guardar
localmente el contenido.
Nota: Puede configurar la aplicación cliente de FileNet P8 para que utilice URLs basados en vía de
acceso en las solicitudes de documentos. Por lo tanto, si entra un URL basado en ID, la aplicación
cliente de FileNet P8 convierte el URL basado en ID a un URL basado en vía de acceso si es posible, para
poder mantener la integridad de las referencias relativas de URL incluidas en el contenido del
documento.