Библиотека документов (Document Library) ========================================== .. _document_library: .. contents:: :depth: 3 **Document Library (Библиотека документов)** - иерархический интерфейс для работы с папками и документами. .. image:: _static/doclib/DocLib_1.png :width: 700 :align: center В данном режиме можно просмотреть дерево иерархии папок и документов, произвести действия над документами и папками по аналогии действиям в проводнике Windows. Файл открывается в фоновой вкладке по одинарному клику. Папка открывается по двойному в текущей вкладке. Проводник отображается по умолчанию, скрывается по нажатию на **«Скрыть дерево папок»** в правом меню. .. list-table:: :widths: 20 20 :align: center * - | .. image:: _static/doclib/DocLib_2.png :width: 600 :align: center - | .. image:: _static/doclib/DocLib_2_1.png :width: 600 :align: center .. image:: _static/doclib/DocLib_3.png :width: 700 :align: center 1. Выбранная папка подсвечивается среди других папок **(1)**. 2. При клике на иконку или название папки она раскрывается **(1)**, и в левой части отражаются файлы, находящиеся в папке **(2)**. 3. Для отображения документов и папок используются иконки, соответствующие формату файлов по аналогии с проводником Windows: - Microsoft Word (doc, docx); - Microsoft Excel (xls, xlsx); - Microsoft Powerpoint (ppt, pptx); - Adobe Acrobat (pdf); - Файлы изображений (jpg, bmp, png, gif, tif); - OpenOffice/ LibreOffice (odf); - Файл сообщения из электронной почты (.msg). 4. Над журналом размещено название текущей раскрытой папки **(4)**, чуть ниже - полный путь к открытой папке **(3)**. 5. Загрузка файлов, создание папок осуществляется по кнопке **(5)** и с использованием drag-and-drop. 6. Поиск документов внутри выбранной папки **(6)**. Результат поиска отображается в виде списка. 7. Для обновления данных используйте **(7)** 8. При наведении курсора на файл или папку отображаются действия **(8)**. См. ниже Действия с элементом. Действия с элементом ---------------------- .. list-table:: :widths: 5 10 :align: center * - .. image:: _static/doclib/ic_1.png :width: 25 :align: center - Перейти к просмотру карточки в новой вкладке. * - .. image:: _static/doclib/ic_3.png :width: 25 :align: center - Открыть в фоновой в вкладке * - .. image:: _static/doclib/ic_2.png :width: 25 :align: center - Переименовать файл или папку: .. image:: _static/doclib/DocLib_5.png :width: 300 :align: center | Можно изменить название файла, или сам вложенный файл. * - .. image:: _static/doclib/ic_3.png :width: 25 :align: center - :ref:`Редактировать документ в OnlyOffice`. Доступно только для файлов форматов MS Office и OpenDocument. * - .. image:: _static/doclib/ic_4.png :width: 25 :align: center - Скачать файл. * - .. image:: _static/doclib/ic_5.png :width: 25 :align: center - Удалить файл или папку: .. image:: _static/doclib/DocLib_4.png :width: 300 :align: center * - .. image:: _static/doclib/ic_6.png :width: 25 :align: center - | Загрузить новую версию: .. image:: _static/doclib/DocLib_11.png :width: 300 :align: center | :ref:`Подробно о версиях` Создание папки / Загрузка файла ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ **1. C использованием кнопки:** Создание папки или загрузка файла осуществляется по кнопке **+**: .. image:: _static/doclib/DocLib_6.png :width: 600 :align: center При загрузке файла необходимо ввести его название, которое будет отображаться, и выбрать или перетащить файл для прикрепления: .. image:: _static/doclib/DocLib_8.png :width: 600 :align: center На форме отображается индикатор процесса загрузки файла. При создании папки укажите ее название: .. image:: _static/doclib/DocLib_7.png :width: 600 :align: center **2. Drag-and-drop** Выбранные папки, файлы перетащите в область загрузки: .. list-table:: :widths: 20 20 :align: center * - | .. image:: _static/doclib/drag_01.png :width: 700 :align: center - | .. image:: _static/doclib/drag_02.png :width: 700 :align: center Прогресс загрузки показан в правом нижнем углу: .. list-table:: :widths: 20 20 :align: center * - | .. image:: _static/doclib/drag_03.png :width: 700 :align: center - | .. image:: _static/doclib/drag_04.png :width: 700 :align: center При загрузке, создании файлов и папок производится проверка на уникальность: .. list-table:: :widths: 20 20 :align: center * - | .. image:: _static/doclib/validation_name_01.png :width: 300 :align: center - | .. image:: _static/doclib/validation_name_02.png :width: 300 :align: center Так же доступна загрузка папки, содержащей файлы. Перемещение файлов и папок ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: _static/doclib/move_file.png :width: 600 :align: center Карточка файла ---------------- Карточка состоит из виджетов: .. image:: _static/doclib/DocLib_9.png :width: 600 :align: center Для файла доступны следующие действия: - Редактировать свойства; - Редактировать документ (только для файлов форматов MS Office и OpenDocument) - Скачать; - Удалить; - Загрузить новую версию. .. image:: _static/doclib/DocLib_12.png :width: 600 :align: center Подробно о :ref:`виджетах`. Создание библиотеки документов --------------------------------- .. _new_document_library: Создайте новый :ref:`тип данных`. Удалите **Форму по умолчанию** **(1)**, на вкладке **«Основное»** укажите **id**, **Имя** **(2)**, в качестве родителя выберите **Файл библиотеки документов** **(3)** , выставите чекбокс **Наследовать форму** **(4)**. В созданный тип будут автоматически добавлены действия и форма. .. image:: _static/doclib/DocLib_10.png :width: 600 :align: center На стандартной форме doclib-file настроен ряд параметров для корректной загрузки файлов. Если будет использоваться :ref:`кастомная форма`, то нужно учитывать настройки этой формы, в частности обязательности контента и задание конфигурации максимального размера файла на форме. Компонент **File component**: .. image:: _static/doclib/DocLib_13.png :width: 600 :align: center .. list-table:: :widths: 20 20 :align: center * - | .. image:: _static/doclib/DocLib_13_2.png :width: 600 :align: center - | .. image:: _static/doclib/DocLib_13_1.png :width: 600 :align: center Так же для создания библиотеки документов можно использовать аспект **doclib**. **to be updated** Для добавления библиотеки документов в меню выбирайте специальный элемент **DocLib**: .. image:: _static/doclib/DocLib_10_1.png :width: 600 :align: center API ---- **to be updated**