КодСубсчета
Выдает код счета без кодов счетов вышестоящих уровней.
Синтаксис:
КодСубсчета()
Англоязычный синоним:
SubAccountCode
Возвращаемое значение:
Строковое значение — код счета без кодов счетов вышестоящих уровней.
Описание:
При наличии в плане счетов нескольких уровней счетов-субсчетов атрибут "Код" объекта типа «Счет» содержит полный код счета с учетом всех вышестоящих счетов через разделитель (точку). Метод КодСубсчета выдает собственно код даного счета без кодов счетов вышестоящих уровней.
Пример:
Сч = СоздатьОбъект("Счет.Основной");
Сч.НайтиПоКоду("76.02");
Сообщить("Код счета " + Сч.Код); //Возвращает "76.02"
Сообщить("Код Субсчета " + Сч.КодСубсчета); //Возвращает "76"
Количественный
Признак ведения количественного учета.
Синтаксис:
Количественный
Англоязычный синоним:
IsAmount
Значение:
1 — количественный учет ведется по данному счету;
0 — количественный учет не ведется по данному счету;
Описание:
Атрибут содержит признак ведения количественного учета по счету. Изменение данного значения из языка следует производить только в особых случаях и с учетом всех особенностей настройки учета. После изменения настроек учета система может потребовать выполнить пересчет итогов.
Пример:
Сч.Количественный = 1;
Количество
Количество выбранной проводки или корреспонденции операции.
Синтаксис:
Количество
Англоязычный синоним:
Amount
Значение:
Значение типа «Число».
Описание:
Атрибут Количество служит для обращению к количеству выбранной проводки или корреспонденции операции.
Перед обращением к атрибуту конкретной проводки эта проводка должна быть выбрана с помощью методов ВыбратьПроводки, ПолучитьПроводку или создана при помощи метода НоваяПроводка. В модулях форм «Операции» и «Журнал проводок» текущая проводка определяется положением курсора.
Пример:
Опер = СоздатьОбъект("Операция");
Опер.НайтиОперацию(ВыбрДокумент);
Опер.ВыбратьПроводки();
Пока Опер.ПолучитьПроводку() = 1 Цикл
Сообщить("Количество ="+0пер.Количество);
КонецЦикла;
Количество
Количество видов расчета, включенных в группу видов расчета.
Синтаксис:
Количество()
Англоязычный синоним:
Count
Возвращаемое значение:
Целое положительное число — количество видов расчета, входящих в группу.
Описание:
Метод группы видов расчета, который позволяет определить количество видов расчета, включенных в данную группу. Обычно применяется в цикле с методом ПолучитьВидРасчета.
Пример:
// модуль выполняется в контексте журнала расчетов
// текущий сотрудник Сотр = Объект;
// Для всех видов удержаний проведем расчет в
// журнале расчетов зарплаты
ЖР = СоздатьОбъект("ЖурналРасчетов.Зарплата");
ВсеУд = Группа.ВсеУдержания;
Счетчик = 1;
Пока Счетчик <= ВсеУд.Количество() Цикл
ЖР.ВвестиРасчет(Сотр, ВсеУд.ПолучитьВидРасчета(Счетчик));
Счетчик = Счетчик + 1;
КонецЦикла;
См. также: ПолучитьВидРасчета
КоличествоИндексов
Возвращает количество индексов в открытом индексном файле.
Синтаксис:
КоличествоИндексов()
Англоязычный синоним:
IndexCount
Возвращаемое значение:
Числовое значение — количество индексов в открытом индексном файле.
Описание:
Метод КоличествоИндексов возвращает количество индексов в открытом индексном файле. Может быть использован при работе с базой данных неизвестной заранее структуры.
Пример:
Процедура ОписИнд()
Перем Назв;
Перем Выр;
Перем Уник;
Перем Убыв;
Перем Филт;
СпЗнач = СоздатьОбъект("СписокЗначений");
СпЗнач.УдалитьВсе();
Для КП = 1 По ДБФ.КоличествоИндексов() Цикл
ДБФ.ОписаниеИндекса(КП.Назв, Выр, Уник, Убыв, Филт);
СпЗнач.ДобавитьЗначение("" + КП + "; " + Назв + "; " + Выр + "; " + Уник +
"; " + Убыв + "; " + Филт);
КонецЦикла;
КонецПроцедуры
КоличествоЭкземпляров
Установить количество печатаемых экземпляров.
Синтаксис:
КоличествоЭкземпляров(<Колич>)
Англоязычный синоним:
NumberOfCopies
Параметры:
<Колич> |
Необязательный параметр. Числовое выражение — количество печатаемых экземпляров. |
Возвращаемое значение:
Текущее заданное количество печатаемых экземпляров (на момент до исполнения метода).
Описание:
Метод КоличествоЭкземпляров позволяет установить количество печатаемых экземпляров. Если для текущей таблицы используется набор опций печати (см. Опции), то данный метод следует вызывать только после вызова метода Показать, т. к. иначе будут действовать автоматически устанавливаемые настройки печати.
Пример:
Таб.КоличествоЭкземпляров(5);
См. также: Опции
КоличествоКолонок
Устанавливает/возвращает количество колонок.
Синтаксис:
КоличествоКолонок(<КоличКолонок>)
Англоязычный синоним:
ColumnCount
Параметры:
<КоличКолонок> |
Необязательный параметр. Числовое выражение, которое указывает новое количество колонок. Если параметр опущен, то количество колонок не меняется. |
Возвращаемое значение: количество колонок до вызова метода.
Описание:
Метод КоличествоКолонок устанавливает/возвращает количество колонок таблицы значений.
Пример:
Разм = ТаблицаТоваров.КоличествоКолонок();
КоличествоПериодов
Количество перерасчитываемых периодов для правила перерасчета.
Синтаксис:
КоличествоПериодов
Англоязычный синоним:
NumberOfPeriods
Описание:
Атрибут КоличествоПериодов позволяет прочитать/установить количество периодов перерасчета.
Пример:
КолПер = ПравилоПерерасчета.Главное.КоличествоПериодов;
КоличествоПодчиненных
Возвращает количество «подчиненных» видов расчета.
Синтаксис:
КоличествоПодчиненных()
Англоязычный синоним:
NumberOfDependents
Возвращаемое значение:
Количество «подчиненных» видов расчета.
Описание:
Метод КоличествоПодчиненных возвращает количество «подчиненных» видов расчета (для которых необходимо произвести перерасчеты согласно данного правила).
Пример:
Колич = ПравилоПерерасчета.Доплаты.КоличествоПодчиненных();
КоличествоПолей
Возвращает количество полей базы.
Синтаксис:
КоличествоПолей()
Англоязычный синоним:
FieldCount
Возвращаемое значение:
Числовое значение — количество полей базы.
Описание:
Метод КоличествоПолей возвращает количество полей базы. Может быть использован при работе с базой данных неизвестной заранее структуры.
Пример:
Процедура ОписПол()
Перем Назв;
Перем Тип;
Перем Длин;
Перем Точн;
СпЗнач = СоздатьОбъект("СписокЗначений");
СпЗнач.УдалитьВсе();
Для КП = 1 По ДБФ.КоличествоПолей() Цикл
ДБФ.ОписаниеПоля(КП, Назв, Тип, Длин, Точн);
СпЗнач.ДобавитьЗначение("" + КП + "; " + Назв + "; " + Тип + "; " + Длин +
"; "+Точн);
КонецЦикла;
КонецПроцедуры
КоличествоПроводок
Оперделяет количество проводок в операции включая и проводки и корреспонденции.
Синтаксис:
КоличествоПроводок()
Англоязычный синоним:
EntriesCount
Возвращаемое значение:
Целое число — количество проводок в текущей операции.
Описание:
Метод позволяет опеределить полное количество проводок и корреспонденции в операции.
Пример:
Опер = СоздатьОбъект("Операция");
Опер.НайтиОперацию(ВыбрДокумент);
Для Инд = 1 До Опер.КоличествоПроводок() Цикл
Опер.ПолучитьПроводкуПоНомеру(Инд);
КонецЦикла;
КоличествоСерий
Явно устанавливает количество серий диаграммы.
Синтаксис:
КоличествоСерий(<Количество>)
Англоязычный синоним:
SeriesCount
Параметры:
<Количество> |
Числовое выражение, которое задает количество серий диаграммы. |
Возвращаемое значение:
Текущее значение количества серий (до исполнения метода).
Описание:
Метод КоличествоСерий явно устанавливает количество серий диаграммы. Количество серий может быть изменено и в режиме визуальной настройки. Альтернативой использования этого метода является неявное изменение количества серий: в случае если в метод, одним из параметров, использующий номер серии, передается значение превышающее количество серий, количество серий будет неявно увеличено.
Пример:
Диагр.КоличествоСерий(3); // установим количество серий 3
КоличествоСтрок
Определить количество строк в документе.
Синтаксис:
КоличествоСтрок()
Англоязычный синоним:
LinesCnt
Возвращаемое значение:
Числовое значение — количество строк в документе.
Описание:
Метод КоличествоСтрок позволяет определить количество строк в многострочной части документа.
Пример:
Сообщить("Документ: " + Вид() + " № " + НомерДок + " от " + ДатаДок +
" в документе " + КоличествоСтрок() + " строк");
КоличествоСтрок
Устанавливает/возвращает количество строк в таблице значений,
Синтаксис:
КоличествоСтрок(<НовоеКоличествоСтрок>)
Англоязычный синоним:
LinesCnt
Параметры:
<НовоеКоличествоСтрок> |
Необязательный параметр. Новое количество строк в таблице значений. |
Возвращаемое значение:
Числовое значение — количество строк в таблице значений до вызова метода.
Описание:
Метод КоличествоСтрок устанавливает/возвращает количество строк в таблице значений
Пример:
Разм = ТаблицаТоваров.КоличествоСтрок();
КоличествоСтрок
Возвратить количество строк текста.
Синтаксис:
КоличествоСтрок()
Англоязычный синоним:
LinesCnt
Возвращаемое значение:
Количество строк в тексте.
Описание:
Метод КоличествоСтрок возвращает количество строк в тексте.
Пример:
Процедура ЗагрузкаПродукцииПоКаталогу()
Прод = СоздатьОбъект("Справочник.ГотоваяПродукция");
Если ВыбГруппа.Выбран() = 0 Тогда
Предупреждение("Ошибка! Не выбрана группа!");
Возврат;
ИначеЕсли ВыбГруппа.ЭтоГруппа() = 0 Тогда
Предупреждение("Не выбрана группа! Загрузка в корень!");
Иначе
Тов.ИспользоватьРодителя(ВыбГруппа);
КонецЕсли;
Текст = СоздатьОбъект("Текст");
Текст.Открыть(ИмяФайла);
Если Текст.КоличествоСтрок() = 0 Тогда
Предупреждение("Текст пустой!");
Возврат;
КонецЕсли;
Для Ном = 1 По Текст.КоличествоСтрок() Цикл
Стр = Текст.ПолучитьСтроку(Ном);
Поле = 0;
Пока СтрДлина(Стр) > 0 Цикл
Поле = Поле + 1;
Инд = Найти(Стр, "-");
Если Инд > 0 Тогда
Стр1 = Сред(Стр, 2, Инд - 3);
Стр = Сред(Стр, Инд + 1);
Иначе
Стр1 = Сред(Стр, 2, (СтрДлина(Стр) - 2));
Стр = "";
КонецЕсли;
Если Поле = 1 Тогда
Код = Стр1;
ИначеЕсли Поле = 2 Тогда
Имя = Стр1;
КонецЕсли;
КонецЦикла;
Прод.НоваяГруппа();
Сообщить(Формат(Ном, "ЧЗ") + "-загрузка: " + Формат(Код, "45") + ":" + Имя);
Прод.Наименование = Имя;
Прод.Код = Число(Код);
Прод.Записать();
Сообщить(" — Загружен!");
КонецЦикла;
КонецПроцедуры
КоличествоСубконто
Определяет количество субконто у текущего счета.
Синтаксис:
КоличествоСубконто()
Англоязычный синоним:
SubcontoCount
Возвращаемое значение:
Число — количество видов субконто у текущего счета.
Описание:
Максимальное количество видов субконто, которое можно «прикрепить» к счету, устанавливается в конфигураторе при редактировании свойств планов счетов. Количество субконто, которое реально прикреплено к счету, не может превышать установленного максимального количества.
Метод КоличествоСубконто служит для определения количества видов субконто, прикрепленных к текущему счету в плане счетов.
Необходимо обратить внимание, что все виды субконто, прикрепленные к счету в плане счетов, имеют порядковые номера. Эти номера выдаются в названиях колонок видов субконто в окне редактирования плана счетов; «Субконто1», «Субконто2» ... «Субконто6».
При задании видов субконто для счета их обязательно «выстраивать» по порядку один за другим: например, к счету могут быть прикреплены субконто таким образом, что их порядковые номера будут 1 и 2. Метод КоличествоСубконто возвращает общее количество видов субконто, прикрепленное к счету (в данном примере — 2), а не максимальное количество возможных видов субконто у счета.
Пример:
Сч = СоздатьОбъект("Счет.Основной");
Сч.НайтиПоКоду("76.02");
Для Инд = 1 По Сч.КоличествоСубконто() Цикл
Сообщить("Субконто " + Сч.ВидСубконто(Инд));
КонецЦикла;
КоличествоТочек
Явно устанавливает количество точек диаграммы.
Синтаксис:
КоличествоТочек(<Количество>)
Англоязычный синоним:
PointsCount
Параметры:
<Количество> |
Числовое выражение, которое задает количество точек диаграммы. |
Возвращаемое значение:
Текущее значение количества точек (до исполнения метода).
Описание:
Метод КоличествоТочек явно устанавливает количество точек диаграммы. Количество точек может быть изменено и в режиме визуальной настройки. Альтернативой использования этого метода является неявное изменение количества точек: в случае если в метод, одним из параметров, использующий номер точек, передается значение превышающее количество точек, количество точек будет неявно увеличено.
Пример:
Диагр.КоличествоТочек(4); // установим количество точек 4
КоличествоВедущих
Возвращает количество «ведущих» видов расчета.
Синтаксис:
КоличествоВедущих()
Англоязычный синоним:
NumberOfLeadings
Возвращаемое значение:
Количество «ведущих» видов расчета.
Описание:
Метод КоличествоВедущих возвращает количество «ведущих» видов расчета (при вводе которых в журнал расчетов необходимо произвести перерасчеты согласно данного правила).
Пример:
// выведем все виды расчета от которых зависят доплаты
Для Сч = 1 По ПравилоПерерасчета.Доплаты.КоличествоВедущих() Цикл
Сообщить(ПравилоПерерасчета.Доплаты.ПолучитьВедущий(Сч));
КонецЦикла;
КоличествоЗаписей
Возвращает количество записей в базе.
Синтаксис:
КоличествоЗаписей()
Англоязычный синоним:
RecCount
Возвращаемое значение:
Числовое значение — количество записей в базе.
Описание:
Метод КоличествоЗаписей возвращает количество записей в базе вместе с записями, помеченными, как удаленные.
Пример:
Предупреждение("Записей — " + Строка(ДБФ.КоличествоЗаписей()));
КоличествоЗначений
Определить общее количество значений в данном виде перечисления.
Синтаксис:
КоличествоЗначений()
Англоязычный синоним:
Count
Возвращаемое значение:
Число общего количества значений в данном виде перечисления.
Описание:
Метод КоличествоЗначений применяется к конкретному виду перечисления и позволяет определить общее количество значений в данном виде перечисления.
Пример:
// отобразим все значения перечисления
Всего = Перечисление.ВидыТоваров.КоличествоЗначений();
Пока Ном = 1 По Всего Цикл
Сообщить(Перечисление.ВидыТоваров.ЗначениеПоНомеру(Ном));
КонецЦикла;
КоличествоЗначений
Получить общее количество планов счетов.
Синтаксис:
КоличествоЗначений()
Англоязычный синоним:
Count
Возвращаемое значение:
Числовое значение: количество планов счетов конфигурации.
Описание:
Метод КоличествоЗначений применяется к атрибуту глобального контекста ПланыСчетов и позволяет определить общее количество планов счетов созданных в конфигурации.
Пример:
Для Инд=1 По ПланыСчетов.КоличествоЗначений() Цикл
ПлСч = ПланыСчетов.ЗначениеПоНомеру(Инд);
КонецЦикла;
КоличествоЗначений
Получить общее количество видов субконто.
Синтаксис:
КоличествоЗначений()
Англоязычный синоним:
Count
Возвращаемое значение:
Числовое значение: количество видов субконто конфигурации.
Описание:
Метод КоличествоЗначений применяется к атрибуту глобального контекста ВидыСубконто и позволяет определить общее количество видов субконто, созданных в конфигурации.
Пример:
Для Инд = 1 По ВидыСубконто.КоличествоЗначений() Цикл
ВидСк = ВидыСубконто.ЗначениеПоНомеру(Инд);
КонецЦикла;
КомандаСистемы
Вызывает на исполнение команду DOS.
Синтаксис:
КомандаСистемы(<СтрокаКоманды>)
Англоязычный синоним:
System
Параметры:
<СтрокаКоманды> |
Строковое выражение, содержащее строку команды. |
Описание:
Процедура КомандаСистемы вызывает на исполнение команду, как если бы она была введена в командной строке DOS. При выполнении команды загружается исполняемый файл как «верхняя», активная программа.
Если загружается Windows-приложение, то управление немедленно возвращается в систему 1С:Предприятие на следующий за оператором КомандаСистемы оператор и система продолжает выполняться как фоновая прикладная программа. Пользователь может возвратиться в запускающую программу или закончив выполнение запущенной, или переключившись обратно посредством списка задач Windows.
Если в параметре <СтрокаКоманды> не содержится путь к загружаемой программе в файловой системе к программе, то поиск происходит в следующей последовательности:
- текущий системный каталог;
- каталог Windows;
- системный каталог Windows;
- все каталоги, указанные в переменной PATH;
Пример:
* В данном примере запускается редактор текста notepad.exe и в него загружается файл textl. txt.
КомандаСистемы("notepad textl.txt");
Команды организации механизма заполнения документа методом подбора
При вводе документа, процесс заполнения реквизитов многострочной части документа может быть реализован как обычным способом, так и при помощи специального механизма — методом подбора. Этот механизм предназначен для ускорения интерактивного заполнения значений реквизитов документов типа «справочник» и «документ». Реальным примером может служить процесс заполнения спецификации накладной путем подбора нужных товаров из справочника "Товары".
В системе 1С:Предприятие для реализации подбора предназначены следующие системные процедуры:
ОткрытьПодбор;
Активизировать;
АктивизироватьСтроку.
Кроме того, при обработке выбранных в подборе значений участвует следующая системная предопределенная процедура:
ОбработкаПодбора.
![](image/jelementjazyka_1.gif)
This site is hosted for FREE on VirtualAve -- yours can be, too! Click here for more information.
в исходном тексте программного модуля
Комментарий используется для размещения в исходном тексте программного модуля всякого рода пояснений к работе модуля. Хорошим тоном программирования считается, когда исходный текст содержит исчерпывающий комментарий с описанием алгоритма. В режиме исполнения программы комментарии пропускаются. В тексте программного модуля комментарий начинается парой символов "//" и заканчивается концом строки. Это значит, что комментарий можно начинать с начала строки или записывать его после оператора на той же строке. После начала комментария писать оператор на той же строке нельзя, необходимо закончить комментарий концом строки.
Пример:
А=В; // Это – комментарий
// Это тоже комментарий
Атрибут Комментарий дает доступ
Описание корректной проводки.
Синтаксис:
Комментарий
Англоязычный синоним:
Description
Описание:
Атрибут Комментарий дает доступ к значению описания корректной проводки.
Пример:
КП = СоздатьОбъект("КорректныеПроводки");
КП.ВыбратьКорректныеПроводки();
Пока КП.ПолучитьКорректнуюПроводку() = 1 Цикл
Сообщить(КП.Комментарий);
КонецЦикла;
в тексте описания запроса начинается
Комментарий в тексте описания запроса начинается парой символов //и заканчивается концом строки.
Пример:
// Это — комментарий
Группировка Кат; // Это тоже комментарий
КонДата
Конечная дата периода, за который извлекаются результаты запроса.
Синтаксис:
КонДата
Англоязычный синоним:
EndDate
Описание:
Атрибут КонДата содержит конечную дату периода, за который извлекаются итоги при использовании методов обхода периодов ВыбратьПериоды и ПолучитьПериод.
Пример:
БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, , , , , "Месяц");
БухИтоги.ВыбратьСчета();
Пока БухИтоги.ПолучитьСчет() = 1 цикл
БухИтоги.ВыбратьПериоды();
Пока БухИтоги.ПопучитьПериод() = 1 цикл
Сообщить("С " + БухИтоги.НачДата.Код + " по " + БухИтоги.КонДата +
" ДО = " + БухИтоги.ДО());
КонецЦикла;
КонецЦикла;
КонецИнтервала
Возвратить дату конца интервала журнала.
Синтаксис:
КонецИнтервала()
Англоязычный синоним:
EndOfRange
Возвращаемое значение:
Значение даты конца интервала журнала.
Описание:
Метод КонецИнтервала позволяет получить дату конца интервала журнала.
Данный метод доступен только в контексте Модуля формы журнала документов (см. «Виды программных модулей»).
Пример:
КИ = КонецИнтервала();
КонецИнтервала
Возвратить дату конца интервала журнала операций.
Синтаксис:
КонецИнтервала()
Англоязычный синоним:
EndOfRange
Возвращаемое значение:
Значение типа «Дата» — конечная дата интервала журнала операций.
Описание:
Метод КонецИнтервала позволяет получить конечную дату интервала журнала операций.
Данный метод доступен только в контексте модуля формы журнала операций (см. «Виды программных модулей»).
Пример:
КИ = КонецИнтервала();
КонецИнтервала
Возвратить дату конца интервала журнала проводок.
Синтаксис:
КонецИнтервала()
Англоязычный синоним:
EndOfRange
Возвращаемое значение:
Значение типа «Дата» — конечная дата интервала журнала проводок.
Описание:
Метод КонецИнтервала позволяет получить конечную дату интервала журнала проводок.
Данный метод доступен только в контексте модуля формы журнала проводок (см. «Виды программных модулей»).
Пример:
КИ = КонецИнтервала();
КонецПериода
Возвращает дату конца периода формирования запроса.
Синтаксис:
КонецПериода()
Англоязычный синоним:
EndOfPeriod
Возвращаемое значение:
Значение типа «дата» — конец периода формирования запроса.
Описание:
Метод КонецПериода возвращает дату конца периода запроса. Если в тексте запроса (см. «Язык запросов») указана одна из предопределенных группировок типа период ("Год" , "Месяц" , "День" и т. д.), то при обработке этой и вложенных в нее группировок метод КонецПериода будет возвращать конец периодов текущих значений этих группировок.
Пример:
ДатаКонца = Запрос.КонецПериода();
КонецПериодаБИ
Возвращает дату конца периода бухгалтерских итогов.
Синтаксис:
КонецПериодаБИ()
Англоязычный синоним:
EndOfРег1odBT()
Возвращаемое значение:
Значение типа «Дата» — дата конца периода бухгалтерских итогов.
Описание:
Метод КонецПериодаБИ возвращает дату конца периода бухгалтерских итогов, заданную в режиме «Настройка параметров системы».
Пример:
Дата2 = КонецПериодаБИ();
КонецПериодаПоДате
Возвращает дату окончания произвольного расчетного периода.
Синтаксис:
КонецПериодаПоДате(<Дата>)
Англоязычный синоним:
PeriodEndByDate
Параметры:
<Дата> |
Любая дата, которая попадает в требуемый период. |
Возвращаемое значение:
Значение типа «дата» — окончание расчетного периода журнала расчетов.
Описание:
Метод позволяет определить дату окончания того периода журнала расчетов, в который попадает заданная дата. Работа метода не зависит от наличия в журнале расчетов данных за соответствующий расчетный период.
Пример:
См. предыдущий пример.
См. также: НачалоПериодаПоДате
КонецРассчитанногоПериодаБИ
Возвращает последнюю дату рассчитанных бухгалтерских итогов.
Синтаксис:
КонецРассчитанногоПериодаБИ()
Англоязычный синоним:
EndOfCalculatedРег1odBT()
Возвращаемое значение:
Значение типа «Дата» — последняя дата рассчитанных бухгалтерских итогов.
Описание:
Метод КонецРассчитанногоПериодаБИ возвращает последнюю дату рассчитанных бухгалтерских итогов, заданную в режиме «Управление бухгалтерских итогов» при работе в режиме «1С:Предприятие».
Данная функция позволяет определить, до какой даты может быть выполнено обращение к бухгалтерским итогам.
Пример:
Если Дата2 > КонецРассчитанногоПериодаБИ() Тогда
Сообщить("Период не рассчитан!");
Возврат;
КонецЕсли;
КонецСтандартногоИнтервала
Устанавливает вариант задания конца стандартного интервала ото бражения журнала документов.
Синтаксис:
КонецСтандартногоИнтервала(<Вариант>)
Англоязычный синоним:
EndOfStandardRange
Параметры:
<Вариант> |
Необязательный параметр. Выражение со значением типа строка или дата. Возможные строковые значения параметра: "День", "Месяц", "Квартал", "Год", "Day", "Month", "Quarter", "Year". Значением типа «дата» задается конкретная дата конца интервала журнала документов. Если параметр не задан, то установка сделанная в параметрах системы не меняется, а только возвращается текущий вариант. |
Возвращаемое значение:
Возвращает текущий установленный вариант.
Описание:
Функция КонецСтандартногоИнтервала устанавливает вариант задания конца стандартного интервала отображения журнала документов. Вариант может изменяться при помощи главного меню Сервис-Параметры-Общие.
Пример:
КонецСтандартногоИнтервала("Месяц");
КонецТекущегоПериода
Возвращает дату окончания текущего расчетного периода.
Синтаксис:
КонецТекущегоПериода();
Англоязычный синоним:
CurrentPeriodEnd
Возвращаемое значение:
Значение типа «дата» — окончание текущего расчетного периода журнала расчетов.
Описание:
Возвращает дату окончания текущего расчетного периода журнала расчетов. Текущий расчетный период — это отрезок времени, обсчитываемый журналом расчетов в настоящее время. См. описание метода НачалоТекущегоПериода.
Пример:
// ЖРЗарп = СоздатьОбъект("ЖурналРасчета.Зарплата");
Календ = СоздатьОбъект("Календарь.Служащие");
НормаОтработки = Календ.Дней(ЖРЗарп.НачалоТекущегоПериода(),
ЖРЗарп.КонецТекущегоПериода());
См. также: НачалоТекущегоПериода, ПериодДействия, ПериодРегистрации
КонГода
Определить дату конца года.
Синтаксис:
КонГода(<Дата>)
Англоязычный синоним:
EndOfYear
Параметры:
<Дата> |
Выражение со значением типа «дата». |
Возвращаемое значение:
Результирующая дата.
Описание:
Функция КонГода определяет дату конца года для указанной даты.
Пример:
ПатаКонцаГода = КонГода(РабочаяДата());
Конкретизация переменной
Конкретизация переменной — это уточнение описания внутренней переменной, если это возможно в текущем контексте. Конкретизации переменной могут использоваться в языке запросов в операторах Группировка ... Упорядочить По и в качестве аргумента оператора Функция (см. далее).
Синтаксис:
<ВнутренняяПеременная>[.<Путь>]+;
Параметры:
<ВнутренняяПеременная> |
Идентификатор объявленной ранее внутренней переменной. |
<Путь> |
Доступный атрибут внутренней переменной или конкретизации переменной (см. «Атрибуты, доступные при описании внутренних переменных»). |
Пример:
Запрос = СоздатьОбъект("Запрос");
ТекстЗапроса =
" //{{ЗАПРОС(ОбработкаДок)
|Период с '01.10.96' по '05.10.96';
|ОбрабатыватьДокументы Все;
|Тов = Справочник.Товары.ТекущийЭлемент, Документ.РасхНакл.Товар;
| // используем конкретизацию внутренней переменной Тов
|Группировка Тов Упорядочить По Тов.Наименование;
|Группировка Документ;
|Группировка СтрокаДокумента;
|"//}}ЗАПРОС
// Если ошибка в запросе, то выход из процедуры
Если Запрос.Выполнить(ТекстЗапроса) = 0 Тогда
Возврат;
КонецЕсли;
Внимание! Запрос не манипулирует величинами типа «Строка неограниченной длины».
КонКвартала
Определить дату конца квартала.
Синтаксис:
КонКвартала(<Дата>)
Англоязычный синоним:
EndOfQuart
Параметры:
<Дата> |
Выражение со значением типа «дата». |
Возвращаемое значение:
Результирующая дата.
Описание:
Функция КонКвартала определяет дату конца квартала для указанной даты.
Пример:
ДатаКонцаКвартала = КонКвартала(РабочаяДата());
КонМесяца
Определить дату конца месяца.
Синтаксис:
КонМесяца(<Дата>)
Англоязычный синоним:
EndOfMonth
Параметры:
<Дата> |
Выражение со значением типа «дата». |
Возвращаемое значение:
Результирующая дата.
Описание:
Функция КонМесяца определяет дату конца месяца для указанной даты.
Пример:
ДатаКонцаМесяца = КонМесяца(РабочаяДата());
КонНедели
Определить дату конца недели.
Синтаксис:
КонНедели(<Дата>)
Англоязычный синоним:
EndOfWeek
Параметры:
<Дата> |
Выражение со значением типа «дата». |
Возвращаемое значение:
Результирующая дата.
Описание:
Функция КонНедели определяет дату конца недели для указанной даты.
Пример:
ДатаКонцаНедели = КонНедели(РабочаяДата());
КонПериода
Выдает конечную дату установленного в данный момент периода основных итогов.
Синтаксис:
КонПериода()
Англоязычный синоним:
EndOfPeriod
Возвращаемое значение: Конечная дата периода.
Описание:
Метод КонПериода используется для определения конечной даты основных итогов выдаваемых объектом.
Пример:
Сообщить(ПериодСтр(БухИтоги.НачПериода(), БухИтоги.КонПериода());
Константы
Язык содержит следующие типы констант:
Числовая константа описывается следующей синтаксической диаграммой:
[+|-][0-9]+ | [0-9]*.[0-9]+
Пример:
-17
43.712
.43842
Строковая константа — это строка, заключенная в двойные кавычки.
Пример:
"Это текстовая константа" // ОК
"Это ошибочная константа
и должна находиться на одной строке" // Ошибка
Константа типа "дата" задается в виде строки, заключенной в одинарные кавычки, в формате 'ДД.ММ.ГГ' или 'ДД.ММ.ГГГГ'.
Пример:
'21.05.96'
'25.09.1964'
Константы даты
Дата задается в формате 'ДД.ММ.ГГ' или 'ДД.ММ.ГГГГ' (дата заключается в одиночные кавычки). Неопределенная дата задается как '00.00.00'.
Пример:
'12.04.95' '01.01.1996'
Контекст работы с бухгалтерскими итогами
Обращение к бухгалтерским итогам выполняется посредством агрегатного объекта типа «БухгалтерскиеИтоги» (Англоязычный синоним: BookkeepingTotals). Объект такого типа должен быть создан при помощи функции СоздатьОбъект
БухИтоги = СоздатьОбъект("БухгалтерскиеИтоги");
Таких объектов может быть в системе несколько (любое необходимое количество). Объект может создаваться непосредственно перед использованием или в глобальном модуле (с объявлением экспортируемой переменной). При этом следует иметь в виду, что различные установки, назначаемые объекту будут действовать до их переустановки или удаления объекта. Поэтому обычно данный объект создается перед его использованием.
Механизм бухгалтерских итогов, поддерживаемый компонентой «Бухгалтерский учет» системы 1С:Предприятие релизует хранение накопленных итогов для обеспечения быстрого обращения к ним при составлении отчетов и выполнения различных вычислений.
Хранение итогов поддерживается системой с детализацией до месяца. Кроме того, хранятся не все возможные итоги, а те, обращение к которым выполняется наиболее часто — это остатки и обороты по счетам с детализацией по объектам аналитики (субконто), а также обороты между счетам (без учета аналитики).
Обращение к этим итогам выполняется системой непосредственно. Для получения других итогов (с детализацией меньше месяца, с получением оборотов между различными объектами аналитики, а также сложных выборок) требуется выполнение предварительных действий — временного расчета или запроса.
Объект «БухгалтерскиеИтоги» может работать в 3-х различных режимах:
работа с основными итогами;
работа с временными итогами;
работа в режиме запроса;
При создании объекта он работает в режиме работы с основными итогами. Переключение его в остальные режимы выполняется методами Рассчитать и ВыполнитьЗапрос. В зависимости от режима изменяется состав и использование атрибутов и методов объекта.
Кроме того некоторые установки объекта влияют на получение итогов во всех режимах. К ним относятся установки используемого плана счетов и разделителя учета.
Контекст работы с бухгалтерскими счетами
В синтаксисе языка доступ к атрибутам, а также вызов методов счетов зависит от контекста выполнения программного модуля.
Если счет входит (согласно локальному контексту) в набор непосредственно Доступных модулю значений агрегатных типов данных (см. «Виды программ-йьгх модулей»), то доступ к атрибутам и вызов метода для этого счета — просто имя этого атрибута или метода с указанием необходимых параметров.
Пример:
* Модуль формы счета выполняется в контексте «Счет». Поэтому в модуп возможен непосредственный доступ к текущему счету. Например, для пои сваивания счету наименования запишем:
Наименование = "Основные средства";
Значение счета может быть получено из других источников, например, как реквизит документа. В этом случае обращение к атрибутам и методам такого документа представляет собой сложное выражение, где имена реквизитов разделяются точкой.
Пример:
* Например, в структуре документа «ПриходныйОрдер» существует реквизит «КоррСчет» типа «Счет». Тогда получить наименование счета, указанного в этом реквизите, можно следующим образом
НаименованиеСчета = Док.КоррСчет.Наименование;
В других случаях, доступ к атрибутам, вызов методов конкретного счета происходит при помощи переменной со ссылкой на объект типа «Счет». Объект создается функцией СоздатьОбъект, ссылка на который присваивается переменной. Чтобы вызвать атрибут или метод объекта, имя этого атрибута или метода (с указанием необходимых параметров) пишется через точку после имени ссылки.
При создании ссылки на объект типа «Счет» при помощи функции СоздатьОбъект в качестве типа объекта указывается слово "Счет" и может быть через точку указан вид — идентификатор плана счетов.
Полное имя типа счет записывается следующим образом:
Счет.<ВидСчета>
где <ВидСчета> — идентификатор плана счетов.
Применение ключевого слова "Счет" (без вида счета) используется для организации доступа ко всем планам счетов.
Англоязычный синоним ключевого слова Счет — Account.
Замечание: Следует обратить особое внимание, что переменная типа «Счет», созданная функцией СоздатьОбъект — это ссылка на список счетов, в отличие от переменных, содержащих само значение объекта (например, переменной может быть присвоено значение некоторого реквизита документа, который имеет тип «Счет»). Использование ссылки на список счетов, созданной при помощи функции СоздатьОбъект, существенно отличается от работы со значением типа «Счет». Только при работе со объектом-ссылкой на список счетов разрешено изменять позицию (найти-выбрать...) текущего счета в списке (т. е. осуществлять позиционирование по списку счетов), создавать новые, изменять и удалять существующие счета, С другой стороны, ссылка на список счетов не содержит собственно значения конкретного счета, которое можно присвоить чему-либо. Однако. его всегда можно получить, используя функцию ТекущийСчет.
Замечание. Объект, созданный при помощи функции СоздатьОбъект, изначально не определен, т. е. не содержит никакого значения. Чтобы начать с ним работать, его предварительно надо позиционировать (установить на конкретный счет) при помощи процедур НайтиСчет, ПолучитьСчет и т. п.
Пример:
*
Сч = СоздатьОбъект("Счет");
Сч1 = СоздатьОбъект("Счет.ОснПлан");
Сч2 = СоздатьОбъект("Счет.РабПлан");
*
//В модуле формы счета // меняем наименование счета
Наименование = "Новый счет";
*
Сч1 = СоздатьОбъект("Счет.ОснПлан");
// создаем новый счет Сч1.Новый();
Сч1.Код = "12.01";
Сч1.Записать();
Контекст работы с диаграммами
Для использования диаграмм нужно в табличный документ 1С:Предприятия внедрить объект «Диаграмма», используя специальную кнопку инструментальной панели или через главное меню <Таблица>-<Вставить рисунок>-<Диаграмма>.
Процесс внедрения объекта «Диаграмма» в табличный документ подробно описан в документации к 1С:Предприятию (см. книгу «Руководство по конфигурированию и администрированию»). После внедрения объект нужно активизировать, например, двойным щелчком указателя мыши, и настроить его внешний вид.
Настройка диаграммы обычно проводится на этапе конфигурирования. Задача настройки состоит в определении формата, специфического для каждой из областей диаграммы, их размера и расположения.
В свойствах объекта есть закладка «Текст». В поле «Текст» этой закладки нужно внести вызов процедуры, управляющей объектом диаграммы. Сам объект «Диаграмма», в момент вызова этой процедуры, является текущим объектом таблицы (см. атрибут объекта «Таблицы» ТекущийОбъект) и передается в процедуру как параметр. Например, этот вызов будет выглядеть так:
ПостроитьДиаграмму(Таб.ТекущийОбъект);
Наполнение диаграммы данными осуществляется в теле вызываемой процедуры с помощью атрибутов и методов данного объекта.
Таким образом, во всех программных модулях доступ к атрибутам и вызов методов деловой графики может выполняться только при помощи переменной со ссылкой на объект типа «Диаграмма». Данный объект внедряется в таблицу 1С:Предприятие при конфигурировании. При инициировании построения диаграммы, значение этого объекта в качестве фактического параметра передается в обрабатывающую процедуру, где ссылка на объект становится доступна через идентификатор фиктивного параметра. Чтобы вызвать метод деловой графики, имя метода (с указанием необходимых параметров) пишется через точку после идентификатора переменной.
См. также: ТекущийОбъект
Контекст работы с документами
В синтаксисе языка доступ к атрибутам, а также вызов методов документов зависит от контекста выполнения программного модуля.
Если конкретный документ входит (согласно локального контекста) в набор непосредственно доступных модулю значений агрегатных типов данных (см. «Виды программных модулей»), то доступ к атрибуту, вызов метода для этого документа — просто имя этого атрибута, метода с указанием необходимых параметров.
Пример:
* В форме редактирования документа «Накладная» мы имеем непосредственный доступ к текущему документу (накладной). Значит, чтобы изменить номер накладной, запишем:
НомерДок = "12345678";
* В форме редактирования документа «Приказ на зачисление» мы имеем непосредственный доступ к реквизитам этого документа. Значит, чтобы записать имя нового сотрудника, пишем:
ФИО = "Иванов И.И.";
Значение документа может быть получено из других источников, например как реквизит другого документа. В этом случае обращение к атрибутам и методам такого документа представляет собой сложное выражение, где имена реквизитов разделяются точкой.
Пример:
* Допустим, у документа «Счет» есть реквизит «Накладная», который имеет тип «Документ.РасхНакл». Номер накладной можно получить следующим образом:
НомерРасхНакл=Документ.Счет.Накладная.НомерДок;
* Допустим, значение реквизита «Приказ» справочника «ПриказыНаДоплату» имеет тип «Документ.ПриказНаДоплату». Тогда номер приказа можно получить следующим образом:
Спр = СоздатьОбъект("Справочник.ПриказыНаДоплату");
// ...
Номер = Спр.Приказ.НомерДок;
В других случаях, доступ к атрибутам, вызов методов конкретного документа происходит при помощи переменной со ссылкой на объект типа «Документ». Объект создается функцией СоздатьОбъект, ссылка на который присваивается переменной. Чтобы вызвать атрибут или метод объекта, имя этого атрибута, метода (с указанием необходимых параметров) пишется через точку после имени ссылки.
При создании ссылки на объект типа «Документ» при помощи функции СоздатьОбъект в качестве имени документа может выступать ключевое слово Документ или полное имя вида документа.
Полное имя вида документа записывается следующим образом:
Документ.<Имя_Документа>
где <Имя_Документа> — имя вида документа, как он объявлен в конфигураторе.
Применение ключевого слова "Документ" (без указания вида документа) используется для организации доступа ко всему перечню документов независимо от вида. В этом случае методы ВыбратьДокументы и ПолучитьДокумент будут обрабатывать документы всех видов. Однако, для переменных, созданных таким вызовом функции СоздатьОбъект, будут недоступны процедуры поиска, выбора документа из диалога, ввода нового документа, которые подразумевают конкретный вид документа.
Англоязычный синоним ключевого слова Документ — Document.
Замечание: Следует обратить особое внимание, что переменная типа «Документ», созданная функцией СоздатьОбъект — это ссылка на список документов в отличие от переменных содержащих само значение объекта (например, переменной может быть присвоено значение реквизита справочника, который имеет тип «Документ»). Использование ссылки на список документов, созданной при помощи функции СоздатьОбъект существенно отличается от работы со значением типа «Документ». Только при работе со ссылкой на список документов разрешено изменять позицию (найти-выбрать...) текущего элемента в списке (т. е. осуществлять позиционирование по списку документов), создавать новые, изменять и удалять существующие документы. С другой стороны, ссылка на список документов не содержит собственно значения конкретного документа, которое можно присвоить чему-либо. Однако, его всегда можно получить, используя функцию ТекущийДокумент.
Замечание. Объект, созданный при помощи функции СоздатьОбъект, изначально не определен, т. е. не содержит никакого значения. Чтобы начать с ним работать, его предварительно надо позиционировать (установить на конкретный документ) при помощи процедур НайтиДокумент, НайтиПоНомеру, ПолучитьДокумент ит. п..
Пример:
*
Док = СоздатьОбъект("Документ");
Док1 = СоздатьОбъект("Документ.БольничныйЛист");
Контекст работы с Файлами
Во всех программных модулях для работы с файлами следует использовать методы объекта типа «ФС». По умолчанию в системе всегда доступен уже существующий объект с именем ФС (англоязычный синоним — FS) (имя существующего объекта совпадает с названием типа данных), к которому можно непосредственно применять методы объекта ФС. Кроме того, можно создать произвольное число объектов типа «ФС» при помощи функции СоздатьОбъект. Чтобы вызвать метод объекта, имя метода (с указанием необходимых параметров) пишется через точку после имени объекта.
Англоязычный синоним ключевого слова ФС — FS.
Пример:
* Здесь приведены примеры различных способов вызова методов объекта «ФС».
ФС.УдалитьФайл("Текст1.txt");
ВАКФайлы = СоздатьОбъект("ФС");
ВАКФайлы.УдалитьФайл("Текст3.txt");