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

Дата последнего изменения: 24 сентября 2009 г.

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

Пользователям может потребоваться извлечение экземпляров внешнего типа контента, соответствующих некоторым условиям, например во внешнем списке. Так, пользователю могут потребоваться данные только о тех клиентах, которые живут в Нью-Джерси, или список заказов конкретного клиента. Для поддержки этих функциональных возможностей разработчики внешних типов контента могут добавлять фильтры в требуемые операции. В примере, приведенном выше, разработчик может создать параметр фильтра "Сравнение" и затем установить тег для поля State в методе Finder с созданным фильтром. Большинство подобных фильтров могут быть связаны с одним методом (API). Затем пользователи выбирают фильтр и указывают его значение. BDC передает значение фильтра внутреннему методу, вставляя его в требуемое место, в результате чего возвращаются только те строки, которые пользователь хочет видеть.

Использование фильтров — это основной способ, который используется подключения к бизнес-данным (BDC) для сбора данных, вводимых пользователем (или системой), и передачи вызову внутреннего API. В сложных наборах параметров фильтры позволяют описать место, в которое необходимо передать значение фильтра. Это достигается за счет добавления тегов входных или выходных параметров в определении метода и отметки места вставки. Следует особо отметить, что внутренний метод должен предоставлять функциональные возможности фильтрации, поскольку только фильтры создают механизм, позволяющий предоставить данную функциональность пользователю.

Бизнес-системы предоставляют различные механизмы фильтрации. Чтобы предоставить пользователям одинаковую семантику фильтрации, независящую от источника данных, BDC использует общие шаблоны. BDC поддерживает несколько фильтров и шаблонов фильтров. Дополнительные сведения см. в статье Типы фильтров, поддерживаемых службой подключения к бизнес-данным

Пользовательские фильтры, используемые, например, для сравнения, указывают, какие входные данные могут быть переопределены пользователями, а системные фильтры, такие как UserContext и UserProfile, позволяют BDC безопасно задавать значения, например маркер пользователя.

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

Чтобы определить, какие фильтры поддерживаются системой и правильно отображают пользовательский интерфейс, клиенты запрашивают репозиторий метаданных.

См. также

Задачи

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