Справочник "Источники данных"

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

Открыть справочник «Источников данных» можно в программных комплексах «Кинт: Управление делами» и «Кинт: Управление санаторием» в разделе ГЛАВНОЕ — ИСТОЧНИКИ ДАННЫХ.

Категории источников данных

Категория источника данных определяет алгоритм получения таблицы с данными. Существующие категории источников данных:

1. Запрос — одна из основных категорий для обращения к БД текущей конфигурации. Запросом можно выбрать любые данные, которые есть в базе. Для создания запроса необходимы базовые знания конфигурации и работы с языком запросов 1С.
2. Файл — представляет собой файл с данными.
3. Интернет-сервис — позволяет получить данные из внешнего сервиса по API.
4. Программный код — требует знания языка программирования и знания объекта, который вызывается. Данная категория используется для специфических ситуаций, например, когда есть функция конфигурации, которая формирует по сложным алгоритмам таблицы, собирая информацию с нескольких источников.
5. Хранилище данных — служит для взаимодействия с внешними сервисами.
6. Соединение — позволяет настроить соединение данных из нескольких источников.

Примеры использования источников данных

Запрос

• В поле «Наименование» запишите название таблицы.
• Во вкладке «Настройки» нажмите на ссылку «Текст запроса». Откроется конструктор запросов. С его помощью можно реализовать простые запросы.
• Во вкладке «Группировка» один из параметров перенесите в Поле группировки, а другое — в суммирующее поле.
• Во вкладке «Объединения/Псевдонимы» задайте псевдоним для строки (полей таблицы).
• Во вкладке «Таблицы и поля» выберите период (например, &КонецПериода).

  Для всех запросов есть 2 предопределенных параметра: «НачалоПериода» и «КонецПериода». Эти параметры связаны с УФО, и когда открываются источники данных в УФО, параметр КонецПериода будет заполнен по периоду, который выбран в УФО.

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

  Данную таблицу можно открыть в универсальной форме отчета нажатием кнопки «Открыть в УФО».

• Чтобы сохранить запрос нажмите кнопку «Записать».

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

Программный код

Рассмотрим на примере отчета «Движения документа».

1. Вызываем функцию «Движения документа».
2. Параметры передаем через символ собака. Функция принимает ссылку на документ и имя регистра, по которому надо получить движения.
3. На закладке «Параметры» выбираем документ, по которому мы извлекаем движения. После этого во вкладке Таблица данных по кнопке Обновить появляется результат работы функции.

Файл

Типы поддерживаемых файлов:

• JSON. Используется в каких=либо сервисах, можно сохранить результат УФО.
• MXL. Стандартные таблицы 1С
• CSV. Строка таблицы соответствует строке текста, которая содержит одно или несколько полей, разделенных запятыми.
• XLS. Excel-таблица. Данные считываются платформой. Устанавливать Excel не надо. Для форматов XLS, MXLS есть настройка параметров считывания.

Чтобы создать источник данных с категорией «Файл», необходимо сделать следующее:

1. Откройте исходный файл и посмотрите, с какой колонки начинается таблица, с какой строки начинаются данные.
2. Соответственно, если шапка таблицы начинается со второй колонки и четвертой строки, то запишите следующее:
   • Номер строки шапки: 4
   • Номер колонки шапки: 2
   • Номер строки с данными: 5
3. Затем выберите путь до исходного файла, и программа считает данные в соответствии с указанными параметрами. Наименование заполняется по имени исходного файла. Так как колонка «№» представлена спецсимволом, то вместо нее стоит нижнее подчеркивание.
4. Выберите «Ресурс» в строке «Остаток», чтобы по этому параметру проводилось суммирование.
5. Во вкладке «Таблица данных» нажмите «Обновить». Формируется таблица данных, и ее можно открыть в УФО.

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

Интернет-сервис

Пример.

1. Создайте источник данных с категорией «Запрос».
2. Поставьте реализацию по контрагентам (количество и сумма), обороты по оперативному учету услуг.
3. Добавьте идентификатор, так как в системе уже есть Санаторий.
4. Нажимаем Получить http-запрос. База при этом должна быть опубликована на веб-сервере. По нажатию он копирует ссылку на запрос, с помощью которого можно получить таблицу данных этого источника. Этот запрос позволяет обращаться к таблице данных и может использоваться во внешних системах, подключенных к вашей (например, можно сделать интеграцию с сайтами).
5. Для этого создайте новый источник данных, вставьте запрос в путь источника, укажите наименование, укажите имя пользователя 1С и пароль. У пользователя должны быть права на чтение данных из регистра, который мы используем в той базе.
6. Нажмите «Записать».
7. Во вкладке «Переменные» нажмите «Обновить», чтобы получить данные о переменных.
8. Выставьте Количество и Сумму как ресурсы.
9. В «Таблице данных» нажмите «Обновить». Появится таблица данных запроса. После этого можно переходить в УФО и редактировать.

Соединение

Пример консолидированного отчета.

1. Выбираем источником любой из двух.
2. Добавляем в тч Связанных источников второй источник с типом соединения Объединение.
3. Записать.
4. Ставим Количество и сумму ресурсами.
5. Записываем и в Таблице данных нажимаем Обновить.
6. Можно редактировать в УФО.

Соединение таблиц

Контрагенты, которые были в 2 санаториях. Пример такой же, как и сверху. Берем внутреннее соединение. Типы соединений: — Левое. Все, что есть в основном источнике и то, что совпадает по ключевым полям, в правом. — Внутреннее. Совпадает в основном и этом — Полное. Данные из всех таблиц, но по ключевым полям из обеих таблиц. (?) — Объединение. Берет все данные из обеих таблиц.

1. В Параметрах выбираем переменную основного источника Контрагенты, условие соединения "=", переиенная связанного источника тоже Контрагенты.
2. На закладке Ресурсы можно определить вычисляемые ресурсы, которые используют ресурсы таблицы, например, общая сумма — это сумма основного источника + сумма связанного источника.
3. Записать.
4. В закладке Переменные нажимаем Обновить.

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

5. Записать. Таблица данных - Обновить.

Сравнение факта и плана

План реализации по дате и сумме. (в корректировках движения проставил план) Или пример, присылают план, мы его загружаем как источник данных и сравниваем. План реализации Оперативный.Обороты с параметром Счет Реализация по месяцам ОператиивныйУчетУслуг.Обороты за период месяц План/факт реализации Основной источник — План реализации Левое соединение реализация по месяцам с параметром месяц, ресурсом отклонение (СуммаПлан - СуммаРеализации) Обновить в таблице данных Переменные СуммаПлан и СуммаРеализации — ресурсы. Отклонение тоже ресурс Потом можно передавать дальше через http-запрос в другой источник. Можно менять настройки отображения. Мощность - служебная. Отчет потом можно вывести в Директор как виджет.

Форма документа

На закладке «Параметры» автоматически заполняются параметры из текста запроса и здесь можно выбрать для них значения, которые будут применяться исключительно для этого запроса. Когда выбирается источник данных в УФО, параметры будут автоматически переопределяться.

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

Во вкладке «Переменные» по кнопке Обновить заполняются колонки таблицы. Здесь можно переопределить заголовки, которые будут отображаться в отчете, и можно выбрать значение колонки «Измерение/Ресурс».

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

Во вкладке «Таблица данных» по кнопке Обновить заполняются данные по запросу.

По кнопке «Вывести список» можно распечатать данные.

По кнопке «Открыть в УФО» открывается отчет с данными из таблицы данных. Исполнитель ушел в развороты, а Количество ушло в ресурсы. Если период изменить, то данные будут отображаться соответствующие.

История изменений, ссылки сюда

• Релиз 3.23.03 (КР) ‎ (← ссылки)
• Релиз 23.05 (КУС) — Реализация по оказанным услугам и сбор отзывов (LTS) ‎ (← ссылки)