Перейти к основному содержимому
Версия: 1.21.3

Управление вложениями

SimpleOne поддерживает прикрепление файлов к записям. Читайте статью Вложения, чтобы узнать, как загружать, скачивать и удалять файлы, прикрепленные к записи, на портале или через агентский интерфейс. В этой статье содержится информация о том, как настроить различные аспекты системы, связанные с вложениями:

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

Вложения в интерфейсе

Действие и поле типа Image


Вы можете прикрепить файл к полю типа Image или к записи, используя действие вложения. Оно отображается на форме как иконка скрепки .

На скриншоте ниже отмечены два действия вложения на записи формы:

Виджет вложений


Вложения могут быть добавлены через виджет вложений. Для этого вам нужно использовать Simple-тег <attachment> внутри определенного экземпляра виджета. Необязательно указывать атрибуты recordId, tableName для тега <attachment>, расположенного на странице с формой. Поэтому шаблон виджета будет выглядеть следующим образом:


<attachment> </attachment>

примечание

После добавления экземпляра виджета на форму агентского интерфейса стандартное действие в правом верхнем углу формы будет удалено:

Вы можете добавить файлы из буфера обмена в виджет прямо на форме с помощью сочетания клавиш Ctrl+V при наведении курсора на область загрузки файлов.

Запись вложения

Когда вы загружаете файл, создается запись в таблице Вложения (sys_attachment). Чтобы открыть эти записи, перейдите во Вложения → Все вложения.

Поля формы записи Вложения

ПолеОбязательноОписание
Запись в таблицеНетЭто поле заполняется автоматически ссылкой на запись, к которой добавлено вложение.
Имя файлаДаОтображает название файла.
Путь к файлуНетОтображает путь к файлу на сервере.
Размер в байтахНетУказывает размер файла в байтах.
MIME-типДаУказывает тип содержимого файла, описанный в стандарте MIME.
ПубличноеНетУстановите флажок, чтобы сделать вложение публичным с постоянной ссылкой.

Распознавание

Распознавание содержимого вложений возможно только в том случае, если размер прикрепленного файла не превышает 30 Мб. Лимит фиксирован и не может быть изменен. Если файл больше 30 Мб, он не будет распознан.

внимание

Распознавание вложений – фоновый процесс. В рамках этого процесса реализуется следующее событие:

  • В записи таблицы Вложения (sys_attachment) помещается содержимое вложения, проанализированное из предоставленного файла. Содержимое вложения заполняется в поле Содержимое, а кодировка – в поле Кодировка. Кодировка содержимого определяется автоматически.

Логирование вложений

Система регистрирует все операции (кроме чтения) в таблице Основной журнал (sys_log). У операций, связанных с вложениями, значение поля Источник равно Attachment. Перейдите в Системный журнал → Основной журнал.

Если в процессе прикрепления файлов возникли какие-либо ошибки или исключения, их можно найти в списке Журнал исключений (sys_log_exception). Перейдите в Системный журнал → Журнал исключений.

Обратитесь к статье Аудит системы, чтобы узнать больше.

Настройка системных свойств вложений

Чтобы настроить свойства вложений, выполните следующие шаги:

  1. Перейдите в Свойства системы → Все свойства.
  2. Найдите нужную запись свойства с помощью полей поиска по списку или конструктора условий и откройте ее.
  3. Отредактируйте значение в поле Значение.
  4. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
СвойствоОписание
max_files_upload_countМаксимальное количество файлов, которое можно загружать одновременно.
max_file_size_uploadМаксимальный размер файла (в байтах), который можно загрузить.
allowed_upload_file_extensionТипы файлов, которые разрешено загружать. Перечислите расширения через запятую без пробелов, например: jpeg,png,pdf. Файлы других типов будут игнорироваться при загрузке. Чтобы разрешить все типы файлов, введите [].

Доступ к вложениям

Вы можете ограничить операции с полями типа Image и вложениям для пользователей определенных ролей с помощью правил контроля доступа (ACL).

подсказка

Требуемая роль: security_admin.

Ограничение доступа к вложениям


  • Загрузить вложение может только пользователь с правами на создание записей в таблице Вложения (sys_attachment) и на редактирование той записи, к которой он пытается загрузить вложение. Чтобы запретить пользователю загружать вложение, запретите ему одну из этих операций.
  • Удалять вложения может пользователь с правами на удаление записей из таблицы Вложения (sys_attachment) и на редактирование или удаление той записи, из которой он пытается удалить вложение.
  • Скачивать вложения может пользователь с правами на чтение таблицы Вложения (sys_attachment) и чтение записи, к которой прикреплено вложение.
  • Копировать может пользователь с правом на чтение таблицы записи, в которой находится исходное вложение, и с правом редактировать записи в таблице, в которой происходит копирование.

Вы можете дополнить существующие правила контроля доступа для таблицы Вложения (sys_attachment) новыми правилами с другими условиями, которые не будут противоречить существующим. Для этого выполните следующие шаги:

  1. Перейдите в Безопасность → Контроль доступа (ACL).
  2. Нажмите Создать и заполните поля.
  3. В поле Таблица выберите таблицу Вложения.
  4. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Дополнительные сведения об ограничениях доступа смотрите в статьях раздела Контроль доступа.

Ограничение доступа к полям типа Image


Чтобы ограничить доступ к полю типа Image, выполните следующие шаги:

  1. Перейдите в Безопасность → Контроль доступа (ACL).
  2. Нажмите Создать и заполните поля.
  3. В поле Колонка, выберите поле типа Image, доступ к которому вам нужно настроить.
  4. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

В результате:

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

В таблице ниже описано влияние ограничений операций для полей типа Image:

ОперацияОписание
СозданиеПоле не отображается на записи новой формы и появляется после сохранения записи.
ЧтениеПоле и его контент (прикрепленные файлы) скрыты.
ЗаписьПоле доступно только для чтения.