- •Часть 1 Содержание
- •Глава 1 Формат исходных текстов программных модулей 13
- •Вопрос 58
- •Глава 8 Системные предопределенные процедуры 88
- •Глава 9 Работа с Константами 95
- •Глава 10 Работа со Справочниками 98
- •Глава 11 Работа с Перечислениями 133
- •Глава 12 Работа с Документами 136
- •Глава 13 Работа с Журналами документов 173
- •Глава 14 Работа с Регистрами оперативного учета 178
- •Глава 15 Служебные типы данных компоненты «Бухгалтерский учет» 202
- •Глава 16 работа с бухгалтерскими счетами 207
- •Глава 17 Работа с операциями и проводками 229
- •Введение
- •Назначение и краткая характеристика встроенного языка
- •Построение книги
- •Формат описания элементов языка
- •Соглашения и обозначения, принятые в синтаксических диаграммах
- •Синтаксическая диаграмма описания элемента языка
- •ЭлементЯзыка
- •Глава 1 Формат исходных текстов программных модулей Что такое программный модуль?
- •Контекст выполнения программного модуля
- •Виды программных модулей
- •Формат программного модуля
- •Комментарии
- •Формат операторов
- •Имена переменных, процедур и функций
- •Зарезервированные слова
- •Структура программного модуля
- •Специальные символы, используемые в исходном тексте
- •Процедуры и функции программного модуля Процедура
- •Функция
- •Предварительное описание процедур и функций
- •Передача параметров
- •Передача локального контекста программного модуля в качестве параметра
- •Пример исходного текста программного модуля
- •Глава 2 Типы данных Базовые типы данных
- •Правила преобразования типов данных
- •Агрегатные типы данных
- •Англоязычные синонимы названий агрегатных типов данных
- •Атрибуты агрегатных типов данных
- •Методы агрегатных типов данных
- •Глава 3 Объявление переменных
- •Оператор объявления переменной Перем
- •Область использования переменной
- •Глава 4 Выражения и оператор присваивания Выражения
- •Арифметические операции
- •Операция конкатенации
- •Логические операции
- •Числовые константы
- •Константы даты
- •Строковые константы
- •Строковые выражения
- •Логические выражения
- •Оператор присваивания
- •Глава 5 Управляющие операторы Управляющие конструкции Если
- •Попытка
- •Управляющие операторы Перейти
- •Продолжить
- •Прервать
- •Возврат
- •Специальные конструкции языка #ЗагрузитьИзФайла
- •Глава 6 Системные константы
- •Строковые системные константы РазделительСтраниц
- •РазделительСтрок
- •СимволТабуляции
- •Глава 7 Системные процедуры и функции
- •Математические функции
- •Строковые функции СтрДлина
- •ПустаяСтрока
- •СтрЗаменить
- •СтрЧислоВхождений
- •СтрКоличествоСтрок
- •СтрПолучитьСтроку
- •ТекущаяДата
- •ДобавитьМесяц
- •НомерДняГода
- •НомерДняНедели
- •ПериодСтр
- •НачалоСтандартногоИнтервала
- •КонецСтандартногоИнтервала
- •Функции работы с временем ТекущееВремя
- •Функции преобразования типов Дата
- •РазобратьПозициюДокумента
- •Процедуры и функции форматирования Пропись
- •ФиксШаблон
- •Функции для вызова диалога ввода данных ВвестиЗначение
- •ВвестиЧисло
- •ВвестиСтроку
- •ВвестиДату
- •ВвестиПериод
- •ВвестиПеречисление
- •Процедуры и функции общего назначения Вопрос
- •Предупреждение
- •Сообщить
- •ОчиститьОкноСообщений
- •Состояние
- •? (Вычислить выражение по условию)
- •Функции среды исполнения ЗаголовокСистемы
- •ИмяКомпьютера
- •ИмяПользователя
- •ПолноеИмяПользователя
- •НазваниеНабораПрав
- •ПравоДоступа
- •МонопольныйРежим
- •ОсновнойЯзык
- •Процедуры работы с транзакциями
- •НачатьТранзакцию
- •ЗафиксироватьТранзакцию
- •ОтменитьТранзакцию
- •Специальные процедуры и функции СоздатьОбъект
- •СтатусВозврата
- •ОткрытьФорму
- •Открытие формы нового документа
- •Открытие окна истории значений периодических констант, реквизитов справочников и счетов.
- •ОткрытьФормуМодально
- •ТипЗначения
- •ТипЗначенияСтр
- •ПустоеЗначение
- •ПолучитьПустоеЗначение
- •НазначитьВид
- •ЗаписьЖурналаРегистрации
- •ПрефиксАвтоНумерации
- •ПолучитьЗначенияОтбора
- •КомандаСистемы
- •ЗапуститьПриложение
- •ЗавершитьРаботуСистемы
- •НайтиПомеченныеНаУдаление
- •НайтиСсылки
- •УдалитьОбъекты
- •ОбработкаОжидания
- •Процедуры и функции обработки значений ЗначениеВСтрокуВнутр
- •ЗначениеИзСтрокиВнутр
- •ЗначениеВСтроку
- •ЗначениеИзСтроки
- •ЗначениеВФайл
- •ЗначениеИзФайла
- •СохранитьЗначение
- •ВосстановитьЗначение
- •Процедуры и функции компоненты «Оперативный учет» ПолучитьТа
- •ПолучитьДатуТа
- •ПолучитьВремяТа
- •ПолучитьДокументТа
- •ПолучитьПозициюТа
- •УстановитьТАна
- •УстановитьТАпо
- •Процедуры и функции компоненты «Бухгалтерский учет»
- •ВыбранныйПланСчетов
- •ОсновнойПланСчетов
- •СчетПоКоду
- •НачалоПериодаБи
- •КонецПериодаБи
- •КонецРассчитанногоПериодаБи
- •НазначитьСчет
- •ВвестиПланСчетов
- •ВвестиВидСубконто
- •МаксимальноеКоличествоСубконто
- •Процедуры и функции компоненты «Расчет» ОсновнойЖурналРасчетов
- •Глава 8 Системные предопределенные процедуры
- •Предопределенные процедуры Глобального модуля
- •ПриНачалеРаботыСистемы
- •ПриЗавершенииРаботыСистемы
- •ПриУдаленииДокумента
- •ПриУдаленииЭлемента
- •ПриОткрытииИстории
- •ПриЗаписиИстории
- •ПриУдаленииИстории
- •ПриЗаписиКонстанты
- •ПриОтменеПроведенияДокумента
- •ПриИзмененииВремениДокумента
- •ПриУстановкеОтбора
- •ПриСменеРасчетногоПериода
- •ПриУдаленииСчета
- •ПриВыклВклПроводокОперации
- •Глава 9 Работа с Константами
- •Методы констант НазначитьТип
- •УстановитьАтрибут
- •ПолучитьАтрибут
- •Методы периодических констант Получить
- •Установить
- •Глава 10 Работа со Справочниками
- •Контекст работы со справочниками
- •Атрибуты справочников
- •Наименование
- •Родитель
- •Владелец
- •Методы периодических реквизитов Получить
- •Установить
- •Методы справочников
- •ПредставлениеВида
- •Уровень
- •УстановитьАтрибут
- •ПолучитьАтрибут
- •ЭтоГруппа
- •ПринадлежитГруппе
- •Выбрать
- •ВидыДляВыбора
- •ВыборГруппы
- •ТекущийЭлемент
- •ПолныйКод
- •ПолноеНаименование
- •НайтиЭлемент
- •НайтиПоКоду
- •НайтиПоНаименованию
- •НайтиПоРеквизиту
- •ВыбратьЭлементы
- •ВыбратьЭлементыПоРеквизиту
- •ОбратныйПорядок
- •ПолучитьЭлемент
- •ИспользоватьДату
- •ИспользоватьВладельца
- •ИспользоватьРодителя
- •ВключатьПодчиненные
- •ПорядокКодов
- •ПорядокНаименований
- •ПорядокРеквизита
- •НоваяГруппа
- •ПрефиксКода
- •УстановитьНовыйКод
- •НазначитьТип
- •Записать
- •Удалить
- •Блокировка
- •ПометкаУдаления
- •СнятьПометкуУдаления
- •Методы контекста Модуля формы элемента справочника
- •Модифицированность
- •ИспользоватьДату
- •СохранениеПериодическихРеквизитов
- •ПросмотрИстории
- •Предопределенные процедуры Модуля формы справочника
- •ВводНового
- •ПриЗаписи
- •Методы контекста Модуля формы списка справочника
- •ИспользоватьДату
- •ИспользоватьВладельца
- •ИспользоватьРодителя
- •ИерархическийСписок
- •ВыборГруппы
- •РедактироватьВДиалоге
- •СохранениеПериодическихРеквизитов
- •Сортировка
- •УстановитьОтбор
- •ПолучитьОтбор
- •ВидыОтбора
- •ЗакладкиОтбора
- •ИспользоватьСписокЭлементов
- •ПросмотрИстории
- •Предопределенные процедуры Модуля формы списка справочника
- •ПриВводеСтроки
- •ПриРедактированииНовойСтроки
- •ПриНачалеРедактированияСтроки
- •ПриЗаписи
- •ПриПереносеЭлементаВДругуюГруппу
- •ПриВыбореРодителя
- •ПриВыбореВладельца
- •ПриСменеИерархии
- •ПриУстановкеОтбора
- •Глава 11 Работа с Перечислениями
- •Контекст работы с перечислениями
- •Методы перечислений ПолучитьАтрибут
- •КоличествоЗначений
- •ЗначениеПоНомеру
- •ЗначениеПоИдентификатору
- •ПредставлениеВида
- •ПорядковыйНомер
- •Идентификатор
- •Глава 12 Работа с Документами
- •Контекст работы с документами
- •Позиция документа
- •Атрибуты документов НомерДок
- •ДатаДок
- •НомерСтроки
- •Операция
- •Методы документов
- •ПредставлениеВида
- •УстановитьАтрибут
- •ПолучитьАтрибут
- •Проведен
- •ТекущийДокумент
- •Выбрать
- •ВидыДляВыбора
- •КоличествоСтрок
- •НайтиДокумент
- •НайтиПоНомеру
- •Получить Строку ПоНомеру
- •ВыбратьДокументы
- •ВыбратьПодчиненныеДокументы
- •ВыбратьПоЗначению
- •ВыбратьПоНомеру
- •ВыбратьПоПоследователыюсти
- •ОбратныйПорядок
- •УстановитьФильтр
- •ПолучитьДокумент
- •ВыбратьСтроки
- •ПолучитьСтроку
- •ПрефиксНомера
- •УстановитьНовыйНомер
- •НазначитьТип
- •Записать
- •Удалить
- •ПометкаУдаления
- •СнятьПометкуУдаления
- •НоваяСтрока
- •УдалитьСтроку
- •УдалитьСтроки
- •СортироватьСтроки
- •ПолучитьПозицию
- •ПринадлежитПоследовательности
- •ИспользоватьЖурнал
- •Блокировка
- •ПолучитьВремя
- •УстановитьВремя
- •АвтоВремяНачалоДня
- •АвтоВремяКонецДня
- •АвтоВремяТекущее
- •АвтоВремяПослеТа
- •АвтоВремяОтключить
- •Провести
- •СделатьНеПроведенным
- •СравнитьТа
- •СуществуетОперация
- •ВыгрузитьТабличнуюЧасть
- •ЗагрузитьТабличнуюЧасть
- •Методы контекста Модуля формы документа
- •ПриЗаписиПерепроводить
- •ПроводитьПослеТа
- •АктивизироватьСтроку
- •ИзменениеПорядкаСтрок
- •Модифицированность
- •Предопределенные процедуры Модуля формы документа
- •ВводНового
- •ВводНаОсновании
- •ПриЗаписи
- •ПриНачалеРедактированияСтроки
- •ПриВводеСтроки
- •ПриРедактированииНовойСтроки
- •ПриОкончанииРедактированияСтроки
- •ПриУдаленииСтроки
- •ПриИзмененииПорядкаСтрок
- •Методы контекста Модуля документа
- •ИтогиАктуальны
- •ГрупповаяОбработка
- •НеПроводитьДокумент
- •УстановитьРеквизитСправочника
- •ОчиститьДвижения
- •ПривязыватьСтроку
- •Предопределенные процедуры Модуля документа
- •ОбработкаПроведения
- •ОбработкаУдаленияПроведения
- •АрхивироватьДокумент
- •Команды организации механизма заполнения документа методом подбора
- •Глава 13 Работа с Журналами документов Контекст работы с журналами документов
- •Атрибуты контекста Модуля формы журнала документов
- •ТекущийДокумент
- •Методы контекста Модуля формы журнала документов
- •ВидыОтбора
- •ЗакладкиОтбора
- •УстановитьОтбор
- •ПолучитьОтбор
- •УстановитьИнтервал
- •НачалоИнтервала
- •КонецИнтервала
- •ПодчинениеДокументу
- •Предопределенные процедуры Модуля формы журнала документов
- •ПриУстановкеОтбора
- •ПриУстановкеИнтервала
- •Глава 14 Работа с Регистрами оперативного учета
- •Контекст работы с регистрами
- •Атрибуты регистров Приход
- •Методы оборотных регистров
- •ИспользоватьПериод
- •СводныйИтог
- •СводныеИтоги
- •ИтогиПолучить
- •Методы регистров остатков
- •Остаток
- •СводныйОстаток
- •Остатки
- •СводныеОстатки
- •ОстаткиПолучить
- •Выбрать ДвиженияСОстатками
- •Общие методы регистров
- •ПредставлениеВида
- •НазначитьТип
- •УстановитьАтрибут
- •ПолучитьАтрибут
- •ВыбратьДвижения
- •ВыбратьДвиженияДокумента
- •ОбратныйПорядок
- •ПолучитьДвижение
- •ТекущийДокумент
- •НомерСтроки
- •ВыбратьИтоги
- •ПолучитьИтог
- •ВыгрузитьИтоги
- •ВременныйРасчет
- •УстановитьФильтр
- •УстановитьЗначениеФильтра
- •Методы контекста Модуля документа
- •ПривязыватьСтроку
- •ДвижениеПриход
- •ДвижениеРасход
- •ДвижениеПриходВыполнить
- •ДвижениеРасходВыполнить
- •Движение
- •ДвижениеВыполнить
- •Системные процедуры работы с регистрами
- •РассчитатьРегистрыНа
- •РассчитатьРегистрыПо
- •Вспомогательный объект Регистры
- •Атрибуты объекта Регистры
- •Методы объекта Регистры ПолучитьАтрибут
- •РассчитатьРегистрыНа
- •РассчитатьРегистрыПо
- •Актуальность
- •Глава 15 Служебные типы данных компоненты «Бухгалтерский учет» Тип данных «ПланСчетов»
- •Методы типа данных «ПланСчетов» Выбран
- •ПорядковыйНомер
- •Идентификатор
- •Атрибут глобального контекста «ПланыСчетов» ПланыСчетов
- •Методы глобального атрибута «ПланыСчетов»
- •КоличествоЗначений
- •ЗначениеПоНомеру
- •ЗначениеПоИдентификатору
- •Тип данных «ВидСубконто»
- •Методы типа данных «ВидСубконто» Выбран
- •ПорядковыйНомер
- •ТипСубконто
- •Идентификатор
- •Атрибут глобального контекста «ВидыСубконто» ВидыСубконто
- •Методы глобального атрибута «ВидыСубконто»
- •КоличествоЗначений
- •ЗначениеПоНомеру
- •ЗначениеПоИдентификатору
- •Глава 16 работа с бухгалтерскими счетами
- •Контекст работы с бухгалтерскими счетами
- •Атрибуты объекта «Счет»
- •Наименование
- •Валютный
- •Количественный
- •Забалансовый
- •Активный
- •Методы объекта «Счет» ВыбратьСчета
- •ПолучитьСчет
- •УстановитьАтрибут
- •ПолучитьАтрибут
- •Выбрать
- •НайтиПоКоду
- •НайтиСчет
- •ЗаданВКонфигурации
- •ПредставлениеВида
- •ПланСчетов
- •ЭтоГруппа
- •Уровень
- •ТекущийСчет
- •ПометкаУдаления
- •ВыборГруппы
- •ПринадлежитГруппе
- •КоличествоСубконто
- •ВидСубконто
- •ТолькоОбороты
- •УчетПоСумме
- •УчетПоВалютнойСумме
- •УчетПоКоличеству
- •ИспользоватьДату
- •ИспользоватьПланСчетов
- •Родитель
- •ИспользоватьРодителя
- •КодСубсчета
- •Блокировка
- •НазначитьТип
- •Записать
- •Удалить
- •СнятьПометкуУдаления
- •Методы контекста Модуля формы списка счетов
- •ИспользоватьДату
- •ИспользоватьПланСчетов
- •ИспользоватьРодителя
- •ИспользоватьКорСчет
- •ИерархическийСписок
- •РедактироватьВДиалоге
- •ВыборГруппы
- •Предопределенные процедуры модуля формы списка счетов
- •ПриВводеСтроки
- •ПриРедактированииНовойСтроки
- •ПриНачалеРедактированияСтроки
- •ПриВыбореРодителя
- •ПриЗаписи
- •Предопределенные процедуры модуля формы счета
- •ВводНового
- •ПриЗаписи
- •Глава 17 Работа с операциями и проводками
- •Контекст работы с операциями и проводками
- •Атрибуты объекта «Операция» ДатаОперации
- •Содержание
- •СуммаОперации
- •Документ
- •ВалСумма
- •Количество
- •Атрибуты объектов «Дебет» и «Кредит» Счет
- •Методы объектов «Дебет» и «Кредит» Субконто
- •ПредставлениеСубконто
- •Методы объекта «Операция» ВыбратьОперации
- •ВыбратьОперацииСПроводками
- •ИспользоватьСубконто
- •ИспользоватьКорСубконто
- •ВыбратьПоЗначению
- •ПолучитьОперацию
- •НайтиОперацию
- •Выбрана
- •УстановитьАтрибут
- •ПолучитьАтрибут
- •ВыбратьПроводки
- •ПолучитьПроводку
- •ПроводкаВыбрана
- •КоличествоПроводок
- •ПолучитьПроводкуПоНомеру
- •НомерПроводки
- •ПланСчетов
- •НомерКорреспонденции
- •СложнаяПроводка
- •НомерСтрокиДокумента
- •ПредставлениеПроводки
- •ПредставлениеСубконто
- •НазначитьТип
- •ЗаписатьПроводки
- •Записать
- •Удалить
- •ПометкаУдаления
- •СнятьПометкуУдаления
- •ПолучитьВремя
- •УстановитьВремя
- •ПолучитьДокумент
- •ВключитьПроводки
- •НоваяПроводка
- •НоваяКорреспонденция
- •ПроверитьПроводку
- •УдалитьПроводку
- •Атрибуты контекста модуля формы операции
- •Методы контекста модуля формы операции ПоТиповойОперации
- •ИспользоватьВалюту
- •ИспользоватьКорСчет
- •ИспользоватьСубконто
- •ИзменениеПорядкаСтрок
- •Предопределенные процедуры модуля формы операции
- •ВводНового
- •ВводНаОсновании
- •ПриЗаписи
- •ПриНачалеРедактированияСтроки
- •ПриВводеСтроки
- •ПриРедактированииНовойСтроки
- •ПриУдаленииСтроки
- •ПриИзмененииПорядкаСтрок
ВвестиВидСубконто
Выбрать вид субконто из существующих видов субконто в диалоге.
Синтаксис:
ВвестиВидСубконто(<ВидСубконто>, <Подсказка>, [<Счет>], [<Таймаут>])
Англоязычный синоним:
InputSubcontoKind
Параметры:
-
<ВидСубконто>
Значение типа «ВидСубконто», переданное по ссылке (идентификатор переменной). В данное значение будет осуществлен возврат выбранного значение вида субконто.
<Подсказка>
Строковое выражение, содержащее строку, которая будет выводиться в заголовке окна диалога выбора вида субконо.
<Счет>
Значение типа «Счет». Если данное значение указано выбор будет ограничен видами субконто, заданными для указанного счета. Необязательный параметр.
<Таймаут>
Числовое выражение — интервал времени ожидания ответа пользователя в секундах. Если параметр опущен или равен 0 — ожидание бесконечно. Необязательный параметр.
Возвращаемое значение:
Числовое значение: 1 — выбор осуществлен , 0 — выбор не осуществлен (пользователем нажата кнопка «Отмена», клавиша <Esc> или закрыто окно диалога).
Описание:
Данная функция выводит диалог, в котором пользователь выбирает один из существующих видов субконто. Результат выбора возвращается в первый параметр функции. Выбор видов субконто может быть ограничен видами субконто, заданными для конкретного счета.
Пример:
Перем ВыбВидСубк;
Если ВвестиВидСубконто(ВыбВидСубк, "Введите вид убконто", ВыбСчет) = 1 Тогда
...
КонецЕсли;
МаксимальноеКоличествоСубконто
Максимальное количество видов субконто, которые могут быть заданы для счетов.
Синтаксис:
МаксимальноеКоличествоСубконто()
Англоязычный синоним:
MaxSubcontoCount
Возвращаемое значение:
Число — максимальное количество видов субконто.
Описание:
Метод МаксимальноеКоличествоСубконто выдает значение параметра «Максимальное количество субконто», указанное в метаданных в настройке планов счетов. Фактически она позволяет определить, сколько видов субконто может быть задано для счета.
Пример:
Если МаксимальноеКоличествоСубконто() < 2 Тогда
Форма.ВидСубк2.Видимость(0);
КонецЕсли;
Процедуры и функции компоненты «Расчет» ОсновнойЖурналРасчетов
Устанавливает основной журнал расчетов. Используется только при наличии компоненты «Расчет».
Синтаксис:
ОсновнойЖурналРасчетов(<ЖурналРасч>)
Англоязычный синоним:
BasicCalcJournal
Параметры:
-
<ЖурналРасч>
Строковое значение — идентификатор журнала расчетов, как он задан при конфигурировании.
Возвращаемое значение:
Значение текущего журнала расчетов.
Описание:
Функция ОсновнойЖурналРасчетов устанавливает основной журнал расчетов. По умолчанию основной журнал расчетов — первый в списке журналов расчетов.
Пример:
ОсновнойЖурналРасчетов("Основной");
Глава 8 Системные предопределенные процедуры
Системные предопределенные процедуры предназначены для того, чтобы дать возможность программно обрабатывать системные события, возникающие при интерактивных действиях пользователя, таких как ввод нового, изменение, удаление. Исключение составляют только предопределенные процедуры Модуля документа: ОбработкаПроведения, ОбработкаУдаленияПроведения, АрхивироватьДокумент, которые вызываются как при интерактивном, так и при программном возникновении события.
ВНИМАНИЕ! Системные предопределенные процедуры не являются встроенными процедурами языка. Для них зарезервированы только название и синтаксис. Тело процедур должно быть написано самим разработчиком конфигурации в соответствующих программных модулях.
Вызов системных предопределенных процедур (если они использованы в конфигурации) производится неявно самой системой 1С:Предприятие перед обработкой какого-либо интерактивного действия пользователя, например, при вводе нового документа. В этот момент система передает в предопределенную процедуру фактические значения параметров. В теле процедур переданные параметры могут использоваться для обработки события, например, выдачи предупреждающих сообщений, установки статуса возврата и т. п.
С помощью системной функции СтатусВозврата в теле предопределенной процедуры можно устанавливать значение статуса возврата процедуры. Статус возврата используется системой, чтобы определить — выполнить или нет действие того системного события, которое вызвало данную предопределенную процедуру.