Справочники

 

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

 

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

LibraryName

Наименование библиотеки

Строка (Константа или параметр)

Наименование или GUID библиотеки SharePoint

LastUpdateParamName

Имя параметра типового маршрута, где содержится дата последней проверки

Строка

(Константа)

Дата последней проверки. Если дата не означена, блок мониторинга вернет все документы библиотеки, иначе - документы, измененные за период  [LastUpdateDate..Now]

ChangeIDCollectionParamName

Имя параметра типового маршрута, куда запишутся ID измененных документов библиотеки

Строка (Константа)

Наименование параметра типового маршрута типа «Коллекция строк», куда будут записываться ID измененных с момента последнего мониторинга документов.

FieldCollectionParamName

Имя параметра типового маршрута, куда запишутся идентификаторы полей библиотеки

Строка (Константа)

Наименование параметра типового маршрута типа «Коллекция строк», куда будут записываться поля библиотеки в формате: <Уникальный идентификатор поля>|<Видимое название поля>

Результаты выполнения. В результате выполнения блока возвращается одно из следующих значений:

 

Код

Наименование

Примечание

 

Успешно

Унаследован от базового блока. Найдены новые и (или) измененные документы до наступления крайнего срока выполнения.

 

Срок истек

Унаследован от базового блока. Не найдено ни одного измененного или нового документа до наступления крайнего срока выполнения мониторинга.

Описание. Блок будет отслеживать изменение документов библиотеки с момента последней проверки. Если есть изменившиеся документы, блок запишет в параметры типового маршрута ID этих документов, а также все наименования полей этих документов, которые можно в дальнейшем использовать для получения значений этих полей.

Если дата последней проверки пустая, блок вернет все документы библиотеки SharePoint.

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

В свойстве LibraryName можно указывать как видимое наименование библиотеки SharePoint (задается при ее создании), так и уникальный GUID (можно получить программно при работе c SharePoint).

В параметр FieldCollectionParamName записываются все поля представления по умолчанию библиотеки LibraryName.

 

Примечание. Следует учитывать, что у учетной записи, от имени которой работает служба WorkFlow, должны быть права на доступ к узлу SharePoint с локального компьютера, где установлена служба, а также права на просмотр заданной библиотеки. В противном случае блок сгенерирует исключение, которое содержит код ошибки доступа и краткое описание (подробнее о настройках прав доступа для библиотек SharePoint см. в документации по SharePoint).

Примечание. Если в наименовании библиотеки содержатся спецсимволы, например, !№#@, то свойство LibraryName нужно означивать либо GUID-ом библиотеки, либо значением, которое фигурирует в гиперссылке к этой библиотеке (http://<Адрес веб-узла>/<Имя библиотеки>/Forms/AllItems.aspx).

 

 

См. также:

·         Прикладной блок «Мониторинг изменения элементов в списке SharePoint»;

·         Прикладной блок «Получить поля документа библиотеки SharePoint»;

·         Прикладной блок «Получить элемент списка SharePoint»;

·         Прикладной блок «Публикация документа в библиотеку SharePoint»;

·         Прикладной блок «Публикация элемента списка SharePoint».