Подключить внешнее хранилище

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

Подключение хранилища

Процесс подключения внешних хранилищ включает следующие шаги:

  1. В Консоли управления Docsvision выберите настраиваемую базу данных на странице Серверы  Имя-сервера  Сервер приложений  Базы данных и нажмите на строку нужной базы данных.

  2. Настройте параметры в группе Внешние хранилища при настройке свойств БД, см. раздел "Работа с внешними хранилищами в Docsvision" в документации Консоли управления Docsvision.

  3. Нажмите на кнопку Плюс в столбце настроек Хранилища, чтобы открыть окно Настройки хранилища.

    Окно настройки хранилища
    Рисунок 1. Окно "Настройки хранилища"

  4. В появившемся окне настройте параметры добавляемого хранилища, см. подробнее "Настройки хранилища" ниже. Все поля в окне Настройки хранилища обязательны для заполнения.

  5. Нажмите на кнопку Сохранить, чтобы добавить хранилище в список.

    При сохранении хранилища будет выполнена проверка введенных данных, в случае возникновения ошибки появится сообщение с указанием причины.

  6. Включите хранилище в группу хранилищ, см. подробнее в разделе "Включить хранилище в группу хранилищ".

  7. Нажмите кнопку Применить в правом верхнем углу окна Консоли, чтобы применить настройки хранилищ и перезапустите службу Сервера Docsvision. Уже сохранённые в БД хранилища, группы и правила отображаются обычным шрифтом, новые и отредактированные — выделяются жирным. После применения и успешного сохранения настроек в БД выделение жирным пропадает.

Настройки хранилища

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

  1. В поле Название введите уникальное имя для нового хранилища.

  2. В списке Тип выберите тип подключаемого хранилища.

    • Хранилище на диске. Если данные будут храниться в файловой системе сервера Docsvision.

    • Хранилище во внешней базе Microsoft SQL Server. Если данные будут храниться в БД Microsoft SQL Server, не являющейся используемой БД Docsvision.

    • Собственное хранилище. Если данные будут храниться в хранилище, тип которого предоставляется выбранным компонентом (файл .dll). Потребуется опция лицензии Docsvision модуль интеграции с произвольными файловыми хранилищами.

      Инструкция по разработке программного компонента для работы с хранилищем приведена в документации разработчика Docsvision, в разделе "Внешние хранилища".

      Тип хранилища Хранилище во внешней базе Microsoft SQL Server, доступен только если БД Docsvision работает под управлением Microsoft SQL Server.

    • Хранилище в базе данных Docsvision — хранилище с данным типом по умолчанию подключено, используется и не может быть создано или удалено. У хранилища отсутствуют дополнительные поля, такие как Строка подключения и Таймаут. Они не отображаются и не могут быть отредактированы, поле Тип также не может быть изменено. Все остальные поля можно отредактировать.

  3. В списке Состояние выберите тип подключаемого хранилища.

    • Определять автоматически — состояние, при котором хранилище будет автоматически переведено в режим "только чтение и удаление" при достижении размера, указанного в настройке Максимальный размер Гбайт.

    • Онлайн — стандартное состояние, при котором хранилище доступно на чтение, запись и удаление.

    • Отключено — хранилище отключено, операции чтения, записи и удаления будут недоступны.

      Файлы, бинарные данные которых хранятся в хранилище с состоянием Отключено, также будут недоступны.

      Переведите хранилища в состояние Отключено на время проведения профилактических работ по обслуживанию хранилища.

    • Чтение и удаление — состояние, при котором хранилище доступно только на чтение и удаление данных.

    • Зарезервировано — состояние, при котором хранилище не используется, пока в его группе хранилищ не заполнены остальные хранилища. Данное хранилище будет задействовано после заполнения других хранилищ группы.

  4. Если для хранилища установлено состояние Определять автоматически, укажите в поле Максимальный размер Гбайт максимальный размер хранилища, при достижении которого оно будет переведено в режим "только чтение и удаление".

    Если состояние хранилища не Определять автоматически, данная настройка не используется.

    При значении по умолчанию 0 Гб автоматическое переключение режима хранилища осуществляться не будет.

    Информация о загруженности хранилища обновляется каждые 10 минут.

    Если хранилище включено в группу хранилищ по умолчанию, ограничение Максимальный размер Гбайт игнорируется. Если для файла не найдено других хранилищ, подходящих по правилам помещения, файл будет сохранён в хранилище из группы хранилищ по умолчанию.

    Для СУБД Microsoft SQL Server существует ограничение на размер добавляемых файлов — не более 2 Гб. Если в Docsvision необходимо хранить файлы больше 2 Гб, используйте Хранилище на диске, Filestream хранилище в базе данных Docsvision, FileStream хранилище во внешней базе данных Microsoft SQL Server или другое хранилище, поддерживающее файлы такого размера.

    Для СУБД PostgreSQL аналогичное ограничение составляет 1 Гб.

  5. Установите необходимые флаги для настройки разделов:

    • Основной раздел. Если хранилище может быть использовано для хранения бинарных данных актуальных файлов.

    • Архивный раздел. Если хранилище может быть использовано для хранения бинарных данных файлов карточек, помещённых в архив.

    • Временный раздел. Если хранилище может быть использовано для хранения временных бинарных данных.

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

      Рекомендуется устанавливать флаг Временный для всех типов хранилищ, за исключением хранилищ в БД Microsoft SQL Server.

  6. Укажите дополнительные настройки хранилища:

    Для типа "Хранилище на диске":

    • Путь к файловой системе — расположение каталога в файловой системе для сохранения бинарных данных файлов. В поле указывается путь к каталогу на сервере, где установлен Сервер приложений. Пример для Linux: /var/tmp/

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

      • Когда службы Сервера Docsvision и Файлового сервиса запущены под разными учётными записями и используются пути по умолчанию, например, %TEMP% для временного хранилища, возможны случаи неудаления файлов с закончившимся сроком хранения. Причина в разных относительных путях для разных УЗ.

        Чтобы избежать подобной ситуации, указывайте абсолютный путь к временному хранилищу и обеспечивайте необходимый доступ по этому пути для обоих учётных записей. Также можно запускать службы Сервера Docsvision и Файлового сервиса под одной учётной записью.
    Для типа "Хранилище во внешней базе Microsoft SQL Server":

    • Строка подключения — строка подключения к БД в формате Data Source=ServerName;Initial Catalog=DatabaseName;User ID=UserName;Password=UserPassword.

      Строка должна содержать данные для подключения к внешней БД (по отношению к БД Docsvision). В указанную внешнюю БД будут сохраняться бинарные данные файлов.

      Не указывайте текущую или любую другую БД Docsvision — это может привести к поломке БД.

    • Таймаут (с) — время ожидания ответа от сервера в секундах.

    Для типа "Собственное хранилище":

    • Имя сборки — в поле указывается имя сборки в файловой системе. Нужно указать только имя сборки с расширением, полный путь указывать не требуется. Если тип был изменён, строка исчезает.

Изменение настроек хранилища

Чтобы изменить настройки хранилища:

  1. Выберите его в столбце Хранилища, нажмите на его название.

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

    Поля Тип хранилища, Имя сборки и Имя класса провайдера не могут быть изменены. Если хранилище содержит файлы, следующие поля заблокированы:

    • Путь в файловой системе, если выбран тип Хранилище на диске

    • Строка подключения, если выбран тип Хранилище во внешней базе MSSQL Server

    • Свойства, если выбран тип Собственное хранилище (т.к. в поле может быть прописан путь или строка подключения).

Удаление хранилища

Чтобы удалить хранилище:

  1. Найдите хранилище в столбце Хранилища и нажмите на кнопку Крест в правой части строки.

    При удалении хранилища появляется окно с сообщением: Вы уверены, что хотите удалить хранилище? и кнопками Да / Нет. После подтверждения хранилище удаляется из списка хранилищ.

    Хранилище также будет удалено из всех групп хранилищ. Стандартное хранилище "Database" (название по умолчанию) не может быть удалено.

    Перед удалением хранилища убедитесь, что данные файлов из хранилища не используются в карточках, т.к. после удаления хранилища эти файлы будут недоступны.