ТолькоПросмотр

Установка режима редактирования формы,

Синтаксис:

ТолькоПросмотр(<Режим>)

Англоязычный синоним:

Readonly

Параметры:

<Режим>

Необязательный параметр. Числовое выражение:

0 — разрешено редактирование элементов формы;

1 — запрещено редактирование.

Возвращаемое значение:

Текущее числовое значение режима редактирования формы (на момент до исполнения метода).

Описание:

Метод ТолькоПросмотр позволяет установить режим редактирования текущей формы.

Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

Форма.ТолькоПросмотр(0);

ТолькоПросмотр

Установить режим редактирования таблицы.

Синтаксис:

ТолькоПросмотр(<Режим>)

Англоязычный синоним:

Readonly

Параметры:

<Режим>

Необязательный параметр. Числовое выражение — режим редактирования: 1 — только просмотр, 0 — допускается редактирование.

Возвращаемое значение:

Текущее числовое значение режима редактирования таблицы (на момент до исполнения метода).

Описание:

Метод ТолькоПросмотр устанавливает флаг возможности редактирования таблицы в окне. Данный метод должен вызываться до вызова метода Показать. По умолчанию, для табличных документов устанавливается режим с возможностью редактирования.

Замечание: Режим «только просмотр» позволяет воспринимать сгруппированные ячейки таблицы как единое целое и использовать фиксацию шапки и боковика таблицы при просмотре. Таким образом данный режим рекомендуется для отчетов, которые предназначены в основном для просмотра и печати.

Пример:

Таб = СоздатьОбъект("Таблица");

Таб.Открыть("catalog.txt");

Таб.ТолькоПросмотр(0);

Таб.Показать("Редактирование Прайс-листа", "price.txt");

ТолькоПросмотр

Установить режима редактирования текста.

Синтаксис:

ТолькоПросмотр(<Режим>)

Англоязычный синоним:

Readonly

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — запрещено редактирование текста, 0 — разрешено редактирование текста.

Возвращаемое значение:

Текущее числовое значение режима редактирования текста (на момент до исполнения метода).

Описание:

Метод ТолькоПросмотр позволяет установить режим редактирования текста в окне редактирования.

Пример:

ТекстДок = СоздатьОбъект("Текст");

ТекстДок.Открыть("catalog.txt");

ТекстДок.ТолькоПросмотр(1);

ТекстДок.Показать("Редактирование Прайс-листа", "catalog.txt");

УчетПоКоличеству

Устанавливает/возвращает значение флага «Учет по количеству» субконто счета.

Синтаксис:

УчетПоКоличеству(<НомерСубконто>, <УчетПоКоличеству>)

Англоязычный синоним:

AccountingByAmount

Параметры:

<НомерСубконто>

Числовое выражение — порядковый номер субконто счета.

<УчетПоКоличеству>

Необязательный параметр. Числовое значение: 1 или 0. Данный параметр снимает или устанавливает флаг «Учет по количеству» для данного субконто счета. Если параметр не используется, то флаг «Учет по количеству» не меняется.

Возвращаемое значение:

Значение флага «Учет по количеству» на момент до использования метода: 1 — флаг установлен; 0 — флаг не установлен.

Описание:

Все виды субконто, прикрепленные к счету в плане счетов, имеют порядковые номера. Для субконто может быть установлен флаг «Учет по количеству», который устанавливает для данного субконто счета режим использования учета по количеству.

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

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Для Инд = 1 По Сч.КоличествоСубконто() Цикл

Сообщить("Субконто " + Сч.ВидСубконто(Инд) +

?(Сч.УчетПоКоличеству(Инд) = 1, "(об.)", ""));

КонецЕсли;

УчетПоСумме

Устанавливает/возвращает значение флага «Учет по сумме» субконто счета.

Синтаксис:

УчетПоСумме(<НомерСубконто>, <УчетПоСумме>)

Англоязычный синоним:

AccountingBySum

Параметры:

<НомерСубконто>

Числовое выражение — порядковый номер субконто счета.

<УчетПоСумме>

Необязательный параметр. Числовое значение: 1 или 0. Данный параметр снимает или устанавливает флаг «Учет по сумме» для данного субконто счета. Если параметр не используется, то флаг «Учет по сумме» не меняется.

Возвращаемое значение:

Значение флага «Учет по сумме» на момент до использования метода: 1 — флаг установлен; 0 — флаг не установлен.

Описание:

Все виды субконто, прикрепленные к счету в плане счетов, имеют порядковые номера. Для субконто может быть установлен флаг «Учет по сумме», который устанавливает для данного субконто счета режим использования учета по сумме.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Для Инд = 1 По Сч.КоличествоСубконто() Цикл

Сообщить("Субконто " + Сч.ВидСубконто(Инд) +

? (Сч.УчетПоСумме(Инд) = 1, "(об.)", ""));

КонецЕсли;

УчетПоВалютнойСумме

Устанавливает/возвращает значение флага «Учет по валютной сумме» субконто счета.

Синтаксис:

УчетПоВалютнойСумме(<НомерСубконто>, <УчетПоСумме>)

Англоязычный синоним:

AccountingByCurrencySum

Параметры:

<НомерСубконто>

Числовое выражение — порядковый номер субконто счета.

<УчетПоСумме>

Необязательный параметр. Числовое значение: 1 или 0. Данный параметр снимает или устанавливает флаг «Учет по валютной сумме» для данного субконто счета. Если параметр не используется, то флаг «Учет по валютной сумме» не меняется.

Возвращаемое значение:

Значение флага «Учет по валютной сумме» на момент до использования метода: 1 — флаг установлен; 0 — флаг не установлен.

Описание:

Все виды субконто, прикрепленные к счету в плане счетов, имеют порядковые номера. Для субконто может быть установлен флаг «Учет по валютной сумме», который устанавливает для данного субконто счета режим использования учета по валютной сумме.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Для Инд = 1 По Сч.КоличествоСубконто() Цикл

Сообщить("Субконто " + Сч.ВидСубконто(Инд) +

?(Сч.УчетПоВалютнойСумме(Инд) = 1, "(об.)", ""));

КонецЕсли;

УчитыватьПраздники

Установка флага учета праздников при автозаполнении.

Синтаксис:

УчитыватьПраздники(<Флаг>)

Англоязычный синоним:

UseHolidays

Параметры:

<Флаг>

Необязательный параметр. Число: 1 — учитываются праздники при автозаполнении; 0 — не учитываются праздники при автозаполнении.

Возвращаемое значение:

Возвращает текущую установку. Число: 1 — учитываются праздники при автозаполнении; 0 — не учитываются праздники при автозаполнении.

Описание:

Метод УчитыватьПраздники выполняет установку флага учета праздников при автозаполнении.

Пример:

// Календарь служащих

Календ = СоздатьОбъект("Календарь.Служащие");

Календ.УчитыватьПраздники(1);

Результат = Календ.Автозаполнение(ДатаНачала, ДатаОкончания);

См. также: Автозаполнение

Удаление записей

Удаление записи из базы данных не приводит к физическому уничтожению ее на диске. В этом случае в специальном служебном поле записи, не доступном обычными средствами, ставится пометка об удалении. На записи, помеченные удаленными, позиционирования не происходит, если не включен специальный режим просмотра удаленннх записей. Имеется набор методов для включения/выключения специального режима просмотра, а также определения, является ли спозиционированная запись удаленной, и восстановления удаленной записи.

Метод сжатия базы вызывает физическое уничтожение записей, помеченных как удаленные. Метод очистки базы вызывает физическое уничтожение всех записей. После применения этих методов восстановление удаленных записей становится невозможным.

Удалить

Удалить элемент справочника.

Синтаксис:

Удалить(<Режим>)

Англоязычный синоним:

Delete

Параметры:

<Режим>

Числовое выражение: 1 — непосредственное удаление; 0 — пометка на удаление. Необязательный параметр. Значение по умолчанию — 1.

Описание:

Метод Удалить удаляет (или делает пометку на удаление) текущий элемент или группу справочника.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

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

Пример:

Процедура УдалениеСотрудника(Сотр)

Спр = СоздатьОбъект("Справочник.Сотрудники");

Если Сотр.Выбран() > 0 Тогда

// позиционируем справочник на заданном элементе

Спр.НайтиЭлемент(Сотр);

Если Спр.Выбран() > 0 Тогда

Если Вопрос("Удалять??? ", 1) = 1 Тогда

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

Спр.Удалить(1);

КонецЕсли;

Иначе

Предупреждение("Некого удалять!");

КонецЕсли;

КонецПроцедуры

См. также: ПометкаУдаления, СнятьПометкуУдаления

Удалить

Удалить документ.

Синтаксис:

удалить(<Режим>)

Англоязычный синоним:

Delete

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — непосредственное удаление; 0 — пометка на удаление. Значение по умолчанию — 1.

Описание:

Метод Удалить удаляет (или делает пометку на удаление) текущий документ. Данный метод разрешено применять только для тех документов, которые либо не проведены, либо они лежат за точкой ТА, т. е. предполагается, что предварительно интерактивно сдвинули ТА назад.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

Док = СоздатьОбъект("Документ.Приказы");

Если Док.Выбрать("Найди документ") > 0 Тогда

Док.Удалить(1);

КонецЕсли;

См. также: ПометкаУдаления, СнятьПометкуУдаления

Удалить

Удаляет счет из плана счетов.

Синтаксис:

Удалить(<Режим>)

Англоязычный синоним:

Delete

Параметры:

<Режим>

Числовое выражение: 1 — непосредственное удаление; 0 — пометка на удаление. По умолчанию 1;

Описание:

Метод Удалить удаляет (или помечает на удаление) текущий счет. Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Замечание. Непосредственное удаление объекта следует применять только в особых случаях, так как счет может участвовать в проводках и непосредственное удаление может повлечет нарушение в бухгалтерском учете.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Сч.Удалить(0);

Удалить

Удаление операции.

Синтаксис:

Удалить(<Режим>)

Англоязычный синоним:

Delete

Параметры:

<Режим>

Необязательный параметр. Числовое выражение:

1 — непосредственное удаление; 0 — пометка на удаление. Значение по умолчанию — 1.

Описание:

Метод Удалить удаляет (или помечает на удаление) текущую операцию.

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

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Если метод Удалить применен к операции принадлежащей документу не специального вида «Операция», то происходит удаление (или пометка) всего документа.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДок);

Опер.Удалить(0);

Удалить

Удалить корректную проводку.

Синтаксис:

Удалить()

Англоязычный синоним:

Delete

Возвращаемое значение:

Число: 1 — корректная проводка успешно удалена; 0 — не удалена.

Описание:

Метод Удалить удаляет корректную проводку.

Пример:

КП = СоздатьОбъект("КорректныеПроводки");

КП.ВыбратьКорректныеПроводки();

Пока КП.ПояучитьКорректнуюПроводку() = 1 Цикл

Если КП.Комментарий = "НДС с комисс. вознаграждения" Тогда

КП.Удалить();

Прервать;

КонецЕсли;

КонецЦикла;

Удалить

Удаляет «праздничный» день.

Синтаксис:

Удалить(<Дата>)

Англоязычный синоним:

Delete

Параметры:

<Дaтa>

Дата удаляемой строки (праздника).

Описание:

Метод Удалить позволяет удалить существующую запись («праздничный» день). Если строка с такой датой не найдена, то метод ничего не делает. Возвращаемого значения нет.

Пример:

// Праздничные дни

Празд = СоздатьОбъект("Праздники");

Празд.Удалить('01.05.99');

Удалить

Удалить периодическое значение.

Синтаксис:

Удалить()

Англоязычный синоним:

Delete

Возвращаемое значение:

Число: 1 — если вызов метода закончился успешно, 0 — если нет.

Описание:

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

Пример:

Процедура ЧисткаКурсов()

Вал = СоздатьОбъект("Справочник.Валюты");

// Позиционируем созданный объект Вал по известному коду

Вал.НайтиПоКоду(1);

Если Вал.Выбран() = 1 Тогда

Доллар = Вал.ТекущийЭлемент();

Иначе

Предупреждение("Не найдена валюта!");

Возврат;

КонецЕсли;

ПерВал = СоздатьОбъект("Периодический");

ПерВал.ИспользоватьОбъект("Текущ_курс".Доллар);

ПерВал.ВыбратьЗначения();

Пока ПерВал.ПолучитьЗначение() = 1 Цикл

Курс = ПерВал.Значение;

ДатаКурса = ПерВал.ДатаЗнач;

Если Курс < 1000 Тогда

ПерВал.Удалить();

КонецЕсли;

КонецЦикла;

КонецПроцедуры

Удалить

Удалить текущую запись.

Синтаксис:

Удалить()

Англоязычный синоним:

Del

Описание:

Метод Удалить ставит пометку «удалена» на текущую запись. Физически запись из базы данных не удаляется и может быть впоследствии восстановлена. Полное удаление записей из БД с освобождением дискового пространства, занятого ими, производится вызовом методов Сжать и ОчиститьФайл.

Пример:

Процедура УдалЗап()

ДБФ.Первая();

Пока 1 = 1 Цикл

ДБФ.Удалить();

ДБФ.Записать();

Если ДБФ.Следующая() = 0 Тогда

Возврат;

КонецЕсли;

КонецЦикла;

КонецПроцедуры

УдалитьФайл

Удалить файл.

Синтаксис:

УдалитьФайл(<ИмяФайла>)

Англоязычный синоним:

DeleteFile

Параметры:

<ИмяФайла>

Строковое выражение с именем удаляемого файла.

Описание:

Метод УдалитьФайл удаляет указанный файл.

Пример:

* В данном примере приведена процедура удаления файла.

Процедура УдалФ()

ФС.УдалитьФайл(ИмяФайла);

КонецПроцедуры

УдалитьКаталог

Удаляет каталог файлов.

Синтаксис:

УдалитьКаталог(<ИмяКат>)

Англоязычный синоним:

RemoveDirectory

Параметры:

<ИмяКат> Строковое выражение с именем удаляемого каталога файлов.

Описание:

Метод УдалитьКаталог удаляет каталог файлов.

Пример:

* В данном примере приведена процедура удаления каталога файлов.

Процедура УдалДир()

ФС.УдалитьКаталог(ИмяВыбрДир);

КонецПроцедуры

УдалитьКолонку

Удаляет колонку из таблицы значений.

Синтаксис:

УдалитьКолонку(<Колонка>)

Англоязычный синоним:

DeleteColumn

Параметры:

<Колонка>

Номер или идентификатор колонки.

Описание:

Метод УдалитьКолонку удаляет колонку <Колонка> из таблицы значений.

Пример:

ТаблДокументов.УдалитьКолонку(2);

УдалитьОбъекты

Удалить объекты, переданные в списке значений.

Синтаксис:

УдалитьОбъекты(<Объекты>, <Проверять>, <Ссылки>)

Англоязычный синоним:

DeleteObjects

Параметры:

<Объекты>

Конкретное значение объекта или объект типа «СписокЗначений», в котором данной процедуре передаются объекты, которые надо удалить.

<Проверять>

Необязательный параметр. Число: 1 — перед удалением проверяется — нет ли ссылок на удаляемый объект. Если есть, то объект не удаляется, а ссылки помещаются в таблицу значений <Ссылки>. Любое другое число — проверку не выполнять. Значение по умолчанию: 1.

<Ссылки>

Необязательный параметр. Идентификатор объекта типа «ТаблицаЗначений», в который данная процедура помещает найденные ссылки на объекты. Таблица значений состоит из 3 колонок:

1. Объект — объект, на который ссылаются;

2. Ссылка — объект, который содержит ссылку;

3. Комментарий — комментарий к ссылке.

Описание:

Процедура УдалитьОбъекты удаляет объекты, переданные в списке значений.

Пример:

Список = СоздатьОбъект("СписокЗначений");

ТаблицаСсылок = СоздатьОбъект("ТаблицаЗначений");

НайтиПомеченныеНаУдаление(Список);

УдалитьОбъекты(Список, 1, ТаблицаСсылок);

УдалитьПроводку

Удалить проводку.

Синтаксис:

УдалитьПроводку()

Англоязычный синоним:

DeleteEntry

Описание:

Метод удаляет текущую проводку или корреспонденцию операции. Метод может быть вызван объектом «Операция», созданным функцией СоздатьОбъект, при создании или изменении операции принадлежащей документу специального вида «Операция».

Собственно изменение в составе проводок будут записаны и повлекут из-менния в бухгалтерских итогах после вызова метода операции Записать.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДок);

Пока Опер.КоличествоПроводок() > 0 Цикл

Опер.ПолучитьПроводкуПоНомеру(1);

Опер.УдалитьПроводку();

КонецЦикла;

Опер.Записать();

УдалитьСтроки

Удалить все строки документа.

Синтаксис:

УдалитьСтроки()

Англоязычный синоним:

DeleteLines

Описание:

Метод УдалитьСтроки удаляет сразу все строки из многострочной части документа.

Пример:

УдалитьСтроки();

УдалитьСтроки

Удаляет все строки из таблицы значений.

Синтаксис:

УдалитьСтроки()

Англоязычный синоним:

DeleteLines

Описание:

Метод УдалитьСтроки удаляет все строки из таблицы значений.

Пример:

ТаблДокументов.УдалитьСтроки();

УдалитьСтроку

Удалить строку документа.

Синтаксис:

УдалитьСтроку()

Англоязычный синоним:

DeleteLine

Описание:

Метод УдалитьСтроку удаляет текущую строку из многострочной части Документа.

Пример:

Процедура УдалЗаданнойСтроки(Док, Стр)

Если Док.Выбран() = 1 Тогда

// если переданный параметр содержит значение документа, то

// найдем в нем строку

Док.ПолучитьСтрокуПоНомеру(Стр);

// удалим найденную строку спецификации документа

Док.УдалитьСтроку();

Предупреждение("Документ не выбран!");

КонецЕсли;

УдалитьСтроку

Удаляет строку из таблицы значений.

Синтаксис:

УдалитьСтроку(<НомерСтроки>)

Англоязычный синоним:

DeleteLine

Параметры:

<НомерСтроки>

Необязательный параметр. Номер строки. Если не указан, то удаляется текущая строка

Описание:

Метод УдалитьСтроку удаляет строку из таблицы значений.

Пример:

ТаблДокументов.УдалитьСтроку(2);

УдалитьСтроку

Удалить строку с указанным номером.

Синтаксис:

УдалитьСтроку(<НомерСтроки>)

Англоязычный синоним:

DeleteLine

Параметры:

<НомерСтроки>

Числовое выражение — номер удаляемой строки.

Описание:

Метод УдалитьСтроку удаляет из текста строку с номером <НомерСтроки>.

Пример:

ТекстДок = СоздатьОбъект("Текст");

ТекстДок.Открыть("catalog.txt");

ТекстДок.УдалитьСтроку(5 3);

УдалитьВсе

Удалить все элементы списка.

Синтаксис:

УдалитьВсе()

Англоязычный синоним:

RemoveAll

Описание:

Метод УдалитьВсе удаляет все элементы списка.

Пример:

Список.УдалитьВсе();

УдалитьВсеПодчиненные

Удаляет все виды расчета из списка «подчиненных».

Синтаксис:

УдалитьВсеПодчиненные()

Англоязычный синоним:

DeleteAllDependents

Описание:

Метод УдалитьВсеПодчиненные удаляет все виды расчета из списка «подчиненных».

Пример:

ПравилоПерерасчета.Доплаты.УдалитьВсеПодчиненные();

УдалитьВсеВедущие

Удаляет все виды расчета из списка «ведущих».

Синтаксис:

УдалитьВсеВедущие()

Англоязычный синоним:

DeleteAlILeadings

Описание:

Метод УдалитьВсеВедущие удаляет все виды расчета из списка «ведущих».

Пример:

ПравилоПерерасчета.Доплаты.УдалитьВсеВедущие();

УдалитьЗапись

Удалить запись журнала расчетов.

Синтаксис:

УдалитьЗапись()

Англоязычный синоним:

DeleteRecord

Возвращаемое значение:

Число: 1 — если операция успешно выполнена; 0 — в противном случае.

Описание:

Метод предназначен для удаления записей журнала расчетов. Данный метод работает только для переменных, созданных функцией СоздатьОбъект.

Пример:

// Процедура выполняется в контексте журнала расчетов

// Удалим записи, по которым нет рабочих дней!

ЖР = СоздатьОбъект("ЖурналРасчетов.Зарплата");

Календ = СоздатьОбъект("Календарь.Служащие");

ЖР.ВыбратьПериод(ЖР.НачалоТекущегоПериода());

Пока ЖР.ПолучитьЗапись() > 0 Цикл

Если Календ.Дней(ЖР.ДатаНачала, ЖР.ДатаОкончания) = 0 Тогда

ЖР.УдалитьЗапись();

КонецЕсли;

КонецЦикла;

УдалитьЗначение

Удалить значение в указанной позиции списка.

Синтаксис:

УдалитьЗначение(<Позиция>, <Колич>)

Англоязычный синоним:

RemoveValue

Параметры:

<Позиция>

Числовое выражение — номер позиции в списке, начиная с которой будут удалены значения. Номер позиции может быть от 1 до количества элементов в списке.

<Колич>

Необязательный параметр. Числовое выражение — количество повторов. По умолчанию — 1.

Описание:

Метод УдалитьЗначение удаляет <Колич> значений, начиная с указаний позиции <Позиция>.

Пример:

Список.УдалитьЗначение(1, 2);

Уровень

Определить номер уровня элемента справочника.

Синтаксис:

Уровень()

Англоязычный синоним:

Level

Возвращаемое значение:

Числовое значение номера уровня текущего элемента справочника.

Описание:

Метод Уровень возвращает номер уровня текущего элемента справочника в структуре дерева многоуровневого справочника.

Пример:

Спр = СоздатьОбъект("Справочник.Подразделения");

Спр.ИспользоватьДату(РабочаяДата());

Спр.ВыбратьЭлементы();

Пока Спр.ПолучитьЭлемент() > 0 Цикл

Сообщить(Строка(Спр.Наименование + Спр.Код + Спр.Уровень());

КонецЦикла;

Уровень

Возвращает уровень вложенности текущего счета.

Синтаксис:

Уровень()

Англоязычный синоним:

Level

Возвращаемое значение:

Число — уровень вложенности счета: 1 — счета верхнего уровня.

Описание:

В системе 1С:Предприятие количество уровней вложенности субсчетов в плане счетов не ограничивается. В качестве «ограничителя» выступает величина реквизита «Максимальная длина кода счета» в окне редактирования «Планы счетов». В пределах указанной длины можно задавать произвольное количество уровней вложенности, комбинируя символы «#» и «.» в шаблоне счета.

Шаблон кода представляет собой символьную строку состоящую из символов «#» и «.». Шаблон кода схематически иллюстрирует структуру полного кода счета. Фактически, шаблон кода задает количество уровней субсчетов, которое может быть открыто к счету. Например, символьная строка вида

##.#.###

означает, что к счету могут быть открыты 2 уровня субсчетов. Метод Уровень() возвращает уровень вложенности текущего счета. Для счета верхнего уровня метод возвратит 1, для счета второго уровня — 2, и так далее.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Сообщить("Уровень счета - " + Сч.Уровень());

//Возвращает — 2

Условие

Назначить условие включения информации в запрос.

Синтаксис:

Условие(<ЛогическоеВыражение>);

Англоязычный синоним:

Condition

Параметры:

<ЛогическоеВыражение>

Логическое выражение встроенного языка 1С:Предприятие.

Описание:

Оператор Условие назначает условие включения информации в запрос. Если значение <ЛогическоеВыражение> верно, то информация включается в запрос, иначе нет.

Пример:

ТекстЗапроса =

"//{{ЗАПРОС(Одинарный)

|Период с ДатаНачала по ДатаКонец;

|Оклад = Справочник.Сотрудники.Оклад;

|Ктг = Справочник.Сотрудники.Категория;

|Группировка Ктг без групп;

|Функция Всего = Сумма(Оклад);

|Условие(Ктг.Выбран() = 1); // только для тех сотрудников

| //у кого заполнен реквизит Категория

|"//}}ЗАПРОС

;

В логическом выражении могут участвовать как внутренние, так и внешние переменные запроса, т. е. переменные программного модуля, доступные в процедуре, использующей запрос.

Пример:

* Здесь показан отрывок текста процедуры, в которой формируется некоторый отчет, причем переменные:

ВыбТовар, ВыбОтдел, ВыбСотрудник

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

Запрос = СоздатьОбъект("Запрос");

ТекстЗапроса =

"//{{ЗАПРОС(Квоты)

|Товар = Регистр.КвотыТоваров.Товар;

|Отдел = Регистр.КвотыТоваров.Отдел;

|Сотрудник = Регистр.КвотыТоваров.Сотрудник;

|Партнер = Регистр.КвотыТоваров.Партнер;

|Количество = Регистр.КвотыТоваров.КвотаТовара;

|Группировка Товар;

|Группировка Отдел;

|Группировка Сотрудник;

|Группировка Партнер;

|Функция Кол_во = КонОст(Количество);

|Условие(Товар.ПринадлежитГруппе(ВыбТовар) = 1);

|Условие(Отдел = ВыбОтдел);

|Условие(Сотрудник = ВыбСотрудник.Сотрудник);

|"//}}ЗАПРОС

;

// Если ошибка в запросе, то выход из процедуры

Если Запрос.Выполнить(ТекстЗапроса)= 0 Тогда

   Возврат;

КонецЕсли;

В параметре оператора Условие, в принципе, можно записывать логические выражения любой сложности (по правилам встроенного языка 1С:Предприятие), используя любые логические операторы (>, <, =, >=, <>, И, ИЛИ, НЕ и другие), при этом в качестве операндов могут участвовать как внутренние, так и внешние переменные запроса (если существуют внутренняя и внешняя переменные с одинаковым именем, то использоваться по данному имени будет внутренняя переменная).

Пример:

Условие(Цена > 23.5);

Условие((Товар.ПринадлежитГруппе(ВыбТовар) = 1) И (Товар.Розн_Цена = 100));

Если в описании запроса использовано несколько операторов Условие, то они объединяются по логическому "И".

Пример:

* Использование двух операторов:

Условие(Товар.Наименование <> "Стол");

Условие(Товар.Наименование <> "Шкаф");

* аналогично записи одного оператора:

Условие((Товар.Наименование <> "Стол") И (Товар.Наименование<> "Шкаф"));

Логический оператор принадлежности

Кроме обычных логических операторов (>, <, =, >=, <=, <>, И, ИЛИ, НЕ) в операторе "Условие ..." языка запросов можно использовать дополнительный оператор — логический оператор принадлежности.

Синтаксис:

В

Англоязычный синоним:

In

Описание:

Оператор языка запросов "Условие (А в Б);" говорит о том, что условие истинно, когда значение А является подмножеством значения Б.

Следует особо отметить, что если значение Б пустое (объект не выбран), то условие является истинным, в отличии от оператора «=» (равно).

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

В качестве включающего подмножества логического оператора принадлежности (второй параметр после слова «в») может выступать как простое значение, так и список значений. В этом случае проверка выполняется с учетом вы-шеотмеченных особенностей для каждой строки списка значений.

Скорость выполнения запросов оптимизирована под использование оператора принадлежности, как в клиент-серверной, так и в файл-серверной версии системы 1С:Предприятие.

Внимание. Логический оператор принадлежности не поддерживается встроенным языком системы 1С:Предприятие, а применяется только в языке запросов.

Оператор принадлежности существенно облегчает написание текстов запроса, делает их более понятными.

Пример:

* без использования логического оператора принадлежности

Текст3апроса =

...

| Товар = Документ.ВидДокумента.Товар;";

...

Если ВыбТовар.Выбран() = 1 Тогда

   Если ВыбТовар.ЭтоГруппа() = 1 Тогда

      ТекстЗапроса = ТекстЗапроса +

               "Условие(Товар.ПринадлежитГруппе(ВыбТовар) = 1);";

   Иначе

      ТекстЗапроса = ТекстЗапроса + "Условие(Товар = ВыбТовар);";

   КонецЕсли

КонецЕсли;

* с использованием логического оператора принадлежности

Текст3апроса=

...

|Товар = Документ.ВидДокумента.Товар;";

...

|Условие (Товар в ВыбТовар);

...

Установить

Записать новое значение периодического реквизита справочника на заданную дату.

Синтаксис:

Установить(<Дата>, <3начение>)

Англоязычный синоним:

SetValue

Параметры:

<Дата>

Выражение со значением требуемой даты.

<3начение>

Выражение, содержащее устанавливаемое значение периодического реквизита справочника.

Описание:

Метод Установить записывает значение периодического реквизита справочника на определенную дату. Данный метод разрешено использовать только для периодических реквизитов справочников, если для справочника не установлена дата при помощи метода ИспользоватьДату.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Замечание: Если к объекту типа «справочник» однажды применен метод ИспользоватьДату, то в дальнейшем, чтобы записать новые значения периодических реквизитов справочника, нельзя применять к этому же объекту метод Установить, т. е. в такой последовательности эти два метода несовместимы.

Пример:

// при работе в контексте документа, его реквизит "Сотрудник"

// является переменной типа "справочник",

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

// реквизита "Оклад" этого элемента

// справочника, применим функцию Получить

Сотрудники.Оклад.Установить(ДатаДок, МаксОклад);

См. также: ИспользоватьДату, УстановитьРеквизитСправочника, Получить

Установить

Установить ГП на новую дату документ или позицию.

Синтаксис:

Установить(<ПоложениеГП>)

Англоязычный синоним:

Set

Параметры:

<ПоложениеГП>

Выражение типа «дата», «документ» или «позиция документа», на который устанавливается ГП.

Описание:

Метод Установить изменяет положение Границы Последовательности на начало даты или документа.

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

Пример:

Последовательность.УправленческийУчет.Установить(ТекущийДокумент());

Установить

Установить значение с указанным представлением.

Синтаксис:

Установить(<Строка>, <Знач>)

Англоязычный синоним:

Set

Параметры:

<Строка>

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

<Знач>

Выражение со значением, которое добавляется в список.

Описание:

Метод Установить устанавливает в списке значение с указанным представлением, если значение с таким представлением уже есть — изменятеся значение, если нет — добавляется в конец списка значение с указанным представлением.

Пример:

Спис.Установить("Процентом", ВидРасчета.ДоплатаПроцентом);

Установить

Установить значение периодической константы на дату.

Синтаксис:

Установить(<Дата>, <3начение>)

Англоязычный синоним:

SetValue

Параметры:

<Дата>

Выражение со значением требуемой даты.

<3начение>

Новое значение константы.

Описание:

Метод Установить устанавливает значение константы на определенную дату. Данный метод можно использовать только для периодических констант.

Пример:

Константа.РасчетныйСчет.Установить('01.07.96', "77889001");

Константа.Директор.Установить('01.01.85', "Иванов П.С.")

УстановитьАтрибут

Установить значение реквизита по имени идентификатора.

Синтаксис:

УстановитьАтрибут(<ИмяРеквизита>, <3начение>)

Англоязычный синоним:

SetAttrib

Параметры:

<ИмяРеквизита>

Строковое выражение, содержащее имя реквизита, как оно задано в конфигураторе.

<3начение>

Выражение, содержащее устанавливаемое значение реквизита.

Описание:

Метод УстановитьАтрибут позволяет установить значение реквизита по имени идентификатора, как оно задано в конфигураторе.

Пример:

Тов.УстановитьАтрибут("ЦенаРозн", ЦенаТов);

УстановитьАтрибут

Установить значение реквизита по имени идентификатора.

Синтаксис:

УстановитьАтрибут(<ИмяРеквизита>, <3начение>)

Англоязычный синоним:

SetAttrib

Параметры:

<ИмяРеквизита>

Строковое выражение, содержащее имя реквизита, как оно задано в конфигураторе.

<3начение>

Выражение, содержащее устанавливаемое значение реквизита.

Описание:

Пример:

Док.УстановитьАтрибут("ЦенаРозн", ЦенаТов);

УстановитьАтрибут

Установить значение атрибута по имени идентификатора.

Синтаксис:

УстановитьАтрибут(<ИмяРеквизита>, <3начение>)

Англоязычный синоним:

SetAttrib

Параметры:

<ИмяРеквизита>

Строковое выражение, содержащее имя атрибута, как оно задано в конфигураторе.

<3начение>

Выражение, содержащее устанавливаемое значение атрибута.

Описание:

Метод УстановитьАтрибут позволяет установить значение атрибута по имени идентификатора, как оно задано в конфигураторе.

Пример;

Рег.УстановитьАтрибут("Сумма", СуммаТов);

УстановитьАтрибут

Установить значение реквизита по имени идентификатора.

Синтаксис:

УстановитьАтрибут(<ИмяРеквизита>, <3начение>)

Англоязычный синоним:

SetAttrib

Параметры:

<ИмяРеквизита>

Строковое выражение, содержащее имя реквизита, как оно задано в конфигураторе.

<3начение>

Выражение, содержащее устанавливаемое значение реквизита.

Описание:

Пример:

Счт.УстановитьАтрибут("ЦенаРозн", ЦенаТов);

УстановитьАтрибут

Установить значение реквизита по имени идентификатора.

Синтаксис:

УстановитьАтрибут(<ИмяРеквизита>, <3начение>)

Англоязычный синоним:

SebAttrib

Параметры:

<ИмяРеквизита>

Строковое выражение, содержащее имя реквизита, как оно задано в конфигураторе.

<3начение>

Выражение, содержащее устанавливаемое значение реквизита.

Описание:

Пример:

Опер.УстановитьАтрибут("ЦенаРозн", ЦенаТов);

УстановитьАтрибут

Установить значение атрибута по имени идентификатора.

Синтаксис:

УстановитьАтрибут(<ИмяРеквизита>, <Значение>)

Англоязычный синоним:

SetAttrib

Параметры:

<ИмяРеквизита>

Строковое выражение, содержащее имя атрибута, как оно задано в конфигураторе.

<Значение>

Выражение, содержащее устанавливаемое значение атрибута.

Описание:

Метод УстановитьАтрибут позволяет установить значение атрибута по имени идентификатора, как оно задано в конфигураторе. Доступные имена атрибутов — "Дата" и "Значение".

Пример:

// Календарь служащих

Календ = СоздатьОбъект("Календарь.Служащие");

Календ.ВыбратьДаты(ДатаНачала, ДатаОкончания);

Пока Календ.СледующаяДата() = 1 Цикл

Календ.УстановитьАтрибут("Значение", 1);

// ...

КонецЦикла;

УстановитьАтрибут

Установить значение константы по имени идентификатора.

Синтаксис:

УстановитьАтрибут(<ИмяРеквизита>, <3начение>)

Англоязычный синоним:

SetAttrib

Параметры:

<ИмяРеквизита>

Строковое выражение, содержащее имя константы, как оно задано в конфигураторе.

<3начение>

Выражение, содержащее устанавливаемое значение константы.

Описание:

Метод УстановитьАтрибут позволяет установить значение константы по имени идентификатора, как оно задано в конфигураторе.

Пример:

Константа.УстановитьАтрибут("ФлагЗапретаРедактирования", 1);

УстановитьФильтр

Назначить фильтр выборки документов.

Синтаксис:

УстановитьФильтр(<Проведенные>, <НеПроведенные>, <НеИмеющиеПризнаковУчета>,

<Оперативные>, <Расчетные>, <Бухг>)

Англоязычный синоним:

SetFilter

Параметры:

<Проведенные>

Числовое выражение: 0 — не включать в выборку проведенные документы; 1 — включать.

<НеПроведенные>

Числовое выражение: 0 — не включать в выборку непроведенные документы; 1 — включать.

<НеИмеющиеПризнаковУчета>

Числовое выражение: 0 — не включать в выборку документы не имеющие признаков учета; 1 — включать.

<0перативные>

Числовое выражение: 0 — не включать в выборку оперативные документы; 1 — данный флаг не влияет на выборку; 2 — если оперативный документ, то включается в выборку.

<Расчетные>

Числовое выражение: 0 — не включать в выборку расчетные документы; 1 — данный флаг не влияет на выборку; 2 — если расчетный документ, то включается в выборку.

<Бухг>

Числовое выражение: 0 — не включать в выборку бухгалтерские документы; 1 — данный флаг не влияет на выборку; 2 — если бухгалтерский документ, то включается в выборку.

Описание:

Метод УстановитьФильтр назначает фильтр выборки документов.

Примеры:

Док.УстановитьФильтр(1, 1, 1, 1, 1, 1) — в выборку включаются все документы;

Док.УстановитьФильтр(1, 0, 1, 1, 1, 1) — в выборку включаются все проведенные документы;

Док.УстановитьФильтр(1, 1, 0, 1, 0, 1) — в выборку включаются все документы, имеющие признак оперативный или бухгалтерский или оба, но не имеют признака расчетный;

Док.УстановитьФильтр(1, 1, 1, 2, 1, 2) — в выборку включаются все документы, имеющие признаки и оперативный и бухгалтерский и те, которые не имеют признаков учета;

Док.УстановитьФильтр(1, 1, 1, 2, 0, 2) — в выборку включаются все документы, имеющие признаки и оперативный и бухгалтерский, но не имеют признака расчета, и те, которые не имеют признаков учета;

Док.УстановитьФильтр(1, 0, 0, 0, 1, 0) — в выборку не включаются проведенные документы, если они неоперативные и небухгалтерские и имеют признаки учета, т. е. фактически только проведенные расчетные. Данный метод может использоваться только для документов, созданных функцией СоздатьОбъект.

Пример:

Док = СоздатьОбъект("Документ");

// устанавливаем фильтр выборки документов

Док.УстановитьФильтр(1, 0, 0, 1, 0, 0);

// открываем выборку документов

Док.ВыбратьДокументы(ДатаНачало, ДатаКонец);

// цикл получения документов

Пока Док.ПолучитьДокумент() > 0 Цикл

ТекДок = Док.ТекущийДокумент();

КонецЦикла;

УстановитьФильтр

Назначить фильтр для оптимизации действий с регистром.

Синтаксис:

УстановитьФильтр(<Измер1>, <Измер2>..., <Рекв1>, <Рекв2>, ...)

Англоязычный синоним:

SetFilter

Параметры:

<Измер1 >, <Измер2>

Выражения со значениями измерений регистра.

<Рекв1>, <рекв2>

Необязательные параметры. Выражения со значениями реквизитов регистра. Заданные значения реквизитов будут влиять только на отбор движений регистра.

Описание:

Метод УстановитьФильтр назначает фильтр для оптимизации действий с регистром (временные расчеты, выбор движений и итогов).

В качестве фильтра задаются конкретные значения измерений и реквизитов регистра. Могут быть заданы не все значения, а только несколько, но обязательно в правильной последовательности, соответствующей структуре выбранного регистра, как она задана в конфигураторе. Измерения и реквизиты могут задаваться с пропусками (неуказанное значение — просто запятая), фиксируются только указанные значения.

Пример:

* Для регистра с измерениями «Товар», «Склад», «МОЛ» запись

Рег.УстановитьФильтр(Тов1, , );

означает, что расчеты будут проводиться только по одному товару (Тов1), но по всем складам и МОЛам.

Рег = СоздатьОбъект("Регистр.Взаиморасчеты");

Рег.ВременныйРасчет();

Рег.УстановитьФильтр(Клиент, );

РассчитатьРегистрыНа(ДатаНачала);

Рег.ВыбратьДвиженияСОстатками(ДатаКонца);

Пока Рег.ПолучитьДвижение() = 1 Цикл

Прих = 0;

Расх = 0;

Если Рег.Приход = 1 Тогда

Прих = Рег.Долг;

Иначе

Расх = Рег.Долг;

КонецЕсли;

ТекущееСальдо = Рег.Остаток(Клиент, "Задолженность");

Док = Рег.ТекущийДокумент();

Таб.ВывестиСекцию("Документ");

КонецЦикла;

См. также: ВременныйРасчет

УстановитьИмяСерии

Устанавливает имя серии.

Синтаксис:

УстановитьИмяСерии(<НомерСерии>, <Имя>)

Англоязычный синоним:

SetSeriesLabel

Параметры:

<НомерСерии>

Числовое выражение, которое задает номер серии, для которой устанавливается имя.

<Имя>

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

Описание:

Метод УстановитьИмяСерии явно устанавливает имя для заданного номера серии.

Пример:

Диаграмма.УстановитьИмяСерии(СчетчикСерий, Запрос.Товар.Наименование);

УстановитьИмяТочки

Устанавливает имя точки.

Синтаксис:

УстановитьИмяТочки(<НомерТочки>, <Имя>)

Англоязычный синоним:

SetPointLabel

Параметры:

<НомерТочки>

Числовое выражение, которое задает номер точки, для которой устанавливается имя.

<Имя>

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

Описание:

Метод УстановитьИмяТочки явно устанавливает имя для заданного номера точки.

Пример:

Диаграмма.УстановитьИмяТочки(1, "Продано на сумму");

УстановитьИнтервал

Установить интервал журнала.

Синтаксис:

УстановитьИнтервал(<ДатаНач>, <ДатаКон>, <ФлагИзменения>)

Англоязычный синоним:

SetRange

Параметры:

<ДатаНач>

Выражение типа «дата» — начало интервала журнала.

<ДатаКон>

Выражение типа «дата» — конец интервала журнала.

<ФлагИзменения>

Необязательный параметр. Этим флагом регулируется возможность интерактивного изменения интервала журнала. 1 — пользователь может изменить интервал журнала интерактивно, 0 — пользователь не может интерактивно изменить интервал журнала.

Описание:

Метод УстановитьМнтервал позволяет установить интервал журнала. Данный метод доступен только в контексте Модуля формы журнала документов (см. «Виды программных модулей»).

Пример:

УстановитьИнтервал(НИ, КИ);