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

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

  • Статья

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

Добавить сущности

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

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

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

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

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

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

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

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

Экземпляры методов

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

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

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

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

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

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

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

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

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

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

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

Укажите значения по умолчанию

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание.

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

Извлечение моделей, которые становятся поврежденными

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

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

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

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

Поиск документации по элементам модели BDC

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

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