Что обозначают конструкции {ВЫБРАТЬ…} и {ГДЕ…} в запросах СКД?

База знаний Одина — Одинэсника › Форумы › ODIN — Форум по 1С Предприятию › Что обозначают конструкции {ВЫБРАТЬ…} и {ГДЕ…} в запросах СКД?

Просмотр 1 ветки ответов
  • Автор
    Записи
    • #39016
      Фото аватараOdineski
      Участник

        {ВЫБРАТЬ
        Сотрудник.}
        ИЗ
        Справочник.Сотрудники КАК Сотрудники
        {ГДЕ
        Сотрудники.Ссылка.
        КАК Сотрудник,
        Сотрудники.ФизическоеЛицо.,
        Сотрудники.ГоловнаяОрганизация.
        }

      • #39017
        bot_avaOdin — Одинэсник
        Участник

          Это не обычный запрос 1С, а запрос для схемы компоновки данных. Фигурные скобки { ... } используются СКД, чтобы автоматически добавлять в запрос поля и условия, выбранные пользователем в настройках отчета.

          Запрос в оформленном виде:

          |{ВЫБРАТЬ
          | Сотрудник.}
          |ИЗ
          | Справочник.Сотрудники КАК Сотрудники
          |{ГДЕ
          | Сотрудники.Ссылка.
          КАК Сотрудник,
          | Сотрудники.ФизическоеЛицо.,
          | Сотрудники.ГоловнаяОрганизация.
          }

          ## 1. Источник данных

          |ИЗ
          | Справочник.Сотрудники КАК Сотрудники

          Запрос обращается к справочнику Сотрудники.

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

          То есть:

          |Справочник.Сотрудники КАК Сотрудники

          означает:

          > Использовать справочник Сотрудники и обращаться к нему в запросе через имя Сотрудники.

          Например, ссылка на элемент справочника записывается так:

          |Сотрудники.Ссылка

          Физическое лицо сотрудника:

          |Сотрудники.ФизическоеЛицо

          Головная организация сотрудника:

          |Сотрудники.ГоловнаяОрганизация

          ## 2. Блок {ВЫБРАТЬ ...}

          |{ВЫБРАТЬ
          | Сотрудник.*}

          Это специальный блок СКД, который формирует список выводимых полей.

          Запись:

          |Сотрудник.*

          означает:

          > Разрешить выбор самого сотрудника и его доступных реквизитов.

          Фактически Сотрудник создается ниже как псевдоним:

          |Сотрудники.Ссылка.* КАК Сотрудник

          То есть:

          |Сотрудники.Ссылка КАК Сотрудник

          это ссылка на элемент справочника Сотрудники, переименованная в Сотрудник.

          А запись с .* разрешает СКД обращаться не только к самой ссылке, но и к связанным данным и реквизитам ссылки, например:

          — код сотрудника;
          — наименование;
          — физическое лицо;
          — головная организация;
          — реквизиты физического лица;
          — представление ссылки.

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

          ## 3. Блок {ГДЕ ...}

          |{ГДЕ
          | Сотрудники.Ссылка.* КАК Сотрудник,
          | Сотрудники.ФизическоеЛицо.,
          | Сотрудники.ГоловнаяОрганизация.
          }

          Этот блок описывает поля, которые можно использовать в отборах СКД.

          Важно: перечисленные здесь поля сами по себе не являются условиями отбора.

          Например, строка:

          |Сотрудники.ФизическоеЛицо.*

          не означает:

          > Отобрать сотрудников, у которых заполнено физическое лицо.

          Она означает:

          > Разрешить использовать физическое лицо и его реквизиты в пользовательских отборах.

          Например, в настройках отчета пользователь сможет установить:

          — Физическое лицо = Иванов Иван Иванович;
          — Физическое лицо.Пол = Мужской;
          — Физическое лицо.Дата рождения больше ....

          А также по головной организации:

          — Головная организация = ООО "Ромашка";
          — Головная организация.Наименование содержит "Ромашка".

          ## 4. Что означает .*

          В данном запросе используются конструкции:

          |Сотрудники.Ссылка.*
          |Сотрудники.ФизическоеЛицо.*
          |Сотрудники.ГоловнаяОрганизация.*

          Звездочка означает возможность обращения к полю и его реквизитам.

          ### Сотрудники.Ссылка.*

          Разрешает использовать:

          — самого сотрудника;
          — его код;
          — наименование;
          — реквизиты элемента справочника Сотрудники.

          ### Сотрудники.ФизическоеЛицо.*

          Разрешает использовать:

          — физическое лицо;
          — его наименование;
          — код;
          — реквизиты физического лица.

          Например, если в справочнике ФизическиеЛица есть реквизиты ДатаРождения, Пол, ИНН, их можно будет использовать в СКД, если они доступны для выбора.

          ### Сотрудники.ГоловнаяОрганизация.*

          Разрешает использовать:

          — головную организацию;
          — наименование организации;
          — код организации;
          — реквизиты организации.

          ## 5. Почему в блоке ВЫБРАТЬ указано Сотрудник.*, а не Сотрудники.Ссылка

          Здесь:

          |{ВЫБРАТЬ
          | Сотрудник.*}

          используется имя Сотрудник, заданное в блоке отбора:

          |Сотрудники.Ссылка.* КАК Сотрудник

          Это позволяет СКД воспринимать ссылку на сотрудника как полноценное поле с реквизитами.

          Если бы было написано:

          |{ВЫБРАТЬ
          | Сотрудники.Ссылка КАК Сотрудник}

          то в результате выбиралась бы только ссылка на сотрудника. Вариант с .* дает СКД больше возможностей для выбора связанных реквизитов.

          ## 6. Что реально будет выполняться

          Сам текст в таком виде нельзя выполнить обычным объектом Запрос напрямую:

          |Запрос.Текст = «…»;

          Конструкции с фигурными скобками обрабатывает именно СКД. Перед выполнением СКД подставляет выбранные поля и условия.

          Например, если в настройках отчета выбраны:

          — сотрудник;
          — физическое лицо;
          — головная организация;

          то СКД может сформировать обычный запрос примерно такого вида:

          |ВЫБРАТЬ
          | Сотрудники.Ссылка КАК Сотрудник,
          | Сотрудники.ФизическоеЛицо КАК ФизическоеЛицо,
          | Сотрудники.ГоловнаяОрганизация КАК ГоловнаяОрганизация
          |ИЗ
          | Справочник.Сотрудники КАК Сотрудники

          Если пользователь добавит отбор по организации, СКД дополнит запрос условием:

          |ГДЕ
          | Сотрудники.ГоловнаяОрганизация = &ГоловнаяОрганизация

          Параметр &ГоловнаяОрганизация будет установлен самой системой компоновки данных.

          ## 7. Есть ли в исходном запросе отбор

          Нет, постоянного отбора в представленном тексте нет.

          Запрос выбирает сотрудников из всего справочника:

          |ИЗ
          | Справочник.Сотрудники КАК Сотрудники

          Блок:

          |{ГДЕ
          | Сотрудники.Ссылка.* КАК Сотрудник,
          | Сотрудники.ФизическоеЛицо.,
          | Сотрудники.ГоловнаяОрганизация.
          }

          не ограничивает выборку. Он только предоставляет поля для настройки отборов.

          Если в настройках СКД пользователь ничего не установит, отчет получит всех сотрудников, доступных с учетом прав пользователя.

          ## 8. Важное отличие Сотрудник и Сотрудники

          В запросе используются два разных обозначения:

          |Сотрудники

          Это псевдоним таблицы справочника.

          |Сотрудник

          Это псевдоним поля Сотрудники.Ссылка.

          Соответственно:

          |Сотрудники.Ссылка.* КАК Сотрудник

          означает:

          > Взять ссылку на элемент справочника Сотрудники и представить ее в СКД под именем Сотрудник.

          ## 9. Для чего обычно используется такой запрос

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

          — выбирать состав выводимых колонок;
          — устанавливать отбор по сотруднику;
          — устанавливать отбор по физическому лицу;
          — устанавливать отбор по организации;
          — использовать реквизиты связанных справочников;
          — не прописывать вручную все возможные поля в основном запросе.

          Например, один пользователь может вывести только ФИО сотрудников, а другой дополнительно выбрать:

          — физическое лицо;
          — головную организацию;
          — код;
          — дату рождения;
          — ИНН;
          — пол;
          — подразделение, если оно есть в структуре данных.

          ## 10. Если нужен обычный запрос без СКД

          Для обычного объекта Запрос фигурные скобки не нужны. Например, получить сотрудников, физические лица и головные организации можно так:

          |ВЫБРАТЬ
          | Сотрудники.Ссылка КАК Сотрудник,
          | Сотрудники.ФизическоеЛицо КАК ФизическоеЛицо,
          | Сотрудники.ГоловнаяОрганизация КАК ГоловнаяОрганизация
          |ИЗ
          | Справочник.Сотрудники КАК Сотрудники

          А отбор по организации добавляется явно:

          |ВЫБРАТЬ
          | Сотрудники.Ссылка КАК Сотрудник,
          | Сотрудники.ФизическоеЛицо КАК ФизическоеЛицо,
          | Сотрудники.ГоловнаяОрганизация КАК ГоловнаяОрганизация
          |ИЗ
          | Справочник.Сотрудники КАК Сотрудники
          |ГДЕ
          | Сотрудники.ГоловнаяОрганизация = &ГоловнаяОрганизация

          В таком случае параметр устанавливается в коде:

          |Запрос.УстановитьПараметр(«ГоловнаяОрганизация», Организация);

          Итого по назначению отдельных частей:

          |{ВЫБРАТЬ …}

          Поля, доступные для вывода в отчете.

          |{ГДЕ …}

          Поля, доступные для отбора в отчете.

          |Сотрудники.Ссылка.* КАК Сотрудник

          Сотрудник и его реквизиты.

          |Сотрудники.ФизическоеЛицо.*

          Физическое лицо сотрудника и его реквизиты.

          |Сотрудники.ГоловнаяОрганизация.*

          Головная организация сотрудника и ее реквизиты.

          |ИЗ Справочник.Сотрудники

          Основной источник данных, из которого выбираются сотрудники.

      Просмотр 1 ветки ответов
      • Для ответа в этой теме необходимо авторизоваться.
      База знаний 1С