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

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

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

При работе с БД PostgreSQL поддерживаются не все типы хранилищ.
Чтобы подключить внешнее хранилище:

  1. В программе Консоль настройки Docsvision откройте страницу настроек Настройки сервера  Базы данных  Внешние хранилища.

  2. Выберите настраиваемую базу данных и нажмите на кнопку Настройки.

  3. В появившемся окне Свойства и управление базой данных откройте вкладку Внешние хранилища.

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

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

  5. Настройте параметры добавляемого хранилища:

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

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

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

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

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

      • Filestream хранилище в базе данных Docsvision. Если данные будут храниться в FileStream текущей базы данных Docsvision.

        Вытеснение файлов в Filestream хранилище в базе данных Docsvision и FileStream хранилище во внешней базе данных Microsoft SQL Server поддерживается только для СУБД Microsoft SQL и только, когда сервер Docsvision работает под ОС Windows. При работе сервера под ОС Linux функциональность недоступна.

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

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

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

        При использовании хранилищ FileStream хранилище во внешней базе данных Microsoft SQL Server и Filestream хранилище в базе данных Docsvision учетным записям сервера Docsvision и файлового сервиса нужен полный доступ на папку FileStream.

        Вытеснение файлов в Filestream хранилище в базе данных Docsvision и FileStream хранилище во внешней базе данных Microsoft SQL Server поддерживается только для СУБД Microsoft SQL и только, когда сервер Docsvision работает под ОС Windows. При работе сервера под ОС Linux функциональность недоступна.

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

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

      • Помимо перечисленных типов хранилищ, в Docsvision также есть тип "Хранилище в базе данных Docsvision". Хранилище с данным типом по умолчанию подключено, используется и не может быть создано или удалено.

      Для работы с внешними хранилищами лицензия Docsvision должна содержать опцию:

      • Docsvision Внешнее хранилище ФС, чтобы использовать Хранилище на диске.

      • Docsvision Внешнее хранилище MSSQL, чтобы использовать Хранилище во внешней базе Microsoft SQL Server.

      • Docsvision Внешнее хранилище FileStream, чтобы использовать FileStream хранилище во внешней базе данных Microsoft SQL Server.

      • Docsvision Внешние файловые хранилища, чтобы использовать внешние хранилища и вариант Добавить из сборки….

        Для использования собственного типа хранилищ Добавить из сборки… в лицензии Docsvision должна присутствовать функция Docsvision модуль интеграции с произвольными файловыми хранилищами (F91DB4AB-6E40-4D04-97BB-EBABF15E1562).

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

        Вытеснение файлов в Filestream хранилище в базе данных Docsvision и FileStream хранилище во внешней базе данных Microsoft SQL Server поддерживается только для СУБД Microsoft SQL и только, когда сервер Docsvision работает под ОС Windows. При работе сервера под ОС Linux функциональность недоступна.

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

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

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

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

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

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

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

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

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

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

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

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

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

    5. В блоке настроек Разделы установите необходимые флаги.

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

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

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

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

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

    6. В блоке настроек Свойства укажите дополнительные настройки хранилища.

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

      • Путь — расположение каталога в файловой системе для сохранения бинарных данных файлов.

      Для типа "Хранилище во внешней базе Microsoft SQL Server":

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

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

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

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

      Для типа "FileStream хранилище во внешней базе данных Microsoft SQL Server":

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

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

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

      • Папка — расположение каталога на сервере СУБД для бинарных данных файлов, вытесняемых FileStream.

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

      Для типа "Filestream хранилище в базе данных Docsvision":

      • Папка — расположение каталога для вытесняемых в FileStream бинарных данных файлов на сервере СУБД Microsoft SQL Server.

      Для типа "Добавить из сборки…":

      • Список дополнительных параметров определяется собственной реализацией типа хранилища.

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

    Новая конфигурация будет применена в течение 10 минут (по умолчанию).

  7. Включите хранилище в группу хранилищ.

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

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

  1. Выберите его в списке Хранилища и нажмите на кнопку Блокнот с карандашом.

    Тип хранилища не может быть изменён.

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

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

  1. Выберите его в списке Хранилища и нажмите на кнопку Красный крест.

    Хранилище также будет удалено из всех групп хранилищ.

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

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