Шаг 5: Создайте обработчик рабочего процесса в Visual Studio

Существует два типа обработчиков рабочих процессов, можно создать: рабочий про��есс SharePoint или настраиваемого рабочего процесса. Рабочий процесс SharePoint интегрируется с SharePoint путем создания рабочего процесса на узле SharePoint, указанный вами. Обработчик настраиваемого рабочего процесса.NET библиотека классов, создаваемых, которая может выполнять любые действия, указанный вами.

Создание рабочего процесса SharePoint

Создайте рабочий процесс SharePoint для вашей организации.

1. В Visual Studio 2010 создайте новый проект «Последовательный рабочий процесс». Этот тип проекта находится в шаблоны SharePoint 2010.
2. OnWorkflowActivated включена по умолчанию в конструкторе для вашего решения. Щелкните правой кнопкой мыши элемент управления и выберите команду создать обработчики.
3. Visual Studio создает класс, наследующий от класса SequentialWorkflowActivity. Этот класс содержит workflowId свойство , содержащее Идентификатор рабочего процесса, workflowProperties класс, содержащий данные, связанные с деятельностью и метод с именем onWorkflowActivated1_Invoked , вызывается при активации рабочего процесса. Если вы хотите выполнить какие-либо пользовательскую обработку для рабочего процесса, включите его в этот метод. Данные, которые передаются из рабочего процесса служба хранится в виде строка в workflowProperties.InitiationData.
4. Откомпилируйте и разверните ваш рабочий процесс. Для этого щелкните правой кнопкой мыши проект в Solution Explorer и нажмите кнопку развернуть.

Создание настраиваемого рабочего процесса

Настраиваемый рабочий процесс.Сборку библиотеки классов NET, который реализует Microsoft.MasterDataServices.Core.Workflow.IWorkflowTypeExtender интерфейс. Вызовы служба MDS рабочего процесса интеграции StartWorkflow метод для запуска кода. Выполните следующие действия для создания сборки и настройки MDS рабочего процесса интеграции служба для вызова интерфейс:

1. В Visual Studio создайте новый проект библиотеки классов, использующий язык по вашему выбору. Для создания библиотеки классов C#, выберите Visual C# \Windows типы проектов и выберите Библиотека классов шаблон. Введите имя для вашего проекта, такие как MDSWorkflowTest и нажмите кнопку ОК.
2. Добавить ссылку на Microsoft.MasterDataServices.Core.dll. В Solution Explorer панели, щелкните правой кнопкой мыши ссылки на и выберите Добавить Reference…. В Добавить ссылку диалоговое окно, перейдите на Просмотр вкладку и перейдите в каталог C:\Program файлы\Microsoft SQL Server\Master Data Services\WebApplication\bin. Выберите Microsoft.MasterDataServices.Core.dll и нажмите кнопку ОК.
3. Откройте файл Class1.cs, дважды щелкнув его в Solution Explorer панели.
4. Добавить «с помощью Microsoft.MasterDataServices.Core.Workflow;» под другой с помощью заявления.
5. Переименуйте класс WorkflowTester и наследовать от IWorkflowTypeExtender. Класса объявление должен выглядеть как в следующем примере:
   public class WorkflowTester: IWorkflowTypeExtender
6. Реализуйте интерфейс. Щелкните правой кнопкой мыши IWorkflowTypeExtender в файле ккройте файл Class1.cs, дважды щелкнув его в Solution Explorer панели.
7. Добавить «с помощью Microsoft.MasterDataServices.Core.Workflow;» под другой с помощью заявления.
8. Переименуйте класс WorkflowTester и наследовать от IWorkflowTypeExtender. Класса объявление должен выглядеть как в следода, выберите Реализовать интерфейс\Реализовать интерфейс в меню. Это создает код-заглушку для всех членов интерфейс.
9. Добавьте любой код, вы желаете StartWorkflow метод. Этот метод вызывается MDS рабочего процесса интеграции служба запуска рабочего процесса. Полный пример кода и описание параметров StartWorkflow метод включены в последнем разделе настоящего документа.
10. Постройте решение.
11. Скопируйте сборку MDSWorkflowTest.dll в расположение MDS рабочего процесса интеграции служба исполняемый файл в каталог C:\Program файлы\Microsoft SQL Server\Master Data Services\WebApplication\bin.
12. В зависимости от конфигурация вашего сервера может потребоваться предоставить пользователю mds_workflow_service разрешения Чтение и выполнение на MDSWorkflowTest.dll. В проводнике Windows щелкните правой кнопкой мыши MDSWorkflowTest.dll и выберите Свойства. В Свойства диалоговое окно, перейдите на безопасности щелкните изменить...., click Add…, и добавьте пользователя < имя_сервера > \mds_workflow_service. Mds_workflow_service пользователю предоставляется разрешения Чтение и выполнение по умолчанию. Нажмите кнопку ОК, чтобы закрыть все диалоговые окна, которые открыли.
13. Mds_workflow_service пользователю предоставьте любые дополнительные разрешения, необходимо выполнить операции потока, такие как разрешения на чтение и запись на другую базу данных в вашей системе.

Шаг 6: Обновление MDS рабочего процесса интеграции служба файл веб-конфигурации

Отредактируйте файл конфигурация веб услуг данных мастер включить имя сервера служб данных Master и базы данных и сборки пользовательского рабочего процесса. Если вы используете рабочего процесса SharePoint, вы не должны включать сведения о сборке.

Отредактируйте файл веб- конфигурация Master Data Services

Если используется проверка подлинности Windows не нужно указать пользователя или пароль в файле конфигурация . Кроме того если используется проверка подлинности SQL Server , укажите Идентификатор пользователя и пароль имени входа SQL Server , имеет необходимые разрешения на базу данных Master Data Services.

1. На сервере, где установлены службы данных Master откройте повышенной командной строки.
2. Откройте Microsoft.MasterDataServices.Workflow.exe.config в блокноте C:\Program файлы\Microsoft SQL Server\Master данных Services\WebApplication\bin.

3.  Найти этот параметр:
< имя параметра = «connectionstring» serializeAs = «Строка» >

1. Обновите значение для отражения сервера и базы данных. Если ваши установки SQL Server использует вариант-параметры сортировки, а затем имя базы данных, необходимо ввести в этом же вариант как в базе данных. К примеру, <value> Server = myServer; базы данных = myDatabase; встроенная безопасность = True </value>
2. Параметр ConnectionString добавьте другой <setting> тег для вашего настраиваемого рабочего процесса. Например:
   < имя параметра = «workflowtypeextenders» serializeAs = «Строка» >
   <value> TEST=MDSWorkflowTestLib.WorkflowTester, MDSWorkflowTestLib </value>
   </setting>
   следующих рекомендаций поможет вам построить ваш <setting> Метки:

• Внутренний текст <value> тег представляет собой Идентификатор < > = < имя типа сборки рабочего процесса >.
• < workflow ID > Это строка , используемая для идентификации этой сборки рабочего процесса при создании бизнес-правила в Master Data Manager.
• < имя типа сборки рабочего процесса > уточненное пространством имен имя класса рабочего процесса, а затем запятую, следуют отображаемое имя сборки.
• Если сборка строго именованной, вы также должны включать в себя информацию о версия и его PublicKeyToken.
• Вы можете включить несколько <setting> Теги, если вы создали несколько обработчиков рабочего процесса для различных типов рабочих процессов.
• Если вы используете рабочего процесса SharePoint, не нужно включать этот <setting> тег.

1. Сохраните и закройте файл.
2. В зависимости от confugration вашего сервера может появиться сообщение об ошибке «Отказано в доступе» при попытке сохранить файл. Если это происходит, временно отключите контроль учетных записей (UAC) на сервере. Чтобы сделать это, откройте панель управления, нажмите кнопку системы и безопасности. Под Противоминный центр, нажмите кнопку Изменения параметров контроля учетных записей пользователей. В Параметров контроля учетных записей пользователей диалоговое окно, слайд панели в нижней, так, что вы никогда не будете оповещены. Нажмите кнопку ОК. В диалоговом окне подтверждения нажмите кнопку Да. Перезагрузите компьютер и повторите выше процедуру для редактирования файла конфигурация . После сохранения файла, сбросить настройки UAC по умолчанию уровень.

Шаг 7: Установка и запуск службы рабочего процесса интеграции

Установите и запустите MDS рабочего процесса интеграции SQL Server служба.

Грант на чтение и выполнение рабочего процесса пользователю MDS разрешение

В зависимости от конфигурация вашего сервера может потребоваться предоставить пользователю mds_workflow_service разрешения Чтение и выполнение на исполняемый файл служба MDS рабочего процесса интеграции.

1. На сервере, где установлены службы данных Master откройте проводник Windows и перейдите в каталог C:\Program файлы\Microsoft SQL Server\Master Data Services\WebApplication\bin.
2. Щелкните правой кнопкой мыши Microsoft.MasterDataServices.Workflow.exe и выберите Свойства.
3. В Свойства диалоговое окно, перейдите на безопасности щелкните изменить...., click Add…, и добавьте пользователя < имя_сервера > \mds_workflow_service. Mds_workflow_service пользователю предоставляется разрешения Чтение и выполнение по умолчанию.
4. Нажмите кнопку ОК, чтобы закрыть все диалоговые окна, которые открыли.
5. На сервере, где установлены службы данных Master откройте повышенной командной строки.
6. Перейти к % windir%\Microsoft.NET.
7. Если у вас есть более чем одну папку Framework, определить, какие самые последние и перейти к этой папке.
8. Перейдите к вложенной папке рамки, например Framework\v4.0.30319.
9. Убедитесь, что InstallUtil.exe находится в папке.
10. Скопируйте путь для InstallUtil.exe, например: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe.
11. В командной строке перейдите в каталог C:\Program файлы\Microsoft SQL Server\Master Data Services\WebApplication\bin.
12. Тип: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil Microsoft.MasterDataServices.Workflow.exe
13. Нажмите клавишу ВВОД. Отображается диалоговое окно, запрашивать имя пользователя и пароль.
14. Введите < имя_сервера > \mds_workflow_service имя пользователя и пароль, указанный при создании пользователя. Пользователь должен иметь разрешения Чтение и выполнение для всех сборок, которые обрабатывают рабочего процесса обработки, а также соответствующий доступ к любым ресурсам, испрашивались Ассамблеей обработчика рабочего процесса, такие, как доступ чтения и записи в базу данных, которую будет изменить обработчик рабочего процесса.
15. Нажмите кнопку ОК.
16. Из меню "Пуск" выберите команду выполнить.
17. Тип: Services.msc
18. Нажмите кнопку ОК. Оснастка «службы» в открывается.
19. Найдите служба под названием SQL Server MDS рабочий процесс интеграции и выберите его.
20. Нажмите кнопку начать связь.
21. После запуска служба , закройте оснастку службы.

Найти утилиту установки

Установка служба

Запустите службу

Шаг 8: Создать и применить бизнес-правила в Master Data Manager

Создаете бизнес-правило в Master Data Manager. Когда данных проверяется на соответствие бизнес-правило, заполняется очередью компонента Service Broker в базе данных Master Data Services. служба периодически проверяет очереди, отправляет данные в обработчик указанного рабочего процесса, а затем очищается очереди.

создать и опубликовать бизнес-п��авило

Необходимо сначала создать и опубликовать бизнес-правило, которое будет запускать рабочий процесс при применении.

Следует убедиться, что ваш бизнес-правило содержит действия, изменяющие значения атрибутов, таким образом, чтобы правило имеет значение false, после того, как он был применен один раз. Например бизнес-правило может иметь значение true, когда значение атрибута цены больше чем 500 и утверждено значение атрибута является пустым. Правило затем можно включить два действия: один, чтобы набор значение атрибута утверждено ожидания и один запускать рабочий процесс.

Кроме того вы можете создать правило, использующее состояние «изменилась» и добавить ваши атрибуты для изменения групп слежения. Примечание: эта функция не доступна в SQL Server 2008 R2 ноября сообщества Technology Preview и более ранних версий.

Чтобы создать бизнес-правило в Master Data Manager, необходимо иметь разрешение для функциональной области Системное администрирование и быть администратором моделей для модели, вы хотите создать бизнес-правило для. Для получения дополнительной информации, смотрите администраторов (службы данных Master).

1. В Master Data Manager, щелкните Системное администрирование.
2. В строке меню выберите пункт Управление и нажмите бизнес-правила.
3. На странице обслуживание бизнес правила выберите модель, сущность, тип элемента и атрибут.
4. Нажмите Добавить бизнес-правило. Строка добавляется в таблица и будет выделена.
5. Нажмите Изменить выбранное бизнес-правило.
6. На панели Компоненты разверните узел Условия.
7. Перетащите узел условия IF область условий.
8. В панели сущности-особые атрибуты щелкните атрибут и перетащите его в область редактирования действий выбора атрибута label.
9. В области изменить условие заполните все поля и нажмите кнопку Сохранить элемент.
10. В области компонентов разверните узел действия.
11. В группе внешних действиеперетащите метка действия панели этого запустить рабочий процесс.
12. В области Атрибуты сущности щелкните любой атрибут и перетащите его в область редактирования действий выбора атрибута label. Этот атрибут не имеет отношения рабочего процесса.
13. В области действий, изменить, в списке Тип рабочего процесса введите тег, определяющий обработчик рабочего процесса. Чтобы запустить рабочий процесс SharePoint, введите SPWF. В противном случае введите метку, указанную пользователем в файл веб- конфигурация для сборки, например, тест.
14. При необходимости установите флажок включить член данных. Выберите это включить имена и значения атрибутов в XML, который передается обработчику рабочего процесса.
15. В поле узел рабочего процесса введите имя веб-сайта. Для рабочего процесса SharePoint это должно быть узла SharePoint. Например http://site_name. Для настраиваемого рабочего процесса это может не применяться, но могут быть использованы для Добавлено контекстное.
16. В поле Имя рабочего процесса введите имя рабочего процесса из Visual Studio. В обозревателе решений Visual Studio это значение указано в полеотображаемое имя. Для настраиваемого рабочего процесса это может не применяться, но могут быть использованы для Добавлено контекстное.
17. В нижней части страницы нажмите кнопку Сохранить.
18. В верхней части страницы нажмите кнопку назад. Откроется страница Бизнес правила обслуживания.
19. Нажмите кнопку Опубликовать бизнес-правила.
20. В диалоговом окне подтверждения нажмите кнопку ОК. Состояние правила изменится на Активно.

Применить бизнес-правила

Теперь вы должны применить бизнес-правила для ваших данных. Это действие передает данные в очередь компонента Service Broker.

1. На домашней странице диспетчера данных Master выберите обозреватель.
2. Измените сущность с членами, которые вы хотите проверить.
3. Нажмите кнопку Применить бизнес-правила.

Заполняется SQL Server очереди компонента Service Broker. Когда служба проверяет очереди, он отправляет данные обработчику рабочего процесса и очищает очередь.

Устранение сбоев в работе

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

Обработчик рабочего процесса не получает данных

Если обработчик рабочего процесса не получает данных, вы можете попробовать отладки рабочего процесса служба или просмотра очереди компонента Service Broker, чтобы определить, если правильные данные все еще находится в очереди.

Выполнить отладку службы рабочего процесса

1. Остановите служба , если она запущена.
2. Откройте командную строку.
3. Перейдите в место служба и запустите служба в консольном режиме, введя: Microsoft.MasterDataServices.Workflow.exe-консоль
4. Нажмите клавишу ВВОД.
5. В Master Data Manager, обновите этот атрибут и снова применить бизнес-правила . Подробные журналы отображаются в окноконсоли.

Просмотр очереди компонента Service Broker служба

Очереди компонента Service Broker, содержащий базовые данные передаются как часть рабочего процесса: mdm.microsoft/mdm/queue/externalaction. Эта очередь можно найти в SQL Server Management Studio, открытия базы данных Master Data Services в обозревателе объектов, а затем открытие Компонент Service Broker и очереди. Щелкните правой кнопкой очередь и выберите выберите Top 1000 строк для просмотра top 1000 строк в очереди.

Если служба очереди должным образом, этой очереди должен быть пустым.

Если имеются данные в очередь, которую вы хотите удалить, запустите следующий сценарий SQL, чтобы очистить очередь. MyDatabase необходимо присвоить имя вашей базы данных Master Data Services.

Объявите uniqueidentifier @ разговор

Хотя существует (выберите 1 из [myDatabase]. [МДМ].[microsoft/МДМ/очередь/externalaction])

начать

набор @ разговор = (выберите top 1 conversation_handle от [myDatabase]. [МДМ].[microsoft/МДМ/очередь/externalaction])

конец разговора @ разговор с очистки

конец

Пример кода пользовательского рабочего процесса и XML-описание

Когда вы создаете библиотеку классов пользовательского рабочего процесса, создается класс, реализующий интерфейсMicrosoft.MasterDataServices.Core.Workflow.IWorkflowTypeExtender. Этот интерфейс включает в себя один методStartWorkflow, который вызывается элементом MDS рабочего процесса интеграции служба при запуске рабочего процесса. StartWorkflow метод содержит два параметра: workflowType содержит тип рабочего процесса вы ввели в Master Data Manager, и dataElement содержит метаданные и данные элемент для элемент , вызвавшая рабочего процесса бизнес-правила.

Пример кода

В следующем кода примере показано как вы как реализовать StartWorkflow метод для извлечения атрибутов имя, код и LastChgUserName из XML-данных для элемента, который вызвал рабочего процесса бизнес-правила и как вызывать хранимую процедуру для вставки их в другую базу данных.

с помощью системы;

с помощью System.Collections.Generic;

с помощью System.Linq;

с помощью System.Text;

с помощью System.IO;

с помощью System.Data.SqlClient;

с помощью System.Xml;

с помощью Microsoft.MasterDataServices.Core.Workflow;

пространство имен MDSWorkflowTestLib

{

    государственные класса WorkflowTester : IWorkflowTypeExtender

    {

# Region IWorkflowTypeExtender членов

        государственные void StartWorkflow (строка workflowType, System.Xml.XmlElement dataElement)

        {

            / / Extract атрибуты, мы хотим из данных элемента.

            XmlNode NameNode = dataElement.SelectSingleNode («//ExternalAction/MemberData/Name»);

            XmlNode CodeNode = dataElement.SelectSingleNode («//ExternalAction/MemberData/Code»);

            XmlNode EnteringUserNode = dataElement.SelectSingleNode («//ExternalAction/MemberData/LastChgUserName»);

            / / Открыть подключение на базе рабочего процесса.

            SqlConnection workflowConn = новый SqlConnection(@ "источник данных = < экземплярсервера >; Первоначальный каталог = WorkflowTest; Встроенная безопасность = True ");

            / / Создать команду для вызова хранимой процедуры, которая добавляет нового пользователя в базу данных рабочего процесса.

            SqlCommand addCustomerCommand = новый SqlCommand(«addnewcustomer», workflowConn);

addCustomerCommand.CommandType = System.Data.CommandType.StoredProcedure;

addCustomerCommand.Parameters.Add (новый SqlParameter(«@ имя», NameNode.InnerText));

            SqlCommand addCustomerCommand = addCustomerCommand.Parameters.Add (новый SqlParameter(«@ код», CodeNode.InnerText));

addCustomerCommand.Parameters.Add (новый SqlParameter(«@ EnteringUser», EnteringUserNode.InnerText));

            / / Выполнить команду.

            workflowConn.Open();

            addCustomerCommand.ExecuteNonQuery();

            workflowConn.Close();

        }

        # endregion

    }

}

Данные элемента XML

StartWorkflow метод получает блок XML, который содержит метаданные и данные о элемент , вызвавший рабочего процесса бизнес-правила. В следующем примере показано, как выглядит XML:

<ExternalAction>

<тип>тест< /тип>

<SendData>1< /SendData>

<Server_URL>это мой тест!< /Server_URL>

<Action_ID>тест рабочий процесс< /Action_ID>

<Model_ID>5< /Model_ID>

<Model_NameAction_ID>тест рабочий процесс< /Action_ID>

<Model_ID>5< /Model_ID>>клиента< /Model_Name>

<Entity_ID>34< /Entity_ID>

<Entity_Name>клиента< /Entity_Name>

<Version_ID>8< /Version_ID>

<MemberType_ID>1< /MemberType_ID>

<Member_ID>12< /Member_ID>

<MemberData>

<ID>12</ID>

<Version_ID>8< /Version_ID>

<ValidationStatus_ID>3< /ValidationStatus_ID>

<ChangeTrackingMask>0< /ChangeTrackingMask>

<EnterDTM>2011-02-25T20:16:36.650< /EnterDTM>

<EnterUserID>2< /EnterUserID>

<EnterUserName>имя_пользователя< /EnterUserName>

<EnterUserMuid>EEF91D48-B673-4D83-B95F-5A363C11DE91< /EnterUserMuid>

<EnterVersionId>8< /EnterVersionId>

<EnterVersionName>VERSION_1< /EnterVersionName>

<EnterVersionMuid>52B788C2-2750-4651-9DB0-2CB05A88AA5A< /EnterVersionMuid>

<LastChgDTM>2011-02-25T20:16:36.650< /LastChgDTM>

<LastChgUserID>2< /LastChgUserID>

<LastChgUserName>имя_пользователя< /LastChgUserName>

<LastChgUserMuid>EEF91D48-B673-4D83-B95F-5A363C11DE91< /LastChgUserMuid>

<LastChgVersionId>8< /LastChgVersionId>

<LastChgVersionName>VERSION_1< /LastC">< /LastChgUserMuid>

>

<LastChgVersionMuid>52B788C2-2750-4651-9DB0-2CB05A88AA5A< /LastChgVersionMuid>

<имя>испытания клиента< /имя>

<код>TC< /код>

< /MemberData>

< /ExternalAction>

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

Для получения дополнительной информации:

http://MSDN.Microsoft.com/en-us/library/ee633763.aspx: Master Data Services документация

http://msdn.microsoft.com/en-us/sqlserver/ff943581.aspx: Центр разработчиков служб данных Master

http://www.Microsoft.com/SQLServer/: SQL Server веб-сайт

http://TechNet.Microsoft.com/en-US/SQLServer/: SQL Server TechCenter

http://MSDN.Microsoft.com/en-US/SQLServer/: SQL Server DevCenter