SQL запросы (версия 3.xx)/1C

Материал из Call Office Wiki
Перейти к навигации Перейти к поиску

Для работы с данными 1С можно использовать стандартные SQL запросы, которые буду преобразованы в формат, воспринимаемый 1С.

Поддерживаются SQL - операторы:

  • select или ВЫБРАТЬ - выборка данных. В списке полей можно указать только * - все поля. Пример: ВЫБРАТЬ ПЕРВЫЕ 10 * ИЗ Справочник.Контрагенты
    • where или ГДЕ - позволяет указать условие выборки. Пример: select * from Справочник.Контрагенты where Наименование = "Тест"
  • insert - вставка данных, позволяет указать список полей и константы значений, выражения не поддерживаются. Пример: insert into Справочники.Контрагенты (Наименование) values ("Тест")
  • update - изменение данных, позволяет указать список изменяемых полей и условие отбора. Пример: update Справочники.Контрагенты set Комментарий = 5 where Наименование = 'Тест'
  • delete - изменение данных, позволяет указать список изменяемых полей и условие отбора. Пример: delete from Справочник.Контрагенты where Наименование = "Тест"

Помимо этого SQL-запросы к этому источнику данных могут содержать комментарии в виде /* */ и содержать несколько запросов разделенных символами // на новой строке.

Пример SQL-запросов 1C на выборку данных

SQL-запросы на выборку данных полностью аналогичны запросам Новый Запрос на языке 1C. Например, запрос на выборку контрагентов с номерами телефонов выглядит так:

ВЫБРАТЬ * 
     ИЗ Справочник.Контрагенты КАК Контрагенты
        ЛЕВОЕ СОЕДИНЕНИЕ РегистрСведений.КонтактнаяИнформация КАК Телефон ПО (Телефон.Объект = Контрагенты.Ссылка) 
                                                                           И (Телефон.Тип = ЗНАЧЕНИЕ(Перечисление.ТипыКонтактнойИнформации.Телефон))
                                                                           И (Телефон.Вид = ЗНАЧЕНИЕ(Справочник.ВидыКонтактнойИнформации.ТелефонКонтрагента))
   ГДЕ Телефон.Представление ЕСТЬ НЕ null 
УПОРЯДОЧИТЬ ПО Контрагенты.Наименование

Или на привычном языке SQL этот же запрос выглядит так:

select * 
  from Справочник.Контрагенты AS Контрагенты
       left join РегистрСведений.КонтактнаяИнформация as Телефон on (Телефон.Объект = Контрагенты.Ссылка)
                                                                and (Телефон.Тип = VALUE(Перечисление.ТипыКонтактнойИнформации.Телефон))
                                                                and (Телефон.Вид = VALUE(Справочник.ВидыКонтактнойИнформации.ТелефонКонтрагента))
 where Телефон.Представление is not null 
order by Контрагенты.Наименование

Более подробно о том как составлять запросы на выборку данных 1C можно посмотреть здесь.

Пример SQL-запросов 1C на изменение данных

SQL-запросы на изменение данных не поддерживаются 1C, поэтому функционал таких запросов эмулируется средой Call Office. Следует учитывать, что из-за особенностей 1C, имена таблиц в запросах на выборку данных выглядят одним образом (например, Справочник.Контрагенты), а при работе на изменение данных - другим (например, Справочники.Контрагенты).

Поэтому, SQL-запрос на запись результатов звонка в поле Комментарий объекта Контрагенты выглядит так:

update Справочники.Контрагенты
   set Комментарий = [ColumnResult]
 where Наименование = '[Наименование]'

Использование функций для доступа к данным 1C

Если возможностей SQL-запросов недостаточно, то вы можете работать напрямую с функциями объектов 1C на языке javascript. Такие функции необходимо заключать между символами /! и !/. Например, следующая функция найдет контрагента с кодом 000000001, запишет 11455 в его ИНН:

 /!
 function (Connection) {

    var Find = Connection.Справочники.Контрагенты.НайтиПоКоду ('000000001');

    if (Find != Connection.Справочники.Контрагенты.ПустаяСсылка ()) {

       var Contractor = Find.ПолучитьОбъект ();
       Contractor.ИНН =  11455;
       Contractor.Записать ();

    } else alert ('Контрагент не найден !');

    return null;
 }
 !/
 

А эта выберет первые 10 контрагентов:

 /!
 function (Connection) {

    var Query = Connection.NewObject ('Query');
    Query.text = "ВЫБРАТЬ ПЕРВЫЕ 10 * ИЗ Справочник.Контрагенты";

    return Query.execute ();
 }
 !/
 

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

 /!
 function (Connection) {

    var nz = Connection.РегистрыСведений.КакойтоРегистр.СоздатьНаборЗаписей();

    nz.Отбор.УИД.Установить ('[Выборка.УИД]'); // Ищем по уникальному идентификатору

    nz.Прочитать();

    if (nz.Количество() > 0) {

       var curz = nz.Получить(0);
       curz.Статус = '[ColumnResult]';

       nz.Записать ();
    }

    return null;
 }
 !/
 

В качестве параметра функции Connection передается COM-соединение с базой данных 1С.

Полезные примеры для работы с 1С

Получение текущей даты-времени для 1С, например для установки документу перед его записью:

 /!

 function (Connection) {

   var GetCurrentDate = function () {

                           var Date = new Date;
                           var TwoChar = function (Num) {return Num < 10 ? '0' + Num : Num;}

                           return '' + Date.GetFullYear () +
                                       GetCurrectNum (Date.getMonth   () + 1) +
                                       GetCurrectNum (Date.getDate    ()) +
                                       GetCurrectNum (Date.getHours   ()) +
                                       GetCurrectNum (Date.getMinutes ()) +
                                       GetCurrectNum (Date.getSeconds ());
                        };

    var Doc = Connection.Документы.ИмяВашегоДокумента.СоздатьДокумент ();
    Doc.Дата = GetCurrentDate ();
    Doc.Ответственный = Connection.ПараметрыСеанса.ТекущийПользователь;      // Пользователь, через которого осуществляется подключение к 1С
    Doc.Записать ();

    return null;
 }
 !/
 

Выполнение произвольного запроса в 1С:

Примечание: для создания многострочного запроса, необходимо в конце каждой строки добавлять "\"

 /!

 function (Connection) {

    var Query = Connection.NewObject ('Запрос');
                                      // Запрос выбирает настройку "Основная организация" у пользователя, через которого осуществляется подключение к 1С 
    Query.Текст = "ВЫБРАТЬ \
                       НастройкиПользователей.Значение \
                   ИЗ \
                       РегистрСведений.НастройкиПользователей КАК НастройкиПользователей \
                   ГДЕ \
                       НастройкиПользователей.Пользователь = &Пользователь \
                       И НастройкиПользователей.Настройка = ЗНАЧЕНИЕ (ПланВидовХарактеристик.НастройкиПользователей.ОсновнаяОрганизация)";
    Query.УстановитьПараметр ("Пользователь",Connection.ПараметрыСеанса.ТекущийПользователь);
    var Select = Query.Выполнить ().Выбрать ();
    var Org;
    while (Select.Следующий () === true){
         Org = Select.Значение;
    }
    var Doc = Connection.Документы.ИмяВашегоДокумента.СоздатьДокумент ();
    Doc.Организация = Org;
    Doc.Записать ();
    return null;
 }
 !/
 

Назад к SQL-запросам