Справочники > Типовые маршруты > Прикладные блоки типовых маршрутов > Группа «Портальные компоненты DIRECTUM для SharePoint» >

Прикладной блок «Мониторинг изменения документов в библиотеке SharePoint»

Предыдущий раздел В начало Следующий раздел

Назначение. Блок «Мониторинг изменения документов в библиотеке SharePoint» предназначен для получения новых и (или) измененных документов в библиотеке SharePoint. Блок ожидает появление новых  и (или) изменение существующих документов, опрашивая библиотеку через определенный интервал (задается в свойствах). После появления таких документов, блок выходит по результату «Успешно» и означивает параметры типового маршрута, где содержатся ID измененных документов, а также описание всех полей (реквизитов) документов библиотеки.

Базовый блок - «Мониторинг».

Свойства, унаследованные от базового блока:

Имя

Заголовок

Тип

Отличия от свойств базового блока

Name

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

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

По умолчанию имеет значение «Мониторинг изменения документов в библиотеке SharePoint»

Link

Ссылка

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

Доступное

Comment

Примечание

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

Доступное

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.

 

Примечания:

1. Следует учитывать, что у учетной записи, от имени которой работает служба WorkFlow, должны быть права на доступ к узлу SharePoint с локального компьютера, где установлена служба, а также права на просмотр заданного списка. В противном случае блок сгенерирует исключение, которое содержит код ошибки доступа и краткое описание. Подробнее о настройках прав доступа для библиотек SharePoint см. в руководстве по Портальным компонентам DIRECTUM для SharePoint.
2. Если в наименовании списка содержатся спецсимволы, например, !№#@, то свойство ListName нужно означивать либо GUID-ом списка, либо значением, которое фигурирует в гиперссылке к этому списку (http://<Адрес веб-узла>/Lists/<Имя списка>.aspx).