Основная страница

Глава 16
работа с бухгалтерскими счетами


Счета — это агрегатный тип данных для доступа к объектам данных — бухгалтерским счетам. Бухгалтерские счета используются компонентой «Бухгалтерский учет» системы 1С:Предприятие для идентификации разрезов синтетического учета наличия и движения средств. В общем виде смысл типа данных «Счет» вполне соответвует общепринятому понятию «Счет» в бухгалтерском учете. Подробно об основных свойствах типа данных «Счет» можно ознакомиться в руководстве по конфигурированию системы 1С:Предприятие.

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

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

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

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

Контекст работы с бухгалтерскими счетами

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

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

Пример:

* Модуль формы счета выполняется в контексте «Счет». Поэтому в модуп возможен непосредственный доступ к текущему счету. Например, для пои сваивания счету наименования запишем:

Наименование = "Основные средства";

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

Пример:

* Например, в структуре документа «ПриходныйОрдер» существует реквизит «КоррСчет» типа «Счет». Тогда получить наименование счета, указанного в этом реквизите, можно следующим образом

НаименованиеСчета = Док.КоррСчет.Наименование;

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

При создании ссылки на объект типа «Счет» при помощи функции СоздатьОбъект в качестве типа объекта указывается слово "Счет" и может быть через точку указан вид — идентификатор плана счетов.

Полное имя типа счет записывается следующим образом:

Счет.<ВидСчета>

где <ВидСчета> — идентификатор плана счетов.

Применение ключевого слова "Счет" (без вида счета) используется для организации доступа ко всем планам счетов.

Англоязычный синоним ключевого слова СчетAccount.

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

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

Пример:

*

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

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

Сч2 = СоздатьОбъект("Счет.РабПлан");

*

//В модуле формы счета // меняем наименование счета

Наименование = "Новый счет";

*

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

// создаем новый счет Сч1.Новый();

Сч1.Код = "12.01";

Сч1.Записать();

Атрибуты объекта «Счет»

Код

Полный код счета.

Синтаксис:

Код

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

Code

Описание:

Код счета в общем случае представляет собой символьную строку вида:

<Код счета>.<Код субсчета>.<Код субсчета> ...

Общая длина кода счета в системе 1С:Предприятие ограничена 255 символами. В это значение входят: код счета первого уровня, коды субсчетов всех нижележащих уровней и разделители номеров счета и субсчетов (точка). При помощи атрибута Код можно получать и задавать код счета.

Пример:

* При показе готового табличного документа (в данном примере это отчет «Карточка счета») в заголовке окна выдается наименование отчета и код счета, по которому построен отчет.

// Формирование отчета "Карточка счета"

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

// ...

<команды формирования отчета и выдачи секций табличного документа>

// ...

// Показ готового отчета

Табл.Показать("Карточка счета: " + Счет.Код);

Наименование

Наименование счета.

Синтаксис:

Наименование

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

Description

Описание:

Наименование счета представляет собой произвольную строку символов. Наименование, как правило, разъясняет назначение счета. Максимальная длина наименования счета задается при редактировании свойств планов счетов в Конфигураторе.

При помощи атрибута Наименование можно получать и задавать наименование счета.

Пример:

* При показе готового табличного документа (в данном примере это отчет «Карточка счета») в заголовке окна выдается наименование отчета, код и наименование счета, по которому построен отчет.

// Формирование отчета "Карточка счета"

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

// ...

<команды формирования отчета и выдачи секций табличного документа>

// ...

// Показ готового отчета

Табл.Показать("Карточка счета: " + Счет.Код + " " + Счет.Наименование);

Валютный

Признак ведения валютного учета.

Синтаксис:

Валютный

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

IsCurrency

Значение:

1 — валютный учет ведется по данному счету;

0 — валютный учет не ведется по данному счету;

Описание:

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

Пример:

Сч.Валютный = 1;

Количественный

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

Синтаксис:

Количественный

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

IsAmount

Значение:

1 — количественный учет ведется по данному счету;

0 — количественный учет не ведется по данному счету;

Описание:

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

Пример:

Сч.Количественный = 1;

Забалансовый

Признак забалансовости счета.

Синтаксис:

Забалансовый

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

IsSingle

Значение:

1 — выбранный счет является забалансовым счетом;

0 — выбранный счет является балансовым счетом.

Описание:

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

Пример:

Сч.Забалансовый = 1;

Активный

Тип остатка по счету (активный, пассивный, активно-пассивный).

Синтаксис:

Активный

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

IsActive

Значение:

1 — счет является активным;

2 — счет является пассивным;

3 — счет является активно-пассивным;

Описание:

Атрибут содержит тип остатка счета. Счет может являться активным, (остатки должны быть дебетовыми), пассивным (остатки должны быть кредитов выми), активно-пассивным (остатки могут быть дебетовыми и кредитовыми).

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

По умолчанию все счета считаются активно-пассивными.

Пример:

Сч.Активный = 2;

<Реквизит>

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

Синтаксис:

<Реквизит>

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

Описание:

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

Атрибут <Реквизит> позволяет обращаться к значениям дополнительных реквизитов выбранного счета. Для обращения к конкретному реквизиту должен быть указан его идентификатор, заданный для этого реквизита в конфигураторе.

Пример:

* Для счетов определен реквизит "Ответственный" типа "Справочник.Сотрудники".

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

Сч.ВыбратьСчета();

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

   Сч.Ответственный = ВыбСотр;

   Сообщить(Сч.Ответственный.Наименование);

   Сч.Записать();

КонецЦикла

Методы объекта «Счет»

ВыбратьСчета

Метод открывает выборку счетов из текущего плана счетов для последующей обработки.

Синтаксис:

ВыбратьСчета()

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

SelectAccounts

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

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

Описание:

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

Пример:

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

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

   Сч.ВыбратьСчета();

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

      Сообщить(Сч.Код);

   КонецЦикла;

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

ПолучитьСчет

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

Синтаксис:

ПолучитьСчет([<Режим>])

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

GetAccount

Параметры:

<Режим>

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

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

Число: 1 — следующий счет выбран успешно; 0 — следующий счет не выбран (отсутствует).

Описание:

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

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

Метод возвращает 0, когда очередной счет не выбран. Это происходит, если при предыдущем применении метода был выбран последний счет выборки.

Пример:

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

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

   Сч.ВыбратьСчета();

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

      Сообщить(Сч.Код);

   КонецЦикла;

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

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

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

Синтаксис:

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

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

SetAttrib

Параметры:

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

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

<3начение>

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

Описание:

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

Пример:

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

ПолучитьАтрибут

Получить значение реквизита по имени идентификатора.

Синтаксис:

ПолучитьАтрибут(<ИмяРеквизита>)

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

GetAttrib

Параметры:

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

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

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

Значение реквизита <ИмяРеквизита>.

Описание:

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

Пример:

ЦенаТов = Счт.ПолучитьАтрибут("ЦенаРозн");

Выбрать

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

Синтаксис:

Выбрать(<Подсказка>, <ФормаСписка>)

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

Choose

Параметры:

<Подсказка>

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

<ФормаСписка>

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

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

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

Описание:

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

Если счет выбран, метод возвращает 1 и позиционирует объект на выбранном счете.

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

Пример:

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

Сч.Выбрать("Выберите счет", "ДляВыбораВДиалоге");

НайтиПоКоду

Выполняет поиск счета в плане счетов по коду счета.

Синтаксис:

НайтиПоКоду(<КодСчета>)

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

FindByCode

Параметры:

<КодСчета>

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

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

Число: 1 — счет найден; 0 — счет не найден.

Описание:

Метод НайтиПоКоду выполняет поиск счета в плане счетов по коду счета, который передается методу в качестве параметра.

Если счет найден, метод возвращает 1 и позиционирует объект на выбранном счете.

Пример:

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

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

НайтиСчет

Метод выполняет поиск счета в плане счетов по значению типа «Счет».

Синтаксис:

НайтиСчет(<Счет>)

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

FindAccount

Параметры:

<Счет>

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

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

Число: 1 — счет найден; 0 — счет не найден.

Описание:

Метод НайтиСчет выполняет поиск счета по значению, заданному параметром <Счет>, и позиционирует объект на выбранном счете.

Пример:

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

Сч.НайтиСчет(ВыбСчет);

Выбран

Проверяет факт выбора счета.

Синтаксис:

Выбран()

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

Selected

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

Числ: 1 — если счет выбран (спозиционирован); 0 — если не выбран.

Описание:

Метод Выбран для объекта созданного функцией СоздатьОбъект определяет, спозиционирован ли объект на каком либо счете или нет, для объекта хранящего значение типа «Счет» он определяет является значение пустым или нет. Метод возвращает число со значением 1 — если счет выбран (спозиционирован) или значение не пустое, 0 — если не выбран или значение пустое.

Пример:

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

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

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

   Сообщить("Счет найден");

КонецЕсли;

ЗаданВКонфигурации

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

Синтаксис:

ЗаданВКонфигурации()

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

DefinedInConfiguration

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

Число: 1 — если счет задан в конфигурации; 0 — если счет введен в информационной базе.

Описание:

Метод ЗаданВКонфигурации определяет, задан текущий счет в конфигурации или в информационной базе.

Пример:

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

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

Если Сч.ЗаданВКонфигурации() = 1 Тогда

   Сообщить("Счет задан в Конфигурации ");

КонецЕсли;

Вид

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

Синтаксис:

Вид()

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

Kind

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

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

Описание:

Метод Вид позволяет определить план счетов, к которому относится данный счет. Метод возвращает идентификатор плана счетов в виде строки символов. Метод ПланСчетов позволяет получить значение типа «План счетов» к которому относится выбранный счет.

Пример:

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

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

Сообщить("Вид - " + Сч.Вид());

ПредставлениеВида

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

Синтаксис:

ПредставлениеВида()

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

KindPresent

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

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

Описание:

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

Пример:

// отобразим пользовательское представление в строке состояния

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

Состояние(Сч.ПредставлениеВида());

ПланСчетов

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

Синтаксис:

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

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

ChartOfAccounts

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

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

Описание:

Метод выдает план счетов (значение типа «План счетов»), которому принадлежит счет.

Пример:

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

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

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

// Выдает "План счетов - Основной"

ЭтоГруппа

Определяет, является ли данный счет группой.

Синтаксис:

ЭтоГруппа()

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

IsGroup

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

Число: 1 — счет является группой; 0 — счет не является группой.

Описание:

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

Данная функция определяет, является счет группой (может иметь субсчета) или нет.

Пример:

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

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

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

   Сообщить("Найдена группа");

КонецЕсли;

Уровень

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

Синтаксис:

Уровень()

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

Level

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

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

Описание:

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

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

##.#.###

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

Пример:

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

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

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

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

ТекущийСчет

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

Синтаксис:

ТекущийСчет()

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

CurAccount

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

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

Описание:

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

Кроме того, в контексте формы счета данный метод может выдать текущее (для открытой формы) значение типа «Счет».

Пример:

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

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

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

   Операция.Дебет.Счет = Сч.ТекущийСчет();

КонецЕсли;

ПометкаУдаления

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

Синтаксис:

ПометкаУдаления()

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

DeleteMark

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

1 — счет помечен на удаление;

0 — счет не помечен на удаление.

Описание;

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

Пример:

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

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

Если Сч.ПометкаУдаления() = 1 Тогда

   Сообщить("Счет помечен на удаление");

КонецЕсли;

ВыборГруппы

Устанавливает или сбрасывает признак выбора группы.

Синтаксис:

ВыборГруппы([<ПризнакВыбораГруппы>])

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

SelectGroup

Параметры:

<ПризнакВыбораГруппы>

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

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

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

Описание:

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

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

По умолчанию выбор группы разрешен, за исключением счетов дебета и кредита в проводках операции.

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

Пример:

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

Сч.ВыборГруппы(0);

Сч.Выбрать("Выберите конкретный счет");

ПринадлежитГруппе

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

Синтаксис:

ПринадлежитГруппе(<Счет>)

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

BelongsToGroup

Параметры:

<Счет>

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

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

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

Описание:

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

Пример:

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

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

Если Сч.ПринадлежитГруппе(СчетПоКоду("76")) = 1 Тогда

   Сообщить("Счет принадлежит группе");

КонецЦикла;

КоличествоСубконто

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

Синтаксис:

КоличествоСубконто()

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

SubcontoCount

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

Число — количество видов субконто у текущего счета.

Описание:

Максимальное количество видов субконто, которое можно «прикрепить» к счету, устанавливается в конфигураторе при редактировании свойств планов счетов. Количество субконто, которое реально прикреплено к счету, не может превышать установленного максимального количества.

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

Необходимо обратить внимание, что все виды субконто, прикрепленные к счету в плане счетов, имеют порядковые номера. Эти номера выдаются в названиях колонок видов субконто в окне редактирования плана счетов; «Субконто1», «Субконто2» ... «Субконто6».

При задании видов субконто для счета их обязательно «выстраивать» по порядку один за другим: например, к счету могут быть прикреплены субконто таким образом, что их порядковые номера будут 1 и 2. Метод КоличествоСубконто возвращает общее количество видов субконто, прикрепленное к счету (в данном примере — 2), а не максимальное количество возможных видов субконто у счета.

Пример:

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

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

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

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

КонецЦикла;

ВидСубконто

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

Синтаксис:

ВидСубконто(<НомерСубконто>, <ВидСубконто>, <ТолькоОбороты>)

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

SubcontoKind

Параметры:

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

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

<ВидСубконто>

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

<ТолькоОбороты>

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

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

Значение типа «Вид субконто».

Описание:

К любому счету или субсчету в плане счетов может быть «прикреплено» до 5 видов субконто. Максимальное количество видов субконто, которое можно «прикрепить» к счету, устанавливается в конфигураторе при редактировании свойств планов счетов. Количество субконто, которое реально прикреплено к счету, не превышает установленного максимального количества. Все виды субконто, прикрепленные к счету в плане счетов, имеют порядковые номера. Эти номера выдаются в названии колонок для видов субконто в окне редактирования плана счетов; «Субконто!», «Субконто2» ... «Субконто5».

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

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

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

Пример:

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

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

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

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

КонецЦикла;

ТолькоОбороты

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

Синтаксис:

ТолькоОбороты(<НомерСубконто>, <ТолькоОбороты>]

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

TurnoversOnly

Параметры:

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

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

<ТолькоОбороты>

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

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

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

Описание:

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

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

Пример:

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

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

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

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

         ?(Сч.ТолькоОбороты(Инд) = 1, "(об.)", ""));

КонецЦикла;

УчетПоСумме

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

Синтаксис:

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

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

AccountingBySum

Параметры:

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

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

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

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

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

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

Описание:

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

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

Пример:

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

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

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

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

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

КонецЕсли;

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

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

Синтаксис:

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

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

AccountingByCurrencySum

Параметры:

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

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

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

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

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

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

Описание:

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

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

Пример:

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

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

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

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

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

КонецЕсли;

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

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

Синтаксис:

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

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

AccountingByAmount

Параметры:

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

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

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

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

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

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

Описание:

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

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

Пример:

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

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

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

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

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

КонецЕсли;

ИспользоватьДату

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

Синтаксис:

ИспользоватьДату(<Дата>)

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

UseDate

Параметры:

<Дата>

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

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

Текущее значение используемой даты (на момент до исполнения метода). Описание:

Метод ИспользоватьДату устанавливает для объекта типа «Счет» дату, на которую будут в дальнейшем выбираться (или записываться) значения периодических реквизитов счета.

Данный метод, используется обычно, если нужно обращаться сразу к не-сколькитм периодическим реквизитам спозиционированного объекта. Для одиночных обращений рекомендуется использовать методы периодического реквизита счета Получить(<Дата>) и Установить(<Дата>, <3начение>) .

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

Замечание: Метод ИспользоватьДату устанавливает дату выборки для данного объекта. В случае, если обращение к объекту типа счет выполняется по длинному пути (например, Клиент.СчетУчета.СтатусУчета) значение типа «Счет» создается динамически и после первого обращения к нему с вызовом метода ИспользоватьДату уничтожается, поэому при повторном обращении для получении значения реквизита данная установка уже действовать не будет.

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

Пример:

* Выведем список счетов со значением периодического реквизита "СтатусУчета".

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

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

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

   Сч.ВыбратьСчета();

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

      Сообщить("Статус учета " + Сч.Код + " - " + Сч.СтатусУчета);

   КонецЦикла;

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

ИспользоватьПланСчетов

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

Синтаксис:

ИспользоватьПланСчетов(<ПланСчетов>)

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

UseChartOfAccounts

Параметры:

<ПланСчетов>

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

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

Значение типа «План Счетов». Текущее значение на момент до исполнения метода.

Описание:

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

Метод ИспользоватьПланСчетов имеет смысл использовать в том случае, если объект создан функцией СоздатьОбъект для работы с разными планами счетов — СоздатьОбъект("Счет"). Если объект был создан для работы с конкретным планом счетов, то все операции поиска и обхода счетов будут работать только с этим планом счетов.

Пример:

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

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

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

   Сч.ВыбратьСчета();

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

      Сообщить("Счет " + Сч.Код);

   КонецЦикла;

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

Родитель

Выдает счет вышестоящего уровня.

Синтаксис:

Родитель(<НомерУровня>)

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

Параметры:

<НомерУровня>   Необязательный параметр. Число — номер уровня. Определяет какого уровня вышестоящий счет должен быть выдан. Если параметр не указан -выдается непосредственный родитель.

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

Значение типа «Счет». Счет вышестоящего уровня данного счета.

Описание:

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

Пример:

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

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

Сообщить("Родитель " + Сч.Родитель());

//Возвращает "Родитель 76"

ИспользоватьРодителя

Устанавливает/выдает значение родителя (счета вышестоящего уровня), используемого для выборки счетов.

Синтаксис:

ИспользоватьРодителя(<Родитель>, <ФлагИзменения>)

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

UseParent

Параметры:

<Родитель>

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

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

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

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

Значение типа «Счет». Текущее значение используемого родителя на момент до исполнения метода.

Описание:

При наличии в плане счетов нескольких уровней счетов-субсчетов при переборе или выборе счета существует возможность отбирать только счета подчиненные некоторому счету. Метод ИспользоватьРодителя устанавливает значение, которе будет затем использовано методами перебора и выбора счета.

Пример:

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

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

   Сч.ИспользоватьРодителя(СчетПоКоду("01"));

   Сч.ВыбратьСчета();

   Пока Сч.ПолучитьСчет(0) = 1 Цикл

      Сообщить(Сч.Код);

   КонецЦикла;

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

КодСубсчета

Выдает код счета без кодов счетов вышестоящих уровней.

Синтаксис:

КодСубсчета()

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

SubAccountCode

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

Строковое значение — код счета без кодов счетов вышестоящих уровней.

Описание:

При наличии в плане счетов нескольких уровней счетов-субсчетов атрибут "Код" объекта типа «Счет» содержит полный код счета с учетом всех вышестоящих счетов через разделитель (точку). Метод КодСубсчета выдает собственно код даного счета без кодов счетов вышестоящих уровней.

Пример:

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

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

Сообщить("Код счета " + Сч.Код); //Возвращает "76.02"

Сообщить("Код Субсчета " + Сч.КодСубсчета); //Возвращает "76"

Блокировка

Установить/прочитать режим блокировки.

Синтаксис:

Блокировка(<ВклВыкл>)

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

Locking

Параметры:

<ВклВыкл>

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

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

Если при вызове метода параметр <ВклВыкл> не задан, то возвращается Режим блокировки до выполнения метода. Число: 1 — заблокирован; 0 — свободен.

Если при вызове метода параметр <ВклВыкл> задан, то возвращается результат выполнения метода блокировки. Число: 1 — успешно; 0 — не получилось.

Описание:

Метод Блокировка позволяет установить/прочитать режим блокировки.

Пример:

Блокировка(0);

Новый

Создает новый счет.

Синтаксис:

Новый(<ЕстьСубсчета>)

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

New

Параметры:

<ЕстьСубсчета>

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

0 — счет не будет иметь субсчета;

1 — счет будет иметь субсчета.

По умолчанию 0;

Описание:

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

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

Однако, если для счета, для которого было указано отсутствие субсчетов, все-таки введен субсчет, то система 1С:Предприятие выполнит следующее:

·         Будет создан новый счет (группа) с тем же кодом;

·         Код данного счета будет дополнен субсчетом 0;

В дальнейшем код субсчета 0 можно будет изменить на другой.

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

Пример:

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

Сч.Новый();

Сч.Код = "76.02";

Сч.Записать();

НазначитьТип

Назначить тип для реквизита неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяРеквизита>, <ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

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

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

<ИмяТипа>

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

"Строка", "Число", "Справочник.Товары", "Документ. РасходнаяНакладная" и т. п.

<Длина>

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

<Точность>

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

Описание:

Метод НазначитьТип позволяет назначить тип для реквизита, которому в конфигураторе назначен тип «Неопределенный».

Пример:

ВыбСчет.НазначитьТип("ТМЦ", "Справочник.Товары");

Записать

Записывает изменения счета.

Синтаксис:

Записать()

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

Write

Описание:

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

Замечание. Если этот метод применяется в Модуле формы счета непосредственно к счету локального контекста, то данный метод отрабатывает те же действия, как интерактивное нажатие пользователем кнопки с формулой "#Записать".

Пример:

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

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

Сч.Наименование = "Прочие взаиморасчеты";

Сч.Записать();

Удалить

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

Синтаксис:

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

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

Delete

Параметры:

<Режим>

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

Описание:

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

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

Пример:

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

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

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

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

Снять пометку удаления счета.

Синтаксис:

СнятьПометкуУдаления()

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

ClearDeleteMark

Описание:

Метод СнятьПометкуУдаления снимает пометку удаления текущего счета.

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

Пример:

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

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

Сч.СнятьПометкуУдаления();

Методы контекста Модуля формы списка счетов

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

ИспользоватьДату

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

Синтаксис:

ИспользоватьДату(<Дата>)

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

UseDate

Параметры:

<Дата>

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

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

Значение даты выборки периодических реквизитов формы списка счетов.

Описание:

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

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

Пример:

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

ИспользоватьПланСчетов

Установить (получить) текущий план счетов формы списка счетов.

Синтаксис:

ИспользоватьПланСчетов(<ПланСчетов>)

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

UseChartOfAccounts

Параметры:

<ПланСчетов>

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

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

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

Описание:

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

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

Пример:

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

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

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

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

ИспользоватьРодителя

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

Синтаксис:

ИспользоватьРодителя(<Родитель>, <ФлагИзменения>)

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

UseParent

Параметры:

<Родитель>

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

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

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

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

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

Описание:

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

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

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

Пример:

ИспользоватьРодителя(ВыбСчет, 1);

ИспользоватьКорСчет

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

Синтаксис:

ИспользоватьКорСчет(<Счет>, <Корреспонденция>)

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

UseCorAccount

Параметры:

<Счет>

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

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

Число: 1 — дебетовый счет; 0 — кредитовый счет.

Описание:

Метод ИспользоватьКорСчет устанавливает счет для показа списка корреспондирующих с ним счетов. Корреспондирующие счета задаются с помощью корректных проводок.

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

Пример:

ИспользоватьКорСчет(ВыбСчет, 1);

ИерархическийСписок

Установить режим иерархического списка счетов.

Синтаксис:

ИерархическийСписок(<ФлагИерархСписка>, <ФлагИзменения>)

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

HierarchicalList

Параметры:

<ФлагИерархСписка>

Флаг иерархического списка. 1 — иерархический список; 0 — неиерархический список.

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

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

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

Значение флага иерархического списка для формы списка счетов (до применения метода).

Описание:

Метод ИерархическийСписок устанавливает режим иерархического списка счетов.

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

Пример:

ИерархическийСписок(1, 1);

РедактироватьВДиалоге

Установить способ редактирования счета.

Синтаксис:

РедактироватьВДиалоге(<Способ>, <Разрешение>)

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

EditInForm

Параметры:

<Способ>

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

<Разрешение>

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

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

Значение установленного на данный момент способа счета (до применения метода).

Описание:

Метод РедактироватьВДиалоге устанавливает способ редактирования счета.

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

Пример:

ТекСп = РедактироватьВДиалоге();

// какой сейчас способ?

РедактироватьВДиалоге(1);

// установить редактирование в диалоге

РедактироватьВДиалоге(1, 0);

// установить редактирование в диалоге и запретить его менять

ВыборГруппы

Устанавливает или сбрасывает признак выбора группы.

Синтаксис:

ВыборГруппы([<ФлагВыбораГруппы>])

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

SelectGroup

Параметры:

<ФлагВыбораГруппы>

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

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

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

Описание:

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

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

Пример:

ВыборГруппы(0);

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

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

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

Предопределенные процедуры не является встроенными процедурами языка. Для них зарезервированы только название и синтаксис. Тело процедур должно быть написано самим разработчиком в соответствующих программных модулях. Вызов предопределенных процедур на исполнение производится в системе 1С:Предприятие неявно при возникновении соответствующего события. Описание предопределенных процедур также см. гл. «Системные предопределенные процедуры».

ПриВводеСтроки

Предопределенная процедура при вводе новой строки списка счетов

Синтаксис:

ПриВводеСтроки()

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

OnNewLine

Описание:

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

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

Пример:

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

   Если НазваниеНабораПрав() = "Оператор" Тогда

      Предупреждение("У вас нет права добавлять счета!", 2);

      СтатусВозврата(0);

   КонецЕсли;

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

См. также: СтатусВозврата

ПриРедактированииНовойСтроки

Предопределенная процедура при редактировании новой строки списка счетов.

Синтаксис:

ПриРедактированииНовойСтроки()

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

OnEditNewLine

Описание:

Вызов предопределенной процедуры ПриРедактированииНовойСтроки производится в системе 1С:Предприятие в момент начала интерактивного редактирования новой строки списка счетов (после того, как новая строка уже заведена). Данная процедура может использоваться, например, для установки начальных значений (значений по умолчанию) характеристик нового счета. В данной предопределенной процедуре установка статуса возврата не имеет смысла, т. к. отказаться от ввода новой строки в этот момент уже невозможно.

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

Пример:

Процедура ПриРедактированииНовойСтроки()

   СтатусСчета = ОснСтатусСчетов;

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

ПриНачалеРедактированияСтроки

Предопределенная процедура при начале редактирования существующей строки списка счетов.

Синтаксис:

ПриНачалеРедактированияСтроки()

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

OnStartEditLine

Описание:

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

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

Пример:

Процедура ПриНачалеРедактированияСтроки()

   Если НазваниеНабораПрав() = "Оператор" Тогда

      Предупреждение("У вас нет права менять счета!", 2);

      СтатусВозврата(0);

   КонецЕсли;

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

См. также: СтатусВозврата

ПриВыбореРодителя

Предопределенная процедура выбора родительской группы счета.

Синтаксис:

ПриВыбореРодителя(<Счет>)

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

OnSetParent

Параметры:

<Счет>

Значение счета, который интерактивно установлен в качестве родителя.

Описание:

Вызов предопределенной процедуры ПриВыборе Родителя производится в системе 1С:Предприятие при интерактивной смене родительской группы счета (выбор следующего или предыдущего уровня). Если в данной предопределенной процедуре установить статус возврата — 0, то выбор родительской группы не будет произведен.

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

Пример:

Процедура ПриВыбореРодителя(Родитель)

   Если НазваниеНабораПрав() = "Продавец" Тогда

      Если Родитель = ЗапрещеннаяГруппа Тогда

         Предупреждение("Вам запрещено изменять счет!", 2);

         СтатусВозврата(0);

      КонецЕсли;

   КонецЕсли;

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

См. также: СтатусВозврата

ПриЗаписи

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

Синтаксис:

ПриЗаписи(<СписокПериодРекв>)

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

OnWrite

Параметры:

<СписокПериодРекв>

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

Описание:

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

Формальный параметр <СписокПериодРекв> используется в теле процедуры для обработки ситуаций изменений периодических реквизитов счета.

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

Пример:

Процедура ПриЗаписи(СписокРекв)

   Если Валютный = 1 Тогда

      СтатусВозврата(0);

   КонецЕсли;

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

См. также: СтатусВозврата

Предопределенные процедуры модуля формы счета

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

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

Предопределенные процедуры не является встроенными процедурами языка. Для них зарезервированы только название и синтаксис. Тело процедур должно быть написано самим разработчиком в соответствующих программных модулях. Вызов предопределенных процедур на исполнение производится в системе 1С:Предприятие неявно при возникновении соответствующего события. Описание предопределенных процедур также см. гл. «Системные предопределенные процедуры».

ВводНового

Предопределенная процедура при вводе нового счета.

Синтаксис:

ВводНового(<ПризнКопирования>, <ОбъектКопирования>)

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

InputNew

Параметры:

<ПризнКопирования>

Признак того, что объект введен копированием. Число: 1 — объект введен копированием, 0 — просто новый объект. Данный признак может быть использован для анализа необходимости инициализации реквизитов нового объекта.

<ОбъектКопирования>

Объект, который был скопирован.

Описание:

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

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

Процедура ВводНового контекста справочников должна находиться в модуле: формы счета (см. «Виды программных модулей»).

Пример:

Процедура ВводНового()

   Если НазваниеНабораПрав() = "Оператор" Тогда

      Предупреждение("У вас нет права добавлять счета!", 2);

      СтатусВозврата(0);

   КонецЕсли;

   СтатусСчета = ОснСтатусСчетов;

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

См. также: СтатусВозврата

ПриЗаписи

Предопределенная процедура при записи счета.

Синтаксис:

ПриЗаписи(<СписокПериодРекв>)

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

OnWrite

Параметры:

<СписокПериодРекв>

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

Описание:

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

Формальный параметр <СписокПериодРекв> используется в теле процедуры для обработки ситуаций с изменениями периодических реквизитов счета.

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

Пример:

Процедура ПриЗаписи(СписокРекв)

   Если Валютный = 1 Тогда

      СтатусВозврата(0);

   КонецЕсли;

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

См. также: СтатусВозврата


 



Перейти  к оглавлению: Описание встроенного языка

Hosted by uCoz