Общие положения

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

Создание новых и изменение существующих замечаний

1. Если в строке импорта не заполнена ячейка в столбце "Уникальный ИД" (id), то будет создано новое замечание. id нового замечания записывается в эту же ячейку в файле отчета. Если эта ячейка заполнена, то замечание, с указанным в ячейке id, будет обновлено.
   
   
2. Атрибуты замечания заполняются/обновляются в соответствии с содержанием соответствующего столбца Excel. Название столбца в шапке таблицы соответствует пользовательскому названию атрибута в системе.
   
   
3. Если ячейка столбца пустая, то соответствующий столбцу атрибут не заполняется/изменяется.
   
   
4. Для привязки замечания к файлу/папке, необходимо указать id элемента (карточки) файла/папки в столбце "Идентификатор элемента" (source_id).
   
   
5. Если создание замечания невозможно по какой-либо причине (например, сработал валидатор или не найдено соответствие лукапа), то выводится соответствующая ошибка в последнем столбце строки в файле отчета.