Проектирование модели подключения к бизнес-данным

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

Добавление сущностей

Можно добавить сущность, перетащив или скопировать Сущность из Visual Studio Панель элементов в конструктор BDC.Дополнительные сведения см. в разделе Практическое руководство. Добавление сущности в модель.

Определите поля сущности в классе.Например, если необходимо добавить поле с названием Address в класс Customer.Можно либо добавить новый класс в проект, либо использовать существующий класс, созданный с помощью других средств, таких как "Реляционный конструктор объектов".Имя сущности и имя класса, представляющего сущность, должны совпадать.Отнесение класса к сущности происходит при определении методов модели.

Добавление методов

Служба BDC вызывает методы в модели, когда пользователь просматривает, добавляет, обновляет или удаляет сведения в списке или веб-части на основании модели.Модели каждой задачи, выполняемой пользователем, необходимо добавить метод.Создайте методы, выбрав любой из пяти основных типов методов в окне Подробности метода BDC.В следующей таблице описываются пять основных методов модели BDC:

Метод	Описание
Поиск	Возвращает коллекцию экземпляров сущности.Вызывается при открытии пользователем списка или веб-части.Дополнительные сведения см. в разделе Практическое руководство. Добавление метода Finder.
Конкретный поиск	Возвращает конкретный экземпляр сущности.Вызывается при просмотре пользователем сведений о конкретном элементе списка.Дополнительные сведения см. в разделе Практическое руководство. Добавление определенного метода Finder.
Создание	Добавляет новые данные в источник данных сущности.Вызываемый, когда пользователи предпочитают кнопку Создать элемент на ленте списка на основе модели.Дополнительные сведения см. в разделе Практическое руководство. Добавление метода Creator.
Обновление	Изменяет данные списка.Вызывается при обновлении пользователем информации в списке.Дополнительные сведения см. в разделе Практическое руководство. Добавление метода Updater.
Удаление	Удаляет данные.Вызывается при удалении пользователем элементов из списка.Дополнительные сведения см. в разделе Практическое руководство. Добавление метода Deleter.

Определение параметров метода

При создании метода, Visual Studio добавляет входные и выходные параметры, соответствующие типу метода.Эти параметры представляют собой всего лишь заполнители.В большинстве случаев необходимо изменить параметры таким образом, чтобы они передавали или возвращали правильный тип данных.Например, метод поиска по умолчанию возвращает строку.В большинстве случаев, требуется изменить возвращаемый параметр метода поиска таким образом, чтобы он возвращает коллекцию сущностей.Сделать это можно, изменив дескриптор типа параметра.Дескриптор типа представляет собой коллекцию атрибутов, описывающих тип данных параметра.Дополнительные сведения см. в разделе Практическое руководство. Определение дескриптора типа параметра.

Visual Studio позволяет копировать дескрипторы типа из одного параметра модели в другой.Например, следует определить дескриптор типа с именем CustomerTD для возвращаемого параметра метода GetCustomer.Дескриптор типа CustomerTD можно скопировать в Проводник BDC, а затем вставить этот дескриптор типа во входной параметр метода CreateCustomer.Это позволит не определять один и тот же дескриптор типа более одного раза.

Метод экземпляров

При создании метода, Visual Studio добавляет метод экземпляра по умолчанию.Метод экземпляра представляет собой ссылку на метод, плюс значения параметра по умолчанию.Единичный метод может содержать несколько экземпляров метода.Каждый экземпляр является комбинацией сигнатуры метода и набора значений по умолчанию.Дополнительные сведения см. в разделе Практическое руководство. Определение дескриптора типа параметра.

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

Чтобы добавить в экземпляр метода значения по умолчанию, необходимо непосредственно изменить XML модели.Дополнительные сведения см. в разделе Значение по умолчанию.

Добавление дескрипторов фильтра

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

SharePoint предоставляет несколько компонентов, позволяющих пользователям указывать значения фильтра.Например, веб-части бизнес-данных имеют текстовое поле фильтра.Пользователи могут ограничить данные в списке, введя значение в текстовое поле.Дополнительные сведения о том, как добавить в метод дескриптор фильтра, см. в разделе Практическое руководство. Добавление дескриптора фильтра в метод Finder.

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

Необходимо задать значения свойств дескриптора фильтра Связанный дескриптор типа, Имя и Тип.Все прочие свойства являются необязательными.

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

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

Дополнительные сведения о свойствах дескриптора типа см. в разделе Дескриптор типа.

Использование значений по умолчанию

В некоторых случаях пользователь может не указывать значение фильтра.Использовать значение по умолчанию можно, добавив методу экземпляра значение по умолчанию или настроив значение по умолчанию в коде метода.Дополнительные сведения о том, как добавить методу значение по умолчанию см. раздел Метод экземпляра.Пример установки значения по умолчанию для входного параметра в коде метода см. в разделе Практическое руководство. Добавление дескриптора фильтра в метод Finder.

Проверка модели

Во время разработки, модель можно проверить.Visual Studio выявляет проблемы, которые могут нарушить ожидаемое поведение модели.Эти проблемы в Visual Studio отображаются в Списке ошибок.

Можно проверить модель. для этого откройте контекстное меню в конструкторе BDC, а затем выбрать Проверить.Если модель содержит какие-либо ошибки, то они отображаются в Список ошибок.Можно быстро переместить курсор в код, который содержит ошибку, дважды щелкните ошибку в списке.В качестве альтернативы можно выбрать ключи F8 или Shift+F8 повторно на шаг вперед или назад по ошибки в списке.

Ошибки проверки могут возникнуть в случае, если правила модели некоторым образом нарушены.Например, если свойство IsCollection дескриптора типа имеет значение true, а дочерний дескриптор типа не существует, отобразится ошибка проверки.Возможно следует обратиться к правилам модели BDC, чтобы понять некоторые ошибки, отображаемые в Списке ошибок Visual Studio.Дополнительные сведения о правилах модели BDC см. в разделе Схема метаданных BDC.

Отладка решения, содержащего модель

Исправить код можно во время отладки кода в Visual Studio.Чтобы отладить код, установите точки останова в любом месте кода, а затем запустите отладчик.Visual Studio откроет сайт SharePoint.В SharePoint создайте список или веб-часть, использующую бизнес-данные.Затем, можно выполнить код по шагам.Дополнительные сведения об отладке проектов SharePoint см. в разделе Устранение неполадок решений SharePoint.

Также возможна отладка кода в пользовательских сборках, добавляемых к проекту.Однако для отладки кода в пользовательской сборке необходимо добавить сборку к пакету решения.Дополнительные сведения см. в разделе Практическое руководство. Добавление и удаление дополнительных сборок.

Дополнительные сведения о добавлении пользовательской сборки в проект см. в разделе Практическое руководство. Добавление пользовательской сборки в функцию BDC.

Настройка системы безопасности BDC

Возможно, для отладки решения потребуется изменить параметры безопасности в SharePoint.Чтобы изменить настройки, откройте на веб-сайте центра администрирования SharePoint 2010 сервисное приложение подключения к бизнес-данным.В диалоговом окне Задание разрешений хранилища метаданных добавьте учетную запись пользователя, а затем выберите любой из следующих параметров:

Задача	Параметр
Развертывание моделей в службе BDC.	Edit
Создание списков и веб-частей с помощью внешних типов контента (сущностей) модели.	Выбирается в клиентах
Создание, чтение, обновление и удаление данных сущности.	Выполнение

Дополнительные сведения о настройках см. в разделе Управление службой подключения к бизнес-данным.

Также можно установить параметры безопасности для отдельных моделей или внешних типов контента.Дополнительные сведения о том, как устанавливать настройки безопасности для модели см. в разделе Управление моделью BDC.Дополнительные сведения о том, как устанавливать настройки безопасности для внешнего типа контента см. в разделе Управление внешним типом контента.

Примечание
Используйте эти настройки для отладки решения на локальном сервере SharePoint.Дополнительные сведения о настройке параметров безопасности, относящихся к BDC, на рабочем сервере SharePoint см. Обзор безопасности службы подключения бизнес-данных.

Отзыв поврежденных моделей

При первом запуске отладчика Visual Studio развертывает всю модель в SharePoint.Каждый следующий раз Visual Studio обновляет модель в SharePoint с изменениями, внесенными между развертываниями.

Может возникнуть ситуация, в которой потребуется с помощью Visual Studio полностью отозвать модель из SharePoint.Например, модель может быть повреждена.Чтобы повторно развернуть модель в SharePoint, свойству модели Добавочное обновление задайте значение False, затем запустите отладчик.Свойство Добавочное обновление отображается в окне Свойства при выборе узла, представляющего модель в Обозревателе BDC.По умолчанию модели присваивается имя BdcModel1.

Изменение имен идентификаторов сущностей в модели

При изменении имени идентификатора после развертывания модели может возникнуть ошибка развертывания.Эту ошибку нельзя разрешить, задав для свойства модели Добавочное обновление значение False.Необходимо вручную отозвать модель, а затем выполнить развертывание решения заново.Дополнительные сведения см. в разделе Устранение неполадок решений SharePoint.Можно избежать этой ошибки, задав для свойства модели Добавочное обновление значение False до первого развертывания модели.

Размещение документации для элементов модели BDC

Visual Studio добавляет к модели XML-элемент для каждой сущности, метода или другого создаваемого элемента.Атрибуты элемента отображаются в качестве свойств в окне Свойства.Дополнительные сведения об элементах и атрибутах, создаваемых Visual Studio при конструировании модели см. Схема метаданных BDC.

Связанные разделы

Заголовок	Описание
Общие сведения о средствах разработки моделей подключения к бизнес-данным	Описывает средства, которые можно использовать для визуального проектирования модели для BDC.
Практическое руководство. Добавление сущности в модель	Показывает способы добавления в модель внешних типов контента или сущностей.
Практическое руководство. Добавление метода Finder	Показывает способы добавления метода, позволяющего пользователям просматривать сущности в списке или веб-части.
Практическое руководство. Добавление определенного метода Finder	Показывает способы добавления метода, позволяющего пользователям просматривать сведения об определенной сущности.
Практическое руководство. Добавление метода Creator	Показывает способы добавления метода, позволяющего пользователям добавлять записи в источник данных непосредственно из списка или веб-части.
Практическое руководство. Добавление метода Deleter	Показывает способы добавления метода, позволяющего пользователям удалять данные из источника данных с помощью параметров пользовательского интерфейса списка или веб-части.
Практическое руководство. Добавление метода Updater	Показывает способы добавления метода, позволяющего пользователям изменять данные в источнике данных непосредственно из списка или веб-части.
Практическое руководство. Добавление параметра в метод	Показывает способы использования окна "Подробности метода" в Visual Studio для добавления в метод входных и возвратных параметров.
Практическое руководство. Определение дескриптора типа параметра	Показывает способы определения в модели параметра типов данных.
Практическое руководство. Определение экземпляра метода	Показывает способы создания экземпляра метода, выполняющего BDC.
Практическое руководство. Добавление дескриптора фильтра в метод Finder	Показывает способы, позволяющие пользователю ограничивать количество возвращаемых экземпляров с помощью метода поиска.
Создание ассоциации между сущностями	Описывает определение в модели отношений между сущностями.Бизнес-данные веб-частей, внешних списков и пользовательских приложений могут отображать отношения данных в пользовательском интерфейсе.
Практическое руководство. Создание ассоциации между сущностями	Показывает способы определения в модели отношений между сущностями.
Пошаговое руководство. Создание внешнего списка в SharePoint с помощью бизнес-данных	Предоставляет пошаговые инструкции, показывающие создание и тестирование модели, отображающей контакты во внешнем списке SharePoint.
Интеграция бизнес-данных в SharePoint	Предоставляет обзор создания и проектирования моделей для службы BDC.