Мониторинг файловой системы

Дискета с очками
Рисунок 1. Пиктограмма функции

Использование на Linux

Использование мониторинга файловой системы в ОС Linux затруднено. Альтернативный путь — использование общей папки.

  1. На серверной машине с Linux создайте каталог вида /имя-машины-в-домене/название-общей-папки. Дайте права на чтение каталога администратору Workflow.

  2. Предоставьте общий доступ к каталогу под именем "название-общей-папки".

  3. Локальный доступ из Linux обеспечивается по любому из путей:

    • /имя-машины-в-домене/название-общей-папки

    • //имя-машины-в-домене/название-общей-папки (Linux пропускает лишние слеши).

  4. В Windows этот каталог будет виден как \\имя-машины-в-домене\название-общей-папки.

  5. Выполненные настройки позволят Windows-клиенту сохранять файлы, не препятствуя поиску файлов Linux-сервером.

Общее описание функции

Функция Мониторинг файловой системы позволяет серверу Docsvision обнаружить в указанной папке файлы, подходящие под условие фильтра. Если файлы будут найдены, выполнение функции будет завершено. При определенных настройках, функция позволяет выполнять обнаружение появления файлов в папке.

Дополнительно, функция позволяет фиксировать изменения указанного файла. В настройках функции мониторинга указывается, в какую переменную процесса будет возвращена ссылка на найденный файл или файлы.

Настройка параметров

Окно свойств функции "Мониторинг файловой системы". Вкладка "Параметры"
Рисунок 2. Окно свойств функции "Мониторинг файловой системы". Вкладка "Параметры"

Параметры подпроцесса определяются на вкладке Параметры окна свойств функции Мониторинг файловой системы.

Параметр процесса — файл

Переменная бизнес-процесса типа файл ФС, в которую будут возвращены найденные файлы.

При мониторинге папки под запрос могут подходить несколько файлов. Если в поле Параметр процесса — файл указать переменную типа файл ФС с отмеченным признаком Коллекция значений, в неё будут записаны все найденные файлы. Если же указать переменную типа Файл ФС без признака Коллекция значений, в неё будет записан только первый найденный файл.

Очищать историю мониторинга

Значение (или переменная бизнес-процесса типа Да/Нет), указанное в данном поле определяет, будет ли удаляться история мониторинга. При сохранении истории (значение поля Нет) при повторном выполнении функции будет производиться мониторинг только вновь появившихся файлов.
При удалении истории (значение поля Да) при повторном выполнении функции будут обнаружены все файлы, найденные в прошлый раз, а также все вновь появившиеся файлы.

При неудаче активировать связь

Название функции, которой будет передано управление процессом в случае, если объект с нужными свойствами не будет найден при однократном мониторинге. Поле не обязательно для заполнения.

"Неудачей" считается как отсутствие найденных объектов при мониторинге папки, так и отсутствие изменений в указанном файле при мониторинге изменений файла. Если оставить поле пустым, функция будет ожидать только положительного результата — появления файла, подходящего под запрос, или появления изменений в указанном файле.

Далее следует выбрать один из переключателей: Мониторинг папки файловой системы или Мониторинг изменений файла, в соответствии с которым будет производиться мониторинг объектов в какой-либо папке или мониторинг изменения какого-либо объекта.

Мониторинг папки файловой системы

Указывает, что должен производиться мониторинг папки файловой системы.

При этом следует указать также:
  • Папка файловой системы: полный сетевой путь к папке файловой системы или переменная бизнес-процесса типа папка ФС, мониторинг которой будет осуществляться.

  • Фильтр папки: фильтр задается вручную как стандартный шаблон имен искомых файлов (.).

    Примеры фильтров:
    • . — поиск любого файла с любым расширением;

    • Документ.doc — поиск определенного файла с определенным расширением.

    • *.doc? — поиск файлов MS Word формата .doc и .docx.

    • Договор* — поиск файлов с любыми расширениями, которые начинаются со слова "Договор".

  • Искать в подпапках: при установленном флаге будет производиться мониторинг не только указанной папки, но и всех её дочерних папок.

Мониторинг изменений файла

Указывает, что мониторинг файла должен производиться по дате его последнего редактирования. Если изменилась дата последнего редактирования файла, считается, что в файле произошли изменения.

При выборе данного переключателя в следующем поле следует указать необходимый параметр:
  • Выбранный файл — файл из файловой системы (или переменная бизнес-процесса типа файл ФС), изменение которого будет отслеживаться функцией мониторинга.

Для корректной работы мониторинга необходимо, чтобы между функцией мониторинга и функцией, указанной в поле При неудаче активировать связь, была установлена связь типа При успехе. В противном случае процесс будет остановлен при неудаче мониторинга из-за ошибки.

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

При необходимости связи типа При ошибке и При успехе можно установить одновременно.