Очистить

Очищает содержимое текстового документа.

Синтаксис:

Очистить()

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

Clear

Описание:

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

Пример:

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

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

ТекстДок.Очистиь();

Очистить

Очищает диаграмму.

Синтаксис:

Очистить()

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

Clear

Описание:

Метод Очистить очищает диаграмму, т. е. удаляет все ранее установленные значения; количество серий и точек устанавливает нулевым; стирает все ранее установленные имена.

Пример:

Диагр.Очистить(); // очистить диаграмму

Очистить

Очистить текущую запись. Обнуляет все атрибуты объекта.

Синтаксис:

Очистить()

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

Clear

Описание:

Метод Очистить обнуляет все атрибуты объекта. Атрибуты, соответствующие полям типа строковый приобретают значение «пустая строка», числовой — 0, логический — 0, дата — «пустая дата».

Пример:

Процедура ОчистЗап()

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

Пока 1=1 Цикл

ДБФ.Очистить();

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

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

Возврат;

КонецЕсли;

КонецЦикла;

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

ОчиститьДвижения

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

Синтаксис:

ОчиститьДвижения(<ВидыДвижений>)

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

ClearActions

Параметры:

<ВидыДвижений>

Необязательный параметр. Строковое выражение, в котором через «;» перечислены виды движений. В качастве видов движений можно задавать следующие строковые значения:

"Регистр.ХХХХХХ" — движение конкретного регистра, где ХХХХХХ — конкретный вид регистра;

"Операция" — бухгалтерская операция;

"Справочник" — все изменения периодических реквизитов справочников;

"ЖурналРасчетов" — все измененияв журналах расчетов. Если данный параметр не задан, то производится полная очистка всех движений.

Описание:

Метод ОчиститьДвижения удаляет существующие движения документа.

Если метод не вызывается при проведении документа, то существующие движения документа не стираются вообще.

Если метод не вызывается при распроведении документа, то существующие движения после распроведения стираются.

Использование данного метода позволяет:

допроводить документ, т. е. доделывать движения в добавок к уже существующим;

делать движения, анализируя ранее сделанные и уже существующие;

выполнять распроведение документа, анализируя существующие движения;

не очищать существующие движения при перепроведении, если это не нужно.

Замечание. Данный метод доступен только при отключенном в конфигурации флаге «Автоматическое удаление движений».

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

Пример:

Процедура ОбработкаПроведения()

ОчиститьДвижения("Операция; Справочник; ЖурналРасчетов");

ДвиженияРегистровНакладных(Контекст);

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

// —————————————————————————————————————

Процедура ОбработкаУдаленияПроведения()

ОчиститьДвижения();

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

ОчиститьФайл

Очистить все записи в базе.

Синтаксис:

ОчиститьФайл()

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

Zap

Описание:

Метод ОчиститьФайл удаляет все записи в базе. При этом все существующие записи удаляются физически и не могут быть впоследствии восстановлены.

Пример:

Процедура ОчистДБ()

Если Вопрос("Вы уверены, что надо очистить базу?", 1, 5) = 1 Тогда

ДБФ.ОчиститьФайл();

КонецЕсли;

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

См. также: Удалить, Восстановить

ОчиститьОкноСообщений

Очистить окно сообщений.

Синтаксис:

ОчиститьОкноСообщений()

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

ClearMessageWindow

Описание:

Процедура ОчиститьОкноСообщений очищает окно сообщений.

Пример:

ОчиститьОкноСообщений();

OemToAnsi

Преобразовать строку в кодировку ANSI.

Синтаксис:

OemToAnsi(<Строка>)

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

OemToAnsi

Параметры:

<Строка>

Строковое выражение.

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

Строковое значение.

Описание:

Функция OemToAnsi используется для перевода строки из DOS-кодировки в Windows-Кодировку. Результирующая строка возвращается в качестве собственного значения. Исходная строка не изменяется.

Пример:

Загл = OemToAnsi(ТекстDOS);

Ограничения

Основное назначение объектов XBase — организация экспорта-импорта информации в/из внешних файлов формата DBF. Использование методов Xbase для доступа непосредственно к данным информационной базы системы 1С:Предприятие не рекомендуется.

Объекты XBase не поддерживают поля типа memo (см. ДобавитьПоле).

Поддерживаемые объектом XBase фукции, которые можно использовать в выражениях и фильтрах индексов перечислены в разделе «Выражение и фильтр индекса».

Объекты XBase поддерживают только монопольный доступ к файлам. XBase-объекты поддерживают индексные файлы в формате CDX. Однако, использование внешними программами (например, FoxBase) индексных файлов, созданных с помощью объектов XBase, так же, как и использование объектами индексных файлов, созданных внешними программами, не рекомендуется из-за возможной несовместимости версий.

Окр

Округлить число.

Синтаксис:

Окр(<Число1>, [<Число2>], [<Спосо6>])

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

Round

Параметры:

<Число1>

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

<Число2>

Необязательный параметр. Числовое выражение, значение которого — формат округления (число знаков дробной части (если <Число2> отрицательно, то округляется до соответствующего количества знаков целой части). Значение этого параметра по умолчанию — 0.

<Способ>

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

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

Числовое значение результата округления.

Описание:

Функция Окр возвращает числовое значение результата округления <Число1> до <Число2> знаков дробной части (если <Число2> отрицательно, то округляется до соответствующего количества знаков целой части). Параметр <Число2> может быть опущен, при этом принимается, что <Число2> = 0.

Пример:

ОкруглЦена = Окр(ЦЕНА, -2);

Опции

Устанавливает режим включения сумм в итоги.

Синтаксис:

Опции(<ВключатьЗабалансовыеСуммы>, <ВключатьОборотныеСубконтоСуммы>)

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

Options

Параметры:

<ВключатьЗабалансовыеСуммы>

Признак включения в итоги сумм по забалансовым счетам. Число:

0 — не включаются суммы по забалансовым счетам;

1 — включаются суммы по забалансовым счетам.

<ВключатьОборотныеСу6контоСуммы>

Признак включения в итоги сумм по оборотным субконто. Число:

0 — не включаются суммы по оборотным субконто;

1 — включаются суммы по оборотным субконто.

Описание:

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

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

Пример:

БухИтоги.Опции(1, 1);

Опции

Установить флаги вывода сетки, заголовков, фиксации строк и столбцов, опции печати

Синтаксис:

Опции(<ВыводСетки>, <ВыводЗаголовков>, <ФиксСтрок>, <ФиксСтолбцов>,

<ИмяОпцийПечати>, <ИмяСохрРазмОкна>, <ФлагЧерноБелогоПросмотра>,

<НаправлениеПерехода>)

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

Options

Параметры:

<ВыводСетки>

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

<ВыводЗаголовков>

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

<ФиксСтрок>

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

<ФиксСтолбцов>

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

<ИмяОпцийПечати>

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

<ИмяСохрРазмОкна>

Необязательный параметр. Строковое выражение — идентификатор сохраняемых параметров размеров окна. Если этот параметр указан, то система будет сохранять размер окна и использовать его при следующем открытии табличного документа. Фактически, указывая этот параметр можно указать системе режим сохранения и восстановления размеров окна для данного табличного документа, который идентифицируется этой строкой. Параметр необязателен. Значение по умолчанию — пустая строка — в этом случае размеры окна не запоминаются.

<ФлагЧерноБелогоПросмотра>

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

<НаправлениеПерехода>

Необязательный параметр. Число: 1 — по строкам, т. е. при вводе данных в ячейки при нажатии клавиши <Enter> будет автоматически выполняться переход к следующей вводимой ячейке в этой строке, а если таковых нет, то в самой левой вводимой ячейке следующей строки; 2 — по столбцам, т. е. при вводе данных в ячейки при нажатии клавиши <Enter> будет автоматически выполняться переход к следующей вводимой ячейке в этом столбце, а если таковых нет, то в самой верхней вводимой ячейке следующего столбца; 3 — при вводе данных в ячейки автоматический переход при нажатии клавиши <Enter> выполняться не будет. Значение по умолчанию 1.

Метод Опции позволяет перед показом

Описание:

Метод Опции позволяет перед показом таблицы установить флаги вывода сетки и вывода заголовков строк и столбцов, а также фиксацию строк и столбцов. Если перед отображением таблицы не использовать метод Опции, то для табличных документов устанавливается режим «только для чтения», а все флаги имеют значение 0.

Даный метод позволяет назначить для каждой таблицы свой собственный набор опций печати, который сохраняется в системе под именем <ИмяОпцийПечати>. Набор опций печати привязан к конкретному рабочему месту (компьютеру) и запоминается всякий раз, когда в режиме исполнения при открытом окне редактирования таблицы пользователь перенастраивает параметры настройки печати (главное меню — «Файл» — «Печать»).

Пример: Если при формировании отчетов в методе Опции используются уникальные имена для хранения настройки печати, то, например, для отчета «Прайс-лист» можно установить в параметрах печати ориентацию бумаги — «портрет», а для отчета «Оборотно-сальдовая ведомость» — «ландшафт». В дальнейшем, при формировании этих отчетов параметры печати будут настраиваться автоматически.

Пример:

//Вызов выходного отчета в окно просмотра и редактирования.

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

Таб.Опции(0, 0, 5, 0, "ОстаткиТоваров");

Таб.Показать("Остатки товаров на складах", "");

Операция

Атрибут «Операция» предназначен для обращения к бухгалтерской операции документа.

Синтаксис:

Операция

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

Operation

Описание:

Атрибут «Операция» документа используется только в случае, если установлена компонента «Бухгалтерский учет» и только для тех видов документов, для которых в конфигурации установлен признак «Бухгалтерский учет». Он предназначен для обращения к операции документа. Данный атрибут не используется как самостоятельное значение, а позволяет обращаться к атрибутам и методам операции. Описание атрибутов и методов операции см. в разделе «Работа с операциями и проводками».

Пример:

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

Процедура ПриЗаписи()

Операция.Содержание = "Износ за " + Формат(ДатаДок, "Д ММММГГТГ");

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

Операция

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

Синтаксис:

Операция

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

Operation

Описание:

Атрибут позволяет обращаться к текущей операции, если запрос получен с детализацией итогов по периоду «Операция» и «Проводка».

Пример:

БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, , , , , "Проводки");

БухИтоги.ВыбратьСчета();

Пока БухИтоги.ПолучитьСчет() = 1 цикл

БухИтоги.ВыбратьПериоды();

Пока БухИтоги.ПолучитьПериод() = 1 цикл

Сообщить("Операция " + БухИтоги.Операция.ПредставлениеПроводки());

КонецЦикла;

Операция конкатенации

Операция конкатенации ("+") используется для того, чтобы присоединить одну строку к другой. Длина результирующей строки равна сумме длин соединяемых строк. В случае несовпадения типа данных второго или последующих операндов со строковым типом, их значение преобразуется к строковому типу в соответствии с правилами преобразования типов.

Пример:

Для того, чтобы удалить ненужные пробелы, используются системные функции СокрЛ и СокрП.

ФИО = СокрП(Фамилия) + " " + СокрП(Имя) + " " + СокрП(Отчество);

Оператор присваивания

Синтаксис:

<Назначение> = <Источник>;

Параметры:

<Назначение>

В качестве <Назначения> может выступать простая переменная, элемент массива, атрибут агрегатного типа данных (который допускает запись). Элемент массива задается как

Имя_массива[Индексное_выражение].

<Источник>

Выражение.

Описание:

Оператор присваивания (символ "=") означает присваивание значения <Источник> переменной, обозначенной как <Назначение>.

Пример:

А = В;

Стр1 = "777";

ДатаДок = '14.04.96';

This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.

ОписаниеИндекса

Возвращает описание индекса.

Синтаксис:

ОписаниеИндекса(<НомерИндекса>, <НазваниеИндекса>, <Выражение>, <Уникальность>,

<Убывание>, <Фильтр>)

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

Getlndexinfo

Параметры:

<НомерИндекса>

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

<НазваниеИндекса>

Идентификатор переменной, в которую данный метод вернет строковое значение названия индекса.

<Выражение>

Идентификатор переменной, в которую данный метод вернет строковое значение — выражение индекса.

<Уникальность>

Идентификатор переменной, в которую данный метод вернет числовое значение — флаг уникальности индекса. 1 — уникальный. 0 — не уникальный.

<Убывание>

Идентификатор переменной, в которую данный метод вернет числовое значение — флаг направления убывания индекса. 1 — индекс по убыванию значения ключа. 0 — по возрастанию значения ключа.

<Фильтр>

Идентификатор переменной, в которую данный метод вернет строковое значение — фильтр индекса.

Описание:

Метод ОписаниеИндекса возвращает в параметрах <НазваниеИндекса>, <Выражение>, <Уникальность>, <Убывание>, <Фильтр> описание индекса с номером <НомерИндекса>. Выражение индекса и фильтр индекса описаны в разделе «Выражение и фильтр индекса».

Пример:

См. пример метода КоличествоИндексов

ОписаниеПоля

Возвращает описание поля.

Синтаксис:

ОписаниеПоля(<НомерПоля>, <НазваниеПоля>, <Тип>, <Длина>, <Точность>)

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

GetFieldInfo

Параметры:

<НомерПоля>

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

<НазваниеПоля>

Идентификатор переменной, в которую данный метод вернет строковое значение названия поля.

<Тип>

Идентификатор переменной, в которую данный метод вернет числовое значение типа поля. Допустимые значения см. в описании метода ДобавитьПоле.

<Длина>

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

<Точность>

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

Описание:

Метод ОписаниеПоля возвращает в параметрах <НазваниеПоля>, <Тип>, <Длина>, <Точность> описание поля с номером <НомерПоля>.

Пример:

См. пример метода КоличествоПолей

ОписательПериода

Возвращает строку-описатель периода.

Синтаксис:

ОписательПериода

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

РеriodDescriptor

Описание:

Атрибут ОписательПериода является строковым представлением расчетного периода журнала расчетов. Тип формируемой строки различный для разной периодичности журнала расчетов. Например, для периода журналов с месячной периодичностью строка имеет вид "Январь 1997г", в случае квартальной периодичности журнала расчетов — "1 Квартал 1997г", а в случае недельной периодичности — "12.02.97 - 18.02.97".

Как правило, применяется при формировании отчетов.

Пример:

Процедура ВыводПоПериодам()

Перем Запрос, ТекстЗапроса, Таб;

Перем ДатаАкт;

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

ДатаАкт = ЖЗ.НачалоТекущегоПериода();

//Создание объекта типа Запрос

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

ТекстЗапроса = "//{{ЗАПРОС(ВыводПоПериодам)

|Период с ДатаАкт по ДатаАкт;

|Сотр = ЖурналРасчетов.Зарплата.Объект;

|Пер = ЖурналРасчетов.Зарплата.ПериодРегистрации;

|Рез = ЖурналРасчетов.Зарплата.Результат;

|Группировка Сотр упорядочить по Сотр.МестоРаботы без групп;

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

|Функция Сум = Сумма(Рез);

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

;

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

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

Возврат;

КонецЕсли;

Пока Запрос.Группировка("Сотр") = 1 Цикл

Сообщить(Запрос.Сотр.Наименование);

Пока Запрос.Группировка("Пер") = 1 Цикл

Сообщить(Запрос.Пер.ОписательПериода + "-" + 3апрос.Сум);

КонецЦикла;

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

ОписательПериода

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

Синтаксис:

ОписательПериода(<Дата>)

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

PeriodDescriptor

Параметры:

<Дата>

Дата периода, описатель которого требуется получить.

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

Строка — описатель расчетного периода.

Описание:

Метод предназначен для получения строкового представления расчетного периода журнала расчетов. Возвращает значение для того расчетного периода, в который попадает параметр <Дата>. Тип формируемой строки различается для разной периодичности журнала расчетов. Например, для журналов с месячной периодичностью строка имеет вид "Январь 1997г", в случае квартальной периодичности — "1 Квартал 1997г", а в случае недельной периодичности — "12.02.97 — 18.02.97".

Как правило, применяется при формировании отчетов.

Пример:

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

Сообщить("Текущий период — " + ЖЗ.ОписательПериода(РабочаяДата()));

См. также: НачалоПериодаПоДате, КонецПериодаПоДате

ОсновнойЯзык

Определение основного языка конфигурации.

Синтаксис:

ОсновнойЯзык()

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

GeneralLanguage

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

Число 1 — если основной язык конфигурации — русский;

Число 0 — если основной язык конфигурации — английский.

Описание:

При помощи функции ОсновнойЯзык можно прочитать текущее значение основного языка конфигурации.

Замечание: Значение основного языка конфигурации задается в конфигураторе (Метаданные-Глобалъный_модуль-Свойство-Задача-Основной язык).

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

Пример:

В данном примере при записи периодического реквизита справочника (через диалоговое окно «История») система передает в предопределенную процедуру строковое значение названия объекта. Нижеследующая процедура определяет, что введено значение курса валюты и сообщает об этом.

Процедура ПриЗаписиИстории(ИмяОбъекта, Объект, Значение, ДатаИстории)

Если ОсновнойЯзык() = 1 Тогда

СПР = "Справочник";

Иначе

СПР = "Reference";

КонецЕсли;

Если ИмяОбъекта = СПР + ".Валюты.Текущ_курс" Тогда

Сообщить("Добавлено новое значение курса");

Сообщить("Для валюты " + Объект.Наименование);

Сообщить("На дату " + ДатаИстории);

Сообщить("Установлено значение " + Значение);

КонецЕсли;

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

См. также: ПриУдаленииИстории, ПриЗаписиИстории

ОсновнойПланСчетов

Возвращает план счетов, установленный в конфигурации в качестве основного.

Синтаксис:

ОсновнойПланСчетов()

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

MainChartOfAccounts

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

Значение типа «ПланСчетов».

Описание:

Функция ОсновнойПланСчетов выдает план счетов установленный в конфигурации в качестве основного.

Пример:

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

Сч.ИспользоватьПланСчетов(ОсновнойПланСчетов());

ОсновнойЖурналРасчетов

Устанавливает основной журнал расчетов. Используется только при наличии компоненты «Расчет».

Синтаксис:

ОсновнойЖурналРасчетов(<ЖурналРасч>)

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

BasicCalcJournal

Параметры:

<ЖурналРасч>

Строковое значение — идентификатор журнала расчетов, как он задан при конфигурировании.

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

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

Описание:

Функция ОсновнойЖурналРасчетов устанавливает основной журнал расчетов. По умолчанию основной журнал расчетов — первый в списке журналов расчетов.

Пример:

ОсновнойЖурналРасчетов("Основной");

This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.

Основные понятия

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

ОсновныеИтоги

Переводит объект в режим работы с основными итогами.

Синтаксис:

ОсновныеИтоги()

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

MainTotals

Описание:

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

Пример:

БухИтоги.ОсновныеИтоги();

Остатки

Извлечь все ресурсы по регистру.

Синтаксис:

Остатки(<Измерен1>, <Измерен2>...)

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

Rests

Параметры:

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

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

Описание:

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

Данный метод используется только для регистров остатков.

Пример:

Процедура ПолучитьОстатки(Товар, Склад, ОстатокТовара, Стоимость);

Регистр.УчетТовара.Остатки(Товар, Склад);

ОстатокТовара = Регистр.УчетТовара.ОстаткиТовара;

Стоимость = Регистр.УчетТовара.СтоимостьТовара;

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

Остатки и обороты по счетам

Для расчета остатков и обротов по счетам существует группа функций со сходным синтаксисом и набором параметров.

ОстаткиПолучить

Получить все ресурсы по регистру.

Синтаксис:

ОстаткиПолучить()

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

GetRests

Описание:

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

Данный метод используется только для регистров остатков.

Пример:

Регистр.Взаиморасчеты.Клиент = Конт.Клиент;

Регистр.Взаиморасчеты.ОстаткиПолучить();

Сообщить("Долг клиента по заиморасчетам="

+ СокрЛ(Регистр.Взаиморасчеты.СуммаВалютная);

Остаток

Возвратить остаток одного ресурса регистра.

Синтаксис:

Остаток(<Измерен1>, <Измерен2>..., <ИмяРесурса>)

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

Rest

Параметры:

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

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

<ИмяРесурса>

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

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

Численое значение остатка заданного ресурса регистра.

Описание:

Метод Остаток возвращает остаток ресурса <ИмяРесурса> по регистру. Данный метод используется только для регистров остатков.

Пример:

Процедура ПолучитьОстаток(Товар, Склад, Ост, Стоим);

Ост = Регистр.УчетТовара.Остаток(Товар, Склад, "ОстаткиТовара");

Стоим = Регистр.УчетТовара.Остаток(Товар, Склад, "СтоимостьТовара");

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

ОсвободитьЗапись

Снимает фиксацию с текущей записи журнала расчетов.

Синтаксис:

ОсвободитьЗапись()

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

ReleaseRecord

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

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

Описание:

Метод снимает фиксацию с текущей записи журнала расчетов. После при менения этого метода атрибут записи Фиксирована принимает значение 0. Действие, обратное фиксации записи, фактически, означает возможность редактирования результата ее расчета.

Пример:

Если ЖрнЗарплата.Фиксирована = 1 Тогда

Если ДатаДок > ЖрнЗарплата.НачалоТекущегоПериода() Тогда

ОсвободитьЗапись();

Иначе

// отказ от расчета!

// ....

КонецЕсли;

КоненцЕсли;

См. также: Фиксирована, ФиксироватьЗапись

Отчет по неходовым товарам

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

Процедура Сформировать()

Перем Запрос, ТекстЗапроса, Таб;

Рег = СоздатьОбъект("Регистр.ОстаткиТовара");

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

ТекстЗапроса = "//{{ЗАПРОС(Сформировать)

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

|ТОВАР = Документ.РасходнаяБН.Товар,

| Документ.РасходнаяКредит.Товар, Документ.РасходнаяНал.Товар,

| Документ.РасходнаяРеализ.Товар, Документ.Счет.Товар;

|Группировка ТОВАР упорядочить по ТОВАР.Наименование без групп;

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

;

Если ДатаКонца >= ПолучитьДатуТА() Тогда

ТекстЗапроса = ТекстЗапроса + "Период С ДатаНачала;";

Иначе

ТекстЗапроса = ТекстЗапроса + "Период С ДатаНачала По ДатаКонца;";

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

РассчитатьРегистрыНа(ДатаКонца);

КонецЕсли;

// Выполнение Запроса

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

Возврат;

КонецЕсли;

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

// обход включая группировки

Тов.ВключатьПодчиненные(1);

// упорядочить по наименованиям

Тов.ПорядокНаименозаний();

ИтогоОстаток = 0;

ИтогоСумма = 0;

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

Таб.ВывестиСекцию("Отчет");

Состояние("В отчет выведено " + ЧислоСтрок + " строк.");

// Запускаем полный цикл по товарам Справочника

Тов.ВыбратьЭлементы();

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

Флаг = 0;

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

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

Продолжить;

КонецЕсли;

// Здесь пытаемся получить из Запроса информацию о товаре,

но используем просто сам факт

      // но используем просто сам факт того, что товар попал во

      // временный набор данных Запроса.

      // Если товар есть в Запросе, то значит он упоминался в

      // каких то документах,

      // иначе — товар не пользуется спросом — неходовой.

      Если Запрос.Получить(Товар) = 1 Тогда

         Продолжить;

      КонецЕсли;

      // находим остатки неходового товара на складе

      Рег.СводныеОстатки(Товар, );

      ТекОстаток = Рег.ОстатокТовара;

      ТекСумма = Рег.БазоваяСтоимость;

      Если ТекОстаток = 0 Тогда

         Продолжить;

      КонецЕсли;

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

      ИтогоОстаток = ИтогоОстаток + ТекОстаток;

      ИтогоСумма = ИтогоСумма + ТекСумма;

   КонецЦикла;

   Таб.ВывестиСекцию("Итоги");

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

   Таб.Опции(0, 0, 3, 0);

   Таб.Показать("Отчет о неходовых товарах", "");

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

ДатаКонца = РабочаяДата();

ДатаНачала = ДатаКонца — Константа.ПериодАнализа;

Отчет по регистру с точностью до строки документа

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

Использование в описании внутренней переменной для регистра атрибута НомерСтроки, означает выборку связанных номеров строк тех документов, которые произвели движение по регистру (предполагается, что в конфигурации в Модулях документов перед движением данного регистра использовали метод ПривязыватьСтроку).

Процедура Сформировать()

Перем Запрос, ТекстЗапроса, Таб;

//Создание объекта типа Запрос

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

ТекстЗапроса = "//{{ЗАПРОС(Сформировать)

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

|ВидТоплива = Регистр.ПокупателиКолво.ВидыТоплива;

|Вес = Регистр.ПокупателиКолво.Кг;

|Покуп = Регистр.ПокупателиКолво.Покупатели;

|Док = Регистр.ПокупателиКолво.ТекущийДокумент;

|Ном = Регистр.ПокупателиКолво.НомерСтроки;

|Группировка ВидТоплива; //по измерению Регистра

|Группировка Док; // по документам, двигавшим Регистр

|Группировка Ном; //по номерам строк документов

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

|Функция ПриходКолво = Приход(Вес);

|Условие(Покуп = ВыбПокупатель);

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

;

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

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

Возврат;

КонецЕсли;

// Заполнение выходных форм данными Запроса

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

Таб.ИсходнаяТаблица("Таблица1");

Таб.ВывестиСекцию("Шапка");

Пока Запрос.Группировка(1) = 1 Цикл

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

      // Отображаем значение измерения — ВидТоплива

      Таб.ВывестиСекцию("ВидТоплива");

      // запускаем вложенную группировку по документам,

      // которые производили движения Регистра

      Пока Запрос.Группировка(2) = 1 Цикл

         Док1 = Запрос.Док;

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

         Если НЕ(Док1.Вид() = "Продажа") Тогда

            Продолжить;

         КонецЕсли;

         // запускаем вложенную группировку по строкам

         // документа, связанным с движениями регистра

         Пока Запрос.Группировка(3) = 1 Цикл

            // Получаем в документе строку по найденному номеру

            Док1.ПолучитьСтрокуПоНомеру(Запрос.Ном);

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

         КонецЦикла;

      КонецЦикла;

   КонецЦикла;

   // Вывод заполненной формы

   Таб.Опции(О, О, 0, 0);

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

   Таб.Показать("", "");

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

Открыть

Открыть таблицу из файла.

Синтаксис:

Открыть(<ИмяФайла>)

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

Open

Параметры:

<ИмяФайла>

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

Описание:

Метод Открыть открывает таблицу из файла с именем <ИмяФайла>.

Пример:

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

Таб.Открыть("\v7\db\src.mox");

Таб.Показать();

Открыть

Открыть текстовый файл.

Синтаксис:

Открыть(<ИмяФайла>)

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

Open

Параметры:

<ИмяФайла>

Строковое выражение — имя файла.

Описание:

Метод Открыть открывает файл с именем <ИмяФайла>.

Пример:

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

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

Открыта

Прочитать значение флага открытия файла.

Синтаксис:

Открыта()

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

IsOpen

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

Число: 1 — база открыта; 0 — база не открыта.

Описание:

Метод Открыта возвращает значение флага открытия файла базы данных.

Пример:

См. предыдущий пример.

ОткрытьФайл

Открыть существующую базу.

Синтаксис:

ОткрытьФайл(<ПутьКБазе>, <ПутьКИндексу>, <ТолькоЧтение>)

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

OpenFile

Параметры:

<ПутьКБазе>

Строковое выражение, содержащее путь к файлу базы данных формата DBF.

<ПутьКИндексу>

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

<ТолькоЧтение>

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

Описание:

Метод ОткрытьФайл открывает существующую базу данных формата DBF.

Пример:

// Подразумевается, что объект ДБФ уже создан и

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

Процедура ОткрДБ()

ИмяФайла = "";

ИмяПути = "";

ФС.ВыбратьФайл(0, ИмяФайла, ИмяПути, , "*.*", , );

ПутьДБ = ИмяПути + ИмяФайла;

ДБФ.ОткрытьФайл(ПутьДБ);

Если ДБФ. Открыта() = 1 Тогда

Предупреждение("База открыта", 2);

Иначе

Предупреждение("Не смогли открыть Базу!", 2);

КонецЕсли;

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

ОткрытьФорму

Выполняет открытие формы из'встроенного языка.

Синтаксис:

ОткрытьФорму (<Параметр1>, <КонтекстФормы>, < Параметр 3>...)

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

OpenForm

Параметры:

<Параметр1>

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

Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ "#" с некоторым идентификатором: "#LLLL". Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — идентификатор, который позволяет открыть новое окно или активизировать уже открытое с этим идентификатором. Если идентификатор не задан, то обязательно открывается новое окно.

<КонтекстФормы>

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

После исполнения данного метода система вернет в данную переменную контекст открытой формы (см. Передача контекста в качестве параметра). С помощью значения этого контекста можно затем произвольно манипулировать открытой формой, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.

<Параметр3>...

В зависимости от типа открываемой формы используется различный состав и значения остальных параметров.

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

Число 1 — если действие выполнено;

Число 0 — если действие не выполнено.

Описание:

Функция ОткрытьФорму позволяет открыть форму документа, справочника, журнала документов, и других форм используемых в системе 1С:Предприятие.

Замечание. Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ "#" с некоторым идентификатором: "#LLLL". Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — идентификатор, который позволяет открыть новое окно или активизировать уже открытое с этим идентификатором. Если идентификатор не задан, то обязательно открывается новое окно.

Замечание. Метод ОткрытьФорму нельзя вызывать в «теле» глобального модуля ( части глобального модуля, расположенной после последней процедуры). Для его вызова при старте программы следует размещать его в процедуре ПриНачалеРаботыСистемы.

Для открытия разных форм следует использовать разный синтаксис вызова данной функции:

Открытие формы существующего документа.

ОткрытьФорму(<Документ>, <КонтекстФормы>, <РежимПросмотра>)

<Документ>

Значение типа «Документ».

<РежимПросмотра>

Необязательный параметр. Числовое выражение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотренный текущим значением параметра «Режим открытия объектов» установленного пользователем. По умолчанию — 0.

ОткрытьФормуМодально

Выполняет открытие модальной формы из встроенного языка.

Синтаксис:

ОткрытьФормуМодально(<Параметр1>, <КонтекстФормы>, <ПараметрЗ>...)

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

OpenFormModal

Параметры: см. параметры метода ОткрытьФорму

Возвращаемое значение: см. метод ОткрытьФорму.

Описание:

Функция ОткрытьФормуМодально позволяет открыть модальную форму документа, справочника, журнала документов, и других форм используемых в системе 1С:Предприятие. Синтаксис и описание см. метод ОткрытьФорму.

См. также: ОткрытьФорму

Открытие формы нового документа

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ДокументОснование>)

<ОписательОбъекта>

Строковое выражение.

"Документ.ХХХХХ", где ХХХХХ — идентификатор вида документа;

<ДокументОснование>

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

Открытие формы журнала документов.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

Строковое выражение.

"Журнал . ХХХХХ. YYYYY", где ХХХХХ — идентификатор журнала документов; YYYYY — идентификатор формы журнала документов;

Кроме того, в качестве идентификатора журнала можно указывать идентификатор конкретного вида документа, тогда откроется журнал просмотра документов именно указанного вида, например:

ОткрытьФорму("Журнал.РасходнаяНакладная")

Открытие формы журнала подчиненных документов.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>)

<ОписательОбъекта>		Строковое выражение. "Журнал.Подчиненные";
<Документ>		Значение типа «документ», задающее документ, для которого будут выводиться подчиненные документы.

Открытие формы существующего элемента справочника.

ОткрытьФорму(<Элемент>, <КонтекстФормы>, <РежимПросмотра>)

<Элемент>		Значение типа «Справочник».
<РежимПросмотра>		Необязательный параметр. Числовое выражение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотренный текущим значением параметра «Режим открытия объектов» установленного пользователем. По умолчанию — 0.

Открытие формы нового элемента справочника.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы> , <ГруппаРодитель>,

<ФлагГруппы>, <ЭлементВладелец>)

<ОписательОбъекта>		Строковое выражение. "Элемент. ХХХХХ", где ХХХХХ — вид справочника;
<ГруппаРодитель>		Необязательный параметр. Выражение типа «справочник», задающий родительскую группу для открытия формы ввода нового элемента (группы) справочника.
<ФлагГруппы>		Необязательный параметр. Числовое выражение, задающее форму ввода нового элемента (группы) справочника: 1 — ввод новой группы, 0 — ввод нового элемента. По умолчанию — 0.
<ЭлементВладелец>		Необязательный параметр. Выражение типа «справочник», задающий элемент справочника-владельца для открытия формы ввода нового элемента (группы) подчиненного справочника.

Открытие формы списка справочника.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

Строковое выражение.

"Справочник.ХХХХХ.YYYYY", где ХХХХХ — вид справочника, YYYYY — имя выбранной формы списка справочника;

Открытие формы отчета.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

Строковое выражение. "Отчет. ХХХХХ" , где ХХХХХ — вид отчета;

Открытие формы обработки.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

Строковое выражение. "Обработка.ХХХХХ", где ХХХХХ — вид обработки;

Открытие формы внешнего отчета.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ИмяФайла>)

<ОписательОбъекта>	Строковое выражение. "Отчет";
<ИмяФайла>	Строковое выражение — полное имя файла внешнего отчета.

Открытие формы журнала расчетов.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

Строковое выражение.

"ЖурналРасчетов. ХХХХХ", где ХХХХХ — вид журнала расчетов;

Открытие формы существующего счета.

ОткрытьФорму(<Счет>, <КонтекстФормы>, <РежимПросмотра>)

<Счет>

Значение типа «Счет».

<РежимПросмотра>

Открытие формы нового счета.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

Строковое выражение.

"Счет. ХХХХХ" , где ХХХХХ — идентификатор плана счетов;

Открытие формы списка счетов (плана счетов).

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

Строковое выражение.

"ПланСчетов.ХХХХ.YYYY", где ХХХХХ — идентификатор плана счетов; YYYYY — идентификатор формы плана счетов.

Открытие формы существующей операции.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Проводка>,

<Корреспонденция>, <РежимПросмотра>)

<ОписательОбъекта>	Строковое выражение. "Операция".
<Документ>	Значение типа «документ», операция которого будет открываться.
<Проводка>	Необязательный параметр. Числовое выражение — номер проводки, на которую нужно позиционировать курсор при открытии операции.
<Корреспонденция>	Необязательный параметр. Числовое выражение — номер корреспонденции указанной проводки, на которую нужно позиционировать курсор при открытии операции.
<РежимПросмотра>	Необязательный параметр. Числовое выражение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотренный текущим значением параметра «Режим открытия объектов» установленного пользователем. По умолчанию — 0.

Открытие формы ввода новой операции.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ТиповаяОперация>)

<ОписательОбъекта>

Строковое выражение. "Операция".

<ТиповаяОперация>

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

Открытие формы журнала операций.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Пров>, <Корр>)

<ОписательОбъекта>	Строковое выражение. "ЖурналОпераций.YYYYY", где YYYYY — идентификатор формы журнала операций;
<Документ>	Значение типа «документ», операция которого будет использована для первоначального позиционирования.
<Пров>	Номер проводки, которая будет использована для первоначального позиционирования курсора, если в журнале операций используется режим показа проводок.
<Корр>	Номер корреспонденции, которая будет использована для первоначального позиционирования курсора, если в журнале операций используется режим показа проводок.

Открытие формы журнала проводок.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Проводка>,

<Корреспонденция>)

<ОписательОбъекта>	Строковое выражение. "ЖурналПроводок.YYYYY", где YYYYY — идентификатор формы журнала проводок;
<Документ>	Значение типа «документ», операция которого будет использована для первоначального позиционирования.
<Проводка>	Необязательный параметр. Числовое выражение — номер проводки операции, на которую нужно в начале позиционироваться.
<Корреспонденция>	Необязательный параметр. Числовое выражение — номер корреспонденции указанной проводки, на которую нужно в начале позиционироваться.

Открытие окна истории значений периодических констант, реквизитов справочников и счетов.

ОткрытьФорму("История.Константа.<ИдентКонстанты>", , , <УстНаДату>)

ОткрытьФорму("История.Справочник.<ИдентСправочника>, <ИдентРеквизита>", ,

<ЭлементСправочника>, <УстНаДату>)

ОткрытьФорму("История.Счет", , <Счет>, <УстНаДату>)

<ИдентКонстанты>

Идентификатор периодической константы, как он задан в конфигураторе.

<ИдентСправочника>

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

<ИдентРеквизита>

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

<ЭлементСправочника>

Элемент справочника, для периодического реквизита которого открывается окно истории значений.

<Счет>

Счет, для которого открывается окно истории значений.

<УстНаДату>

Необязательный параметр. Дата, на которую нужно установить курсор при открытии окна.

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

Примеры:

Перем Конт;

ОткрытьФорму("История.Справочник.Сотр.Тариф#Ид01", , ТекущийЭлемент());

ОткрытьФорму(Докум, Конт);

ОткрытьФорму("Документ.РасхНакл");

ОткрытьФорму("Журнал.Продажи.КраткаяФорма");

ОткрытьФорму("Отчет", , "С:\lcv7db\extforms\profit.ert");

ОткрытьПодбор

Открыть форму для подбора значений.

Синтаксис:

ОткрытьПодбор(<ИмяОбъекта>, <ИмяФормы>, <КонтекстФормы>, <ФлагМножВыбора>,

<ТекЗнач>)

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

OpenPermanentChoice

Параметры:

<ИмяОбъекта>

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

"Справочник.ХХХХХ";

"Документ.ХХХХХ";

"Отчет.ХХХХХХ";

"Обработка.ХХХХХХ";

"Журнал.ХХХХХ" , где ХХХХХ — имя вида соответствующего объекта, как он задан в конфигураторе, например: "Справочник.Товары";

"Журнал.Подчиненные";

"ЖурналОпераций.ХХХХХ", где ХХХХХ — форма журнала пераций.

"ПланСчетов.ХХХХХ", где ХХХХХ — идентификатор плана счетов, как он задан в конфигураторе. Если ХХХХХ не задан, то открывается подбор из любого (всех) плана счетов.

<ИмяФормы>

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

<КонтекстФормы>

После исполнения данного метода система вернет в данную переменную контекст формы подбора (см. «Передача контекста в качестве параметра»). С помощью значения этого контекста можно затем произвольно манипулировать формой подбора, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.

<ФлагМножВы6ора>

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

<ТекЗнач>

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

Описание:

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

При открытии подбора по журналу подчиненных документов, т. е. когда первый параметр <ИмяОбъекта> имеет значение "Журнал.Подчиненные", документ владелец, по которому следует построить журнал подчиненных документов, передается после вызова метода через полученный контекст формы.

Пример:

Процедура Подбор()

   ГруппаДляВыбора = ТекущийЭлемент();

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

      ГруппаДляВыбора = ГруппаДляВыбора.Родитель;

   КонецЕсли;

   ОткрытьПодбор("Справочник.Товары", "ДляПодбора", КонтПодб, 0);

   // установим в форме подбора реквизит "ГруппаВыбора"

   // используя полученный контекст формы подбора

   КонтПодб.ГруппаВыбора.ВыборГруппы(1);

   КонтПодб.ГруппаВыбора = ГруппаДляВыбора;

   КонтПодб.Обновить(0);

   УстановитьЗначениеВПодборе("ГруппаВыбора", ГруппаДляВыбора);

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

См. также: ОбработкаПодбора, УстановитьЗначениеВПодборе

Отменить

Отменить запись изменения в базу.

Синтаксис:

Отменить()

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

Cancel

Описание:

Метод Отменить отменяет запись изменения в базу (см. Автосохранение).

Пример:

см. пример метода Автосохранение

ОтменитьИсправление

Отменяет исправление записи журнала расчетов, сделанное ранее.

Синтаксис:

ОтменитьИсправление()

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

UndoUpdate

Описание:

Отменяет исправление, сделанное ранее (вручную или из языка методом Исправить). Метод выполняет те же действие, что и интерактивная процедура отмены исправления записи журнала расчетов. Описание интерактивной процедуры отмены исправления результата записи журнала расчетов можно посмотреть в книге «Руководство пользователя».

This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.

ОтменитьТранзакцию

Завершить транзакцию без записи изменений.

Синтаксис:

ОтменитьТранзакцию()

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

RollBackTransaction

Описание:

Процедура ОтменитьТранзакцию завершает транзакцию без записи изменений.

Пример:

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

Процедура ЗагрузкаКурсовВалют()

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

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

Текст.Открыть(ИмяФайла);

Если Текст.КоличествоСтрок() = 0 Тогда

Сообщить("Текст пустой!");

Возврат;

КонецЕсли;

Успешно = 1;

НачатьТранзакцию();

Для Ном = 1 по Текст.КоличествоСтрок() Цикл

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

Если СтрДлина(Стр) = 0 Тогда

Продолжить;

КонецЕсли;

Поле=0;

Пока СтрДлина(Стр) > 0 Цикл

Поле = Поле + 1;

Инд = Найти(Стр, "-");

Если Инд > 0 Тогда

Если Инд > 3 Тогда

Стр1 = Сред(Стр, 2, Инд-3);

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

Иначе

// если значение поля пропущено

Стр1 = "";

КонецЕсли;

Стр=Сред(Стр, Инд + 1);

// не берем символ тильды

Иначе

Стр = Сред(Стр, 2);

Инд = Найти(Стр, """");

Стр1 = Сред(Стр, 1, Инд-1);

Стр = "";

КонецЕсли;

Если Поле = 1 Тогда

Код = Стр1;

ИначеЕсли Поле = 2 Тогда

Курс = Стр1;

ИначеЕсли Поле = 3 Тогда

ДатаКурса = Стр1;

КонецЕсли;

КонецЦикла;

Влт.ИспользоватьДату(Дата(ДатаКурса));

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

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

Сообщить(Формат(Ном, "45") + " - загрузка Курса="

+ Формат(Курс, "45") + " от " + ДатаКурса);

Влт.Текущ_курс = Число(Курс);

Влт.Записать();

Сообщить(" – Загружен!");

Иначе

Успешно = 0;

Сообщить("В базе данных нет валюты с кодом " + Код");

Сообщить("Импорт данных отменён!");

Прервать;

КонецЕсли;

Состояние("Загружено "+Ном+" строк.");

КонецЦикла;

Если Успешно = 1 Тогда

ЗафиксироватьТранзакцию();

Иначе

ОтменитьТранзакцию();

КонецЕсли;

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

ОтметитьЗначения

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

Синтаксис:

ОтметитьЗначения(<Значение>, <3аголовок>, <Позиция>, <Таймаут>)

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

CheckValues

Параметры:

<Значение>

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

<Загoлoвoк>

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

<Пoзиция>

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

<Tаймayт>

Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя.

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

Число: 1 — если выбор произведен (нажата кнопка «ОК»); 0 — если выбоо не произведен (нажата кнопка «ОТМЕНА»); -1 (минус единица) — закончилось время <Таймаут> ожидания отклика пользователя.

Описание:

Метод ОтметитьЗначения вызывает диалоговое окно для интерактивной пометки значений списка из заранее подготовленного списка.

Возможность выбора значения — это дополнительная возможность, предоставляемая данным методом. Параметр <Значение> указывает на значение того элемента списка, на котором будет установлен курсор при открытии окна выбора. В этот же параметр возвращается последнее выбранное значение- В параметр <Позиция> возвращается номер позиции последнего выбранного значения в списке. Если выбор отменен, то значение параметров не меняются.

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

Пример:

Функция ВыбратьКредит (ДокКредита)

Перем ВыбДок;

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

Рег = СоздатьОбъект("Регистр.ТоварныйКредит");

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

Рег.ВыбратьИтоги();

Пока Рег.ПолучитьИтог() = 1 Цикл

Док = Рег.Документ;

Список. ДобавитьЗначение(Док, "" + Док + " — Остаток = " + Рег.Долг);

КонецЦикла;

Список.ОтметитьЗначения(ВыбДок, "Выберите кредиты");

Возврат Список;

КонецФункции

ПанельИнструментов

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

Синтаксис:

ПаяельИнструментов(<Режим>)

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

ToolBar

Параметры:

<Режим>

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

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

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

Описание:

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

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

Пример:

Форма.ПанельИнструментов(0);

представляет собой значение, переданное данной

Параметр, переданный при программном открытии формы.
Синтаксис:
Параметр
Англоязычный синоним:
Parameter
Описание:
Атрибут Параметр объекта «Форма» представляет собой значение, переданное данной форме при ее открытии программно с помощью методов Открытьформу, ОткрытьФормуМодально, ОткрытьПодбор. Если форма открыта интерактивно или если параметр при программном открытии не передавался, то данный атрибут содержит значение неопределенного типа.
Доступ к данному атрибуту возможен только в контексте Модуля формы.
Пример:
ПереданныйПараметр = Форма.Параметр;
См. также: ОткрытьФорму, ОткрытьФормуМодально, ОткрытьПодбор

ПараметрыСтраницы

Установить параметры страницы.

Синтаксис:

ПараметрыСтраницы(<Ориентация>, <Масштаб>, <РежимПечатиКопий>, <ПолеСлева>,

<ПолеСправа>, <ПолеСверху>, <ПолеСнизу>, <КолонтитулСверху>,

<КолонтитулСнизу>, <Автомасштаб> , <ФлагЧерноБелойПечати>,

<ИмяПринтера>)

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

PageSetup

Параметры:

<Ориентация>

Необязательный параметр. Числовое выражение — ориентация вывода на печать: 1 — портрет; 2 — ландшафт.

<Масштаб>

Необязательный параметр. Числовое выражение — масштаб (в процентах) вывода на печать.

<РежимПечатиКопий>

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

<ПолеСлева>

Необязательный параметр. Числовое выражение — расстояние (в миллиметрах) от правого края страницы.

<ПолеСверху>

Необязательный параметр. Числовое выражение — расстояние (в миллиметрах) от верхнего края страницы.

<ПолеСнизу>

Необязательный параметр. Числовое выражение — расстояние (в миллиметрах) от нижнего края страницы.

<КолонтитулСверху>

Необязательный параметр. Числовое выражение — размер (в миллиметрах) верхнего колонтитула.

<КолонтитулСнизу>

Необязательный параметр. Числовое выражение — размер (в миллиметрах) нижнего колонтитула.

<Автомасштаб>

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

<ФлагЧерноБелойПечати>

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

<ИмяПринтера>

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

Описание:

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

Пример:

Таб.ПараметрыСтраницы(1, 100, 1, 17, 17, 25, 25, 10, 10);

См. также: Опции