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

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

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

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

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

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

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

Запрос

Рассмотрим создание источника данных с категорией «Запрос» на примере формирования отчета «Документы в работе»:

1. В поле «Наименование» запишите название таблицы.
2. Во вкладке «Настройки» нажмите на ссылку «Текст запроса». Откроется конструктор запросов на вкладке «Таблицы и поля».
3. В «Базах данных» выберите регистр накопления «яъДокументыВРаботе.Остатки» и щелкните по нему дважды. Регистр будет занесен в «Таблицы».
4. Раскройте регистр и дважды щелкните по параметру «Исполнитель» в «Таблицах». Параметр будет занесен в «Поля»
5. Щелкните дважды по параметру «ЗначениеСвойстваОстаток». Параметр также будет занесен в «Поля».
6. Во вкладке «Группировка» перенесите параметр «Исполнитель» в Поле группировки, а «ЗначениеСвойстваОстаток» — в суммирующее поле.
7. Во вкладке «Объединения/Псевдонимы» щелкните дважды на строку «ЗначениеСвойстваОстаток» и задайте псевдоним.
8. Вернитесь во вкладку «Таблицы и поля» и в строке период пропишите «&КонецПериода».

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

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

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

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

Файл

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

• 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. На закладке «Параметры» выберите документ, по которому мы извлекаем движения. После этого во вкладке Таблица данных по кнопке Обновить появляется результат работы функции.

Соединение

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

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

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

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

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

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

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

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

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

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

• Запрос

  Рис. 1. Категория «Запрос»

  

• Файл

  Рис. 2. Вкладка «Группировка»

  

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

  Рис. 3. Вкладка «Условия»

  

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

  Рис. 4. Вкладка «Дополнительно»

  

• Хранилище данных

  Рис. 5. Вкладка «Объединения/псевдонимы»

  

• Соединение

  Рис. 6. Вкладка «Порядок»

  

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

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

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

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

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

По кнопке Открыть в УФО открывается отчет с данными из таблицы данных.

Форма конструктора запросов

Конструктор запросов доступен по нажатию ссылки «Текст запроса» при выбранной категории «Запрос». Форма конструктора запросов состоит из множества вкладок:

• Таблицы и поля

  Рис. 1. Вкладка «Таблицы и поля»

  

• Группировка

  Рис. 2. Вкладка «Группировка»

  

• Условия

  Рис. 3. Вкладка «Условия»

  

• Дополнительно

  Рис. 4. Вкладка «Дополнительно»

  

• Объединения/псевдонимы

  Рис. 5. Вкладка «Объединения/псевдонимы»

  

• Порядок

  Рис. 6. Вкладка «Порядок»

  

• Итоги

  Рис. 7. Вкладка «Итоги»

  

• Пакет запросов

  Рис. 8. Вкладка «Пакет запросов»

  

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

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