Tipos de filtros compatibles con el Servicio de conectividad a datos empresariales

Última modificación: viernes, 16 de julio de 2010

Hace referencia a: SharePoint Server 2010

Los filtros constituyen la principal forma en que el Servicio de conectividad de datos profesionales (BDC) captura entradas del usuario (o del sistema) y las suministra a la invocación de la API back-end. Los filtros describen la ubicación en la que se debe insertar un valor de filtro en una serie compleja de parámetros. Para ello, se "etiqueta" la entrada o los parámetros devueltos de una definición de método para marcar la ubicación en la que el elemento se debe insertar. La invocación de la API back-end debe proporcionar la funcionalidad de filtrado. Los filtros son solo un mecanismo para mostrar esto al usuario.

Los sistemas externos proporcionan diversos mecanismos de filtrado. BDC resume los patrones comunes a fin de ofrecer a los usuarios la misma semántica de filtrado, independientemente del origen de datos. BDC admite varios filtros y patrones de filtrado. Los filtros de usuario, como Comparison, declaran las entradas que los usuarios pueden invalidar. En cuanto a los filtros de sistema, como UserContext y UserProfile, permiten a BDC establecer valores de forma segura como, por ejemplo, un token de usuario. Para obtener información detallada, vea la tabla 1. Los clientes realizan consultas al repositorio de metadatos para determinar los filtros que el sistema admite, así como para representar sus interfaces de usuario en consecuencia.

Importante
Si un creador de metadatos crea metadatos que toman un nombre de usuario como un filtro que el usuario puede controlar y devuelven datos personales confidenciales, un usuario podrá ver los datos de otro usuario. Para evitar este problema, use UserContextFilter para pasar el nombre de usuario a la llamada del método.

En la tabla 1 se describen los filtros que BDC admite.

Tabla 1. Valores de filtro

Valor	Tipo de filtro	Descripción
ActivityId	Filtro de sistema	Se usa cuando se llama a una operación en un sistema externo y el valor que se debe pasar como parámetro de entrada debe representar una identidad de contexto de la operación de invocación. Servicios de conectividad empresarial establece un GUID que representa el contexto de la operación actual como el valor en el parámetro de entrada que se asocia al filtro ActivityId.
Batching	Filtro de usuario	Se usa cuando se realiza una consulta al sistema externo. Cualquier aplicación cliente puede establecer automáticamente su valor en el último valor del filtro que se obtuvo del sistema externo. Este valor se puede usar posteriormente en el sistema externo para reanudar una enumeración de elementos o cambios.
BatchingTermination	Filtro de usuario	Se usa cuando se realiza una consulta al sistema externo. El valor que el sistema externo devuelve indica si es necesario realizar llamadas adicionales para obtener el resto de datos.
Comparison	Filtro de usuario	Se usa cuando se realiza una consulta a un sistema externo. Un sistema externo puede comparar un valor de ComparisonFilter con el valor de un campo específico en un conjunto de EntityInstances y puede devolver solamente las EntityInstances donde los valores de campo pasen la prueba de comparación.
Input	Filtro de usuario	Se usa al llamar a una operación en un sistema externo. Un sistema externo puede usar el valor de InputFilter como un argumento adicional para la operación.
InputOutput	Filtro de usuario	Se usa al llamar a una operación en un sistema externo. Un sistema externo puede usar el valor de InputOutputFilter como un argumento adicional para la operación, mientras que los resultados adicionales de una operación que no se pueden capturar con ReturnTypeDescriptor se pueden recuperar como un valor de InputOutputFilter.
LastId	Filtro de usuario	Se usa cuando se realiza una consulta a un sistema externo. Cualquier aplicación cliente puede establecer automáticamente su valor en los valores de identificador del último elemento que se lee desde el sistema externo en un buscador que devuelve los datos en varios fragmentos. Este valor se puede usar posteriormente en el sistema externo para devolver el resto de artículos, comenzando por el siguiente elemento.
Limit	Filtro de usuario	Se usa cuando se realiza una consulta a un sistema externo. Su valor se puede interpretar como un límite para el número de elementos externos (EntityInstances) que se devuelve cuando se llama al método al que pertenece.
Output	Filtro de usuario	Se usa al llamar a una operación en un sistema externo. Los resultados adicionales de una operación que no es posible capturar con ReturnTypeDescriptor se pueden recuperar como un valor de InputOutputFilter.
PageNumber	Filtro de usuario	Se usa cuando se realiza una consulta al sistema externo. Su valor representa el índice basado en cero de la página que el sistema externo debe devolver para un resultado de varias páginas.
Password	Filtro de sistema	Se usa cuando se llama a operaciones en un sistema externo y el valor que se debe pasar como parámetro de entrada debe representar una contraseña que se almacena en el Almacenamiento seguro. Servicios de conectividad empresarial obtiene las credenciales que se asignan a la propiedad SecondarySsoApplicationId y la propiedad SsoProviderImplementation de la instancia del sistema externo (LobSystemInstance). Usa la contraseña que se obtiene de las credenciales como el valor del parámetro de entrada que se asocia al filtro Password. Nota SecondarySSOApplicationId es diferente de SSOApplicationId. SecondarySSOApplicationId se usa en el filtro UserName y el filtro Password. Para obtener más información, vea Propiedades personalizadas de BDC y Elemento LobSystemInstance en LobSystemInstances (esquema BDCMetadata).
SSOTicket	Filtro de sistema	Se usa cuando se llama a una operación en un sistema externo y el valor que se debe pasar como parámetro de entrada debe representar un vale de inicio de sesión del Almacenamiento seguro para el usuario. La aplicación o el servicio de destino puede canjear este vale para obtener las credenciales de usuario. El Almacenamiento seguro usa la propiedad SSOProviderImplementation que se especifica en la instancia del sistema externo y solicita a este proveedor que emita un SSOTicket. Este SSOTicket se pasa como parámetro de entrada asociado al filtro SSOTicket.
Timestamp	Filtro de usuario	Se usa cuando se llama a una operación en el sistema externo. Su valor representa la hora en la que el cliente llamó a esta función por última vez. El sistema externo puede usar posteriormente este valor para notificar los cambios realizados después de la hora especificada.
UserContext	Filtro de sistema	Se usa cuando se llama a una operación en un sistema externo y el valor que se debe pasar como parámetro de entrada debe representar el contexto de usuario. En este caso, Servicios de conectividad empresarial usa la propiedad UserContextType en el filtro (FilterDescriptor) para buscar un valor y establecerlo en el parámetro de entrada. Si el UserContextType que se especifica es MachineId, el valor que se pasa al parámetro de entrada es el identificador único de la instalación del sistema operativo del equipo. Si el UserContextType que se especifica es QualifiedUserName, el valor que se pasa al parámetro de entrada es uno de los siguientes: Si el modo de inicio de sesión del usuario es Windows clásico, el valor es el nombre de inicio de sesión de Windows para el usuario. Esto contiene el nombre de dominio y el nombre de usuario (por ejemplo, nombreDeDominio/nombreDeUsuario). Si el modo de inicio de sesión para el usuario se basa en notificaciones, el valor que se pasa es el valor único que identifica al usuario (por ejemplo, pertenencia: nombreDeUsuario, nombreDeUsuario@proveedor.com).
UserCulture	Filtro de sistema	Se usa cuando se llama a una operación en el sistema externo y el valor que se debe pasar como parámetro de entrada debe representar la referencia cultural del entorno de usuario que invoca la operación. Servicios de conectividad empresarial usa la propiedad Format en el filtro para buscar un valor y establecerlo en el parámetro de entrada: Si el valor de la propiedad Format es RFC1766, el valor que se debe pasar al parámetro de entrada es el nombre de la referencia cultural. Para obtener más información, vea CultureInfo.Name. Si el valor de la propiedad Format es TwoLetterISO, el valor que se debe pasar al parámetro de entrada es el nombre de idioma ISO de dos letras de la referencia cultural. Para obtener más información, vea CultureInfo.TwoLetterISOLanguageName. Si el valor de la propiedad Format es ThreeLetterISO, el valor que se debe pasar al parámetro de entrada es el nombre de idioma ISO de tres letras de la referencia cultural. Para obtener más información, vea CultureInfo.ThreeLetterISOLanguageName. Si el valor de la propiedad Format es ThreeLetterWindows, el valor que se debe pasar al parámetro de entrada es el nombre de idioma de Windows de tres letras de la referencia cultural. Para obtener más información, vea CultureInfo.ThreeLetterWindowsLanguageName. Si el valor de la propiedad Format es LCID, el valor que se debe pasar al parámetro de entrada es el LCID de la referencia cultural. Para obtener más información, vea CultureInfo.LCID.
UserName	Filtro de sistema	Se usa cuando se llama a una operación en un sistema externo y el valor que se debe pasar como parámetro de entrada debe representar el nombre de usuario que se almacena en el Almacenamiento seguro. Servicios de conectividad empresarial obtiene las credenciales que se asignan a la propiedad SecondarySsoApplicationId y la propiedad SsoProviderImplementation de la instancia del sistema externo. Usa el nombre de usuario que se obtiene de las credenciales como el valor del parámetro de entrada que se asocia al filtro de sistema UserName. Nota SecondarySSOApplicationId es diferente de SSOApplicationId. SecondarySSOApplicationId se usa en el filtro UserName y el filtro Password. Para obtener más información, vea Propiedades personalizadas de BDC y Elemento LobSystemInstance en LobSystemInstances (esquema BDCMetadata).
UserProfile	Filtro de sistema	Se usa cuando se llama a una operación en un sistema externo y el valor que se debe pasar como parámetro de entrada debe ser una propiedad en el perfil del usuario actual. Servicios de conectividad empresarial usa las propiedades UserProfileProvider y UserProfilePropertyName que se especifican en el filtro para buscar un valor y establecerlo en el parámetro de entrada. UserProfileProvider se usa para recuperar el perfil del usuario actual, mientras que UserProfilePropertyName contiene el nombre de la propiedad cuyo valor en el perfil del usuario se debe pasar al parámetro de entrada.
Wildcard	Filtro de usuario	Se usa cuando se realiza una consulta a un sistema externo. El valor representa un patrón de caracteres normales y caracteres comodín que se compara con el valor de un campo determinado del conjunto de EntityInstances. El sistema externo devuelve solo aquellas EntityInstances cuyos valores de campo coinciden con el patrón especificado.