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

Работа с источниками данных

Работа с источниками данных

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

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

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

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

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

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

Запрос

Рассмотрим пример формирования отчета «Документы в работе»:

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

   

7. На закладке Группировка перенесите параметр «Исполнитель» в Поле группировки, а «ЗначениеСвойстваОстаток» — в суммирующее поле.

   

8. На закладке Объединения/Псевдонимы щелкните дважды на строку «ЗначениеСвойстваОстаток» и задайте псевдоним.

   

9. Вернитесь на закладку Таблицы и поля и в строке период пропишите «&КонецПериода».

   

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

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

    

12. На закладке Данные нажмите Обновить. Появится таблица данных запроса.

    

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

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

Файл

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

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

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

1. Создайте источник данных с категорией «Файл».
2. Откройте исходный файл и посмотрите, с какой колонки начинается таблица, с какой строки начинаются данные.

   

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

   

5. Выберите «Ресурс» в строке «Остаток», чтобы по этому параметру проводилось суммирование.
6. На закладке Таблица данных нажмите Обновить. Формируется таблица данных, и ее можно открыть в УФО.

   

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

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

Пример.

1. Создайте источник данных с категорией «Запрос».

   

2. Поставьте реализацию по контрагентам (количество и сумма), обороты по оперативному учету услуг.
3. Добавьте идентификатор, так как в системе уже есть наименование «Санаторий».
4. Нажмите Получить HTTP-запрос. База при этом должна быть опубликована на веб-сервере. По нажатию он копирует ссылку на запрос, с помощью которого можно получить таблицу данных этого источника. Этот запрос позволяет обращаться к таблице данных и может использоваться во внешних системах, подключенных к вашей (например, можно сделать интеграцию с сайтами).

   

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

   

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

   

   Выбрать параметр периода можно, прописав его вручную в строке «Путь» в формате ISO:

   

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

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

1. Вызовите функцию «Движения документа».
2. Параметры передайте через символ «@». Функция принимает ссылку на документ и имя регистра, по которому надо получить движения.

   

3. На закладке Параметры выберите документ, по которому мы извлекаем движения.

   

4. После этого на закладке Таблица данных по кнопке Обновить появляется результат работы функции.

   

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

Отличие от категории «Запрос» заключается в следующем: если что-то поменяли, то результат запроса изменится, а результат источника данных с типом «Хранилище данных» всегда будет одинаковым. Можно использовать чтобы сохранить какую-либо эталонную таблицу, чтобы, например, дальше использовать ее при сравнении данных.

В текущем релизе работать с таким ИД можно только программно.

Пример:

&НаСервере
// Таблица реализации во временном хранилище.
Функция АдресТаблицыЗначенийВоВременномХранилище()
	запрос = Новый Запрос("ВЫБРАТЬ
			|	оу_ОперативныйУчетУслугОбороты.Субконто1.Наименование КАК Контрагент,
			|	оу_ОперативныйУчетУслугОбороты.Субконто1.ИНН КАК ИНН,
			|	СУММА(оу_ОперативныйУчетУслугОбороты.КоличествоОборотДт) КАК Количество,
			|	СУММА(оу_ОперативныйУчетУслугОбороты.СуммаОборотДт) КАК Сумма
			|ИЗ
			|	РегистрБухгалтерии.оу_ОперативныйУчетУслуг.Обороты(&НачалоПериода, &КонецПериода, , , , , , ) КАК оу_ОперативныйУчетУслугОбороты
			|ГДЕ
			|	оу_ОперативныйУчетУслугОбороты.КоличествоОборотДт > 0
			|
			|СГРУППИРОВАТЬ ПО
			|	оу_ОперативныйУчетУслугОбороты.Субконто1.Наименование,
			|	оу_ОперативныйУчетУслугОбороты.Субконто1.ИНН");
	запрос.УстановитьПараметр("НачалоПериода", Дата('20230101'));
	запрос.УстановитьПараметр("КонецПериода", Дата('20230131'));
	Возврат ПоместитьВоВременноеХранилище(запрос.Выполнить().Выгрузить(), УникальныйИдентификатор);
КонецФункции

&НаКлиенте
// Открывает форму записи данных в источник данных с типом "Хранилище данных".
Процедура ОткрытьФормуСохраненияДанных(Команда)
	стРеквизиты = _ст("Наименование", "Реализация январь (до корректировки)");
	вхТаблицаСДанными = АдресТаблицыЗначенийВоВременномХранилище();
	Если вхТаблицаСДанными = Неопределено Тогда Возврат; КонецЕсли;
	яъПрикладныеОбъекты.ОткрытьФормуСозданияИсточникаДанных(вхТаблицаСДанными, стРеквизиты);
КонецПроцедуры

Соединение

Типы соединений:

• Левое. Все, что есть в основном источнике и то, что совпадает по ключевым полям, в связанном.

  

• Внутреннее. Совпадает в основном и связанном источнике по ключевым полям.

  

• Полное. Берутся данные, совпадающие по ключевым полям, из всех источников.
• Объединение. Берутся все данные из всех источников.

  

Консолидированный отчет

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

   

4. Проставьте в строки «Количество» и «Сумма» значение «Ресурс».

   

5. Запишите источник и на закладке Данные нажмите Обновить. Полученный отчет можно редактировать в УФО.

   

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

Рассмотрим на примере отчета «Контрагенты, которые были в 2 санаториях».

1. Источники выберите такие же, как и в примере консолидированного отчета. Выберите внутреннее соединение.
2. В «Параметрах» выберите переменную основного источника «Контрагенты».
3. Выберите условие соединения "=".
4. В качестве переменной связанного источника также выберите «Контрагенты».

   

5. На закладке Ресурсы можно определить вычисляемые ресурсы, которые используют ресурсы таблицы, например, общая сумма — это сумма основного источника + сумма связанного источника.
6. Нажмите кнопку «Записать».

   

7. На закладке Переменные нажмите Обновить.

   

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

   Выберите вычисляемый ресурс — «Общую сумму» в виде ресурса.

8. Нажмите Записать.
9. Откройте закладку Данные и обновите.

   

Отчет

Категория источника данных «Отчет» используется для получения данных из универсальной формы отчета (УФО).

Пример использования: отображение отчета в качестве виджета в интерфейсе «Директор».

Перед созданием источника данных необходимо настроить вариант отчета в УФО (развороты и ресурсы) и сохранить его в качестве общего отчета.

1. В справочнике «Источники данных» создайте новый источник данных.
2. В поле «Категория» выберите «Отчет».
3. На закладке Настройки выберите подготовленный ранее вариант отчета.
4. Нажмите кнопку Заполнить переменные, чтобы автоматически загрузить параметры отчета.
5. При необходимости нажмите кнопку с настройками источника данных и задайте формат отображения данных, измените заголовки.
6. Нажмите кнопку Записать для сохранения источника данных.

   

Источник данных вставляется в макет HTML-виджета, созданного с указанием владельца — «Интерфейс «Директор».

Интерфейс источника данных

• Отчет

  

• Запрос

  

• Файл

  

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

  

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

  

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

  

• Соединение

  

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

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

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

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

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

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

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

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

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

  

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

  

• Условия

  

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

  

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

  

• Порядок

  

• Итоги

  

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