Мета нашої компанії -  надання якісних послуг по навчанню та консультуванню клієнтів.

Як програмно відкрити форму звіту з встановленим відбором по полю/параметру СКД?

Для реалізації задачі будемо використовувати параметри форми. Параметри форми необхідні для організації зв'язку між різними формами та управління функціональністю форми при її відкритті.

Параметри може створювати розробник на відповідній закладці «Параметри» керованої форми. Але також формою автоматично надаються параметри, які обумовлені типом основного реквізиту. Нас будуть цікавити саме параметри у керованої форми звіту. Їх опис можна знайти у Синтаксис-помічнику (рис. 1).


Рис 1. – Параметри керованої форми звіту у Синтаксис-помічнику

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

  • Отбор (Filter)
    • Тип: Структура.
    • Опис: Використовується для установки відбору і параметрів даних у формі звіту. Ключ елемента структури містить ім'я поля або параметра, на яке потрібно накладати відбір. Значення елемента структури містить значення відбору. Якщо є параметр системи компоновки даних з ім'ям, що відповідає імені ключа структури, то значення буде встановлено йому. Якщо параметра немає, але є поле, то буде доданий відбір на це поле. Якщо значення є масивом або списком значень з декількома елементами, то відбір буде застосовуватися з видом порівняння: ВСписке.
  • СформироватьПриОткрытии (GenerateOnOpen)
    • Тип: Булево.
    • Опис: Вказує необхідність формування звіту при відкритті. Истина - звіт буде сформовано відразу на сервері, після обробника події ПриСозданииНаСервере.

Продемонструємо приклад застосування наведених параметрів. Для цього реалізуємо наступну задачу.

Завдання. Реалізувати можливість програмно відкрити і сформувати звіт «ЦеныПоставщиков» з відбором по одному або декільком контрагентам.


У нашому випадку в основній СКД звіту «ЦеныПоставщиков» присутнє поле, що відповідає імені ключа структури відбору. І оскільки значення ключа у наведеному прикладі є масивом значень, то відбір застосовується з видом порівняння: ВСписке, що підтверджується сформованим звітом (рис. 2).

Звернемо увагу, що у заголовку сформованого звіту (рис 2.) буде зазначено«Встановлено додатковий відбір», що означає, що спрацювали фіксовані настройки СКД


Рис 2. – Сформований звіт з програмно визначеними параметрами

Більш детально про налаштування та доробку звітів в прикладних рішеннях BAS за допомогою СКД (системи компонування даних) Ви можете дізнатись на нашому курсі "Розробка звітів на СКД в системі BAS"


Язык материала:  ua