Справочники

 

Типовые маршруты

 

Прикладной блок «Мониторинг изменения элементов в списке 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».