Типовые маршруты
Прикладной блок «Мониторинг изменения элементов в списке SharePoint»
Назначение. Блок «Мониторинг изменения элементов в списке SharePoint» предназначен для получения новых и (или) измененных элементов списка SharePoint. Блок ожидает появление новых и (или) изменение существующих элементов, опрашивая список через определенный интервал (задается в свойствах). После появления таких элементов, блок выходит по результату «Успешно» и означивает параметры типового маршрута, где содержатся ID измененных элементов, а также описание всех полей списка.
Базовый блок - «Мониторинг».
Свойства, унаследованные от базового блока:
Имя |
Заголовок |
Тип |
Отличия от свойств базового блока |
Name |
Наименование |
Строка (Константа) |
По умолчанию имеет значение «Мониторинг изменения элементов в списке SharePoint» |
Deadline |
Крайний срок, когда заканчивается мониторинг измененных документов |
Дата, Целое число (Константа или параметр) |
Нет |
IsRelativeDeadline |
Относительный |
Логическое значение (Константа) |
Нет |
RelativeDeadlineType |
Единица измерения |
Признак (Константа) |
Нет |
Interval |
Интервал опроса библиотеки SharePoint |
Целое число (Константа или параметр) |
Нет |
IntervalType |
Тип интервала |
Признак (Константа) |
Нет |
SearchType |
Тип поиска |
Признак (Константа) |
Скрытое, не используется |
SearchDescription |
Поиск |
Описание поиска (Константа или параметр) |
Скрытое, не используется |
SearchScript |
Правило мониторинга |
Строка (Вычисление) |
Скрытое |
Дополнительные свойства:
Имя |
Заголовок |
Тип |
Описание |
ServerURL |
URL портала SharePoint |
Строка (Константа или параметр) |
Адрес портала SharePoint например, http://portal.our-company.ru |
RelativeWebSiteURL |
Относительный URL узла на портале SharePoint |
Строка (Константа или параметр) |
Относительный адрес веб-узла портала SharePoint, на котором находится список, например, \Marketing. |
ListName |
Наименование списка |
Строка (Константа или параметр) |
Наименование или GUID списка SharePoint |
LastUpdateParamName |
Имя параметра типового маршрута, где содержится дата последней проверки |
Дата (Параметр) |
Дата последней проверки. Если дата не означена, блок мониторинга вернет все элементы списка, иначе - элементы, измененные за период [LastUpdateDate..Now] |
ChangeIDCollectionParamName |
Имя параметра типового маршрута, куда запишутся ID измененных элементов списка |
Строка (Константа) |
Наименование параметра типового маршрута типа «Коллекция строк», куда будут записываться ID измененных с момента последнего мониторинга элементов. |
FieldCollectionParamName |
Имя параметра типового маршрута, куда запишутся идентификаторы полей списка |
Строка (Константа) |
Наименование параметра типового маршрута типа «Коллекция строк», куда будут записываться поля списка в формате: <Уникальный идентификатор поля>|<Видимое название поля> |
Результаты выполнения. В результате выполнения блока возвращается одно из следующих значений:
Код |
Наименование |
Примечание |
|
Успешно |
Унаследован от базового блока. Найдены новые и (или) измененные элементы списка до наступления крайнего срока выполнения. |
|
Срок истек |
Унаследован от базового блока. Не найдено ни одного измененного или нового элемента списка до наступления крайнего срока выполнения мониторинга. |
Описание. Блок будет отслеживать изменение элементов списка с момента последней проверки. Если есть изменившиеся элементы, блок запишет в параметры типового маршрута ID этих элементов, а также все поля этих элементов, которые можно в дальнейшем использовать для получения значений.
Если дата последней проверки пустая, блок вернет все элементы списка SharePoint.
Свойство RelativeWebSiteURL является обязательным только в том случае, если список находится на одном из узлов портала.
В свойстве ListName можно указывать как видимое наименование списка SharePoint (задается при его создании), так и уникальный GUID (можно получить программно при работе c SharePoint).
В параметр FieldCollectionParamName записываются все поля представления по умолчанию списка ListName.
Примечание. Следует учитывать, что у учетной записи, от имени которой работает служба WorkFlow, должны быть права на доступ к узлу SharePoint с локального компьютера, где установлена служба, а также права на просмотр заданного списка. В противном случае блок сгенерирует исключение, которое содержит код ошибки доступа и краткое описание (подробнее о настройках прав доступа для библиотек SharePoint см. в документации по SharePoint).
Примечание. Если в наименовании списка содержатся спецсимволы, например, !№#@, то свойство ListName нужно означивать либо GUID-ом списка, либо значением, которое фигурирует в гиперссылке к этому списку (http://<Адрес веб-узла>/Lists/<Имя списка>.aspx).
См. также:
· Прикладной блок «Мониторинг изменения документов в библиотеке SharePoint»;
· Прикладной блок «Получить поля документа библиотеки SharePoint»;
· Прикладной блок «Получить элемент списка SharePoint»;
· Прикладной блок «Публикация документа в библиотеку SharePoint»;
· Прикладной блок «Публикация элемента списка SharePoint».
© 2009, Компания DIRECTUM
|
Отправить комментарий к этому разделу на
support@directum.ru
|