Типовые маршруты
Прикладной блок «Мониторинг появления файла»
Назначение. Блок «Мониторинг появления файла» предназначен для мониторинга появления файла в указанной папке по заданной маске в течение определенного времени.
Базовый блок - «Мониторинг».
Свойства, унаследованные от базового блока:
|
Имя |
Заголовок |
Тип |
Отличия от свойств базового блока |
|
Name |
Наименование |
Строка (Константа) |
По умолчанию имеет значение «Ожидание появления электронного документа в файловой системе» |
|
Deadline |
Крайний срок |
Дата, Целое число (Константа или параметр) |
Нет |
|
IsRelativeDeadline |
Относительный |
Логическое значение (Константа) |
Нет |
|
RelativeDeadlineType |
Единица измерения |
Признак (Константа) |
Нет |
|
Interval |
Интервал |
Целое число (Константа или параметр) |
Нет |
|
IntervalType |
Тип интервала |
Признак (Константа) |
Нет |
|
SearchType |
Тип поиска |
Признак (Константа) |
Скрытое |
|
SearchDescription |
Поиск |
Описание поиска (Константа или параметр) |
Скрытое |
|
SearchScript |
Правило мониторинга |
Строка (Вычисление) |
Скрытое |
Дополнительные свойства:
|
Имя |
Заголовок |
Тип |
Описание |
|
Folder |
Папка |
Строка (Константа или параметр) |
Путь к локальной или сетевой папке, в которой будет происходить поиск файла. Обязательное |
|
Mask |
Маска |
Строка (Константа или параметр) |
Маска для поиска файла. Обязательное |
|
FoundFileParamName |
Найденный файл |
Строка (Константа) |
Имя параметра, в который будет сохранена строка с именем найденного файла |
Результаты выполнения. В результате выполнения блока возвращается одно из следующих значений:
|
Код |
Наименование |
Примечание |
|
|
Успешно |
Унаследован от базового блока. Файл, удовлетворяющий заданной маске, найден в папке Folder до наступления крайнего срока выполнения мониторинга. |
|
|
Срок истек |
Унаследован от базового блока. Ни одного файла, удовлетворяющего заданной маске, не было найдено в папке Folder до наступления крайнего срока выполнения мониторинга. |
Описание. Блок «Мониторинг появления файла» выполняет поиск файла по заданной маске в указанной папке с периодичностью, заданной свойством Интервал.
Если обязательные параметры Folder и Mask не заданы, то блок прервется с генерацией соответствующего исключения.
Путь к папке в свойстве Folder может быть задан как сетевой (в этом случае пользователь, от имени которого запущена служба Workflow, должен обладать правами на сетевой ресурс на чтение), так и локальный (при указании локального пути будет происходить обращение к локальным ресурсам сервера, на котором запущена служба Workflow). Указывать путь к папке можно как с ‘\’ на конце, так и без него (например, «C:\» равнозначно «C:»). Если будет указан неверный путь к папке, то блок прервется с генерацией соответствующего исключения.
Для задания маски используются стандартные правила задания масок для поиска файлов («*» - любая последовательность символов, «?» – любой одиночный символ или отсутствие символа). Например, «*.doc» - все файлы с расширением «doc».
Для того чтобы получить имя найденного файла, можно использовать свойство FoundFileParamName. В нем необходимо задать имя параметра типа строка типового маршрута, в который будет занесен результат поиска. Если в папке есть несколько файлов, удовлетворяющих критериям поиска, то в результат будет занесено только первое по алфавиту имя файла.
См. также:
· Прикладной блок «Импорт файла в электронный документ»;
· Прикладной блок «Создание электронного документа из файла»;
· Прикладной блок «Экспорт электронного документа в файл».
|
© 2009, Компания DIRECTUM
|
|
Отправить комментарий к этому разделу на
support@directum.ru
|