Поделиться через


Элемент FilterDescriptor в элементе FilterDescriptors (схема BDCMetadata)

Дата последнего изменения: 29 марта 2010 г.

Применимо к: SharePoint Server 2010

Задает дескриптор фильтра для метода.

Пространство имен: https://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Схема: BDCMetadata

<FilterDescriptor Type = "String" FilterField = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </FilterDescriptor>

Атрибуты и элементы

В следующем разделе описываются атрибуты, дочерние элементы и родительские элементы.

Атрибуты

Атрибут

Описание

Type

Обязательный атрибут.

Тип дескриптора фильтра.

В следующей таблице приведен список возможных значений этого атрибута.

Значение

Описание

Limit

Используется при запросе внешней системы и задает ограничение числа внешних элементов (EntityInstances), возвращаемых при вызове метода, которому он принадлежит.

PageNumber

Wildcard

Используется при запросе внешней системы. Значение этого параметра представляет шаблон из обычных и подстановочных знаков, который сравнивается со значением конкретного поля в наборе элементов EntityInstances. Из внешней системы возвращаются только те элементы EntityInstances, значения полей которых соответствуют заданному шаблону.

UserContext

Используется при запросе внешней системы. В качестве значения этого свойства любым клиентским приложением может автоматически задаваться удостоверение пользователя, вызывающего внешнюю систему. В дальнейшем это значение может использоваться внешней системой для авторизации и фильтрации возвращаемых результатов.

UserCulture

Username

Password

LastId

SsoTicket

UserProfile

Используется при запросе внешней системы. Для получения значения этого свойства необходимо проверить текущий профиль пользователя. Это значение используется внешней системой для фильтрации возвращаемых результатов.

Comparison

Используется при запросе внешней системы. Во внешней системе возможно сравнение значения атрибута ComparisonFilter со значением отдельного поля в наборе элементов EntityInstances. В этом случае возвращаются только те элементы EntityInstances, для которых значения поля прошли проверку сравнением.

Timestamp

Input

Используется при вызове операции во внешней системе. Во внешней системе значение атрибута InputFilter может использоваться в качестве дополнительных аргументов операции.

Output

Используется при вызове операции во внешней системе. Дополнительные результаты операции, которые недоступны для получения с помощью атрибута ReturnTypeDescriptor, извлекаются в качестве значения атрибута InputOutputFilter.

InputOutput

Используется при вызове операции во внешней системе. Значение атрибута InputOutputFilter может использоваться во внешней системе в качестве дополнительных аргументов операции. Дополнительные результаты операции, которые недоступны для получения с помощью атрибута ReturnTypeDescriptor, извлекаются в качестве значения атрибута InputOutputFilter.

Batching

BatchingTermination

ActivityId

Атрибут ActivityId используется при вызове операции внешней системы. Этому атрибуту присваивается значение, соответствующее идентификатору GUID, который представляет текущий контекст операции. Если это значение недоступно, формируется случайный идентификатор GUID. В SharePoint Foundation 2010 в этом фильтре используется идентификатор CorrelationID.

FilterField

Необязательный атрибут.

Тип атрибута: String

Name

Обязательный атрибут.

Имя дескриптора фильтра.

Тип атрибута: String

DefaultDisplayName

Необязательный атрибут.

Установленное по умолчанию отображаемое имя дескриптора фильтра.

Тип атрибута: String

IsCached

Необязательный атрибут.

Задает частоту использования этого дескриптора фильтра. Если установлено значение true, в службе подключения к бизнес-данным (BDC) выполняется кэширование этого дескриптора в памяти.

Значение по умолчанию: true

Тип атрибута: Boolean

Дочерние элементы

Элемент

Описание

Элемент LocalizedDisplayNames в MetadataObject (схема BDCMetadata)

Локализованные отображаемые имена дескриптора фильтра.

Элемент Properties в элементе MetadataObject (схема BDCMetadata)

Свойства дескриптора фильтра.

Родительские элементы

Элемент

Описание

Элемент FilterDescriptors в элементе Method (схема BDCMetadata)

Список дескрипторов фильтра для метода.