Инструкции. Создание внешнего типа контента на основе таблицы SQL Server

Дата последнего изменения: 10 августа 2010 г.

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

Создание внешних типов контента, подключающихся к Microsoft SQL Server, в Microsoft Business Connectivity Services (BCS) выполняется очень просто. внешних типов контента в Microsoft SharePoint Designer 2010 поддерживает базы данных Microsoft SQL Server. Достаточно обнаружить нужную базу данных, указать таблицу, представление или хранимую процедуру, выполняющую нужную операцию, а затем вернуть требуемые данные и использовать для создания внешнего типа контента без написания какого-либо кода или XML.

В этом разделе описывается порядок создания внешнего типа контента с именем Customer, основанного на таблице Customers в образце базы данных Northwind SQL Server 2000.

Необходимые компоненты

• Чтобы не усложнять эту процедуру, Microsoft SQL Server 2005 или более поздней версии на сервере, котором выполняется SharePoint Server. В случае установки Microsoft SQL Server на другом компьютере потребуется настройка службы безопасного хранения. Дополнительные сведения см. в статье Практическое руководство. Подключение к внешней системе с использованием службы безопасного хранения.

• База данных Northwind SQL Server 2000, установленная на сервере, где выполняется Microsoft SQL Server.

• Microsoft SharePoint Designer 2010, установленная на клиентском компьютере

Создание внешнего типа контента на основе таблицы SQL Server

В SharePoint Designer 2010 необходимо, чтобы при использовании внешних типов контента для создания внешних типов контента на сайте SharePoint было организовано хранение создаваемых файлов и артефактов (например, внешних списков). Поэтому сначала на сервере, где выполняется SharePoint Server, необходимо создать сайт SharePoint для хранения артефактов внешнего типа контента и открыть его в SharePoint Designer на клиенте.

Создание и открытие сайта SharePoint в SharePoint Designer

1. Перейдите на сервер SharePoint Server и создайте новый веб-сайт.

2. Введите URL-адрес нового веб-сайта как http:// имя_сайта/sdksamples.

3. Выберите любой шаблон, например Пустой сайт.

4. Нажмите кнопку ОК, чтобы создать сайт.

5. На клиентском компьютере запустите SharePoint Designer и откройте созданный сайт. Сайт должен открыться в главном окне SharePoint Designer.

Обратите внимание на новую область навигации в SharePoint Designer. Эта область разработана для использования со всеми объектами SharePoint (такими, как списки и библиотеки, внешние типы контента, главные страницы и рабочие процессы), которые можно создавать и редактировать в SharePoint Designer.

Определение общих параметров внешнего типа контента

1. Чтобы начать создание внешнего типа контента, щелкните Внешние типы контента.

2. На ленте нажмите кнопку Внешний тип контента, как показано на следующем рисунке. Будет открыто приложение внешних типов контента для создания внешнего типа контента.

   

3. На странице создания внешнего типа контента укажите Имя, Отображаемое имя, Пространство имен и Тип элемента Office, как показано на следующем рисунке. Выбранный здесь тип элемента Office определяет поведение Outlook для данного внешнего типа контента. В этом примере внешний тип контента Customer будет обрабатываться как собственный элемент контакта при переводе в автономный режим в Outlook. Поле "Автономная синхронизация" для внешнего списка определяет, разрешено ли пользователям в Microsoft Outlook или SharePoint Workspace переводить в автономный режим внешние списки на основе данного внешнего типа контента. В этом примере примите заданное по умолчанию значение Включено.

   

Добавление подключения к внешней системе

1. Чтобы указать источник данных для внешнего типа контента, щелкните ссылку обнаружения внешних источников данных и определения операций.

2. Нажмите кнопку Добавить подключение, выберите SQL Server в диалоговом окне Выбор типа внешнего источника данных, а затем нажмите кнопку ОК.

3. В диалоговом окне Соединение с SQL Server укажите имя сервера SQL и введите Борей в качестве имени базы данных, как показано на рисунке ниже, а затем нажмите кнопку ОК.

   

4. После проверки подключения к серверу SQL Server, указанному на предыдущем шаге, в обозревателе источников данных будут показаны объекты базы данных в базе данных Northwind. Разверните базу данных для просмотра содержащихся в ней таблиц, представлений и хранимых процедур. Например, выберите таблицу Customer.

Теперь можно определить операции, доступные для внешнего типа контента Customer.

Определение поддерживаемых операций и их параметров и фильтров

1. Необходимо определить методы во внешней системе, которые будут выполнять нужную операцию, а также их параметры. Для таблицы базы данных SQL Server сделать это очень просто, поскольку SharePoint Designer может автоматически создавать базовые методы. В данном примере создаются все базовые операции для внешнего типа контента Customer: Создание, Чтение элемента, Обновление, Удаление и Чтение списка.

   В обозревателе источников данных щелкните правой кнопкой мыши таблицу Customers, а затем выберите команду Создать все операции, как показано на следующем рисунке. Будут автоматически созданы методы для создания, удаления, чтения и обновления записей в таблице Customers базы данных Northwind. Теперь можно выбрать в таблице Customers столбцы для отображения и определить параметры.

   

   Примечание

   Вместо автоматического создания всех базовых операций также можно создавать операции по отдельности, используя различные команды контекстного меню. Это может потребоваться для таблицы базы данных, если предоставление пользователям возможности выполнять все базовые операции нежелательно или если база данных не поддерживает некоторые операции. Кроме того, команда Создать все операции доступна только для таблиц и представлений SQL Server. В представлениях, содержащих несколько таблиц, убедитесь в наличии поддержки операций записи, иначе команда Создать все операции завершится сбоем. Для источников данных, отличных от таблиц (и представлений) SQL Server (таких, как веб-службы или хранимые процедуры SQL Server), необходимо создавать каждую операцию отдельно в SharePoint Designer

2. Теперь выберите столбцы, которые требуется предоставить, и введите параметры возврата для операций, а также параметры фильтра.

   Чтобы настроить параметры, нажмите кнопку Далее. В диалоговом окне Настройка параметров будут отображены все столбцы таблицы Customers. Заметьте, что по умолчанию все столбцы выделены. Отмените выделение ненужных столбцов. В данном примере принимается выбор по умолчанию.

   1. Заметьте, что текущим выделенным полем является CustomerID. Снимите флажок "Обязательное поле", поскольку ввод пользователями идентификатора заказчика в форме обновления не требуется. Однако оставьте установленным флажок "Только для чтения". Это обеспечивает возможность обновления для внешнего типа контента. Если поле идентификатора доступно не только для чтения, обновление элементов во внешней системе невозможно.

   2. Далее выполните две следующих важных настройки. Если внешний тип контента сопоставляется с типом элементов Outlook, сопоставьте поля внешнего типа контента с полями элементов Outlook. Например, для элемента контакта Outlook сопоставьте FirstName из базы данных со столбцом FirstName в контакте Outlook, выполнив сопоставление с FirstName в поле "Свойство Office". Поле FirstName из базы данных будет сопоставлено с именем в элементе контакта Outlook, что сделает возможным отображение поля FirstName в поле "Имя" в форме контакта Outlook. В данном примере сначала сопоставьте ContactName с полем FullName, как показано на рисунке. Затем повторите этот шаг для полей Address, Phone и Fax.

      

   3. Для каждого поля решите, требуется ли доступ к нему в средстве выбора внешнего типа контента. Если поле должно быть доступно в средстве выбора, выделите поле и установите флажок Отображать в средстве выбора. В данном примере установите этот флажок для полей ContactName и Company Name.

   По завершении нажмите кнопку Далее.

3. В диалоговом окне Настройка параметров фильтров определите фильтры данных. Фильтры помогают ограничить внешние элементы (строки), возвращаемые из внешнего источника данных. Всегда строго рекомендуется добавить ограничивающий фильтр для ограничения числа элементов, возвращаемых из внешней системы во время операции Чтение. Для этого щелкните Добавить параметр фильтра. В области свойств выберите (Щелкните, чтобы добавить). В диалоговом окне Настройка фильтра задайте для нового фильтра имя LimitFilter. В поле Тип фильтра выберите Предел. Затем нажмите кнопку ОК.

   

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

   Примечание

   Убедитесь, что значение по умолчанию, введенное для фильтра, меньше 2000. Для подключений к базам данных, содержащим более 2000 строк, подключения к бизнес-данным (BDC) регулирует результаты и поэтому не вернет никаких данных из внешней системы. Если необходимо вернуть более 2000 строк, администратор должен увеличить значения регулирования, заданные по умолчанию на сервере. Дополнительные сведения о пределах регулирования и порядке их увеличения см. в руководстве администратора на сайте TechNet.

4. Нажмите кнопку Готово. Будут созданы все базовые операции, как показано на следующем рисунке.

   

5. Нажмите кнопку Сохранить на ленте, чтобы сохранить определение внешнего типа контента в хранилище метаданных BDC на сервере SharePoint Server. Создание внешнего типа контента успешно завершено.

Внешний тип контента сразу же станет доступен всем клиентским и серверным продуктам Office для использования компонентами представления Business Connectivity Services и настраиваемыми решения через объектную модель Business Connectivity Services. Дополнительные сведения см. в статье Практическое руководство. Создание внешних списков в SharePoint о создании внешнего списка для внешнего типа контента Customer, созданного в этом примере.