Импорт РПИ

Общая информация

Функциональность импорта РПИ позволяет загружать данные показателей, измерений, фактов и справочников из файлов Microsoft Excel и CSV в текущую версию проекта. Импорт полностью заменяет существующие данные в РПИ в выбранной версии проекта данными из файла.

Доступ к функции импорта

Функция импорта доступна на экране РПИ:

Пункт "Загрузить из файла" доступен через меню в каждой секции экрана РПИ
Для импорта требуется роль Разработчик или выше (Разработчик, Менеджер проекта, работающий в проекте своей компании, Администратор компании, Суперадминистратор) и действующая лицензия компании без ограничений. Роли Аналитик и Наблюдатель не могут импортировать данные

Поддерживаемые форматы файлов

Microsoft Excel (.xlsx)
Microsoft Excel 97-2003 (.xls)
CSV (Comma-Separated Values) (.csv)

Ограничения

Максимальный размер одного файла: 10 МБ
Файл Excel содержит данные всех вкладок РПИ на отдельных листах, поэтому загружается только один файл Excel
Файл CSV содержит данные одной вкладки РПИ, поэтому для каждой загружаемой вкладки загружается отдельный файл (до четырёх файлов)
Скрытые листы в файлах Excel недоступны для импорта
Объединенные ячейки в файле импорта не обрабатываются (соответствующие ячейки останутся пустыми)

Процесс импорта

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

Выбор файла

Нажмите кнопку "Загрузить из файла" на экране РПИ
Выберите файл через стандартный диалог выбора файлов вашего браузера
Нажмите "Далее" для перехода к следующему шагу

Выбор рабочих листов для файлов Excel

На этом шаге вы выбираете, какие вкладки РПИ загружать и с каких листов Excel брать для них данные.

Вкладки, доступные для загрузки:

«Показатели»
«Измерения»
«Факты»
«Справочники»

У каждой вкладки есть свой чекбокс и свой селектор листа, поэтому загрузить можно любое сочетание вкладок — от одной до всех четырёх.

Выбор листов:

Система показывает список всех видимых листов из загруженного файла
Лист предварительно выбирается для вкладки, если его название содержит «Показатели», «Измерения», «Факты» или «Справочники». Проверка не учитывает регистр и распознаёт также английские названия вкладок
Вы можете вручную выбрать другой лист для любой вкладки
Для перехода к следующему шагу должна быть выбрана хотя бы одна вкладка, а для каждой выбранной вкладки должен быть указан лист

Настройки загрузки CSV

На этом шаге вы загружаете файлы CSV и указываете разделитель для каждого из них. Так как один файл CSV содержит данные только одной вкладки РПИ, для каждой загружаемой вкладки загружается отдельный файл: «Показатели», «Измерения», «Факты», «Справочники».

Для каждой вкладки вы можете:

Включить или выключить вкладку с помощью чекбокса
Загрузить для неё файл CSV
Выбрать разделитель, используемый в этом файле

Выбор разделителя данных (указывается отдельно для каждого файла):

Табуляция
Запятая - значение по умолчанию
Точка с запятой

Примечания:

Файл, выбранный при запуске импорта, добавляется как файл с показателями
Селектор разделителя становится доступен после того, как для вкладки загружен файл
На этом шаге можно загружать только файлы с расширением .csv

Выбор колонок

Для каждой выбранной вкладки система создаёт отдельный шаг выбора колонок: показатели, измерения, факты и справочники. На этих шагах вы сопоставляете колонки из файла импорта с колонками РПИ в системе.

Как система определяет колонки для файлов Excel:

Имена колонок берутся из первой непустой строки выбранного листа
Если ячейка в строке с именами колонок пустая, соответствующая колонка пропускается
Если в строке с именами колонок есть объединенные ячейки, все колонки под ними пропускаются

Как система определяет колонки для файлов CSV:

Имена колонок берутся из первой строки файла с учетом выбранного разделителя

Возможности сопоставления колонок (для всех форматов):

Все колонки из файла доступны для сопоставления
Все доступные колонки РПИ в текущем проекте доступны для сопоставления
Вы можете сопоставить только необходимые колонки
Система автоматически сопоставляет колонки, у которых имена в файле совпадают с существующими именами в системе

Сопоставление колонок для справочников:

Шаг для справочников работает иначе, чем шаги для остальных вкладок: колонки файла сопоставляются не с колонками РПИ, а с системными полями справочника.

Системное поле	Описание
«Название»	Название справочника. Справочники загружаются только при сопоставлении этого поля
«Описание»	Описание справочника
«Первичный ключ»	Первичный ключ справочника

Каждое системное поле можно использовать только один раз
Система предзаполняет сопоставление по названиям колонок в файле
Если ни одна колонка не сопоставлена с полем «Название», система предлагает либо продолжить импорт без справочников, либо вернуться и выбрать колонку

Сопоставление вариантов

Эта возможность доступна на шагах выбора колонок для показателей, измерений и фактов — для колонок РПИ с типом поля "Выбор" (выпадающий список).

При сопоставлении вариантов вы можете:

Загрузить список существующих вариантов значений в файле
Сопоставить варианты значений из файла импорта с доступными вариантами в системе
Добавить новые варианты для выпадающих списков непосредственно из экрана импорта
Оставить некоторые варианты несопоставленными (соответствующие ячейки останутся пустыми)

Примечания:

Если для колонки типа "Выбор" существующие варианты значений в файле не были загружены для сопоставления, то значения из этой колонки не будут импортированы
Добавленные варианты сохраняются в системе даже при отмене импорта
Система автоматически сопоставляет варианты из файла с совпадающими названиями в системе
Для колонок "Выбор из БД" сопоставление вариантов недоступно
На шаге для справочников сопоставление вариантов недоступно
Если выбран лист со справочниками, колонка "Справочник" на вкладке измерений загружается как текст и не требует сопоставления вариантов: сами справочники берутся с листа со справочниками

Проверка данных и подтверждение импорта

На этом шаге вы можете просмотреть, как будут выглядеть данные после импорта. Предпросмотр содержит по одной вкладке на каждую загружаемую вкладку РПИ: «Показатели», «Измерения», «Факты», «Справочники».

Возможности просмотра:

Переключение между полным видом таблиц РПИ и видом только сопоставленных колонок
Сортировка, поиск и фильтрация данных (не влияет на импорт)
Прокрутка полных таблиц импортируемых данных
Для справочников в предпросмотре отображаются колонки "Название", "Описание", "Измерения" и "Первичный ключ" с сортировкой и поиском

Справочники с недопустимыми названиями:

Справочники, названия которых нельзя использовать, не загружаются. В предпросмотре появляется сообщение о том, что загружены не все справочники, а в деталях перечислено каждое такое название с причиной:

Причина	Описание
Содержит недопустимые символы	В названии допустимы только буквы, цифры, пробелы, точки, дефисы и знаки подчёркивания
Начинается со специального символа	Название должно начинаться с буквы или цифры
Название не может быть пустым	В файле нет названия
Дублируется в файле	Одно и то же название использовано для нескольких справочников
Длина более 64 символов	Название слишком длинное

Ограничения:

Нельзя редактировать данные в таблице предпросмотра
Данные отображаются точно так, как они будут выглядеть после импорта

Чтобы запустить импорт, нажмите «Выполнить импорт».

Выполнение импорта

После подтверждения импорта:

Все существующие данные в выбранных для импорта разделах РПИ в текущей версии проекта удаляются
Данные из файла загружаются в РПИ
Связи с удаленными данными в других частях продукта удаляются
Вы возвращаетесь на экран РПИ

Важные замечания:

Данные импортируются в ту версию проекта, которая была открыта при запуске импорта
Данные в других версиях проекта не изменяются
Если загружался лист со справочниками, справочники версии полностью синхронизируются с файлом: справочники, отсутствующие в файле, удаляются, а значения колонок РПИ, которые на них ссылались, очищаются
Если при импорте возникает ошибка (например, слишком большой объем данных), система отобразит соответствующее сообщение

Отмена импорта

Вы можете отменить импорт на любом шаге:

Нажмите кнопку отмены или закройте мастер импорта
В появившемся диалоговом окне подтвердите отмену
При отмене никакие данные не загружаются в систему

Примечание: Обновление страницы браузера или переход на другую страницу во время импорта равносильны отмене импорта.

После импорта

После успешного импорта:

На экране РПИ отображается версия, в которую были импортированы данные
Открывается вкладка, выбранная в предпросмотре на последнем шаге мастера. По умолчанию это первая из загружаемых вкладок в порядке: показатели, измерения, факты, справочники