Глава 7 Системные процедуры и функции

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

Математические функции

Окр

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

Синтаксис:

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

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

Round

Параметры:

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

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

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

Описание:

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

Пример:

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

Цел

Получить целую часть числа.

Синтаксис:

Цел(Число)

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

Int

Параметры:

Число

Числовое выражение.

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

Числовое значение целой части переданного в качестве параметра числа.

Описание:

Функция Цел возвращает целую часть переданного в качестве параметра числа, полностью отсекая дробную часть.

Пример:

МожноКупить = Цел(Наличность/Цена);

Мин

Определить минимальное значение.

Синтаксис:

Мин(Элемент1, ..., ЭлементN)

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

Min

Параметры:

Элемент1, ..., ЭлементN

Список выражений базовых типов данных.

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

Значение минимального элемента из списка Элемент1, ..., ЭлементN

Описание:

Функция Мин определяет минимальное значение из списка Элемент1, ..., ЭлементN.

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

Пример:

МинимЦена = Мин(Цена1, Цена2, ЦенаЗ);

Макс

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

Синтаксис:

Макс(Элемент1, ..., ЭлементN)

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

Мах

Параметры:

Элемент1, ..., ЭлементN Список выражений базовых типов данных.

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

Значение максимального элемента из списка Элемент1, ..., ЭлементN

Описание:

Функция Макс определяет максимальное значение из списка Элемент1, ..., ЭлементN.

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

Пример:

МаксимЦена = Макс(Цена1, Цена2, ЦенаЗ);

Лог10

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

Синтаксис:

Лог10(Число)

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

Log10

Параметры:

Число

Числовое выражение.

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

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

Описание:

Функция Лог10 вычисляет и возвращает десятичный логарифм числа. При отрицательном или нулевом значении параметра возвращаемое значение — 0.

Пример:

Шкала = Лог10(Частота);

Лог

Вычислить натуральный логарифм числа.

Синтаксис:

Лог(Число)

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

Ln

Параметры:

Число

Числовое выражение.

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

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

Описание:

Функция Лог вычисляет и возвращает натуральный логарифм числа. При отрицательном или нулевом значении параметра возвращаемое значение — 0.

Пример:

Шкала = Лог(Частота);

Строковые функции

СтрДлина

Получить длину строки.

Синтаксис:

СтрДлина(Строка)

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

StrLen

Параметры:

Строка

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

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

Числовое значение длины строки.

Описание:

Функция СтрДлина получает в качестве параметра строку и возвращает числовое значение ее длины.

Пример:

Длина = СтрДлина(Измерим длину строки);

ПустаяСтрока

Проверить строку на наличие значащих символов.

Синтаксис:

ПустаяСтрока(Строка)

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

IsBlankString

Параметры:

Строка

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

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

Числовое значение. 1 — пустая строка или только пробелы. 0 — не пустая строка.

Описание:

Функция ПустаяСтрока проверяет переданный параметр Строка на наличие значащих символов (любых кроме пробелов) и возвращает число 1, если строка пустая или содержит только пробелы, 0 , если строка не пустая.

Пример:

Если ПустаяСтрока(Буфер) = 1 Тогда

// если Буфер содержит только пробелы, то его удаляем

Буфер = ;

КонецЕсли;

СокрЛ

Отбросить в строке стоящие слева пробелы.

Синтаксис:

СокрЛ(Строка)

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

TrimL

Параметры:

Строка

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

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

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

Описание:

Функция СокрЛ получает в качестве параметра строку, отсекает стоящие слева пробелы и возвращает результирующую строку.

Пример:

СтрЦена = СокрЛ(Цена) + руб.;

СокрП

Отбросить в строке стоящие справа пробелы.

Синтаксис:

СокрП(Строка)

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

TrimR

Параметры:

Строка

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

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

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

Описание:

Функция СокрП получает в качестве параметра строку, отсекает стоящие справа пробелы и возвращает результирующую строку.

Пример:

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

СокрЛП

Отбросить в строке пробелы, стоящие слева и справа.

Синтаксис:

СокрЛП(Строка)

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

TrimAll

Параметры:

Строка

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

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

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

Описание:

Функция СокрЛП получает в качестве параметра строку, отсекает стоящие слева и справа пробелы, и возвращает результирующую строку.

Пример:

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

Лев

Выбрать в строке символы слева.

Синтаксис:

Лев (Строка, Число)

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

Left

Параметры:

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

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

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

Описание:

Функция Лев получает в качестве параметра строку, выбирает первые слева символы строки, числом равные Число, и возвращает в качестве значения результирующую строку.

Пример:

Фамилия = Лев(ФИО, 15);

Прав

Выбрать в строке символы справа.

Синтаксис:

Прав(Строка, Число)

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

Right

Параметры:

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

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

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

Описание:

Функция Прав получает в качестве параметра строку, выбирает крайние справа символы строки, числом равные Число, и возвращает в качестве значения результирующую строку.

Пример:

Отчество = Прав(ФИО, 15);

Сред

Выбрать подстроку.

Синтаксис:

Сред(Строка, Число1, Число2)

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

Mid

Параметры:

Строка	Строковое выражение.
Число1	Числовое выражение, начальный номер символа.
Число2	Числовое выражение, количество символов.

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

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

Описание:

Функция Сред возвращает подстроку параметра Строка, начиная с символа с номером Число1 общим количеством Число2. Позиции в строке считаются, начиная с 1. Параметр Число2 может быть опущен, тогда выделяются все символы начиная с символа с номером Число1 до конца строки.

Пример:

Имя = Сред(ФИО, 10, 12);

Найти

Найти вхождение подстроки.

Синтаксис:

Найти(Строка1, Строка2)

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

Find

Параметры:

Строка1	Строковое выражение места поиска.
Строка2	Строковое выражение шаблона поиска.

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

Числовое значение позиции первого знака найденной подстроки.

Описание:

Функция Найти находит вхождение строки Строка2 как подстроки в Строка1. Возвращает числовое значение позиции первого знака найденной подстроки (первая позиция имеет индекс 1). Если не находит — возвращает число 0.

Пример:

Симв = Найти(ФИО, Борис);

СтрЗаменить

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

Синтаксис:

СтрЗаменить(СтрИсточник, СтрПодстрока, СтрЗамены)

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

StrReplace

Параметры:

СтрИсточник	Строковое выражение места поиска.
СтрПодстрока	Строковое выражение шаблона поиска.
СтрЗамены	Строковое выражение замены.

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

Результирующая строка.

Описание:

Функция СтрЗаменить находит вхождение строки СтрПодстрока как подстроки в СтрИсточник и заменяет его на СтрЗамены. Результирующую строку возвращает в качестве собственного значения. Исходная строка не изменяется.

Пример:

Результат = СтрЗаменить(СтрИсточник, СтрПодстрока, СтрЗамены);

СтрЧислоВхождений

Вычислить число вхождений подстроки.

Синтаксис:

СтрЧислоВхождений(СтрИсточник, СтрПодстрока)

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

StrCountOccur

Параметры:

СтрИсточник	Строковое выражение места поиска.
СтрПодстрока	Строковое выражение шаблона поиска.

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

Число вхождений.

Описание:

Функция СтрЧислоВхождений вычисляет число вхождений строки СтрПодстрока как подстроки в СтрИсточник.

Пример:

Результат = СтрЧислоВхождений(СтрИсточник, СтрПодстрока);

СтрКоличествоСтрок

Определить число строк в многострочном тексте.

Синтаксис:

СтрКоличествоСтрок(Строка)

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

StrLineCount

Параметры:

Строка

Строковое выражение, в котором строки разделены символами перевода строк.

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

Число строк в многострочном тексте.

Описание:

Функция СтрКоличествоСтрок вычисляет число строк в многострочном тексте (строки разделены символами перевода строк).

Пример:

Рез = СтрКоличествоСтрок(ДлТекст);

См. также: РазделительСтрок

СтрПолучитьСтроку

Получить строку из многострочного текста по номеру.

Синтаксис:

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

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

StrGetLine

Параметры:

Текст	Строковое выражение, в котором строки разделены символами перевода строк.
НомерСтроки	Числовое выражение, начальный номер символа.

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

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

Описание:

Функция СтрПолучитьСтроку возвращает строку с номером НомерСтроки из многострочного текста Текст (строки разделены символами перевода строк).

Пример:

ВтораяСтрока = СтрПолучитьСтроку(ДлТекст, 2);

См. также: РазделительСтрок

Врег

Преобразовать символы строки в верхний регистр.

Синтаксис:

ВРег(Строка)

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

UpРег

Параметры:

Строка

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

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

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

Описание:

Функция ВРег преобразует все символы строки в верхний регистр. Результирующую строку возвращает в качестве собственного значения. Исходная строка не изменяется.

Пример:

Загл = ВРег(маленькие);

Нрег

Преобразовать символы строки в нижний регистр.

Синтаксис:

НРег(Строка)

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

Lower

Параметры:

Строка

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

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

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

Описание:

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

Пример:

Загл = НРег(БОЛЬШИЕ);

OemToAnsi

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

Синтаксис:

OemToAnsi(Строка)

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

OemToAnsi

Параметры:

Строка

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

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

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

Описание:

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

Пример:

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

AnsiToOem

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

Синтаксис:

AnsiToOem(Строка)

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

AnsiToOem

Параметры:

Строка

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

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

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

Описание:

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

Пример:

3aгл = AnsiToOem(TeкстWin);

Симв

Преобразовать код символа в символ.

Синтаксис:

Симв(КодСимвола)

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

Chr

Параметры:

КодСимвола

Числовое выражение.

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

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

Описание:

Функция Chr преобразует код символа в символ. Возвращает результирующий символ в виде строкового значения.

Пример:

Буква_я = Симв(255);

КодСимв

Преобразовать символ в код символа.

Синтаксис:

КодСимв(Символ)

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

Asс

Параметры:

Символ

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

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

Числовое значение.

Описание:

Функция КодСимв преобразует символ в код символа. Возвращает результирующий код символа в виде числового значения.

Пример:

КодБуквы_я = КодСимв(я);

Функции работы с датой

РабочаяДата

Установить/получить текущую рабочую дату.

Синтаксис:

РабочаяДата(Дата, РежимСменыРабДаты)

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

WorkingDate

Параметры:

Дата

Необязательный параметр. Выражение типа «дата».

РежимСменыРабДаты

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

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

Значение текущей рабочей даты (на момент до выполнения функции).

Описание:

При помощи функции РабочаяДата можно установить/получить значение рабочей даты, выбранной в текущем сеансе работы программы (которая может изменяться при помощи главного меню Сервис-Параметры-Общие-РабочаяДата).

Пример:

// оклад сотрудника на текущую рабочую дату

Сотрудник.Оклад.Получить(РабочаяДата());

ТекущаяДата

Возвратить текущую дату.

Синтаксис:

ТекущаяДата()

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

CurDate

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

Результирующая дата.

Описание:

Функция ТекущаяДата возвращает текущую (системную) дату. Возвращаемое значение — результирующая дата.

Пример:

ДатаТекущая = ТекущаяДата();

ДобавитьМесяц

Добавляет к указанной дате заданное число месяцев.

Синтаксис:

ДобавитьМесяц(Дата, ЧислоМесяцев)

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

AddMonth

Параметры:

Дата	Выражение со значением типа «дата».
ЧислоМесяцев	Числовое выражение, задающее число месяцев, добавляемое к дате.

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

Результирующая дата.

Описание:

Функция ДобавитьМесяц добавляет к указанной дате заданное число месяцев.

Пример:

ДатаЧерезТриМесяца = ДобавитьМесяц(РабочаяДата(), 3);

НачМесяца

Определить дату начала месяца.

Синтаксис:

НачМесяца(Дата)

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

BegOfMonth

Параметры:

Дата	Выражение со значением типа «дата».

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

Результирующая дата.

Описание:

Функция НачМесяца определяет дату начала месяца для указанной даты.

Пример:

ДатаНачалаМесяца = НачМесяца(РабочаяДата());

КонМесяца

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

Синтаксис:

КонМесяца(Дата)

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

EndOfMonth

Параметры:

Дата	Выражение со значением типа «дата».

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

Результирующая дата.

Описание:

Функция КонМесяца определяет дату конца месяца для указанной даты.

Пример:

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

НачКвартала

Определить дату начала квартала.

Синтаксис:

НачКвартала(Дата)

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

BegOfQuart

Параметры:

Дата	Выражение со значением типа «дата».

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

Результирующая дата.

Описание:

Функция НачКвартала определяет дату начала квартала для указанной даты.

Пример:

ДатаНачалаКвартала = НачКвартала(РабочаяДата());

КонКвартала

Определить дату конца квартала.

Синтаксис:

КонКвартала(Дата)

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

EndOfQuart

Параметры:

Дата	Выражение со значением типа «дата».

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

Результирующая дата.

Описание:

Функция КонКвартала определяет дату конца квартала для указанной даты.

Пример:

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

НачГода

Определить дату начала года.

Синтаксис:

НачГода(Дата)

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

BegOfYear

Параметры:

Дата	Выражение со значением типа «дата».

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

Результирующая дата.

Описание:

Функция НачГода определяет дату начала года для указанной даты.

Пример:

ДатаНачалаГода = НачГода(РабочаяДата());

КонГода

Определить дату конца года.

Синтаксис:

КонГода(Дата)

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

EndOfYear

Параметры:

Дата	Выражение со значением типа «дата».

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

Результирующая дата.

Описание:

Функция КонГода определяет дату конца года для указанной даты.

Пример:

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

НачНедели

Определить дату начала недели.

Синтаксис:

НачНедели(Дата)

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

BegOfWeek

Параметры:

Дата	Выражение со значением типа «дата».

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

Результирующая дата.

Описание:

Функция НачНедели определяет дату начала недели для указанной даты.

Пример:

ДатаНачалаНедели = НачНедели(РабочаяДата());

КонНедели

Определить дату конца недели.

Синтаксис:

КонНедели(Дата)

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

EndOfWeek

Параметры:

Дата	Выражение со значением типа «дата».

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

Результирующая дата.

Описание:

Функция КонНедели определяет дату конца недели для указанной даты.

Пример:

ДатаКонцаНедели = КонНедели(РабочаяДата());

ДатаГод

Определить год указанной даты.

Синтаксис:

ДатаГод(Дата)

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

GetYear

Параметры:

Дата	Выражение со значением типа «дата».

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

Число со значением определенного года.

Описание:

Функция ДатаГод определяет год указанной даты.

Пример:

ЗначениеГода = ДатаГод(РабочаяДата());

ДатаМесяц

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

Синтаксис:

ДатаМесяц(Дата)

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

GetMonbh

Параметры:

Дата	Выражение со значением типа «дата».

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

Число со значением номера месяца года.

Описание:

Функция ДатаМесяц определяет месяц указанной даты.

Пример:

ЗначениеМесяца = ДатаМесяц(РабочаяДата());

ДатаЧисло

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

Синтаксис:

ДатаЧисло(Дата)

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

GetDay

Параметры:

Дата	Выражение со значением типа «дата».

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

Число со значением определенного дня месяца.

Описание:

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

Пример:

ЗначениеДняМесяца = ДатаЧисло(РабочаяДата());

НомерНеделиГода

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

Синтаксис:

НомерНеделиГода(Дата)

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

GetWeekOfYear

Параметры:

Дата	Выражение со значением типа «дата».

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

Число со значением определенного номера недели в году.

Описание:

Функция НомерНеделиГода определяет номер недели в году для указанной даты.

Пример:

ЗначениеНедели = НомерНеделиГода(РабочаяДата());

НомерДняГода

Определить день года указанной даты.

Синтаксис:

НомерДняГода(Дата)

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

GetDayOfYear

Параметры:

Дата	Выражение со значением типа «дата».

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

Число со значением определенного дня года.

Описание:

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

Пример:

ЗначениеДняГода = НомерДняГода(РабочаяДата());

НомерДняНедели

Определить день недели указанной даты.

Синтаксис:

НомерДняНедели(Дата)

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

GetDayOfWeek

Параметры:

Дата	Выражение со значением типа «дата».

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

Число со значением определенного порядкового дня недели.

Описание:

Функция НомерДняНедели определяет день недели указанной даты. Возвращаемое значение — число со значением определенного порядкового дня недели (1 — понедельник, 2 — вторник, ..., 7 — воскресенье).

Пример:

ЗначениеДняНедели = НомерДняНедели(РабочаяДата());

ПериодСтр

Строковое представление периода.

Синтаксис:

ПериодСтр(ДатаНачалаПериода, ДатаКонцаПериода)

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

Рег1odStr

Параметры:

ДатаНачалаПериода	Дата — начальная дата периода.
ДатаКонцаПериода	Дата — конечная дата периода.

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

Символьная строка — представление периода.

Описание:

Внутри системы все периоды задаются интервалом дат — дата начала и дата конца. Функция ПериодСтр предназначена для того, чтобы в случае, если период фактически является кварталом, месяцем, полугодием отобразить его соответствующим образом, например 1 квартал 1997 г.

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

Пример:

Дата1='01.01.97';

Дата2='31.03.97';

Сообщить(ПериодСтр(Дата1, Дата2)); //Выводит 1 квартал 1997 г.

НачалоСтандартногоИнтервала

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

Синтаксис:

НачалоСтандартногоИнтервала(Вариант)

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

BegOfStandrdRange

Параметры:

Вариант

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

День, Месяц, Квартал, Год, Day, Month, Quarter, Year. Значением типа «дата» задается конкретная дата начала интервала журнала документов. Если параметр не задан, то установка сделанная в параметрах системы не меняется, а только возвращается текущий вариант.

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

Возвращает текущий установленный вариант.

Описание:

Функция НачалоСтандартногоИнтервала устанавливает вариант зада ния начала стандартного интервала отображения журнала документов. Вариан может изменяться при помощи главного меню Сервис-Параметры-Общие.

Пример:

НачалоСтандартногоИнтервала(Месяц);

КонецСтандартногоИнтервала

Устанавливает вариант задания конца стандартного интервала ото бражения журнала документов.

Синтаксис:

КонецСтандартногоИнтервала(Вариант)

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

EndOfStandardRange

Параметры:

Вариант

Необязательный параметр. Выражение со значением типа строка или дата. Возможные строковые значения параметра: День, Месяц, Квартал, Год, Day, Month, Quarter, Year. Значением типа «дата» задается конкретная дата конца интервала журнала документов. Если параметр не задан, то установка сделанная в параметрах системы не меняется, а только возвращается текущий вариант.

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

Возвращает текущий установленный вариант.

Описание:

Функция КонецСтандартногоИнтервала устанавливает вариант задания конца стандартного интервала отображения журнала документов. Вариант может изменяться при помощи главного меню Сервис-Параметры-Общие.

Пример:

КонецСтандартногоИнтервала(Месяц);

Функции работы с временем

ТекущееВремя

Возвратить текущее время

Синтаксис:

ТекущееВремя(Час, Мин, Сек)

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

CurrentTime

Параметры:

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

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

Текущее время в текстовом виде.

Описание:

Функция ТекущееВремя возвращает текущее (системное) время в текстовом виде. Кроме того, если в качестве параметров при вызове функции передать переменные, то функция вернет в них числовые значения текущего часа, минуты, секунды.

Пример:

Сообщить(Сейчас + ТекущееВремя());

Функции преобразования типов

Дата

Преобразовать параметр в дату.

Синтаксис 1:

Дата(Параметр)

Синтаксис 2:

Дата(Год, Месяц, Число)

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

Date

Параметры:

Параметр	Числовое выражение.
Год	Числовое выражение. Год указывается 4-х знач-ным числом (вместе с веком).
Месяц	Числовое выражение.
Число	Числовое выражение.

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

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

Описание:

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

Пример:

// преобразование из строки

ДатаРожд = Дата('06.03.1958');

Строка

Преобразовать параметр в строку.

Синтаксис:

Строка(Параметр)

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

String

Параметры:

Параметр

Выражение.

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

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

Описание:

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

Стр = Строка(ДатаРожд + 1);

Число

Преобразовать параметр в число.

Синтаксис:

Число(Параметр)

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

Number

Параметры:

Параметр

Выражение.

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

Числовое значение.

Описание:

Функция Число преобразует параметр в число, руководствуясь принятыми правилами преобразования типов и возвращает значение числа.

Пример:

ВР = Число(Вар + Род);

Функции работы с позицией документа

СформироватьПозициюДокумента

Формирует позицию документа согласно переданным параметрам

Синтаксис 1:

СформироватьПозициюДокумента(Докум, ФлагСмещения)

Синтаксис 2:

СформироватьПозициюДокумента(Дата, Час, Мин, Сек, ФлагКонцаСекунды)

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

MakeDocPosition

Параметры:

Докум	Значение документа (или его позиция), позиция которого определяется.
ФлагСмещения	Необязательный параметр. Число: -1 (минус единица) — предыдущая позиция. 1 — следующая позиция. 0 — текущая позиция. Значение по умолчанию — 0. Использование данного параметра позволяет получить предыдущую или последующую позицию от уже имеющейся позиции.
Дата	Значение типа «дата», на которую формируется позиция документа.
Час	Значение типа «число», которое определяет час, на который формируется позиция документа.
Мин	Значение типа «число», которое определяет минуту, на которую формируется позиция документа.
Сек	Значение типа «число», которое определяет секунду, на которую формируется позиция документа.
ФлагКонцаСекунды	Необязательный параметр. Число: 1 — позиция будет браться от следующей секунды. 0 — позиция от указанной секунды. Значение по умолчанию — 0.

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

Строковое значение — сформированная позиция документа (см. «Позиция документа»).

Описание:

Функция СформироватьПозициюДокумента формирует и возвращает позицию документа согласно переданным параметрам.

Пример:

ПозицияВыбДокум=СформироватьПозициюДокумента(ВыбДокумент);

РазобратьПозициюДокумента

Раскладывает позицию документа на составляющие и возвращает строковое представление позиции документа

Синтаксис:

РазобратьПозициюДокумента(Позиция, Дата, Час, Мин , Сек, Документ)

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

SplitDocPosition

Параметры:

Позиция	Строковое значение позиции документа.
Дата	Необязательный параметр. Имя переменной, куда система вернет значение даты позиции документа.
Час	Необязательный параметр. Имя переменной, куда система вернет числовое значение часа позиции документа.
Мин	Необязательный параметр. Имя переменной, куда система вернет числовое значение минуты позиции документа.
Сек	Необязательный параметр. Имя переменной, куда система вернет числовое значение секунды позиции документа.
Документ	Необязательный параметр. Имя переменной, куда система вернет значение документа данной позиции документа.

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

Представление позиции документа в строковом виде, например: «12.07.98 12:57:14 ПрихНакл 24»

Описание:

Функция РазобратьПозициюДокумента раскладывает позицию документа на составляющие и возвращает строковое представление позиции документа.

Пример:

Позиция = РазобратьПозициюДокумента(ВыбДокумент.ПозицияДокумента());

Процедуры и функции форматирования

Пропись

Задать образец вывода числа прописью.

Синтаксис:

Пропись(Образец)

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

Spelling

Параметры:

Образец

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

-строковое выражение, задающее имя файла прописи (в поставляемом комплекте файлы прописей имеют расширение .SPL);

- объект типа «СписокЗначений» в котором в специальном формате задан образец прописей.

Если параметр Образец пустой или состоит из пробелов, то устанавливается образец прописей по умолчанию (файл 1CV7.spl).

Описание:

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

В параметре Образец может быть передана строка, задающая имя файла прописей. Файл прописей представляет собой текстовый файл специальной структуры, в котором находятся образцы прописей чисел, названия денежной единицы, дат, дней недели и т. п. Пример файла прописей можно посмотреть в поставляемом комплекте (файл lCV7.spl).

Ниже приводится фрагмент текста файла прописей, содержащий образец прописи для валюты мужского рода:

{Speller,

{Money,

{Рубль, Рубля, Рублей, Копейка, Копейки, Копеек, М}},

Ниже приводится фрагмент текста файла, содержащий образец прописи для валюты женского рода (добавляется параметр F в описание названия валюты):

{Speller,

{Money,

{условная единица, Условные единицы, Условных единиц, Сотая, Сотые,

Сотых, F}},

Кроме того, в параметре Образец может быть передан объект типа «СписокЗначений», содержащий в качестве своих значений объекты типа «Список-Значений» каждый из которых содержит набор слов используемых в прописи определенного типа. Типы прописей соответвуют секциям файла SPL:

Money

Numbers

Date

DateRange

WeekDay

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

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

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

Пример:

Процедура Печать(Тип)

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

   // ...

   Пропись(1cue.spl); // задаем имя файла прописи

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

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

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

   Пропись();

   // возвращаем значение прописи по умолчанию

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

Формат

Форматировать переданный параметр.

Синтаксис:

Формат(Параметр, Форматная_строка)

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

Format

Параметры:

Параметр	Выражение.
Форматная_строка	Строковое выражение.

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

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

Описание:

Функция Формат форматирует переданный параметр, руководствуясь информацией, содержащейся в параметре Форматная_строка. Возвращает сформатированную строку.

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

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

Символы, определяющие тип форматируемых данных:

Ч — число (Англоязычный синоним: N)

С — строка (Англоязычный синоним: S)

Д — дата (Англоязычный синоним: D)

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

Для числовых значений форматная строка должна иметь вид: Чm.nDT или Чm, где т и п— целые числа. Целое положительное число m определяет длину поля в котором будет размещаться строковое представление числа, а целое положительное число n определяет число знаков после десятичной точки. D — представляет собой любой символ (кроме пробела и цифры), которым в сфор-матированной строке целая часть будет отделяться от дробной, а T — символ (также кроме пробела и цифры), которым будут разделяться триады целой части числа. Символы D и Т являются необязательными.

Если в форматной строке проставить символ 0 (ноль) перед длиной поля, то нулевые значения при выводе будут подавлятся (выводится пустая строка). Пример: Ч015.2.

Если в форматной строке указано (0) перед всеми прочими спецификациями, то все позиции в поле вывода числа, соответствующие незадействованным старшим разрядам будут заполнены символами 0. Например:

Формат(123.15, Ч(0)10.2) = 0000123.15

Если в форматной строке проставить символ - перед длиной поля, то нулевые значения при выводе будут отображаться прочерком. Пример: 4-17.2 .

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

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

Кроме того, возможен вывод денежных величин и просто целых чисел прописью. В этом случае форматная строка должна иметь вид ЧПДС. Наличие буквы П (в английском варианте для аналогичной цели используется буква S) определяет сам факт вывода числа прописью. Символ Д (в английском варианте — M) обозначает вывод денежной величины и является необязательным. Символ С (в английском варианте — H) также необязателен и означает вывод с копейками.

Для форматирования строк используется следующая форматная строка:

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

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

DDMMYY (ДДММГГ)	дата в виде ДД.ММ.ГГ
DDMMYYYY (ДДММГГГГ)	дата в виде ДД.ММ.ГГГГ
DDMMMMYYYY (ДДММММГГГГ)	дата в виде ДД месяц прописью ГГГГ
(0)DDMMMMYYYY ((0)ДДММММГГГГ)	этот формат представляет собой вариант предыдущего формата с тем отличием, что число месяца всегда выводится двумя цифрами, т. е. для чисел меньших 10 спереди будет добавлен 0. Например: Формат('01.01.1999', ' 'Д(0)ДДММММГГГГ' ') = 01 Января 1999 г.
MMMMYYYY (ММММГГГГ)	дата в виде месяц прописью ГГГГ
MMMMYY (ММММГГ)	дата в виде месяц прописью ГГ
ММММ (ММММ)	дата в виде месяц прописью
QQQQYYYY (ККККГГГГ)	дата в виде N квартала ГГГГ
QQQQYY (ККККГГ)	дата в виде N квартала ГГ
QQQQ	дата в виде N квартала
YYYYMMDD (ГГГГММДД)	дата в виде ГГГГММДД, то есть дата '10.11.1998' будет представлена как строка 19981110
WWWW (HHHH)	выводит наименование дня недели, соответствующее указанной дате. Наименования дней недели берутся из файла прописи.

Пример:

ДолгКлиента = Строка(Формат(-Долг(), Ч12.2)) + + Валюта.Сокр_назв;

Шаблон

Сформировать строку по шаблону.

Синтаксис:

Шаблон(Строка_шаблон)

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

Template

Параметры:

Строка_шаблон

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

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

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

Описание:

Функция Шаблон возвращает строковое значение, сформированное в соответствии с заданным параметром Строка_шаблон, заменив в ней все встроенные выражения, заключенные в квадратные скобки, на их строковые значения.

Строковое значение параметра Строка_шаблон обрабатывается следующим образом: символы [ , ] (квадратные скобки) являются специальными символами, которые выделяют поля, содержащие встроенные выражения. Например:

Имя клиента [Имя], телефон: [Телефон]

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

Пример:

Стр = Шаблон(Это название услуги: [Услуга.Наименование]);

// выдает: Это название услуги: Вывоз мусора

ФиксШаблон

Сформировать строку по фиксированному шаблону.

Синтаксис:

ФиксШаблон(Строка_шаблон)

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

FixTemplate

Параметры:

Строка_шаблон

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

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

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

Описание:

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

Строковое значение параметра Строка_шаблон обрабатывается следующим образом: символы [ , ] (квадратные скобки) являются специальными символами, которые выделяют поля, содержащие встроенные выражения. Выделенные поля фиксируют свою длину с учетом ограничивающих скобок. Например:

Имя Клиента [Имя], телефон: [Телефон]

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

Пример:

// ниже - пример с дополнением пробелами

Стр = Шаблон(Это название услуги [Услуга.Наименование       ]);

//   выдает: Это название услуги Вывоз мусора

// далее - с сокращением строки

Стр = Шаблон(Это название услуги [Услуга.Наименование]);

//   выдает: Это название услуги Выполенние формирован

Функции для вызова диалога ввода данных

ВвестиЗначение

Вызов диалога для ввода значения заданного типа.

Синтаксис:

ВвестиЗначение(3начение, Подсказка, Тип, Длина, Точность)

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

InputValue

Параметры:

3начение	Имя переменной, ранее объявленной в программном модуле. В эту переменную будет помещено введенное значение.
Подсказка	Текст заголовка окна диалога ввода. Может использоваться в качестве подсказки конечному пользователю.
Тип	Строковое выражение — название типа данных, которое требуется ввести. Например: Строка, Число, Справочник.Товары, Документ . РасходнаяНакладная и т. п.
Длина	Необязательный параметр. Длина вводимого значения (для типов данных «Строка», «Число»).
Точность	Необязательный параметр. Количество знаков после десятичной точки (для типа данных «Число»).

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

Числовое значение: 1 — если в диалоге нажата кнопка «ОК»; 0 — если нажата кнопка «Отмена»;

Описание:

Функция ВвестиЗначение выполняет вызов диалога для ввода значения заданного типа.

Пример:

Если ВвестиЗначение(Ном, Введите номер приказа, Число, 5, 0) = 1 Тогда

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

   ВыбДок.НайтиПоНомеру(Строка(Ном), Дата(0));

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

      // . . .

   ИначеЕсли;

      // . . .

   КонецЕсли;

КонецЕсли;

ВвестиЧисло

Вызов диалога для ввода числа.

Синтаксис:

ВвестиЧисло(Число, Подсказка, Длина, Точность , Таймаут)

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

InputNumeric

Параметры:

Число	Имя переменной, ранее объявленной в программном модуле. В эту переменную будет помещено введенное значение числа.
Подсказка	Текст заголовка окна диалога ввода. Может использоваться в качестве подсказки конечному пользователю.
Длина	Длина вводимого числа.
Точность	Количество знаков после десятичной точки.
Таймаут	Необязательный параметр. Числовое выражение интервала времени ожидания ответа в секундах, в течение которого система будет ожидать ответа пользователя. Если данный параметр опущен или равен 0, то время ожидания бесконечно. Значение по умолчанию — 0.

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

Числовое значение: 1 — если в диалоге нажата кнопка «ОК»; 0 — если нажата кнопка «Отмена»; -1 (минус единица) — если закончилось время ожидания ответа.

Описание:

Функция ВвестиЧисло выполняет вызов диалога для ввода числа.

Пример:

Если ВвестиЧисло(Ном, Введите номер приказа, 5, 0, 10) = 1 Тогда

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

   ВыбДок.НайтиПоНомеру(Строка(Ном), Дата(0));

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

      // . . .

   ИначеЕсли;

      // . . .

   КонецЕсли;

КонецЕсли;

ВвестиСтроку

Вызов диалога для ввода строки.

Синтаксис:

ВвестиСтроку(Строка, Подсказка, ДлинаСтроки, Признак, Таймаут)

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

InputString

Параметры:

Строка	Имя переменной, ранее объявленной в программном модуле. В эту переменную будет помещено введенное строковое значение.
Подсказка	Текст заголовка окна диалога ввода. Может использоваться в качестве подсказки конечному пользователю.
ДлинаСтроки	Числовое выражение — длина строки.
Признак	Необязательный параметр. Числовое выражение, если 0 — ввод простой строки без разделителей строк, если 1 — ввод многострочного текста с разделителями строк. Значение по умолчанию — 0.
Таймаут	Необязательный параметр. Числовое выражение интервала времени ожидания ответа в секундах, в течение которого система будет ожидать ответа пользователя. Если данный параметр опущен или равен 0, то время ожидания бесконечно. Значение по умолчанию — 0.

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

Числовое значение: 1 — если в диалоге нажата кнопка «ОК», 0 — если нажата кнопка «Отмена»; -1 (минус единица) — если закончилось время ожидания ответа.

Описание:

Функция ВвестиСтроку выполняет вызов диалога для ввода строки.

Пример:

Процедура ВводКодовПродукции()

   Если Продукция.Вид = Перечисление.ВидПродукции.Наша Тогда

      НК = Код;

      Если ВвестиСтроку(НК, Введите код продукции, 40, 1, 9) = 1 Тогда

         Koд = HK;

      КонецЕсли;

   Иначе

      Код = ;

      Возврат;

   КонецЕсли;

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

ВвестиДату

Вызов диалога для ввода даты.

Синтаксис:

ВвестиДату(Дата, Подсказка, Таймаут)

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

InputDate

Параметры:

Дата	Имя переменной, ранее объявленной в программном модуле. В эту переменную будет помещено введенное значение даты.
Подсказка	Текст заголовка окна диалога ввода. Может использоваться в качестве подсказки конечному пользователю.
Таимаут	Необязательный параметр. Числовое выражение интервала времени ожидания ответа в секундах, в течение которого система будет ожидать ответа пользователя. Если данный параметр опущен или равен 0, то время ожидания бесконечно. Значение по умолчанию — 0.

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

Числовое значение: 1 — если в диалоге нажата кнопка «ОК»; 0 — если нажата кнопка «Отмена»; -1 (минус единица) — если закончилось время ожидания ответа.

Описание:

Функция ВвестиДату выполняет вызов диалога для ввода даты.

Пример:

Процедура ВводДатыСсуды()

   Если ВидРасчета = ВидРасчета.БеспроцентнаяСсуда Тогда

      ДатаСсуды = Дата(0);

      Возврат;

   КонецЕсли;

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

      ДатаСсуды = ДатаДок + 30;

   КонецЕсли;

   Д = ДатаСсуды;

   Если ВвестиДату(Д, Введите дату ссуды) = 1 Тогда

      ДатаСсуды = Д;

   Иначе

      ВидРасчета = ВидРасчета.БеспроцентнаяСсуда;

   КонецЕсли;

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

ВвестиПериод

Ввод периода в виде диалога.

Синтаксис:

ВвестиПериод(НачалоПериода, КонецПериода, Подсказка)

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

InputРег1od

Параметры:

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

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

Числовое значение: 1 — выбор осуществлен , 0 — выбор не осуществлен (пользователем нажата кнопка «Отмена», клавиша Esc или закрыто окно диалога).

Описание:

Функция ВвестиПериод выдает на экран диалог специального вида, при помощи которого пользователь может выбрать период. Выбранный пользователем период записывается в переменные, передаваемые как параметры при вызове метода.

Пример:

Дата1 = '01.01.97';

Дата2 = '31.03.97';

Если ВвестиПериод(Дата1, Дата2, Введите период отчета) 1 Тогда

Возврат 0;

КонецЕсли;

ВвестиПеречисление

Вызов диалога для ввода перечисления.

Синтаксис:

ВвестиПеречисление(3начение, Подсказка, Таймаут)

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

InputEnum

Параметры:

3начение	Имя переменной, ранее объявленной в программном модуле. Переменная должна содержать значение типа «Перечисление» или строковое значение. Если тип передаваемого в качестве параметра значения — перечисление, то вызывается диалог со списком заданного вида перечисления. Если тип передаваемого в качестве параметра значения — строка, то в ней должен быть идентификатор требуемого вида перечисления, как он задан в конфигураторе. В эту же переменную будет помещено выбранное в диалоге значение перечисления.
Подсказка	Текст заголовка окна диалога ввода. Может использоваться в качестве подсказки конечному пользователю.
Таймаут	Необязательный параметр. Числовое выражение интервала времени ожидания ответа в секундах, в течение которого система будет ожидать ответа пользователя. Если данный параметр опущен или равен 0, то время ожидания бесконечно. Значение по умолчанию — 0.

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

Числовое значение: 1 — если в диалоге нажата кнопка «ОК», 0 — если нажата кнопка «Отмена»; -1 (минус единица) — если закончилось время ожидания ответа.

Описание:

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

Пример:

*

Процедура УстПризнак1()

   ВыбПризн = Перечисление.ТипСотрудника.Штатный;

   Если ВвестиПеречисление(ВыбПризн, Выберите тип) 0 Тогда

      Тип = ВыбПризн;

   Иначе

      Тип = Перечисление.ТипСотрудника.Штатный;

   КонецЕсли;

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

*

Процедура УстПризнак2()

   ВыбПризн = ТипСотрудника;

   Если ВвестиПеречисление(ВыбПризн, Выберите тип) 0 Тогда

      Тип = ВыбПризн;

   Иначе

      Тип = Перечисление.ТипСотрудника.Штатный;

   КонецЕсли;

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

Процедуры и функции общего назначения

Вопрос

Вывести окно вопроса.

Синтаксис:

Вопрос(Текст_вопроса, Режим, Таймаут)

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

DoQueryBox

Параметры:

Текст_вопроса	Строковое выражение текста вопроса.
Режим	Числовое или строковое выражение, определяющее режим вывода окна вопроса.
Таймаут	Необязательный параметр. Числовое выражение интервала времени ожидания ответа в секундах, в течение которого система будет ожидать ответа пользователя. Если данный параметр опущен или равен 0, то время ожидания бесконечно. Значение по умолчанию — 0.

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

Если параметр Режим задан числовым значением, то функция возвращает числовое значение:

-1	Закончилось время ожидания ответа.
1	Выбрана кнопка «ОК».
2	Выбрана кнопка «Отмена».
3	Выбрана кнопка «Стоп».
4	Выбрана кнопка «Повтор».
5	Выбрана кнопка «Пропустить».
6	Выбрана кнопка «Да».
7	Выбрана кнопка «Нет».

Если параметр Режим задан строковым значением, то функция возвращает строковое значение. Язык для возврата такой же, какой использован в пара-метре Режим.

Русск. яз.	Англ.яз.	Описание
Таймаут	Timeout	Закончилось время ожидания ответа.
ОК	ОК	Выбрана кнопка «ОК».
Отмена	Cancel	Выбрана кнопка «Отмена».
Стоп	Abort	Выбрана кнопка «Стоп».
Повтор	Retry	Выбрана кнопка «Повтор».
Пропустить	Ignore	Выбрана кнопка «Пропустить».
Да	Yes	Выбрана кнопка «Да».
Нет	No	Выбрана кнопка «Нет».

Описание:

Функция Вопрос выводит на экран окно вопроса. Текст определяется параметром Текст_вопроса. Параметр Режим определяет варианты возможных ответов.

Если параметр Режим задан числовым значением, то возможные варианты передаваемого параметра:

0	Кнопка «ОК».
1	Кнопки «ОК» и «Отмена».
2	Кнопки «Стоп», «Повтор», «Пропустить».
3	Кнопки «Да», «Нет», «Отмена».
4	Кнопки «Да», «Нет».
5	Кнопки «Повтор», «Отмена».

Любое другое числовое значение параметра Режим эквивалентно значению 0 (кнопка «ОК»), равно как и отсутствие указанного параметра.

Если параметр Режим задан строковым значением, то возможные варианты передаваемого параметра:

Русскоязычное написание	Англоязычное написание
ОК	ОК
ОК+Отмена	OK+Cancel
Стоп+Повтор+Пропустить	Abort+Retry+Ignore
Да+Нет+Отмена	Yes+No+Cancel
Да+Нет	Yes+No
Повтор+Отмена	Retry+Cancel

Пример:

Рез = Вопрос(Вы получили данное сообщение?, 4);

Если Вопрос(Все нормально?, Да+Нет) = Да Тогда

// . . .

КонецЕсли;

Предупреждение

Вывести окно предупреждения.

Синтаксис:

Предупреждение(Текст_сообщения, Таймаут)

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

DoMessageBox

Параметры:

Текст_сообщения

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

Таймаут

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

Описание:

Процедура Предупреждение выводит на экран окно предупреждения (MessageBox). Текст определяется параметром Текст_сообщения. По поведению данная процедура эквивалентна функции:

Вопрос(Текст_сообщения, 0, Таймаут), но не возвращает значения.

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

Пример:

// Выводим сообщение 5 секунд

Предупреждение(Доброе утро!, 5);

Сообщить

Вывести строку в окно сообщений.

Синтаксис:

Сообщить(Текст_сообщения, ИмиджМаркера)

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

Message

Параметры:

Текст_сообщения	Строковое выражение.
ИмиджМаркера	Необязательный параметр. Строковое выражение, которое задает тип пиктограммы выводимой перед сообщением. Возможные значения: I, !, !!, !!!, . — обычное сообщение, — без маркера.

Описание:

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

Пример:

Сообщить(Доброе утро!, I);

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

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

Синтаксис:

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

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

ClearMessageWindow

Описание:

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

Пример:

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

Состояние

Вывести сообщение в строку состояния.

Синтаксис:

Состояние(Текст_сообщения)

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

Status

Параметры:

Текст_сообщения

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

Описание:

Процедура Состояние выводит строку текста в строку состояния (статус-бар). Текст определяется параметром Текст_сообщения.

Пример:

Состояние(Доброе утро!)

? (вычислить выражение по условию)

Вычислить выражение по условию.

Синтаксис:

?(Логич_выраж, Выраж1, Выраж2)

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

?

Параметры:

Логич_выраж	Логическое выражение.
Выраж1	Выражение.
Выраж2	Выражение.

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

Результирующее значение.

Описание:

Функция ? вычисляет значение Логич_выраж и если его значение — истина, то возвращает вычисленное значение Выраж1. Если значение Логич_выраж — ложь, то возвращает вычисленное значение Выраж2.

Пример:

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

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

   Состояние(Спр.Наименование);

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

   Sec = ?(Спр.ЭтоГруппа = 1, Folder, DL);

   Таб.ВывестиСекцию(Sес + -V1);

   Таб.ПрисоединитьСекцию(Sec + -V3);

КонецЦикла;

Сигнал

Вывести звуковой сигнал.

Синтаксис:

Сигнал()

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

Веер

Описание:

Процедура Сигнал издает короткий звуковой сигнал.

Пример:

Сигнал();

Разм

Определить размерность массива.

Синтаксис:

Разм(Имя_массива)

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

Dim

Параметры:

Имя_массива

Идентификатор массива.

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

Числовое значение размерности массива.

Описание:

Функция Разм возвращает числовое значение размерности массива переданного в качестве параметра.

Пример:

Перем Массив_для_хранения[10];

Размер = Разм(Массив_для_хранения);

Функции среды исполнения

ЗаголовокСистемы

Получить/установить заголовок окна программы.

Синтаксис:

ЗаголовокСистемы(3аголовок)

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

SystemCaption

Параметры:

Заголовок

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

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

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

Описание:

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

Пример:

ЗаголовокСистемы(Оптово-розничная конфигурация)

ИмяКомпьютера

Получить сетевое имя компьютера.

Синтаксис:

ИмяКомпьютера()

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

ComputerName

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

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

Описание:

Функция ИмяКомпьютера возвращает сетевое имя компьютера, работающего в данный момент с программой.

Пример:

Компьютер = ИмяКомпьютера();

ИмяПользователя

Получить имя пользователя.

Синтаксис:

ИмяПользователя()

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

UserName

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

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

Описание:

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

Пример:

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

Спр.НайтиПоКоду(ИмяПользователя());

Менеджер = Спр.ТекущийЭлемент();

Если Менеджер.Выбран() = 0 Тогда

Предупреждение(Не выбран менеджер!);

КонецЕсли;

ПолноеИмяПользователя

Получить полное имя пользователя.

Синтаксис:

ПолноеИмяПользователя()

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

UserFullName

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

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

Описание:

Функция ПолноеИмяПользователя возвращает полное имя пользователя, указанное в конфигураторе при авторизации доступа.

Пример:

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

Спр.НайтиПоНаименованию(ПолноеИмяПользователя());

Менеджер = Спр.ТекущийЭлемент();

Если Менеджер.Выбран() = 0 Тогда

Предупреждение(Не выбран менеджер!);

КонецЕсли;

НазваниеНабораПрав

Получить название набора прав пользователя.

Синтаксис:

НазваниеНабораПрав(ВыдИспНабПрав)

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

RightName

Параметры:

ВыдИспНабПрав

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

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

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

Описание:

Функция НазваниеНабораПрав возвращает название набора прав, заданное пользователю в конфигураторе.

Пример:

МоиПрава = НазваниеНабораПрав();

ПравоДоступа

Проверяет для текущего пользователя наличие права доступа для заданного объекта.

Синтаксис:

ПравоДоступа(НазваниеПрава, Объект)

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

AccessRight

Параметры:

НазваниеПрава	Строка с названием права доступа, как оно выводится в конфигурации (без пробелов).
Объект	Строка с наименованием типа и вида объекта (записывается через точку). Для глобальных прав этот параметр не указывается. Для объектов, у которых нет вида, записывается только тип объекта, например, «Операция».

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

Число: 1 — если право доступа есть, иначе 0.

Описание:

Функция ПравоДоступа проверяет для текущего пользователя наличие права доступа для заданного объекта.

Пример:

Доступ = ПравоДоступа(Чтение, Документ.Счет);

Доступ1 = ПравоДоступа(МонопольныйРежим);

НазваниеИнтерфейса

Получить название интерфейса пользователя.

Синтаксис:

НазваниеИнтерфейса()

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

UserInterfaceName

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

Строковое значение, содержащее название интерфейса пользователя.

Описание:

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

Пример:

МойИнтерфейс = НазваниеИнтерфейса();

КаталогПользователя

Получить каталог пользователя.

Синтаксис:

КаталогПользователя()

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

UserDir

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

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

Описание:

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

Пример:

МояДиректория = КаталогПользователя();

КаталогИБ

Получить каталог базы данных.

Синтаксис:

КаталогИБ()

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

IBDir

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

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

Описание:

Функция КаталогИБ возвращает имя каталога базы данных.

Пример:

МояБД = КаталогИБ();

КаталогПрограммы

Получить каталог программы.

Синтаксис:

КаталогПрограммы()

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

BinDir

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

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

Описание:

Функция КаталогПрограммы возвращает имя каталога, где размещены исполняемые файлы системы 1С:Предприятие.

Пример:

МояДирПрог = КаталогПрограммы();

КаталогВременныхФайлов

Получить каталог временных файлов.

Синтаксис:

КаталогВременныхФайлов()

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

TempFilesDir

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

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

Описание:

Функция КаталогВременныхФайлов возвращает имя каталога временных файлов, как он установлен в системе 1С:Предприятие. Это может быть каталог, установленный в командной строке запуска системы или, если не указан, то каталог временных файлов установленный в операционной системе.

Пример:

МояВремДир = КаталогВременныхФайлов();

МонопольныйРежим

Определение режима работы программы.

Синтаксис:

МонопольныйРежим()

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

ExclusiveMode

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

Число 1 — если программа запущена в монопольном режиме;

Число 0 — если программа запущена в сетевом режиме.

Описание:

Функция МонопольныйРежим возвращает число 1 — если программа запущена в монопольном режиме и 0 если нет.

Пример:

Процедура Загрузка()

   Если МонопольныйРежим() 0 Тогда

    ЗагрузитьНаряды();

   Иначе

      Предупреждение(Для запуска этой операции требуется +

                     монопольный режим доступа !!!);

   КонецЕсли;

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

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

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

Синтаксис:

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

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

GeneralLanguage

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

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

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

Описание:

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

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

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

Пример:

*

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

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

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

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

   Иначе

      СПР = Reference;

   КонецЕсли;

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

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

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

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

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

   КонецЕсли;

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

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

Процедуры работы с транзакциями

Понятие транзакций соответствует общепринятому пониманию транзакций баз данных. В системе 1С:Предприятие транзакции активно используются самой системой при записи различной информации. Транзакция гарантирует неизменность информации в базе данных для других пользователей до ее завершения и целостное сохранение информации.

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

Для начала транзакции используется процедура НачатьТранзацию. Для фиксации сделанных в процессе выполнения изменений применяется процедура ЗафиксироватьТранзакцию. Для отмены изменений, сделанных в процессе выполнения транзакции — процедура ОтменитьТранзакцию. Таким образом, все действия с базой данных, выполняемые внутри скобок: НачатьТранзакцию — ЗафиксироватьТранзацию собственно и являются транзакцией.

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

Замечание. В Модуле документа (при проведении документов) в предопределенных процедурах ОбработкаПроведения и ОбработкаУдаленияПроведения система сама по умолчанию выполняет все действия через транзакцию, поэтому никаких специальных действий в этих предопределенных процедурах предпринимать не нужно.

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

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

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

Открыть обработку транзакции.

Синтаксис:

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

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

BeginTransaction

Описание:

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

Пример:

Процедура УдалитьПустые()

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

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

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

   Пока Спр.ПолучитьЭлемент() = 1 Тогда

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

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

      КонецЕсли;

   КонецПока;

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

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

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

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

Синтаксис:

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

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

CoinmitTransation

Описание:

Процедура ЗафиксироватьТранзакцию завершает успешную транзакцию.

Пример:

Процедура УдалитьПустые()

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

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

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

   Пока Спр.ПолучитьЭлемент() = 1 Тогда

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

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

      КонецЕсли;

   КонецПока;

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

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

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

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

Синтаксис:

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

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

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 Тогда

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

   Иначе

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

   КонецЕсли;

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

Специальные процедуры и функции

СоздатьОбъект

Создает объект агрегатного типа данных и возвращает ссылку на него.

Синтаксис:

СоздатъО6ъект(ИмяАгрегатногоТипа)

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

CreateObject

Параметры:

ИмяАгрегатногоТипа

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

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

Ссылка на созданный объект агрегатного типа данных.

Описание:

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

Замечание. Объекты, такие как документ и справочник, созданные при помощи функции СоздатьОбъект, изначально не определены, т. е. не содержат никакого значения. Чтобы начать с ними работать, их предварительно надо позиционировать (установить на конкретный документ или элемент справочника). Для документов позиционирование выполняется при помощи методов НайтиДокумент, НайтиПоНомеру, ПолучитьДокумент. Для справочников позиционирование выполняется при помощи методов НайтиЭлемент, НайтиПоКоду, ПолучитьЭлемент.

Пример:

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

Спр.НайтиПоКоду(029);

СтатусВозврата

Установить/определить статуса возврата предопределенной процедуры.

Синтаксис:

СтатусВозврата([Статус])

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

ReturnStatus

Параметры:

Статус

Необязательный параметр. Числовое выражение. Если задано значение 1, то устанавливается статус возврата — Выполнить Действие. Если задано значение 0, то устанавливается статус возврата — Отменить Действие. Если параметр опущен, то статус возврата предопределенной процедуры не меняется.

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

Число 1 — если статус возврата — Выполнить Действие;

Число 0 — если статус возврата — Отменить Действие.

Описание:

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

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

Замечание: Начальное значение статуса возврата предопределенной процедуры равно 1 (Выполнить Действие), которое устанавливается системой при вызове предопределенной процедуры.

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

Если параметр Статус задан явно, то после выполнения данной функции статус возврата установится в заданное значение. Пример:

* Если в предопределенной процедуре ПриЗаписи установить статус возврата — 0 (например, если неверно заполнены реквизиты), то документ не будет записываться.

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

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

      Предупреждение(Запись отменена! Не задан клиент!);

      СтатусВозврата(0);

   КонецЕсли;

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

* Если в предопределенной процедуре ВводНаОсновании установить статус возврата — 0, то ввод нового документа будет отменен и форма нового документа не откроется.

Процедура ВводНаОсновании(ДокОснование)

   Автор = Пользователь;

   ДокВид = ДокОснование.Вид();

   Если (ДокВид = Счет) ИЛИ (ДокВид = Счет_фактура)

        ИЛИ (ДокВид = РасходнаяКредит) ИЛИ (ДокВид = РасходнаяРеализ) Тогда

      Автор = Пользователь;

      ДокВид = ДокОснование.Вид();

      Фирма = ДокОснование.Фирма;

      Клиент = ДокОснование.Клиент;

      Основание = ДокВид + № + ДокОснование.НомерДок;

      Сумма = ДокОснование.Итог(Сумма);

      НДС = ДокОснование.Итог(НДС);

   Иначе

      Предупреждение(Недопустимый вид документа основания!);

      СтатусВозврата(0);

   КонецЕсли;

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

См. также: «Системные предопределенные процедуры»

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

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

Синтаксис:

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

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

OpenForm

Параметры:

Параметр1	В зависимости от типа открываемой формы используется различные значения данного параметра. Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ # с некоторым идентификатором: #LLLL. Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — идентификатор, который позволяет открыть новое окно или активизировать уже открытое с этим идентификатором. Если идентификатор не задан, то обязательно открывается новое окно.
КонтекстФормы	Необязательный параметр. Имя переменной, куда можно задать значение любого типа для передачи в открываемую форму. Данное значение будет доступно в открытой форме как атрибут Форма.Параметр. После исполнения данного метода система вернет в данную переменную контекст открытой формы (см. Передача контекста в качестве параметра). С помощью значения этого контекста можно затем произвольно манипулировать открытой формой, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.
Параметр3...	В зависимости от типа открываемой формы используется различный состав и значения остальных параметров.

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

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

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

Описание:

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

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

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

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

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

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

Документ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Элемент

Значение типа «Справочник».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Счет

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры:

Перем Конт;

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

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

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

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

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

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

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

Синтаксис:

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

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

OpenFormModal

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

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

Описание:

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

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

ТипЗначения

Получить тип значения данных.

Синтаксис:

ТипЗначения(3начение)

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

ValueType

Параметры:

3начение                Выражение, тип данных значения которого надо определить.

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

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

0 —                 неопределенный тип данных;

1 —                 числовой тип данных;

2 —                 строковый тип данных;

3 —                 тип данных — дата;

10 —                агрегатный тип данных «Перечисление»;

11 —                агрегатный тип данных «Справочник»;

12 —                агрегатный тип данных «Документ»;

13 —                агрегатный тип данных «Календарь»;

14 —                агрегатный тип данных «ВидРасчета»;

15 —                агрегатный тип данных «Счет»;

16 —                агрегатный тип данных «ВидСубконто»;

17 —                агрегатный тип данных «ПланСчетов»;

100 — так называемый внешний объект. В этот класс попадают все агрегатные объекты, не вошедшие в вышеперечисленный список, такие как «Текст», «Таблица», «Запрос», «ЖурналРасчетов» и т. п.

Описание:

Функция ТипЗначения определяет, к какому типу данных принадлежит переданный параметр 3начение и возвращает числовой результат:

Пример:

Если ТипЗначения(Код)1 Тогда

   Предупреждение(Код имеет не числовой тип !!!);

КонецЕсли;

ТипЗначенияСтр

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

Синтаксис:

ТипЗначенияСтр(3начение)

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

ValueTypeStr

Параметры:

3начение Выражение, тип данных значения которого надо определить.

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

Функция возвращает строковое значение в русскоязычном или в англоязычном написании — в зависимости от текущей установки основного языка конфигурации:

Русскоязычное	Англоязычное	Описание
Неизвестный Объект	UnknownObject	неопределенный тип данных;
Число	Number	числовой тип данных;
Строка	String	строковый тип данных;
Дата	Date	тип данных — дата;
Перечисление	Enum	агрегатный тип данных «Перечисление»;
Справочник	Reference	агрегатный тип данных «Справочник»;
Документ	Document	агрегатный тип данных «Документ»;
Регистр	Register	агрегатный тип данных «Регистр»;
Календарь	Calendar	агрегатный тип данных «Календарь»;
ВидРасчета	Calculation	агрегатный тип данных «ВидРасчета»;
ЖурналРасчетов	CalcJournal	агрегатный тип данных «ЖурналРасчетов»;
ПланСчетов	ChartOfAccounts	агрегатный тип данных «ПланСчетов»;
Счет	Account	агрегатный тип данных «Счет»,
Операция	Operation	агрегатный тип данных «Операция»;
КорректныеПроводки	CorrectEntries	агрегатный тип данных «КорректныеПроводки»;
БухгалтерскиеИтоги	BookkeepingTotals	агрегатный тип данных «БухгалтерскиеИтоги»;
Таблица	Table	агрегатный тип данных «Таблица»;
Текст	Text	агрегатный тип данных «Текст»;
Запрос	Query	агрегатный тип данных «Запрос»;
СписокЗначений	ValueList	агрегатный тип данных «СписокЗначений»;
ТаблицаЗначений	ValueTable	агрегатный тип данных «ТаблицаЗначений»;
Периодический	Рег1odic	агрегатный тип данных «Периодический»;
Картинка	Picture	агрегатный тип данных «Картинка»;
ГрупповойКонтекст	GroupContext	локальный контекст программного модуля, передаваемый при помощи ключевого слова Контекст или возвращаемый методом ОткрытьПодбор;
OLE	OLE	OLE-объект;

Описание:

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

Пример:

Предупреждение(Код имеет тип - + ТипЗначенияСтр(Код));

См. также: ОсновнойЯзык

ПустоеЗначение

Проверить значение любого типа.

Синтаксис:

ПустоеЗначение(3начение)

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

Empty Value

Параметры:

3начение Выражение любого типа данных, значение которого проверяется на «пустое».

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

Функция возвращает числовое значение: 1 — значение пустое; 0 — значение не пустое.

Описание:

Функция ПустоеЗначение определяет, является ли пустым переданное в параметре значение. При этом применяется следующее правило:

- значение неопределенного типа — всегда пустое;

- значение типа «строка» проверяется как в методе ПустаяСтрока;

- значение типа «число» проверяется на равенство нулю;

- значение типа «дата» проверяется на пустое значение;

- значения следующих типов: «справочник», «перечисление», «документ», «счет», «вид субконто», «план счетов», «календарь» проверяются как в методах Выбран для соответствующего типа объекта.

Пример:

Если ПустоеЗначение(Код) = 1 Тогда

Предупреждение(Задайте непустое значение Кода !!!);

КонецЕсли;

ПолучитьПустоеЗначение

Получить пустое значение заданного типа данных.

Синтаксис:

ПолучитьПустоеЗначение(Тип)

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

GetEmptyValue

Параметры:

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

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

Функция ПолучитьПустоеЗначение возвращает пустое значение заданного типа данных.

Описание:

Функция возвращает пустое значение заданного типа данных.

Пример:

Если ВыбФирма = ПолучитьПустоеЗначение(Справочник.Фирмы) = 1 Тогда

Предупреждение(Задайте непустое значение Фирмы);

КонецЕсли;

НазначитьВид

Для значений типа «Документ неопределенного вида», «Справочник неопределенного вида», «Счет неопределенного вида» назначает конкретный вид.

Синтаксис:

НазначитьВид(3начение, Вид)

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

SetKind

Параметры:

3начение

Значение типа документ/справочник/счет неопределенного вида — обычно реквизит документа, справочника или диалога формы.

Вид

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

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

Описание:

Процедура НазначитьВид используется для установки значениям типа «Документ неопределенного вида», «Справочник неопределенного вида», «Счет неопределенного вида» конкретный вид. При этом, если существующее значение не соответсвует вновь установленному виду — то оно очищается.

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

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

Пример:

* Например, реквизиту документа «Контрагент» типа справочник неопределенного вида, в зависимости от значений других реквизитов можно установить вид «Организации» или «Сотрудники».

Процедура ВводНаОсновании(ДокОсн)

   Если ДокОсн.Вид() = Счет Тогда

      НазначитьВид(Контрагент, «Организации»);

   Иначе

      НазначитВид(Контрагент, «Сотрудники»);

   КонецЕсли;

   Форма.Контрагент.НеИзменятьВид(1);

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

ЗаписьЖурналаРегистрации

Выводит строку текста в системный журнал регистрации.

Синтаксис:

ЗаписьЖурналаРегистрации(Коммент, ТипСобытия, Событие, Объект,

Категория)

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

LogMessageWrite

Параметры:

Коммент	Строковое выражение, комментарий к событию. Если этот параметр — единственный переданный при вызове метода, то тогда в журнал записывается стандартное дополнительное событие с указанным комментарием.
ТипСобытия	Необязательный параметр. Строковое выражение -тип события. По умолчанию или при пустой строке «Дополнительные события».
Событие	Необязательный параметр. Строковое выражение -событие. По умолчанию «Дополнительное событие».
Объект	Необязательный параметр. Объект события, по умолчанию отсутствует. Для переданных в функцию объектов типа Документ/ Справочник/ Счет представление объекта будет записано автоматически (это не зависит от типа события и самого события).
Категория	Необязательный параметр. Число — категория события: 1 — администрирование; 2 — изменение данных; 3 — информация; 4 — предупреждение; 5 — ошибка. Значение по умолчанию 3.

Описание:

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

Системой зарезервированы следующие типы событий/события:

Документ / Открыт	Справочник/СнятаПометакаНаУдаление
Документ / Новый
Документ / Удален	Константа / ЗначениеЗаписано
Документ / Записан	Константа / ЗначениеУдалено
Документ / НаЗаписан
Документ / Проведен	ЖурналРасчетов / ИзмененРасчетныйПериод
Документ / ПроведенЗаднимЧислом	ЖурналРасчетов / ОткатНазадРасчетногоПериода
Документ / НеПроведен	ЖурналРасчетов / НеудачнаяПопыткаИзмененияПериода
Документ / СделанНеПроведенным	ЖурналРасчетов / ОтменаРучногоРедактированияРезультата
Документ / ЗаписанИПроведенЗаднимЧислом	ЖурналРасчетов / ИзмененРезультат
Документ / ЗаписанИПроведен
Документ / ПомеченНаУдаление	Счет / ЗаписанНовый
Документ / СнятаПометакаНаУдаление	Счет / Записан
Документ / ИзмененаОперацияДокумента	Счет / ЗначениеРеквизитаЗаписано
Документ / ПроводкиВключены	Счет / ЗмачениеРеквизитаУдалено
Документ / ПроводкиВыключены	Счет / Удален
Документ / ИзмененоВремя	Счет / ПомеченНаУдаление
Справочник / ЗаписанНовый	Счет / СнятаПометакаНаУдаление
Справочник / Записан
Справочник / Удален	КорректнаяПроводка / ЗаписанаНовая
Справочник / ЗначениеРеквизитаЗаписано	КорректнаяПроводка / Записана
Справочник / ЗначениеРеквизитаУдалено	КорректнаяПроводка / Удалена
Справочник / ПеренесенВДругуюГруппу
Справочник / ПомеченНаУдаление	ОбщиеСобытия / ИзменениеТА

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

Пример:

ЗаписьЖурналаРегистрации(Доброе утро!)

ПрефиксАвтоНумерации

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

Синтаксис:

ПрефиксАвтоНумерации(ИмяВида, Префикс)

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

AutoNumPrefix

Параметры:

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

Описание:

Процедура ПрефиксАвтоНумерации устанавливает префикс для автоматического создания новых номеров документов или кодов элементов справочника.

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

ПрефиксАвтоНумерации(Документ.*, ПР-)

Пример:

ПрефиксАвтоНумерации(Документ.РасходнаяНакл, Рн-);

См. также: ПрефиксНомера, ПрефиксКода, УстановитьНовыйНомер, УстановитьНовыйКод.

ПолучитьЗначенияОтбора

Выбирать все существующие значения отбора.

Синтаксис:

ПолучитьЗначенияОтбора(ИмяОтбора, СписокЗначений , [ДатаНач], [ДатаКон])

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

GetSelect ionValues

Параметры:

ИмяОтбора	Строковое выражение с полным названием общего реквизита документа или графы отбора, как он назван в конфигурации.
СписокЗначений	Идентификатор переменной. Если при вызове метода данная переменная содержит объект типа «СписокЗначений», то система заполнит его всеми возможными существующими значениями отбора. Если при вызове метода данная переменная содержит любое другое значение кроме объекта типа «СписокЗначений», то система сама создаст объект типа «СписокЗначений», заполнит его существующими значениями отбора и присвоит переменной ссылку на этот объект.
ДатаНач	Необязательный параметр. Дата начала интервала в котором проводить отбор. Если параметр не задан, то отбор будет производиться по всем данным.
ДатаКон	Необязательный параметр. Дата конца интервала в котором проводить отбор. Если параметр не задан или равен 0, то отбор будет производиться до ТА.

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

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

Описание:

Функция ПолучитьЗначенияОтбора выбирает все возможные существующие значения отбора ИмяОтбора, заполняет выбранными значениями объект типа «СписокЗначений», и передает ссылку на этот объект в переменной СписокЗначений.

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

Пример:

// Выбрать существующие значения Авторов документов

ПолучитьЗначенияОтбора(Автор, Спис, , );

См. также: «Работа со Списком Значений»

КомандаСистемы

Вызывает на исполнение команду DOS.

Синтаксис:

КомандаСистемы(СтрокаКоманды)

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

System

Параметры:

СтрокаКоманды

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

Описание:

Процедура КомандаСистемы вызывает на исполнение команду, как если бы она была введена в командной строке DOS. При выполнении команды загружается исполняемый файл как «верхняя», активная программа.

Если загружается Windows-приложение, то управление немедленно возвращается в систему 1С:Предприятие на следующий за оператором КомандаСистемы оператор и система продолжает выполняться как фоновая прикладная программа. Пользователь может возвратиться в запускающую программу или закончив выполнение запущенной, или переключившись обратно посредством списка задач Windows.

Если в параметре СтрокаКоманды не содержится путь к загружаемой программе в файловой системе к программе, то поиск происходит в следующей последовательности:

- текущий системный каталог;

- каталог Windows;

- системный каталог Windows;

- все каталоги, указанные в переменной PATH;

Пример:

* В данном примере запускается редактор текста notepad.exe и в него загружается файл textl. txt.

КомандаСистемы(notepad textl.txt);

ЗапуститьПриложение

Выполняет запуск внешнего приложения.

Синтаксис:

ЗапуститьПриложение(СтрокаКоманды)

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

RunApp

Параметры:

СтрокаКоманды

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

Описание:

Процедура ЗапуститьПриложение вызывает запуск внешнего приложения. В отличие от функции КомандаСистемы запуск приложения выполняется непосредственно, минуя командный интерпретатор. При выполнении команды исполняемый файл загружается как «верхняя», активная программа.

Процедура, кроме того, может открыть файл с помощью ассоциированного для данного вида файлов приложения. (При условии, что таковое установлено на данном компьютере).

Если загружается Windows-приложение, то управление немедленно возвращается в систему 1С:Предприятие на следующий за оператором ЗапуститьПриложение оператор и система продолжает выполняться как фоновая прикладная программа. Пользователь может возвратиться в запускающую программу или закончив выполнение запущенной, или переключившись обратно посредством списка задач Windows.

Если в параметре СтрокаКоманды не содержится путь к загружаемой программе в файловой системе к программе, то поиск происходит в следующей последовательности:

- текущий системный каталог;

- каталог Windows;

- системный каталог Windows;

- все каталоги, указанные в переменной PATH;

Пример:

* В данном примере запускается редактор текста notepad.exe и в него загружается файл textl. txt.

ЗапуститьПриложение(notepad textl.txt);

ЗавершитьРаботуСистемы

Выполняет запуск внешнего приложения.

Синтаксис:

ЗавершитьРаботуСистемы(ФлагСохранения)

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

ExitSystem

Параметры:

ФлагСохранения

Необязательный параметр. Флаг запроса сохранения открытых объектов. Если 0, то не запрашивается сохранение не записанных документов, элементов справочников и т. п. Если 1, то сохранение запрашивается. Значение по умолчанию 1.

Описание:

Процедура ЗавершитьРаботуСистемы вызывает завершение работы системы.

Пример:

ЗавершитьРаботуСистемы(0);

НайтиПомеченныеНаУдаление

Находит все помеченные на удаление объекты.

Синтаксис:

НайтиПомеченныеНаУдаление(Объекты)

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

FindMarkedForDelete

Параметры:

Объекты

Идентификатор объекта типа «СписокЗначений», в который данная процедура помещает найденные объекты.

Описание:

Процедура НайтиПомеченныеНаУдаление находит все помеченные на удаление объекты и помещает их в список значений.

Пример:

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

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

НайтиСсылки

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

Синтаксис:

НайтиСсылки(Объекты, Ссылки)

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

FindReferences

Параметры:

Объекты

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

Ссылки

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

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

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

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

Описание:

Процедура НайтиСсылки находит ссылки на переданные в списке объекты, и помещает их в таблицу значений.

Пример:

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

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

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

НайтиСсылки(Список, ТаблицаСсылок);

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

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

Синтаксис:

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

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

DeleteObjects

Параметры:

Объекты	Конкретное значение объекта или объект типа «СписокЗначений», в котором данной процедуре передаются объекты, которые надо удалить.
Проверять	Необязательный параметр. Число: 1 — перед удалением проверяется — нет ли ссылок на удаляемый объект. Если есть, то объект не удаляется, а ссылки помещаются в таблицу значений Ссылки. Любое другое число — проверку не выполнять. Значение по умолчанию: 1.
Ссылки	Необязательный параметр. Идентификатор объекта типа «ТаблицаЗначений», в который данная процедура помещает найденные ссылки на объекты. Таблица значений состоит из 3 колонок: 1. Объект — объект, на который ссылаются; 2. Ссылка — объект, который содержит ссылку; 3. Комментарий — комментарий к ссылке.

Описание:

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

Пример:

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

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

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

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

ОбработкаОжидания

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

Синтаксис:

ОбработкаОжидания([ИмяПроцедуры], [ИнтервалВызова])

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

IdleProcessing

Параметры:

ИмяПроцедуры

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

Если в качестве параметра передается «пустая строка», то ранее запущенный процесс прекращается.

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

ИнтервалВызова

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

Если в качестве параметра передается 0 (ноль), то ранее запущенный процесс прекращается.

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

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

Имя процедуры глобального модуля, которая назначена для периодического запуска (на момент до исполнения процедуры).

Описание:

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

Пример:

Процедура СформироватьТекущийОтчетПродаж

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

ОбработкаОжидания(СформироватьТекущийОтчетПродаж, 60);

Процедуры и функции обработки значений

ЗначениеВСтрокуВнутр

Преобразование значения объекта агрегатного типа из внутреннего представления в строковое.

Синтаксис:

ЗначениеВСтрокуВнутр(Выражение)

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

ValueToStringInternal

Параметры:

Выражение

Выражение, вычисленное значение которого следует перевести в строковое представление. В качестве параметра для данного метода допускается передавать значения любых типов данных, доступных в конфигурации, как базовых, так и агрегатных типов данных, за исключением тех типов данных, которые не имеют собственно значения — это касается таких объектов как «Периодический», «Таблица», «ФС», «Запрос», «XBase» и т. п. Однако, объекты типа «СписокЗначений» и «ТаблицаЗначений» использовать можно — они преобразуются в строковое представление.

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

Результирующее строковое значение.

Описание:

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

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

Пример:

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

ЗначениеВСтрокуВнутр(Запрос.Клиент) + РазделительСтрок +

ЗначениеВСтрокуВнутр(Запрос.Товар)

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

Процедура ОбработкаЯчейкиТаблицы(Значение, ФлагСтандартнойОбработки)

   Если ТипЗначенияСтр(Значение) = Строка Тогда

      Орг = ЗначениеИзСтрокиВнутр(СтрПолучитьСтроку(Значение, 1));

      Тов = ЗначениеИзСтрокиВнутр(СтрПолучитьСтроку(Значение, 2));

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

         Возврат;

      КонецЕсли;

      Карт(Орг, Тов);

      ФлагСтандартнойОбработки = 0;

      Возврат;

   КонецЕсли;

   ФлагСтандартнойОбработки = 1;

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

См. также: ЗначениеИзСтрокиВнутр, ЗначениеТекущейЯчейки, ОбработкаЯчейкиТаблицы

ЗначениеИзСтрокиВнутр

Преобразование значения объекта агрегатного типа из строкового системного представления во внутреннее.

Синтаксис:

ЗначениеИзСтрокиВнутр(СистСтрока)

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

ValueFromStringInternal

Параметры:

СистСтрока

Строковое выражение, представление объекта агрегатного типа данных в системном строковом виде.

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

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

Описание:

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

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

Замечание. При использовании метода ЗначениеИзСтрокиВнутр() для значения типа «СписокЗначений», являющимся реквизитом формы, его идентификатор следует передавать в качестве второго параметра. В этом случае метод следует использовать как процедуру, т. е. не использовать возвращаемое значение. Пример:

ВосстановитьЗначение(СистСтрокаМойСпис, ИдентМойСпис);

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

См. также: ЗначениеВСтрокуВнутр, ЗначениеТекущейЯчейки

ЗначениеВСтроку

Преобразование значения из внутреннего представления в строковое.

Синтаксис:

ЗначениеВСтроку(Объект)

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

ValueToString

Параметры:

Объект

Значение, которое следует перевести в строковое представление. В качестве параметра для данного метода допускается передавать значения любых типов данных, доступных в конфигурации, как базовых, так и агрегатных типов данных, за исключением тех типов данных, которые не имеют собственно значения — это касается таких объектов как «Периодический», «Таблица», «ФС», «Запрос», «XBase» и т. п. Однако, объекты типа «СписокЗначений» и «ТаблицаЗначений» использовать можно — он преобразуется в строковое представление.

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

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

Описание:

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

Замечание: Строковое представление имеет специальный системный формат, т. е. предназначено не для отображения, а просто для возможности выполнения строковых операций с объектами, например при экспорте-импорте информации между разными конфигурациями (например, при помощи OLE). При преобразовании агрегатных типов данных, данный системный формат использует идентификаторы объектов, как они даны в конфигураторе, а также значения кода (для элементов справочников) и номера (для документов), поэтому при передаче такого строкового представления в другую (похожую) конфигурацию функция ЗначениеИзСтроки сделает попытку восстановить значение объекта по его строковому описанию.

Пример:

СтрДок = ЗначениеВСтроку(ВыбДокумент);

См. также: ЗначениеИзСтроки

ЗначениеИзСтроки

Преобразование из строкового системного представления во внутреннее значение объекта.

Синтаксис:

ЗначениеИзСтроки(СистСтрока)

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

ValueFromString

Параметры:

СистСтрока

Строковое выражение, содержащее представление объекта, полученное ранее при помощи метода ЗначениеВСтроку.

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

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

Описание:

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

Замечание: Строковое представление агрегатного типа данных имеет специальный системный формат, т. е. предназначено не для отображения, а просто для возможности выполнения строковых операций с объектами, например при экспорте-импорте информации между разными конфигурациями (например, при помощи OLE). При преобразовании агрегатных типов данных, данный системный формат использует идентификаторы объектов, как они даны в конфигураторе, а также значения кода (для элементов справочников) и номера (для документов), поэтому при передаче такого строкового представления в другую (похожую) конфигурацию функция ЗначениеИзСтроки сделает попытку восстановить значение объекта по его строковому описанию.

Пример:

Док = ЗначениеИзСтроки(СтрДок);

См. также: ЗначениеВСтроку

ЗначениеВФайл

Сохраняет значение в файле.

Синтаксис:

ЗначениеВФайл(ИмяФайла, 3начение, Формат)

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

ValueToFile

Параметры:

ИмяФаила	Строковое выражение, задающее имя файла.
3начение	Значение, которое следует сохранить в файле. В качестве параметра для данного метода допускается передавать значения любых типов данных, доступных в конфигурации, как базовых, так и агрегатных типов данных, за исключением тех типов данных, которые не имеют собственно значения — это касается таких объектов как «Периодический», «Таблица», «ФС», «Запрос», «XBase» и т. п. Однако, объекты типа «СписокЗначений» и «ТаблицаЗначе-ний» использовать можно.
Формат	Необязательный параметр. Число: 1 — сохранение во внутреннем формате; иначе во внешнем. Значение по умолчанию: 1.

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

Число: 1 — функция выполнена успешно; 0 — функция не выполнена.

Описание:

Функция ЗначениеВФайл позволяет сохранить любое значение в файле. В дальнейшем этот файл можно будет распаковать и сделать обратное преобразование при помощи функции ЗначениеИзФайла.

Пример:

Результат = ЗначениеВФайл(ВыбИмяФайла, ВыбДокумент);

См. также: ЗначениеИзФайла

ЗначениеИзФайла

Восстанавливает значение из файла.

Синтаксис:

ЗначениеИзФайла(ИмяФайла, 3начение, Формат)

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

ValueFromFile

Параметры:

ИмяФайла	Строковое выраженние, задающее имя файла.
3начение	Необязательный параметр. Идентификатор переменной, куда система вернет значение, которое получено из файла.
Формат	Необязательный параметр. Число: 1 — сохранение во внутреннем формате; иначе во внешнем. Значение по умолчанию: 1.

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

Значение, которое получено из файла.

Описание:

Функция ЗначениеИзФайла восстанавливает значение из файла, которое упаковано туда при помощи функции ЗначениеВФайл.

Пример:

Док = ЗначениеИзФайла(ВыбИмяФайла);

См. также: ЗначениеВФайл

СохранитьЗначение

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

Синтаксис:

СохранитьЗначение(Идентификатор, 3начение)

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

SaveValue

Параметры:

Идентификатор	Строковое выражение, наименование сохраняемого значения. Данное наименование используется для идентификации сохраняемых значений.
3начение	Выражение любого типа. Объекты типа «Список-Значений» и «ТаблицаЗначений» использовать можно.

Описание:

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

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

Пример:

СохранитьЗначение(МойСклад, Склад);

См. также: ВосстановитьЗначение

ВосстановитьЗначение

Восстановить сохраненное для пользователя значение.

Синтаксис:

ВосстановитьЗначение(Идентификатор)

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

RestoreValue

Параметры:

Идентификатор

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

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

Значение, сохраненное для пользователя.

Описание:

Применять функцию ВосстановитьЗначение следует, например, если требуется восстановить ранее запомненное (в предыдущем сеансе работы) некоторые значение системы.

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

Замечание. При использовании метода ВосстановитьЗначение() для значения типа «СписокЗначений», являющимся реквизитом формы, его идентификатор следует передавать в качестве второго параметра. В этом случае метод следует использовать как процедуру, т. е. не использовать возвращаемое значение. ВосстановитьЗначение(СистСтрокаМойСпис, ИдентМойСпис);

Пример:

ДефСклад = ВосстановитьЗначение(МойСклад);

См. также: СохранитьЗначение

Процедуры и функции компоненты «Оперативный учет»

ПолучитьТА

Получить дату и время Точки Актуальности итогов в текстовом виде. Данная функция используется только при наличии компоненты. «Оперативный учет».

Синтаксис:

ПолучитьТА()

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

GetAP

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

Строковое значение, содержащее дату и время ТА.

Описание:

Функция ПолучитьТА возвращает дату и время Точки Актуальности итогов в текстовом виде.

Пример:

Дата_И_Время_ТА = ПолучитьТА();

ПолучитьДатуТА

Получить дату Точки Актуальности итогов. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

ПолучитьДатуТА()

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

GetDateOfAP

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

Значение типа «дата», содержащее дату ТА.

Описание:

Функция ПолучитьДатуТА возвращает значение (типа «дата») даты Точки Актуальности итогов.

Пример:

Дата_ТА = ПолучитьДатуТА();

ПолучитьВремяТА

Получить значение времени Точки Актуальности итогов. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

ПолучитьВремяТА(Часы, Минуты, Секунды)

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

GetTimeOfAP

Параметры:

Часы	Идентификатор переменной, в которую метод возвращает строковое значение часа ТА.
Минуты	Идентификатор переменной, в которую метод возвращает строковое значение минут ТА.
Секунды	Идентификатор переменной, в которую метод возвращает строковое значение секунд ТА.

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

Строковое значение времени ТА в виде ЧЧ. MM. СС.

Описание:

Функция ПолучитьВремяТА записывает значение времени Точки Актуальности итогов в передаваемые при вызове параметры.

Пример:

ПолучитьВремяТА(Час, Минута, Секунда);

ПолучитьДокументТА

Получить документ, который стоит на ТА. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

ПолучитьДокументТА()

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

GetDocOfAP

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

Значение типа «документ», который стоит на ТА.

Описание:

Функция ПолучитьДокументТА возвращает документ, который стоит на ТА, если он есть.

Пример:

ПоследнийДок = ПолучитьДокументТА();

ПолучитьПозициюТА

Получить позицию Точки Актуальности итогов. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

ПолучитьПозициюТА()

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

GetAPPosition

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

32-х символьное строковое значение позиции ТА.

Описание:

Функция ПолучитьПозициюТА возвращает 32-х символьное строковое значение позиции ТА.

Пример:

ПозицияТА = ПолучитьПозициюТА();

УстановитьТАна

Изменить положение Точки Актуальности итогов. Данный метод используется только при наличии компоненты «Оперативный учет». Данный метод используется только в монопольном режиме доступа.

Синтаксис:

УстановитьТАна(ПоложениеТА]

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

SetAPToBeg

Параметры:

ПоложениеТА

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

Описание:

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

Пример:

УстановитьТАна(ВыбДокумент);

УстановитьТАпо

Изменить положение Точки Актуальности итогов. Данный метод используется только при наличии компоненты «Оперативный учет». Данный метод используется только в монопольном режиме доступа.

Синтаксис:

УстановитьТАпо(ПоложениеТА)

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

SetAPToEnd

Параметры:

ПоложениеТА

Выражение типа дата, документ или позиция документа, на конец которого устанавливается ТА.

Описание:

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

Пример:

УстановитьТАпо(ВыбДокумент);

Процедуры и функции компоненты «Бухгалтерский учет»

Процедуры и функции этого раздела используются только при наличии компоненты «Бухгалтерский учет».

ВыбранныйПланСчетов

Возвращает план счетов, выбранный пользователем в параметрах системы.

Синтаксис:

ВыбранныйПланСчетов()

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

DefaultChartOfAccounts

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

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

Описание:

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

Пример:

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

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

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

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

Синтаксис:

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

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

MainChartOfAccounts

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

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

Описание:

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

Пример:

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

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

СчетПоКоду

Поиск бухгалтерского счета по коду.

Синтаксис:

СчетПоКоду(КодСчета[, ПланСчетов])

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

AccountByCode

Параметры:

КодСчета	Символьное выражение — код счета.
ПланСчетов	Значение типа «План Счетов» — план счетов, в котором выполняется поиск. Если параметр не указан, поиск выполняется в основном плане счетов, заданном в метаданных.

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

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

Описание:

Метод СчетаПоКоду позволяет найти значение типа «Счет» по коду счета, указанному в виде символьной строки.

Пример:

// При проведении документа формируем проводку

Операция.НоваяПроводка();

Операция.Дебет.Счет = СчетПоКоду(51);

НачалоПериодаБИ

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

Синтаксис:

НачалоПериодаБИ()

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

BeginOfРег1odBT()

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

Значение типа «Дата» — дата начала периода бухгалтерских итогов.

Описание:

Метод НачалоПериодаБИ возвращает дату начала периода бухгалтерских итогов, заданную в режиме «Настройка параметров системы».

Пример:

Дата1 = НачалоПериодаБИ();

КонецПериодаБИ

Возвращает дату конца периода бухгалтерских итогов.

Синтаксис:

КонецПериодаБИ()

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

EndOfРег1odBT()

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

Значение типа «Дата» — дата конца периода бухгалтерских итогов.

Описание:

Метод КонецПериодаБИ возвращает дату конца периода бухгалтерских итогов, заданную в режиме «Настройка параметров системы».

Пример:

Дата2 = КонецПериодаБИ();

КонецРассчитанногоПериодаБИ

Возвращает последнюю дату рассчитанных бухгалтерских итогов.

Синтаксис:

КонецРассчитанногоПериодаБИ()

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

EndOfCalculatedРег1odBT()

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

Значение типа «Дата» — последняя дата рассчитанных бухгалтерских итогов.

Описание:

Метод КонецРассчитанногоПериодаБИ возвращает последнюю дату рассчитанных бухгалтерских итогов, заданную в режиме «Управление бухгалтерских итогов» при работе в режиме «1С:Предприятие».

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

Пример:

Если Дата2 КонецРассчитанногоПериодаБИ() Тогда

Сообщить(Период не рассчитан!);

Возврат;

КонецЕсли;

НазначитьСчет

Назначает счет значению типа «Вид субконто».

Синтаксис:

НазначитьСчет(ВидСубконто, Счет[, НомерСубконто])

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

SetAccount

Параметры:

ВидСубконто	Значение типа «ВидСубконто», переданное по ссылке — обычно реквизит диалога формы.
Счет	Значение типа «Счет».
НомерСубконто	Значение типа «Число» — номер субконто для данного счета.

Описание:

Данная процедура используется для организации выбора значения типа «Вид субконто» в диалоге формы применительно к конкретному счету, то есть организовать выбор видов субконто конкретного счета. В качестве первого параметра передается собственно реквизит диалога, а в качестве второго — счет. Вызов данной процедуры ограничивает выбор вида субконто видами, заданными для конкретного счета. Кроме того, само значение вида субконто очищается, если данный вид субконто не используется для указанного счета. Если указан параметр НомерСубконто, то значение вида субконто будет автоматически установлено в соответствии с настройкой субконто указанного счета с данным номером.

Пример:

Процедура ПриВыбореСчета()

   НазначитьСчет(ВыбВидСубконто1, Счет, 1);

   НазначитьСчет(ВыбВидСубконто2, Счет, 2);

   НазначитьСчет(ВыбВидСубконтоЗ, Счет, 3);

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

ВвестиПланСчетов

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

Синтаксис:

ВвестиПланСчетов(ПланСчетов, Подсказка, Таймаут)

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

InputChartOfAccounts

Параметры:

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

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

Числовое значение: 1 — выбор осуществлен , 0 — выбор не осуществлен (пользователем нажата кнопка «Отмена», клавиша Esc или закрыто окно диалога).

Описание:

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

Пример:

Перем ВыбПлан;

Если ВвестиПланСчетов(ВыбПлан, Введите план счетов) = 1 Тогда

...

КонецЕсли;

ВвестиВидСубконто

Выбрать вид субконто из существующих видов субконто в диалоге.

Синтаксис:

ВвестиВидСубконто(ВидСубконто, Подсказка, [Счет], [Таймаут])

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

InputSubcontoKind

Параметры:

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

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

Числовое значение: 1 — выбор осуществлен , 0 — выбор не осуществлен (пользователем нажата кнопка «Отмена», клавиша Esc или закрыто окно диалога).

Описание:

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

Пример:

Перем ВыбВидСубк;

Если ВвестиВидСубконто(ВыбВидСубк, Введите вид убконто, ВыбСчет) = 1 Тогда

...

КонецЕсли;

МаксимальноеКоличествоСубконто

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

Синтаксис:

МаксимальноеКоличествоСубконто()

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

MaxSubcontoCount

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

Число — максимальное количество видов субконто.

Описание:

Метод МаксимальноеКоличествоСубконто выдает значение параметра «Максимальное количество субконто», указанное в метаданных в настройке планов счетов. Фактически она позволяет определить, сколько видов субконто может быть задано для счета.

Пример:

Если МаксимальноеКоличествоСубконто() 2 Тогда

Форма.ВидСубк2.Видимость(0);

КонецЕсли;

Процедуры и функции компоненты «Расчет»

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

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

Синтаксис:

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

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

BasicCalcJournal

Параметры:

ЖурналРасч

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

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

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

Описание:

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

Пример:

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

Содержание раздела