Identificadores de documento y servicio de identificador de documento
Última modificación: lunes, 19 de abril de 2010
Hace referencia a: SharePoint Server 2010
En este artículo
Descripción de direcciones URL estáticas
Administración de identificador de documento
Cómo afectan los identificadores de documento a los tipos de contenido
Asignación de identificadores de documento
Persistencia de identificador de documento
Comportamiento de consulta de identificador de documento
Elemento web del cuadro de consulta de identificador de documento
Proveedores de identificador de documento personalizados
La característica de identificador de documento crea identificadores que se pueden usar para recuperar los elementos, independientemente de su ubicación actual. El servicio de identificador de documento que lo admite genera y asigna identificadores de documento. En este tema se describen los identificadores de documento: cómo funcionan y cómo funciona el servicio que admite la generación y la asignación.
Por lo general, los usuarios abren elementos a partir de una acción que se inicia en el explorador web, como navegar a una dirección URL, que a continuación indica a la aplicación cliente de Microsoft Office que abra el archivo.
Descripción de direcciones URL estáticas
La característica de direcciones URL estáticas puede usarse en el explorador web para redirigir usuarios a la dirección URL real de un elemento por medio de una redirección HTTP o una llamada de transferencia de servidor. En ambos casos, no está previsto que la dirección URL estática funcione en todas las partes que funciona la dirección URL real para un elemento. Por ejemplo, al seleccionar Abrir en el menú Archivo en las aplicaciones cliente, no se controlan los casos donde las direcciones URL se redirigen al llamar al método Open.
Administración de identificador de documento
Se puede activar, administrar y desactivar el servicio de identificador de documento en el nivel de la colección de sitios. Las direcciones URL estáticas funcionan correctamente en el nivel de la colección de sitios porque el explorador web administra la redirección antes de que invoque la aplicación cliente de Office. Esto significa que la aplicación cliente ve solo la dirección URL real. Cuando se activa la característica de identificador de documento, Microsoft SharePoint Server 2010 agrega vínculos a la página de configuración de la colección de sitios en la interfaz de usuario de Administración central y habilita el servicio de identificador de documento, que comienza la asignación de identificador de documento en la colección de sitios. El servicio de identificador de documento genera los identificadores de documento para todos los documentos de la colección de sitios, pero no genera identificadores de documento para otros tipos de elementos de lista. Los identificadores de documento se generan cada vez que se agrega un elemento y se sobrescriben los identificadores existentes de forma predeterminada, a menos que el elemento que se creó indique específicamente a SharePoint Server 2010 que no sobrescriba el identificador existente. Durante las operaciones de movimiento, SharePoint Server 2010 conserva el identificador de documento. Durante las operaciones de copia, SharePoint Server 2010 asigna un nuevo identificador de documento. Puede controlarlo por medio de un operador booleano en la columna PersistID.
Cuando se asigna un identificador de documento, se expone como metadatos y el servidor expone una dirección URL estática para que el elemento al que está asignado el identificador de documento pueda ser reconocido por su identificador de documento. La dirección URL estática intenta recuperar el elemento al buscarlo o al explorarlo.
Los administradores de búsqueda pueden configurar el servicio de búsqueda para buscar los identificadores de documento al agregar la columna ID como una columna de búsqueda administrada y, opcionalmente, al crear un nuevo ámbito de búsqueda que se use para buscar el identificador de documento. SharePoint Server 2010 incluye un comando Windows PowerShell 1.0 que lo hace automáticamente.
La desactivación de la característica hace que se quiten los vínculos de la página Configuración de la colección de sitios, que la página que se usa para buscar los identificadores de documento ya no esté disponible, que se desactive el servicio de identificador de documento y que se detenga la asignación de identificador de documento. El servidor no elimina las columnas que se agregan al nivel del sitio cuando la característica se activa por primera vez para que, incluso tras la activación, se conserven los identificadores de documento existentes. Después de desactivar la característica, los usuarios que intenten usar una dirección URL estática para buscar un elemento por su identificador de documento verán un mensaje de error que indica que esta colección de sitios no está configurada para usar identificadores de documento.
Cómo afectan los identificadores de documento a los tipos de contenido
Cuando se habilita el servicio de identificador de documento, SharePoint Server 2010 agrega nuevas columnas para el tipo de contenido de documento y el tipo de contenido de conjunto de documentos, que almacenan el identificador de documento y exponen la dirección URL estática y los receptores de eventos que asignan los identificadores de documento. El servicio también incluye una tarea de elemento de trabajo que asigna los identificadores a todos los elementos existentes en la colección de sitios. El servidor agrega las siguientes columnas de sitio a la colección de sitios en un grupo denominado "Identificadores de documentos". Además, se agregan columnas de sitio para el tipo de contenido de documento y el tipo de contenido de conjunto de documentos en el nivel de la colección de sitios.
La columna DocID almacena el identificador de documento que está asignado al artículo. Tiene los atributos siguientes:
Nombre: Document ID
Descripción: se usa para ubicar este elemento independientemente de su ubicación actual.
Tipo: Texto
Indexed: False
Sealed: True
ReadOnly: True
CanBeDeleted: False
ShowInNewForm: False
ShowInEditForm: False
Columna de dirección URL estática
La columna Static URL presenta la dirección URL del elemento que se usa para buscar el identificador de documento. Tiene los atributos siguientes:
Nombre: Static URL
Descripción: se usa para recuperar este elemento independientemente de su ubicación actual.
Tipo: URL
Indexed: False
Sealed: True
ReadOnly: True
CanBeDeleted: False
ShowInNewForm: False
ShowInEditForm: False
La columna PersistID se usa con la lógica de asignación de identificador de documento para determinar si un identificador de documento existente se debe mantener o volver a asignar. Esta columna está oculta, no representa la interfaz de usuario y no puede incluirse en cualquier vista:
Nombre: PersistID
Descripción: se usa para especificar si se debe conservar el identificador del elemento actual después de que se copia en una nueva ubicación.
Tipo: Boolean
Valor predeterminado: False
Indexed: False
Sealed: True
ReadOnly: True
CanBeDeleted: False
ShowInNewForm: False
ShowInEditForm: False
ShowInViewForms: False
Receptores de eventos
Además de agregar las columnas que se han mencionado anteriormente para los tipos de contenido documento y conjunto de documentos, SharePoint Server 2010 agrega un receptor de eventos a los eventos de SharePoint Foundation 2010 adecuados, de modo que se ejecuten cada vez que un documento o un conjunto de documentos se cargue en SharePoint Foundation 2010. El servidor usa receptores de eventos sincrónicos, como ItemAdded(SPItemEventProperties) (no [M:Microsoft.SharePoint.SPItemEventReceiver.ItemAdding(Microsoft.SharePoint.SPItemEventProperties]) para garantizar que los proveedores de identificador de documentos puedan usar metadatos del elemento al asignar los identificadores de documento.
Asignación de identificadores de documento
Cuando se agregan elementos a una colección de sitios, SharePoint Server 2010 les asigna o reasigna identificadores de documento.
Cuando se agrega un nuevo elemento, SharePoint Server 2010 comprueba primero si el elemento tiene un identificador de documento. Si el elemento tiene un identificador de documento, el servidor comprueba si el atributo PreserveID está establecido en True o en False y, a continuación, lo establece en False si actualmente está establecida en True. Si el elemento todavía no tiene un identificador de documento, el servidor obtiene un identificador de documento para el elemento del proveedor especificado, lo escribe en metadatos y establece el atributo PreserveID en False.
Nota
No se genera el valor de la dirección URL estática, debido a que SharePoint Server 2010 lo crea de forma dinámica cuando se procesa y se ve el campo.
Persistencia de identificador de documento
El comportamiento predeterminado para asignar los identificadores de documento supone que, si el elemento existe y ya tiene un identificador, SharePoint Server 2010 debe sobrescribir dicho identificador con un identificador de documento. Esto sucede cuando se copia un elemento existente en SharePoint Foundation 2010: la copia mantiene los mismos metadatos que el original, incluido el identificador de documento, pero se sigue produciendo el evento ItemAdding(SPItemEventProperties).
Nota
Cuando un objeto SPFile invoca su método MoveTo(String), no se produce un evento ItemAdding(SPItemEventProperties).
Cuando se agrega un elemento, SharePoint Server 2010 no supone que el elemento sea una copia, sino que proporciona un medio para que las soluciones personalizadas tengan en cuenta que van a implementar un "cambio semántico". Desde la perspectiva del modelo de objetos, el cambio semántico consiste en una operación de copia y eliminación que sirve para invalidar la lógica de copia predeterminada y tratar los elementos y sus identificadores de documento asociados como si el modelo de objetos hubiese completado una operación de cambio en ellos.
Nota
Puede usar código personalizado para evitar la sobrescritura de los identificadores de documento o los identificadores que se asignaron previamente a los elementos que se van a copiar en SharePoint Server 2010 por primera vez. Por ejemplo, puede suspender todos los eventos llamando al método DisableEventFiring() en código antes de copiar. Sin embargo, no se recomienda este enfoque en casos en los que deben ejecutarse otros receptores de eventos y el código sólo existe para conservar los identificadores.
Comportamiento de consulta de identificador de documento
SharePoint Server 2010 adopta un enfoque de dos partes cuando el servicio de identificador de documento busca los identificadores de documento para proporcionar el mejor equilibrio de los identificadores de documento que funcionan de forma inmediata y aquellos que funcionan a través de amplios ámbitos:
Búsqueda. Busque un elemento a través de cualquier ubicación que pertenezca al ámbito de búsqueda actual. Por lo general, la búsqueda se realiza mejor como una consulta en todas las listas. Sin embargo, la búsqueda solo es tan confiable como el último índice. Por lo tanto, si se ha agregado un elemento pero la búsqueda aún no lo ha indizado, no aparece en los resultados de la búsqueda. Además, si un elemento se ha movido desde la última vez que la búsqueda lo ha indizado, aparecerá la dirección URL anterior (ahora rota) en los resultados de la búsqueda.
Búsqueda específica del proveedor de identificadores. Cuando no se puede recuperar un elemento mediante la búsqueda (por ejemplo, si aún no se ha indizado), SharePoint Server 2010 vuelve a llamar al proveedor de identificadores de documento y le permite usar su propia lógica de búsqueda. Esto permite la búsqueda a los proveedores que desean usar identificadores que funcionen antes de que se ejecute el indizado de búsqueda en los últimos elementos. El proveedor determina si va a realizar búsquedas de este modo y cuál es la lógica más eficaz para hacerlo.
Elemento web del cuadro de consulta de identificador de documento
El Elemento web del cuadro de búsqueda de Id. de documento permite especificar un identificador de documento y, a continuación, genera una "dirección URL estática" y busca el elemento.
Proveedores de identificador de documento personalizados
Puede usar proveedores personalizados para asignar los identificadores de documento a los elementos. En algunas organizaciones, los metadatos de elementos específicos controlan cómo se asignan los identificadores Esto ayuda a asegurarse de que el identificador transmite información sobre el elemento.
SharePoint Server 2010 admite el uso de complementos de código personalizados para aprovisionar los identificadores de documento. Puede crear sus propios proveedores personalizados mediante la implementación de una clase que derive de la interfaz de IIDProvider y, a continuación, implementar y registrar ese proveedor en cada colección de sitios. Una vez registrado un proveedor personalizado, el servicio de identificador de documento usa el proveedor personalizado en lugar del proveedor predeterminado.
Vea también
Conceptos
Ejemplo: Proveedor de identificador de documento personalizado