Consulta de cambios específicos en el registro de cambios

Artículo
09/24/2014

Última modificación: miércoles, 29 de julio de 2009

Hace referencia a: SharePoint Foundation 2010

En este artículo
Construcción de una consulta
Filtrado por tipo de objeto
Filtrado por tipo de cambio

Para acotar la selección de cambios devueltos en una colección de cambios, se puede pasar un objeto SPChangeQuery a una sobrecarga del método GetChanges de la clase SPList, SPWeb, SPSite o SPContentDatabase. Al construir un objeto SPChangeQuery, se puede especificar que se desea filtrar los resultados de la consulta por tipo de objeto, por tipo de cambio o por ambos.

Construcción de una consulta

Para filtrar los resultados devueltos por una llamada al método GetChanges(SPChangeQuery), se deben usar los parámetros del constructor SPChangeQuery en combinación con las propiedades del objeto SPChangeQuery.

La firma del constructor es la siguiente:

public SPChangeQuery(bool AllChangeObjectTypes, bool AllChangeTypes);

Los dos parámetros del constructor se usan de la siguiente manera:

AllChangeObjectTypes

Pase true para devolver los cambios a todos los tipos de objeto. Pase false para limitar la consulta a tipos de objeto específicos; a continuación, establezca true en las propiedades del objeto SPChangeQuery que corresponden a los tipos de objeto que le interesan.

Por ejemplo, el código siguiente construye una consulta para cambios a los objetos SPGroup.
```
// Construct a query.
SPChangeQuery query = new SPChangeQuery(false, true); 

// Specify the object type. 
query.Group = true;
```
AllChangeTypes

Pase true para devolver todos los tipos de cambio. Pase false para limitar la consulta a tipos de cambio específico; a continuación, establezca true en las propiedades del objeto SPChangeQuery que corresponde a los tipos de cambio que le interesan.

Por ejemplo, el código siguiente construye una consulta para cambios que eliminan objetos.
```
// Construct a query.
SPChangeQuery query = new SPChangeQuery(true, false); 

// Specify the change type. 
query.Delete = true;
```

Si desea restringir la consulta a tipos de cambio específicos o a tipos de objeto específicos, puede pasar false como el argumento para ambos parámetros. Por ejemplo, el código siguiente construye una consulta para cambios que agregan, eliminan o actualizan elementos de lista.

// Construct a query.
SPChangeQuery query = new SPChangeQuery(false, false); 

// Specify the object type.
query.Item = true;

// And the change types. 
query.Add = true;
query.Delete = true;
query.Update = true;

Filtrado por tipo de objeto

La tabla siguiente es una lista de las propiedades de la clase SPChangeQuery que puede usarse para especificar los tipos de objeto para los que deben devolverse cambios. Para obtener los cambios de un tipo de objeto determinado, establezca la propiedad correspondiente en true. Las entradas de cambio se devuelven como subclases de SPChange con propiedades específicas del tipo de objeto. Por ejemplo, la subclase SPChangeUser representa un cambio a un objeto SPUser y tiene una propiedad IsSiteAdminChange que describe una característica de un cambio en ese tipo de objeto.

Tabla 1. Propiedades que especifican un tipo de objeto

Propiedad	Descripción	Subclase devuelta
Alert	Incluye cambios a objetos SPAlert.	SPChangeAlert
ContentType	Incluye cambios a objetos SPContentType.	SPChangeContentType
Field	Incluye cambios a objetos SPField.	SPChangeField
File	Incluye cambios a archivos que existen fuera de una lista y no tienen elementos correspondientes.	SPChangeFile
Folder	Incluye cambios a carpetas que existen fuera de una lista y no tienen elementos correspondientes.	SPChangeFolder
Group	Incluye cambios a objetos SPGroup.	SPChangeGroup
Item	Incluye cambios a todos los objetos que existen en una lista: elementos de lista, archivos y carpetas.	SPChangeItem
List	Incluye cambios a objetos SPList.	SPChangeList
SecurityPolicy	Incluye cambios a la directiva de seguridad realizada en el nivel de aplicación web y que afecta a toda la base de datos de contenido.	SPChangeSecurityPolicy
Site	Incluye cambios a objetos SPSite.	SPChangeSite
User	Incluye cambios a objetos SPUser.	SPChangeUser
View	Incluye cambios a objetos SPView.	SPChangeView
Web	Incluye cambios a objetos SPWeb.	SPChangeWeb

Filtrado por tipo de cambio

La tabla siguiente es una lista de las propiedades de la clase SPChangeQuery que pueden usarse para especificar los tipos de cambio a los objetos que una consulta debe devolver. Para obtener un tipo de cambio específico, establezca la propiedad correspondiente en true. Tenga en cuenta, sin embargo, que no todos los tipos de cambio se aplican a todos los tipos de objeto.

Tabla 2. Propiedades que especifican un tipo de cambio

Propiedad	Descripción
Add	Incluye los objetos que se agregan. Para los elementos, archivos y carpetas, el valor TimeLastModified del registro debe ser igual que la propiedad Created del objeto.
Delete	Incluye objetos eliminados.
GroupMembershipAdd	Incluye cambios que agregan usuarios a grupos.
GroupMembershipDelete	Incluye cambios que quitan usuarios de grupos.
Move	Incluye operaciones de desplazamiento.
Navigation	Incluye cambios en la navegación.
Rename	Incluye los cambios de cambio de nombre. Esto significa que se cambió la parte del nombre del archivo de la dirección URL.
Restore	Incluye cambios que restauran objetos de la papelera de reciclaje o de una copia de seguridad. El cambio de restauración indica al lector del registro de cambios de un cliente de sincronización que debe volver a sincronizar el objeto y todos sus objetos secundarios.
RoleAssignmentAdd	Incluye los cambios que agregan una asignación de roles al ámbito del objeto.
RoleAssignmentDelete	Incluye los cambios que quitan una asignación de roles del ámbito del objeto.
RoleDefinitionAdd	Incluye los cambios que agregan una definición de roles.
RoleDefinitionDelete	Incluye los cambios que eliminan una definición de roles.
RoleDefinitionUpdate	Incluye los cambios que modifican una definición de roles.
SystemUpdate	Incluye los cambios que modifican un objeto sin que cambie su propiedad Modified o Modified By. El valor TimeLastModified del registro debe ser el momento en el tiempo en el que se produjo la actualización, no la propiedad Modified.
Update	Incluye los cambios que modifican un objeto.

Vea también

Tareas

Procedimiento para fitrar el registro de cambios por tipo de objeto

Procedimiento para filtrar el registro de cambios por tipo de cambio

Compartir a través de