IBM FileNet P8, Versión 5.1.+            

Acceder a objetos mediante URL

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.


Comentarios

Última actualización: Julio de 2011


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