Импорт РПИ

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

Функциональность импорта РПИ позволяет загружать данные показателей, измерений, фактов, справочников, таблиц фактов и связей из файлов 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:

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

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

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

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

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

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

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

Сопоставление колонок для таблиц фактов:

Шаг для таблиц фактов идёт сразу после шага для справочников и устроен так же: колонки файла сопоставляются с системными полями таблицы фактов.

Системное поле	Описание
«Название»	Название таблицы фактов. Таблицы фактов загружаются только при сопоставлении этого поля
«Описание»	Описание таблицы фактов. Значения длиннее 255 символов обрезаются
«Показатели»	Показатели, назначенные таблице фактов
«Измерения»	Измерения, назначенные таблице фактов
«Факты»	Факты, назначенные таблице фактов
«Связанные справочники»	Справочники, связанные с таблицей фактов

Система предзаполняет сопоставление, если колонки в файле называются «Название», «Описание», «Показатели», «Измерения», «Факты» и «Связанные справочники». Английские названия этих колонок также распознаются
Эти поля не настраиваются, поэтому система не предлагает конфигурировать сопоставленные колонки
Несколько показателей, измерений, фактов или справочников записываются в одной ячейке файла — каждое название с новой строки, так же как их выгружает экспорт РПИ
Если ни одна колонка не сопоставлена с полем «Название», система предлагает либо продолжить импорт без таблиц фактов, либо вернуться и выбрать колонку

Сопоставление колонок для связей:

Шаг для связей идёт после шага для таблиц фактов и устроен так же.

Системное поле	Описание
«Таблица фактов»	Сторона связи со стороны таблицы фактов
«Справочник»	Сторона связи со стороны справочника
«Ключ в таблице фактов»	Ключ таблицы фактов, используемый в связи. Загружается так же, как первичный ключ справочника
«Тип связи»	Не используется: каждая связь загружается с единственным поддерживаемым типом связи («Многие-к-одному»), поэтому колонку можно не сопоставлять

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

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

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

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

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

Примечания:

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

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

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

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

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

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

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

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

Таблицы фактов, которые не были загружены:

В предпросмотре показываются только те таблицы фактов, названия которых отвечают тем же требованиям, что и при добавлении или переименовании таблицы фактов: от 1 до 64 символов, начинается с буквы или цифры, содержит только буквы, цифры, пробелы, точки, дефисы и знаки подчёркивания. Если в файле есть несколько таблиц фактов с одинаковым названием, ни одна из них не загружается.

Таблицы фактов, не отвечающие этим требованиям, не отображаются в предпросмотре и не импортируются. В этом случае на вкладке появляется сообщение о том, что загружены не все таблицы фактов, рядом со значком предупреждения:

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

Как заполняется предпросмотр таблиц фактов:

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

Связи, которые не были загружены:

Связь показывается в предпросмотре, только если выполняются все условия:

поля «Таблица фактов» и «Справочник» не пустые
таблица фактов совпадает с корректной таблицей фактов из загружаемых таблиц фактов или, если лист с таблицами фактов не загружается, из таблиц фактов, уже существующих в версии
справочник совпадает с корректным справочником из загружаемых справочников или, если лист со справочниками не загружается, из справочников, уже существующих в версии
пара «таблица фактов — справочник» встречается в файле только один раз. Если в файле есть несколько связей с одинаковой парой, ни одна из них не загружается
названия таблицы фактов и справочника не длиннее 64 символов

Связи, не отвечающие этим условиям, не отображаются и не импортируются. Как и на вкладке таблиц фактов, появляется сообщение о том, что загружены не все связи, рядом со значком предупреждения с подсказкой «Просмотреть детали»; нажатие на значок открывает список незагруженных связей с причиной для каждой из них.

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

Колонка	Чем заполняется
«Ключ в таблице фактов»	Значение сопоставленной колонки, обрабатываемое так же, как первичный ключ справочника
«Ключ в справочнике»	Берётся из загружаемых справочников или, если лист со справочниками не загружается, из справочников, уже существующих в версии
«Тип связи»	Всегда «Многие-к-одному» — единственный тип связи; сопоставленная колонка не используется

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

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

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

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

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

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

Если импорт включает таблицы фактов или связи, система:

Если загружается лист таблиц фактов — удаляет существующие таблицы фактов вместе с их связями; если загружается только лист связей — оставляет таблицы фактов, но очищает все их существующие связи со справочниками, так что остаются только связи из файла
Создаёт таблицы фактов в том виде, в котором они показаны на шаге проверки
Назначает им показатели, измерения и факты в том виде, в котором они показаны на шаге проверки
Добавляет к ним справочники в том виде, в котором они показаны на шаге проверки
Настраивает связи на вкладке «Связи» в том виде, в котором они показаны на шаге проверки

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

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

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

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

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

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

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

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

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