Добавление данных

Вкладка ДАННЫЕ - самая правая панель отчета. Ее видно в режиме редактирования. Предназначена для добавления, обновления или удаления данных, их сортировки и фильтрации.

Основные возможности вкладки ДАННЫЕ

Создание календарного источника по диапазону дат.
Подключение таблиц из каталога доступных баз данных.
Прямое подключение к PostgreSQL или Microsoft SQL Server.
Выбор одной или нескольких таблиц, или представлений из базы данных.
Предпросмотр структуры и первых строк таблицы перед загрузкой.
Загрузка данных из CSV, Excel, JSON и XML.
Вставка данных вручную в формате CSV или JSON.
Загрузка файла по прямой ссылке.
Выбор нескольких листов Excel и создание отдельных источников для каждого листа.
Подключение списков Business Scanner Platform.
Подключение коннекторов ALAN IoT App, Business Scanner (Задачи) и Weeek CRM.
Подключение файлов через Data Gateway.
Подключение данных по JSON-ссылке с дополнительными HTTP-заголовками.
Настройка типов колонок перед созданием источника.
Разворачивание вложенных объектов в данных, полученных по ссылке.

Варианты добавления данных в отчет

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

При создании первого отчета добавить данные можно со стартового экрана, где доступны быстрые карточки:

Получить данные;
Базы данных;
Excel;
CSV;
Вставьте данные или введите их вручную;
Списки;
ссылка Посмотреть список доступных коннекторов.

Если в отчете еще нет источников, в панели Данные отображается пустое состояние с кнопкой Добавить данные.

Модальное окно добавления данных

При нажатии на кнопку ПОЛУЧИТЬ или ДОБАВИТЬ ДАННЫЕ (в любом из вариантов) откроется модальное окно добавления данных. Оно называется Добавить источник данных.
Здесь можно выбрать способ подключения к источнику данных: из каталога доступных баз или прямое подключение баз данных, не зарегистрированных в каталоге.

В левой части окна доступны варианты источников данных:

Глобальные источники;
Хранилища;
Календарь;
Базы данных;
Файлы;
Списки;
Коннекторы;
Ссылки;
Data Gateway;
Веб-службы;
Cloud Apps;
Yandex Services.

Внизу окна для удобства есть кнопка Отмена. И основная кнопка действия - Выберите файл. Текст этой кнопки меняется в зависимости от выбора источника данных. Например, при получении данных из файла – «Выберите файл», из Календаря- «Далее», по ссылкам – предложит «Загрузить данные». Кнопка становится недоступной, пока не заполнены обязательные поля или не выбран нужный элемент.

Сообщения об ошибках

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

Варианты подключения данных из разных источников

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

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

Подключить базу данных из каталога Используется, когда нужная база уже зарегистрирована в каталоге Alan-IT и доступна пользователю.

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

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

Откройте Получить данные.
Выберите Базы данных.
На шаге выбора способа подключения отметьте Прямое подключение.
Нажмите Далее.
Выберите тип базы данных: PostgreSQL, Microsoft SQL Server и т.д.
В блоке Сервер выберите способ ввода: Хост или Строка подключения.
Для режима Хост заполните URL, порт, имя базы данных и режим SSL. Для режима Строка подключения вставьте строку подключения.
В блоке Аутентификация укажите логин и пароль.
Нажмите Тестировать подключение.
После успешного теста нажмите Продолжить с этим подключением.
Выберите таблицы или представления.
Нажмите Загрузить и преобразовать. В результате таблицы из внешней базы данных будут добавлены в отчет.

Создать источник через собственный SQL-запрос Когда нужно загрузить не всю таблицу, а подготовленную выборку: например, только нужные поля, строки за период или результат объединения таблиц.

Откройте прямое подключение к базе данных.
Заполните параметры сервера и аутентификации.
В блоке Расширенные параметры включите Использовать собственную SQL инструкцию.
Введите SQL-запрос.
Используйте только запросы на чтение: SELECT или WITH.
Нажмите Тестировать подключение и создать источник данных. Если подключение и запрос корректны, источник будет создан сразу по результату SQL-инструкции.

Выбрать таблицы из базы данных Когда подключение уже выбрано и нужно определить, какие таблицы попадут в отчет.

На шаге Выбор таблиц просмотрите список найденных таблиц.
Используйте вкладки Все, Таблицы и Представления.
Введите часть названия в поле поиска, если таблиц много.
При необходимости нажмите Группировать по схемам или Показать все.
Отметьте нужные таблицы.
Чтобы выбрать все видимые элементы, нажмите Выбрать все.
Для проверки нажмите значок предпросмотра рядом с таблицей.
Нажмите Загрузить и преобразовать. Выбранные таблицы будут загружены в список источников отчета.

Посмотреть предпросмотр таблицы или списка Когда нужно проверить структуру источника до добавления в отчет, понять какие поля есть в источнике и как выглядят первые строки данных.

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

Загрузить файл с компьютера Когда данные находятся в локальном CSV, Excel, JSON или XML-файле.

Откройте Получить данные.
Выберите Файлы.
Перейдите на вкладку Выбрать файл.
Перетащите файл в область загрузки или нажмите на нее и выберите файл.
Дождитесь обработки файла.
Если это Excel с несколькими листами, выберите один или несколько листов.
Нажмите Далее.
Укажите или проверьте имя источника данных.
На вкладке Таблица проверьте первые строки.
На вкладке Заголовки проверьте и при необходимости измените типы данных для каждой колонки таблицы (текст/число/дата).
Нажмите Загрузить и преобразовать. Файл будет добавлен в отчет как источник данных. Если выбрано несколько листов Excel, каждый лист станет отдельным источником.

Добавить данные вручную Когда нужно быстро добавить небольшой набор данных без отдельного файла: например, справочник, тестовую таблицу или список значений.

Откройте Получить данные.
Выберите Файлы.
Перейдите на вкладку Ввести данные.
Вставьте данные в формате CSV или JSON.
Если вставлен CSV, проверьте разделитель: запятая, точка с запятой, табуляция или вертикальная черта.
Нажмите Загрузить данные.
Проверьте имя источника, строки и типы колонок.
Нажмите Загрузить и преобразовать. Введенные данные будут добавлены в отчет как источник.

Загрузить файл по URL Когда файл доступен по прямой ссылке, например https://example.com/data.csv.

Откройте Получить данные.
Выберите Файлы.
Перейдите на вкладку Ввести URL файла.
Вставьте прямую ссылку на файл.
Нажмите Загрузить.
Проверьте имя источника, строки и типы колонок.
Нажмите Загрузить и преобразовать. Файл по ссылке будет добавлен в отчет как источник данных.

Добавить список Business Scanner Platform Когда нужно использовать уже созданный справочник или список из Business Scanner Platform.

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

Подключить данные ALAN IoT App Когда нужно загрузить данные конкретного IoT-устройства.

Откройте Получить данные.
Выберите Коннекторы.
Выберите коннектор ALAN IoT App.
Нажмите Далее.
Найдите устройство по названию, Device EUI или описанию.
При необходимости измените сортировку или вид списка.
Выберите устройство.
Нажмите Загрузить и преобразовать. В отчет добавится источник данных выбранного IoT-устройства.

Подключить данные Business Scanner (Задачи) Когда нужно анализировать задачи, участников, теги, чек-листы или действия по задачам.

Откройте Получить данные.
Выберите Коннекторы.
Выберите коннектор типа Business Scanner (Задачи).
Нажмите Далее.
Выберите доску.
При необходимости используйте поиск, сортировку и переключение вида.
Нажмите Далее.
Выберите типы данных: Задачи; Действия в задачах; Пользователи; Участники в задачах; Чек-листы; Элементы чек-листов; Теги.
Или нажмите Выбрать все.
Нажмите Загрузить и преобразовать. Каждый выбранный тип данных будет добавлен в отчет отдельным источником.

Подключить данные Weeek CRM Когда нужно анализировать данные CRM: сделки, контакты, организации, воронки и валюты.

Откройте Получить данные.
Выберите Коннекторы.
Выберите коннектор Weeek.
Нажмите Далее.
Выберите нужные типы данных: Воронки; Статусы воронок; Сделки; Организации; Контакты; Валюты.
При необходимости нажмите Выбрать все.
Нажмите Загрузить и преобразовать. Выбранные таблицы Weeek CRM будут добавлены в отчет как источники данных.

Подключить данные по JSON-ссылке Когда данные доступны через URL, который возвращает JSON-ответ.

Откройте Получить данные.
Выберите Ссылки.
Введите название источника, если хотите задать его вручную.
Введите URL.
Если API требует авторизацию или специальные параметры, добавьте HTTP-заголовки.
Нажмите Загрузить данные.
На шаге предпросмотра выберите Путь к данным, если в ответе найдено несколько массивов или объектов.
Проверьте типы колонок.
Если колонка содержит вложенный объект, откройте контекстное меню заголовка и выберите Развернуть столбцы.
Проверьте строки предпросмотра.
Нажмите Загрузить и преобразовать. JSON-данные по ссылке будут добавлены в отчет. Если вложенные объекты были развернуты, они станут отдельными колонками.

Подключить файл через Data Gateway Когда файл находится в корпоративной сети или на машине, доступ к которой организован через шлюз.

Откройте Получить данные.
Выберите Data Gateway.
Выберите шлюз со статусом online.
В дереве папок выберите файл.
Проверьте превью первых 5 строк.
Нажмите Подключить. Выбранный файл будет добавлен в отчет как источник Data Gateway.

Работа с данными

Что отображается в каталогах и списках

В каталоге баз данных: название базы, сервер, логин, статус активности и признак SSL.
В выборе таблиц: название таблицы или представления, тип объекта, схема и количество строк, если оно доступно.
В списках: название, описание, количество элементов или записей, количество колонок, дополнительные поля и первые названия колонок.
В коннекторах: название интеграции, тип интеграции и дата создания.
В устройствах IoT: название, Device EUI и описание.
В досках задач: название, рабочая область, количество задач и чек-листов.
В Data Gateway: имя шлюза, hostname, операционная система, версия, статус, имя файла, размер и дата изменения.

Можно ли сортировать, группировать, экспортировать или раскрывать данные

Действие	Доступность
Поиск таблиц, списков, устройств и досок	Да
Фильтр таблиц по типу Все / Таблицы / Представления	Да
Группировка таблиц по схемам	Да
Выбор всех видимых таблиц	Да
Сортировка устройств	Да, по описанию или количеству устройств
Сортировка досок	Да, по рабочей области, количеству задач или количеству досок
Переключение вида устройств и досок	Да, сетка, таблица, kanban, список
Предпросмотр таблиц и списков	Да
Предпросмотр файлов	Да
Предпросмотр JSON-ссылок	Да, до 50 строк на экране из загруженного превью
Предпросмотр Data Gateway	Да, первые 5 строк файла
Изменение типов колонок	Да, для файлов и JSON-ссылок
Разворачивание вложенных объектов	Да, для JSON-ссылок
Экспорт из окна предпросмотра	Кнопка отображается, но рабочий сценарий экспорта требует уточнения

Частые варианты использования

Быстро начать отчет с Excel или CSV

Откройте Получить данные.
Выберите Файлы.
Загрузите Excel или CSV.
Проверьте названия колонок и типы данных.
Нажмите Загрузить и преобразовать.

Добавить календарь к фактическим данным

Сначала загрузите фактическую таблицу с датами.
Добавьте источник Календарь на нужный диапазон дат.
Используйте календарные поля для фильтрации и группировки в отчете.

Проверить, подходит ли таблица из базы данных

Выберите базу данных.
Найдите таблицу через поиск.
Откройте предпросмотр.
Проверьте названия колонок, типы и первые строки.
Только после проверки добавьте таблицу в отчет. Так можно избежать подключения лишних или похожих таблиц.

Загрузить несколько связанных таблиц по Задачам

Выберите коннектор Business Scanner (Задачи).
Выберите доску.
Отметьте Задачи, Пользователи, Участники в задачах, Теги и другие нужные таблицы.
Загрузите выбранные таблицы. Используется для распределения и контроля выполнения задач по специалистам, создания чек-листов.

Подготовить JSON API к анализу

Выберите Ссылки.
Укажите URL и заголовки авторизации, если они нужны.
Загрузите данные.
Выберите правильный путь к массиву данных.
Разверните вложенные колонки, если API возвращает объекты внутри объектов.
Проверьте типы колонок и создайте источник. Так можно использовать данные из API без отдельной ручной подготовки файла.

Подключить файл из закрытой сети

Убедитесь, что Data Gateway запущен и отображается как online.
Откройте Data Gateway.
Выберите шлюз и файл в каталоге.
Проверьте первые строки.
Нажмите Подключить. Вариант подходит для файлов, которые нельзя открыть прямой публичной ссылкой.

Возможные состояния экрана

Нет доступных баз данных - в каталоге нет баз, доступных пользователю.
Таблицы не найдены - в базе нет таблиц.
Нет доступных коннекторов - коннекторы еще не созданы в разделе подключений.
Нет доступных устройств - в выбранной интеграции ALAN IoT App нет устройств.
Нет доступных досок - в выбранной интеграции задач нет досок.
Нет доступных шлюзов - агент Data Gateway не запущен или не подключен.
Каталог файлов пуст - для шлюза не найдены расшаренные папки или файлы.

Ошибки

Могут возникать при:

отсутствии токена авторизации;
недоступности API;
ошибке загрузки баз, таблиц, списков, устройств, досок или шлюзов;
неверных параметрах прямого подключения;
отсутствии обязательных полей подключения;
некорректной SQL-инструкции;
попытке использовать запрещенные SQL-операции;
ошибке загрузки файла;
неподдерживаемом формате файла;
превышении максимального размера файла;
некорректном JSON или XML;
пустом Excel-листе или JSON-массиве;
недоступном URL;
HTTP-ошибке при загрузке данных по ссылке;
невозможности найти данные в JSON-ответе;
ошибке создания источника на сервере.

Частые вопросы

Какие источники данных можно добавить? Доступны: календарь, базы данных из каталога, прямые подключения к PostgreSQL и Microsoft SQL Server, файлы CSV/Excel/JSON/XML, вставленные CSV/JSON-данные, файлы по URL, списки Business Scanner Platform, JSON-ссылки, коннекторы ALAN IoT App, Business Scanner (Задачи), Weeek CRM и файлы через Data Gateway.

Можно ли загрузить несколько таблиц за один раз? Да. В базах данных можно выбрать несколько таблиц. В списках можно выбрать несколько списков. В Business Scanner (Задачи) и Weeek CRM можно выбрать несколько типов данных. В Excel можно выбрать несколько листов.

Почему кнопка ДАЛЕЕ или ЗАГРУЗИТЬ И ПРЕОБРАЗОВАТЬ недоступна? Обычно не заполнено обязательное поле или не выбран нужный элемент: база, таблица, список, коннектор, устройство, доска, тип данных, дата, файл или URL.

Какие форматы файлов поддерживаются? Поддерживаются CSV, Excel XLSX/XLS, JSON и XML. Для загрузки с компьютера максимальный размер файла - 50 МБ.

Можно ли вставить данные вручную? Да. Во вкладке Файлы есть режим Ввести данные. Он поддерживает CSV с разделителями и JSON.

Можно ли использовать свой SQL-запрос? Да, для прямого подключения. Нужно включить Использовать собственную SQL инструкцию. Разрешены только запросы на чтение: SELECT и WITH. Модифицирующие операции запрещены.

Почему SQL-запрос не принимается? Запрос отклоняется, если начинается не с SELECT или WITH, либо содержит операции изменения данных: DELETE, UPDATE, INSERT, CREATE, DROP, ALTER, TRUNCATE, REPLACE, MERGE, GRANT, REVOKE, COMMIT, ROLLBACK, SAVEPOINT.

Можно ли подключить API, который требует токен?

Да, если API возвращает JSON. В разделе Ссылки можно добавить заголовки, например Authorization, X-API-Key или X-Auth-Token.

Что делать, если JSON-ответ содержит несколько массивов? На шаге предпросмотра выберите нужный Путь к данным. Модуль пытается найти подходящие массивы и объекты автоматически.

Что значит точка рядом с названием колонки в JSON-предпросмотре? Она показывает, что колонка содержит вложенный объект. Такую колонку можно развернуть в отдельные столбцы через контекстное меню.

Почему список нельзя выбрать? Если список пуст и не содержит колонок, его карточка становится недоступной. Такой список нельзя выбрать или открыть в предпросмотре.

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

Почему Data Gateway показывает только часть шлюзов? В списке отображаются только шлюзы со статусом online. Offline-шлюзы в выборе не показываются.

Краткая памятка

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