Valores predeterminados de metadatos basados en la ubicación
Última modificación: jueves, 15 de abril de 2010
Hace referencia a: SharePoint Server 2010
En este artículo
Presentación de los valores predeterminados de metadatos basados en la ubicación
Condiciones y precedencia
Registro de receptores de eventos para aplicar metadatos predeterminados
Configuración de valores predeterminados de metadatos para ubicaciones
Programación de valores predeterminados de metadatos basados en la ubicación
En este tema se explican los valores predeterminados de metadatos basados en la ubicación, sus opciones de configuración, las reglas de precedencia que rigen su uso y el modo en que estos valores predeterminados de metadatos basados en la ubicación usan los receptores de eventos para aplicar metadatos predeterminados.
Presentación de los valores predeterminados de metadatos basados en la ubicación
Los valores predeterminados de metadatos basados en la ubicación administran los valores predeterminados de los campos de metadatos basados en la ubicación y los aplica para que estén disponibles cuando el usuario edita un documento. Cuando un usuario interactúa con un sitio de Microsoft SharePoint Server 2010, SharePoint Server aplica valores predeterminados para que aparezcan la primera vez que el usuario ve un formulario de edición de documento. Las aplicaciones de Microsoft Office 2010, como Microsoft Word 2010, obtienen los valores predeterminados para una ubicación cuando se guarda el documento. Al guardar el documento, la aplicación cliente obtiene la información de tipo de contenido de la ubicación donde se guarda el elemento de contenido y el servidor aplica los valores predeterminados y crea el esquema de propiedad en el documento de Office 2010.
Condiciones y precedencia
Los valores predeterminados de metadatos basados en la ubicación siguen reglas condicionales para saber cuándo aplicar valores predeterminados a un documento. En esta sección, primero se enumeran las condiciones y, a continuación, se explican las reglas de precedencia que se usan para aplicarlas.
Los valores predeterminados se aplican bajo las siguientes condiciones:
Cuando se carga un solo archivo.
Cuando se agregan archivos de forma masiva a través de la vista del explorador o del control ActiveX de carga de varios documentos.
Cuando se crea una nueva página de publicación.
Cuando se crea un nuevo documento predeterminado en un conjunto de documentos.
Cuando un flujo de trabajo crea un documento.
Cuando se guarda directamente desde las aplicaciones cliente de Office 2010 o un área de trabajo de SharePoint.
Una vez finalizada la conversión de documentos.
Para usar y aplicar los valores predeterminados de los metadatos basados en la ubicación, SharePoint Server 2010 establece primero un conjunto de reglas de precedencia generales mediante las que se determinan los valores predeterminados de metadatos que se deben aplicar y en qué orden. Por ejemplo, se usan reglas de precedencia específicas para, entre otras acciones, aplicar valores predeterminados al servidor, registrar receptores de eventos, averiguar la secuencia de eventos que se desencadena cuando se carga un documento en el servidor.
Cómo y cuándo SharePoint Server 2010 aplica valores predeterminados de metadatos basados en la ubicación a los elementos depende del modo en que la característica establece la precedencia. En primer lugar, al cargar un documento en una carpeta de una biblioteca de documentos, los valores predeterminados de metadatos basados en la ubicación para las columnas se obtienen desde distintos lugares:
Del documento que se está cargando, que puede contener un valor de columna, una columna integrada (como "Título"), o de un documento previamente almacenado con un esquema aplicado (que incluye la misma columna). En ambos casos, el documento que se está cargando puede contener un valor de columna.
De la definición de campo de la lista, que puede especificar un valor predeterminado.
De la ubicación en la que se está cargando el documento en la biblioteca de documentos, que puede especificar un valor predeterminado de columna.
Las reglas de precedencia se usan para saber el valor que se aplica a una columna:
Si el documento cargado contiene un valor para el campo igual al valor predeterminado de lista para la definición de campo, SharePoint Server 2010 sobrescribe el valor actual del campo con el valor predeterminado basado en la ubicación, si existe uno basado en reglas de precedencia.
Si el documento cargado contiene un valor distinto al valor predeterminado de lista, SharePoint Server 2010 lo conserva, incluso si existe un valor predeterminado basado en la ubicación para éste.
Si no existe un campo, el servidor usa el valor predeterminado establecido en la definición de campo.
Registro de receptores de eventos para aplicar metadatos predeterminados
La primera vez que configura un valor predeterminado de metadatos basados en la ubicación relativo a cualquier ubicación de una biblioteca de documentos, SharePoint Server 2010 registra un nuevo receptor de eventos sincrónico ItemAdded posterior al evento en dicha biblioteca de documentos. Una vez registrado el evento, el servidor lo aplica a los valores predeterminados de cada ubicación. Una secuencia de eventos afecta al modo en que los valores predeterminados de metadatos basados en la ubicación se promocionan de los documentos a la columna correspondiente en una lista de SharePoint Server 2010, así como a los valores predeterminados que se especifican para una ubicación y, además, determina si los valores de las propiedades se deben actualizar o corregir.
El usuario carga un documento en una ubicación. En este momento, los metadatos se promocionan del documento.
Se ejecuta el nuevo receptor de eventos ItemAdded, que comprueba qué valores predeterminados de los metadatos basados en la ubicación se han especificado para la ubicación y actualiza el valor de las propiedades si se ha especificado un valor predeterminado y el valor actual es equivale a éste en relación con el tipo de contenido especificado.
El usuario ve el formulario estándar de edición del elemento, con los valores predeterminados correctos para la ubicación ya completados.
Si quita el último valor predeterminado basado en la ubicación de la biblioteca de documentos, el servidor anula el registro del receptor de eventos.
Después de cargar el documento en el servidor, se desencadena el evento ItemAdded y los valores de metadatos del documento para todas las columnas se promocionan a la columna correspondiente de la lista. SharePoint Server 2010 muestra el formulario de edición del documento y el servidor cambia los valores de metadatos reales mediante reglas de precedencia generales.
Configuración de valores predeterminados de metadatos para ubicaciones
Puede configurar valores predeterminados de metadatos basados en la ubicación en columnas que admiten valores predeterminados de configuración, en una jerarquía de carpetas. Si se configuran valores de metadatos en una carpeta principal, sus subcarpetas heredarán los valores de metadatos de ésta, a menos que se especifique explícitamente un valor de metadatos diferente en una subcarpeta. Dependiendo de si se manipulan las carpetas o los metadatos y de qué manera se manipulan a través de la interfaz de usuario o la API, los valores predeterminados de metadatos de las carpetas y subcarpetas pueden verse afectados.
Si no hay valores predeterminados configurados para una carpeta o subcarpeta y la lista incluye solo una columna (una columna de texto denominada "TheOnlyColumn" con una cadena vacía para un valor predeterminado), una serie de tres acciones modifica los valores de metadatos de las carpetas y subcarpetas en función de la herencia. Por ejemplo, considere una estructura de ejemplo donde:
Una carpeta llamada DocLib es el elemento primario.
Las carpetas con los nombres Alpha y Beta son subcarpetas de la carpeta DocLib.
Las carpetas AlphaOne y AlphaTwo son subcarpetas de Alpha.
BetaOne es una subcarpeta de Beta.
Primera acción: navegar a la carpeta Beta y establecer de un valor predeterminado
Un usuario navega a la carpeta Beta y establece un valor predeterminado "Z" para TheOnlyColumn.
Tabla 1. Consecuencias de establecer valores de metadatos en carpetas: primera acción
Si agrega un elemento en esta carpeta... |
El valor predeterminado de TheOnlyColumn es... |
|---|---|
DocLib (raíz) |
Vacío |
Alfa |
Vacío |
AlphaOne |
Vacío |
AlphaTwo |
Vacío |
Beta |
Z |
BetaOne |
Z |
El cambio afecta a las carpetas Beta y BetaOne: la modificación del valor de metadatos de Beta afecta a BetaOne porque es una subcarpeta de Beta, por lo que hereda el valor de metadatos de su elemento primario.
Segunda acción: navegar a la carpeta Alpha y establecer un valor predeterminado
Un segundo usuario navega a la carpeta Alpha y establece un valor predeterminado "Y".
Tabla 2. Consecuencias de establecer valores de metadatos en carpetas: segunda acción
Si agrega un elemento en esta carpeta... |
El valor predeterminado de TheOnlyColumn es... |
DocLib (raíz) |
Vacío |
Alfa |
Y |
AlphaOne |
Y |
AlphaTwo |
Y |
Beta |
Z |
BetaOne |
Z |
El cambio afecta a la carpeta Alpha y sus subcarpetas. No afecta a las carpetas Beta.
Tercera acción: navegar a la carpeta AlphaOne y establecer un valor predeterminado
Por último, otro usuario navega a la carpeta AlphaOne y establece un valor predeterminado "X".
Tabla 3. Consecuencias de establecer valores de metadatos en carpetas: tercera acción
Si agrega un elemento en esta carpeta... |
El valor predeterminado de TheOnlyColumn es... |
|---|---|
DocLib (raíz) |
Vacío |
Alfa |
Y |
AlphaOne |
X |
AlphaTwo |
Y |
Beta |
Z |
BetaOne |
Z |
El valor de la carpeta AlphaTwo sigue siendo "Y". El cambio de la carpeta AlphaOne no afecta a AlphaTwo, porque AlphaTwo no es un elemento secundario de AlphaOne.
Programación de valores predeterminados de metadatos basados en la ubicación
El modelo de objetos para valores predeterminados de metadatos basados en la ubicación se encuentra principalmente en el tipo MetadataDefaults. En él se incluyen los métodos que puede usar para aplicar valores predeterminados de metadatos basados en la ubicación. También permite obtener, establecer y quitar metadatos predeterminados de los objetos String y SPFolder, así como obtener valores predeterminados de campo. La documentación de referencia administrada de MetadataDefaults contiene fragmentos de código que muestran esta funcionalidad.
Vea también
Conceptos
Modelo de programación para la administración de documentos