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

  1. Запуск процедуры импорта замечаний осуществляется процессом "Импорт из Excel", вызываемого из контекстного меню по трем точкам в шапке списка "Замечания". При запуске процедуры импорта запускается процесс. 

  2. Подготовленный файл с данными для импорта прикрепляется в качестве вложения к процессу "Импорт из Excel" на форме инициализации процесса в обязательный атрибут "Вложение". 



  3. Пример файла Excel с корректными данными, необходимыми для импорта, можно получить, выгрузив в Excel настроенный в системе вид "Для импорта" списка Замечаний Для этого воспользуйтесь функцией Экспорт в Excel.



  4. Перед началом импорта файл проходит проверку на пригодность к импорту (валидацию):
    - Формат файла корректный (.xlsx)
    - Приложен только один файл

  5. После старта процесса проверяется наличие обязательных столбцов в приложенном файле:
    - Уникальный ИД (id)
    - Тип (content_type_id)

    Важно! Строки с незаполненным столбцом "Тип" не обрабатываются и пропускаются! Для импорта замечаний в ячейках столбца "Тип" должно стоять слово Замечание.

    Если обязательные столбцы отсутствуют, процесс завершается со статусом "Завершен". В атрибут "Описание" карточки процесса записывается причина, по которой импорт не был произведен.
    Также в "Описание" выводится любая другая ошибка обработки файла, которая не связана с обработкой конкретной строки (замечания).



    Важно! При выполнении операции импорта из Excel учитываются и обрабатываются все строки, в которых есть хоть какое-то форматирование. 
    Поэтому перед импортом в Excel в файле для импорта надо встать на строку, где заканчиваются данные, выделить все строки ниже и нажать удалить, таким образом будет удалена вся лишняя информация о строках и количество обрабатываемых строк будет количеству строк с данными.
  6. Системные атрибуты замечаний (дата создания/изменения, создал, изменил, ИД и т.п.) заполняются в соответствии с настройками системы, как при ручном создании/изменении элемента инициатором импорта.

  7. Замечания создаются/обновляются под правами пользователя, запустившего процесс импорта. Также отрабатывают все вычисления, валидаторы и автоматизация, как и при ручном создании/изменении.

  8. По результату импорта в карточке процесса в атрибуте "Вложение" формируется файл с отчетом "[Название приложенного к процессу файла]__report".
    Если при импорте конкретного замечания произошла ошибка, например, сработал валидатор, то текст ошибки будет выведен в столбец следующий за столбцом, где заканчиваются данные.

Создание новых замечаний

  1. Ключевым параметром для определения необходимости создания в системе нового замечания является отсутствие заполненного значения атрибута «id» замечания для данной строки таблицы.
  2. Атрибуты замечания заполняются в соответствии с содержанием соответствующего столбца Excel. Название столбца в шапке таблицы соответствует пользовательскому названию атрибута в системе.

  3. Для привязки замечания к файлу/папке, необходимо указать id элемента файла/папки в столбце "Идентификатор элемента".

3. 

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

Изменение существующих замечаний

1. Ключевым параметром для определения необходимости изменения существующего в системе замечания является наличие значений атрибута «id» для данной строки таблицы. Если атрибут «id» заполнен корректно, то обновляется соответствующее ему замечание в Vitro.

2. Атрибуты замечания изменяются и заполняются в соответствие с содержанием ячейки соответствующего столбца таблицы. Название в шапке таблицы - пользовательское название атрибута в системе.

3. Если ячейка в файле пустая, то атрибут не изменяется.

4. Если изменяемый импортом атрибут уже имеет значение, то заменяется старое значение на новое.

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