Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Merged branch "DOC0001238" into parent

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

Файлы можно прикрепить тремя способами:

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

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


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

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

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


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

Code Block
<attachment> </attachment> 


Info

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

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


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


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

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

Поле

Обязательно

Описание

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

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

и индексация

Anchor
parsing
parsing

Распознавание и индексация содержимого вложений возможны возможно только в том случае, если размер прикрепленного файла не превышает 30 Мб. Лимит фиксирован и не может быть изменен. Если файл больше 30 Мб, он не будет распознан. Предупреждающее сообщение, связанное с индексацией, будет записано в логах. Вы сможете найти дополнительную информацию позже в таблице Основной журнал (sys_log), используя следующие критерии для фильтра:

  • Уровень равно Предупреждение.
  • Сообщение содержит {ID вложения}

    Индексация выполняется только для определенных форматов файлов. Поле Контент будет автоматически заполнено текстовым содержимым прикрепленного файла, если расширение файла входит в список: TXT, INI, REG, CVS, JSON, HTM, HTML, DOC, DOCS, XLS, XLSX. Атрибут Полнотекстовый поиск активен для поля Контент. Этот атрибут позволяет выполнять глобальный поиск по содержанию поля.

    этого процесса реализуется следующее событие:

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

    Note

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

  • Какой-то файл прикреплен к записи любой таблицы (например, к записи 164313550512027919 в таблице Задачи).
  • После этого создается поисковый индекс для этого вложения. Технически, это запись в таблице Поисковые индексы (sys_search_index) с полями, заполненными следующим образом:

    ПолеТипЗначение
    Запись

    Big Integer

    164313646211541086

    Таблица

    Reference

    Вложения

    Колонка

    Reference

    Контент

    Текст

    Text

    В этом поле появляется контент вложения. 


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

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

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

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


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

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

    1. Перейдите в Свойства системы → Все свойства.
    2. Найдите нужную запись свойства с помощью полей поиска по списку или конструктора условий и откройте ее.
    3. Отредактируйте значение в поле Значение.
    4. Нажмите Сохранить или Сохранить и выйти.

    Доступные свойства вложений:

    .Определите имена системных таблиц в этом свойстве, и вложения в записях в этих таблицах не будут индексироваться

    Свойство

    Описание

    max_files_upload_countМаксимальное количество файлов, которое можно загружать одновременно.
    max_file_size_upload

    Максимальный размер файла (в байтах), который можно загрузить.

    allowed_upload_file_extension

    Типы файлов, который разрешено загружать. Перечислите расширения через запятую без пробелов, например: jpeg,png,pdf.

    Файлы других типов будут игнорироваться при загрузке. Чтобы разрешить все типы файлов, введите []

    simple.attachments.ignored_tables_indexing

    .

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

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

    Tip

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

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


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

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

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

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

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

    Операция

    Описание

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

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


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

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

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

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

    Table of Contents
    absoluteUrltrue
    classfixedPosition
    printablefalse