Типовые маршруты
Прикладной блок «Мониторинг изменения документов в библиотеке 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».
© 2009, Компания DIRECTUM
|
Отправить комментарий к этому разделу на
support@directum.ru
|