Общие положения
...
- Запуск процедуры импорта замечаний осуществляется процессом "Импорт из Excel", вызываемого из контекстного меню по трем точкам в шапке списка "Замечания". При запуске процедуры импорта запускается процесс.
...
- Подготовленный файл с данными для импорта прикрепляется в качестве вложения к процессу "Импорт из Excel" на форме инициализации процесса в обязательный атрибут "Вложение".
...
- Пример файла Excel с корректными данными, необходимыми для импорта, можно получить, выгрузив в Excel настроенный в системе вид "Для импорта" списка Замечаний
...
- Для этого воспользуйтесь функцией Экспорт в Excel
...
Важно! Для корректной работы функционала «Импорт замечаний из Excel» категорически запрещается изменять вид «Для импорта» через стандартную иконку настройки вида.
...
- .
...
- Перед началом импорта файл проходит проверку на пригодность к импорту (
...
- валидацию):
-
...
- Формат файла корректный (.xlsx)
...
-
...
- Приложен только один файл
...
...
- После старта процесса проверяется наличие обязательных столбцов в приложенном файле:
...
- - Уникальный ИД (id)
...
- - Тип (content_type_id)
Важно! Строки с незаполненным столбцом "Тип" не обрабатываются и пропускаются! Для импорта замечаний в ячейках столбца "Тип" должно стоять слово Замечание.
...
Если обязательные столбцы отсутствуют, процесс завершается со статусом "Завершен". В атрибут "Описание" карточки процесса записывается причина, по которой импорт не был произведен.
Также в "Описание" выводится любая другая ошибка обработки файла, которая не связана с обработкой конкретной строки (замечания).
...
Важно! При выполнении операции импорта из Excel учитываются и обрабатываются все строки, в которых есть хоть какое-то форматирование.
Поэтому перед импортом в Excel в файле для импорта надо встать на строку, где заканчиваются данные, выделить все строки ниже и нажать удалить, таким образом будет удалена вся лишняя информация о строках и количество обрабатываемых строк будет количеству строк с данными.- Системные атрибуты замечаний (дата создания/изменения, создал, изменил, ИД и т.п.) заполняются в соответствии с настройками системы, как при ручном создании/изменении элемента инициатором импорта.
...
- Замечания создаются/обновляются под правами пользователя, запустившего процесс импорта. Также отрабатывают все вычисления, валидаторы и автоматизация, как и при ручном создании/изменении.
- По результату импорта в карточке процесса в атрибуте "Вложение" формируется файл с отчетом "[Название приложенного к процессу файла]__report".
Если при импорте конкретного замечания произошла ошибка, например, сработал валидатор, то текст ошибки будет выведен в столбец следующий за столбцом, где заканчиваются данные.
Создание новых замечаний
- Ключевым параметром для определения необходимости создания в системе нового замечания является отсутствие заполненного значения атрибута «id» замечания для данной строки таблицы.
- Атрибуты замечания заполняются в соответствии с содержанием соответствующего столбца Excel. Название столбца в шапке таблицы соответствует пользовательскому названию атрибута в системе.
- Для привязки замечания к файлу/папке, необходимо указать id элемента файла/папки в столбце "Идентификатор элемента".
...