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

Статья
04/28/2010

Обновлен: Ноябрь 2007

Применение
Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office. Тип проекта Рабочий процесс SharePoint Версия Microsoft Office Сервер SharePoint 2007 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office.

Тип проекта

Рабочий процесс SharePoint

Версия Microsoft Office

Сервер SharePoint 2007

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

В этом пошаговом руководстве демонстрируется создание простого последовательного шаблона рабочего процесса. Рабочий процесс выполняет проверку свойства библиотеки документов, чтобы определить, выполнялось ли рецензирование документа. Если документ был рецензирован, рабочий процесс завершается.

В данном пошаговом руководстве представлены следующие задачи:

Создание проекта последовательного рабочего процесса SharePoint 2007.
Создание расписания рабочего процесса.
Обработка событий действий.

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

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

Дополнительные сведения о создании шаблонов рабочих процессов SharePoint с помощью Visual Studio Tools for Office см. в разделе Решения рабочих процессов SharePoint.

Обязательные компоненты

Для выполнения инструкций данного пошагового руководства необходимы следующие компоненты:

Visual Studio Tools for Office (необязательный компонент Visual Studio 2008 Professional и Visual Studio Team System).
Microsoft SharePoint Server 2007.
Веб-узел SharePoint Server с заголовком Центр документации и URL-адресом https://localhost/Docs. При изолированной установке Microsoft Office SharePoint Server 2007 на одиночный компьютер данный веб-узел создается автоматически по завершении работы Мастера настройки продуктов и технологий SharePoint.
Microsoft Office Word 2007 или Microsoft Office Word 2003.

Средства Visual Studio Tools for Office по умолчанию устанавливаются с перечисленными версиями Visual Studio. Чтобы проверить, установлены ли эти средства, см. раздел Установка средств Visual Studio для Office.

Добавление свойств в библиотеку документов SharePoint

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

Добавление свойств в библиотеку документов SharePoint

Откройте используемый по умолчанию веб-узел SharePoint Server 2007 в обозревателе Internet Explorer.

Примечание.
URL-адрес веб-узла SharePoint по умолчанию — https://localhost. Если адрес https://localhost поставлен в соответствие веб-узлу, не являющемуся узлом SharePoint, протестировать шаблон рабочего процесса с помощью инструкций данного пошагового руководства будет невозможно.

URL-адрес веб-узла SharePoint по умолчанию — https://localhost. Если адрес https://localhost поставлен в соответствие веб-узлу, не являющемуся узлом SharePoint, протестировать шаблон рабочего процесса с помощью инструкций данного пошагового руководства будет невозможно.

Откройте вкладку Центр документации.
В области переходов выберите Документы.
На странице Документы выберите Параметры, после чего выберите Параметры библиотеки документов.
На странице Настройка документов в разделе Столбцы выберите команду Создать столбец.
Присвойте столбцу имя Статус документа, тип Выбор (меню) и укажите следующие варианты выбора, после чего нажмите кнопку ОК:
- Требуется рецензирование
- Рецензирование завершено
- Запрос изменений
Создайте еще два столбца и присвойте им имена Уполномоченный и Комментарии. Выберите в качестве формата столбца Уполномоченный одиночную текстовую строку, а в качестве формата столбца Комментарии — множественные текстовые строки.

Включение редактирования документов без необходимости их извлечения

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

Включение редактирования документов без извлечения

На странице Настройка документов в разделе Общие параметры выберите Параметры управления версиями.
В поле Требовать извлечения документов перед редактированием? выберите Нет, после чего нажмите кнопку ОК.
Закройте обозреватель Internet Explorer.

Создание проекта последовательного рабочего процесса SharePoint

Последовательный рабочий процесс представляет собой последовательность шагов, которые выполняются поочередно, пока не завершится последнее действие.

Создание проекта последовательного рабочего процесса SharePoint

Запустите Visual Studio.
Откройте диалоговое окно Создать проект разверните узел Office, относящийся к необходимому языку, и выберите узел 2007.
Затем в области Шаблоны выберите Последовательный рабочий процесс SharePoint 2007.
В поле Имя введите MySharePointWorkflow. Если в интегрированной среде разработки выбраны параметры для разработки на Visual C# или общие параметры разработки, также укажите расположение и имя решения.
Нажмите кнопку ОК.

Появится мастер Новый рабочий процесс Office SharePoint.
На странице Имя и веб-узел рабочего процесса для отладки нажмите кнопку Далее, чтобы принять предложенное имя и веб-узел рабочего процесса по умолчанию.
На странице Списки для использования во время отладки нажмите на кнопку Далее, чтобы принять библиотеку документов, список задач и список журнала по умолчанию, а также автоматически связать шаблон рабочего процесса с библиотекой документов.
На странице Выбор условий запуска рабочего процесса нажмите кнопку Готово, чтобы принять предложенные параметры по умолчанию.

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

Шаблоны рабочих процессов содержат одно или несколько расписаний рабочих процессов, в которых представлены действия, подлежащие выполнению. Чтобы организовать действия в расписании, можно воспользоваться конструктором рабочих процессов. Чтобы отследить статус рецензирования документа в списке Документы, нужно добавить два действия: HandleExternalEventActivity и Microsoft.SharePoint.WorkflowActions.OnWorkflowItemChanged.

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

В обозревателе решений дважды щелкните Workflow1.cs или Workflow1.vb, чтобы открыть расписание рабочего процесса в конструкторе.
В конструкторе щелкните действие OnWorkflowActivated1, чтобы выбрать его.
В окне Свойства введите onWorkflowActivated рядом со свойством Invoked и нажмите клавишу ВВОД.

Откроется редактор кода, и в файл кода Workflow1 будет добавлен обработчик событий onWorkflowActivated.
Снова откройте расписание рабочего процесса в конструкторе.
В меню Вид выберите пункт Панель элементов.
Перетащите действие While со вкладки Windows Workflow 3.0 в панели элементов в действие onWorkflowActivated1.
Щелкните действие WhileActivity1, чтобы его выбрать.
В окне Свойства установите для свойства Condition значение Code Condition.
Разверните свойство Condition и введите isWorkflowPending рядом с дочерним свойством Condition, после чего нажмите клавишу ВВОД.

Откроется редактор кода, и в файл кода Workflow1 будет добавлен обработчик событий isWorkflowPending.
Снова откройте расписание рабочего процесса в конструкторе.
Перетащите действие OnWorkflowItemChanged со вкладки Sharepoint Workflow в панели элементов внутрь действия whileActivity1.
Щелкните действие OnWorkflowItemChanged1, чтобы его выбрать.
В окне Свойства задайте значения свойств, как показано в следующей таблице:

Свойство

Значение

CorrelationToken

workflowToken

Invoked

onWorkflowItemChanged

Свойство	Значение
CorrelationToken	workflowToken
Invoked	onWorkflowItemChanged

Обработка событий действий

Последний шаг — проверка статуса документа в каждом действии. Если документ был отрецензирован, рабочий процесс завершается.

Обработка событий действий

В обозревателе решений щелкните правой клавишей мыши файл Workflow1.cs или Workflow1.vb и выберите команду Перейти к коду.
Добавьте приведенное ниже поле в начало класса Workflow1. Данное поле будет использовано в действии, чтобы определить, завершен ли рабочий процесс.
```
Dim workflowPending As Boolean = True
```
```
Boolean workflowPending = true;
```
Добавьте приведенный ниже метод в класс Workflow1. Данный метод выполняет проверку значения свойства Document Status списка документов, чтобы определить, выполнялось ли рецензирование документа. Если свойство Document Status имеет значение Review Complete, метод checkStatus присваивает полю workflowPending значение false, чтобы указать, что рабочий процесс готов к завершению.
```
Private Sub checkStatus()
    If CStr(workflowProperties.Item("Document Status")) = "Review Complete" Then
        workflowPending = False
    End If
End Sub 
```
```
private void checkStatus()
{
    if ((string)workflowProperties.Item["Document Status"] == "Review Complete")
    workflowPending = false;
}
```
Для вызова метода checkStatus необходимо добавить в методы onWorkflowActivated и onWorkflowItemChanged приведенный ниже код. При запуске рабочего процесса метод onWorkflowActivated вызывает метод checkStatus, чтобы определить, было ли уже выполнено рецензирование документа. Если рецензирование документа не производилось, рабочий процесс продолжает работу. При сохранении документа метод onWorkflowItemChanged вызывает метод checkStatus, чтобы определить, было ли уже выполнено рецензирование документа. Пока поле workflowPending имеет значение true, рабочий процесс продолжает работу.
```
Private Sub onWorkflowActivated(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub

Private Sub onWorkflowItemChanged(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub
```
```
private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
{
    checkStatus();
}

private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
{
    checkStatus();
}
```
Добавьте следующий код в метод isWorkflowPending, чтобы проверить состояние свойства workflowPending. При каждом сохранении документа действие whileActivity1 вызывает метод isWorkflowPending. Этот метод проверяет свойство Result объекта ConditionalEventArgs, чтобы определить, должно ли действие WhileActivity1 продолжать работу или завершиться. Если свойство имеет значение true, действие продолжает свою работу. В противном случае действие завершается; также завершается рабочий процесс.
```
Private Sub isWorkflowPending(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ConditionalEventArgs)
    e.Result = workflowPending
End Sub
```
```
private void isWorkflowPending(object sender, ConditionalEventArgs e)
{
    e.Result = workflowPending;
}
```

Тестирование шаблона рабочего процесса SharePoint

При запуске отладчика средства Visual Studio Tools for Office развертывают шаблон рабочего процесса в SharePoint Server 2007 и связывают шаблон рабочего процесса со списком Документы. Чтобы протестировать рабочий процесс, запустите экземпляр шаблона рабочего процесса из документа в списке Документы.

Тестирование шаблона рабочего процесса SharePoint

В обозревателе решений щелкните правой клавишей мыши файл Workflow1.cs или Workflow1.vb и выберите команду Перейти к коду.
Установите точку останова после метода onWorkflowActivated.
Нажмите клавишу F5.

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

Документ добавится в список Документы, и запустится рабочий процесс.
В Visual Studio следует убедиться, что отладчик остановился в точке останова рядом с методом onWorkflowActivated.
Нажмите клавишу F5, чтобы возобновить выполнение.
Закройте документ.
Вернитесь на страницу Документы веб-узла SharePoint по умолчанию.
На странице Документы проверьте, чтобы в столбце MySharePointWorkflow было указано значение Выполняется. Это означает, что рабочий процесс выполняется, и документ ожидает рецензирования.
На странице Документы наведите указатель мыши на документ, нажмите направленную вниз стрелку, после чего выберите Изменить свойства.
Задайте для свойства Статус документа значение Рецензирование завершено и нажмите кнопку ОК.
Вернитесь на страницу Документы веб-узла SharePoint по умолчанию.
На странице Документы проверьте, чтобы в столбце MySharePointWorkflow было указано значение Завершен. Это означает, что рабочий процесс завершился, и рецензирование документа было выполнено.

Следующие действия

Дополнительные сведения о создании шаблонов рабочих процессов см. в следующих разделах:

Дополнительные сведения о действиях рабочих процессов SharePoint см. в разделе Общие сведения о действиях рабочих процессов для Windows SharePoint Services.
Дополнительные сведения о действиях Windows Workflow Foundation см. в разделе Пространство имен System.Workflow.Activities.

См. также

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

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

Обязательные компоненты

Добавление свойств в библиотеку документов SharePoint

Добавление свойств в библиотеку документов SharePoint

Включение редактирования документов без необходимости их извлечения

Включение редактирования документов без извлечения

Создание проекта последовательного рабочего процесса SharePoint

Создание проекта последовательного рабочего процесса SharePoint

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

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

Обработка событий действий

Обработка событий действий

Тестирование шаблона рабочего процесса SharePoint

Тестирование шаблона рабочего процесса SharePoint

Следующие действия

См. также

Задачи

Основные понятия

Ссылки

Дополнительные ресурсы