Импорт данных из Excel
Автоматический импорт данных из Excel-таблицы в систему КОСКО ИСУП.
1. Принцип работы

При нажатии на кнопку «Конвертировать» в каталоге «Импорт клиентов» запускается сценарий «Конвертировать документ». Сценарий конвертирует Excel таблицу и полученные данные записывает в каталог «Клиенты**».**
2. Реализация
В каталоги КОСКО BPM можно импортировать записи из файла Microsoft Excel (.xlsx).

КОСКО BPM создает новые записи в каталоге, соотнося наименование столбца в Excel-таблице (первую заполненную ячейку в столбце) с наименованием поля каталога. Если наименования совпадают, то система автоматически заполнит значения полей создаваемых записей значениями ячеек столбца Excel.

Если вы хотите изменить правило соотношения полей каталога со столбцами из Excel, вы можете вручную соотнести поле со столбцом.

2.1Типы импортируемых значений
Кроме импортирования текстовых и числовых значений, можно также импортировать значения других полей, например поля типа «Статус», «Связанный каталог» и других. В этом случае поиск нужного значения будет произведен по полному совпадению его наименования и ячейки из столбца Excel.
Если наименования не совпадают, то система не сможет автоматически соотнести значение поля с ячейкой столбца Excel-таблицы. В этом случае вы можете самостоятельно выбрать доступное значение поля для импортируемой записи.
Пример: В должности «Директор» в Excel-таблице произошла опечатка.

Можно самостоятельно выбрать правильное значение.

2.3 Пример импорта записей
В каталоге «Лица» есть следующий набор полей:

Записи в связанном каталоге «Предприятия (1)»:

Записи в каталоге «Сотрудники»:

Excel-файл для импорта в каталог «Лица»:

Результат импортирования:

2.4 Право импортировать записи
Импортировать записи могут сотрудники с привилегией «Создавать записи» и выше. Подробнее в статье «Привилегии». Также возможен вариант открытия доступа к каталогу без возможности просмотра записей в нем, но импорт при этом будет доступен. Реализуется данный механизм с использованием правовых видов, в качестве правила также должна быть выбрана привилегия «Создавать записи».
2.5 Другие методы импорта записей
В случаях, когда функционала стандартного импорта недостаточно, например, когда нужно импортировать только определенные записи по критерию или актуализировать существующие в КОСКО BPM записи, используйте сценарий автоматизации (пошаговая инструкция импорта данных из Excel).
Импорт из Excel с использованием сценария – тут видео на сайте
2.6 Выбор каталога и файла для импорта
Чтобы импортировать данные, перейдите в каталог, в который хотите импортировать данные, и нажмите «Импорт из Excel».

Следующий шаг: выберите импортируемый объект. По умолчанию пользователю доступен импорт только из .xlsx файлов.

2.7 Настройка параметров импорта
После выбора импортируемого объекта перед вами появится таблица с «сырыми» данными. Они будут конвертированы в формат КОСКО BPM, исходя из правил, задаваемых в заголовке каждого столбца.

Правила задаются при помощи прямого соответствия: Название столбца в Excel — Название поля в структуре каталога.
На выбор доступны все поля структуры каталога + служебное значение — «Не импортировать».

Каждая строка таблицы может находиться в различных состояниях. Каждому состоянию соответствует свое значение служебного поля «Статус строки»:
Значение поля | Состояние строки |
Определено | Каждая ячейка строки удовлетворяет условиям корректности введенных данных (строка без ошибок) |
Ошибка определения | Хотя бы одна ячейка строки не удовлетворяет условиям корректности введенных данных (строка с ошибкой) |
Импортировано | Строка импортирована |
Ошибка импорта | Строку не удалось импортировать |
Не импортировать | Строка исключена из списка импортируемых строк |
Обработка | Данные конвертируются |
Помимо индикации состояния строк, можно визуально определить, в каких именно ячейках допущена ошибка: текст в таких ячейках выделяется красным цветом.
Строки таблицы, кроме обладающих статусом «Импортировано», «Не импортировать» и «Обработка», можно редактировать. Но есть особенности:
Когда вы исправите ошибку, текущие изменения будут применены ко всем ячейкам столбца. Исключение — пустые ячейки.
При изменении корректно определенной ячейки изменения будут применены только к изменяемой ячейке.
После установки правил импортирования данных нажмите на кнопку «Импортировать» в правом нижнем углу.
2.8 Что еще можно делать с данными
Импорт можно остановить. Для этого в системе есть кнопка «Пауза».

В правом нижнем углу указывается примерное время выполнения импорта.
Импорт также сопровождается индикационным статус-баром. Зеленая полоса показывает, какие записи успешно импортированы, красная полоса показывает, что в процессе импорта есть ошибка.
Внизу каждого столбца указан процент успешно определенных ячеек.

Данные в таблице можно отфильтровать по статусу строк или по содержащимся в них данным.
